Snapdragon® Telematics Application Framework (TelAF) Interface Specification
taf_sim_server.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 le_msg_ServiceRef_t taf_sim_GetServiceRef
27 (
28  void
29 );
30 
31 //--------------------------------------------------------------------------------------------------
35 //--------------------------------------------------------------------------------------------------
37 (
38  void
39 );
40 
41 //--------------------------------------------------------------------------------------------------
45 //--------------------------------------------------------------------------------------------------
47 (
48  void
49 );
50 
51 
52 //--------------------------------------------------------------------------------------------------
268 //--------------------------------------------------------------------------------------------------
269 
270 
271 //--------------------------------------------------------------------------------------------------
275 //--------------------------------------------------------------------------------------------------
276 
277 
278 //--------------------------------------------------------------------------------------------------
282 //--------------------------------------------------------------------------------------------------
283 
284 
285 //--------------------------------------------------------------------------------------------------
289 //--------------------------------------------------------------------------------------------------
290 
291 
292 //--------------------------------------------------------------------------------------------------
295 //--------------------------------------------------------------------------------------------------
296 
297 
298 //--------------------------------------------------------------------------------------------------
302 //--------------------------------------------------------------------------------------------------
303 
304 
305 //--------------------------------------------------------------------------------------------------
310 //--------------------------------------------------------------------------------------------------
311 
312 
313 //--------------------------------------------------------------------------------------------------
317 //--------------------------------------------------------------------------------------------------
318 
319 
320 //--------------------------------------------------------------------------------------------------
324 //--------------------------------------------------------------------------------------------------
325 
326 
327 //--------------------------------------------------------------------------------------------------
331 //--------------------------------------------------------------------------------------------------
332 
333 
334 //--------------------------------------------------------------------------------------------------
339 //--------------------------------------------------------------------------------------------------
340 
341 
342 //--------------------------------------------------------------------------------------------------
346 //--------------------------------------------------------------------------------------------------
347 
348 
349 //--------------------------------------------------------------------------------------------------
354 //--------------------------------------------------------------------------------------------------
355 
356 
357 //--------------------------------------------------------------------------------------------------
361 //--------------------------------------------------------------------------------------------------
362 
363 
364 
365 //--------------------------------------------------------------------------------------------------
371 //--------------------------------------------------------------------------------------------------
373 (
376  void* contextPtr
378 );
379 
380 
381 
382 //--------------------------------------------------------------------------------------------------
386 //--------------------------------------------------------------------------------------------------
388 (
391 );
392 
393 
394 
395 //--------------------------------------------------------------------------------------------------
402 //--------------------------------------------------------------------------------------------------
404 (
407  void* contextPtr
409 );
410 
411 
412 
413 //--------------------------------------------------------------------------------------------------
417 //--------------------------------------------------------------------------------------------------
419 (
422 );
423 
424 
425 
426 //--------------------------------------------------------------------------------------------------
434 //--------------------------------------------------------------------------------------------------
436 (
437  taf_sim_Id_t slotId
439 );
440 
441 
442 
443 //--------------------------------------------------------------------------------------------------
449 //--------------------------------------------------------------------------------------------------
451 (
452  taf_sim_Id_t slotId
454 );
455 
456 
457 
458 //--------------------------------------------------------------------------------------------------
466 //--------------------------------------------------------------------------------------------------
467 bool taf_sim_IsReady
468 (
469  taf_sim_Id_t slotId
471 );
472 
473 
474 
475 //--------------------------------------------------------------------------------------------------
486 //--------------------------------------------------------------------------------------------------
488 (
489  taf_sim_Id_t slotId,
491  char* iccid,
493  size_t iccidSize
495 );
496 
497 
498 
499 //--------------------------------------------------------------------------------------------------
510 //--------------------------------------------------------------------------------------------------
512 (
513  taf_sim_Id_t slotId,
515  char* imsi,
517  size_t imsiSize
519 );
520 
521 
522 
523 //--------------------------------------------------------------------------------------------------
534 //--------------------------------------------------------------------------------------------------
536 (
537  taf_sim_Id_t slotId,
539  char* nameStr,
541  size_t nameStrSize
543 );
544 
545 
546 
547 //--------------------------------------------------------------------------------------------------
558 //--------------------------------------------------------------------------------------------------
560 (
561  taf_sim_Id_t slotId,
563  char* phoneNumberStr,
565  size_t phoneNumberStrSize
567 );
568 
569 
570 
571 //--------------------------------------------------------------------------------------------------
582 //--------------------------------------------------------------------------------------------------
584 (
585  taf_sim_Id_t slotId,
587  char* mccPtr,
589  size_t mccPtrSize,
591  char* mncPtr,
593  size_t mncPtrSize
595 );
596 
597 
598 
599 //--------------------------------------------------------------------------------------------------
605 //--------------------------------------------------------------------------------------------------
607 (
608  void
609 );
610 
611 
612 
613 //--------------------------------------------------------------------------------------------------
622 //--------------------------------------------------------------------------------------------------
624 (
625  taf_sim_Id_t slotId
627 );
628 
629 
630 
631 //--------------------------------------------------------------------------------------------------
642 //--------------------------------------------------------------------------------------------------
644 (
645  taf_sim_Id_t slotId,
647  taf_sim_LockType_t lockType,
649  const char* LE_NONNULL pin
651 );
652 
653 
654 
655 //--------------------------------------------------------------------------------------------------
665 //--------------------------------------------------------------------------------------------------
667 (
668  taf_sim_Id_t slotId,
670  taf_sim_LockType_t lockType,
672  const char* LE_NONNULL oldpin,
674  const char* LE_NONNULL newpin
676 );
677 
678 
679 
680 //--------------------------------------------------------------------------------------------------
690 //--------------------------------------------------------------------------------------------------
692 (
693  taf_sim_Id_t slotId
695 );
696 
697 
698 
699 //--------------------------------------------------------------------------------------------------
709 //--------------------------------------------------------------------------------------------------
711 (
712  taf_sim_Id_t slotId,
714  uint32_t* remainingPukTriesPtrPtr
716 );
717 
718 
719 
720 //--------------------------------------------------------------------------------------------------
730 //--------------------------------------------------------------------------------------------------
732 (
733  taf_sim_Id_t slotId,
735  taf_sim_LockType_t lockType,
737  const char* LE_NONNULL pin
739 );
740 
741 
742 
743 //--------------------------------------------------------------------------------------------------
754 //--------------------------------------------------------------------------------------------------
756 (
757  taf_sim_Id_t slotId,
759  taf_sim_LockType_t lockType,
761  const char* LE_NONNULL pin
763 );
764 
765 
766 
767 //--------------------------------------------------------------------------------------------------
779 //--------------------------------------------------------------------------------------------------
781 (
782  taf_sim_Id_t slotId,
784  taf_sim_LockType_t lockType,
786  const char* LE_NONNULL puk,
788  const char* LE_NONNULL newpin
790 );
791 
792 
793 
794 //--------------------------------------------------------------------------------------------------
802 //--------------------------------------------------------------------------------------------------
804 (
805  taf_sim_Id_t slotId,
807  char* eid,
809  size_t eidSize
811 );
812 
813 
814 
815 //--------------------------------------------------------------------------------------------------
823 //--------------------------------------------------------------------------------------------------
825 (
826  bool enable
828 );
829 
830 
831 
832 //--------------------------------------------------------------------------------------------------
840 //--------------------------------------------------------------------------------------------------
842 (
843  bool* enablePtr
845 );
846 
847 
848 
849 //--------------------------------------------------------------------------------------------------
858 //--------------------------------------------------------------------------------------------------
860 (
861  taf_sim_Id_t slotId,
863  taf_sim_AppType_t apptype,
865  uint8_t* channelPtrPtr
867 );
868 
869 
870 
871 //--------------------------------------------------------------------------------------------------
879 //--------------------------------------------------------------------------------------------------
881 (
882  taf_sim_Id_t slotId,
884  uint8_t channel
886 );
887 
888 
889 
890 //--------------------------------------------------------------------------------------------------
900 //--------------------------------------------------------------------------------------------------
902 (
903  taf_sim_Id_t simId,
905  uint8_t channel,
907  const uint8_t* commandApduPtr,
909  size_t commandApduSize,
911  uint8_t* responseApduPtr,
913  size_t* responseApduSizePtr
915 );
916 
917 
918 
919 //--------------------------------------------------------------------------------------------------
929 //--------------------------------------------------------------------------------------------------
931 (
932  taf_sim_Id_t simId,
934  const uint8_t* commandApduPtr,
936  size_t commandApduSize,
938  uint8_t* responseApduPtr,
940  size_t* responseApduSizePtr
942 );
943 
944 
945 
946 //--------------------------------------------------------------------------------------------------
959 //--------------------------------------------------------------------------------------------------
961 (
962  taf_sim_Id_t simId,
964  taf_sim_Command_t command,
966  const char* LE_NONNULL fileIdentifier,
968  uint8_t p1,
970  uint8_t p2,
972  uint8_t p3,
974  const uint8_t* dataPtr,
976  size_t dataSize,
978  const char* LE_NONNULL path,
980  uint8_t* sw1Ptr,
982  uint8_t* sw2Ptr,
984  uint8_t* responsePtr,
986  size_t* responseSizePtr
988 );
989 
990 
991 
992 //--------------------------------------------------------------------------------------------------
1006 //--------------------------------------------------------------------------------------------------
1008 (
1009  taf_sim_Id_t simId,
1011  taf_sim_Manufacturer_t manufacturer
1013 );
1014 
1015 
1016 
1017 //--------------------------------------------------------------------------------------------------
1031 //--------------------------------------------------------------------------------------------------
1033 (
1034  taf_sim_Id_t simId,
1036  taf_sim_Manufacturer_t manufacturer
1038 );
1039 
1040 
1041 
1042 //--------------------------------------------------------------------------------------------------
1055 //--------------------------------------------------------------------------------------------------
1057 (
1058  taf_sim_Id_t simId,
1060  le_onoff_t power
1062 );
1063 
1064 
1065 
1066 //--------------------------------------------------------------------------------------------------
1074 //--------------------------------------------------------------------------------------------------
1076 (
1077  taf_sim_Id_t simId
1079 );
1080 
1081 
1082 
1083 //--------------------------------------------------------------------------------------------------
1094 //--------------------------------------------------------------------------------------------------
1096 (
1097  taf_sim_Id_t simId,
1099  bool* isEcsPtr
1101 );
1102 
1103 
1104 
1105 //--------------------------------------------------------------------------------------------------
1112 //--------------------------------------------------------------------------------------------------
1114 (
1117  void* contextPtr
1119 );
1120 
1121 
1122 
1123 //--------------------------------------------------------------------------------------------------
1127 //--------------------------------------------------------------------------------------------------
1129 (
1132 );
1133 
1134 
1135 
1136 //--------------------------------------------------------------------------------------------------
1144 //--------------------------------------------------------------------------------------------------
1146 (
1147  void
1148 );
1149 
1150 
1151 
1152 //--------------------------------------------------------------------------------------------------
1162 //--------------------------------------------------------------------------------------------------
1164 (
1165  taf_sim_FPLMNListRef_t fplmnListRef,
1167  const char* LE_NONNULL mcc,
1169  const char* LE_NONNULL mnc
1171 );
1172 
1173 
1174 
1175 //--------------------------------------------------------------------------------------------------
1188 //--------------------------------------------------------------------------------------------------
1190 (
1191  taf_sim_FPLMNListRef_t fplmnListRef,
1193  char* mccPtr,
1195  size_t mccPtrSize,
1197  char* mncPtr,
1199  size_t mncPtrSize
1201 );
1202 
1203 
1204 
1205 //--------------------------------------------------------------------------------------------------
1217 //--------------------------------------------------------------------------------------------------
1219 (
1220  taf_sim_FPLMNListRef_t fplmnListRef,
1222  char* mccPtr,
1224  size_t mccPtrSize,
1226  char* mncPtr,
1228  size_t mncPtrSize
1230 );
1231 
1232 
1233 
1234 //--------------------------------------------------------------------------------------------------
1242 //--------------------------------------------------------------------------------------------------
1244 (
1245  taf_sim_Id_t simId
1247 );
1248 
1249 
1250 
1251 //--------------------------------------------------------------------------------------------------
1260 //--------------------------------------------------------------------------------------------------
1262 (
1263  taf_sim_FPLMNListRef_t fplmnListRef
1265 );
1266 
1267 
1268 
1269 //--------------------------------------------------------------------------------------------------
1279 //--------------------------------------------------------------------------------------------------
1281 (
1282  taf_sim_Id_t simId,
1284  taf_sim_FPLMNListRef_t fplmnListRef
1286 );
1287 
1288 
1289 
1290 //--------------------------------------------------------------------------------------------------
1298 //--------------------------------------------------------------------------------------------------
1300 (
1301  int32_t* countPtr
1303 );
1304 
1305 
1306 #endif // TAF_SIM_INTERFACE_H_INCLUDE_GUARD
le_result_t taf_sim_SetPower(taf_sim_Id_t simId, le_onoff_t power)
Definition: taf_sim_client.c:1419
taf_sim_LockType_t
Definition: taf_sim_common.h:488
le_result_t taf_sim_SelectCard(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:873
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
void(* taf_sim_NewStateHandlerFunc_t)(taf_sim_Id_t slotId, taf_sim_States_t state, void *contextPtr)
Definition: taf_sim_common.h:622
taf_sim_FPLMNListRef_t taf_sim_ReadFPLMNList(taf_sim_Id_t simId)
Definition: taf_sim_client.c:1654
le_result_t taf_sim_LocalSwapToCommercialSubscription(taf_sim_Id_t simId, taf_sim_Manufacturer_t manufacturer)
Definition: taf_sim_client.c:1390
taf_sim_Command_t
Definition: taf_sim_common.h:574
taf_sim_FPLMNListRef_t taf_sim_CreateFPLMNList(void)
Definition: taf_sim_client.c:1531
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_AuthenticationResponseHandlerRef_t taf_sim_AddAuthenticationResponseHandler(taf_sim_AuthenticationResponseHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_sim_client.c:597
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
le_result_t taf_sim_GetSlotCount(int32_t *countPtr)
Definition: taf_sim_client.c:1723
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
le_result_t taf_sim_LocalSwapToEmergencyCallSubscription(taf_sim_Id_t simId, taf_sim_Manufacturer_t manufacturer)
Definition: taf_sim_client.c:1360
void taf_sim_RemoveIccidChangeHandler(taf_sim_IccidChangeHandlerRef_t handlerRef)
Definition: taf_sim_client.c:1510
void taf_sim_AdvertiseService(void)
Definition: taf_sim_server.c:296
le_result_t taf_sim_WriteFPLMNList(taf_sim_Id_t simId, taf_sim_FPLMNListRef_t fplmnListRef)
Definition: taf_sim_client.c:1699
int32_t taf_sim_GetRemainingPINTries(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:958
le_msg_ServiceRef_t taf_sim_GetServiceRef(void)
Definition: taf_sim_server.c:269
le_result_t taf_sim_CloseLogicalChannel(taf_sim_Id_t slotId, uint8_t channel)
Definition: taf_sim_client.c:1195
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
le_result_t taf_sim_GetEID(taf_sim_Id_t slotId, char *eid, size_t eidSize)
Definition: taf_sim_client.c:1098
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
struct taf_sim_FPLMNList * taf_sim_FPLMNListRef_t
Definition: taf_sim_common.h:410
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
taf_sim_Manufacturer_t
Definition: taf_sim_common.h:551
struct taf_sim_AuthenticationResponseHandler * taf_sim_AuthenticationResponseHandlerRef_t
Definition: taf_sim_common.h:605
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
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_GetNextFPLMNOperator(taf_sim_FPLMNListRef_t fplmnListRef, char *mccPtr, size_t mccPtrSize, char *mncPtr, size_t mncPtrSize)
Definition: taf_sim_client.c:1621
taf_sim_AppType_t
Definition: taf_sim_common.h:527
taf_sim_Id_t
Definition: taf_sim_common.h:465
void taf_sim_RemoveNewStateHandler(taf_sim_NewStateHandlerRef_t handlerRef)
Definition: taf_sim_client.c:577
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
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
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_IccidChangeHandlerFunc_t)(taf_sim_Id_t simId, const char *LE_NONNULL iccid, void *contextPtr)
Definition: taf_sim_common.h:656
struct taf_sim_IccidChangeHandler * taf_sim_IccidChangeHandlerRef_t
Definition: taf_sim_common.h:613
le_result_t taf_sim_GetHomeNetworkOperator(taf_sim_Id_t slotId, char *nameStr, size_t nameStrSize)
Definition: taf_sim_client.c:762
bool taf_sim_IsPresent(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:638
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
taf_sim_Id_t taf_sim_GetSelectedCard(void)
Definition: taf_sim_client.c:853
le_msg_SessionRef_t taf_sim_GetClientSessionRef(void)
Definition: taf_sim_server.c:282
le_onoff_t
Definition: le_basics.h:95
le_result_t taf_sim_SetAutomaticSelection(bool enable)
Definition: taf_sim_client.c:1125
taf_sim_States_t
Definition: taf_sim_common.h:418
le_result_t taf_sim_GetAutomaticSelection(bool *enablePtr)
Definition: taf_sim_client.c:1146
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
#define LE_NONNULL
Definition: le_basics.h:368
taf_sim_IccidChangeHandlerRef_t taf_sim_AddIccidChangeHandler(taf_sim_IccidChangeHandlerFunc_t handlerPtr, void *contextPtr)
Definition: taf_sim_client.c:1490
le_result_t
Definition: le_basics.h:45
le_result_t taf_sim_GetRemainingPUKTries(taf_sim_Id_t slotId, uint32_t *remainingPukTriesPtrPtr)
Definition: taf_sim_client.c:981
taf_sim_States_t taf_sim_GetState(taf_sim_Id_t slotId)
Definition: taf_sim_client.c:657
struct le_msg_Session * le_msg_SessionRef_t
Definition: le_messaging.h:860
struct taf_sim_NewStateHandler * taf_sim_NewStateHandlerRef_t
Definition: taf_sim_common.h:597
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
le_result_t taf_sim_IsEmergencyCallSubscriptionSelected(taf_sim_Id_t simId, bool *isEcsPtr)
Definition: taf_sim_client.c:1467
void taf_sim_RemoveAuthenticationResponseHandler(taf_sim_AuthenticationResponseHandlerRef_t handlerRef)
Definition: taf_sim_client.c:617