MZCommands

Module Start

This command is used to initialize monoZ:Jet module and check SIM Status, Configure Band and OrgID, attach to cellular network and open connection with IoT platform using run time value. This command must be used after +MZREADY from monoZ:Jet module. Upon unsuccessful network/IoT connection in first attempt, monoZ:Jet shall send back a failure URC and attempt connection with network/platform 2 more times with unsuccessful URC after every attempt in case of failure. After +MZSTART:0, further +MZSTART URCs can be expected anytime in the event of network or IoT PF disconnect.

Execution command

MZSTART

Response
MZOK/MZFAIL
+MZSTART: <s_sts> 
+DEBUG: <dbg_sts> 

Defined Values

<s_sts>

Integer Type.

Start Success

SIM Not Inserted

Band Setting Fail

Network Connection Fail

IoT Platform Connection Fail

Modem Start Fail

<dbg_sts>
*Only when Debug mode is ON.

Integer Type.

Not registered, MZJ is not currently searching a new operator to register

Registered, home network

Not registered, but MZJ is currently searching a new operator to register

Registration denied

Unknown (e.g. out of GERAN/UTRAN/E UTRAN coverage)

Registered, roaming

Modem Power ON Success

Modem Power ON Failed

Modem Power OFF Success

Modem Power OFF Failed

Modem Band Setting Success

Network Connect Success

Network Disconnect Success

Network Disconnect Failed

IoT platform open Success

IoT platform open Failed

IoT platform not connected

Network not connected

Maximum Response Time

MZOK/MZFAIL	1 second
+MZSTART/+DEBUG	3 minutes

Usage

Without Debug Mode

+MZREADY
MZSTART
MZOK
+MZSTART: 0

With Debug Mode

MZSTART
MZOK
MZDEBUG=1
MZOK
+MZDEBUG: 10
+MZDEBUG: 14
+MZDEBUG: 10
+MZDEBUG: 2
+MZDEBUG: 0
+MZDEBUG: 2
+MZDEBUG: 5
+MZDEBUG: 15
+MZDEBUG: 20
+MZSTART: 0

Firmware Version

This command reads the current software version of monoZ:Jet.

Execution command

MZVERSION

Response
MZOK/MZFAIL
+MZVERSION: <version> 

Defined Values

<version>

String Type.

Maximum Response Time

MZOK/MZFAIL	1 second
+MZVERSION	1 second

Usage

Without Debug Mode

MZVERSION
MZOK
+MZVERSION: MZJ2_V2.0.1

Data Send

This command is used to send data to IoT PF through monoZ:Jet.

Execution command
MZSEND=<payload> 

Response
MZOK/MZFAIL
+MZSEND: <send_sts> 
+DEBUG: <dbg_sts> 

Defined Values

<payload>

String Type.

Max byte size

1024B

Accepted Characters

Alphanumeric, Kanji, “#$%&’()//<>.,?
There is a possibility certain kanji characters may not be accepted.

<send_sts>

Integer Type.

Send Success

Send Fail

Send Payload size exceeds

<dbg_sts>
*Only when Debug mode is ON.

Integer Type.

Data Send Success

Data Send Retransmit

Data Send Failed

Maximum Response Time

MZOK/MZFAIL	1 second
+MZSEND/+DEBUG	5 seconds

Usage

Without Debug Mode

MZSEND=Payload123
MZOK
+MZSEND: 0

With Debug Mode

MZSEND=Payload123
MZOK
+MZDEBUG: 30
+MZSEND: 0

DL Data Receive

This command enable monoZ:Jet to receive data from IoT Platform.

Execution command

MZRECEIVE

Response
MZOK/MZFAIL
+MZRECEIVE: <r_sts> 
+MZRECEIVE: <r_sts>,<DL data> 
+MZDEBUG: <dbg_sts>

Defined Values

<DL data>

String Type.

Max Byte size

1020B

Accepted Characters

Alphanumeric, Kanji, “#$%&’()//<>.,?

<receive_sts>

Integer Type.

Receive success

Receive failed

Receive payload

Receive payload size exceed limit

<dbg_sts>
*Only when Debug mode is ON.

Integer Type.

IoT Platform Receive Subscribe Success

IoT Platform Receive Subscribe Failed

Maximum Response Time

MZOK/MZFAIL	1 second
+MZRECEIVE/+DEBUG	5 seconds

Usage

Without Debug Mode

MZRECEIVE
MZOK
+MZRECEIVE: 0
<when message sent from platform>
+MZRECEIVE: 2,"Test message"

With Debug Mode

MZRECEIVE
+MZDEBUG: 40
+MZRECEIVE: 0
<when message sent from platform>
+MZRECEIVE: 2,"Test message"

Sleep

This command is used to put the module to different Low Power Modes(LPM).

Execution command
MZSLEEP=<Key_val> 

Response
MZOK/MZFAIL
+MZSLEEP: <sleep_sts> 
+DEBUG: <dbg_sts>

Defined Values

<Key_val>

Integer Type.

Full sleep. Wake up triggered by raising HOST to BOARD_WKP(P407) Pin to HIGH. MCU will go to Full sleep mode after 5 sec of receiving +MZSLEEP: 0 URC and shall not take any MZ input via UART.

Network Disconnect (Module will be in ON state but Network will be disconnected).

Platform Disconnect (Module will be in ON state, Network will be in connected state, module will be disconnected from IoT PF).

<sleep_sts>

Integer Type.

Sleep Success

Sleep Fail

<dbg_sts>
*Only when Debug mode is ON.

Integer Type.

Modem Power OFF Success

Modem Power OFF Failed

Network Disconnect Success

Network Disconnect Failed

IoT platform Disconnect Success

IoT platform Disconnect Failed

Maximum Response Time

MZOK/MZFAIL	1 second
+MZSLEEP/+DEBUG	5 seconds

Usage

Without Debug Mode

MZSLEEP=1
MZOK
+MZSLEEP:0

With Debug Mode

MZSLEEP=1
MZOK
+DEBUG: 50
+MZSLEEP: 0

Time

This command is used to capture and return the real time clock.

Execution command

MZTIME

Response
MZOK/MZFAIL
+MZTIME: <r_sts>,<yy/mm/dd,hh:mm:ss±zz>
+MZTIME: <r_sts>

Defined Values

<r_sts>

Integer Type.

Time Read Success

Time Read Failed

Maximum Response Time

MZOK/MZFAIL	1 second
+MZTIME	1 second

Usage

Without Debug Mode

MZTIME
+MZTIME: 0,2024/06/17,16:11:23+36

NW Status

This command is used to read current network status.

MZNWSTATUS Capture Network Status

Execution Command

Response

MZSTATUS

MZOK
+MZNWSTATUS: 
<r_sts>,<sysmode>,<value1>,<value2>,<value3,<value4>
+MZNWSTATUS: <r_sts>

Mzximum Response Time

MZOK: 1 second
+MZNWSTATUS: 2 seconds

Execution command

MZSTATUS

Defined Values

<r_sts>

Integer Type.

Network Status Read Success

Network Status Read Failed

<sysmode>

String Type.

"NOSERVICE"

No Service Mode

"GSM"

GSM/GPRS/EDGE mode

"eMTC"

eMTC mode

"NBIoT"

NB-IoT mode

The following table lists the signal strength type corresponding to each service mode.

<sysmode>	<value1>	<value2>	<value3>	<value4>
NO SERVICE	-	-	-	-
GSM	<GSM_RSSI>	-	-	-
eMTC	<LTE_RSSI>	<LTE_RSRP>	<LTE_SINR>	<LTE_RSRQ>
NBIoT	<LTE_RSSI>	<LTE_RSRP>	<LTE_SINR>	<LTE_RSRQ>

<GSM_RSSI>

Integer Type.

Received signal strength indicator (dBm)

<LTE_RSSI>

Integer Type.

Received signal strength indicator (dBm)

<LTE_RSRP>

Integer Type.

Received signal strength indicator (dBm)

<LTE_SINR>

Integer Type.

Signal-to-interference-plus-noise-ratio (SINR). Logarithmic value of SINR. Values are in 1/5th of a dB. Range: 0–250, which translates to -20 dB to +30 dB

<LTE_RSRQ>

Integer Type.

Reference signal received quality (dBm)

Maximum Response Time

MZOK/MZFAIL	1 second
+MZNWSTATUS	1 second

Usage

Without Debug Mode

MZNWSTATUS
+MZNWSTATUS: 0,"eMTC",-66,-88,140,-8

Debug

This command is used to enter and exit Debugging mode. If entered once it shall put monoZ:Jet in debug mode until exited.

Execution command
MZDEBUG=<key_val>

Response
MZOK/MZFAIL
MZOK

Defined Values

<key_val>

Integer Type.

Enter Debugging Mode

Exit Debugging Mode

Maximum Response Time

MZOK/MZFAIL	1 second
OK/	1 second

Usage

Without Debug Mode

MZDEBUG=1
MZOK

Set Org ID

This command is used to configure ORGID setting for connecting with monoZ:Link IoT PF. ORG ID can be set only before MZSTART.

Execution command
MZORGID="<org_id>"

Response
MZOK/MZFAIL
+MZORGID: <cfg_sts>

Defined Values

<org_id>

String Type.

Maximum Size:

12B

Acceptable characters

Alphanumeric, “#$%&’()//<>.,?

<cfg_sts>

Integer Type.

ORGID Configuration Success

ORGID Configuration Fail

ORGID Syntax Invalid

ORGID Length Exceeds

Maximum Response Time

MZOK/MZFAIL	1 second
+MZORGID	5 second

Usage

Without Debug Mode

MZORGID="MTI-1"
+MZORGID: 0

Set Band

This command is used for configure BAND setting to connect with network. By default, all supported bands are enabled in ascending order of priority.

Execution command
MZBAND="<GSM_bandval>","<eMTC_bandval>","<NB_IoT_bandval>"

Response
MZOK/MZFAIL
+MZBAND: <cfg_sts>

Defined Values

<GSM_bandval>

A hexadecimal value that specifies the GSM frequency band (e.g.: 0xa =0x2(DCS1800) + 0x8(PCS1900)). If it is set to 0, it means not to change GSM frequency band.

No Change

0x1

EGSM900

0x2

DCS1800

0x4

GSM850

0x8

PCS1900

0xf

All of the supported bands above

<eMTC_bandval>

A hexadecimal value that specifies the eMTC frequency band (e.g.: 0x15 =0x01(LTE B1) + 0x04(LTE B3) + 0x10(LTE B5)). If it is set to 0, the eMTC frequency band will not be changed.

No Change

0x0

All supported bands

0x1 (BAND_PREF_LTE_BAND1)

LTE B1

0x2 (BAND_PREF_LTE_BAND2)

LTE B2

0x4 (BAND_PREF_LTE_BAND3)

LTE B3

0x8 (BAND_PREF_LTE_BAND4)

LTE B4

0x10 (BAND_PREF_LTE_BAND5)

LTE B5

0x80 (BAND_PREF_LTE_BAND8)

LTE B8

0x800 (BAND_PREF_LTE_BAND12)

LTE B12

0x1000 (BAND_PREF_LTE_BAND13)

LTE B13

0x20000 (BAND_PREF_LTE_BAND18)

LTE B18

0x40000 (BAND_PREF_LTE_BAND19)

LTE B19

0x80000 (BAND_PREF_LTE_BAND20)

LTE B20

0x1000000 (BAND_PREF_LTE_BAND25)

LTE B25

0x2000000 (BAND_PREF_LTE_BAND26)

LTE B26

0x4000000 (BAND_PREF_LTE_BAND27)

LTE B27

0x8000000 (BAND_PREF_LTE_BAND28)

LTE B28

0x20000000000000000 (BAND_PREF_LTE_BAND66)

LTE B66

<NB-IoT_bandval>

A hexadecimal value that specifies the NB-IoT frequency band (e.g.: 0x15 =0x01(LTE B1) + 0x04(LTE B3) + 0x10(LTE B5)). If it is set to 0, the NB-IoT frequency band will not be changed. By default, all bands are set.

No Change

0x0

All supported bands

0x1 (BAND_PREF_LTE_BAND1)

LTE B1

0x2 (BAND_PREF_LTE_BAND2)

LTE B2

0x4 (BAND_PREF_LTE_BAND3)

LTE B3

0x8 (BAND_PREF_LTE_BAND4)

LTE B4

0x10 (BAND_PREF_LTE_BAND5)

LTE B5

0x80 (BAND_PREF_LTE_BAND8)

LTE B8

0x800 (BAND_PREF_LTE_BAND12)

LTE B12

0x1000 (BAND_PREF_LTE_BAND13)

LTE B13

0x20000 (BAND_PREF_LTE_BAND18)

LTE B18

0x40000 (BAND_PREF_LTE_BAND19)

LTE B19

0x80000 (BAND_PREF_LTE_BAND20)

LTE B20

0x1000000 (BAND_PREF_LTE_BAND25)

LTE B25

0x8000000 (BAND_PREF_LTE_BAND28)

LTE B28

0x20000000000000000 (BAND_PREF_LTE_BAND66)

LTE B66

<cfg_sts>

Integer Type.

Band Configuration Success

Invalid GSM Band value

GSM Band value Length Exceeds

Invalid eMTC Band value

eMTC Band value Length Exceeds

Invalid NB-IoT Band value

NB-IoT Band value Length Exceeds

Maximum Response Time

MZOK/MZFAIL	1 second
+MZBAND	5 second

Usage

Without Debug Mode

MZBAND=”0x0”,”0x2089b”,”0x80a”
+MZBAND: 0

Special URC

monoZ:Jet has 2 special URCs namely MZFAIL and MZERROR as described below.

MZFAIL SPECIAL MZFAIL
Response URC MZFAIL	MZFAIL URC shall be returned for each new MZ command If any prior MZ Command is in progress and respected success URC has not been received Host commands (MZTIME, MZNWSTATUS, MZSEND, MZRECEIVE) before MZSTART will return MZFAIL. Host Configuration Commands (MZBAND, MZORGID) after MZSTART will return MZFAIL URC
Response URC MZFAIL	MZERROR URC shall be returned for Invalid MZ command

MZCommands

Module Start​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

With Debug Mode

Firmware Version​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

Data Send​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

With Debug Mode

DL Data Receive​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

With Debug Mode

Sleep​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

With Debug Mode

Time​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

NW Status​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

Debug​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

Set Org ID​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

Set Band​

Defined Values​

Maximum Response Time​

Usage​

Without Debug Mode

Special URC​

Module Start

Defined Values

Maximum Response Time

Usage

Firmware Version

Defined Values

Maximum Response Time

Usage

Data Send

Defined Values

Maximum Response Time

Usage

DL Data Receive

Defined Values

Maximum Response Time

Usage

Sleep

Defined Values

Maximum Response Time

Usage

Time

Defined Values

Maximum Response Time

Usage

NW Status

Defined Values

Maximum Response Time

Usage

Debug

Defined Values

Maximum Response Time

Usage

Set Org ID

Defined Values

Maximum Response Time

Usage

Set Band

Defined Values

Maximum Response Time

Usage

Special URC