Snapdragon® Telematics Application Framework (TelAF) Interface Specification
|
Go to the source code of this file.
Macros | |
#define | IFGEN_TAF_SIMRSP_PROTOCOL_ID "bd560854534a28c278ac3577550149c1" |
#define | IFGEN_TAF_SIMRSP_MSG_SIZE 2068 |
#define | TAF_SIMRSP_EID_LEN 32 |
#define | TAF_SIMRSP_EID_BYTES 33 |
#define | TAF_SIMRSP_MAX_PROFILE 32 |
#define | TAF_SIMRSP_NAME_LEN 64 |
#define | TAF_SIMRSP_NAME_BYTES 65 |
#define | TAF_SIMRSP_SPN_LEN 32 |
#define | TAF_SIMRSP_SMDP_LEN 1024 |
#define | TAF_SIMRSP_ICCID_LEN 20 |
#define | TAF_SIMRSP_ICCID_BYTES 21 |
#define | TAF_SIMRSP_NICKNAME_LEN 64 |
#define | TAF_SIMRSP_NICKNAME_BYTES 65 |
#define | TAF_SIMRSP_ACTIVATION_CODE_LEN 256 |
#define | TAF_SIMRSP_ACTIVATION_CODE_BYTES 257 |
#define | TAF_SIMRSP_CODE_LEN 256 |
#define | TAF_SIMRSP_CODE_BYTES 257 |
Typedefs | |
typedef struct taf_simRsp_ProfileListNode * | taf_simRsp_ProfileListNodeRef_t |
typedef struct taf_simRsp_ProfileDownloadHandler * | taf_simRsp_ProfileDownloadHandlerRef_t |
typedef struct taf_simRsp_ProfileUserConsentHandler * | taf_simRsp_ProfileUserConsentHandlerRef_t |
typedef struct taf_simRsp_ProfileConfirmationCodeHandler * | taf_simRsp_ProfileConfirmationCodeHandlerRef_t |
typedef void(* | taf_simRsp_ProfileDownloadHandlerFunc_t) (taf_sim_Id_t slotId, taf_simRsp_DownloadStatus_t downloadStatus, taf_simRsp_DownloadErrorCause_t errorCause, void *contextPtr) |
typedef void(* | taf_simRsp_ProfileUserConsentHandlerFunc_t) (taf_sim_Id_t slotId, bool userConsentRequired, uint8_t mask, void *contextPtr) |
typedef void(* | taf_simRsp_ProfileConfirmationCodeHandlerFunc_t) (taf_sim_Id_t slotId, const char *LE_NONNULL profileName, void *contextPtr) |
Enumerations | |
enum | taf_simRsp_ProfileType_t { TAF_SIMRSP_UNKNOWN = -1, TAF_SIMRSP_REGULAR = 0, TAF_SIMRSP_EMERGENCY = 1 } |
enum | taf_simRsp_IconType_t { TAF_SIMRSP_NONE = 0, TAF_SIMRSP_JPEG = 1, TAF_SIMRSP_PNG = 2 } |
enum | taf_simRsp_ProfileClass_t { TAF_SIMRSP_TEST = 0, TAF_SIMRSP_PROVISIONING = 1, TAF_SIMRSP_OPERATIONAL = 2 } |
enum | taf_simRsp_PolicyRuleType_t { TAF_SIMRSP_PROFILE_DISABLE_NOT_ALLOWED = 0, TAF_SIMRSP_PROFILE_DELETE_NOT_ALLOWED = 1, TAF_SIMRSP_PROFILE_DELETE_ON_DISABLE = 2 } |
enum | taf_simRsp_DownloadStatus_t { TAF_SIMRSP_DOWNLOAD_ERROR = 0, TAF_SIMRSP_DOWNLOAD_INSTALLATION_COMPLETE = 1 } |
enum | taf_simRsp_DownloadErrorCause_t { TAF_SIMRSP_GENERIC = 1, TAF_SIMRSP_SIM = 2, TAF_SIMRSP_NETWORK = 3, TAF_SIMRSP_MEMORY = 4, TAF_SIMRSP_UNSUPPORTED_PROFILE_CLASS = 5, TAF_SIMRSP_PPR_NOT_ALLOWED = 6, TAF_SIMRSP_END_USER_REJECTION = 7, TAF_SIMRSP_END_USER_POSTPONED = 8 } |
enum | taf_simRsp_UserConsentReasonType_t { TAF_SIMRSP_USER_REJECTION = 0, TAF_SIMRSP_USER_POSTPONED = 1 } |
#define IFGEN_TAF_SIMRSP_PROTOCOL_ID "bd560854534a28c278ac3577550149c1" |
#define IFGEN_TAF_SIMRSP_MSG_SIZE 2068 |
#define TAF_SIMRSP_EID_LEN 32 |
#define TAF_SIMRSP_EID_BYTES 33 |
#define TAF_SIMRSP_MAX_PROFILE 32 |
#define TAF_SIMRSP_NAME_LEN 64 |
#define TAF_SIMRSP_NAME_BYTES 65 |
#define TAF_SIMRSP_SPN_LEN 32 |
#define TAF_SIMRSP_SMDP_LEN 1024 |
#define TAF_SIMRSP_ICCID_LEN 20 |
#define TAF_SIMRSP_ICCID_BYTES 21 |
#define TAF_SIMRSP_NICKNAME_LEN 64 |
#define TAF_SIMRSP_NICKNAME_BYTES 65 |
#define TAF_SIMRSP_ACTIVATION_CODE_LEN 256 |
#define TAF_SIMRSP_ACTIVATION_CODE_BYTES 257 |
#define TAF_SIMRSP_CODE_LEN 256 |
#define TAF_SIMRSP_CODE_BYTES 257 |
typedef struct taf_simRsp_ProfileListNode* taf_simRsp_ProfileListNodeRef_t |
typedef struct taf_simRsp_ProfileDownloadHandler* taf_simRsp_ProfileDownloadHandlerRef_t |
Reference type used by Add/Remove functions for EVENT 'taf_simRsp_ProfileDownload'
typedef struct taf_simRsp_ProfileUserConsentHandler* taf_simRsp_ProfileUserConsentHandlerRef_t |
Reference type used by Add/Remove functions for EVENT 'taf_simRsp_ProfileUserConsent'
typedef struct taf_simRsp_ProfileConfirmationCodeHandler* taf_simRsp_ProfileConfirmationCodeHandlerRef_t |
Reference type used by Add/Remove functions for EVENT 'taf_simRsp_ProfileConfirmationCode'
typedef void(* taf_simRsp_ProfileDownloadHandlerFunc_t) (taf_sim_Id_t slotId, taf_simRsp_DownloadStatus_t downloadStatus, taf_simRsp_DownloadErrorCause_t errorCause, void *contextPtr) |
Handler for profile download.
typedef void(* taf_simRsp_ProfileUserConsentHandlerFunc_t) (taf_sim_Id_t slotId, bool userConsentRequired, uint8_t mask, void *contextPtr) |
Handler for consent of profile management.
typedef void(* taf_simRsp_ProfileConfirmationCodeHandlerFunc_t) (taf_sim_Id_t slotId, const char *LE_NONNULL profileName, void *contextPtr) |
Handler for confirmation code of profile.
Defines profile policy rules (PPR). Each value represents the corresponding bit for the PprMask bitset.
Indicates the profile download error cause.
LE_SHARED bool ifgen_taf_simRsp_HasLocalBinding | ( | void | ) |
Get if this client bound locally.
LE_SHARED void ifgen_taf_simRsp_InitCommonData | ( | void | ) |
Init data that is common across all threads
LE_SHARED void ifgen_taf_simRsp_CleanupCommonData | ( | le_msg_SessionRef_t | _ifgen_sessionRef | ) |
Cleanup the data of a session
LE_SHARED le_result_t ifgen_taf_simRsp_OpenSession | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
bool | isBlocking | ||
) |
Perform common initialization and open a session
LE_SHARED taf_simRsp_ProfileDownloadHandlerRef_t ifgen_taf_simRsp_AddProfileDownloadHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileDownloadHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Add handler function for EVENT 'taf_simRsp_ProfileDownload'
Event for profile download.
[in] | handlerPtr | Handler for profile download. |
[in] | contextPtr |
LE_SHARED void ifgen_taf_simRsp_RemoveProfileDownloadHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileDownloadHandlerRef_t | handlerRef | ||
) |
Remove handler function for EVENT 'taf_simRsp_ProfileDownload'
[in] | handlerRef |
LE_SHARED taf_simRsp_ProfileUserConsentHandlerRef_t ifgen_taf_simRsp_AddProfileUserConsentHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileUserConsentHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Add handler function for EVENT 'taf_simRsp_ProfileUserConsent'
User consent of profile management.
[in] | handlerPtr | Handler of user consent. |
[in] | contextPtr |
LE_SHARED void ifgen_taf_simRsp_RemoveProfileUserConsentHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileUserConsentHandlerRef_t | handlerRef | ||
) |
Remove handler function for EVENT 'taf_simRsp_ProfileUserConsent'
[in] | handlerRef |
LE_SHARED taf_simRsp_ProfileConfirmationCodeHandlerRef_t ifgen_taf_simRsp_AddProfileConfirmationCodeHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileConfirmationCodeHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Add handler function for EVENT 'taf_simRsp_ProfileConfirmationCode'
Event for confirmation code of profile.
[in] | handlerPtr | Handler of profile confirmation code. |
[in] | contextPtr |
LE_SHARED void ifgen_taf_simRsp_RemoveProfileConfirmationCodeHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileConfirmationCodeHandlerRef_t | handlerRef | ||
) |
Remove handler function for EVENT 'taf_simRsp_ProfileConfirmationCode'
[in] | handlerRef |
LE_SHARED le_result_t ifgen_taf_simRsp_GetEID | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
char * | eid, | ||
size_t | eidSize | ||
) |
Request eUICC identifier (EID) for the slot.
[in] | slotId | SIM slot ID. |
[out] | eid | EID as output. |
[in] | eidSize |
LE_SHARED le_result_t ifgen_taf_simRsp_AddProfile | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
const char *LE_NONNULL | activationCode, | ||
const char *LE_NONNULL | confirmationCode, | ||
bool | userConsentSupported | ||
) |
Adds a new profile to the eUICC card and downloads and installs the profile on the eUICC.
[in] | slotId | SIM slot ID. |
[in] | activationCode | Activation code. |
[in] | confirmationCode | Confirmation code. |
[in] | userConsentSupported | Whether user consent is |
LE_SHARED le_result_t ifgen_taf_simRsp_DeleteProfile | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
uint32_t | profileId | ||
) |
Deletes a profile from the eUICC card.
[in] | slotId | SIM slot ID. |
[in] | profileId | Profile ID. |
LE_SHARED le_result_t ifgen_taf_simRsp_SetProfile | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
uint32_t | profileId, | ||
bool | enable | ||
) |
Enables or disables the profile which allows switching another profile on the eUICC card.
[in] | slotId | SIM slot ID. |
[in] | profileId | Profile ID. |
[in] | enable | Enabled or not; true if enabling, false if disabling. |
LE_SHARED le_result_t ifgen_taf_simRsp_UpdateNickName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
uint32_t | profileId, | ||
const char *LE_NONNULL | nickName | ||
) |
Updates the profile's nick name.
[in] | slotId | SIM slot ID. |
[in] | profileId | Profile ID. |
[in] | nickName | Nick name. |
LE_SHARED le_result_t ifgen_taf_simRsp_GetProfileList | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
taf_simRsp_ProfileListNodeRef_t * | profileListPtr, | ||
size_t * | profileListSizePtr | ||
) |
Requests a list of profiles supported by the eUICC card.
[in] | slotId | SIM slot ID. |
[out] | profileListPtr | Profile list as output. |
[in,out] | profileListSizePtr |
LE_SHARED le_result_t ifgen_taf_simRsp_SetServerAddress | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
const char *LE_NONNULL | smdpAdress | ||
) |
Sets the Subscription Manager Data Preparation (SM-DP+) address on the eUICC. If the SM-DP+ address length is zero then the existing SM-DP+ address on the eUICC is removed.
[in] | slotId | SIM slot ID. |
[in] | smdpAdress | SM-DP+ address. |
LE_SHARED le_result_t ifgen_taf_simRsp_GetServerAddress | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
char * | smdpAdress, | ||
size_t | smdpAdressSize, | ||
char * | smdsdress, | ||
size_t | smdsdressSize | ||
) |
Gets the SM-DP+ address and the Subscription Manager Discovery Server (SMDS) address configured on the eUICC.
[in] | slotId | SIM slot ID. |
[out] | smdpAdress | SM-DP+ address. |
[in] | smdpAdressSize | |
[out] | smdsdress | SMDS address. |
[in] | smdsdressSize |
LE_SHARED le_result_t ifgen_taf_simRsp_ProvideUserConsent | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
bool | userConsent, | ||
taf_simRsp_UserConsentReasonType_t | reason | ||
) |
Provides user consent required for downloading and installing a profile. This API should be called in response to a ProfileUserConsent event.
[in] | slotId | SIM slot ID. |
[in] | userConsent | User consent. |
[in] | reason | User consent reason. |
LE_SHARED le_result_t ifgen_taf_simRsp_ProvideConfirmationCode | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_sim_Id_t | slotId, | ||
const char *LE_NONNULL | code | ||
) |
Provides the confirmation code required for downloading and installing the profile. This API should be called in response to a ProfileConfirmationCode event.
[in] | slotId | SIM slot ID. |
[in] | code | Confirmation code. |
LE_SHARED taf_simRsp_ProfileListNodeRef_t ifgen_taf_simRsp_GetProfile | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint32_t | index | ||
) |
Returns the opaque type (ProfileListNode) reference for a profile, specified using the profile index.
[in] | index | Profile index. |
LE_SHARED uint32_t ifgen_taf_simRsp_GetProfileIndex | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Returns profileIndex for a profile, specified using the ProfileListNode type reference.
[in] | profileRef |
LE_SHARED taf_simRsp_ProfileType_t ifgen_taf_simRsp_GetProfileType | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Returns the profile type for a profile, specified using the ProfileListNode type reference.
[in] | profileRef |
LE_SHARED le_result_t ifgen_taf_simRsp_GetIccid | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef, | ||
char * | iccid, | ||
size_t | iccidSize | ||
) |
Gets the ICCID for a profile, specified using the ProfileListNode type reference.
[in] | profileRef | |
[out] | iccid | |
[in] | iccidSize |
LE_SHARED bool ifgen_taf_simRsp_GetProfileActiveStatus | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Returns whether or not the specified profile is active.
[in] | profileRef |
LE_SHARED le_result_t ifgen_taf_simRsp_GetNickName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef, | ||
char * | nickName, | ||
size_t | nickNameSize | ||
) |
Gets the nickname for the specified profile.
[in] | profileRef | |
[out] | nickName | |
[in] | nickNameSize |
LE_SHARED le_result_t ifgen_taf_simRsp_GetName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef, | ||
char * | name, | ||
size_t | nameSize | ||
) |
Gets the name for the specified profile.
[in] | profileRef | |
[out] | name | |
[in] | nameSize |
LE_SHARED le_result_t ifgen_taf_simRsp_GetSpn | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef, | ||
char * | spn, | ||
size_t | spnSize | ||
) |
Gets the SPN for the specified profile.
[in] | profileRef | |
[out] | spn | |
[in] | spnSize |
LE_SHARED taf_simRsp_IconType_t ifgen_taf_simRsp_GetIconType | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Gets the Icon type for the specified profile.
[in] | profileRef |
LE_SHARED taf_simRsp_ProfileClass_t ifgen_taf_simRsp_GetProfileClass | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Gets the ProfileClass for the specified profile.
[in] | profileRef |
LE_SHARED uint32_t ifgen_taf_simRsp_GetMask | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_simRsp_ProfileListNodeRef_t | profileRef | ||
) |
Gets the Mask for the specified profile.
[in] | profileRef |