11 Commands for VGCS and VBS
27.0073GPPAT command set for User Equipment (UE)Release 18TS
11.0 General
This clause defines commands that a TE may use to control a VGCS or VBS supporting MT. The requirements for the VGCS and VBS are included in the following specifications:
– Voice Group Call service (VGCS): 3GPP TS 42.068 [55], 3GPP TS 43.068 [49] and 3GPP TS 44.068 [52];
– Voice Broadcast Service (VBS): 3GPP TS 42.069 [56], 3GPP TS 43.069 [50] and 3GPP TS 44.069 [53].
It is anticipated that VGCS or VBS supporting MTs will vary widely in functionality.
A comprehensive set of VGCS and VBS-specific commands is defined in clause 11.1 to provide the flexibility needed by the more complex MT. The commands use the extended information and error message capabilities described in this specification.
For the simplest MTs, and for backwards compatibility with existing communications software, it is possible to control access to the VGCS and VBS using existing modem-compatible commands. A special dial-string syntax is defined for use with the D command. This "modem compatible" mode of operation is described in clause 11.2.
11.1 Commands specific to MTs supporting the VGCS and VBS
11.1.1 Accept an incoming voice group or voice broadcast call +CAJOIN
Table 132: +CAJOIN action command syntax
|
Command |
Possible Response(s) |
|
+CAJOIN=<service>,<GId>,<GCA> |
+CME ERROR: <err> |
|
+CAJOIN=? |
Description
The execute command accepts an incoming or ongoing voice group or voice broadcast call. Refer clause 9.2 for possible <err> values.
See command +CALCC to get a list of current voice group or voice broadcast calls.
Defined values
<GId>: string of digits that specifies the group identification for the incoming voice group or voice broadcast call.
<GCA>: string of digits that specifies the group call area identification for the incoming voice group or voice broadcast call.
<service>: integer type (tele-service)
17 voice group call
18 voice broadcast call
Implementation
Mandatory for a MT supporting AT commands only and VGCS or VBS is implemented.
11.1.2 Reject an incoming voice group or voice broadcast call +CAREJ
Table 133: +CAREJ action command syntax
|
Command |
Possible Response(s) |
|
+CAREJ=<service>,<GId>,<GCA> |
+CME ERROR: <err> |
|
+CAREJ=? |
Description
The execute command rejects an incoming voice group or voice broadcast call indicated by RING or +CRING, the command is applicable as long as the indication is pending. Refer clause 9.2 for possible <err> values.
If the call is once rejected the RING or +CRING indication is not repeated to TE although the call is still running and notifications for the call are received.
See command +CALCC to get a list of current voice group or voice broadcast calls.
Defined values
<GId>: string of digits that specifies the group identification for the incoming voice group or voice broadcast call.
<GCA>: string of digits that specifies the group call area identification for the incoming voice group or voice broadcast call.
<service>: integer type (tele-service)
17 voice group call
18 voice broadcast call
Implementation
Mandatory for a MT supporting AT commands only and VGCS or VBS is implemented.
11.1.3 Leave an ongoing voice group or voice broadcast call +CAHLD
Table 134: +CAHLD action command syntax
|
Command |
Possible Response(s) |
|
+CAHLD |
+CME ERROR: <err> |
|
+CAHLD=? |
Description
The execute command forces the MT to leave the active voice group or voice broadcast call without terminating it. The command is only applicable if the MT is in group receive mode. The MT returns to idle mode. Refer clause 9.2 for possible <err> values.
Implementation
Mandatory for a MT supporting AT commands only and VGCS or VBS is implemented.
11.1.4 Talker access for voice group call +CAPTT
Table 135: +CAPTT parameter command syntax
|
Command |
Possible Response(s) |
|
+CAPTT=[<mode>[,<time>]] |
+CME ERROR: <err> |
|
+CAPTT? |
+CAPTT: <mode> +CME ERROR: <err> |
|
+CAPTT=? |
+CAPTT: (list of supported <mode>s),(list of supported <time>s) |
Description
The execute command emulates the Push To Talk function for VGCS talker access. If the parameter <mode> is set to value "0" i.e. "Released" the PTT key is assumed to be released immediately. If the parameter <mode> is set to value "1" i.e. "Pushed" the PTT key is assumed to be pushed immediately for the period of <time> in seconds. If the command execution is repeated before the <time> expires the PTT timer will be loaded with the new <time> value and the PTT key remains "Pushed" for the period of new <time> in seconds.
If the parameter <mode> is set to value "2" i.e. "Pushed" the PTT key is assumed to be pushed immediately for an infinite period of time and can be released by <mode> value 0. For <mode>=0 if the parameter <time> is issued it is ignored.
If the PTT timer expires after <time> seconds during <mode> "Pushed" an unsolicited result code +CAPTT: 0 is issued to the TE.
Refer clause 9.2 for possible <err> values.
The read command returns the current <mode>.
The test command returns values supported as compound values.
Defined values
<mode>: integer type.
0 status of the PTT key is Released
1 status of the PTT key is Pushed for a limited time by <time> in seconds
2 status of the PTT key is Pushed for an infinite time
<time>: integer type.
3..255 this gives the time in seconds to wait before the PTT key is released, default value 10
Implementation
Mandatory for a MT supporting AT commands only and VGCS is implemented.
11.1.5 Voice group call uplink status presentation +CAULEV
Table 136: +CAULEV parameter command syntax
|
Command |
Possible Response(s) |
|
+CAULEV=[<mode>] |
+CME ERROR: <err> |
|
+CAULEV? |
+CAULEV: <mode>,[<status>] +CME ERROR: <err> |
|
+CAULEV=? |
+CAULEV: (list of supported <mode>s) |
Description
The set command enables or disables the presentation of uplink access status for an active VGCS call. When enabled the unsolicited result code +CAULEV: <status> is returned from MT to TE whenever the call uplink status changes.
Refer clause 9.2 for possible <err> values.
Read command returns the current uplink <status> and the selected <mode>.
The test command returns values supported as a compound value.
Defined values
<mode>: integer type; status of unsolicited result code presentation.
0 disabled
1 enabled
<status>: integer type; network uplink access status.
0 uplink free
1 uplink busy
Implementation
Mandatory for a MT supporting AT commands only and VGCS is implemented.
11.1.6 List current voice group and voice broadcast calls +CALCC
Table 137: +CALCC action command syntax
|
Command |
Possible response(s) |
|
+CALCC=<mode> |
[+CALCC: <GId>,<GCA>,<service>,<stat>,<dir>,<ack_flag>[,<priority>]] [<CR><LF>+CALCC: <GId>,<GCA>,<service>,<stat>,<dir>,<ack_flag>[,<priority>] […]] +CME ERROR: <err> |
|
+CALCC=? |
+CALCC: (list of supported <mode>s) |
Description
The set command returns for <mode>=1 the active voice group or voice broadcast call and for <mode>=0 a list of all current running voice group and voice broadcast calls for which the user has a subscription and the GId is activated on the SIM. If the command succeeds but no calls are available, OK response is returned. Refer clause 9.2 for possible <err> values.
Test command returns the values supported as a compound value.
Defined values
<mode>: integer type.
0 return a list of all current running voice group and voice broadcast calls for which the user has a subscription and the GId is activated on the SIM
1 return the active voice group or voice broadcast call
<GId>: string of digits that specifies the group identification of the voice group or voice broadcast call.
<GCA>: string of digits that specifies the group call area of the voice group or voice broadcast call.
<service>: integer type (tele-service).
17 voice group call
18 voice broadcast call
<stat>: integer type (state of the call).
0 active, i.e. user participating at the call as talker or listener
1 held, the call is running but put to background, notifications ignored
2 incoming (MT call), the user doesn’t respond to notifications of this call yet
<dir>: integer type (direction of the call).
0 mobile originated (MO) call, the user is the originator of the call
1 mobile terminated (MT) call, the user is not the originator of the call
<ack_flag>: integer type; proposes that a predefined confirmation procedure is to be used after the call is ended.
0 confirmation procedure is not required
1 confirmation procedure is required
<priority>: integer type; identifies the priority level of the voice group or voice broadcast call. The values are specified in 3GPP TS 22.067 [54].
Implementation
Optional. Recommended for an MT supporting AT commands only and VGCS or VBS is implemented.
11.1.7 Voice group or voice broadcast call state attribute presentation +CACSP
Table 138: +CACSP parameter command syntax
|
Command |
Possible Response(s) |
|
+CACSP=[<mode>] |
+CME ERROR: <err> |
|
+CACSP? |
+CACSP: <mode>[,<da>,<ua>,<comm>,<oi>] +CME ERROR: <err> |
|
+CACSP=? |
+CACSP: (list of supported <mode>s) |
Description
The set command enables or disables the presentation of unsolicited result code +CACSP: <da>,<ua>,<comm>,<oi> from MT to TE if the call control state attributes of the active voice group or voice broadcast call changes.
Read command returns the current call control state attributes <da>, <ua>, <comm>, <oi> and selected <mode>.
Refer clause 9.2 for possible <err> values.
The test command returns values supported as a compound value.
Defined values
<mode>: integer type; status of unsolicited result code presentation
0 disabled
1 enabled
<da>: integer type. User connection in the downlink
0 not attached
1 attached
<ua>: integer type. User connection in the uplink
0 not attached
1 attached
<comm>: integer type. The MT assumes that communication with its peer entity is
0 not enabled in both directions
1 enabled in both directions
<oi>: integer type. The MT assumes to be
0 not the originator of the call
1 the originator of the call
Implementation
Optional. Recommended for a MT supporting AT commands only and VGCS or VBS is implemented.
11.1.8 NCH support indication +CANCHEV
Table 139: +CANCHEV parameter command syntax
|
Command |
Possible Response(s) |
|
+CANCHEV=[<mode>] |
+CME ERROR: <err> |
|
+CANCHEV? |
+CANCHEV: <status>,<mode> +CME ERROR: <err> |
|
+CANCHEV=? |
+CANCHEV: (list of supported <mode>s) |
Description
The set command enables or disables the presentation of unsolicited result code +CANCHEV: <status> from MT to TE if the status of the network NCH support information changes.
Read command returns in parameter <status> the network NCH support information in the selected cell and the selected <mode>.
Refer clause 9.2 for possible <err> values.
The test command returns values supported as a compound value.
Defined values
<mode>: integer type; status of unsolicited result code presentation
0 disabled
1 enabled
<status>: integer type; network NCH support information
0 NCH not available
1 NCH available
Implementation
Optional. Recommended for a MT supporting AT commands only and VGCS or VBS is implemented.
11.1.9 Originator to dispatcher information +COTDI
Table 140: +COTDI parameter command syntax
|
Command |
Possible response(s) |
|
+COTDI=<message>[,<OTDIE>[,<message>[,<OTDIE>]]] |
+CME ERROR: <err> |
|
+COTDI? |
[+COTDI: <message>,<OTDIE>[,<message>,<OTDIE>]] |
|
+COTDI=? |
+COTDI: (list of supported <message>s) |
Description
This command allows control of the Originator-to-Dispatcher Information and Compressed Originator-to-Dispatcher Information according to 3GPP TS 44.068 [52] and 3GPP TS 44.069 [53].
When <message> and <OTDIE> are both present the string specified in <OTDIE> is included in the corresponding group or broadcast control <message> as the value part of the Originator-to-Dispatcher Information Element or Compressed Originator-to-Dispatcher Information Element (as defined in 3GPP TS 44.068 [52] and 3GPP TS 44.069 [53]) into all subsequent messages of type <message>. If parameter <message> is present but parameter <OTDIE> is not present then the Originator-to-Dispatcher Information Element shall not be present in sub-sequent messages of type <message>. Refer clause 9.2 for possible <err> values.
The read command returns the content of <message> and of <OTDIE>. If no <OTDIE> is available, no information text shall be returned.
Test command returns values supported as a compound value.
Defined values
<message>: integer type
0 SETUP message containing the outgoing Originator-to-Dispatcher Information Element
1 IMMEDIATE SETUP 2 message containing the outgoing Compressed Originator-to-Dispatcher Information Element
<OTDIE>: the Originator-to-Dispatcher Information Element or Compressed Originator-to-Dispatcher Information Element (as defined in 3GPP TS 44.068 [52] and 3GPP TS 44.069 [53]) in hexadecimal character format (for hexadecimal format, refer +CSCS).
Implementation
Optional.
11.1.10 Short data transmission during ongoing VGCS +CEPTT
Table 141: +CEPTT action command syntax
|
Command |
Possible response(s) |
|
+CEPTT=<mode>,<data>,<dataid>,<dist-param> |
+CME ERROR: <err> |
|
+CEPTT=? |
+CEPTT: (list of supported <mode>s),(list of supported <dataid>s),(list of supported <dist-param>s) |
Description
The execute command emulates the Short Data Transmission during ongoing VGCS according to 3GPP TS 42.068 [55] and 3GPP TS 43.068 [49].
The application indicator <mode> is used to identify whether the application data is an application-specific data or is a confirmation. The data identifier <dataid> is to provide a sequence number of the sending of application data. The value of the data identifier <dataid> is dependent on the value of the application indicator <mode>. If the application indicator <mode> indicates sending application data to the network, the data identifier <dataid> contains a number from the range between 0 and 15 which is generated by the mobile station. If the application indicator <mode> indicates sending confirmation of the reception of the application data, the data identifier <dataid> shall contain the data identifier which was received in the data identity sent by the previous sender. The distribution parameter <dist-param> contains information to which participants shall be transferred the short data.
The response CEPTT string from the network to the other participants is returned in a subsequent unsolicited result code +CEPTT: <mode>,<data>,<dataid>,<dist-param>[,<number>].
Refer clause 9.2 for possible <err> values.
Test command returns values supported as compound values.
Defined values
<mode>: integer type.
0 sending of application-specific data
1 confirmation of receiving application-specific data
<data>: 9 bytes application-specific data in hexadecimal character format (for hexadecimal character format, refer +CSCS).
<dataid>: integer type, a number from the range between 0 and 15.
<dist-param>: integer type, a number from the range between 1 and 7.
1 data shall be distributed only to network application
2 data shall be distributed only to dispatchers
3 data shall be distributed to network application and to dispatchers
4 data shall be distributed to talkers and listeners
5 data shall be distributed to talkers and listeners and to network application
6 data shall be distributed to talkers and listeners and to dispatchers
7 data shall be distributed to network application, to talkers and listeners and to dispatchers
<mode>: integer type.
Implementation
Optional.
11.1.11 Group Id prefixes capability +CGIPC
Table 11.1.11-1: +CGIPC action command syntax
|
Command |
Possible Response(s) |
|
+CGIPC |
+CGIPC: <status> +CME ERROR: <err> |
|
+CGIPC=? |
Description
Execution command returns the MT Group Id prefix management capability, according to 3GPP TS 43.068 [49]. Refer clause 9.2 for possible <err> values.
Defined values
<status>: integer type, value
0 MT is not able to manage Group Id prefixes
1 MT is able to manage Group Id prefixes
Implementation
Optional.
11.2 Modem compatibility commands
11.2.0 General
This clause describes how existing AT commands, designed for use with a modem, may be used to control a VGCS or VBS supporting MT. This is to provide backwards compatibility with existing communications software.
11.2.1 Request VGCS or VBS service ‘D’
Table 141a: D command syntax
|
Command |
Possible Response(s) |
|
D*<SC1>[*<SC2>[*<SC3>]]#<GId>; |
+CME ERROR: <err> |
Description
This Dial command extension is a service request application according to 3GPP TS 22.030 [19]. No further commands may follow on the AT command line.
Responses
When the call has terminated, either as a result of an orderly termination or an error, the MT shall return the NO CARRIER final result code.
Possible error responses include +CME ERROR: <err> when error is related to MT functionality. The requested service, GId and priority level are checked against the subscriptions of the user and the status of the GId stored on the SIM. In case if no subscription is available for this service, GId or priority level or the GId is deactivated an ERROR or +CME ERROR result code is returned. The requested Group Id prefix is not checked against susbscription. The Group Id prefixes are not stored in the SIM/USIM card. If Service Code for Group Id prefix is used, but is not managed by MT, an ERROR or +CME ERROR result code is returned. See +CME ERROR extensions for VGCS, VBS and eMLPP in clause 9.2.3.
Detailed error report of an unsuccessful originated call can be obtained with command Extended Error Report +CEER (if implemented).
NOTE 1: The dial string conforms to the syntax specified in 3GPP TS 22.030 [19].
Defined values
<SC1>: Service Code is a string of digits which identifies a request to use.
17 Voice Group Call Service
18 Voice Broadcast Service
<SC2>: Service Code is a string of digits which identifies a request to use eMLPP priority. Service Code values for different priority levels are specified in 3GPP TS 22.030 [19].
<GId>: a string of digits that specifies the group identification of a called party as specified in 3GPP TS 43.068 [49].
<SC3>: a digit that specifies a Group Id prefix as specified in 3GPP TS 43.068 [49].
NOTE 2: <SC3> is only applicable when <SC1> defines Voice Group Call Service.
Implementation
Mandatory for a MT supporting AT commands only and VGCS or VBS is implemented.
11.2.2 Termination of an voice group or voice broadcast call ‘H’
The V.250 ‘H’ or ‘H0’ (On-hook) command may be used to terminate an ongoing voice group or voice broadcast call. The MT responds with OK. It is an error to issue the ‘H’ command when there is no outstanding network request.
It is an error to issue the ‘H’ command if the user is in group receive mode or the user is not the originator of the call and a ERROR or +CME ERROR result code is returned to the TE. Refer clause 9.2 for possible <err> values.
NOTE: This is an extension to the usage of the ‘H’ command that is described in ITU-T Recommendation V.250 [14].
Implementation
Mandatory for a MT supporting AT commands only and VGCS or VBS is implemented.
11.3 SIM commands supporting the VGCS and VBS
11.3.1 VGCS subscriptions and GId status +CGCS
Table 142: +CGCS parameter command syntax
|
Command |
Possible response(s) |
|
+CGCS=<GId>,<status> |
+CME ERROR: <err> |
|
+CGCS? |
+CGCS: <GId>,<status> [<CR><LF>+CGCS: <GId>,<status> […]] +CME ERROR: <err> |
|
+CGCS=? |
+CGCS: (list of supported <GId>s),(list of supported <status>s) |
Description
This command works with SIM Card and when the GSM Application is selected in UICC. Function with USIM is for further study. The set command is used to edit the status of the GId EFVGCSS on the SIM.
The read command returns all subscribed GIds in EFVGCS and their status in EFVGCSS from the SIM.
Refer clause 9.2 for possible <err> values.
The test command returns the values supported by the UE as compound values.
Defined values
<GId> integer type, group Id as specified in 3GPP TS 22.030 [19]
<status>: integer type, value
0 deactivated
1 activated
Implementation
Mandatory for a MT supporting AT commands only and supporting VGCS.
11.3.2 VBS subscriptions and GId status +CBCS
Table 143: +CBCS parameter command syntax
|
Command |
Possible response(s) |
|
+CBCS=<GId>,<status> |
+CME ERROR: <err> |
|
+CBCS? |
+CBCS: <GId>,<status> [<CR><LF>+CBCS: <GId>,<status> […]] +CME ERROR: <err> |
|
+CBCS=? |
+CBCS: (list of supported <GId>s),(list of supported <status>s) |
Description
This command works with SIM Card and when the GSM Application is selected in UICC. Function with USIM is for further study. The set command is used to edit the status of the GId EFVBSS on the SIM.
The read command returns all subscribed GIds in EFVBS and their status in EFVBSS from the SIM.
Refer clause 9.2 for possible <err> values.
The test command returns the values supported by the UE as compound values.
Defined values
<GId> integer type, group Id as specified in 3GPP TS 22.030 [19]
<status>: integer type, value
0 deactivated
1 activated
Implementation
Mandatory for a MT supporting AT commands only and supporting VBS.
11.4 Informative examples
As supplementary services may be invoked and controlled using dial command according to 3GPP TS 22.030 [19].
Examples of voice group call service request usage:
ATD*17*753#500; (originate voice group call with the priority level 3)
OK (voice group call setup was successful)
ATD*17*750*3#299; (originate voice group call for Group Id 299, with Group Id prefix 3 and priority level 0)
OK (voice group call setup was successful)
ATD*17**6#599; (originate voice group call for Group Id 599, with Group Id prefix 6 and default priority selected by the network)
OK (voice group call setup was successful)