5 General commands

27.0073GPPAT command set for User Equipment (UE)Release 18TS

5.0 General

ITU‑T Recommendation V.250 [14] includes "Generic DCE Control" commands with the prefix +G. These commands are for the identification of the TA. Four of those commands are adapted here to be the identification commands of the MT. Syntax is otherwise similar, but the prefix is +CG. TIA IS‑99 [15] uses same commands for base station identification.

5.1 Request manufacturer identification +CGMI

Table 2: +CGMI action command syntax

Command	Possible response(s)
+CGMI	<manufacturer> +CME ERROR: <err>
+CGMI=?

Description

Execution command causes the TA to return one or more lines of information text <manufacturer>, determined by the MT manufacturer, which is intended to permit the user of the TA to identify the manufacturer of the MT to which it is connected to. Typically, the text will consist of a single line containing the name of the manufacturer, but manufacturers may choose to provide more information if desired. Refer clause 9.2 for possible <err> values.

Defined values

<manufacturer>: the total number of characters, including line terminators, in the information text shall not exceed 2048 characters.

Text shall not contain the sequence 0<CR> or OK<CR>.

Implementation

Optional.

5.2 Request model identification +CGMM

Table 3: +CGMM action command syntax

Command	Possible response(s)
+CGMM	<model> +CME ERROR: <err>
+CGMM=?

Description

Execution command causes the TA to return one or more lines of information text <model>, determined by the MT manufacturer, which is intended to permit the user of the TA to identify the specific model of the MT to which it is connected to. Typically, the text will consist of a single line containing the name of the product, but manufacturers may choose to provide more information if desired. Refer clause 9.2 for possible <err> values.

Defined values

<model>: the total number of characters, including line terminators, in the information text shall not exceed 2048 characters.

Text shall not contain the sequence 0<CR> or OK<CR>.

Implementation

Optional.

5.3 Request revision identification +CGMR

Table 4: +CGMR action command syntax

Command	Possible response(s)
+CGMR	<revision> +CME ERROR: <err>
+CGMR=?

Description

Execution command causes the TA to return one or more lines of information text <revision>, determined by the MT manufacturer, which is intended to permit the user of the TA to identify the version, revision level or date, or other pertinent information of the MT to which it is connected to. Typically, the text will consist of a single line containing the version of the product, but manufacturers may choose to provide more information if desired. Refer clause 9.2 for possible <err> values.

Defined values

<revision>: the total number of characters, including line terminators, in the information text shall not exceed 2048 characters.

Text shall not contain the sequence 0<CR> or OK<CR>.

Implementation

Optional.

5.4 Request product serial number identification +CGSN

Table 5: +CGSN action command syntax

Command	Possible response(s)
+CGSN[=<snt>]	when <snt>=0 (or omitted) and command successful: <sn> when <snt>=1 and command successful: +CGSN: <imei> when <snt>=2 and command successful: +CGSN: <imeisv> when <snt>=3 and command successful: +CGSN: <svn> +CME ERROR: <err>
+CGSN=?	when TE supports <snt> and command successful: +CGSN: (list of supported <snt>s)

Description

Execution command causes the TA to return IMEI (International Mobile station Equipment Identity number) and related information to identify the MT that the TE is connected to.

Refer clause 9.2 for possible <err> values.

Test command returns values supported as a compound value. For a TA which does not support <snt>, only OK is returned.

Defined values

<snt>: integer type indicating the serial number type that has been requested.

0 returns <sn>

1 returns the IMEI (International Mobile station Equipment Identity)

2 returns the IMEISV (International Mobile station Equipment Identity and Software Version number)

3 returns the SVN (Software Version Number)

<sn>: one or more lines of information text determined by the MT manufacturer. Typically, the text will consist of a single line containing the IMEI number of the MT, but manufacturers may choose to provide more information if desired. The total number of characters, including line terminators, in the information text shall not exceed 2048 characters. Text shall not contain the sequence 0<CR> or OK<CR>.

<imei>: string type in decimal format indicating the IMEI; refer 3GPP TS 23.003 [7], clause 6.2.1. IMEI is composed of Type Allocation Code (TAC) (8 digits), Serial Number (SNR) (6 digits) and the Check Digit (CD) (1 digit). Character set used in <imei> is as specified by command select TE character set +CSCS.

<imeisv>: string type in decimal format indicating the IMEISV; refer 3GPP TS 23.003 [7], clause 6.2.2. The 16 digits of IMEISV are composed of Type Allocation Code (TAC) (8 digits), Serial Number (SNR) (6 digits) and the software version (SVN) (2 digits). Character set used in <imeisv> is as specified by command select TE character set +CSCS.

<svn>: string type in decimal format indicating the current SVN which is a part of IMEISV; refer 3GPP TS 23.003 [7], clause 6.2.2. This allows identifying different software versions of a given mobile. Character set used in <svn> is as specified by command select TE character set +CSCS.

NOTE: The default value <snt>=0 returns the information text <sn> with no command name prefixed. This has been done to retain backward compatibility. All other values of <snt> return the information text including command name prefix.

Informative examples

To get <sn> which returns IMEI of the MT:

AT+CGSN

490154203237518

OK

To get <imei> which returns IMEI of the MT:

AT+CGSN=1

+CGSN: "490154203237518"

OK

Implementation

Optional.

5.5 Select TE character set +CSCS

Table 6: +CSCS parameter command syntax

Command	Possible response(s)
+CSCS=[<chset>]
+CSCS?	+CSCS: <chset>
+CSCS=?	+CSCS: (list of supported <chset>s)

Description

Set command informs TA which character set <chset> is used by the TE. TA is then able to convert character strings correctly between TE and MT character sets.

When TA‑TE interface is set to 8‑bit operation and used TE alphabet is 7‑bit, the highest bit shall be set to zero.

NOTE: It is manufacturer specific how the internal alphabet of MT is converted to/from the TE alphabet.

Read command shows current setting and test command displays conversion schemes implemented in the TA.

Test command returns values supported as a compound value.

Defined values

<chset>: character set as a string type (conversion schemes not listed here can be defined by manufacturers).

"GSM" GSM 7 bit default alphabet (3GPP TS 23.038 [25]); this setting causes easily software flow control (XON/XOFF) problems.

"HEX" Character strings consist only of hexadecimal numbers from 00 to FF; e.g. "032FE6" equals three 8-bit characters with decimal values 3, 47 and 230; no conversions to the original MT character set shall be done.

If MT is using GSM 7 bit default alphabet, its characters shall be padded with 8th bit (zero) before converting them to hexadecimal numbers (i.e. no SMS‑style packing of 7‑bit alphabet).

"IRA" International reference alphabet (see ITU‑T Recommendation T.50 [13]).

"PCCPxxx" PC character set Code Page xxx.

"PCDN" PC Danish/Norwegian character set.

"UCS2" 16-bit universal multiple-octet coded character set (see ISO/IEC10646 [32]); UCS2 character strings are converted to hexadecimal numbers from 0000 to FFFF; e.g. "004100620063" equals three 16-bit characters with decimal values 65, 98 and 99.

"UTF-8" Octet (8-bit) lossless encoding of UCS characters (see RFC 3629 [69]); UTF-8 encodes each UCS character as a variable number of octets, where the number of octets depends on the integer value assigned to the UCS character. The input format shall be a stream of octets. It shall not be converted to hexadecimal numbers as in "HEX" or "UCS2". This character set requires an 8-bit TA – TE interface.

"8859-n" ISO 8859 Latin n (1‑6) character set.

"8859-C" ISO 8859 Latin/Cyrillic character set.

"8859-A" ISO 8859 Latin/Arabic character set.

"8859-G" ISO 8859 Latin/Greek character set.

"8859-H" ISO 8859 Latin/Hebrew character set.

Implementation

Mandatory when a command using the setting of this command is implemented.

5.6 Request international mobile subscriber identity +CIMI

Table 7: +CIMI action command syntax

Command	Possible response(s)
+CIMI	<IMSI> +CME ERROR: <err>
+CIMI=?

Description

Execution command causes the TA to return <IMSI>, which is intended to permit the TE to identify the individual SIM card or active application in the UICC (GSM or USIM) which is attached to MT. Refer clause 9.2 for possible <err> values.

Defined values

<IMSI>: International Mobile Subscriber Identity (string without double quotes)

Implementation

Optional.

5.7 Multiplexing mode +CMUX

Table 8: +CMUX parameter command syntax

Command	Possible response(s)
+CMUX=<transparency>[,<subset>[,<port_speed>[,<N1>[,<T1>[,<N2>[,<T2>[,<T3>[,<k>]]]]]]]]	+CME ERROR: <err>
+CMUX?	+CMUX: <transparency>,[<subset>],<port_speed>,<N1>,<T1>,<N2>,<T2>,<T3>[,<k>] +CME ERROR: <err>
+CMUX=?	+CMUX: (list of supported <transparency>s),(list of supported <subset>s),(list of supported <port_speed>s),(list of supported <N1>s),(list of supported <T1>s),(list of supported <N2>s),(list of supported <T2>s),(list of supported <T3>s),(list of supported <k>s)

Description

This command is used to enable/disable the 3GPP TS 27.010 [45] multiplexing protocol control channel. Refer clause 9.2 for possible <err> values. The AT command sets parameters for the Control Channel. If the parameters are left out, the default value is used.

Read command returns the current settings.

Test command returns the supported parameters as compound values.

It is recommended that the MT/TA/TE should autobaud to the +CMUX command up to and including an interface speed of 9600 bits/s.

The OK or +CME ERROR: <err> response is returned at the speed of the +CMUX command prior to entering <transparency>.

It is recommended that whenever the multiplexer control channel is released the MT/TA/TE should assume an interface rate of up to and including 9600 bits/s for auto bauding purposes irrespective of any previous higher speed having been selected.

If a +CMUX command is issued whilst in any multiplexer mode then that +CMUX command shall be ignored and the MT/TA shall return a +CME ERROR: <err> response.

Defined values

<transparency>: integer type (multiplexer Transparency Mechanism).

0 Basic option

1 Advanced option

<subset>: integer type. This parameter defines the way in which the multiplexer control channel is set up. A virtual channel may subsequently be set up differently but in the absence of any negotiation for the settings of a virtual channel, the virtual channel shall be set up according to the control channel <subset> setting.

0 UIH frames used only

1 UI frames used only

2 I frames used only

<port_speed> integer type (transmission rate). The default value is implementation specific.

1 9 600 bit/s

2 19 200 bit/s

3 38 400 bit/s

4 57 600 bit/s

5 115 200 bit/s

6 230 400 bits/s

<N1>: integer type (maximum frame size).

1- 32768, where the 31 is default for Basic option and 64 is default for Advanced option (see <transparency>)

<T1>: integer type (acknowledgement timer in units of ten milliseconds).

1-255, where 10 is default (100 ms)

<N2>: integer type (maximum number of re-transmissions).

0-100, where 3 is default

<T2>: integer type (response timer for the multiplexer control channel in units of ten milliseconds).

2-255, where 30 is default (300 ms)

NOTE: T2 must be longer than T1.

<T3>: integer type (wake up response timer in seconds).

1-255, where 10 is default

<k>: integer type (window size, for Advanced option with Error-Recovery Mode).

1-7, where 2 is default

Implementation

Mandatory, if 3GPP TS 27.010 [45] supported in the MT/TA.

5.8 ITU‑T Recommendaton V.250 [14] generic TA control commands

Table 9: V.250 generic TA control commands

Command	Clause	Impl.	Used in the present document
Z[<value>]	6.1.1	mand.	TA sets all parameters to their defaults as specified by a user memory profile or by the manufacturer, and resets TA
&F[<value>]	6.1.2	mand.	TA sets all parameters to their defaults as specified by the manufacturer
I[<value>]	6.1.3	opt.	request manufacturer specific information about the TA (software cannot use this command to determine the capabilities of a TA)
+GMI	6.1.4	mand.	request TA manufacturer identification (may equal to +CGMI)
+GMM	6.1.5	mand.	request TA model identification (may equal to +CGMM)
+GMR	6.1.6	mand.	request TA revision identification (may equal to +CGMR)
+GSN	6.1.7	opt.	request TA serial number identification (may equal to +CGSN)
+GOI	6.1.8	opt.	request ISO system global object identification of the TA (general format defined in ITU‑T Recommendation X.208; encoding rules in ITU‑T Recommendation X.209)
+GCAP	6.1.9	mand.	request overall capabilities of TA; the response code for a TA building on this document shall be +CGSM
+GCI=<T.35>	6.1.10	opt.	selects the country of installation for the TA using ITU‑T Recommendation T.35 Annex A country codes

5.9 PCCA STD‑101 [17] select wireless network +WS46

PCCA STD‑101 [17] includes a command to select the cellular network (Wireless Data Service; WDS) to operate with the TA. PCCA calls this WDS‑Side Stack Selection. This command may be used when TA is asked to indicate the networks in which it can operate.

Table 10: +WS46 parameter command syntax

Command	Possible response(s)
+WS46=[<n>]
+WS46?	<n>
+WS46=?	(list of supported <n>s)

Description

Set command selects the WDS side stack <n> to be used by the TA. Read command shows current setting and test command displays side stacks implemented in the TA.

Read command (query) returns the current value of <n>.

Test command returns values supported as a compound value.

Defined values for Query

<n>: integer type

12 GSM Digital Cellular Systems (GERAN only)

22 UTRAN only

25 3GPP Systems (GERAN, UTRAN and E-UTRAN)

28 E-UTRAN only

29 GERAN and UTRAN

30 GERAN and E-UTRAN

31 UTRAN and E-UTRAN

35 GERAN, UTRAN, E-UTRAN and NG-RAN

36 NG-RAN only

37 NG-RAN and E-UTRAN

38 NG-RAN, E-UTRAN and UTRAN

39 NG-RAN, E-UTRAN and GERAN

40 NG-RAN and UTRAN

41 NG-RAN, UTRAN and GERAN

42 NG-RAN and GERAN

The values in <n> for Query are mutually exclusive. If one value (e.g. "25") is returned, other values shall not be returned.

Defined values for Set

<n>: integer type

12 3GPP System

22 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

25 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

28 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

29 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

30 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

31 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

35 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

36 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

37 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

38 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

39 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

40 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

41 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

42 Not used. If received, the value shall be treated as if 12 had been received or an ERROR shall be returned.

refer PCCA STD‑101 [17] for other values.

Implementation

Mandatory in PCCA STD‑101 [17], but optional in the context of this specification.

5.10 Request 5G subscription permanent identifier +CSUPI

Table 5.10-1: +CSUPI action command syntax

Command	Possible response(s)
+CSUPI	<SUPI> +CME ERROR: <err>
+CSUPI=?

Description

Execution command causes the TA to return <SUPI>, which is intended to permit the TE to identify the individual USIM card or active application in the UICC which is attached to 5G MT. Refer clause 9.2 for possible <err> values.

Defined values

<SUPI>: 5G subscription permanent identifier (string without double quotes).

Implementation

Optional. This command is superfluous when the command +CIMI or +CNAI is supported.

5.11 Request 5G network specific identifier +CNAI

Table 5.11-1: +CNAI action command syntax

Command	Possible response(s)
+CNAI	<NAI> +CME ERROR: <err>
+CNAI=?

Description

Execution command causes the TA to return <NAI>, which is intended to permit the TE to identify the individual USIM card or active application in the UICC which is attached to 5G MT. Refer clause 9.2 for possible <err> values.

Defined values

<NAI>: Network Access Identifier (NAI), as specified in 3GPP TS 23.003 [7], when SUPI is in NAI format (string without double quotes) consisting of:

– network specific identifier (NSI), as specified in 3GPP TS 23.003 [7], when SUPI type is NSI;

– Global Line Identifier (GLI), as specified in 3GPP TS 23.003 [7] clause 28.15.2, when SUPI type is GLI; or

– Global Cable Identifier (GCI), as specified in 3GPP TS 23.003 [7] clause 28.16.2, when SUPI type is GCI.

Implementation

Optional.

5.12 Informative examples

When beginning to build a communication link, a general TE application controlling a TA needs to determine the TA and the MT to which it is connected. ITU‑T Recommendation V.250 [14] has seven commands for TA identification from which four are mandatory to be implemented in a TA. An example of this command sequence requesting manufacturer (+GMI), model (+GMM), revision (+GMR) and serial number (+GSN) information would be:

AT+GMI

Manufacturer ABC

OK

AT+GMM

GSM Ultimate Data Device

OK

AT+GMR

1.00

OK

AT+GSN

987612345‑123

OK

The maximum lengths of the information responses are defined to be 2048 characters, but it is recommended that they are kept as simple as in the example. The serial number command is defined as optional. Another optional command is Global Object Identification command (+GOI) which should return the object identifiers of ITU‑T Recommendation X.208 as numeric strings delimited by periods. The Complete Capabilities List command (+GCAP) indicates the major capability areas of the TA. The support of different areas is presented in the response of +GCAP command. Each area can be presented by the selection command name of a specific capability area (e.g. +FCLASS for fax support) or some other predefined response. For instance, a GSM TA with fax capabilities could respond as follows:

AT+GCAP

+GCAP: +CGSM,+FCLASS,+W

OK

The first supported area in the response is presented with +CGSM. It is the response text to show that some or all GSM commands of the present document are supported. Second response text (+FCLASS) informs that some fax or voice capabilities are present, and the third text (+W) about the presence of wireless commands as specified by PCCA STD‑101 [17]. Command +FCLASS=? (refer e.g. ITU‑T Recommendation T.31 [11] and ITU‑T Recommendation T.32 [12]) can be used to query the supported fax capabilities and +WS46=? to query the wireless data services available:

AT+FCLASS=?;+WS46=?

0,1,2,2.0

(12)

OK

The TA of this example supports GSM data services, and fax service class 1 (TIA‑578‑A), 2 (manufacturer specific) and 2.0 (ITU‑T Recommendation T.32 [12] / TIA‑592).

The present document defines commands for MT identification which are similar to those for TA identification in ITU‑T Recommendation V.250 [14], for an example:

AT+CGMI

Mobile Manufacturer XYZ

OK

AT+CGMM

GSM Phone 1234

OK

AT+CGMR

1.00

OK

AT+CGSN

123456121234561

OK

Manufacturer, model and version commands work similarly as for TA, except that the serial number query returns the International Mobile Station Equipment Identity (IMEI) number. IMEI is fifteen digits long and consists of a type approval code, a final assembly code, a serial number and a spare digit (refer 3GPP TS 23.003 [7]). When the TA is implemented inside MT, the responses for both TA and MT queries will most likely follow the responses of MT identification.