Card Application Toolkit Service
[Telephony Mgr]

Detailed Description

This service groups the Telephony card application toolkit functions.

Data Structures

struct _AlpTelCatBuffer

< used in: SendData, SendDTMF, Send USSD, Send SS More...

struct _AlpTelCatCmdParams

struct _AlpTelCatCmdResponse

struct _AlpTelCatConfig

struct _AlpTelCatDisplayText

struct _AlpTelCatEventToCard

struct _AlpTelCatGetInkey

struct _AlpTelCatGetInput

struct _AlpTelCatItem

struct _AlpTelCatItemList

struct _AlpTelCatLaunchBrowser

struct _AlpTelCatLocalInfo

struct _AlpTelCatMEanswer

struct _AlpTelCatMenuSelection

struct _AlpTelCatOpenChannel

struct _AlpTelCatPlayTone

struct _AlpTelCatRefreshFileList

struct _AlpTelCatSendShortMessage

struct _AlpTelCatSetUpCall

struct _AlpTelCatSetUpEventList

struct _AlpTelCatSIManswer

struct _AlpTelCatSSOperation

< used in Send SS More...

Defines

#define ALP_TEL_CALL_CONTROL_ACTION_SS_REQUESTED   0x03

USSD request or voice call is changed by call contol into an SS request.

#define ALP_TEL_CALL_CONTROL_ACTION_USSD_REQUESTED   0x02

SS request or voice call is changed by call contol into an USSD request.

#define ALP_TEL_CALL_CONTROL_ACTION_VOICE_CALL_REQUESTED   0x01

Call control requested action SS Request or USSD request is changed by call control to a voice call request or the address is modified.

#define ALP_TEL_CALL_CONTROL_ALLOWED   0x00

Call Control or MO-SMS control result code.

#define ALP_TEL_CALL_CONTROL_ALLOWED_WITH_MODIFICATIONS   0x02

#define ALP_TEL_CALL_CONTROL_NOT_ALLOWED   0x01

#define ALP_TEL_CAT_ADD_INFO_ACCESS_CONTROL_BAR   0x05

Access control class bar.

#define ALP_TEL_CAT_ADD_INFO_ACTION_NOT_ALLOWED   0x01

Additional Information codes for "Interaction with Call Control by SIM Action not allowed.

#define ALP_TEL_CAT_ADD_INFO_BEARER_UNAVAILABLE   0x01

Additional information codes "launch browser generic error code" Bearer unavailable.

#define ALP_TEL_CAT_ADD_INFO_BROWSER_UNAVAILABLE   0x02

Browser unavailable.

#define ALP_TEL_CAT_ADD_INFO_BUFFER_SIZE_NOT_AVAILABLE   0x04

Requested buffer size not available.

#define ALP_TEL_CAT_ADD_INFO_CHANNEL_CLOSED   0x02

Channel closed.

#define ALP_TEL_CAT_ADD_INFO_CHANNEL_ID_NOT_VALID   0x03

Channel identifier not valid.

#define ALP_TEL_CAT_ADD_INFO_DATA_READ_ERROR   0x03

terminal unable to read the provisioning data

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_CALL   0x02

terminal currently busy on call

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_SEND_DTMF   0x09

ME currently busy on SEND DTMF command.

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_SS   0x03

ME currently busy on SS transaction.

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_USSD   0x08

ME currently busy on USSD transaction.

#define ALP_TEL_CAT_ADD_INFO_NO_CHANNEL_AVAILABLE   0x01

Additional Information codes for "Bearer Independent Protocol error" No channel available.

#define ALP_TEL_CAT_ADD_INFO_NO_NAA_ACTIVE   0x0A

No NAA active.

#define ALP_TEL_CAT_ADD_INFO_NO_RADIO_RESSOURCE   0x06

Radio resource not granted.

#define ALP_TEL_CAT_ADD_INFO_NO_SERVICE   0x04

No service.

#define ALP_TEL_CAT_ADD_INFO_NOT_IN_SPEECH_CALL   0x07

Not in speech call.

#define ALP_TEL_CAT_ADD_INFO_PORT_NOT_AVAILABLE   0x10

Port not available (applicable for OPEN CHANNEL related to UICC Server Mode).

#define ALP_TEL_CAT_ADD_INFO_REMOTE_DEVICE_NOT_REACHABLE   0x07

remote device is not reachable (not present, not physically connected, switched off, etc.)

#define ALP_TEL_CAT_ADD_INFO_REQUEST_TYPE_CHANGE   0x02

The type of request has changed.

#define ALP_TEL_CAT_ADD_INFO_SCREEN_IS_BUSY   0x01

Additional Information codes for "ME currently unable to process command" error Screen is busy.

#define ALP_TEL_CAT_ADD_INFO_SECURITY_ERROR   0x05

Security error (unsuccessful authentication).

#define ALP_TEL_CAT_ADD_INFO_SERVICE_ERROR   0x08

Service error (service not available on remote device).

#define ALP_TEL_CAT_ADD_INFO_SERVICE_IDENTIFIER_UNKNOWN   0x09

Service identifier unknown.

#define ALP_TEL_CAT_ADD_INFO_TRANSPORT_NOT_AVAILABLE   0x06

Requested UICC/terminal interface transport level not available.

#define ALP_TEL_CAT_ADDRESS_IPV4   0x21

Command OPEN CHANNEL parameters or response to OPEN CHANNEL:.

#define ALP_TEL_CAT_ADDRESS_IPV6   0x97

#define ALP_TEL_CAT_BEARER_CSD   0x01

circuit switched data

#define ALP_TEL_CAT_BEARER_GPRS   0x03

#define ALP_TEL_CAT_BEARER_SMS   0x00

short message

#define ALP_TEL_CAT_BEARER_USSD   0x02

#define ALP_TEL_CAT_BLUETOOTH   0x05

Bluetooth.

#define ALP_TEL_CAT_BROWSER_ERROR_TERMINATION   0x01

#define ALP_TEL_CAT_BROWSER_USER_TERMINATION   0x00

Browser termination cause to join in the structure of enveloppe (Browser termination).

#define ALP_TEL_CAT_CALL_ACCEPT   0x01

User accept to setup the call.

#define ALP_TEL_CAT_CALL_ACTION_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0007)

#define ALP_TEL_CAT_CALL_REJECT   0x00

Setup Call actions User did not accept the proactive command SETUP CALL.

#define ALP_TEL_CAT_CLEAR_AFTER_DELAY   0x01

clear after delay

#define ALP_TEL_CAT_CMD_CLOSE_CHANNEL   0x41

#define ALP_TEL_CAT_CMD_DISPLAY_TEXT   0x21

#define ALP_TEL_CAT_CMD_GET_CHANNEL_STATUS   0x44

#define ALP_TEL_CAT_CMD_GET_INKEY   0x22

#define ALP_TEL_CAT_CMD_GET_INPUT   0x23

#define ALP_TEL_CAT_CMD_GET_READER_STATUS   0x33

#define ALP_TEL_CAT_CMD_LANGUAGE_NOTIFICATION   0x35

#define ALP_TEL_CAT_CMD_LAUNCH_BROWSER   0x15

#define ALP_TEL_CAT_CMD_MORE_TIME   0x02

#define ALP_TEL_CAT_CMD_OPEN_CHANNEL   0x40

#define ALP_TEL_CAT_CMD_PERFORM_CARD_APDU   0x30

#define ALP_TEL_CAT_CMD_PLAY_TONE   0x20

#define ALP_TEL_CAT_CMD_POWER_OFF_CARD   0x32

#define ALP_TEL_CAT_CMD_POWER_ON_CARD   0x31

#define ALP_TEL_CAT_CMD_PROVIDE_LOCAL_INFORMATION   0x26

#define ALP_TEL_CAT_CMD_RECEIVE_DATA   0x42

#define ALP_TEL_CAT_CMD_REFRESH   0x01

Proactive Commands Id.

#define ALP_TEL_CAT_CMD_RUN_AT_COMMAND   0x34

#define ALP_TEL_CAT_CMD_SELECT_ITEM   0x24

#define ALP_TEL_CAT_CMD_SEND_DATA   0x43

#define ALP_TEL_CAT_CMD_SEND_DTMF   0x14

#define ALP_TEL_CAT_CMD_SEND_SHORT_MESSAGE   0x13

#define ALP_TEL_CAT_CMD_SEND_SS   0x11

#define ALP_TEL_CAT_CMD_SEND_USSD   0x12

#define ALP_TEL_CAT_CMD_SETUP_CALL   0x10

#define ALP_TEL_CAT_CMD_SETUP_EVENTLIST   0x05

#define ALP_TEL_CAT_CMD_SETUP_IDLE_MODE_TEXT   0x28

#define ALP_TEL_CAT_CMD_SETUP_MENU   0x25

#define ALP_TEL_CAT_CRITICAL_ALERT   0x15

Critical Alert - This tone is to be used in critical situations.

#define ALP_TEL_CAT_CSD   0x01

Bearer type in the bearer description parameter circuit switched data.

#define ALP_TEL_CAT_DCS_SMS_PACKED   0x00

DISPLAY TEXT Parameters (Data coding scheme) use the SMS default 7-bit coded alphabet, packed into 8-bit octets, as defined in TS 123 038 [3].

#define ALP_TEL_CAT_DCS_SMS_UNICODE   0x08

use the UCS2 alphabet if the UCS2 is supported, as defined in TS 123 038 [3]

#define ALP_TEL_CAT_DCS_SMS_UNPACKED   0x04

use the SMS default 7-bit coded alphabet as defined in TS 123 038 [3] with bit 8 set to 0

#define ALP_TEL_CAT_DEFAULT_BEARER   0x03

default bearer for requested transport layer

#define ALP_TEL_CAT_DEFAULT_STYLE   0x00

SELECT ITEM command qualifier presentation type is not specified.

#define ALP_TEL_CAT_EVENT_ACCES_TECH_CHANGE   0x0B

Access Technology Change.

#define ALP_TEL_CAT_EVENT_BROWSER_TERMINATION   0x08

Browser termination.

#define ALP_TEL_CAT_EVENT_BROWSING_STATUS   0x0F

Browsing status.

#define ALP_TEL_CAT_EVENT_CHANNEL_STATUS   0x0A

Channel status.

#define ALP_TEL_CAT_EVENT_DATA_AVAILABLE   0x09

Data available.

#define ALP_TEL_CAT_EVENT_DISPLAY_PARAMETERS_CHANGED   0x0C

Display parameters changed.

#define ALP_TEL_CAT_EVENT_FRAMES_INFORMATION_CHANGE   0x10

Frames Information Change.

#define ALP_TEL_CAT_EVENT_IDLE_SCREEN_AVAILABLE   0x05

Idle screen available.

#define ALP_TEL_CAT_EVENT_IWLAN_ACCESS_STATUS   0x11

I-WLAN Access Status.

#define ALP_TEL_CAT_EVENT_LANGUAGE_SELECTION   0x07

Language selection.

#define ALP_TEL_CAT_EVENT_LOCAL_CONNECTION   0x0D

Local connection.

#define ALP_TEL_CAT_EVENT_USER_ACTIVITY   0x04

SetUpEventList parameters: each byte in the event list shall be coded with one of the values below: User activity.

#define ALP_TEL_CAT_GENERAL_BEEP   0x10

Terminal proprietary tones: General beep.

#define ALP_TEL_CAT_GET_CMD_PARAMETERS_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0004)

#define ALP_TEL_CAT_GET_CONFIG_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0001)

#define ALP_TEL_CAT_GET_INPUT_NO_ECHO   0x00

GET INPUT command qualifier dispatched on the field hideUserInput user input shall not be revealed in any way.

#define ALP_TEL_CAT_GET_INPUT_WITH_ECHO   0x01

terminal may echo user input on the display

#define ALP_TEL_CAT_GPRS_3G_PACKET_SERVICE   0x02

GPRS / 3G packet service.

#define ALP_TEL_CAT_HAPPY_TONE   0x30

happy tone

#define ALP_TEL_CAT_HELP_AVAILABLE   0x01

help available

#define ALP_TEL_CAT_HIGH_PRIORITY   0x01

high priority

#define ALP_TEL_CAT_IMMEDIATE_LINK_ESTABLISHMENT   0x01

immediate link establishment

#define ALP_TEL_CAT_IRDA   0x06

IrDA.

#define ALP_TEL_CAT_LANGUAGE_NON_SPECIFIC_NOTIFICATION   0x00

Language Notification command qualifier non-specific language notification.

#define ALP_TEL_CAT_LANGUAGE_SPECIFIC_NOTIFICATION   0x01

specific language notification

#define ALP_TEL_CAT_LAUNCH_BROWSER_CLOSE_EXISTING_AND_LAUNCH_NEW   0x03

close the existing browser session and launch new browser session

#define ALP_TEL_CAT_LAUNCH_BROWSER_IF_NOT_ALREADY_LAUNCHED   0x00

LaunchBrowser command qualifier launch browser if not already launched.

#define ALP_TEL_CAT_LAUNCH_BROWSER_USE_EXISTING   0x02

use the existing browser (the browser shall not use the active existing secured session)

#define ALP_TEL_CAT_LOCAL_INFO_DATE_TIME_TIMEZONE   0x03

Provide Local Information command qualifier date, time and time zone.

#define ALP_TEL_CAT_LOCAL_INFO_LANGUAGE_SETTING   0x04

language setting

#define ALP_TEL_CAT_MELODY1_TONE   0x40

Melody tones: Melody 1.

#define ALP_TEL_CAT_MELODY2_TONE   0x41

Melody 2.

#define ALP_TEL_CAT_MELODY3_TONE   0x42

Melody 3.

#define ALP_TEL_CAT_MELODY4_TONE   0x43

Melody 4.

#define ALP_TEL_CAT_MELODY5_TONE   0x44

Melody 5.

#define ALP_TEL_CAT_MELODY6_TONE   0x45

Melody 6.

#define ALP_TEL_CAT_MELODY7_TONE   0x46

Melody 7.

#define ALP_TEL_CAT_MELODY8_TONE   0x47

Melody 8.

#define ALP_TEL_CAT_MENU_SELECTION_HELP_REQUESTED   0x01

insert help request tag in the enveloppe message MENU SELECTION to request help information on the item selected

#define ALP_TEL_CAT_MENU_SELECTION_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0006)

#define ALP_TEL_CAT_MENU_SELECTION_NO_HELP_REQUESTED   0x00

Command Menu Selection parameters: do not insert help request tag in the enveloppe message MENU SELECTION.

#define ALP_TEL_CAT_MESSAGE_RECEIVED_TONE   0x34

message received tone

#define ALP_TEL_CAT_MESSAGES_COUNT   ((ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)

Total count of CAT service messages.

#define ALP_TEL_CAT_NEGATIVE_ACKNOWLEDGE_TONE   0x12

Negative acknowledgement or error tone.

#define ALP_TEL_CAT_NO_HELP   0x00

common to Setup Menu/Get input / Get inkey no help available

#define ALP_TEL_CAT_NO_SOFT_KEY   0x00

Setup menu command qualifier dispatched on the softkey and helpInfo fields no selection preference.

#define ALP_TEL_CAT_NO_SPECIFIC_CAUSE   0x00

Additional Information codes for miscellaneous errors No specific cause can be given.

#define ALP_TEL_CAT_NORMAL_PRIORITY   0x00

DISPLAY MULTIMEDIA MESSAGE / DISPLAY TEXT command qualifier normal priority.

#define ALP_TEL_CAT_NOTIFY_CARD_OF_EVENT_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0008)

#define ALP_TEL_CAT_ON_DEMAND_LINK_ESTABLISHMENT   0x00

Open Channel command qualifier on demand link establishment.

#define ALP_TEL_CAT_PACKET_DATA_SERVICE   0x08

TIA/EIA/IS-820 packet data service.

#define ALP_TEL_CAT_PLAY_TONE_CALL_DROPPED   0x05

Radio path not available/Call dropped.

#define ALP_TEL_CAT_PLAY_TONE_CALL_WAITING_TONE   0x07

Call waiting tone.

#define ALP_TEL_CAT_PLAY_TONE_CALLER_BUSY   0x02

Called subscriber busy.

#define ALP_TEL_CAT_PLAY_TONE_CONGESTION   0x03

Congestion.

#define ALP_TEL_CAT_PLAY_TONE_DIAL_TONE   0x01

PLAY TONE command parameters Dial tone.

#define ALP_TEL_CAT_PLAY_TONE_RADIO_PATH_ACKNOWLEDGE   0x04

Radio path acknowledge.

#define ALP_TEL_CAT_PLAY_TONE_RINGING_TONE   0x08

Ringing tone.

#define ALP_TEL_CAT_PLAY_TONE_SPECIAL_INFORMATION_OR_ERROR   0x06

Error/Special information.

#define ALP_TEL_CAT_POSITIVE_ACKNOWLEDGE_TONE   0x11

Positive acknowledgement tone.

#define ALP_TEL_CAT_PRESENT_AS_DATA_VALUES   0x01

presentation as a choice of data values

#define ALP_TEL_CAT_PRESENT_AS_NAVIGATION_OPTIONS   0x02

presentation as a choice of navigation options

#define ALP_TEL_CAT_QUESTION_TONE   0x33

question tone

#define ALP_TEL_CAT_REFRESH_FILE_CHANGE_NOTIFICATION   0x01

File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_INIT   0x03

NAA Initialization.

#define ALP_TEL_CAT_REFRESH_SIM_INIT_AND_FILE_CHANGE_NOTIFICATION   0x02

NAA Initialization and File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_INIT_AND_FULL_FILE_CHANGE_NOTIFICATION   0x00

Refresh command qualifier NAA Initialization and Full File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_RESET   0x04

UICC Reset.

#define ALP_TEL_CAT_REFRESH_USIM_INIT   0x05

NAA Application Reset, only applicable for a 3G platform.

#define ALP_TEL_CAT_REFRESH_USIM_RESET   0x06

NAA Session Reset, only applicable for a 3G platform;.

#define ALP_TEL_CAT_RES_ABORTED_BY_USER   0x10

Proactive UICC session terminated by the user.

#define ALP_TEL_CAT_RES_ACCESS_TECHNOLOGY_UNABLE_TO_PROCESS   0x3B

Access Technology unable to process command.

#define ALP_TEL_CAT_RES_ACTION_CONTRADICT_TIMER_STATE   0x24

Action in contradiction with the current timer state.

#define ALP_TEL_CAT_RES_BACKWARD   0x11

Backward move in the proactive UICC session requested by the user.

#define ALP_TEL_CAT_RES_BEARER_INDEPENDENT_PROTOCOL_ERROR   0x3A

Bearer Independent Protocol error.

#define ALP_TEL_CAT_RES_COMMAND_BEYOND_ME_CAPABILITIES   0x30

Command beyond terminal's capabilities.

#define ALP_TEL_CAT_RES_COMMAND_DATA_NOT_UNDERSTOOD   0x32

Command data not understood by terminal.

#define ALP_TEL_CAT_RES_COMMAND_NUMBER_NOT_KNOWN   0x33

Command number not known by terminal.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL   0x00

General result codes Command performed successfully.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_ICON_NOT_FOUND   0x04

Command performed successfully, but requested icon could not be displayed.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_LIMITED_SERVICE   0x06

Command performed successfully, limited service.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_MODIFIED_BY_CALL_CONTROL   0x05

Command performed, but modified by call control by NAA.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_MISSING_INFORMATION   0x02

Command performed, with missing information.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_MODIFICATION   0x07

Command performed with modification.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_PARTIAL_COMPREHENSION   0x01

Command performed with partial comprehension.

#define ALP_TEL_CAT_RES_COMMAND_TYPE_NOT_UNDERSTOOD   0x31

Command type not understood by terminal.

#define ALP_TEL_CAT_RES_FRAMES_ERROR   0x3C

Frames error.

#define ALP_TEL_CAT_RES_HELP_REQUIRED   0x13

Help information required by the user.

#define ALP_TEL_CAT_RES_LAUNCH_BROWSER_ERROR   0x26

Launch browser generic error code.

#define ALP_TEL_CAT_RES_ME_UNABLE_TO_PROCESS_COMMAND   0x20

terminal currently unable to process command

#define ALP_TEL_CAT_RES_MMS_ERROR   0x3D

MMS Error.

#define ALP_TEL_CAT_RES_NETWORK_UNABLE_TO_PROCESS_COMMAND   0x21

Network currently unable to process command.

#define ALP_TEL_CAT_RES_NO_RESPONSE   0x12

No response from user.

#define ALP_TEL_CAT_RES_PERMANENT_PROBLEM_IN_SMS_OR_CALL_CONTROL   0x39

Interaction with call control by USIM or MO short message control by USIM, permanent problem.

#define ALP_TEL_CAT_RES_REFRESH_SUCCESSFUL_WITH_ADDITIONAL_EFS_READ   0x03

REFRESH performed with additional EFs read.

#define ALP_TEL_CAT_RES_REQUIRED_VALUES_MISSING   0x36

Error, required values are missing.

#define ALP_TEL_CAT_RES_SMS_RP_ERROR   0x35

SMS RP-ERROR.

#define ALP_TEL_CAT_RES_SS_RETURN_ERROR   0x34

SS Return Error.

#define ALP_TEL_CAT_RES_TEMP_PROBLEM_IN_CALL_CONTROL   0x25

Interaction with call control by NAA, temporary problem.

#define ALP_TEL_CAT_RES_USER_CLEARED_BEFORE_RELEASE   0x23

User cleared down call before connection or network release.

#define ALP_TEL_CAT_RES_USER_REJECTED_SETUP_CALL   0x22

User did not accept the proactive command.

#define ALP_TEL_CAT_RES_USSD_ABORTED_BY_USER   0x14

USSD or SS transaction terminated by the user.

#define ALP_TEL_CAT_RES_USSD_RETURN_ERROR   0x37

USSD Return Error.

#define ALP_TEL_CAT_RESP_TYPE_PACKED_DIGITS_ONLY   0x03

#define ALP_TEL_CAT_RESP_TYPE_PACKED_SMS_ALPHABET   0x06

#define ALP_TEL_CAT_RESP_TYPE_UCS2_ALPHABET   0x07

#define ALP_TEL_CAT_RESP_TYPE_UCS2_DIGITS_ONLY   0x04

#define ALP_TEL_CAT_RESP_TYPE_UNPACKED_DIGITS_ONLY   0x02

#define ALP_TEL_CAT_RESP_TYPE_UNPACKED_SMS_ALPHABET   0x05

#define ALP_TEL_CAT_RESP_TYPE_YES_NO_OPTION   0x01

GET INKEY / GET INPUT command qualifier (common part).

#define ALP_TEL_CAT_RS232   0x07

RS232.

#define ALP_TEL_CAT_SAD_TONE   0x31

sad tone

#define ALP_TEL_CAT_SEND_DTMF_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000A)

#define ALP_TEL_CAT_SEND_SMS_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000B)

#define ALP_TEL_CAT_SEND_SMS_PACKING_NOT_REQUIRED   0x00

SEND SHORT MESSAGE command qualifier bit 1: 0 = packing not required;.

#define ALP_TEL_CAT_SEND_SMS_PACKING_REQUIRED   0x01

bit 1: 1 = SMS packing by the ME required.

#define ALP_TEL_CAT_SEND_SS_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000D)

#define ALP_TEL_CAT_SEND_USSD_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000C)

#define ALP_TEL_CAT_SET_CMD_RESPONSE_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0005)

#define ALP_TEL_CAT_SET_CONFIG_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0002)

#define ALP_TEL_CAT_SETUP_CALL_AND_DISCONNECT_ALL_OTHER_CALLS   0x04

Set up call, disconnecting all other calls (if any).

#define ALP_TEL_CAT_SETUP_CALL_AND_DISCONNECT_ALL_OTHER_CALLS_WITH_REDIAL   0x05

Set up call, disconnecting all other calls (if any), with redial.

#define ALP_TEL_CAT_SETUP_CALL_AND_PUT_ALL_OTHER_CALLS_ON_HOLD   0x02

Set up call, putting all other calls (if any) on hold.

#define ALP_TEL_CAT_SETUP_CALL_AND_PUT_ALL_OTHER_CALLS_ON_HOLD_WITH_REDIAL   0x03

Set up call, putting all other calls (if any) on hold, with redial.

#define ALP_TEL_CAT_SETUP_CALL_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0009)

#define ALP_TEL_CAT_SETUP_CALL_ONLY_IF_NOT_BUSY   0x00

SetUpCall command qualifier Set up call, but only if not currently busy on another call.

#define ALP_TEL_CAT_SETUP_CALL_ONLY_IF_NOT_BUSY_WITH_REDIAL   0x01

Set up call, but only if not currently busy on another call, with redial.

#define ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000E)

#define ALP_TEL_CAT_SHOW_ICON_WITH_TEXT   0x00

icon is not self-explanatory, i.e. if displayed, it shall be displayed together with the alpha identifier or text string

#define ALP_TEL_CAT_SHOW_ICON_WITHOUT_TEXT   0x01

Icon qualifier (indicates to the terminal how the icon is to be used) icon is self-explanatory, i.e. if displayed, it replaces the alpha identifier or text string.

#define ALP_TEL_CAT_SOFT_KEY_PREFERRED   0x01

selection using softkey preferred

#define ALP_TEL_CAT_TECHNOLOGY_INDEPENDANT   0x04

local link technology independent

#define ALP_TEL_CAT_TERMINATE_ENDS_OF_REDIALING_REACHED   1

#define ALP_TEL_CAT_TERMINATE_MESSAGE   ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0003)

#define ALP_TEL_CAT_TERMINATE_USER_ENDS_SESSION   2

#define ALP_TEL_CAT_TERMINATE_USER_STOPPED_REDIALING   0

Terminate reasons.

#define ALP_TEL_CAT_TRANSPORT_TCP_CLIENT_MODE   0x02

TCP, UICC in client mode (as defined in RFC 793 [10]).

#define ALP_TEL_CAT_TRANSPORT_TCP_SERVER_MODE   0x03

TCP, UICC in server mode (as defined in RFC 793 [10]).

#define ALP_TEL_CAT_TRANSPORT_UDP   0x01

Transport protocol type in the TLV object "UICC/ME interface transport level" UDP, UICC in client mode (as defined in RFC 768 [9]).

#define ALP_TEL_CAT_URGENT_ACTION_TONE   0x32

urgent action tone

#define ALP_TEL_CAT_USB   0x10

USB.

#define ALP_TEL_CAT_USER_CLEAR   0x00

wait for user to clear message

#define ALP_TEL_CAT_USER_RINGING_TONE   0x13

Ringing tone as selected by the user for incoming speech call.

#define ALP_TEL_CAT_USER_SMS_TONE   0x14

Alert tone as selected by the user for incoming SMS.

#define ALP_TEL_CAT_UTRAN   0x09

UTRAN packet service with extended parameters.

#define ALP_TEL_CAT_VIBRATE_ALERT_UP_TO_TERMINAL   0x00

Play Tone command qualifier use of vibrate alert is up to the terminal.

#define ALP_TEL_CAT_VIBRATE_ALERT_WITH_TONE   0x01

vibrate alert, if available, with the tone

#define ALP_TEL_CAT_VIBRATE_ONLY   0x20

Themed tones: vibrate only, if available.

#define ALP_TEL_IS_CAT_CALL_ACTION_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_CALL_ACTION_MESSAGE)

#define ALP_TEL_IS_CAT_GET_CMD_PARAMETERS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_GET_CMD_PARAMETERS_MESSAGE)

#define ALP_TEL_IS_CAT_GET_CONFIG_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_GET_CONFIG_MESSAGE)

#define ALP_TEL_IS_CAT_MENU_SELECTION_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_MENU_SELECTION_MESSAGE)

#define ALP_TEL_IS_CAT_NOTIFY_CARD_OF_EVENT_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_NOTIFY_CARD_OF_EVENT_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_DTMF_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_DTMF_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_SMS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_SMS_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_SS_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_SS_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_USSD_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_USSD_MESSAGE)

#define ALP_TEL_IS_CAT_SET_CMD_RESPONSE_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SET_CMD_RESPONSE_MESSAGE)

#define ALP_TEL_IS_CAT_SET_CONFIG_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SET_CONFIG_MESSAGE)

#define ALP_TEL_IS_CAT_SETUP_CALL_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SETUP_CALL_MESSAGE)

#define ALP_TEL_IS_CAT_SETUP_EVENT_LIST_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE)

#define ALP_TEL_IS_CAT_TERMINATE_SUPPORTED(iAppId)   alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_TERMINATE_MESSAGE)

Typedefs

typedef _AlpTelCatBuffer AlpTelCatBuffer

typedef _AlpTelCatCmdParams AlpTelCatCmdParams

typedef _AlpTelCatCmdResponse AlpTelCatCmdResponse

typedef _AlpTelCatConfig AlpTelCatConfig

typedef _AlpTelCatDisplayText AlpTelCatDisplayText

typedef _AlpTelCatEventToCard AlpTelCatEventToCard

typedef _AlpTelCatGetInkey AlpTelCatGetInkey

typedef _AlpTelCatGetInput AlpTelCatGetInput

typedef _AlpTelCatItem AlpTelCatItem

typedef _AlpTelCatItemList AlpTelCatItemList

typedef _AlpTelCatLaunchBrowser AlpTelCatLaunchBrowser

typedef _AlpTelCatLocalInfo AlpTelCatLocalInfo

typedef _AlpTelCatMEanswer AlpTelCatMEanswer

answer made by the phone module directly to the SIM

typedef _AlpTelCatMenuSelection AlpTelCatMenuSelection

typedef _AlpTelCatOpenChannel AlpTelCatOpenChannel

typedef _AlpTelCatPlayTone AlpTelCatPlayTone

typedef _AlpTelCatRefreshFileList AlpTelCatRefreshFileList

typedef _AlpTelCatSendShortMessage AlpTelCatSendShortMessage

typedef _AlpTelCatSetUpCall AlpTelCatSetUpCall

typedef _AlpTelCatSetUpEventList AlpTelCatSetUpEventList

typedef _AlpTelCatSIManswer AlpTelCatSIManswer

typedef _AlpTelCatSSOperation AlpTelCatSSOperation

Functions

alp_status_t alp_tel_cat_call_action (AlpTelApplicationId iAppId, uint8_t iAction, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_get_cmd_parameters (AlpTelApplicationId iAppId, AlpTelCatCmdParams *ioParamsP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_get_config (AlpTelApplicationId iAppId, AlpTelCatConfig *ioCfgP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_menu_selection (AlpTelApplicationId iAppId, AlpTelCatMenuSelection *iSelectionP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_notify_card_of_event (AlpTelApplicationId iAppId, AlpTelCatEventToCard *iEventP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_send_dtmf (AlpTelApplicationId iAppId, char *iDtmfStringP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_send_sms (AlpTelApplicationId iAppId, AlpTelCatSendShortMessage *ioMessageP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_send_ss (AlpTelApplicationId iAppId, AlpTelCatSSOperation *ioOperationP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_send_ussd (AlpTelApplicationId iAppId, AlpTelNwkUssd *iUssdP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_set_cmd_response (AlpTelApplicationId iAppId, AlpTelCatCmdResponse *iResponseP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_set_config (AlpTelApplicationId iAppId, AlpTelCatConfig *iCfgP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_setup_call (AlpTelApplicationId iAppId, AlpTelSpcCall *ioCallP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_setup_event_list (AlpTelApplicationId iAppId, AlpTelCatSetUpEventList *iEventListP, AlpTelTransId *ioTransIdP)

alp_status_t alp_tel_cat_terminate (AlpTelApplicationId iAppId, uint8_t iReason, AlpTelTransId *ioTransIdP)

Define Documentation

#define ALP_TEL_CALL_CONTROL_ACTION_SS_REQUESTED 0x03

USSD request or voice call is changed by call contol into an SS request.

#define ALP_TEL_CALL_CONTROL_ACTION_USSD_REQUESTED 0x02

SS request or voice call is changed by call contol into an USSD request.

#define ALP_TEL_CALL_CONTROL_ACTION_VOICE_CALL_REQUESTED 0x01

Call control requested action SS Request or USSD request is changed by call control to a voice call request or the address is modified.

#define ALP_TEL_CALL_CONTROL_ALLOWED 0x00

Call Control or MO-SMS control result code.

#define ALP_TEL_CALL_CONTROL_ALLOWED_WITH_MODIFICATIONS 0x02

#define ALP_TEL_CALL_CONTROL_NOT_ALLOWED 0x01

#define ALP_TEL_CAT_ADD_INFO_ACCESS_CONTROL_BAR 0x05

Access control class bar.

#define ALP_TEL_CAT_ADD_INFO_ACTION_NOT_ALLOWED 0x01

Additional Information codes for "Interaction with Call Control by SIM Action not allowed.

#define ALP_TEL_CAT_ADD_INFO_BEARER_UNAVAILABLE 0x01

Additional information codes "launch browser generic error code" Bearer unavailable.

#define ALP_TEL_CAT_ADD_INFO_BROWSER_UNAVAILABLE 0x02

Browser unavailable.

#define ALP_TEL_CAT_ADD_INFO_BUFFER_SIZE_NOT_AVAILABLE 0x04

Requested buffer size not available.

#define ALP_TEL_CAT_ADD_INFO_CHANNEL_CLOSED 0x02

Channel closed.

#define ALP_TEL_CAT_ADD_INFO_CHANNEL_ID_NOT_VALID 0x03

Channel identifier not valid.

#define ALP_TEL_CAT_ADD_INFO_DATA_READ_ERROR 0x03

terminal unable to read the provisioning data

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_CALL 0x02

terminal currently busy on call

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_SEND_DTMF 0x09

ME currently busy on SEND DTMF command.

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_SS 0x03

ME currently busy on SS transaction.

#define ALP_TEL_CAT_ADD_INFO_ME_BUSY_ON_USSD 0x08

ME currently busy on USSD transaction.

#define ALP_TEL_CAT_ADD_INFO_NO_CHANNEL_AVAILABLE 0x01

Additional Information codes for "Bearer Independent Protocol error" No channel available.

#define ALP_TEL_CAT_ADD_INFO_NO_NAA_ACTIVE 0x0A

No NAA active.

#define ALP_TEL_CAT_ADD_INFO_NO_RADIO_RESSOURCE 0x06

Radio resource not granted.

#define ALP_TEL_CAT_ADD_INFO_NO_SERVICE 0x04

No service.

#define ALP_TEL_CAT_ADD_INFO_NOT_IN_SPEECH_CALL 0x07

Not in speech call.

#define ALP_TEL_CAT_ADD_INFO_PORT_NOT_AVAILABLE 0x10

Port not available (applicable for OPEN CHANNEL related to UICC Server Mode).

#define ALP_TEL_CAT_ADD_INFO_REMOTE_DEVICE_NOT_REACHABLE 0x07

remote device is not reachable (not present, not physically connected, switched off, etc.)

#define ALP_TEL_CAT_ADD_INFO_REQUEST_TYPE_CHANGE 0x02

The type of request has changed.

#define ALP_TEL_CAT_ADD_INFO_SCREEN_IS_BUSY 0x01

Additional Information codes for "ME currently unable to process command" error Screen is busy.

#define ALP_TEL_CAT_ADD_INFO_SECURITY_ERROR 0x05

Security error (unsuccessful authentication).

#define ALP_TEL_CAT_ADD_INFO_SERVICE_ERROR 0x08

Service error (service not available on remote device).

#define ALP_TEL_CAT_ADD_INFO_SERVICE_IDENTIFIER_UNKNOWN 0x09

Service identifier unknown.

#define ALP_TEL_CAT_ADD_INFO_TRANSPORT_NOT_AVAILABLE 0x06

Requested UICC/terminal interface transport level not available.

#define ALP_TEL_CAT_ADDRESS_IPV4 0x21

Command OPEN CHANNEL parameters or response to OPEN CHANNEL:.

#define ALP_TEL_CAT_ADDRESS_IPV6 0x97

#define ALP_TEL_CAT_BEARER_CSD 0x01

circuit switched data

#define ALP_TEL_CAT_BEARER_GPRS 0x03

#define ALP_TEL_CAT_BEARER_SMS 0x00

short message
Bearer codes used in the LAUNCH BROWSER command within the bearer list the terminal shall use the list of bearers associated with the Launch Broser command to choose which bearers are allowed in order of priority.

#define ALP_TEL_CAT_BEARER_USSD 0x02

#define ALP_TEL_CAT_BLUETOOTH 0x05

Bluetooth.

#define ALP_TEL_CAT_BROWSER_ERROR_TERMINATION 0x01

#define ALP_TEL_CAT_BROWSER_USER_TERMINATION 0x00

Browser termination cause to join in the structure of enveloppe (Browser termination).

#define ALP_TEL_CAT_CALL_ACCEPT 0x01

User accept to setup the call.

#define ALP_TEL_CAT_CALL_ACTION_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0007)

#define ALP_TEL_CAT_CALL_REJECT 0x00

Setup Call actions User did not accept the proactive command SETUP CALL.

#define ALP_TEL_CAT_CLEAR_AFTER_DELAY 0x01

clear after delay

#define ALP_TEL_CAT_CMD_CLOSE_CHANNEL 0x41

#define ALP_TEL_CAT_CMD_DISPLAY_TEXT 0x21

#define ALP_TEL_CAT_CMD_GET_CHANNEL_STATUS 0x44

#define ALP_TEL_CAT_CMD_GET_INKEY 0x22

#define ALP_TEL_CAT_CMD_GET_INPUT 0x23

#define ALP_TEL_CAT_CMD_GET_READER_STATUS 0x33

#define ALP_TEL_CAT_CMD_LANGUAGE_NOTIFICATION 0x35

#define ALP_TEL_CAT_CMD_LAUNCH_BROWSER 0x15

#define ALP_TEL_CAT_CMD_MORE_TIME 0x02

#define ALP_TEL_CAT_CMD_OPEN_CHANNEL 0x40

#define ALP_TEL_CAT_CMD_PERFORM_CARD_APDU 0x30

#define ALP_TEL_CAT_CMD_PLAY_TONE 0x20

#define ALP_TEL_CAT_CMD_POWER_OFF_CARD 0x32

#define ALP_TEL_CAT_CMD_POWER_ON_CARD 0x31

#define ALP_TEL_CAT_CMD_PROVIDE_LOCAL_INFORMATION 0x26

#define ALP_TEL_CAT_CMD_RECEIVE_DATA 0x42

#define ALP_TEL_CAT_CMD_REFRESH 0x01

Proactive Commands Id.

#define ALP_TEL_CAT_CMD_RUN_AT_COMMAND 0x34

#define ALP_TEL_CAT_CMD_SELECT_ITEM 0x24

#define ALP_TEL_CAT_CMD_SEND_DATA 0x43

#define ALP_TEL_CAT_CMD_SEND_DTMF 0x14

#define ALP_TEL_CAT_CMD_SEND_SHORT_MESSAGE 0x13

#define ALP_TEL_CAT_CMD_SEND_SS 0x11

#define ALP_TEL_CAT_CMD_SEND_USSD 0x12

#define ALP_TEL_CAT_CMD_SETUP_CALL 0x10

#define ALP_TEL_CAT_CMD_SETUP_EVENTLIST 0x05

#define ALP_TEL_CAT_CMD_SETUP_IDLE_MODE_TEXT 0x28

#define ALP_TEL_CAT_CMD_SETUP_MENU 0x25

#define ALP_TEL_CAT_CRITICAL_ALERT 0x15

Critical Alert - This tone is to be used in critical situations.

#define ALP_TEL_CAT_CSD 0x01

Bearer type in the bearer description parameter circuit switched data.

#define ALP_TEL_CAT_DCS_SMS_PACKED 0x00

DISPLAY TEXT Parameters (Data coding scheme) use the SMS default 7-bit coded alphabet, packed into 8-bit octets, as defined in TS 123 038 [3].

#define ALP_TEL_CAT_DCS_SMS_UNICODE 0x08

use the UCS2 alphabet if the UCS2 is supported, as defined in TS 123 038 [3]

#define ALP_TEL_CAT_DCS_SMS_UNPACKED 0x04

use the SMS default 7-bit coded alphabet as defined in TS 123 038 [3] with bit 8 set to 0

#define ALP_TEL_CAT_DEFAULT_BEARER 0x03

default bearer for requested transport layer

#define ALP_TEL_CAT_DEFAULT_STYLE 0x00

SELECT ITEM command qualifier presentation type is not specified.

#define ALP_TEL_CAT_EVENT_ACCES_TECH_CHANGE 0x0B

Access Technology Change.

#define ALP_TEL_CAT_EVENT_BROWSER_TERMINATION 0x08

Browser termination.

#define ALP_TEL_CAT_EVENT_BROWSING_STATUS 0x0F

Browsing status.

#define ALP_TEL_CAT_EVENT_CHANNEL_STATUS 0x0A

Channel status.

#define ALP_TEL_CAT_EVENT_DATA_AVAILABLE 0x09

Data available.

#define ALP_TEL_CAT_EVENT_DISPLAY_PARAMETERS_CHANGED 0x0C

Display parameters changed.

#define ALP_TEL_CAT_EVENT_FRAMES_INFORMATION_CHANGE 0x10

Frames Information Change.

#define ALP_TEL_CAT_EVENT_IDLE_SCREEN_AVAILABLE 0x05

Idle screen available.

#define ALP_TEL_CAT_EVENT_IWLAN_ACCESS_STATUS 0x11

I-WLAN Access Status.

#define ALP_TEL_CAT_EVENT_LANGUAGE_SELECTION 0x07

Language selection.

#define ALP_TEL_CAT_EVENT_LOCAL_CONNECTION 0x0D

Local connection.

#define ALP_TEL_CAT_EVENT_USER_ACTIVITY 0x04

SetUpEventList parameters: each byte in the event list shall be coded with one of the values below: User activity.

#define ALP_TEL_CAT_GENERAL_BEEP 0x10

Terminal proprietary tones: General beep.

#define ALP_TEL_CAT_GET_CMD_PARAMETERS_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0004)

#define ALP_TEL_CAT_GET_CONFIG_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0001)

#define ALP_TEL_CAT_GET_INPUT_NO_ECHO 0x00

GET INPUT command qualifier dispatched on the field hideUserInput user input shall not be revealed in any way.

#define ALP_TEL_CAT_GET_INPUT_WITH_ECHO 0x01

terminal may echo user input on the display

#define ALP_TEL_CAT_GPRS_3G_PACKET_SERVICE 0x02

GPRS / 3G packet service.

#define ALP_TEL_CAT_HAPPY_TONE 0x30

happy tone

#define ALP_TEL_CAT_HELP_AVAILABLE 0x01

help available

#define ALP_TEL_CAT_HIGH_PRIORITY 0x01

high priority

#define ALP_TEL_CAT_IMMEDIATE_LINK_ESTABLISHMENT 0x01

immediate link establishment

#define ALP_TEL_CAT_IRDA 0x06

IrDA.

#define ALP_TEL_CAT_LANGUAGE_NON_SPECIFIC_NOTIFICATION 0x00

Language Notification command qualifier non-specific language notification.

#define ALP_TEL_CAT_LANGUAGE_SPECIFIC_NOTIFICATION 0x01

specific language notification

#define ALP_TEL_CAT_LAUNCH_BROWSER_CLOSE_EXISTING_AND_LAUNCH_NEW 0x03

close the existing browser session and launch new browser session

#define ALP_TEL_CAT_LAUNCH_BROWSER_IF_NOT_ALREADY_LAUNCHED 0x00

LaunchBrowser command qualifier launch browser if not already launched.

#define ALP_TEL_CAT_LAUNCH_BROWSER_USE_EXISTING 0x02

use the existing browser (the browser shall not use the active existing secured session)

#define ALP_TEL_CAT_LOCAL_INFO_DATE_TIME_TIMEZONE 0x03

Provide Local Information command qualifier date, time and time zone.

#define ALP_TEL_CAT_LOCAL_INFO_LANGUAGE_SETTING 0x04

language setting

#define ALP_TEL_CAT_MELODY1_TONE 0x40

Melody tones: Melody 1.

#define ALP_TEL_CAT_MELODY2_TONE 0x41

Melody 2.

#define ALP_TEL_CAT_MELODY3_TONE 0x42

Melody 3.

#define ALP_TEL_CAT_MELODY4_TONE 0x43

Melody 4.

#define ALP_TEL_CAT_MELODY5_TONE 0x44

Melody 5.

#define ALP_TEL_CAT_MELODY6_TONE 0x45

Melody 6.

#define ALP_TEL_CAT_MELODY7_TONE 0x46

Melody 7.

#define ALP_TEL_CAT_MELODY8_TONE 0x47

Melody 8.

#define ALP_TEL_CAT_MENU_SELECTION_HELP_REQUESTED 0x01

insert help request tag in the enveloppe message MENU SELECTION to request help information on the item selected

#define ALP_TEL_CAT_MENU_SELECTION_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0006)

#define ALP_TEL_CAT_MENU_SELECTION_NO_HELP_REQUESTED 0x00

Command Menu Selection parameters: do not insert help request tag in the enveloppe message MENU SELECTION.

#define ALP_TEL_CAT_MESSAGE_RECEIVED_TONE 0x34

message received tone

#define ALP_TEL_CAT_MESSAGES_COUNT ((ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE & ALP_TEL_MESSAGE_MASK) + 1)

Total count of CAT service messages.

#define ALP_TEL_CAT_NEGATIVE_ACKNOWLEDGE_TONE 0x12

Negative acknowledgement or error tone.

#define ALP_TEL_CAT_NO_HELP 0x00

common to Setup Menu/Get input / Get inkey no help available

#define ALP_TEL_CAT_NO_SOFT_KEY 0x00

Setup menu command qualifier dispatched on the softkey and helpInfo fields no selection preference.

#define ALP_TEL_CAT_NO_SPECIFIC_CAUSE 0x00

Additional Information codes for miscellaneous errors No specific cause can be given.

#define ALP_TEL_CAT_NORMAL_PRIORITY 0x00

DISPLAY MULTIMEDIA MESSAGE / DISPLAY TEXT command qualifier normal priority.

#define ALP_TEL_CAT_NOTIFY_CARD_OF_EVENT_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0008)

#define ALP_TEL_CAT_ON_DEMAND_LINK_ESTABLISHMENT 0x00

Open Channel command qualifier on demand link establishment.

#define ALP_TEL_CAT_PACKET_DATA_SERVICE 0x08

TIA/EIA/IS-820 packet data service.

#define ALP_TEL_CAT_PLAY_TONE_CALL_DROPPED 0x05

Radio path not available/Call dropped.

#define ALP_TEL_CAT_PLAY_TONE_CALL_WAITING_TONE 0x07

Call waiting tone.

#define ALP_TEL_CAT_PLAY_TONE_CALLER_BUSY 0x02

Called subscriber busy.

#define ALP_TEL_CAT_PLAY_TONE_CONGESTION 0x03

Congestion.

#define ALP_TEL_CAT_PLAY_TONE_DIAL_TONE 0x01

PLAY TONE command parameters Dial tone.

#define ALP_TEL_CAT_PLAY_TONE_RADIO_PATH_ACKNOWLEDGE 0x04

Radio path acknowledge.

#define ALP_TEL_CAT_PLAY_TONE_RINGING_TONE 0x08

Ringing tone.

#define ALP_TEL_CAT_PLAY_TONE_SPECIAL_INFORMATION_OR_ERROR 0x06

Error/Special information.

#define ALP_TEL_CAT_POSITIVE_ACKNOWLEDGE_TONE 0x11

Positive acknowledgement tone.

#define ALP_TEL_CAT_PRESENT_AS_DATA_VALUES 0x01

presentation as a choice of data values

#define ALP_TEL_CAT_PRESENT_AS_NAVIGATION_OPTIONS 0x02

presentation as a choice of navigation options

#define ALP_TEL_CAT_QUESTION_TONE 0x33

question tone

#define ALP_TEL_CAT_REFRESH_FILE_CHANGE_NOTIFICATION 0x01

File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_INIT 0x03

NAA Initialization.

#define ALP_TEL_CAT_REFRESH_SIM_INIT_AND_FILE_CHANGE_NOTIFICATION 0x02

NAA Initialization and File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_INIT_AND_FULL_FILE_CHANGE_NOTIFICATION 0x00

Refresh command qualifier NAA Initialization and Full File Change Notification.

#define ALP_TEL_CAT_REFRESH_SIM_RESET 0x04

UICC Reset.

#define ALP_TEL_CAT_REFRESH_USIM_INIT 0x05

NAA Application Reset, only applicable for a 3G platform.

#define ALP_TEL_CAT_REFRESH_USIM_RESET 0x06

NAA Session Reset, only applicable for a 3G platform;.

#define ALP_TEL_CAT_RES_ABORTED_BY_USER 0x10

Proactive UICC session terminated by the user.

#define ALP_TEL_CAT_RES_ACCESS_TECHNOLOGY_UNABLE_TO_PROCESS 0x3B

Access Technology unable to process command.

#define ALP_TEL_CAT_RES_ACTION_CONTRADICT_TIMER_STATE 0x24

Action in contradiction with the current timer state.

#define ALP_TEL_CAT_RES_BACKWARD 0x11

Backward move in the proactive UICC session requested by the user.

#define ALP_TEL_CAT_RES_BEARER_INDEPENDENT_PROTOCOL_ERROR 0x3A

Bearer Independent Protocol error.

#define ALP_TEL_CAT_RES_COMMAND_BEYOND_ME_CAPABILITIES 0x30

Command beyond terminal's capabilities.

#define ALP_TEL_CAT_RES_COMMAND_DATA_NOT_UNDERSTOOD 0x32

Command data not understood by terminal.

#define ALP_TEL_CAT_RES_COMMAND_NUMBER_NOT_KNOWN 0x33

Command number not known by terminal.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL 0x00

General result codes Command performed successfully.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_ICON_NOT_FOUND 0x04

Command performed successfully, but requested icon could not be displayed.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_LIMITED_SERVICE 0x06

Command performed successfully, limited service.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_BUT_MODIFIED_BY_CALL_CONTROL 0x05

Command performed, but modified by call control by NAA.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_MISSING_INFORMATION 0x02

Command performed, with missing information.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_MODIFICATION 0x07

Command performed with modification.

#define ALP_TEL_CAT_RES_COMMAND_SUCCESSFUL_WITH_PARTIAL_COMPREHENSION 0x01

Command performed with partial comprehension.

#define ALP_TEL_CAT_RES_COMMAND_TYPE_NOT_UNDERSTOOD 0x31

Command type not understood by terminal.

#define ALP_TEL_CAT_RES_FRAMES_ERROR 0x3C

Frames error.

#define ALP_TEL_CAT_RES_HELP_REQUIRED 0x13

Help information required by the user.

#define ALP_TEL_CAT_RES_LAUNCH_BROWSER_ERROR 0x26

Launch browser generic error code.

#define ALP_TEL_CAT_RES_ME_UNABLE_TO_PROCESS_COMMAND 0x20

terminal currently unable to process command

#define ALP_TEL_CAT_RES_MMS_ERROR 0x3D

MMS Error.

#define ALP_TEL_CAT_RES_NETWORK_UNABLE_TO_PROCESS_COMMAND 0x21

Network currently unable to process command.

#define ALP_TEL_CAT_RES_NO_RESPONSE 0x12

No response from user.

#define ALP_TEL_CAT_RES_PERMANENT_PROBLEM_IN_SMS_OR_CALL_CONTROL 0x39

Interaction with call control by USIM or MO short message control by USIM, permanent problem.

#define ALP_TEL_CAT_RES_REFRESH_SUCCESSFUL_WITH_ADDITIONAL_EFS_READ 0x03

REFRESH performed with additional EFs read.

#define ALP_TEL_CAT_RES_REQUIRED_VALUES_MISSING 0x36

Error, required values are missing.

#define ALP_TEL_CAT_RES_SMS_RP_ERROR 0x35

SMS RP-ERROR.

#define ALP_TEL_CAT_RES_SS_RETURN_ERROR 0x34

SS Return Error.

#define ALP_TEL_CAT_RES_TEMP_PROBLEM_IN_CALL_CONTROL 0x25

Interaction with call control by NAA, temporary problem.

#define ALP_TEL_CAT_RES_USER_CLEARED_BEFORE_RELEASE 0x23

User cleared down call before connection or network release.

#define ALP_TEL_CAT_RES_USER_REJECTED_SETUP_CALL 0x22

User did not accept the proactive command.

#define ALP_TEL_CAT_RES_USSD_ABORTED_BY_USER 0x14

USSD or SS transaction terminated by the user.

#define ALP_TEL_CAT_RES_USSD_RETURN_ERROR 0x37

USSD Return Error.

#define ALP_TEL_CAT_RESP_TYPE_PACKED_DIGITS_ONLY 0x03

#define ALP_TEL_CAT_RESP_TYPE_PACKED_SMS_ALPHABET 0x06

#define ALP_TEL_CAT_RESP_TYPE_UCS2_ALPHABET 0x07

#define ALP_TEL_CAT_RESP_TYPE_UCS2_DIGITS_ONLY 0x04

#define ALP_TEL_CAT_RESP_TYPE_UNPACKED_DIGITS_ONLY 0x02

#define ALP_TEL_CAT_RESP_TYPE_UNPACKED_SMS_ALPHABET 0x05

#define ALP_TEL_CAT_RESP_TYPE_YES_NO_OPTION 0x01

GET INKEY / GET INPUT command qualifier (common part).

#define ALP_TEL_CAT_RS232 0x07

RS232.

#define ALP_TEL_CAT_SAD_TONE 0x31

sad tone

#define ALP_TEL_CAT_SEND_DTMF_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000A)

#define ALP_TEL_CAT_SEND_SMS_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000B)

#define ALP_TEL_CAT_SEND_SMS_PACKING_NOT_REQUIRED 0x00

SEND SHORT MESSAGE command qualifier bit 1: 0 = packing not required;.

#define ALP_TEL_CAT_SEND_SMS_PACKING_REQUIRED 0x01

bit 1: 1 = SMS packing by the ME required.

#define ALP_TEL_CAT_SEND_SS_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000D)

#define ALP_TEL_CAT_SEND_USSD_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000C)

#define ALP_TEL_CAT_SET_CMD_RESPONSE_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0005)

#define ALP_TEL_CAT_SET_CONFIG_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0002)

#define ALP_TEL_CAT_SETUP_CALL_AND_DISCONNECT_ALL_OTHER_CALLS 0x04

Set up call, disconnecting all other calls (if any).

#define ALP_TEL_CAT_SETUP_CALL_AND_DISCONNECT_ALL_OTHER_CALLS_WITH_REDIAL 0x05

Set up call, disconnecting all other calls (if any), with redial.

#define ALP_TEL_CAT_SETUP_CALL_AND_PUT_ALL_OTHER_CALLS_ON_HOLD 0x02

Set up call, putting all other calls (if any) on hold.

#define ALP_TEL_CAT_SETUP_CALL_AND_PUT_ALL_OTHER_CALLS_ON_HOLD_WITH_REDIAL 0x03

Set up call, putting all other calls (if any) on hold, with redial.

#define ALP_TEL_CAT_SETUP_CALL_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0009)

#define ALP_TEL_CAT_SETUP_CALL_ONLY_IF_NOT_BUSY 0x00

SetUpCall command qualifier Set up call, but only if not currently busy on another call.

#define ALP_TEL_CAT_SETUP_CALL_ONLY_IF_NOT_BUSY_WITH_REDIAL 0x01

Set up call, but only if not currently busy on another call, with redial.

#define ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x000E)

#define ALP_TEL_CAT_SHOW_ICON_WITH_TEXT 0x00

icon is not self-explanatory, i.e. if displayed, it shall be displayed together with the alpha identifier or text string

#define ALP_TEL_CAT_SHOW_ICON_WITHOUT_TEXT 0x01

Icon qualifier (indicates to the terminal how the icon is to be used) icon is self-explanatory, i.e. if displayed, it replaces the alpha identifier or text string.

#define ALP_TEL_CAT_SOFT_KEY_PREFERRED 0x01

selection using softkey preferred

#define ALP_TEL_CAT_TECHNOLOGY_INDEPENDANT 0x04

local link technology independent

#define ALP_TEL_CAT_TERMINATE_ENDS_OF_REDIALING_REACHED 1

#define ALP_TEL_CAT_TERMINATE_MESSAGE ((ALP_TEL_CAT_SERVICE_ID << 8) | 0x0003)

#define ALP_TEL_CAT_TERMINATE_USER_ENDS_SESSION 2

#define ALP_TEL_CAT_TERMINATE_USER_STOPPED_REDIALING 0

Terminate reasons.

#define ALP_TEL_CAT_TRANSPORT_TCP_CLIENT_MODE 0x02

TCP, UICC in client mode (as defined in RFC 793 [10]).

#define ALP_TEL_CAT_TRANSPORT_TCP_SERVER_MODE 0x03

TCP, UICC in server mode (as defined in RFC 793 [10]).

#define ALP_TEL_CAT_TRANSPORT_UDP 0x01

Transport protocol type in the TLV object "UICC/ME interface transport level" UDP, UICC in client mode (as defined in RFC 768 [9]).

#define ALP_TEL_CAT_URGENT_ACTION_TONE 0x32

urgent action tone

#define ALP_TEL_CAT_USB 0x10

USB.

#define ALP_TEL_CAT_USER_CLEAR 0x00

wait for user to clear message

#define ALP_TEL_CAT_USER_RINGING_TONE 0x13

Ringing tone as selected by the user for incoming speech call.

#define ALP_TEL_CAT_USER_SMS_TONE 0x14

Alert tone as selected by the user for incoming SMS.

#define ALP_TEL_CAT_UTRAN 0x09

UTRAN packet service with extended parameters.

#define ALP_TEL_CAT_VIBRATE_ALERT_UP_TO_TERMINAL 0x00

Play Tone command qualifier use of vibrate alert is up to the terminal.

#define ALP_TEL_CAT_VIBRATE_ALERT_WITH_TONE 0x01

vibrate alert, if available, with the tone

#define ALP_TEL_CAT_VIBRATE_ONLY 0x20

Themed tones: vibrate only, if available.

#define ALP_TEL_IS_CAT_CALL_ACTION_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_CALL_ACTION_MESSAGE)

#define ALP_TEL_IS_CAT_GET_CMD_PARAMETERS_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_GET_CMD_PARAMETERS_MESSAGE)

#define ALP_TEL_IS_CAT_GET_CONFIG_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_GET_CONFIG_MESSAGE)

#define ALP_TEL_IS_CAT_MENU_SELECTION_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_MENU_SELECTION_MESSAGE)

#define ALP_TEL_IS_CAT_NOTIFY_CARD_OF_EVENT_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_NOTIFY_CARD_OF_EVENT_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_DTMF_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_DTMF_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_SMS_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_SMS_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_SS_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_SS_MESSAGE)

#define ALP_TEL_IS_CAT_SEND_USSD_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SEND_USSD_MESSAGE)

#define ALP_TEL_IS_CAT_SET_CMD_RESPONSE_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SET_CMD_RESPONSE_MESSAGE)

#define ALP_TEL_IS_CAT_SET_CONFIG_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SET_CONFIG_MESSAGE)

#define ALP_TEL_IS_CAT_SETUP_CALL_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SETUP_CALL_MESSAGE)

#define ALP_TEL_IS_CAT_SETUP_EVENT_LIST_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_SETUP_EVENT_LIST_MESSAGE)

#define ALP_TEL_IS_CAT_TERMINATE_SUPPORTED ( iAppId ) alp_tel_is_function_supported(iAppId, ALP_TEL_CAT_TERMINATE_MESSAGE)

Typedef Documentation

typedef struct _AlpTelCatBuffer AlpTelCatBuffer

typedef struct _AlpTelCatCmdParams AlpTelCatCmdParams

typedef struct _AlpTelCatCmdResponse AlpTelCatCmdResponse

typedef struct _AlpTelCatConfig AlpTelCatConfig

typedef struct _AlpTelCatDisplayText AlpTelCatDisplayText

typedef struct _AlpTelCatEventToCard AlpTelCatEventToCard

typedef struct _AlpTelCatGetInkey AlpTelCatGetInkey

typedef struct _AlpTelCatGetInput AlpTelCatGetInput

typedef struct _AlpTelCatItem AlpTelCatItem

typedef struct _AlpTelCatItemList AlpTelCatItemList

typedef struct _AlpTelCatLaunchBrowser AlpTelCatLaunchBrowser

typedef struct _AlpTelCatLocalInfo AlpTelCatLocalInfo

typedef struct _AlpTelCatMEanswer AlpTelCatMEanswer

answer made by the phone module directly to the SIM

typedef struct _AlpTelCatMenuSelection AlpTelCatMenuSelection

typedef struct _AlpTelCatOpenChannel AlpTelCatOpenChannel

typedef struct _AlpTelCatPlayTone AlpTelCatPlayTone

typedef struct _AlpTelCatRefreshFileList AlpTelCatRefreshFileList

typedef struct _AlpTelCatSendShortMessage AlpTelCatSendShortMessage

typedef struct _AlpTelCatSetUpCall AlpTelCatSetUpCall

typedef struct _AlpTelCatSetUpEventList AlpTelCatSetUpEventList

typedef struct _AlpTelCatSIManswer AlpTelCatSIManswer

answer made by the SIM card to the phone module after a CALL CONTROL or MO Short Message CONTROL command Deprecated, do not use. Use AlpTelCardCallControlParams

typedef struct _AlpTelCatSSOperation AlpTelCatSSOperation

Function Documentation

alp_status_t alp_tel_cat_call_action ( AlpTelApplicationId iAppId,

uint8_t iAction,

AlpTelTransId * ioTransIdP

)

To inform indirectly the UICC that the user accepts or not to set up a call (requested by the proactive command SETUP CALL)

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iAction This value is used to pass the user choice (accept or reject)

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The response has been formated and sent to the mobile device successfuly.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_get_cmd_parameters ( AlpTelApplicationId iAppId,

AlpTelCatCmdParams * ioParamsP,

AlpTelTransId * ioTransIdP

)

Get the parameters of the proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in,out] ioParamsP Pointer to a AlpTelCatCmdParams structure that contains all the parameters associated with a proactive command (command qualifier, alpha ID, item ID ...).

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The parameters has been retrieved successfuly.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_get_config ( AlpTelApplicationId iAppId,

AlpTelCatConfig * ioCfgP,

AlpTelTransId * ioTransIdP

)

Get from the Card the current configuration

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in,out] ioCfgP Pointer to a AlpTelCatConfig structure that identifies the list of CAT facilities that are supported by the terminal.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The configuration has been retrieved successfuly.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_menu_selection ( AlpTelApplicationId iAppId,

AlpTelCatMenuSelection * iSelectionP,

AlpTelTransId * ioTransIdP

)

Send the identifier of the selected item to the Card

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iSelectionP Pointer to a AlpTelCatMenuSelection structure that contains the identifier of the selected item and eventually a flag indicating the need to get help information on this selected item

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The envelope command has been formated and sent successfuly to the card.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_notify_card_of_event ( AlpTelApplicationId iAppId,

AlpTelCatEventToCard * iEventP,

AlpTelTransId * ioTransIdP

)

To notify the card that an event( being part of the current event list) has occured.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iEventP Pointer to a AlpTelCatEventToCard structure that contains all the details of the event to the UICC (event code, browser termination cause, language selection)

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The envelope command has been formated and sent successfuly to the card .

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_send_dtmf ( AlpTelApplicationId iAppId,

char * iDtmfStringP,

AlpTelTransId * ioTransIdP

)

Sends a DTMF string as a result from the SEND DTMF proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iDtmfStringP The DTMF string with ASCII characters in the set of 0-9, #, *, and A-D.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The DTMF string has been sent successfuly.

Since:
ALP iSDK 2.3

alp_status_t alp_tel_cat_send_sms ( AlpTelApplicationId iAppId,

AlpTelCatSendShortMessage * ioMessageP,

AlpTelTransId * ioTransIdP

)

Sends an SMS message as a result from the SEND SMS proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in,out] ioMessageP Pointer to a AlpTelCatSendShortMessage structure containing the TPDU to send.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The SMS message has been sent successfuly.

Since:
ALP iSDK 2.3

alp_status_t alp_tel_cat_send_ss ( AlpTelApplicationId iAppId,

AlpTelCatSSOperation * ioOperationP,

AlpTelTransId * ioTransIdP

)

Sends a Supplementary Service request to the network as a result from the SEND SS proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] ioOperationP Pointer to a AlpTelCatSSOperation structure.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The SS transaction has been completed successfuly.

Since:
ALP iSDK 2.3

alp_status_t alp_tel_cat_send_ussd ( AlpTelApplicationId iAppId,

AlpTelNwkUssd * iUssdP,

AlpTelTransId * ioTransIdP

)

Sends a USSD string to the network as a result from the SEND USSD proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iUssdP Pointer to a AlpTelNwkUssd structure.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The USSD string has been sent successfuly.

Since:
ALP iSDK 2.3

alp_status_t alp_tel_cat_set_cmd_response ( AlpTelApplicationId iAppId,

AlpTelCatCmdResponse * iResponseP,

AlpTelTransId * ioTransIdP

)

Set the response of the proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iResponseP Pointer to a AlpTelCatCmdResponse structure that contains all the information to send to the card (command details, general result and sometimes more specific information like item identifier...).

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The response has been formated and sent successfuly to the card.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_set_config ( AlpTelApplicationId iAppId,

AlpTelCatConfig * iCfgP,

AlpTelTransId * ioTransIdP

)

Set the configuration (profile) to send to the UICC as part of the UICC initialization

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iCfgP Pointer to a AlpTelCatConfig structure that identifies the list of CAT facilities that are supported by the terminal.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The configuration has been set successfuly.

Since:
ALP iSDK 1.0

alp_status_t alp_tel_cat_setup_call ( AlpTelApplicationId iAppId,

AlpTelSpcCall * ioCallP,

AlpTelTransId * ioTransIdP

)

To setup a call as a result from the SETUP CALL proactive command. The ME shall not check the address against those of the FDN list, even if the Fixed Dialling Number service is enabled.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in,out] ioCallP Pointer to a AlpTelSpcCall structure that must contain the number to dial

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The call has been initiated successfuly.

Since:
ALP iSDK 2.3

alp_status_t alp_tel_cat_setup_event_list ( AlpTelApplicationId iAppId,

AlpTelCatSetUpEventList * iEventListP,

AlpTelTransId * ioTransIdP

)

To forward the set of events the modem has to monitor. This list of events is extracted from the list supplied in the SETUP EVENT LIST proactive command.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] ioOperationP Pointer to a AlpTelCatSetUpEventList structure.

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The event list has been accepted successfuly.

Since:
ALP iSDK 2.4

alp_status_t alp_tel_cat_terminate ( AlpTelApplicationId iAppId,

uint8_t iReason,

AlpTelTransId * ioTransIdP

)

informs the card that the user decided to end the CAT session.

Parameters:

[in] iAppId The telephone application attachement identifier for your application.

[in] iReason The reason of this session termination

[in,out] ioTransIdP Set the value of this parameter to NULL to cause the function to execute synchronously. If this parameter is not NULL, the call executes asynchronously. Upon return from this function, this points to the transaction identifier associated with the asynchronous operation.

Returns:
ALP_STATUS_OK The information has been sent successfuly to the mobile device.

Since:
ALP iSDK 1.0

Generated on Wed Jul 30 07:06:44 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation

Card Application Toolkit Service [Telephony Mgr]

Detailed Description

Data Structures

Defines

Typedefs

Functions

Define Documentation

Typedef Documentation

Function Documentation

Card Application Toolkit Service
[Telephony Mgr]