Renesas RYZ014 Application Note

Renesas RYZ014 Application Note

Use cases with at commands
Hide thumbs Also See for RYZ014:
Table of Contents

Advertisement

Quick Links

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.
General Introduction ........................................................................................................... 5
2.
Network Connection............................................................................................................ 5
2.1
Check that the SIM Card is Ready...................................................................................................... 5
2.1.1
Feature Description .......................................................................................................................... 5
2.1.2
Use Cases ....................................................................................................................................... 6
2.1.3
Error Handling .................................................................................................................................. 9
2.2
Configure the Operator Mode ............................................................................................................. 9
2.2.1
Feature Description .......................................................................................................................... 9
2.2.2
Use Cases ..................................................................................................................................... 10
2.2.3
Error Handling ................................................................................................................................ 12
2.3
Connect to the Network and Check that Attach is Done .................................................................... 12
2.3.1
Feature Description ........................................................................................................................ 12
2.3.2
Use Cases ..................................................................................................................................... 13
2.3.3
Error Handling ................................................................................................................................ 15
3.
How to Manage TLS Certificates ........................................................................................18
3.1
Feature Description .......................................................................................................................... 18
3.1.
Use Cases with Certificates.............................................................................................................. 18
3.1.1
Identify a Free Certificate Index Entry ............................................................................................. 18
3.1.2
Add Certificate at Index 0 ............................................................................................................... 20
3.1.3
Read Certificate at Index 0 ............................................................................................................. 20
3.1.4
Remove Certificate at Index 0......................................................................................................... 20
3.2
Use Cases with Private Keys ............................................................................................................ 20
3.2.1
Upload a Private Key-at Index 1. .................................................................................................... 20
3.2.2
Read the Private Key at Index 1 ..................................................................................................... 21
3.2.3
Remove the Private Key at Index 1 ................................................................................................. 21
3.3
Use Cases to Setup a Security Profile .............................................................................................. 21
3.4
Error Handling .................................................................................................................................. 22
4.
Proprietary FOTA...............................................................................................................22
4.1
Feature Description .......................................................................................................................... 22
R19AN0075EU0150 Rev.1.50
Mar.15.22
Application Note
Page 1 of 76

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RYZ014 and is the answer not in the manual?

Questions and answers

Summary of Contents for Renesas RYZ014

  • Page 1: Table Of Contents

    Application Note 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 General Introduction ......................5 Network Connection......................5 Check that the SIM Card is Ready...................... 5 2.1.1...
  • Page 2 RYZ014 Modules Use Cases with AT Commands Use Cases ............................23 4.2.1 Synchronous Upgrade using HTTPS Protocol................. 23 4.2.2 Synchronous Upgrade using HTTPS Protocol with Certificates ............24 4.2.3 Synchronous Upgrade using HTTPS Protocol and Credentials ............24 4.2.4 Asynchronous Upgrade using HTTPS Protocol ................25 4.2.5...
  • Page 3 RYZ014 Modules Use Cases with AT Commands 5.6.3 Use Cases ............................. 44 How to Use FTP AT Commands ...................... 44 5.7.1 Feature Description ........................44 5.7.2 Use Cases ............................. 45 How to Use MQTT(S) Commands ....................45 5.8.1 Feature Description ........................45 5.8.2...
  • Page 4 RYZ014 Modules Use Cases with AT Commands 10.1 UART Interfaces ..........................70 10.2 How to Configure the RING Signal ....................70 10.2.1 Feature Description ........................70 10.2.2 Use Cases ............................. 71 10.3 How to Configure Modem Alarms ..................... 71 10.3.1 Feature Description ........................71 10.3.2 Use Cases .............................
  • Page 5: General Introduction

    2.1.1 Feature Description Depending on the RYZ014 module used, the modem can support one or two SIM slots (external only or internal and external). If an internal SIM is soldered in,, the AT+CSUS command should be used to switch from one slot to another.
  • Page 6: Use Cases

    RYZ014 Modules Use Cases with AT Commands 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 response is +CSUS: 1,skip the following steps because only one SIM slot is available on the module.
  • Page 7 RYZ014 Modules Use Cases with AT Commands 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 SIM card is present and unlocked, ready to use Option: Check the SIM card state by enabling +SQNSIMST URC...
  • Page 8 RYZ014 Modules Use Cases with AT Commands 2.1.2.6 Enter PIN Code to Unlock SIM Command Response Comment Check current SIM card state AT+CPIN? SIM PIN is required to unlock SIM card CPIN: SIM PIN Type PIN code to unlock with "1234" PIN code AT+CPIN="1234"...
  • Page 9: Error Handling

    Configure the Operator Mode 2.2.1 Feature Description RYZ014 modules can support up to 17 LTE bands. Scanning all the bands takes several minutes. Specifically, cell detection duration per candidate EARFCN is 30ms/18mJ (1.3 µAh). Scanning the full 17 bands will take 186 seconds and consume 115J (8.4 mAh).
  • Page 10: Use Cases

    RYZ014 Modules Use Cases with AT Commands To reduce the scanning duration, it is possible to configure the list of the bands that need to be scanned with the AT+SQNBANDSEL command. Several operator modes are configured by default in the software, to be able to work even if the user does not know which bands should be configured.
  • Page 11 RYZ014 Modules Use Cases with AT Commands Command Response Comment +SQNBANDSEL: AT+SQNBANDSEL? 17 bands are configured for 0,3gpp-conformance,"" the standard operator mode. +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"...
  • Page 12: Error Handling

    RYZ014 Modules Use Cases with AT Commands 2.2.2.3 Select a Specific Operator Mode Command Response Comment Select a specific operator mode. If you don't know which bands to be scanned, you can select a specific operator mode by hand. AT+SQNCTM=? +SQNCTM: ("3gpp-...
  • Page 13: Use Cases

    RYZ014 Modules Use Cases with AT Commands The related AT commands are: • AT+CEREG • AT+CFUN • AT+CGACT • AT+CGATT • AT+CGCDCONT • 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 UE should attach to network automatically.
  • Page 14 RYZ014 Modules Use Cases with AT Commands 2.3.2.4 Activate the PDP Context Command Response Comment AT+CGACT=1,3 1: activate PDP context 3: cid 3 Query PDP context activation state AT+CGACT? +CGACT: 1,1 PDP context with cid 3 is activated in addition of PDP context with cid 1.
  • Page 15: Error Handling

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+CGATT=0 +CEREG: 0 AT+COPS=1,2,"310410",7 Force the modem to attach on AT&T network +CEREG: 2 +CEREG: 5,"0936","0C702F0F",7 2.3.3 Error Handling 2.3.3.1 If CEREG? returns status 0 If CEREG? returns status 0, the UE is not registered, and is not currently searching an operator to register...
  • Page 16 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+CEREG? Query network registration status +CEREG: 0,2 Possible causes: No network available Available networks have insufficient Rx level HPLMN or allowed PLMN are available but the registration is rejected, e.g. roaming is not allowed in this Location...
  • Page 17 RYZ014 Modules Use Cases with AT Commands 2.3.3.3 If CEREG? returns status 3 If CEREG? returns status 3, the registration is denied. Command Response Comment AT+CEREG? Query network registration status +CEREG: 0,3 Possible causes: • Illegal mobile equipment • IMSI unknown at HLR (Home Location Register) •...
  • Page 18: How To Manage Tls Certificates

    RYZ014 Modules Use Cases with AT Commands 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.
  • Page 19 RYZ014 Modules Use Cases with AT Commands Command Response Comment +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 00:00:00","36/07/16...
  • Page 20: Add Certificate At Index 0

    RYZ014 Modules Use Cases with AT Commands 3.1.2 Add Certificate at Index 0 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.
  • Page 21: Read The Private Key At Index 1

    RYZ014 Modules Use Cases with AT Commands Command Response Comment 3.2.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----- "...
  • Page 22: Error Handling

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSPCFG=1,3,"",1,0,0,"" +SQNSPCFG: Depending on the SW release, 1,3,"",1,0,0,"","" OK AT+SQNSPCFG does not allow setting all the cipher suites supported by the modem. In that case, the list of cipher suites should be left empty ("").
  • Page 23: Use Cases

    RYZ014 Modules Use Cases with AT Commands • Get the firmware packages or differential firmware packages from the release • Upload the firmware packages or differential firmware packages on an FTP or HTTP/HTTPS server. • Execute the AT+SQNSUPGRADE command to upgrade. Then the module will upgrade automatically.
  • Page 24: Synchronous Upgrade Using Https Protocol With Certificates

    RYZ014 Modules Use Cases with AT Commands 4.2.2 Synchronous Upgrade using HTTPS Protocol with Certificates Command Response Comment AT+SQNSPCFG=1,0,"0x002F;0 +SQNSPCFG: Set the security profile to be used, x003C;0x0035;0x003D",1,5,,,"", "",0 1,0,"0x002F;0x003C;0x0035;0x pointing to the right certificate 003D",1,5,,,"","",0 AT+SQNSUPGRADE="https://ec23-134-42-3.us-east- 2.compute.amaz The device will reboot automatically onaws.com/naa/bl_51630.dup",1,1, 0,1...
  • Page 25: Asynchronous Upgrade Using Https Protocol

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSUPGRADE="https://login:pwd@cloud.sequans.com/ The credentials are hidden here, you apps/sharingpath/team-iot-bb-support/Internal/image_diff- from8.0.0. 4- should use your own. If there is a "@" 52526-to-8.0.1.0-52573.dup",1,1,0 character in your login or pwd, please replace it by its Ascii encoding "%40".
  • Page 26: Cancel Asynchronous Upgrade With Https Protocol

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSUPGRADE="https://s3-us-west- 2.amazonaws.com/FileShare/ 41613- Reboot automatically after the ue.dup",1,10,1 firmware is installed, report progress every 10%, in asynchronous upgrade. +SQNSUPGRADE: “available” +SQNSUPGRADE: “downloading”,0 Background upgrade, AT interface is still allowed to issue AT command, read command to check the current state of...
  • Page 27: Asynchronous Upgrade Using Ftp Protocol

    RYZ014 Modules Use Cases with AT Commands 4.2.6 Asynchronous Upgrade using FTP Protocol Command Response Comment Launch the asynchronous update with FTP protocol. Login is ftpuser and password is ftppwd. AT+SQNSUPGRADE="ftp://ftpuse r: ftppwd@192.168.0.225/5410- 4715148548-ue.dup",1,10,1 +SQNSUPGRADE: "available" +SQNSUPGRADE: "downloading",0 +SQNSUPGRADE: "downloading",10 +SQNSUPGRADE: "downloading",20...
  • Page 28: Asynchronous Upgrade Though Ftp Using A Specific Port

    A maximum of six sessions can be established in parallel based on a socket. A socket is created by the RYZ014 module and not by the host MCU. UDP and TCP sockets can be opened with either in command or online modes: In command mode, the UART transmits AT commands and responses.
  • Page 29: How To Send Data With Udp

    RYZ014 Modules Use Cases with AT Commands • AT+SQNSSEND: the user enters the data to be sent after the prompt and concludes with CTRL+Z to confirm the data to send or ESC to cancel. • AT+SQNSSENDEXT: in that case, the host MCU defines the size of the payload to be sent and the modem escapes automatically once the defined number of bytes is reached.
  • Page 30: Use Cases In Online Mode

    RYZ014 Modules Use Cases with AT Commands Important: If +SQNSRING URC mode is set to 2 (data view mode), it is required to use AT+SQNSRECV to receive the data. Otherwise, the data buffer would remain full and all following data would be dropped.
  • Page 31: Accept Any Remote Option

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSSEND=1 Send data in command mode through socket connection id 1. > Hello extend from client Type Ctrl+Z to confirm and ESC to cancel. AT+SQNSSENDEXT=1,24 Configure how many bytes are to be sent.
  • Page 32: Error Handling

    RYZ014 Modules Use Cases with AT Commands 5.1.4.2 Send Data to Different Server within the Same Socket Command Response Comment Ensure that UE is attached to LTE network. You can then configure the socket. AT+SQNSCFG=1,1,300,0,0,50 Basic socket configuration AT+SQNSCFGEXT=1,2,0,0 Command...
  • Page 33: How To Send Data With Tcp

    RYZ014 Modules Use Cases with AT Commands How to Send Data with TCP 5.2.1 Feature Description The user can open TCP socket and send data either in online mode or command mode. Note: If +SQNSRING URC mode is set to 2 (data view mode), it is required to use AT+SQNSRECV to receive the data.
  • Page 34 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSD=1,0,8008,"192.168.13.1",0,8000,0 Type socket dial command. Parameter <commMode> is 0 for online mode. <TxProt>=0 for TCP. CONNECT Intermediate result code if the socket is opened successfully. Hello this is from client Type string, and press <enter>...
  • Page 35: Use Cases In Command Mode With Text Data

    RYZ014 Modules Use Cases with AT Commands 5.2.3 Use Cases in Command Mode with Text Data Command Response Comment Ensure that UE is attached to LTE network. You can then configure the socket. AT+SQNSCFG=1,1,0,0,600,50 The second parameter is <cid> for PDP context identifier.
  • Page 36: Error Handling

    RYZ014 Modules Use Cases with AT Commands Command Response Comment 7D000015116000050010 Send data in HEX mode. And should see message code on client side. AT+SQNSH=1 Shutdown the socket. 5.2.5 Error Handling When sending HEX data with AT+SQNSSEND or AT+SQNSSENDEXT, if you get ERROR (CME_ERROR 4), please make sure first that the data to send is valid.
  • Page 37 RYZ014 Modules Use Cases with AT Commands 5.3.2.1 Send a GET Request Command Response Comment Type this command to configure the HTTP connection without SSL enabled. AT+SQNHTTPCFG=1,"httpbin.org",80,0,"","",0,120,1 AT+SQNHTTPCFG? Read command of HTTP configuration +SQNHTTPCFG: 0,"",80,0,"","",0,120,3 +SQNHTTPCFG: 1,"httpbin.org",80,0,"","",0,120,1 +SQNHTTPCFG: 2,"",80,0,"","",0,120,3 AT+SQNHTTPQRY=1,0,"/"...
  • Page 38: Use Case With +Sqnfget Command

    RYZ014 Modules Use Cases with AT Commands You might want to define charset for text/plain, or boundary for multipart/form-data. In these cases, you need an extension as detailed below: • Set charset to us-ascii: Set <post_param> to “1:charset=us-ascii”, then the request will contain “Content-type: text/plain;...
  • Page 39: Use Case With +Sqnfput Command

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNFGET="http:/192.168.13.1/index.html" By default, it is synchronous downloading. In case the <local_filename> parameter is not specified; this AT command switches AT channel to data mode and outputs downloaded binary octet stream to the host.
  • Page 40: Error Handling

    RYZ014 Modules Use Cases with AT Commands 5.3.5 Error Handling +SQNHTTPSND is a synchronous command. The modem will not accept any other AT commands and send any URC while the command is being executed. This command depends on the network conditions. Under bad RF condition, the command will take some time to execute.
  • Page 41 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSNVW="privatekey",4,167 5 > > -----BEGIN RSA PRIVATE KEY----- MIIEowIBAAKCAQEA5Y9oi8GwKg3FOx8ZnqLtWaUN3IAKRVgWO7/bmzkNN6HYJTxvp3v+4jGPkkL KiA+b … mT4lEcd4I5X00w82tdpIxobIH9UUBJlrZ2YLQ+nBAEy0zLYY532ZQwJXAI0rzejOanzMvwd+pXzwwPt -----END RSA PRIVATE KEY----- Configure SSL/TLS security profile 1, TLS 1.1, cipher suites TLS_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA and TLS_RSA_WITH_AES_256_CBC_SHA256 (certificate validation level: 0 (no validated), certificate id: 3, 4 and 4): AT+SQNSPCFG=1,1,"0x2F;0x3C;0x...
  • Page 42: Use Cases With Private Keys

    RYZ014 Modules Use Cases with AT Commands 5.4.2.2 Read certificate at index 0 Command Response Comment AT+SQNSNVR="certificate",0 Read certificate at index 0 +SQNSNVR: "certificate",0,"/C=GB/ST=United Kingdom/L=Derby/O=Mosquitto/OU=CA/CN=mosquitto.org/emailAddr ess=roger@atchoo.org","0000000000000000000000000000000000000000000 000000000000000000000000000000000000000000(...)00000000000000000000 00000000000000000000000000000000000","/C=GB/ST=United Kingdom/L=Derby/O=Mosquitto/OU=CA/CN=mosquitto.org/emailAddr ess=roger@atchoo.org","12/06/29 22:11:59","22/06/27 22:11:59","sha1RSA","00000000000000000000","sha1","1d214e931ab1da59c 1e08f025f268d2783a51f0a" 5.4.2.3 Remove certificate at index 0 Command...
  • Page 43: Test With No Certificate In Filesystem

    RYZ014 Modules Use Cases with AT Commands Command Response Comment -----BEGIN CERTIFICATE----- MIIEtjCCA56gAwIBAgIQDHmpRLCMEZUgkmFf4msdgzANBgkqhkiG9w0BAQsFADBs MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 c63YlC3k 8wyd7sFOYn4XwHGeLN7x+RAoGTMCAwEAAaOCAUkwggFFMBIGA1UdEwEB/wQIMAYB Af8CAQAwDgYDVR0PAQH/BAQDAgGGMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEF BQcDAjA0BggrBgEFBQcBAQQoMCYwJoVWNWlZopCJwqjyBcdmdqEU79OX2olHdx3ti6G8MdOu42vi /hw15 UJGQmxg7kVkn 8TUoE6smftX3eg== -----END CERTIFICATE----- You would see OK if succeed to write the certificate into device filesystem If there is already a certificate with index 1, remove it from device filesystem as described in section 0 Configure SSL/TLS security profile 1 (certificate validation level: 7, certificate id: 1): AT+SQNSPCFG=1,2,"",7,1...
  • Page 44: How To Use Tftp At Commands

    RYZ014 Modules Use Cases with AT Commands Command Response Comment <<< Note that SQNHTTPRCV returns error when there is no body (only a header) ... OK in the data received. How to Use TFTP AT Commands 5.6.1 Feature Description The user can send data on TFTP connection in two different modes, asynchronous mode and synchronous mode.
  • Page 45: Use Cases

    URC will end up in ERROR +SQNFGETREPORT: "complete" AT+SQNFGETDATA Read internal buffer [Data] How to Use MQTT(S) Commands 5.8.1 Feature Description 5.8.1.1 AT Commands Renesas provides the following set of dedicated AT commands to implement MQTT protocol: R19AN0075EU0150 Rev.1.50 Page 45 of 76 Mar.15.22...
  • Page 46: Mqtt Server

    RYZ014 Modules Use Cases with AT Commands • Configure MQTT client: +SQNSMQTTCFG • Initiate a MQTT client connection to a broker: +SQNSMQTTCONNECT • Subscribe client to MQTT topic on a broker: +SQNSMQTTSUBSCRIBE • Publish payload text message into MQTT topic: +SQNSMQTTPUBLISH •...
  • Page 47 RYZ014 Modules Use Cases with AT Commands Depending on which type of data endpoint you are using and which cipher suite you have negotiated, AWS IoT Core server authentication certificates are signed by different root CA certificates, Please refer to: https://docs.aws.amazon.com/iot/latest/developerguide/server-authentication.html#server-authentication-...
  • Page 48 RYZ014 Modules Use Cases with AT Commands AWS End Point Parameters Figure 5. More details on how to retrieve the end point can be found here: https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-rest-api.html. • The topic to be used to publish with +SQNSMQTTPUBLISH is the one you want (for example myTopic) 5.8.2.3 Cloud IoT Core...
  • Page 49: Use Cases

    RYZ014 Modules Use Cases with AT Commands • The client id parameter to be set in the +SQNSMQTTCFG command is formatted in this way: projects/project_id/locations/region/registries/regist ry_id/devices/device_id  Where the project_id is the name that you chose for your project (MyFirstProject for example) ...
  • Page 50 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSMQTTSUBSCRIBE=0,"sqn/ test",1 +SQNSMQTTONSUBSCRIBE:0,"sqn/test",0 Notification that subscribing operation is finished. Publish a payload into a topic on a test Mosquitto broker. The command responses the Publish a payload prompt ‘>’ and waits for the data to send. The data is provided as multi-line data which ends into a topic on a with CTRL-Z or ESC to cancel publishing.
  • Page 51 RYZ014 Modules Use Cases with AT Commands Command Response Comment +SQNSMQTTONDISCONNECT: Notification about drop of MQTT connection for client 5.8.3.2 Encrypted Command Response Comment Upload test Mosquitto broker certificate into file system, certificate index 0. Note: If there is a certificate with index 0 already, remove it by the same command but setting the length to 0: AT+SQNSNVW=“certificate”,0,0...
  • Page 52 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+SQNSMQTTCONNECT=0,"19 In real usage, <host> is a domain name. In this test 2.168.13.1",8883 with local setup, we use IP address. <port> 8883 is for test with MQTT encrypted. +SQNSMQTTONCONNECT:0,0 URC notifies that connection operation is finished.
  • Page 53 RYZ014 Modules Use Cases with AT Commands Command Response Comment Upload test Mosquitto broker certificate into file system, certificate index 0. Note: If there is a certificate with index 0 already, remove it as follows: AT+SQNSNVW=“certificate”,0,0 AT+SQNSNVW="certificate",0,1 326 > After the prompt '>', copy the certificate into UART tool.
  • Page 54 RYZ014 Modules Use Cases with AT Commands Command Response Comment Configure client id, client id string, and set the index of the security profile configured previously with AT+SQNSPCFG. AT+SQNSMQTTCFG=0,"sqn/g m01 Please refer to q",,,2 sections 5.8.2.2 and 5.8.2.3 to get the client id to be used for AWS and IoT Core.
  • Page 55: Error Handling

    UEs. The supported transport layer for RYZ014 is SMS over NAS, also called SMS over SG, with 3GPP format. 3GPP2 format is not supported with SMS over NAS. It complies with 3GPP specification 27.005. There are two supported modes to send SMS: •...
  • Page 56: How To Send And Receive Sms In Text Mode

    RYZ014 Modules Use Cases with AT Commands Table 2 the call flow for a mobile-originated SMS call, and Table 3 the call flow for a mobile-terminated SMS call. Table 1. Mobile Originated SMS Flow Network UL NAS Transport -> ( CP-DATA / SMS-SUBMIT) <-...
  • Page 57 RYZ014 Modules Use Cases with AT Commands 6.1.2.2 Send SMS Command Response Comment EPS combined attach type is required before AT+CFUN=1. AT+CEMODE=2 Configure UE for EPS combined attach AT+CFUN=1 +CEREG:2 +CEREG:1,”0002”,”01A2 2002”,7 Configure UE to work under SMS text mode AT+CMGF=1 Query SMS service center address to confirm if it already well configured.
  • Page 58: How To Send And Receive A Sms In Pdu Mode

    RYZ014 Modules Use Cases with AT Commands Command Response Comment EPS combined attach type is required before AT+CFUN=1. AT+CEMODE=2 Configure UE for EPS combined attach AT+CFUN=1 +CEREG:2 +CEREG:1,”0002”,”01A2 2002”,7 Configure UTF-8 encoding AT+CSCS="UTF-8" Configure SMS in text mode AT+CMGF=1 How to Send and Receive a SMS in PDU Mode 6.2.1 Feature Description...
  • Page 59: How To Manage Sms Storage

    AT+CMGR=0 +CMGR: 1,,23 04a11132f30405a11132f30000f0c020f0e2400007c8329bfd06c500 OK How to Manage SMS Storage 6.3.1 Feature Description There are two storage areas for short messages on a RYZ014-based device: • The SIM card • The modem or device itself Use AT+CPMS (Preferred Message Storage) command to: •...
  • Page 60 RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+CPMS? +CPMS: Check storage status "ME",0,10,"ME",0,10,"ME",0,10 Send the message ”aaaa” to number +11000000151 (yourself for the test) AT+CMGS="+11000000151" Press <Enter> to get the prompt after numbering, and <CTRL-Z> to proceed with >...
  • Page 61: Error Handling

    RYZ014 Modules Use Cases with AT Commands Command Response Comment AT+CPMS="SM","ME","SM" +CPMS: 2,20,1,10,2,20 Only working when AT+CMGF=1 (Read SMS in text mode) AT+CMGL="ALL" +CMGL: 1,"REC UNREAD","11000000151",,"18/12/29,14:24:42+32" bbbb +CMGL: 2,"REC UNREAD","11000000151",,"18/12/29,14:25:29+32" cccc 6.3.2.3 Delete the SMS in the Modem Command Response...
  • Page 62: Low Power With Edrx And Psm

    RYZ014 Modules Use Cases with AT Commands • The SIM card is inserted and unlocked: Command Response Comment AT+CPIN? +CPIN: READY OK • The SMS Center number is set : AT+CSCA? returns a phone number Command Response Comment AT+CFUN=1 +CEREG: 2 AT+CSCA? +CSCA: "+33689004000",145...
  • Page 63 • URC +CEDRXP Note: RYZ014 modules support both the legacy 3GPP command (AT+CEDRXS) and a proprietary AT command (AT+SQNEDRX) to configure eDRX. It is recommended to use AT+SQNEDRX as it provides more options such as the possibility to change the value of the paging time window (PTW).
  • Page 64: Use Cases

    RYZ014 Modules Use Cases with AT Commands 7.1.2 Use Cases 7.1.2.1 Enable eDRX, Set and Query eDRX Cycle and PTW Value Command Response Comment Enable eDRX and set requested eDRX cycle to 10.24 s (requested PTW will use the default value of 1.28 s).
  • Page 65 RYZ014 Modules Use Cases with AT Commands Behavior in PSM Figure 9. When the device is dormant, the UE is not reachable from the network. However, it remains registered to the network and there is no need to re-attach or re-establish PDN connections at wake up. A UE in PSM can be reached by the network when it is in connected mode (period 2) and for the following short idle window (period 3).
  • Page 66 RYZ014 Modules Use Cases with AT Commands Table 5. Bitmap for Unit of T3412 Timer Bits Unit value is incremented in multiples of 10 minutes value is incremented in multiples of 1 hour value is incremented in multiples of 10 hours...
  • Page 67: Use Case

    RYZ014 Modules Use Cases with AT Commands 7.2.2 Use Case Command Response Comment Enable PSM and configure requested T3412 Extended and T3324 timers AT+CPSMS=1,,,"10100011"," 1: Enable the use of PSM 0100001 " "10100011": Requested Periodic TAU timer (T3412 Extended), 3 minutes "00100001": Requested Active...
  • Page 68: Informal Network Scan

     All URC should be read by the host MCU, on all the UART configured as AT ports • The estimated sleep duration is long enough  RYZ014 module will not enter deep sleep mode if a timer is scheduled to pop within a few 10 of a second 8.
  • Page 69: Error Handling

    RYZ014 Modules Use Cases with AT Commands 8.2.1.1 AT+SQNMONI Usage Command Response Comment Report on serving cell only. AT+SQNMONI +SQNMONI: Verizon Wireless USA Cc:311 Nc:480 RSRP:-70.80 RSRQ:-9.50 TAC:22533 Id:350 EARFCN:5230 PWR:-53.52 PAGING:128 Report information for the serving cell only with RSRP/CINR on main antenna.
  • Page 70: Error Handling

    10. Hardware Configuration 10.1 UART Interfaces RYZ014 modules can be controlled via a serial interface UART using standard AT commands. The serial AT interface can be connected using HW flow control or not. Please refer to the System Integration Guide for more details.
  • Page 71: Use Cases

    RYZ014 Modules Use Cases with AT Commands 10.2.2 Use Cases Command Response Comment All events are indicated by activated RING0 line of the UART0 interface, whatever event AT channel origin. AT+SQNRICFG=1,3 AT+SQNRICFG? +SQNRICFG: 1,3,1000 RING activation triggered by general URC events only, and only the event on UART0 triggers RING signal.
  • Page 72 RYZ014 Modules Use Cases with AT Commands 10.3.2.2 Set Alarm, in Format Date-Time Command Response Comment Set the time AT+CCLK="19/01/01,00:00:00+00" Set alarm timer AT+CALA="19/01/01,00:01:00+00",0,0,"first alarm" +CALV: 0 60 seconds later first alarm 10.3.2.3 Set Alarm Time Recurring All Days Command...
  • Page 73 RYZ014 Modules Use Cases with AT Commands Command Response Comment Check alarm timer AT+CALA? +CALA: "19/01/01,00:01:00",0,0,"first alarm",0 +CALA: "19/01/02,00:01:30",1,0,"second","1,2,3,4,5,6,7",1 +CALA: "19/01/01,00:02:00",2,0,"third alarm","2,7",0 +CALV: 2 third alarm 60 s. later Check that the date is shifted according to recurrence days. AT+CALA? +CALA: "19/01/01,00:01:00",0,0,...
  • Page 74: Manufacturing

    If the IMEI appears as unset and if you think that you lost the calibration file of your module please contact your Renesas representative for support. Important: By regulatory constraints, the IMEI information cannot be overwritten - the IMEI is written on an OTP (one time programmable) memory.
  • Page 75 RYZ014 Modules Use Cases with AT Commands Term Description Data Communications Equipment Data Terminal Equipment Bearer Independent Protocol Clear To Send Request To Send eDRX Extended Discontinuous Reception Power Saving Mode Microcontroller Unit UART Universal Asynchronous Receiver Transmitter Point to Point Protocol...
  • Page 76: Revision History

    RYZ014 Modules Use Cases with AT Commands Revision History Description Rev. Date Page Summary 1.00 Apr.16.21 — Initial release 1.50 Mar.15.22 — Overall update Moved 3. Factory Reset to 9. Factory Reset Added 3. How to Manage TLS Certificates Added 4. Proprietary FOTA R19AN0075EU0150 Rev.1.50...
  • Page 77 Renesas Electronics disclaims any and all liability for any damages or losses incurred by you or any third parties arising from the use of any Renesas Electronics product that is inconsistent with any Renesas Electronics data sheet, user’s manual or other Renesas Electronics document.

Table of Contents