Snapdragon® Telematics Application Framework (TelAF) Interface Specification
taf_sim_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 
12 
13 #ifndef TAF_SIM_INTERFACE_H_INCLUDE_GUARD
14 #define TAF_SIM_INTERFACE_H_INCLUDE_GUARD
15 
16 
17 #include "legato.h"
18 
19 // Internal includes for this interface
20 #include "taf_sim_common.h"
21 //--------------------------------------------------------------------------------------------------
25 //--------------------------------------------------------------------------------------------------
26 typedef void (*taf_sim_DisconnectHandler_t)(void *);
27 
28 //--------------------------------------------------------------------------------------------------
40 //--------------------------------------------------------------------------------------------------
42 (
43  void
44 );
45 
46 //--------------------------------------------------------------------------------------------------
65 //--------------------------------------------------------------------------------------------------
67 (
68  void
69 );
70 
71 //--------------------------------------------------------------------------------------------------
79 //--------------------------------------------------------------------------------------------------
81 (
82  taf_sim_DisconnectHandler_t disconnectHandler,
83  void *contextPtr
84 );
85 
86 //--------------------------------------------------------------------------------------------------
97 //--------------------------------------------------------------------------------------------------
99 (
100  taf_sim_DisconnectHandler_t disconnectHandler,
101  void *contextPtr
102 );
103 
104 //--------------------------------------------------------------------------------------------------
115 //--------------------------------------------------------------------------------------------------
117 (
118  void
119 );
120 
121 
122 //--------------------------------------------------------------------------------------------------
338 //--------------------------------------------------------------------------------------------------
339 
340 //--------------------------------------------------------------------------------------------------
346 //--------------------------------------------------------------------------------------------------
348 (
351  void* contextPtr
353 );
354 
355 //--------------------------------------------------------------------------------------------------
359 //--------------------------------------------------------------------------------------------------
361 (
364 );
365 
366 //--------------------------------------------------------------------------------------------------
373 //--------------------------------------------------------------------------------------------------
375 (
378  void* contextPtr
380 );
381 
382 //--------------------------------------------------------------------------------------------------
386 //--------------------------------------------------------------------------------------------------
388 (
391 );
392 
393 //--------------------------------------------------------------------------------------------------
401 //--------------------------------------------------------------------------------------------------
403 (
404  taf_sim_Id_t slotId
406 );
407 
408 //--------------------------------------------------------------------------------------------------
414 //--------------------------------------------------------------------------------------------------
416 (
417  taf_sim_Id_t slotId
419 );
420 
421 //--------------------------------------------------------------------------------------------------
429 //--------------------------------------------------------------------------------------------------
430 bool taf_sim_IsReady
431 (
432  taf_sim_Id_t slotId
434 );
435 
436 //--------------------------------------------------------------------------------------------------
447 //--------------------------------------------------------------------------------------------------
449 (
450  taf_sim_Id_t slotId,
452  char* iccid,
454  size_t iccidSize
456 );
457 
458 //--------------------------------------------------------------------------------------------------
469 //--------------------------------------------------------------------------------------------------
471 (
472  taf_sim_Id_t slotId,
474  char* imsi,
476  size_t imsiSize
478 );
479 
480 //--------------------------------------------------------------------------------------------------
491 //--------------------------------------------------------------------------------------------------
493 (
494  taf_sim_Id_t slotId,
496  char* nameStr,
498  size_t nameStrSize
500 );
501 
502 //--------------------------------------------------------------------------------------------------
513 //--------------------------------------------------------------------------------------------------
515 (
516  taf_sim_Id_t slotId,
518  char* phoneNumberStr,
520  size_t phoneNumberStrSize
522 );
523 
524 //--------------------------------------------------------------------------------------------------
535 //--------------------------------------------------------------------------------------------------
537 (
538  taf_sim_Id_t slotId,
540  char* mccPtr,
542  size_t mccPtrSize,
544  char* mncPtr,
546  size_t mncPtrSize
548 );
549 
550 //--------------------------------------------------------------------------------------------------
556 //--------------------------------------------------------------------------------------------------
558 (
559  void
560 );
561 
562 //--------------------------------------------------------------------------------------------------
571 //--------------------------------------------------------------------------------------------------
573 (
574  taf_sim_Id_t slotId
576 );
577 
578 //--------------------------------------------------------------------------------------------------
589 //--------------------------------------------------------------------------------------------------
591 (
592  taf_sim_Id_t slotId,
594  taf_sim_LockType_t lockType,
596  const char* LE_NONNULL pin
598 );
599 
600 //--------------------------------------------------------------------------------------------------
610 //--------------------------------------------------------------------------------------------------
612 (
613  taf_sim_Id_t slotId,
615  taf_sim_LockType_t lockType,
617  const char* LE_NONNULL oldpin,
619  const char* LE_NONNULL newpin
621 );
622 
623 //--------------------------------------------------------------------------------------------------
633 //--------------------------------------------------------------------------------------------------
635 (
636  taf_sim_Id_t slotId
638 );
639 
640 //--------------------------------------------------------------------------------------------------
650 //--------------------------------------------------------------------------------------------------
652 (
653  taf_sim_Id_t slotId,
655  uint32_t* remainingPukTriesPtrPtr
657 );
658 
659 //--------------------------------------------------------------------------------------------------
669 //--------------------------------------------------------------------------------------------------
671 (
672  taf_sim_Id_t slotId,
674  taf_sim_LockType_t lockType,
676  const char* LE_NONNULL pin
678 );
679 
680 //--------------------------------------------------------------------------------------------------
691 //--------------------------------------------------------------------------------------------------
693 (
694  taf_sim_Id_t slotId,
696  taf_sim_LockType_t lockType,
698  const char* LE_NONNULL pin
700 );
701 
702 //--------------------------------------------------------------------------------------------------
714 //--------------------------------------------------------------------------------------------------
716 (
717  taf_sim_Id_t slotId,
719  taf_sim_LockType_t lockType,
721  const char* LE_NONNULL puk,
723  const char* LE_NONNULL newpin
725 );
726 
727 //--------------------------------------------------------------------------------------------------
735 //--------------------------------------------------------------------------------------------------
737 (
738  taf_sim_Id_t slotId,
740  char* eid,
742  size_t eidSize
744 );
745 
746 //--------------------------------------------------------------------------------------------------
754 //--------------------------------------------------------------------------------------------------
756 (
757  bool enable
759 );
760 
761 //--------------------------------------------------------------------------------------------------
769 //--------------------------------------------------------------------------------------------------
771 (
772  bool* enablePtr
774 );
775 
776 //--------------------------------------------------------------------------------------------------
785 //--------------------------------------------------------------------------------------------------
787 (
788  taf_sim_Id_t slotId,
790  taf_sim_AppType_t apptype,
792  uint8_t* channelPtrPtr
794 );
795 
796 //--------------------------------------------------------------------------------------------------
804 //--------------------------------------------------------------------------------------------------
806 (
807  taf_sim_Id_t slotId,
809  uint8_t channel
811 );
812 
813 //--------------------------------------------------------------------------------------------------
823 //--------------------------------------------------------------------------------------------------
825 (
826  taf_sim_Id_t simId,
828  uint8_t channel,
830  const uint8_t* commandApduPtr,
832  size_t commandApduSize,
834  uint8_t* responseApduPtr,
836  size_t* responseApduSizePtr
838 );
839 
840 //--------------------------------------------------------------------------------------------------
850 //--------------------------------------------------------------------------------------------------
852 (
853  taf_sim_Id_t simId,
855  const uint8_t* commandApduPtr,
857  size_t commandApduSize,
859  uint8_t* responseApduPtr,
861  size_t* responseApduSizePtr
863 );
864 
865 //--------------------------------------------------------------------------------------------------
878 //--------------------------------------------------------------------------------------------------
880 (
881  taf_sim_Id_t simId,
883  taf_sim_Command_t command,
885  const char* LE_NONNULL fileIdentifier,
887  uint8_t p1,
889  uint8_t p2,
891  uint8_t p3,
893  const uint8_t* dataPtr,
895  size_t dataSize,
897  const char* LE_NONNULL path,
899  uint8_t* sw1Ptr,
901  uint8_t* sw2Ptr,
903  uint8_t* responsePtr,
905  size_t* responseSizePtr
907 );
908 
909 //--------------------------------------------------------------------------------------------------
923 //--------------------------------------------------------------------------------------------------
925 (
926  taf_sim_Id_t simId,
928  taf_sim_Manufacturer_t manufacturer
930 );
931 
932 //--------------------------------------------------------------------------------------------------
946 //--------------------------------------------------------------------------------------------------
948 (
949  taf_sim_Id_t simId,
951  taf_sim_Manufacturer_t manufacturer
953 );
954 
955 //--------------------------------------------------------------------------------------------------
968 //--------------------------------------------------------------------------------------------------
970 (
971  taf_sim_Id_t simId,
973  le_onoff_t power
975 );
976 
977 //--------------------------------------------------------------------------------------------------
985 //--------------------------------------------------------------------------------------------------
987 (
988  taf_sim_Id_t simId
990 );
991 
992 //--------------------------------------------------------------------------------------------------
1003 //--------------------------------------------------------------------------------------------------
1005 (
1006  taf_sim_Id_t simId,
1008  bool* isEcsPtr
1010 );
1011 
1012 //--------------------------------------------------------------------------------------------------
1019 //--------------------------------------------------------------------------------------------------
1021 (
1024  void* contextPtr
1026 );
1027 
1028 //--------------------------------------------------------------------------------------------------
1032 //--------------------------------------------------------------------------------------------------
1034 (
1037 );
1038 
1039 //--------------------------------------------------------------------------------------------------
1047 //--------------------------------------------------------------------------------------------------
1049 (
1050  void
1051 );
1052 
1053 //--------------------------------------------------------------------------------------------------
1063 //--------------------------------------------------------------------------------------------------
1065 (
1066  taf_sim_FPLMNListRef_t fplmnListRef,
1068  const char* LE_NONNULL mcc,
1070  const char* LE_NONNULL mnc
1072 );
1073 
1074 //--------------------------------------------------------------------------------------------------
1087 //--------------------------------------------------------------------------------------------------
1089 (
1090  taf_sim_FPLMNListRef_t fplmnListRef,
1092  char* mccPtr,
1094  size_t mccPtrSize,
1096  char* mncPtr,
1098  size_t mncPtrSize
1100 );
1101 
1102 //--------------------------------------------------------------------------------------------------
1114 //--------------------------------------------------------------------------------------------------
1116 (
1117  taf_sim_FPLMNListRef_t fplmnListRef,
1119  char* mccPtr,
1121  size_t mccPtrSize,
1123  char* mncPtr,
1125  size_t mncPtrSize
1127 );
1128 
1129 //--------------------------------------------------------------------------------------------------
1137 //--------------------------------------------------------------------------------------------------
1139 (
1140  taf_sim_Id_t simId
1142 );
1143 
1144 //--------------------------------------------------------------------------------------------------
1153 //--------------------------------------------------------------------------------------------------
1155 (
1156  taf_sim_FPLMNListRef_t fplmnListRef
1158 );
1159 
1160 //--------------------------------------------------------------------------------------------------
1170 //--------------------------------------------------------------------------------------------------
1172 (
1173  taf_sim_Id_t simId,
1175  taf_sim_FPLMNListRef_t fplmnListRef
1177 );
1178 
1179 //--------------------------------------------------------------------------------------------------
1187 //--------------------------------------------------------------------------------------------------
1189 (
1190  int32_t* countPtr
1192 );
1193 
1194 #endif // TAF_SIM_INTERFACE_H_INCLUDE_GUARD
taf_sim_LockType_t
Definition: taf_sim_common.h:488
le_result_t taf_sim_SendApduOnChannel(taf_sim_Id_t simId, uint8_t channel, const uint8_t *commandApduPtr, size_t commandApduSize, uint8_t *responseApduPtr, size_t *responseApduSizePtr)
Definition: taf_sim_client.c:1221
void(* taf_sim_NewStateHandlerFunc_t)(taf_sim_Id_t slotId, taf_sim_States_t state, void *contextPtr)
Definition: taf_sim_common.h:622
le_result_t taf_sim_Unlock(taf_sim_Id_t slotId, taf_sim_LockType_t lockType, const char *LE_NONNULL pin)
Definition: taf_sim_client.c:1007
taf_sim_Command_t
Definition: taf_sim_common.h:574
le_result_t taf_sim_AddFPLMNOperator(taf_sim_FPLMNListRef_t fplmnListRef, const char *LE_NONNULL mcc, const char *LE_NONNULL mnc)
Definition: taf_sim_client.c:1552
taf_sim_NewStateHandlerRef_t taf_sim_AddNewStateHandler(taf_sim_NewStateHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_sim_client.c:557
le_result_t taf_sim_GetHomeNetworkMccMnc(taf_sim_Id_t slotId, char *mccPtr, size_t mccPtrSize, char *mncPtr, size_t mncPtrSize)
Definition: taf_sim_client.c:822
bool taf_sim_IsReady(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:678
void(* taf_sim_DisconnectHandler_t)(void *)
Definition: taf_sim_interface.h:26
le_result_t taf_sim_GetHomeNetworkOperator(taf_sim_Id_t slotId, char *nameStr, size_t nameStrSize)
Definition: taf_sim_client.c:762
void taf_sim_RemoveAuthenticationResponseHandler(taf_sim_AuthenticationResponseHandlerRef_t handlerRef)
Definition: taf_sim_client.c:617
le_result_t taf_sim_WriteFPLMNList(taf_sim_Id_t simId, taf_sim_FPLMNListRef_t fplmnListRef)
Definition: taf_sim_client.c:1699
le_result_t taf_sim_TryConnectService(void)
Definition: taf_sim_client.c:323
le_result_t taf_sim_LocalSwapToEmergencyCallSubscription(taf_sim_Id_t simId, taf_sim_Manufacturer_t manufacturer)
Definition: taf_sim_client.c:1360
le_result_t taf_sim_SetAutomaticSelection(bool enable)
Definition: taf_sim_client.c:1125
LE_FULL_API void taf_sim_SetServerDisconnectHandler(taf_sim_DisconnectHandler_t disconnectHandler, void *contextPtr)
Definition: taf_sim_client.c:380
le_result_t taf_sim_GetNextFPLMNOperator(taf_sim_FPLMNListRef_t fplmnListRef, char *mccPtr, size_t mccPtrSize, char *mncPtr, size_t mncPtrSize)
Definition: taf_sim_client.c:1621
void taf_sim_DisconnectService(void)
Definition: taf_sim_client.c:503
taf_sim_FPLMNListRef_t taf_sim_ReadFPLMNList(taf_sim_Id_t simId)
Definition: taf_sim_client.c:1654
struct taf_sim_FPLMNList * taf_sim_FPLMNListRef_t
Definition: taf_sim_common.h:410
le_result_t taf_sim_GetEID(taf_sim_Id_t slotId, char *eid, size_t eidSize)
Definition: taf_sim_client.c:1098
taf_sim_Manufacturer_t
Definition: taf_sim_common.h:551
le_result_t taf_sim_SetPower(taf_sim_Id_t simId, le_onoff_t power)
Definition: taf_sim_client.c:1419
struct taf_sim_AuthenticationResponseHandler * taf_sim_AuthenticationResponseHandlerRef_t
Definition: taf_sim_common.h:605
le_result_t taf_sim_SelectCard(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:873
LE_FULL_API void taf_sim_SetNonExitServerDisconnectHandler(taf_sim_DisconnectHandler_t disconnectHandler, void *contextPtr)
Definition: taf_sim_client.c:457
le_result_t taf_sim_GetSubscriberPhoneNumber(taf_sim_Id_t slotId, char *phoneNumberStr, size_t phoneNumberStrSize)
Definition: taf_sim_client.c:792
le_result_t taf_sim_OpenLogicalChannel(taf_sim_Id_t slotId, taf_sim_AppType_t apptype, uint8_t *channelPtrPtr)
Definition: taf_sim_client.c:1168
taf_sim_FPLMNListRef_t taf_sim_CreateFPLMNList(void)
Definition: taf_sim_client.c:1531
taf_sim_AppType_t
Definition: taf_sim_common.h:527
taf_sim_Id_t
Definition: taf_sim_common.h:465
void(* taf_sim_AuthenticationResponseHandlerFunc_t)(taf_sim_Id_t slotId, taf_sim_LockResponse_t responsetype, le_result_t result, void *contextPtr)
Definition: taf_sim_common.h:638
void(* taf_sim_IccidChangeHandlerFunc_t)(taf_sim_Id_t simId, const char *LE_NONNULL iccid, void *contextPtr)
Definition: taf_sim_common.h:656
le_result_t taf_sim_GetSlotCount(int32_t *countPtr)
Definition: taf_sim_client.c:1723
le_result_t taf_sim_Lock(taf_sim_Id_t slotId, taf_sim_LockType_t lockType, const char *LE_NONNULL pin)
Definition: taf_sim_client.c:1037
struct taf_sim_IccidChangeHandler * taf_sim_IccidChangeHandlerRef_t
Definition: taf_sim_common.h:613
le_result_t taf_sim_SendCommand(taf_sim_Id_t simId, taf_sim_Command_t command, const char *LE_NONNULL fileIdentifier, uint8_t p1, uint8_t p2, uint8_t p3, const uint8_t *dataPtr, size_t dataSize, const char *LE_NONNULL path, uint8_t *sw1Ptr, uint8_t *sw2Ptr, uint8_t *responsePtr, size_t *responseSizePtr)
Definition: taf_sim_client.c:1297
void taf_sim_ConnectService(void)
Definition: taf_sim_client.c:291
taf_sim_Id_t taf_sim_GetSelectedCard(void)
Definition: taf_sim_client.c:853
le_result_t taf_sim_GetICCID(taf_sim_Id_t slotId, char *iccid, size_t iccidSize)
Definition: taf_sim_client.c:702
void taf_sim_DeleteFPLMNList(taf_sim_FPLMNListRef_t fplmnListRef)
Definition: taf_sim_client.c:1676
bool taf_sim_IsPresent(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:638
int32_t taf_sim_GetRemainingPINTries(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:958
le_result_t taf_sim_ChangePIN(taf_sim_Id_t slotId, taf_sim_LockType_t lockType, const char *LE_NONNULL oldpin, const char *LE_NONNULL newpin)
Definition: taf_sim_client.c:926
le_result_t taf_sim_EnterPIN(taf_sim_Id_t slotId, taf_sim_LockType_t lockType, const char *LE_NONNULL pin)
Definition: taf_sim_client.c:897
le_onoff_t
Definition: le_basics.h:95
taf_sim_States_t
Definition: taf_sim_common.h:418
#define LE_NONNULL
Definition: le_basics.h:368
taf_sim_States_t taf_sim_GetState(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:657
taf_sim_AuthenticationResponseHandlerRef_t taf_sim_AddAuthenticationResponseHandler(taf_sim_AuthenticationResponseHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_sim_client.c:597
le_result_t taf_sim_CloseLogicalChannel(taf_sim_Id_t slotId, uint8_t channel)
Definition: taf_sim_client.c:1195
le_result_t
Definition: le_basics.h:45
le_result_t taf_sim_GetAutomaticSelection(bool *enablePtr)
Definition: taf_sim_client.c:1146
le_result_t taf_sim_Reset(taf_sim_Id_t simId)
Definition: taf_sim_client.c:1443
le_result_t taf_sim_Unblock(taf_sim_Id_t slotId, taf_sim_LockType_t lockType, const char *LE_NONNULL puk, const char *LE_NONNULL newpin)
Definition: taf_sim_client.c:1068
taf_sim_IccidChangeHandlerRef_t taf_sim_AddIccidChangeHandler(taf_sim_IccidChangeHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_sim_client.c:1490
le_result_t taf_sim_SendApdu(taf_sim_Id_t simId, const uint8_t *commandApduPtr, size_t commandApduSize, uint8_t *responseApduPtr, size_t *responseApduSizePtr)
Definition: taf_sim_client.c:1259
le_result_t taf_sim_LocalSwapToCommercialSubscription(taf_sim_Id_t simId, taf_sim_Manufacturer_t manufacturer)
Definition: taf_sim_client.c:1390
struct taf_sim_NewStateHandler * taf_sim_NewStateHandlerRef_t
Definition: taf_sim_common.h:597
#define LE_FULL_API
Definition: le_apiFeatures.h:42
le_result_t taf_sim_GetRemainingPUKTries(taf_sim_Id_t slotId, uint32_t *remainingPukTriesPtrPtr)
Definition: taf_sim_client.c:981
le_result_t taf_sim_GetIMSI(taf_sim_Id_t slotId, char *imsi, size_t imsiSize)
Definition: taf_sim_client.c:732
le_result_t taf_sim_IsEmergencyCallSubscriptionSelected(taf_sim_Id_t simId, bool *isEcsPtr)
Definition: taf_sim_client.c:1467
void taf_sim_RemoveNewStateHandler(taf_sim_NewStateHandlerRef_t handlerRef)
Definition: taf_sim_client.c:577
le_result_t taf_sim_GetFirstFPLMNOperator(taf_sim_FPLMNListRef_t fplmnListRef, char *mccPtr, size_t mccPtrSize, char *mncPtr, size_t mncPtrSize)
Definition: taf_sim_client.c:1584
void taf_sim_RemoveIccidChangeHandler(taf_sim_IccidChangeHandlerRef_t handlerRef)
Definition: taf_sim_client.c:1510