Snapdragon® Telematics Application Framework (TelAF) Interface Specification
|
Go to the source code of this file.
Data Structures | |
struct | taf_dcs_DefaultGatewayAddresses_t |
struct | taf_dcs_DnsServerAddresses_t |
struct | taf_dcs_StateInfo_t |
struct | taf_dcs_RoamingStatusInd_t |
struct | taf_dcs_ProfileInfo_t |
Typedefs | |
typedef struct taf_dcs_Profile * | taf_dcs_ProfileRef_t |
typedef struct taf_dcs_Call * | taf_dcs_CallRef_t |
typedef uint32_t | taf_dcs_Auth_t |
typedef uint32_t | taf_dcs_ApnType_t |
typedef struct taf_dcs_SessionStateHandler * | taf_dcs_SessionStateHandlerRef_t |
typedef struct taf_dcs_RoamingStatusHandler * | taf_dcs_RoamingStatusHandlerRef_t |
typedef void(* | taf_dcs_AsyncSessionHandlerFunc_t) (taf_dcs_ProfileRef_t profileRef, le_result_t result, void *contextPtr) |
typedef 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) |
typedef void(* | taf_dcs_RoamingStatusHandlerFunc_t) (const taf_dcs_RoamingStatusInd_t *LE_NONNULL roamingStatusIndPtr, void *contextPtr) |
typedef void(* | taf_dcs_ProfileListHandlerFunc_t) (le_result_t result, const taf_dcs_ProfileInfo_t *profileListPtr, size_t profileListSize, void *contextPtr) |
#define IFGEN_TAF_DCS_PROTOCOL_ID "68cf9aa5086404da8037281238787893" |
#define IFGEN_TAF_DCS_MSG_SIZE 2320 |
#define TAF_DCS_NAME_MAX_LEN 64 |
The common name (string) maximum length.
#define TAF_DCS_NAME_MAX_BYTES 65 |
The common name (string) maximum Bytes.
#define TAF_DCS_MAX_CALL_OBJ 32 |
The maximum number of call contexts.
#define TAF_DCS_MAX_SESSION_REF 32 |
The maximum number of session references.
#define TAF_DCS_APN_NAME_MAX_LEN 64 |
The APN name (string) maximum length.
#define TAF_DCS_APN_NAME_MAX_BYTES 65 |
The APN name (string) maximum Bytes.
#define TAF_DCS_USER_NAME_MAX_LEN 64 |
The authorized username (string) maximum length.
#define TAF_DCS_PASSWORD_NAME_MAX_LEN 64 |
The authorized user's password (string) maximum length.
#define TAF_DCS_USER_NAME_MAX_BYTES 65 |
The authorized user's username (string) maximum Bytes.
#define TAF_DCS_PASSWORD_NAME_MAX_BYTES 65 |
The authorized user's password (string) maximum Bytes.
#define TAF_DCS_IPV4_ADDR_MAX_LEN 16 |
The IPv4 address maximum length.
#define TAF_DCS_IPV6_ADDR_MAX_LEN 46 |
The IPv6 address ("ffff:ffff:ffff:ffff:ffff:ffff:255:255:255:255") maximum length.
#define TAF_DCS_DEFAULT_PROFILE 1 |
The default cellular profile index.
#define TAF_DCS_PROFILE_LIST_MAX_ENTRY 32 |
The maximum number of entries for cellular profiles.
#define TAF_DCS_MAX_ASYNC_HANDLER_MAPPING 20 |
The maximum number of mappings for a handler session.
#define TAF_DCS_AUTH_NONE 0x1 |
The data profile authentication type.
#define TAF_DCS_AUTH_PAP 0x2 |
#define TAF_DCS_AUTH_CHAP 0x4 |
#define TAF_DCS_APN_TYPE_DEFAULT 0x1 |
The APN type
#define TAF_DCS_APN_TYPE_IMS 0x2 |
#define TAF_DCS_APN_TYPE_MMS 0x4 |
#define TAF_DCS_APN_TYPE_DUN 0x8 |
#define TAF_DCS_APN_TYPE_SUPL 0x10 |
#define TAF_DCS_APN_TYPE_HIPRI 0x20 |
#define TAF_DCS_APN_TYPE_FOTA 0x40 |
#define TAF_DCS_APN_TYPE_CBS 0x80 |
#define TAF_DCS_APN_TYPE_IA 0x100 |
#define TAF_DCS_APN_TYPE_EMERGENCY 0x200 |
#define TAF_DCS_APN_TYPE_UT 0x400 |
#define TAF_DCS_APN_TYPE_MCX 0x800 |
typedef struct taf_dcs_Profile* taf_dcs_ProfileRef_t |
Reference to the cellular profile context.
typedef struct taf_dcs_Call* taf_dcs_CallRef_t |
Reference to the data call session context.
typedef uint32_t taf_dcs_Auth_t |
typedef uint32_t taf_dcs_ApnType_t |
typedef struct taf_dcs_SessionStateHandler* taf_dcs_SessionStateHandlerRef_t |
Reference type used by Add/Remove functions for EVENT 'taf_dcs_SessionState'
typedef struct taf_dcs_RoamingStatusHandler* taf_dcs_RoamingStatusHandlerRef_t |
Reference type used by Add/Remove functions for EVENT 'taf_dcs_RoamingStatus'
typedef void(* taf_dcs_AsyncSessionHandlerFunc_t) (taf_dcs_ProfileRef_t profileRef, le_result_t result, void *contextPtr) |
The handler for asynchronous session start or stop result response.
typedef 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) |
The data call session handler.
typedef void(* taf_dcs_RoamingStatusHandlerFunc_t) (const taf_dcs_RoamingStatusInd_t *LE_NONNULL roamingStatusIndPtr, void *contextPtr) |
Handler for roaming status.
typedef void(* taf_dcs_ProfileListHandlerFunc_t) (le_result_t result, const taf_dcs_ProfileInfo_t *profileListPtr, size_t profileListSize, void *contextPtr) |
The handler of the requesting data profile list.
The supported data bearer technology.
enum taf_dcs_ConState_t |
enum taf_dcs_Pdp_t |
enum taf_dcs_Tech_t |
LE_SHARED bool ifgen_taf_dcs_HasLocalBinding | ( | void | ) |
Get if this client bound locally.
LE_SHARED void ifgen_taf_dcs_InitCommonData | ( | void | ) |
Init data that is common across all threads
LE_SHARED void ifgen_taf_dcs_CleanupCommonData | ( | le_msg_SessionRef_t | _ifgen_sessionRef | ) |
Cleanup the data of a session
LE_SHARED le_result_t ifgen_taf_dcs_OpenSession | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
bool | isBlocking | ||
) |
Perform common initialization and open a session
LE_SHARED le_result_t ifgen_taf_dcs_StartSession | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Starts a synchronous data cellular session for the given profile reference.
[in] | profileRef | The profile reference. |
LE_SHARED void ifgen_taf_dcs_StartSessionAsync | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_AsyncSessionHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Starts (asynchronously) a cellular data session for the given profile reference.
[in] | profileRef | The profile reference. |
[in] | handlerPtr | The handler. |
[in] | contextPtr |
LE_SHARED le_result_t ifgen_taf_dcs_StopSession | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Stops (synchronously) a cellular data session for the given profile reference.
[in] | profileRef | The profile reference. |
LE_SHARED void ifgen_taf_dcs_StopSessionAsync | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_AsyncSessionHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Stops (asynchronously) a cellular data session for the given profile reference.
[in] | profileRef | The profile reference. |
[in] | handlerPtr | The handler. |
[in] | contextPtr |
LE_SHARED le_result_t ifgen_taf_dcs_GetInterfaceName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | ifName, | ||
size_t | ifNameSize | ||
) |
Gets a connected data call interface name.
[in] | profileRef | The profile reference. |
[out] | ifName | The interface name. |
[in] | ifNameSize |
LE_SHARED taf_dcs_SessionStateHandlerRef_t ifgen_taf_dcs_AddSessionStateHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_SessionStateHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Add handler function for EVENT 'taf_dcs_SessionState'
The data call session event.
[in] | profileRef | The profile reference. |
[in] | handlerPtr | The event handler reference. |
[in] | contextPtr |
LE_SHARED void ifgen_taf_dcs_RemoveSessionStateHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_SessionStateHandlerRef_t | handlerRef | ||
) |
Remove handler function for EVENT 'taf_dcs_SessionState'
[in] | handlerRef |
LE_SHARED taf_dcs_RoamingStatusHandlerRef_t ifgen_taf_dcs_AddRoamingStatusHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_RoamingStatusHandlerFunc_t | handlerPtr, | ||
void * | contextPtr | ||
) |
Add handler function for EVENT 'taf_dcs_RoamingStatus'
Event to report roaming status.
[in] | handlerPtr | Handler for roaming status. |
[in] | contextPtr |
LE_SHARED void ifgen_taf_dcs_RemoveRoamingStatusHandler | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_RoamingStatusHandlerRef_t | handlerRef | ||
) |
Remove handler function for EVENT 'taf_dcs_RoamingStatus'
[in] | handlerRef |
LE_SHARED le_result_t ifgen_taf_dcs_GetRoamingStatus | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint8_t | phoneId, | ||
bool * | isRoamingPtr, | ||
taf_dcs_RoamingType_t * | typePtr | ||
) |
Gets the roaming status.
[in] | phoneId | The phone ID. |
[out] | isRoamingPtr | True means that roaming is on; False means that |
[out] | typePtr | The roaming type. Valid only if roaming is on. |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv4Address | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | ipAddr, | ||
size_t | ipAddrSize | ||
) |
Gets the connected data session IPv4 address.
[in] | profileRef | The profile reference. |
[out] | ipAddr | The IPv4 address. |
[in] | ipAddrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv4GatewayAddress | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | gatewayAddr, | ||
size_t | gatewayAddrSize | ||
) |
Gets the connected data session IPv4 gateway address.
[in] | profileRef | The profile reference. |
[out] | gatewayAddr | The IPv4 gateway address. |
[in] | gatewayAddrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv4DNSAddresses | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | dns1AddrStr, | ||
size_t | dns1AddrStrSize, | ||
char * | dns2AddrStr, | ||
size_t | dns2AddrStrSize | ||
) |
Gets the connected data session primary and secondary DNS IPv4 addresses.
[in] | profileRef | The profile reference. |
[out] | dns1AddrStr | The IPv4 primary DNS address. |
[in] | dns1AddrStrSize | |
[out] | dns2AddrStr | The IPv4 secondary DNS address. |
[in] | dns2AddrStrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv6Address | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | ipAddr, | ||
size_t | ipAddrSize | ||
) |
Gets the connected data session IPv6 address.
[in] | profileRef | The profile reference. |
[out] | ipAddr | The IPv6 address. |
[in] | ipAddrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv6GatewayAddress | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | gatewayAddr, | ||
size_t | gatewayAddrSize | ||
) |
Gets the connected data session IPv6 gateway address.
[in] | profileRef | The profile reference. |
[out] | gatewayAddr | The IPv6 gateway address. |
[in] | gatewayAddrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetIPv6DNSAddresses | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | dns1AddrStr, | ||
size_t | dns1AddrStrSize, | ||
char * | dns2AddrStr, | ||
size_t | dns2AddrStrSize | ||
) |
Gets the connected data session primary and secondary DNS IPv6 addresses.
[in] | profileRef | The profile reference. |
[out] | dns1AddrStr | The IPv6 primary DNS address. |
[in] | dns1AddrStrSize | |
[out] | dns2AddrStr | The IPv6 secondary DNS address. |
[in] | dns2AddrStrSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetSessionState | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_ConState_t * | connectionStatePtr | ||
) |
Gets the data session's current state.
[in] | profileRef | The profile reference. |
[out] | connectionStatePtr | The connection state. |
LE_SHARED bool ifgen_taf_dcs_IsIPv4 | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Checks if the data session is IPv4.
[in] | profileRef | The profile reference. |
LE_SHARED bool ifgen_taf_dcs_IsIPv6 | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Checks if the data session is IPv6.
[in] | profileRef | The profile reference. |
LE_SHARED le_result_t ifgen_taf_dcs_GetDataBearerTechnology | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_DataBearerTechnology_t * | dlDataBearerTechPtrPtr, | ||
taf_dcs_DataBearerTechnology_t * | ulDataBearerTechPtrPtr | ||
) |
Gets the connected data session data bearer technology.
[in] | profileRef | The profile reference. |
[out] | dlDataBearerTechPtrPtr | The downlink data bearer technology. |
[out] | ulDataBearerTechPtrPtr | The uplink data bearer technology. |
LE_SHARED le_result_t ifgen_taf_dcs_GetProfileList | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileInfo_t * | profileListPtr, | ||
size_t * | profileListSizePtr | ||
) |
Gets the data profile list.
[out] | profileListPtr | The profile list information. |
[in,out] | profileListSizePtr |
LE_SHARED le_result_t ifgen_taf_dcs_GetProfileListEx | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint8_t | phoneId, | ||
taf_dcs_ProfileInfo_t * | profileListPtr, | ||
size_t * | profileListSizePtr | ||
) |
Gets the data profile list with the specified phone ID.
[in] | phoneId | The phone ID. |
[out] | profileListPtr | The profile list information. |
[in,out] | profileListSizePtr |
LE_SHARED uint32_t ifgen_taf_dcs_GetDefaultProfileIndex | ( | le_msg_SessionRef_t | _ifgen_sessionRef | ) |
Gets the default profile index.
LE_SHARED le_result_t ifgen_taf_dcs_GetDefaultPhoneIdAndProfileId | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint8_t * | phoneIdPtr, | ||
uint32_t * | profileIdPtr | ||
) |
Gets the default phone ID and profile index.
[out] | phoneIdPtr | The phone ID. |
[out] | profileIdPtr | The profile index. |
LE_SHARED le_result_t ifgen_taf_dcs_SetDefaultProfileIndex | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint32_t | profileId | ||
) |
Sets the default profile index corresponding to the specified profile index.
[in] | profileId | The profile index. |
LE_SHARED le_result_t ifgen_taf_dcs_SetDefaultProfileIndexEx | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint8_t | phoneId, | ||
uint32_t | profileId | ||
) |
Sets the default profile corresponding to the specified phone ID and profile index.
[in] | phoneId | The phone ID. |
[in] | profileId | The profile index. |
LE_SHARED taf_dcs_ProfileRef_t ifgen_taf_dcs_GetProfile | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint32_t | profileId | ||
) |
Gets the profile reference for the given profile index.
[in] | profileId | The profile index. |
LE_SHARED taf_dcs_ProfileRef_t ifgen_taf_dcs_GetProfileEx | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
uint8_t | phoneId, | ||
uint32_t | profileId | ||
) |
Gets the profile reference for the given phone ID and profile index.
[in] | phoneId | The phone ID. |
[in] | profileId | The profile index. |
LE_SHARED uint32_t ifgen_taf_dcs_GetProfileIndex | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Gets the profile index for the given profile reference.
[in] | profileRef | The profile reference. |
LE_SHARED le_result_t ifgen_taf_dcs_GetPhoneId | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
uint8_t * | phoneIdPtr | ||
) |
Gets the phone ID for the given profile reference.
[in] | profileRef | The profile reference. |
[out] | phoneIdPtr | The phone ID. |
LE_SHARED le_result_t ifgen_taf_dcs_SetAPN | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
const char *LE_NONNULL | apnName | ||
) |
Sets the data profile APN name.
[in] | profileRef | The profile reference. |
[in] | apnName | The APN name. |
LE_SHARED le_result_t ifgen_taf_dcs_GetAPN | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
char * | apnName, | ||
size_t | apnNameSize | ||
) |
Gets the data profile APN name.
[in] | profileRef | The profile reference. |
[out] | apnName | The APN name. |
[in] | apnNameSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetApnTypes | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_ApnType_t * | apnTypePtr | ||
) |
Gets the data profile APN types.
[in] | profileRef | The profile reference. |
[out] | apnTypePtr | The APN type. |
LE_SHARED le_result_t ifgen_taf_dcs_SetPDP | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_Pdp_t | pdp | ||
) |
Sets the data profile PDP type.
[in] | profileRef | The profile reference. |
[in] | pdp | The PDP type. |
LE_SHARED taf_dcs_Pdp_t ifgen_taf_dcs_GetPDP | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef | ||
) |
Gets the data profile PDP type.
[in] | profileRef | The profile reference. |
LE_SHARED le_result_t ifgen_taf_dcs_SetAuthentication | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_Auth_t | auth, | ||
const char *LE_NONNULL | userName, | ||
const char *LE_NONNULL | password | ||
) |
Set the data profile authentication type and username/password.
[in] | profileRef | The profile reference. |
[in] | auth | The authentication type. |
[in] | userName | The username. |
[in] | password | The password. |
LE_SHARED le_result_t ifgen_taf_dcs_GetAuthentication | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
taf_dcs_ProfileRef_t | profileRef, | ||
taf_dcs_Auth_t * | authPtr, | ||
char * | userName, | ||
size_t | userNameSize, | ||
char * | password, | ||
size_t | passwordSize | ||
) |
Gets the data profile authentication type and username/password.
[in] | profileRef | The profile reference. |
[out] | authPtr | The authentication type. |
[out] | userName | The username. |
[in] | userNameSize | |
[out] | password | The password. |
[in] | passwordSize |
LE_SHARED le_result_t ifgen_taf_dcs_GetProfileIdByInterfaceName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
const char *LE_NONNULL | ifName, | ||
uint32_t * | profileIdPtr | ||
) |
Gets the data profile index by the interface name.
[in] | ifName | The interface name. |
[out] | profileIdPtr | The profile index. |
LE_SHARED le_result_t ifgen_taf_dcs_GetPhoneIdByInterfaceName | ( | le_msg_SessionRef_t | _ifgen_sessionRef, |
const char *LE_NONNULL | ifName, | ||
uint8_t * | phoneIdPtr | ||
) |
Gets the phone ID by the interface name.
[in] | ifName | The interface name. |
[out] | phoneIdPtr | The phone ID. |