Home · All Classes · Grouped Classes · Annotated · 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.

CommandPossible 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.

CommandPossible 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.

CommandPossible 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.

CommandPossible 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:

ParameterValues
<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.

CommandPossible 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:

0CLIR not provisioned
1CLIR provisioned in permanent mode
2unknown (no network, etc)
3CLIR temporary mode presentation restricted
4CLIR 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.

CommandPossible 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).

CommandPossible 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:

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:

Conforms with 3GPP TS 27.007.

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


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3