Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

[Previous: Modem Emulator - Network] [Next: Modem Emulator - GPRS]

Modem Emulator - Supplementary Services

The AT commands in this section are used for accessing GSM supplementary services such as call waiting, caller-id, etc.

AT+CCWA Call Waiting

The AT+CCWA command allows control of the Call Waiting supplementary service according to 3GPP TS 22.083.

Command	Possible Responses
`AT+CCWA=[<n>[,<mode>[,<class>]]]`	when `<mode>`=2 and command successful: +CCWA: <status>,<class1> +CCWA: <status>,<class2> ...
`AT+CCWA?`	`+CCWA: <n>`
`AT+CCWA=?`	`+CCWA: (0,1)`

Activation, deactivation, and status query are supported. When querying the status of a network service (<mode>=2) the response line for the "not active" case (<status>=0) should be returned only if the service is not active for any <class>.

Parameter <n> is used to disable/enable the presentation of an unsolicited result code +CCWA: <number>,<type>,<class>,[<alpha>][,<CLI validity>[,<subaddr>,<satype>[,<priority>]]] to the TE when the call waiting service is enabled.

Test command returns the supported unsolicited presentation values.

`<n>`	Unsolicited presentation status value. 0 Disable 1 Enable
`<mode>`	Mode of call waiting operation to perform. 0 Disable call waiting 1 Enable call waiting 2 Query status
`<class>`	Sum of integers representing a class of information (default 7). 1 voice (telephony) 2 data (refers to all bearer services) 4 reserved for future use: fax 8 short message service 16 data circuit sync 32 data circuit async 64 dedicated packet access 128 dedicated PAD access
`<status>`	0 not active 1 active
`<number>`	String type phone number of calling address in format specified by `<type>`.
`<type>`	Type of address octet in integer format (refer 3GPP TS 24.008).
`<alpha>`	String indicating the name of a phonebook entry corresponding to `<number>`. Usually this is empty.
`<CLI validity>`	0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network.
`<subaddr>`	String type subaddress of format specified by `<satype>`.
`<satype>`	Type of subaddress octet in integer format (refer 3GPP TS 24.008).
`<priority>`	Digit indicating eMLPP priority level of incoming call (refer 3GPP TS 22.067).

Conforms with: 3GPP TS 27.007.

AT+CLIP Calling line identification presentation

The AT+CLIP command allows control of the calling line identification presentation supplementary service.

Command	Possible Responses
`AT+CLIP=[<n>]`	`OK`
`AT+CLIP?`	`+CLIP: <n>,<m>`
`AT+CLIP=?`	`+CLIP: (0,1)`

Set command enables or disables the presentation of the CLI at the TE. It has no effect on the execution of the supplementary service in the network. When <n> is 1, the unsolicited response +CLIP: <number>,<type>[,<subaddr>,<satype>[,[<alpha>][,<CLI validitity>]] is sent to the TE after every RING or +CRING response.

Read command gives the status of <n>, plus the provision status of the CLIP service (<m>).

`<n>`	Unsolicited presentation status value. 0 Disable 1 Enable
`<m>`	Provision status of CLIP in the network: 0 CLIP not provisioned 1 CLIP provisioned 2 unknown (e.g. no network, etc.)
`<number>`	String type phone number of calling address in format specified by `<type>`.
`<type>`	Type of address octet in integer format (refer 3GPP TS 24.008).
`<subaddr>`	String type subaddress of format specified by `<satype>`.
`<satype>`	Type of subaddress octet in integer format (refer 3GPP TS 24.008).
`<alpha>`	String indicating the name of a phonebook entry corresponding to `<number>`. Usually this is empty.
`<CLI validity>`	0 CLI valid 1 CLI has been withheld by the originator 2 CLI is not available due to interworking problems or limitations of originating network.

Conforms with: 3GPP TS 27.007.

AT+CSSN Supplementary Service Notifications

The AT+CSSN command refers to supplementary services related network initiated notifications. It controls the presentation of notification result codes from TA to TE.

Command	Possible Responses
`AT+CSSN=[<n>[,<m>]]`
`AT+CSSN?`	`+CSSN: <n>,<m>`
`AT+CSSN=?`	`+CSSN:`(list of supported `<n>`s)`,`(list of supported `<m>`s)

<n> parameter enables presentation of the +CSSI result code to the TE. <m> parameter enables presentation of the +CSSU result code to the TE. For each, values of 0 (disable; default) and 1 (enable) are supported.

Conforms with: 3GPP TS 27.007.

AT+CCFC Call Forwarding

The AT+CCFC command allows control of the call forwarding supplementary service according to 3GPP TS 22.082.

Command	Possible Responses
`AT+CCFC=<reason>,<mode>[,<number>[,<type>[,<class>[,<subaddr>[,<satype>[,<time>]]]]]]`	`+CME ERROR: <err>` when <mode>=2 and command successful: `+CCFC: <status>,<class1>[,<number>,<type>[,<subaddr>,<satype>[,<time>]]] [<CR><LF>+CCFC: <status>,<class2>[,<number>,<type>[,<subaddr>,<satype>[,<time>]]] [...]]`
`AT+CCFC=?`	`+CCFC:`(list of supported `<reason>`s)

Defined Values:

Parameter	Values
`<reason>`	0 Unconditional 1 Mobile Busy 2 No Reply 3 Not Reachable 4 All Call Forwarding 5 All Conditional Call Forwarding
`<mode>`	0 Disable 1 Enable 2 Query Status 3 Registration 4 Erasure
`<number>`	string type phone number of forwarding address in format specified by `type`
`<type>`	type of address octet in integer format (see TS 24.008 [8]); default 145 when dialling string includes international access code character `+', else 129
`<subaddr>`	string type subaddress of the format specified by `<satype>`
`<satype>`	type of subaddress octet in integer format (see TS 24.008 [8]); default 128
`<class>`	sum of integers representing a class of information (default 7): 1 voice (telephony) 2 data (refers to all bearer services) 4 reserved for future use: fax (facsimile services) 8 short message service 16 data circuit sync 32 data circuit async 64 dedicated packet access 128 dedicated PAD access 7 default (voice, data and fax)
`<time>`	1..30; when "no reply" is enabled or queried, this gives the time in seconds to wait before the call is forwarded. Default value of 20
`<status>`	0 Not Active 1 Active

Conforms with: 3GPP TS 27.007.

AT+CLIR Calling Line Identification Restriction

This command allows a calling subscriber to enable or disable the presentation of the CLI to the called party when originating a call.

Command	Possible Responses
`AT+CLIR=[<n>]`
`AT+CLIR?`	`+CLIR: <n>,<m>`
`AT+CLIR=?`	`+CLIR:`(list of supported `<n>`s)

The <n> parameter sets the adjustment for outgoing calls, and can be 0 (default; according to CLIR subscription), 1 (invocation), or 2 (suppression).

The <m> parameter shows the subscriber CLIR service status in the network. It can be one of:

0	CLIR not provisioned
1	CLIR provisioned in permanent mode
2	unknown (no network, etc)
3	CLIR temporary mode presentation restricted
4	CLIR temporary mode presentation allowed

Conforms with: 3GPP TS 27.007.

AT+COLP Connected Line Identification Presentation

This command enables a calling subscriber to get the line identity of the called party after setting up a mobile originated call. The command enables or disables the presentation of the connected line identity at the TE.

Command	Possible Responses
`AT+COLP=[<n>]`
`AT+COLP?`	`+COLP: <n>,<m>`
`AT+COLP=?`	`+COLP:`(list of supported `<n>`s)

In this implementation of AT+COLP the line identity information is presented after the establishment of any type of call.

The <n> parameter can be 0 (default; disable) or 1. The <m> parameter shows the subscriber COLP service status in the network. See 27.007 for complete details.

Conforms with: 3GPP TS 27.007.

AT+CUSD Unstructured Supplementary Service Data

The AT+CUSD command allows control of the Unstructured Supplementary Service Data (USSD).

Command	Possible Responses
`AT+CUSD=[<n>[,<str>[,<dcs>]]]`	`+CME ERROR: <err>`
`AT+CUSD?`	`+CUSD: <n>`
`AT+CUSD=?`	`+CUSD:`(list of supported `<n>`s)

The <n> parameter can take the following values:

0 Disable result code presentation to TE (default)
1 Enable result code presentation to TE
2 Cancel session (not applicable to read command response)

When <str> is given, a mobile initiated USSD string is sent to the network. The response USSD string from the network is returned in a subsequent unsolicited +CUSD result code.

The <dcs> parameter defines the Cell Broadcast Data Coding Scheme in integer format (default 0).

The unstructured supplementary service data response is of the form +CUSD: <m>[,<str>,<dcs>] where <m> can take the following values:

0 No further user action required
1 Further user action required
2 USSD terminated by network
3 Other local client has responded
4 Operation not supported
5 Network time-out

Conforms with 3GPP TS 27.007.

[Previous: Modem Emulator - Network] [Next: Modem Emulator - GPRS]

Trademarks

Qt Extended 4.4.3