Mobile equipment control and status

Module switch off +CPWROFF

+CPWROFF

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

full

No

No

No

< 40 s

+CME Error

Description

Switches off the MT. During shutdown current settings are saved in module’s non-volatile memory.

Using this command can result in the following command line being ignored.

See the corresponding system integration manual for the timing and the electrical details of the module power-off sequence via the AT+CPWROFF command.

Syntax

Type

Syntax

Response

Example

Action

AT+CPWROFF

OK

Test

AT+CPWROFF=?

OK

URC

+UCPWROFF

+UCPWROFF

Notes

  • The +UCPWROFF URC is not supported.

Set module functionality +CFUN

+CFUN

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

partial

No

No

No

Estimated maximum command response time

+CME Error

Description

Selects the level of functionality <fun> in the MT.

Syntax

TypeSyntaxResponseExample

Set

AT+CFUN=<fun>[,<rst>]

OK

AT+CFUN=1

OK

Read

AT+CFUN?

+CFUN: <power_mode>

OK

+CFUN: 1

OK

Test

AT+CFUN=?

+CFUN: (list of supported <fun>'s),(list of supported <rst>'s)

OK

+CFUN: (0,1,4,10,11,15,16,19),(0-1)

OK

URC

+UUFASTSHUTDOWN: <value>

+UUFASTSHUTDOWN: 0

Defined values

ParameterTypeDescription

<fun>

Number

Selected functionality:

  • 0: sets the MT to minimum functionality (disable both transmit and receive RF circuits by deactivating both CS and PS services)

  • 1 (factory-programmed value): sets the MT to full functionality, e.g. from airplane mode or minimum functionality. Full functionality mode is persistent between power cycles triggered by AT+CFUN=15, AT+CFUN=16 or AT+CPWROFF (where supported).

  • 4: disables both transmit and receive RF circuits by deactivating both CS and PS services and sets the MT into airplane mode. Airplane mode is persistent between power cycles triggered by AT+CFUN=15, AT+CFUN=16 or AT+CPWROFF (where supported).

  • 10: fast power-off, the command triggers a fast shutdown, without sending a detach request to the network, with storage of current settings in module’s non-volatile memory. The "OK" final result code indicates the command request was successful, while the +UUFASTSHUTDOWN URC provides the status of the power-off process.

  • 11: safe memory and power-off, the command puts the memory in safe state avoiding further write and erase operations and shuts down the system without performing any controlled shutdown procedure

  • 15: MT silent reset (with detach from network and saving of NVM parameters), without reset of the SIM card

  • 16: MT silent reset (with detach from network and saving of NVM parameters), with reset of the SIM card

  • 19: sets the MT to minimum functionality by deactivating CS and PS services and the SIM card. Re-enable the SIM card by means of <fun>=0, 1, 4.

Allowed values:

  • 0, 1, 4, 10, 11, 15, 16, 19

<rst>

Number

Reset mode:

  • 0 (default value): do not reset the MT before setting it to the selected <fun>

  • 1: performs a MT silent reset (with detach from network and saving of NVM parameters) with reset of the SIM card before setting it to the selected <fun> (if persistent at reboot).

<power_mode>

Number

Power mode:

  • 0: MT is switched on with minimum functionality

  • 1: MT is switched on

  • 4: MT is in "airplane mode"

  • 5: MT is in "test mode"

  • 19: MT is in minimum functionality with SIM deactivated

Allowed values:

  • 0, 1, 4, 19

<value>

Number

Allowed values:

  • 0: fast power-off ongoing

  • 1: fast power-off completed

Notes

  • <fun>=15 resets the SIM card, same as <fun>=16.

  • Only the +UUFASTSHUTDOWN: 1 URC is provided after the trigger of <gpio_mode>=24 GPIO functionality and <fun>=10 command.

Clock +CCLK

+CCLK

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

partial

No

NVM

No

-

+CME Error

Description

Sets and reads the real-time clock of the MT.

Syntax

TypeSyntaxResponseExample

Set

AT+CCLK=<time>

OK

AT+CCLK="14/07/01,15:00:00+01"

OK

Read

AT+CCLK?

+CCLK: <time>

OK

+CCLK: "14/07/01,15:00:00+01"

OK

Test

AT+CCLK=?

OK

Defined values

ParameterTypeDescription

<time>

String

Format is "yy/MM/dd,hh:mm:ss+TZ". Characters indicate year, month, day, hours, minutes, seconds, time zone.

  • The factory-programmed value is "00/01/01,00:00:00+00".

Values prior to the factory-programmed value are not allowed.

Notes

  • If the parameter value is out of range, then the “+CME ERROR: operation not supported” or “+CME ERROR: 4” will be provided (depending on the +CMEE AT command setting).

  • “TZ”: The Time Zone information is represented by two digits. The value is updated during the registration procedure when the automatic time zone update is enabled (using +CTZU AT command) and the network supports the time zone information.

  • The Time Zone information is expressed in steps of 15 minutes and it can assume a value in the range that goes from -96 to +96.

  • Time setting is not permanently stored in NVM.

Set greeting text +CSGT

+CSGT

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

partial

No

NVM

No

-

+CME Error

Description

Configures and activates/deactivates the greeting text. The greeting text configuration’s change will be applied at the subsequent boot. If active, the greeting text is shown at boot once, on any AT interface, the first time the TE sets the DTR line to ON state.

Syntax

TypeSyntaxResponseExample

Set

AT+CSGT=<mode>[,<text>]

OK

AT+CSGT=1,"Hello user"

OK

Read

AT+CSGT?

+CSGT: <text>,<mode>

OK

+CSGT: "Hello",0

OK

Test

AT+CSGT=?

+CSGT: (list of supported <mode>s),<ltext>

OK

+CSGT: (0-1),49

OK

Defined values

ParameterTypeDescription

<text>

String

Greeting text. The factory-programmed value is:

  • "+UUSTATUS: READY"

<mode>

Number

Allowed values:

  • 0: turn off the greeting text

  • 1: turn on the greeting text

Factory-programmed value:

  • 1

<ltext>

Number

Maximum length of the <text> parameter.

Notes

  • The greeting text is shown even if the DTR line is set to OFF state.

Automatic time zone update +CTZU

+CTZU

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

full

Yes

NVM

No

-

+CME Error

Description

Configures the automatic time zone update via NITZ.

The Time Zone information is provided after the network registration (if the network supports the time zone information).

Syntax

TypeSyntaxResponseExample

Set

AT+CTZU=<on_off>

OK

AT+CTZU=1

OK

Read

AT+CTZU?

+CTZU: <on_off>

OK

+CTZU: 0

OK

Test

AT+CTZU=?

+CTZU: (list of supported <on_off>s)

OK

+CTZU: (0-2)

OK

Defined values

ParameterTypeDescription

<on_off>

Number

Automatic time zone update:

  • 0: automatic time zone via NITZ disabled

  • 1: automatic time zone update via NITZ enabled; if the network supports the service, update the local time to the module (not only time zone)

  • 2: automatic time zone update via NITZ enabled; if the network supports the service, update the GMT time to the module (not only time zone)

Allowed values:

  • 0, 1 (factory-programmed value)

Time zone reporting +CTZR

+CTZR

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

partial

Yes

NVM / Profile

No

-

+CME Error

Description

Configures the time zone change event reporting. If the reporting is enabled, according to the <mode> parameter the MT returns:

  • the +CTZV URC whenever the time zone changes and additionally the +CTZDST URC if the daylight saving time information is available

  • the +CTZE URC

  • the +CTZEU URC whenever the universal time reporting is available

Syntax

TypeSyntaxResponseExample

Set

AT+CTZR=<mode>

OK

AT+CTZR=1

OK

Read

AT+CTZR?

+CTZR: <mode>

OK

+CTZR: 0

OK

Test

AT+CTZR=?

+CTZR: (list of supported <mode>s)

OK

+CTZR: (0-1)

OK

URC

+CTZV: <tz>[,<time>]

+CTZV: +04,"12/12/31,23:46:33"

URC

+CTZE: <tz>,<dst>[,<time>]

+CTZE: +04,1,"12/12/31,23:46:33"

URC

+CTZEU: <tz>,<dst>[,<utime>]

+CTZEU: +04,1

URC

+CTZDST: <dst>

+CTZDST: 1

Defined values

ParameterTypeDescription

<mode>

Number

Enables the time zone reporting URCs:

  • 0: disable the time zone change event reporting

  • 1: enable the time zone reporting by +CTZV and +CTZDST URCs

  • 2: enable the time zone reporting by +CTZE URC

  • 3: enable the time zone reporting and universal time reporting by +CTZEU URC according to 3GPP TS 27.007 Release 13

Allowed values:

  • 0 (default value), 1, 2, 3. The +CTZDST URC is not supported.

<tz>

Number

Indicates the time zone. The range goes from -48 to 56.

<time>

String

Current local time in format "yy/MM/dd,hh:mm:ss". The characters indicate year, month, day, hour, minutes, seconds.

<dst>

Number

Indicates the daylight saving time. The allowed values are:

  • 0: no adjustments

  • 1: +1 hour adjustment

  • 2: +2 hours adjustment

<utime>

String

Universal time in format "yyyy/MM/dd,hh:mm:ss". The characters indicate year, month, day, hour, minutes, seconds.

Notes

  • The +CTZU AT command (automatic time zone setting) does not affect the time zone reporting.

  • The time zone information is expressed in steps of 15 minutes.

  • The reported <tz> reflects the <dst> offset: if time zone is +1 hour and the daylight saving time is +1 hour, the reported <tz> is +08.

  • For the +CTZE URC, the local time <time> needs to be derived by the MT.

  • The command setting is stored in the personal profile.

  • The format of the <time> and <utime> parameter is “yy/MM/dd,hh:mm:ss”.

Network Time Synchronization +USNTP

+USNTP

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

Full

No

No

No

<45 s

+CME Error

+USNTP Error

Description

Synchronizes the local RTC time with the Coordinated Universal Time (UTC) via the NTP server.

The local RTC time synchronization via the NTP server will be retained until the module reboot.

Local time is returned via +UUSNTP URC when +CTZU is enabled, otherwise UTC time is returned.

The default EPS bearer with the default CID (<cid>=1) will be used for time synchronization. To activate and use another PDP context for this purpose, use +CGACT and +UDCONF=19 respectively.

Syntax

TypeSyntaxResponseExample

Set

AT+USNTP=<host_name>[,<port>[,<autosync>[,<cid>]]]

OK

AT+USNTP="cn.pool.ntp.org"

OK

Test

AT+USNTP=?

+USNTP: "host_name",(list of supported <port>s),(list of supported <autosync>s),(list of supported <cid>s)

OK

+USNTP: "host_name",(1-65535),(0,1),(1-15)

OK

URC

+UUSNTP: <time>

+UUSNTP: "2020/08/01,08:53:48"

URC

+UUSNTPER: <error_code>

+UUSNTPER: 5

Defined values

ParameterTypeDescription

<host_name>

String

IP address or domain name of the NTP server. For IP address format reference, see the IP addressing.

<port>

Number

NTP server port, the range goes from 1-65535, default port is 123.

<autosync>

Number

Local RTC time synchronization:

  • 0 (default value): disable the synchronization of local RTC from NTP server

  • 1: enable the synchronization of local RTC from NTP server

<cid>

Number

See <cid>. For more details on the default value of the parameter, see description.

<time>

String

Time in format "yyyy/MM/dd,hh:mm:ss". The characters indicate year, month, day, hour, minutes, seconds.

<error_code>

Number

The error occurred while processing the +USNTP command. For the list of the allowed error result codes, see SNTP error codes.

Report mobile termination error +CMEE

+CMEE

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

full

No

Profile

No

-

+CME Error

Description

Configures the formatting of the result code +CME ERROR: <err> as an indication of an error relating to the functionality of the MT. When enabled, MT related errors cause +CME ERROR: <err> final result code instead of the regular ERROR final result code. The error result code is returned normally when an error is related to syntax, invalid parameters or MT functionality.

The command setting is stored in the personal profile following the procedure described in the Saving AT commands configuration section.

Syntax

TypeSyntaxResponseExample

Set

AT+CMEE=[<n>]

OK

AT+CMEE=2

OK

Read

AT+CMEE?

+CMEE: <n>

OK

+CMEE: 0

OK

Test

AT+CMEE=?

+CMEE: (list of supported <n>s)

OK

+CMEE: (0-2)

OK

Defined values

ParameterTypeDescription

<n>

Number

  • 0: +CME ERROR: <err> result code disabled and ERROR used

  • 1: +CME ERROR: <err> result code enabled and numeric <err> values used

  • 2: +CME ERROR: <err> result code enabled and verbose <err> values used

Notes

  • The following convention is valid:

    Numeric error code

    Verbose error code

    Description

    3

    “operation not allowed”

    The MT is in a state which does not allow performing the entered command.

    4

    “operation not supported”

    The error result code is related to a parameter not covered by the GSM/ETSI or u-blox specification

  • The <n> factory-programmed value is 1.

Extended error report +CEER

+CEER

Modules

LEXI-R10401D-00B LEXI-R10801D-00B

Attributes

Syntax

PIN required

Settings saved

Can be aborted

Response time

Error reference

partial

No

No

No

-

+CME Error

Description

Causes the MT to return one or more lines of the information text response which offer an extended report of the reason for:

  • The failure in the last unsuccessful call setup or in-call modification,

  • The last call release,

  • The last unsuccessful GPRS attach / EPS bearer establishment or unsuccessful PDP context activation,

  • The last GPRS / EPS bearer detach or PDP context deactivation.

The total number of characters in the information text response shall not exceed 2041 characters (including line terminators). The textual report is the failure cause according to 3GPP TS 24.008 [24.008].

Syntax

TypeSyntaxResponseExample

Action

AT+CEER

+CEER: <type>[,<cause>,<error_description>,<mcc>,<mnc>]

OK

+CEER: "EMM cause ESM failure",27,"Missing or unknown APN",001,01

OK

Test

AT+CEER=?

OK

Defined values

ParameterTypeDescription

<type>

String

  • "EMM cause": <cause>, <error_description>, <mcc> and <mnc> parameters are provided

  • "ESM cause": <cause> and <error_description> parameters are provided

  • "EMM cause ESM failure": <cause>, <error_description>, <mcc> and <mnc> parameters are provided

  • "No report available": no more parameters are provided

<cause>

Number

Code number of the received error (internal or network originated); more details in series

<error_description>

String

Code description of the received error; more details in series

<mcc>

Number

Mobile Country Code (range 0 - 999)

<mnc>

Number

Mobile Network Code (range 0 - 999)

Notes

  • The GPRS attach/detach and call setup/modification/release are not supported.

  • The <mcc> and <mnc> optional parameters are only displayed after a failed attach attempt, they are no longer displayed after a successful attach.