Renesas RYZ014 User manual

Application Note
R19AN0075EU0200 Rev.2.00 Page 1 of 67
Aug.29.22
RYZ014 Modules
Use Cases with AT Commands
Introduction
This document will provide RYZ014-based platform users with practical use cases of AT commands.
Target Device
RYZ014 modules.
Contents
1. Introduction..............................................................................................................................4
2. Network Connection ................................................................................................................4
2.1 Check that the SIM Card is Ready..........................................................................................................4
2.1.1 Feature Description...............................................................................................................................4
2.1.2 Use Cases.............................................................................................................................................4
2.1.3 Error Handling .......................................................................................................................................7
2.2 Configure the Operator Mode..................................................................................................................7
2.2.1 Feature Description...............................................................................................................................7
2.2.2 Use Cases.............................................................................................................................................8
2.2.3 Error Handling .....................................................................................................................................10
2.3 Connect to the Network and Check that Attach is Done.......................................................................10
2.3.1 Feature Description.............................................................................................................................10
2.3.2 Use Cases...........................................................................................................................................10
2.3.3 Error Handling .....................................................................................................................................12
3. How to Manage TLS Certificates............................................................................................14
3.1 Feature Description ...............................................................................................................................14
3.2 Use Cases with Certificates ..................................................................................................................14
3.2.1 Identify a Free Certificate Index Entry.................................................................................................14
3.2.2 Add Certificate at Index 19..................................................................................................................16
3.2.3 Read Certificate at Index 19................................................................................................................16
3.2.4 Remove Certificate at Index 19...........................................................................................................16
3.3 Use Cases with Private Keys.................................................................................................................16
3.3.1 Upload a Private Key at Index 1..........................................................................................................16
3.3.2 Read the Private Key at Index 1..........................................................................................................17
3.3.3 Remove the Private Key at Index 1.....................................................................................................17
3.4 Use Cases to Setup a Security Profile ..................................................................................................17
3.4.1 With a Private Key Stored in the Non-Volatile Memory (NVM)...........................................................17
3.5 Error Handling........................................................................................................................................18
4. Proprietary FOTA...................................................................................................................18

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 2 of 67
Aug.29.22
4.1 Feature Description...............................................................................................................................18
4.2 Use Cases .............................................................................................................................................19
4.2.1 Synchronous Upgrade using HTTPS Protocol....................................................................................19
4.2.2 Synchronous Upgrade using HTTPS Protocol with Certificates..........................................................20
4.2.3 Asynchronous Upgrade using HTTPS Protocol..................................................................................20
4.2.4 Cancel Asynchronous Upgrade with HTTPS Protocol ........................................................................21
4.2.5 Asynchronous Upgrade using FTP Protocol .......................................................................................21
4.2.6 Cancel Asynchronous Upgrade with FTP protocol..............................................................................22
4.2.7 Asynchronous Upgrade though FTP using a Specific Port.................................................................22
4.3 Error Handling .......................................................................................................................................23
5. Factory Reset........................................................................................................................23
5.1 Feature Description...............................................................................................................................23
5.2 Use Cases.............................................................................................................................................24
5.3 Error Handling .......................................................................................................................................24
6. Data over UART ....................................................................................................................24
6.1 How to Send Data with UDP.................................................................................................................25
6.1.1 Feature Description.............................................................................................................................25
6.1.2 Use Cases in Online Mode..................................................................................................................26
6.1.3 Use Cases in Command Mode ...........................................................................................................26
6.1.4 Accept Any Remote Option.................................................................................................................27
6.1.5 Error Handling .....................................................................................................................................28
6.2 How to Send Data with TCP..................................................................................................................28
6.2.1 Feature Description.............................................................................................................................28
6.2.2 Use Cases in Online Mode..................................................................................................................29
6.2.3 Use Cases in Command Mode with Text Data ...................................................................................30
6.2.4 Use Cases in Command Mode with Hex Data....................................................................................31
6.2.5 Error Handling .....................................................................................................................................31
6.3 How to Setup a Secure Socket Connection..........................................................................................32
6.3.1 Feature Description.............................................................................................................................32
6.3.2 Use Cases...........................................................................................................................................32
6.4 How to Send Data on HTTP Connection...............................................................................................33
6.4.1 Feature Description.............................................................................................................................33
6.4.2 Use Cases in Synchronous Mode with +SQNHTTP Commands .......................................................34
6.4.3 Use Case with +SQNFGET Command...............................................................................................35
6.4.4 Use Case with +SQNFPUT Command...............................................................................................36
6.4.5 Error Handling .....................................................................................................................................36
6.5 How to Use TFTP AT Commands.........................................................................................................37
6.5.1 Feature Description.............................................................................................................................37
6.5.2 Use Case.............................................................................................................................................37
6.6 How to Use FTP(S) AT Commands ......................................................................................................37

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 3 of 67
Aug.29.22
6.6.1 Feature Description.............................................................................................................................37
6.6.2 Use Cases...........................................................................................................................................37
6.7 How to Use MQTT(S) Commands ........................................................................................................38
6.7.1 Feature Description.............................................................................................................................38
6.7.2 MQTT Server.......................................................................................................................................39
6.7.3 Use Cases...........................................................................................................................................41
6.7.4 Error Handling .....................................................................................................................................45
7. SMS ......................................................................................................................................45
7.1 How to Send and Receive SMS in Text Mode......................................................................................47
7.1.1 Feature Description.............................................................................................................................47
7.1.2 Use Cases...........................................................................................................................................47
7.2 How to Send and Receive a SMS in PDU Mode ..................................................................................48
7.2.1 Feature Description.............................................................................................................................48
7.2.2 Use Cases...........................................................................................................................................48
7.3 How to Manage SMS Storage...............................................................................................................49
7.3.1 Feature Description.............................................................................................................................49
7.3.2 Use Cases...........................................................................................................................................49
7.3.3 Error Handling .....................................................................................................................................51
8. Low Power with eDRX and PSM............................................................................................51
8.1 How to Use eDRX Feature....................................................................................................................51
8.1.1 Feature Description.............................................................................................................................51
8.1.2 Use Cases...........................................................................................................................................53
8.2 How to Use PSM Feature......................................................................................................................54
8.2.1 Feature Description.............................................................................................................................54
8.2.2 Use Case.............................................................................................................................................55
8.3 eDRX and PSM Troubleshooting ..........................................................................................................56
8.4 Maximum Transmission Power Reduction............................................................................................56
9. Informal Network Scan ..........................................................................................................57
9.1 Feature Description...............................................................................................................................57
9.2 Use Cases.............................................................................................................................................57
9.2.1 AT+SQNINS Usage.............................................................................................................................57
9.2.2 AT+SQNMONI Usage.........................................................................................................................57
9.2.3 Error Handling .....................................................................................................................................58
10. Hardware Configuration.........................................................................................................58
10.1 UART Interfaces....................................................................................................................................58
10.2 How to Configure the RING Signal........................................................................................................58
10.2.1 Feature Description.............................................................................................................................58
10.2.2 Use Cases...........................................................................................................................................58
10.3 How to Configure Modem Alarms .........................................................................................................59

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 4 of 67
Aug.29.22
10.3.1 Feature Description.............................................................................................................................59
10.3.2 Use Cases...........................................................................................................................................59
11. Manufacturing........................................................................................................................61
11.1 How to Configure GPIOs Alternate Functions.......................................................................................61
11.1.1 Feature Description.............................................................................................................................61
11.1.2 Use Cases...........................................................................................................................................61
12. Appendix. Glossary and Abbreviations ..................................................................................65
Revision History............................................................................................................................67
1. Introduction
The host MCU can interact with the RYZ014 modem using:
•AT commands
This is the purpose of the current document.
•The PPP protocol
See the document PPP User Guide for more details on PPP connection setup with RYZ014 modules.
After power up, the modem sends the +SYSSTART URC when the UARTs are initialized and ready to receive
AT commands.
Note: Please refer to the System Integration Guide for more information on AT command types and AT
parser implementation.
2. Network Connection
By default, the modem starts in +CFUN=0 state with minimum functionality. It does not attach to the network
until the host MCU requires full functionality by setting the +CFUN state to 1.
This section helps you to connect your RYZ014-based device to the network, following these simple steps:
1. Confirm that the SIM card in your device works properly
2. Confirm that your device is correctly configured to interact with your operator’s network
3. Attach your device to the network
2.1 Check that the SIM Card is Ready
2.1.1 Feature Description
Any RYZ014 module supports two SIM slots (internal and external). If an internal SIM is soldered, the
AT+CSUS command switches from one slot to the other.
This section details how to check the SIM card state, as well as how to and lock or unlock the SIM card using
the PIN or PUK code.
2.1.2 Use Cases
2.1.2.1 Select the SIM Slot
Command
Response
Comment
Power up the module
+SYSSTART
Check the number of supported SIM slots. If the response is +CSUS: 1, skip the following steps because only one
SIM slot is available on the module.
AT+CSUS=?
+CSUS: 2
OK
The module has 2 SIM slots, it supports an external SIM (slot 0) and an internal
one (slot 1).
Check the SIM slot that is configured

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 5 of 67
Aug.29.22
Command
Response
Comment
AT+CSUS?
+CSUS: 1
OK
The internal SIM slot is configured
Change the SIM slot to external. First ensure that the modem is in the +CFUN=0 state, otherwise change it with
AT+CFUN=0
AT+CFUN?
+CFUN: 0
OK
AT+CSUS=0
OK
Select external SIM slot
AT+CSUS?
+CSUS: 0
OK
Verify that the change was implemented
AT+CFUN=4
OK
Set the modem to airplane mode so that the SIM is read
AT+CIMI?
208019706
849013
OK
Make sure that the IMSI corresponds to that of the SIM you want to use.
If CIMI is sent before the modem finishes reading the SIM card, it returns
ERROR.
AT^RESET
OK
Restart the modem
+SHUTDOWN
+SYSSTART
AT+CSUS?
+CSUS: 0
OK
The configuration is not changed at reboot
Notes: The number of SIM slots supported can be checked with AT+CSUS=?. This command can only be
used when the module is in CFUN=0 state. The SIM slot configuration survives reboots and software
upgrades.
2.1.2.2 Power on the SIM Slot
Select one function mode from Airplane or Full functionality. Airplane mode disables both transmit and
receive RF circuits.
Command
Response
Comment
AT+CFUN=4
OK
Enter Airplane mode
or
AT+CFUN=1
OK
Enter Full functionality mode
2.1.2.3 Check the SIM Card Status after Powering on the SIM Slot
Command
Response
Comment
Check the SIM status
AT+CPIN?
+CPIN: READY
OK
The SIM card is present and unlocked, ready to use.
Option: Check the SIM card state by enabling +SQNSIMSTURC
AT+SQNSIMST=1
OK
Enable SIM state URC
AT+CFUN=4
OK
Set the modem to airplanemode to read the SIM card
+SQNSIMST: 1
Start reading the SIM card
+SQNSIMST: 5
The SIM card is now ready to use
AT+SQNSIMST? +SQNSIMST: 1,5
OK
If the URC are not enabled, it is possible to check the SIM statewith
this command as well
2.1.2.4 Enable SIM Lock with PIN Code
Command
Response
Comment
AT+CLCK="SC"
,1,"0000"
OK
"SC": SIM (lock SIM/UICC card installed in the currently selected card
slot) (SIM/UICC asks for password during MT power-up and when this
lock command issued)
1: lock
"0000": PIN code

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 6 of 67
Aug.29.22
2.1.2.5 Disable SIM Lock with PIN Code
Command
Response
Comment
Unlock SIM with correct PIN code
AT+CPIN="000
0"
OK
"0000": PIN code
Disable SIM lock with correct PIN code.
AT+CLCK="SC"
,0,"0000" OK
"SC": SIM (lock SIM/UICC card installed in the currently selected card
slot) (SIM/UICC asks for password during MT power-up and when this
lock command issued)
0: unlock
"0000": PIN code
2.1.2.6 Enter PIN Code to Unlock SIM
Command
Response
Comment
Check current SIM card state
AT+CPIN?
CPIN: SIM PIN
OK
SIM PIN is required to unlock SIM card
Attempt to unlock the SIM with the "1234" PIN code
AT+CPIN="123
4"
ERROR
PIN code is not correct, SIM card is still locked
Attempt to unlock the SIM the with "0000" PIN code
AT+CPIN="000
0"
OK
PIN code is correct, SIM card unlocked
Check SIM card state
AT+CPIN?
+CPIN: READY
SIM card is present and unlocked, ready to use
2.1.2.7 Enter PUK Code to Unlock SIM
Command
Response
Comment
Check current SIM card state
AT+CPIN?
+CPIN: SIM PUK
OK
Require SIM PUK to unlock SIM card
Type PUK code to unlock with "12345678" PUK code
AT+CPIN="123
45678"
ERROR
The PUK code is not correct, the SIM card is still locked
Type PUK code to unlock with "00000000" PUK code
AT+CPIN="000
00000"
OK
The PUK code is correct, the SIM card is unlocked
Check SIM card state
AT+CPIN?
+CPIN: READY
OK
The SIM card is present and unlocked, ready to use

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 7 of 67
Aug.29.22
2.1.3 Error Handling
•The SIM card is read only when the modem is in CFUN=1 (fully functional) or CFUN=4 (airplane mode)
states. Trying to access the SIM card with AT commands in CFUN=0 state will result in ERROR.
•If the SIM card is not present or not detected, check that the SIM card is inserted properly to the SIM
slot, and check again.
Command
Response
Comment
Enable return final result code
AT+CMEE=2 OK
Enable
+CME ERROR: <err>
result code and use verbose
<err>
values
Check SIM card state
AT+CPIN?
+CME ERROR:
SIM not
inserted
SIM card is not present or not detected
The AT+CSUS command requires that the UE is in CFUN=0 state. If you get an error while using the
AT+CSUS command, first check how many SIM slots are supported by the module, and second confirm the
CFUN=0 state.
Command
Response
Comment
Check the number of supported SIM slots (case only 1 slot)
AT+CSUS=?
+CSUS: 1
OK
Only one SIM slot is supported (external)
Trying to switch to the internal SIM slot results in error
AT+CSUS=1
+CME ERROR:
ERROR
If the CFUN state is 1 or 4, the SIM slot cannot be switched
AT+CFUN?
+CFUN: 4
OK
AT+CSUS=1 +CME ERROR:
ERROR
Change CFUN state to 0
AT+CFUN=0
OK
Check the number of supported SIM slots (case 2 slots)
AT+CSUS=? +CSUS: 2
OK
External is #0, internal is #1.
Trying to switch to the internal SIM slot succeeds
AT+CSUS=1
OK
2.2 Configure the Operator Mode
2.2.1 Feature Description
RYZ014 modules support up to 17 LTE bands. Scanning all the bands takes several minutes. Specifically,
cell detection duration per candidate EARFCN is 30 ms/18 mJ (1.3 µAh). Scanning the full 17 bands will take
186 seconds and consume 115J (8.4 mAh).
To reduce the overall scan time, it is possible to configure the list of the bands that need to be scanned with
the AT+SQNBANDSEL command.
Several operator modes are preloaded by default in the module. The operator mode can be selected with the
AT+SQNCTM command.
The operator mode enables the support of specific requirements requested by the various carriers, such as:
•Supported RF bands to scan
•Predefined scanning profile

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 8 of 67
Aug.29.22
•Roaming availability
Note: When roaming is disabled, CEREG: 5 does not work. Only CEREG: 1 is supported.
•Feature group in UE capability
•PDN configuration
•LwM2M support
AT+SQNBANDSEL? command returns the list of the predefined operator modes and their respective scan
configuration.
By default, the software is configured with standard operator mode.
A UE scan begins with the EARFCN to which it was attached previously. It proceeds with all the configured
bands, without any precedence.
Note: See the System Integration Guide for more information on the operator modes and the scanning
algorithm
2.2.2 Use Cases
2.2.2.1 Check the Currently Configured Operator Mode
Command
Response
Comment
By default the UE will be configured in the “standard” operator mode.
AT+SQNCTM?
+SQNCTM: standard
OK
2.2.2.2 Limit the Number of Bands
Command
Response
Comment
Limit the number of bands to be scanned while in "standard" mode.
Check that you are using the standard mode
AT+SQNCTM?
+SQNCTM: standard
OK
If not in standard mode, change it with:
AT+SQNCTM="sta
ndard"
OK
+SHUTDOWN
+SYSSTART
The modem restarts
AT+SQNCTM?
+SQNCTM: standard
OK
After reset, the CTM mode is correctly set
Check the bands that are configured for each operator modes.
AT+SQNBANDSEL?
+SQNBANDSEL:
0,3gpp-conformance,""
+SQNBANDSEL: 0,att,"2,4,12"
+SQNBANDSEL:
0,docomo,"1,19"
+SQNBANDSEL: 0,dtag,"3,8,20"
+SQNBANDSEL: 0,kddi,"18,26"
+SQNBANDSEL:
0,orange,"20,3"
+SQNBANDSEL:
0,softbank,"1,8"
+SQNBANDSEL:
0,soracom,"2,4,12"
+SQNBANDSEL:
0,sprint,"2,4,5,12,25"
+SQNBANDSEL:
0,standard,"1,2,3,4,5,8,12,13,17
,18,19,20,25,26,28,66"
17 bands are configured for the standard
operator mode.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 9 of 67
Aug.29.22
Command
Response
Comment
+SQNBANDSEL:
0,telstra,"3,28"
+SQNBANDSEL:
0,telus,"12,4,5"
+SQNBANDSEL:
0,truphone,"1,2,4,8,12,20"
+SQNBANDSEL: 0,verizon-no-
roaming,"4,13"
+SQNBANDSEL:
0,verizon,"13,4,5,12,17,20"
+SQNBANDSEL:
0,vodafone,"20,8" (...)
OK
Reduce the number of bands to be scanned
AT+SQNBANDSEL=
0,"standard","
3,8,20"
+SQNBANDSEL:
0,standard,"3,8,20"
OK
Scan is limited to bands 3, 8 and 20.
No band has precedence over another, so enter the band in any order. More bands to scan means a longer time to
attach to the network. Please keep in mind that it takes around 30 ms to scan one
EARFCN
.
2.2.2.3 Select a Specific Operator Mode
Command
Response
Comment
Select a specific operator mode.
If you are using a MNO SIM card, you need operator specific features to be enabled.
AT+SQNCTM=? +SQNCTM: ("3gpp-conformance",
"ais", "aptg", "att", "bell",
"cht",
"cta", "dialog", "dish", "docomo",
"dtag", "etisalat", "kddi", "kpn",
"kt", "lgu", "orange", "ptcrb",
"singtel", "skt", "softbank",
"soracom", "spark", "sprint",
"standard", "swisscom", "telenor",
"telstra", "telus", "tim",
"truphone",
"turkcell", "verizon", "vodafone")
OK
Check the list of supported operator
modes
In this example, select “verizon” operator mode.
AT+SQNCTM="ver
izon"
OK
+SHUTDOWN
+SYSSTART
The modem restarts.
AT+SQNCTM=? +SQNCTM: verizon
OK
Read the operator mode.
For Advanced user only:
You can also use +SQNBANDSEL command to reduce the number of bands scanned in a specific
operator mode. It is only possible to decrease the number of bands to be scanned and not increase
it. If you add a new band, the AT command accepts it but it is ignored during scanning
. It is highly
recommended to use the
+SQNBANDSEL
command with the standard operator mode only.
AT+SQNBANDSEL
=0,"verizon","20" +SQNBANDSEL
: 0, verizon,"20"
OK
Scanning is now limited to LTE Band 20. It
was previously LTE Band 13, 4, 5, 12, 17
and 20.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 10 of 67
Aug.29.22
2.2.3 Error Handling
The AT +SQNBANDSEL command only limits the number of bands to be scanned compared to the default
configuration. You cannot add a new band to scan with this command. If you enter the AT
+SQNBANDSEL
command with a band that was not set for a specific operator mode , is ignored: the command will not return
any error, but the band will not be scanned.
2.3 Connect to the Network and Check that Attach is Done
2.3.1 Feature Description
This section describes how to attach to or detach from the network.
The related AT commands are:
•AT+CEREG
•AT+CFUN
•AT+CGACT
•AT+CGATT
•AT+CGCDCONT
•AT+COPS
•URC +CEREG
2.3.2 Use Cases
2.3.2.1 Attach to the Network
Command
Response
Comment
Insert a SIM card and power-on the UE
AT+CFUN=1
OK
UE should attach to network automatically. Note that
CFUN = 1 is an asynchronous command. It will return
OK immediately. The OK response does not mean that
the modem is attached to the network.
+CEREG:2
By default,
<n>
parameter if
+CEREG
URC is set to 2
to enable network registration and URC.
+CEREG:1,”0002”,”01A2
2002”,7
2.3.2.2 Check the Network’s Registration Status
Command
Response
Comment
Query network
registration status
AT+CEREG?
+CEREG: 2,1
OK
2: Network registration and location information URC
enabled
1: Registered, home network
2.3.2.3 Check the PDP Context Configuration
Command
Response
Comment
Get current PDP context configuration
AT+CGDCONT?
+CGDCONT: 1,"IPV4V6","broadband",,,,0,0,0,0,0,0,0,,0
+CGDCONT: 2,"IPV4V6","lwaactivate",,,,0,0,0,0,0,0,0,,0
+CGDCONT: 3,"IPV4V6","custom",,,,0,0,0,0,0,0,0,,0
+CGDCONT: 4,"IPV4V6","attm2mglobal",,,,0,0,0,0,0,0,0,,0 OK
Get current PDP context activation state
AT+CGACT?

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 11 of 67
Aug.29.22
Command
Response
Comment
+CGACT: 1,1
+CGACT: 2,0
+CGACT: 3,0
+CGACT: 4,0
OK
PDP context with cid 1 is activated
2.3.2.4 Activate the PDP Context
Command
Response
Comment
AT+CGACT=1,3
OK
1: activate PDP context 3: cid 3
Query PDP context activation state
AT+CGACT?
+CGACT: 1,1
+CGACT: 2,0
+CGACT: 3,1
+CGACT: 4,0
OK
PDP context with cid 3 is activated in addition of
PDP context with cid 1.
2.3.2.5 Check IP Address
Command
Response
Comment
List IP address of all cids
AT+CGPADDR +CGPADDR:
1,"192.168.6.3","32.1.4.104.48
.6.0.3.3
2.1.4.104.48.6.0.3"
+CGPADDR: 2
+CGPADDR: 3,"192.168.11.2"
+CGPADDR: 4
OK
cid 1, IPv4 and IPv6 address
cid 2, not activated, no IP address
cid 3, IPv4 address only
Query IP address of cid=1
AT+CGPADDR=1 +CGPADDR:
1,"192.168.6.3","32.1.4.104.48.6
.0.3.3
2.1.4.104.48.6.0.3"
OK
cid 1, IPv4 and IPv6 address
2.3.2.6 Detach from the Network
Command
Response
Comment
AT+CFUN=0
OK
Power-off UE
Note that AT+CFUN=0 is a synchronous
command. The OK response is sent when the
modem is detached from the network.
+CEREG:0
If enabled, the CEREG:0 URC will immediately
follow the
OK response from AT+CFUN=0 command

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 12 of 67
Aug.29.22
2.3.2.7 Force an Attachment to a Specific Operator (AT+COPS)
Command
Response
Comment
AT+COPS is available only when the modem is set to full functionality (CFUN: 1 state)
AT+CFUN=1 OK
+CEREG: 2
Deregister from the network
AT+CGATT=0 OK
+CEREG: 0
AT+COPS=1,2,"
310410",7
OK
Force the modem to attach onAT&T network
+CEREG: 2
+CEREG: 5,"0936","0C702F0F",7
2.3.3 Error Handling
2.3.3.1 If AT+CEREG? returns status 0
If AT+CEREG? returns status 0, the UE is not registered, and is not currently searching an operator to register
to.
Command
Response
Comment
AT+CEREG?
Query network registration status
+CEREG: 2,0
OK
Possible causes:
SIM card error: SIM card not detected, PIN code not entered, SIM card read error.
The registration is not started (+COPS=2): execute the actions below.
AT+CFUN?
Check if current CFUN state is 1
+CFUN: 1
OK
AT+CGATT=1
OK
Force EPS attach
2.3.3.2 If CEREG? returns status 2
If CEREG? returns status 2, the modem not registered, but it is currently trying to attach or is searching an
operator to register to.
Command
Response
Comment
AT+CEREG?
Query network registration status
+CEREG: 2,2
OK
Possible causes:
No network available
Available networks have insufficient Rx level
HPLMN or allowed PLMN are available but the registration is rejected, for example, roaming is not allowed in this
Location Area
Wait for the module to retrieve a coverage (no action required)
+CEREG:1
Verify reception signal strength. In the response below <rssi> is the signal strength of the antenna, and <ber> is the
bit error rate in percent. Please refer to AT Commands User’s Manual for details on values and levels.
AT+CSQ
+CSQ: <rssi>,<ber>
If the signal strength is low, change to a different
position and try again.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 13 of 67
Aug.29.22
2.3.3.3 If AT+CEREG? returns status 3
If AT+CEREG? returns status 3, the registration is denied.
Command
Response
Comment
AT+CEREG?
Query network registration status
+CEREG: 2,3
OK
Possible causes:
•Illegal mobile equipment
•IMSI unknown at HLR (Home Location Register)
•
PLMN not allowed
Actions:
1. Check if right SIM card and right device is used
2. Check if right PLMN is selected with the command below
AT+COPS?
Check the operator mode
+COPS: 0,0,"Amarisoft
Network",7
OK
0: automatic operator select mode
0: long format alphanumeric
<oper>
"Amarisoft Network": <oper> name
7
: E-UTRAN
2.3.3.4 If AT+CEREG? returns status 4
If AT+CEREG? returns status 4, an unknown error occurred (for example: out of E-UTRAN coverage).
Command
Response
Comment
AT+CEREG?
Query network registration status
+CEREG: 2,4
OK
Check current signal strength
AT+CSQ
+CSQ: 18,99 or not
detectable
OK
18: RSSI -77dBm
99: channel ber, not known
If the signal strength is low, change to a different
position and try again.
If AT+CEREG? returns status 80, a PLMN loss indication is received from RRC. Most frequently, this means
that the modem got rejected from the network.
Command
Response
Comment
AT+CEREG?
Query network registration status
+CEREG: 2,80
OK
Check your SIM card validity
2.3.3.5 APN Configuration
In LTE-M, APN auto configuration is sufficient in most cases. There is no need for the user to set a specific
APN. In case a specific APN needs to be set, the following command can be applied. These APN settings
are persistent at reboot.
On AT&T specifically, if the APN is different from the one mentioned in the above examples, the SMS
services will not be functional.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 14 of 67
Aug.29.22
Command
Response
Comment
AT+CGDCONT=1,"IPV4V6
","m2m.
com.attz",,,,0,0,0,0
,0,0,0,,0
OK
Apply m2m.com.attz APN
AT+CGDCONT?
+CGDCONT:
1,"IPV4V6","m2m.com.a
ttz",,,,0,0,0,
0,0,0,0,,0
OK
Check the new APN settings
3. How to Manage TLS Certificates
3.1 Feature Description
For the best security, we strongly advise that you configure mutual authentication TLS connections . For
secured socket connection, it is necessary to write the certificate or the private key beforehand in the non-volatile
memory.
AT+SQNSNVW is used to write or delete data in the non-volatile memory using “certificate” or
“privatekey” parameters with the specific index in the file system. The file size corresponds to the exact
number of bytes to be uploaded.
After an AT+SQNSNVW write command is issued, the user sends certificate bytes in PEM (Privacy- enhanced
Electronic Mail) format. To delete a certificate or a private key, the user simply writes a ‘0’-byte certificate or
private key using file ID as <index>. A RYZ014 module holds 20 slots to store certificates and 20 slots for
private keys. These files are stored on the file system of the module.
The size of a certificate cannot exceed 8 kB and the size of a private key must be less than 2 kB.
Additionally, the total allocatable user non-volatile memory is 200 kB, and the AT+SQNSNVW returns ERROR
when no memory space is left.
CA certificates chain is supported: it is possible to combine several root CA certificates into one. The module
is preloaded with default certificates needed to connect to some operator specific LwM2M servers. To avoid
erasing preloaded certificates, it is highly recommended to use slots 8 to 19 only.
3.2 Use Cases with Certificates
To get the file size, use Linux command ls -l filename, or DOS command dir, or open the file with
Notepad++ to check its length.
With Notepad++, make sure to select the Unix (LF) encoding to get the right size of the certificate:
3.2.1 Identify a Free Certificate Index Entry
Command
Response
Comment
RYZ014 modules come with some pre-provisioned certificates.
AT+SQNSNVR="certificate"
+SQNSNVR: "certificate",1,"/C=US/O=VeriSign, Inc./OU=VeriSign Trust Network/OU=(c)
2006 VeriSign, Inc. - For authorized use only/CN=VeriSign Class 3 Public Primary
Certification Authority -
G5","000000000000000000000000000000000000000000000000","/C=US/O=VeriSign,
Inc./OU=VeriSign Trust Network/OU=(c) 2006 VeriSign, Inc. - For authorized use
only/CN=VeriSign Class 3 Public Primary Certification Authority - G5","06/11/08

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 15 of 67
Aug.29.22
Command
Response
Comment
00:00:00","36/07/16
23:59:59","sha1RSA","000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000","sha1","52b1
d7e64e2e1a453322ced6aa1c993bcb11f187"
+SQNSNVR: "certificate",2,"/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert
Global Root CA","0000000000000000","/C=US/O=DigiCert
Inc/OU=www.digicert.com/CN=DigiCert Global Root CA","06/11/10 00:00:00","31/11/10
00:00:00","sha1RSA","000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000","sha1","9aacd9b54b2f972ef2e1bd488eb550afcc462d46"
+SQNSNVR: "certificate",3,"/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert
Global Root CA","0000000000000000","/C=US/O=DigiCert
Inc/OU=www.digicert.com/CN=DigiCert Global Root CA","06/11/10 00:00:00","31/11/10
00:00:00","sha1RSA","000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000","sha1","4418290c0af661843b28c70f4eb728f4cc462960"
+SQNSNVR: "certificate",4,"/CN=root/OU=Service Platform Development
department/O=SoftBank Corp./L=Minato-
ku/C=JP","000000000000000000000000000000000000000000000000000000000000000000000000
000000000000000000000000000000000000000000","/CN=root/OU=Service Platform
Development department/O=SoftBank Corp./L=Minato-ku/C=JP","18/02/26
01:33:37","19/02/26
01:33:37","sha256ECDSA","0000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000000000","sha1","38db2b4bde4278b9f460cd175ec4c04f88f
bc
9b8"
OK
Indexes 1 to 4 are already used. If you wish to keep them and add a new certificate, choose any other
index between 10 and 19.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 16 of 67
Aug.29.22
3.2.2 Add Certificate at Index 19
Command
Response
Comment
Upload a certificate type file with size 1078 bytes into the file system.
AT+SQNSNVW="certificate",0,1078
>
After prompt '>', enter the data from certificate file and type enter in the end.
-----BEGIN CERTIFICATE-----
MIIC8DCCAlmgAwIBAgIJAOD63PlXjJi8MA0GCSqGSIb3DQEBBQUAMIGQMQswCQYD
VA+GIbdYKO3JprPxSBoRponZJvDGEZuM3N7p3S/lRoi7G5wG5mvUmaE5RAgMBAAGj (
)REyPOFdGdhBY2P1FNRy0MDr6xr+D2ZOwxs63dG1nnAnWZg7qwoLgpZ4fE
SPD3PkA 1ZgKJc2zbSQ9fCPxt2W3mdVav66c6fsb7els2W2Iz7gERJSX END
CERTIFICATE-----
OK
3.2.3 Read Certificate at Index 19
Command
Response
Comment
AT+SQNSNVR="certificat e",
19
Read certificate at index 19
+SQNSNVR: "certificate",0,"/C=GB/ST=United
Kingdom/L=Derby/O=Mosquitto/OU=CA/CN=mosquitto.org/emai
lAddr
ess=[e-mail]","00000000000000000000000000000000000
00
000000
000000000000000000000000000000000000000000(...)00000000
00000
000000000000000000000000000000000000000000","/C=GB/ST=U
nited
Kingdom/L=Derby/O=Mosquitto/OU=CA/CN=mosquitto.org/emailAd
dr
[email protected]","12/06/29 22:11:59","22/06/27
22:11:59","sha1RSA","00000000000000000000","sha1","1d21
4e931ab1
da59c 1e08f025f268d2783a51f0a"
OK
3.2.4 Remove Certificate at Index 19
Command
Response
Comment
AT+SQNSNVW="certificate",19,
0
OK
Remove certificate at index 19
3.3 Use Cases with Private Keys
3.3.1 Upload a Private Key at Index 1
Command
Response
Comment
Upload a private key type file with size 1679 bytes into file system at index 1.
AT+SQNSNVW="privatekey",1,167
9
>
After prompt '>', enter the data from certificate file and press Enter at the end.
-----BEGIN RSA PRIVATE KEY-----
MIIEpQIBAAKCAQEA0DeexyAY2TP1LeRL/MR7nVXzq+eQysfvZCzZVy39KXPtSaGL 5gHjlGS2ufB9ZB3KgOxS
MlF+W7oqB6xa5FLMD4YQfgQiUux6kmuQZ4r3yvCUlOxD (…)

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 17 of 67
Aug.29.22
Command
Response
Comment
h46R1gIvDPGBeS0r7Ex4ILu
WCYDIWrQ740KaxODp8+z10GfqFzKMq7eVFBl6gBtzU1JMs7L12qnx7U+rJqf0zL7
/yoN9g25RqCbUczK1h9gkwky1TVKnZDK2+gE
JJjNhnbp8T4zgPiS8X/V0YypVeTnu2Yl7oXFDeHeci77DKXcGz5eWMo
= -----END RSA PRIVATE KEY-----
OK
3.3.2 Read the Private Key at Index 1
Command
Response
Comment
AT+SQNSNVR="privatekey",1
Read the private key at index 1
+SQNSNVR: 1,"-----BEGIN RSA PRIVATE KEY-----
MIIEpQIB
(...) Gz5eWMo=
"-----END RSA PRIVATE KEY----“"
OK
3.3.3 Remove the Private Key at Index 1
Command
Response
Comment
AT+SQNSNVW="privatekey",1,0
OK
Remove
the private key at
index 1
3.4 Use Cases to Setup a Security Profile
3.4.1 With a Private Key Stored in the Non-Volatile Memory (NVM)
Command
Response
Comment
Upload a certificate type file with size 1078 bytes into the file system.
AT+SQNSNVW="certificate",19,1078
>
After prompt '>', enter the data from certificate file and type enter in the end.
-----
BEGIN CERTIFICATE-----
MIIC8DCCAlmgAwIBAgIJAOD63PlXjJi8MA0GCSqGSIb3DQEBBQUAMIGQMQswCQYD
VA+GIbdYKO3JprPxSBoRponZJvDGEZuM3N7p3S/lRoi7G5wG5mvUmaE5RAgMBAAGj
(
… )
REyPOFdGdhBY2P1FNRy0MDr6xr+D2ZOwxs63dG1nnAnWZg7qwoLgpZ4fESPD3PkA
1ZgKJc2zbSQ9fCPxt2W3mdVav66c6fsb7els2W2Iz7gERJSX
-----END CERTIFICATE-----
OK
Upload Server Certificate Authority on the modem
AT+SQNSNVW="certificate",18,683
>
After prompt '>', enter the data from certificate file and press Enter at the end.
-----
BEGIN CERTIFICATE-----
MIIBzDCCAXECFGw5Gx1S52QxSP44Sx4pQ0ptMOKDMAoGCCqGSM49BAMCMIGLMQsw
(…) xJ3LStv06Yd0EiB2cu8csxr4Z6TtApSJdCQpN+gusUQ=
-----END CERTIFICATE-----
OK
Upload a 1679 byte private key type file to the file system.
AT+SQNSNVW="privatekey",0,1679
>
After prompt '>', enter the data from certificate file and press Enter at the end.

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 18 of 67
Aug.29.22
Command
Response
Comment
-----BEGIN RSA PRIVATE KEY-----
MIIEpQIBAAKCAQEA0DeexyAY2TP1LeRL/MR7nVXzq+eQysfvZCzZVy39KXPtSaGL
5gHjlGS2ufB9ZB3KgOxSMlF+W7oqB6xa5FLMD4YQfgQiUux6kmuQZ4r3yvCUlOxD
(
…)
h46R1gIvDPGBeS0r7Ex4Ilu
WCYDIWrQ740KaxODp8+z10GfqFzKMq7eVFBl6gBtzU1JMs7L12qnx7U+rJqf0zL7
/
yoN9g25RqCbUczK1h9gkwky1TVKnZDK2+gE
JJjNhnbp8T4zgPiS8X/
V0YypVeTnu2Yl7oXFDeHeci77DKXcGz5eWMo=
---END RSA PRIVATE KEY-----
OK
Setup the security profile with both certificate and private key
Note
that there is no requirement for the certificate sequence; the module will send everything at the
certificate/privatekey index mentioned in the secure profile to the server as is.
AT+SQNSPCFG=1,3,"",1,0,0,""
+SQNSPCFG:
1,3,"",1,0,0,"",""
OK
By default, the last parameter
<storageId>
is set to 0 to
indicate
that the private key is
stored in the NVM.
3.5 Error Handling
AT+SQNSNVW can return +CME ERROR: operation not supported when the certificate is not correctly
formatted and that the length specified in the command does not match the content of the
certificate including
<CR> , <LF> , 'space' and so on.
You can use AT+SQNSNVR="certificate" and AT+SQNSNVR="privatekey" to dump all the available
certificates and private keys stored in the system. If you use CA certificate chains and try to read back the
slot index with AT+SQNSNVR, it only outputs the first certificate in the chain.
When using AT+SQNSNVW, if you get ERROR (CME_ERROR 4), please make sure first that the certificate is
valid. If the certificate is confirmed valid, please check if you used the proper terminator for AT command.
Only one char is allowed. The AT command syntax is described in the 3GPP 27.007
(§4.1 and §4.2) and
ITU V250 (§5.2.1). The termination character is
<CR> by default. For example, using <CR><LF> (“\r\n”)
as terminator would have no impact for most of AT commands since the "\n" would be treated as invalid AT
command. But for AT commands which need input data,
the second char <LF> (" \n ") would remain in the
buffer and be treated as input data. When
sending data in text mode, the module will not return ERROR, but the
server would receive data starting with "\n”, and this may trigger problems. When sending data in HEX
mode, ERROR is sent immediately as "\n" is an invalid HEX char. The terminator char can be changed by an
ATS3 command. Please refer to AT Commands Reference Manual for more details. When developing an
application on the host MCU based on AT commands, if no specific requirements are set, please use
<CR>
(" \r ") as the terminator character.
4. Proprietary FOTA
This section describes FOTA as proprietary feature using the AT+SQNSUPGRADE command. It does not apply
to FOTA through LwM2M.
4.1 Feature Description
The AT +SQNSUPGRADE command is used to trigger a device upgrade. The firmware is located either on an
external FTP or HTTP/HTTPS server or on the file system of the device, if it was previously downloaded from
any external server. The customer is responsible for hosting the firmware files on its own server. The FOTA
process is a device-initiated firmware update triggered by the host system. The modem downloads the
firmware file from the specified server if needed and automatically applies the update.
The firmware type must be a full DUP (a .dup file with the full software upgrade) or diff DUP (a .dup file
including a differential upgrade). The differential FOTA allows the customer to upgrade the firmware or
downgrade the firmware over-the-air to a new/old version. Before upgrading the firmware, the customer

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 19 of 67
Aug.29.22
needs to prepare the firmware package containing only the differences between the old and new firmware
version. This reduces the amount of data transmission and accelerates the firmware upgrade.
Note: A device reboot is required to finalize the system upgrade. This can be triggered through the
<reboot>
parameter of AT+SQNSUPGRADE command, or any other kind of reboot ( AT^RESET ,
AT+SQNSSHDN or a hardware reset).
The FW upgrade can be launched in foreground (synchronous upgrade) or background
(asynchronous
upgrade) as specified by a
<command > parameter. The user can cancel upgrade by sending cancel <command>
value '2' any time before the device's reboot when using the bac
kground upgrade.
Customers need to operate the following steps to upgrade the firmware:
•Get the firmware packages or differential firmware packages from the release
•Upload the differential firmware packages on an external FTP or HTTP/HTTP server.
•
Execute the AT+SQNSUPGRADE command to upgrade. T he module will upgrade automatically.
When the image is not already on the device file system, the FOTA process requires the modem to be
registered on the network and needs to have a correctly configured PDP context. The network must allow
internet access to the server hosting the files.
Once the modem's network connection has been verified, the modem can start downloading the firmware file
as shown in the use cases below.
4.2 Use Cases
The test is to be run with an external server.
Note: <firmware_url> protocol can be HTTP, HTTPS or FTP (compliant with RFC1738).
4.2.1 Synchronous Upgrade using HTTPS Protocol
Command
Response
Comment
Launch the device upgrade.
AT+SQNSUPGRADE="https://s3-us-west-
2.amazonaws.com/FileShare/ 41613-ue.dup",1,10,0
The device will reboot automatically after the
firmware is installed, and report progress every
10%, in synchronous upgrade.
OK
+SQNSUPGRADE: “available”
UE can access URL
+SQNSUPGRADE: “downloading”,0
Start download
+SQNSUPGRADE: “downloading”,10
+SQNSUPGRADE: “downloading”,20
+SQNSUPGRADE: “downloading”,30
+SQNSUPGRADE: “downloading”,40
+SQNSUPGRADE: “downloading”,50
+SQNSUPGRADE: “downloading”,60
+SQNSUPGRADE: “downloading”,70
+SQNSUPGRADE: “downloading”,80
+SQNSUPGRADE: “downloading”,90
Progress notifications
+SQNSUPGRADE: “downloading”,100
OK
FW is downloaded to the to UE file system
+SQNSUPGRADE: “rebooting”
Device is rebooting and going in updater mode to
finish the upgrade
Upgrade duration depends on the DUP type. After upgrade is finished, the device
reboots in FFF mode.
+SQNSUPGRADE: “installed”
Device is upgraded to the new FW
+SYSSTART
Device is ready for operation

RYZ014 Modules Use Cases with AT Commands
R19AN0075EU0200 Rev.2.00 Page 20 of 67
Aug.29.22
4.2.2 Synchronous Upgrade using HTTPS Protocol with Certificates
Command
Response
Comment
AT+SQNSPCFG=1,0,"0x002F;0
x003C;0x0035;0x003D",1,5
,,,"",
"",0
+SQNSPCFG:
1,0,"0x002F;0x003C;0x0035;0x
003D",1,5,,,"","",0
OK
Set the security profile to be used, pointing
to the right
certificate
AT+SQNSUPGRADE="https://ec23
-134-42-3.us-east-
2.compute.amaz
onaws.com/naa/bl_51630.dup",1,1, 0,1
The device will reboot
automatically after
the firmware
is installed, and report
progress
every 1%, in synchronous
upgrade.
+SQNSUPGRADE: "available"
UE can access the URL specified in the
command
+SQNSUPGRADE:
"downloading",1
Download
started
+SQNSUPGRADE:
"downloading",2 (…)
Progress
notification
+SQNSUPGRADE:
"downloading",100 OK
The new SW image is downloaded and
stored
in the
UE's file system
+SQNSUPGRADE: "rebooting"
The UE will reboot to install the new SW
image
+SQNSUPGRADE: "installed"
Device
is upgraded to the new
SW image
+SYSSTART
Device is ready for operation
4.2.3 Asynchronous Upgrade using HTTPS Protocol
Set the URL of the firmware, reboot automatically after the firmware is installed, report progress every 10%
in asynchronous upgrade.
Command
Response
Comment
AT+SQNSUPGRADE="https://s3-us-west-
2.amazonaws.com/FileShare/ 41613-ue.dup",1,10,1 Reboot automatically after the firmware is installed, report
progress every 10%, in
asynchronous upgrade.
OK
+SQNSUPGRADE: “available”
+SQNSUPGRADE: “downloading”,0
Background upgrade, AT interface is still allowed to issue AT command, read command to check the current state
of upgrade process
AT+SQNSUPGRADE?
+SQNSUPGRADE: “downloading”,5
OK
+SQNSUPGRADE:
“downloading”,10
+SQNSUPGRADE:
“downloading”,20
+SQNSUPGRADE:
“downloading”,30
Progress notifications