Snapdragon® Telematics Application Framework (TelAF) Interface Specification
taf_dcs_interface.h
Go to the documentation of this file.
1 
2 
3 /*
4  * ====================== WARNING ======================
5  *
6  * THE CONTENTS OF THIS FILE HAVE BEEN AUTO-GENERATED.
7  * DO NOT MODIFY IN ANY WAY.
8  *
9  * ====================== WARNING ======================
10  */
11 
120 #ifndef TAF_DCS_INTERFACE_H_INCLUDE_GUARD
121 #define TAF_DCS_INTERFACE_H_INCLUDE_GUARD
122 
123 
124 #include "legato.h"
125 
126 // Interface specific includes
127 #include "taf_types_interface.h"
128 
129 // Internal includes for this interface
130 #include "taf_dcs_common.h"
131 //--------------------------------------------------------------------------------------------------
135 //--------------------------------------------------------------------------------------------------
136 typedef void (*taf_dcs_DisconnectHandler_t)(void *);
137 
138 //--------------------------------------------------------------------------------------------------
150 //--------------------------------------------------------------------------------------------------
152 (
153  void
154 );
155 
156 //--------------------------------------------------------------------------------------------------
175 //--------------------------------------------------------------------------------------------------
177 (
178  void
179 );
180 
181 //--------------------------------------------------------------------------------------------------
189 //--------------------------------------------------------------------------------------------------
191 (
192  taf_dcs_DisconnectHandler_t disconnectHandler,
193  void *contextPtr
194 );
195 
196 //--------------------------------------------------------------------------------------------------
207 //--------------------------------------------------------------------------------------------------
209 (
210  taf_dcs_DisconnectHandler_t disconnectHandler,
211  void *contextPtr
212 );
213 
214 //--------------------------------------------------------------------------------------------------
225 //--------------------------------------------------------------------------------------------------
227 (
228  void
229 );
230 
231 //--------------------------------------------------------------------------------------------------
244 //--------------------------------------------------------------------------------------------------
246 (
247  taf_dcs_ProfileRef_t profileRef
249 );
250 
251 //--------------------------------------------------------------------------------------------------
257 //--------------------------------------------------------------------------------------------------
259 (
260  taf_dcs_ProfileRef_t profileRef,
264  void* contextPtr
266 );
267 
268 //--------------------------------------------------------------------------------------------------
281 //--------------------------------------------------------------------------------------------------
283 (
284  taf_dcs_ProfileRef_t profileRef
286 );
287 
288 //--------------------------------------------------------------------------------------------------
294 //--------------------------------------------------------------------------------------------------
296 (
297  taf_dcs_ProfileRef_t profileRef,
301  void* contextPtr
303 );
304 
305 //--------------------------------------------------------------------------------------------------
315 //--------------------------------------------------------------------------------------------------
317 (
318  taf_dcs_ProfileRef_t profileRef,
320  char* ifName,
322  size_t ifNameSize
324 );
325 
326 //--------------------------------------------------------------------------------------------------
332 //--------------------------------------------------------------------------------------------------
334 (
335  taf_dcs_ProfileRef_t profileRef,
339  void* contextPtr
341 );
342 
343 //--------------------------------------------------------------------------------------------------
347 //--------------------------------------------------------------------------------------------------
349 (
352 );
353 
354 //--------------------------------------------------------------------------------------------------
360 //--------------------------------------------------------------------------------------------------
362 (
365  void* contextPtr
367 );
368 
369 //--------------------------------------------------------------------------------------------------
373 //--------------------------------------------------------------------------------------------------
375 (
378 );
379 
380 //--------------------------------------------------------------------------------------------------
390 //--------------------------------------------------------------------------------------------------
392 (
393  uint8_t phoneId,
395  bool* isRoamingPtr,
397  taf_dcs_RoamingType_t* typePtr
399 );
400 
401 //--------------------------------------------------------------------------------------------------
409 //--------------------------------------------------------------------------------------------------
411 (
412  taf_dcs_ProfileRef_t profileRef,
414  char* ipAddr,
416  size_t ipAddrSize
418 );
419 
420 //--------------------------------------------------------------------------------------------------
428 //--------------------------------------------------------------------------------------------------
430 (
431  taf_dcs_ProfileRef_t profileRef,
433  char* gatewayAddr,
435  size_t gatewayAddrSize
437 );
438 
439 //--------------------------------------------------------------------------------------------------
447 //--------------------------------------------------------------------------------------------------
449 (
450  taf_dcs_ProfileRef_t profileRef,
452  char* dns1AddrStr,
454  size_t dns1AddrStrSize,
456  char* dns2AddrStr,
458  size_t dns2AddrStrSize
460 );
461 
462 //--------------------------------------------------------------------------------------------------
470 //--------------------------------------------------------------------------------------------------
472 (
473  taf_dcs_ProfileRef_t profileRef,
475  char* ipAddr,
477  size_t ipAddrSize
479 );
480 
481 //--------------------------------------------------------------------------------------------------
489 //--------------------------------------------------------------------------------------------------
491 (
492  taf_dcs_ProfileRef_t profileRef,
494  char* gatewayAddr,
496  size_t gatewayAddrSize
498 );
499 
500 //--------------------------------------------------------------------------------------------------
508 //--------------------------------------------------------------------------------------------------
510 (
511  taf_dcs_ProfileRef_t profileRef,
513  char* dns1AddrStr,
515  size_t dns1AddrStrSize,
517  char* dns2AddrStr,
519  size_t dns2AddrStrSize
521 );
522 
523 //--------------------------------------------------------------------------------------------------
531 //--------------------------------------------------------------------------------------------------
533 (
534  taf_dcs_ProfileRef_t profileRef,
536  taf_dcs_ConState_t* connectionStatePtr
538 );
539 
540 //--------------------------------------------------------------------------------------------------
548 //--------------------------------------------------------------------------------------------------
549 bool taf_dcs_IsIPv4
550 (
551  taf_dcs_ProfileRef_t profileRef
553 );
554 
555 //--------------------------------------------------------------------------------------------------
563 //--------------------------------------------------------------------------------------------------
564 bool taf_dcs_IsIPv6
565 (
566  taf_dcs_ProfileRef_t profileRef
568 );
569 
570 //--------------------------------------------------------------------------------------------------
578 //--------------------------------------------------------------------------------------------------
580 (
581  taf_dcs_ProfileRef_t profileRef,
583  taf_dcs_DataBearerTechnology_t* dlDataBearerTechPtrPtr,
585  taf_dcs_DataBearerTechnology_t* ulDataBearerTechPtrPtr
587 );
588 
589 //--------------------------------------------------------------------------------------------------
601 //--------------------------------------------------------------------------------------------------
603 (
604  taf_dcs_ProfileInfo_t* profileListPtr,
606  size_t* profileListSizePtr
608 );
609 
610 //--------------------------------------------------------------------------------------------------
619 //--------------------------------------------------------------------------------------------------
621 (
622  uint8_t phoneId,
624  taf_dcs_ProfileInfo_t* profileListPtr,
626  size_t* profileListSizePtr
628 );
629 
630 //--------------------------------------------------------------------------------------------------
637 //--------------------------------------------------------------------------------------------------
639 (
640  void
641 );
642 
643 //--------------------------------------------------------------------------------------------------
652 //--------------------------------------------------------------------------------------------------
654 (
655  uint8_t* phoneIdPtr,
657  uint32_t* profileIdPtr
659 );
660 
661 //--------------------------------------------------------------------------------------------------
672 //--------------------------------------------------------------------------------------------------
674 (
675  uint32_t profileId
677 );
678 
679 //--------------------------------------------------------------------------------------------------
687 //--------------------------------------------------------------------------------------------------
689 (
690  uint8_t phoneId,
692  uint32_t profileId
694 );
695 
696 //--------------------------------------------------------------------------------------------------
707 //--------------------------------------------------------------------------------------------------
709 (
710  uint32_t profileId
712 );
713 
714 //--------------------------------------------------------------------------------------------------
722 //--------------------------------------------------------------------------------------------------
724 (
725  uint8_t phoneId,
727  uint32_t profileId
729 );
730 
731 //--------------------------------------------------------------------------------------------------
739 //--------------------------------------------------------------------------------------------------
741 (
742  taf_dcs_ProfileRef_t profileRef
744 );
745 
746 //--------------------------------------------------------------------------------------------------
756 //--------------------------------------------------------------------------------------------------
758 (
759  taf_dcs_ProfileRef_t profileRef,
761  uint8_t* phoneIdPtr
763 );
764 
765 //--------------------------------------------------------------------------------------------------
774 //--------------------------------------------------------------------------------------------------
776 (
777  taf_dcs_ProfileRef_t profileRef,
779  const char* LE_NONNULL apnName
781 );
782 
783 //--------------------------------------------------------------------------------------------------
792 //--------------------------------------------------------------------------------------------------
794 (
795  taf_dcs_ProfileRef_t profileRef,
797  char* apnName,
799  size_t apnNameSize
801 );
802 
803 //--------------------------------------------------------------------------------------------------
811 //--------------------------------------------------------------------------------------------------
813 (
814  taf_dcs_ProfileRef_t profileRef,
816  taf_dcs_ApnType_t* apnTypePtr
818 );
819 
820 //--------------------------------------------------------------------------------------------------
829 //--------------------------------------------------------------------------------------------------
831 (
832  taf_dcs_ProfileRef_t profileRef,
834  taf_dcs_Pdp_t pdp
836 );
837 
838 //--------------------------------------------------------------------------------------------------
848 //--------------------------------------------------------------------------------------------------
850 (
851  taf_dcs_ProfileRef_t profileRef
853 );
854 
855 //--------------------------------------------------------------------------------------------------
864 //--------------------------------------------------------------------------------------------------
866 (
867  taf_dcs_ProfileRef_t profileRef,
869  taf_dcs_Auth_t auth,
871  const char* LE_NONNULL userName,
873  const char* LE_NONNULL password
875 );
876 
877 //--------------------------------------------------------------------------------------------------
886 //--------------------------------------------------------------------------------------------------
888 (
889  taf_dcs_ProfileRef_t profileRef,
891  taf_dcs_Auth_t* authPtr,
893  char* userName,
895  size_t userNameSize,
897  char* password,
899  size_t passwordSize
901 );
902 
903 //--------------------------------------------------------------------------------------------------
912 //--------------------------------------------------------------------------------------------------
914 (
915  const char* LE_NONNULL ifName,
917  uint32_t* profileIdPtr
919 );
920 
921 //--------------------------------------------------------------------------------------------------
930 //--------------------------------------------------------------------------------------------------
932 (
933  const char* LE_NONNULL ifName,
935  uint8_t* phoneIdPtr
937 );
938 
939 #endif // TAF_DCS_INTERFACE_H_INCLUDE_GUARD
void taf_dcs_DisconnectService(void)
Definition: taf_dcs_client.c:503
LE_FULL_API void taf_dcs_SetNonExitServerDisconnectHandler(taf_dcs_DisconnectHandler_t disconnectHandler, void *contextPtr)
Definition: taf_dcs_client.c:457
le_result_t taf_dcs_StartSession(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:564
void taf_dcs_StartSessionAsync(taf_dcs_ProfileRef_t profileRef, taf_dcs_AsyncSessionHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_dcs_client.c:583
struct taf_dcs_SessionStateHandler * taf_dcs_SessionStateHandlerRef_t
Definition: taf_dcs_common.h:368
void(* taf_dcs_AsyncSessionHandlerFunc_t)(taf_dcs_ProfileRef_t profileRef, le_result_t result, void *contextPtr)
Definition: taf_dcs_common.h:400
le_result_t taf_dcs_GetProfileIdByInterfaceName(const char *LE_NONNULL ifName, uint32_t *profileIdPtr)
Definition: taf_dcs_client.c:1503
le_result_t taf_dcs_GetSessionState(taf_dcs_ProfileRef_t profileRef, taf_dcs_ConState_t *connectionStatePtr)
Definition: taf_dcs_client.c:974
taf_dcs_DataBearerTechnology_t
Definition: taf_dcs_common.h:178
uint32_t taf_dcs_Auth_t
Definition: taf_dcs_common.h:293
le_result_t taf_dcs_GetPhoneIdByInterfaceName(const char *LE_NONNULL ifName, uint8_t *phoneIdPtr)
Definition: taf_dcs_client.c:1528
le_result_t taf_dcs_SetPDP(taf_dcs_ProfileRef_t profileRef, taf_dcs_Pdp_t pdp)
Definition: taf_dcs_client.c:1387
struct taf_dcs_RoamingStatusHandler * taf_dcs_RoamingStatusHandlerRef_t
Definition: taf_dcs_common.h:376
le_result_t taf_dcs_GetIPv4Address(taf_dcs_ProfileRef_t profileRef, char *ipAddr, size_t ipAddrSize)
Definition: taf_dcs_client.c:800
void taf_dcs_RemoveRoamingStatusHandler(taf_dcs_RoamingStatusHandlerRef_t handlerRef)
Definition: taf_dcs_client.c:750
le_result_t taf_dcs_GetPhoneId(taf_dcs_ProfileRef_t profileRef, uint8_t *phoneIdPtr)
Definition: taf_dcs_client.c:1285
void taf_dcs_RemoveSessionStateHandler(taf_dcs_SessionStateHandlerRef_t handlerRef)
Definition: taf_dcs_client.c:711
le_result_t taf_dcs_GetIPv4GatewayAddress(taf_dcs_ProfileRef_t profileRef, char *gatewayAddr, size_t gatewayAddrSize)
Definition: taf_dcs_client.c:827
le_result_t taf_dcs_GetAuthentication(taf_dcs_ProfileRef_t profileRef, taf_dcs_Auth_t *authPtr, char *userName, size_t userNameSize, char *password, size_t passwordSize)
Definition: taf_dcs_client.c:1466
Definition: taf_dcs_common.h:384
le_result_t taf_dcs_GetIPv6DNSAddresses(taf_dcs_ProfileRef_t profileRef, char *dns1AddrStr, size_t dns1AddrStrSize, char *dns2AddrStr, size_t dns2AddrStrSize)
Definition: taf_dcs_client.c:941
taf_dcs_ConState_t
Definition: taf_dcs_common.h:235
le_result_t taf_dcs_SetDefaultProfileIndexEx(uint8_t phoneId, uint32_t profileId)
Definition: taf_dcs_client.c:1190
le_result_t taf_dcs_SetDefaultProfileIndex(uint32_t profileId)
Definition: taf_dcs_client.c:1169
taf_dcs_ProfileRef_t taf_dcs_GetProfile(uint32_t profileId)
Definition: taf_dcs_client.c:1217
le_result_t taf_dcs_SetAuthentication(taf_dcs_ProfileRef_t profileRef, taf_dcs_Auth_t auth, const char *LE_NONNULL userName, const char *LE_NONNULL password)
Definition: taf_dcs_client.c:1435
LE_FULL_API void taf_dcs_SetServerDisconnectHandler(taf_dcs_DisconnectHandler_t disconnectHandler, void *contextPtr)
Definition: taf_dcs_client.c:380
void taf_dcs_StopSessionAsync(taf_dcs_ProfileRef_t profileRef, taf_dcs_AsyncSessionHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_dcs_client.c:634
le_result_t taf_dcs_GetProfileListEx(uint8_t phoneId, taf_dcs_ProfileInfo_t *profileListPtr, size_t *profileListSizePtr)
Definition: taf_dcs_client.c:1096
le_result_t taf_dcs_GetProfileList(taf_dcs_ProfileInfo_t *profileListPtr, size_t *profileListSizePtr)
Definition: taf_dcs_client.c:1071
le_result_t taf_dcs_SetAPN(taf_dcs_ProfileRef_t profileRef, const char *LE_NONNULL apnName)
Definition: taf_dcs_client.c:1310
taf_dcs_ProfileRef_t taf_dcs_GetProfileEx(uint8_t phoneId, uint32_t profileId)
Definition: taf_dcs_client.c:1238
le_result_t taf_dcs_GetIPv6GatewayAddress(taf_dcs_ProfileRef_t profileRef, char *gatewayAddr, size_t gatewayAddrSize)
Definition: taf_dcs_client.c:914
bool taf_dcs_IsIPv4(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:998
le_result_t taf_dcs_StopSession(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:615
uint32_t taf_dcs_ApnType_t
Definition: taf_dcs_common.h:313
void(* taf_dcs_SessionStateHandlerFunc_t)(taf_dcs_ProfileRef_t profileRef, taf_dcs_ConState_t state, const taf_dcs_StateInfo_t *LE_NONNULL infoPtr, void *contextPtr)
Definition: taf_dcs_common.h:415
le_result_t taf_dcs_GetIPv4DNSAddresses(taf_dcs_ProfileRef_t profileRef, char *dns1AddrStr, size_t dns1AddrStrSize, char *dns2AddrStr, size_t dns2AddrStrSize)
Definition: taf_dcs_client.c:854
uint32_t taf_dcs_GetDefaultProfileIndex(void)
Definition: taf_dcs_client.c:1122
le_result_t taf_dcs_GetRoamingStatus(uint8_t phoneId, bool *isRoamingPtr, taf_dcs_RoamingType_t *typePtr)
Definition: taf_dcs_client.c:773
le_result_t taf_dcs_GetAPN(taf_dcs_ProfileRef_t profileRef, char *apnName, size_t apnNameSize)
Definition: taf_dcs_client.c:1335
le_result_t taf_dcs_GetApnTypes(taf_dcs_ProfileRef_t profileRef, taf_dcs_ApnType_t *apnTypePtr)
Definition: taf_dcs_client.c:1362
uint32_t taf_dcs_GetProfileIndex(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:1262
taf_dcs_Pdp_t taf_dcs_GetPDP(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:1413
void(* taf_dcs_DisconnectHandler_t)(void *)
Definition: taf_dcs_interface.h:136
le_result_t taf_dcs_GetInterfaceName(taf_dcs_ProfileRef_t profileRef, char *ifName, size_t ifNameSize)
Definition: taf_dcs_client.c:663
#define LE_NONNULL
Definition: le_basics.h:368
taf_dcs_Pdp_t
Definition: taf_dcs_common.h:254
le_result_t
Definition: le_basics.h:45
le_result_t taf_dcs_GetDefaultPhoneIdAndProfileId(uint8_t *phoneIdPtr, uint32_t *profileIdPtr)
Definition: taf_dcs_client.c:1142
void(* taf_dcs_RoamingStatusHandlerFunc_t)(const taf_dcs_RoamingStatusInd_t *LE_NONNULL roamingStatusIndPtr, void *contextPtr)
Definition: taf_dcs_common.h:432
taf_dcs_RoamingStatusHandlerRef_t taf_dcs_AddRoamingStatusHandler(taf_dcs_RoamingStatusHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_dcs_client.c:730
struct taf_dcs_Profile * taf_dcs_ProfileRef_t
Definition: taf_dcs_common.h:134
taf_dcs_RoamingType_t
Definition: taf_dcs_common.h:273
le_result_t taf_dcs_GetIPv6Address(taf_dcs_ProfileRef_t profileRef, char *ipAddr, size_t ipAddrSize)
Definition: taf_dcs_client.c:887
#define LE_FULL_API
Definition: le_apiFeatures.h:42
taf_dcs_SessionStateHandlerRef_t taf_dcs_AddSessionStateHandler(taf_dcs_ProfileRef_t profileRef, taf_dcs_SessionStateHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_dcs_client.c:688
void taf_dcs_ConnectService(void)
Definition: taf_dcs_client.c:291
le_result_t taf_dcs_GetDataBearerTechnology(taf_dcs_ProfileRef_t profileRef, taf_dcs_DataBearerTechnology_t *dlDataBearerTechPtrPtr, taf_dcs_DataBearerTechnology_t *ulDataBearerTechPtrPtr)
Definition: taf_dcs_client.c:1040
bool taf_dcs_IsIPv6(taf_dcs_ProfileRef_t profileRef)
Definition: taf_dcs_client.c:1019
le_result_t taf_dcs_TryConnectService(void)
Definition: taf_dcs_client.c:323