Renesas CK-RX65N User manual

Getting Started Guide
R01AN6870EJ0110 Rev.1.10 Page 1 of 52
Jun.02.23
CK-RX65N
Getting Started Guide with RYZ014A Azure Cellular Application
Introduction
This document describes a system that uses the CK-RX65N Cloud Kit board from Renesas. This system
incorporates the CK-RX65N running Azure RTOS and via an Ethernet/Cellular connection visualizes
HS3001, ZMOD4410, ZMOD4510, OB1203, ICP10101 and ICM20948 sensors information on Azure IoT
Explorer and controls LEDs on the board.
There are two ways of connectivity for CK-RX65N. One is the Ethernet, second is the Cellular Cat-M1.
This document shows both connectivity.
And this document shows the way of below items.
- How to activate the SIM card that is contained the CK-RX65N
- How to operate and install the information of certification for cloud
- How to see and run the sensor data on the Azure IoT viewer
Figure 1. CK-RX65N(with RYZ014A Pmod)
Target Device
CK-RX65N
Web site
RX Cloud solution Web
CK-RX65N Web
Program and binary data
Program
Binary data

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
2
of 52
Jun.02.23
Contents
1. Terms......................................................................................................................................3
2. Preparation..............................................................................................................................3
2.1 Hardware Configuration .....................................................................................................................3
2.2 Software Configuration.......................................................................................................................3
2.3 Tera term Setting...............................................................................................................................4
3. System Diagram......................................................................................................................4
4. Activating a SIM card...............................................................................................................5
4.1 Activating a SIM card on Truphone.....................................................................................................5
4.2 Activating a SIM card on MicroAI Launchpad......................................................................................8
5. Azure Account and Credentials Creation...............................................................................14
5.1 Install Azure CLI...............................................................................................................................14
5.2 Create an IoT Hub ...........................................................................................................................15
5.3 Certificate Creation Process.............................................................................................................18
5.4 View Device Properties ....................................................................................................................21
5.5 Set IoT Hub......................................................................................................................................21
5.6 Register an IoT Hub Device..............................................................................................................25
5.7 Prepare the Device ..........................................................................................................................26
6. Common users: To import the project and Run......................................................................27
6.1 Import the project.............................................................................................................................27
6.2 Serial Terminal Settings................................................................................................................... 34
6.3 Storing Device Certificate, Host Name, Device ID.............................................................................37
6.4 Send Device to Cloud Message........................................................................................................41
6.5 Send Cloud-to-Device Message .......................................................................................................41
7. IoT Plug and Play Certification Requirements........................................................................43
7.1 Program Purpose.............................................................................................................................43
7.2 Requirements ..................................................................................................................................43
8. Azure IoT Central architecture...............................................................................................48
8.1 Manage devices............................................................................................................................... 48
8.1.1 View and analyze data...................................................................................................................49
8.1.2 Secure your solution ......................................................................................................................49
8.2 Devices............................................................................................................................................49
8.3 Gateways.........................................................................................................................................49
8.4 Export data......................................................................................................................................50
9. Note and trouble shooting......................................................................................................50
9.1 About stabilization time for sensor....................................................................................................50
9.2 Connection issue when using Ethernet (Wired cable).......................................................................50

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
3
of 52
Jun.02.23
9.3 About the trouble of current supply short when using RYZ014A........................................................50
9.4 About when build errors occur..........................................................................................................50
Revision History............................................................................................................................52
General Precautions in the Handling of Microprocessing Unit and Microcontroller Unit Products..53
Notice ...........................................................................................................................................54
Corporate Headquarters ...............................................................................................................54
Contact information.......................................................................................................................54
Trademarks...................................................................................................................................54
1. Terms
Terms
Terms used in this document are explained below.
Table 1.1 Terms
Term
Meaning
IoT
Internet of Things
2. Preparation
2.1 Hardware Configuration
The hardware configuration of the demo project is listed in the table below.
Item
Content
Description
CK-RX65N Cloud Kit
Target board for
CK-RX65N
Please see detail.
https://www.renesas.com/rx/ck-
rx65n
RYZ014A Cellular PMOD
module
SIM card
This PMOD is contained with CK-
RX65N of kit with SIM card
PC
Windows 10
Azure IoT Explorer (0.14.5.0)
Recommended OS
Azure cloud Data viewer
2.2 Software Configuration
The software configuration of the demo project is listed in the table below.
Item
Content
Version
Integrated development
environment
e2 studio
2023-01 or Later
Complier
CC-RX
GCC(Planning)
V3.04
-

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
4
of 52
Jun.02.23
Communication Software
Tera term
Version 4.106
Emulator
E2 emulator Lite (on-board)
-
OpenSSL
3.0.5
RTOS
Azure RTOS
V6.1.11
2.3 Tera term Setting
Item
Settings
Baud rate
115200
Data length
8
Parity
none
Stop bits
1
Flow Control
none
3. System Diagram
Figure 2. System Diagram
Azure Dashboard
OB1203 Sensor
HS3001 Sensor
ICP10101 Sensor
ICM20948 Sensor
ZMOD 44XX
Sensor
CK-RX65N CloudKit
(Cellular/Ethernet
Interface)

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
5
of 52
Jun.02.23
4. Activating a SIM card
One of two SIM cards is included in this kit that is Truphone or MicroAI Launchpad.
Please activate the SIM card as following steps depending on the included SIM card.
4.1 Activating a SIM card on Truphone
To activate the included Truphone SIM card, please visit the Truphone SIM Activation platform at
truphone.com/connectit and use the following steps:
1. On the Business page, click Start activation button under IoT SIM Activation.
Figure 3. Activating the SIM Card on Truphone
2. Create a new Truphone Account by selecting Sign up (next to Don’t have an account yet?) and fill-in
your full name, Email, and a password. Then click Sign up to create a new account.
Figure 4. Signing in
3. Select Personal as the account type and press Get Started.

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
6
of 52
Jun.02.23
Figure 5. Selecting the account type
4. Verify your email by entering the activation code sent to your email account.
Figure 6. Verifying the email
5. Complete the Profile information form –then select Create account.

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
7
of 52
Jun.02.23
Figure 7. Completing the Profile information
6. Select Activate SIMS to activate your individual SIM by ICCID.
Figure 8. Activating SIM
7. Enter the ICCID value.
Figure 9. Entering the ICCID
8. You will receive email confirmation when the SIM card activation is complete.
The CK-RX65N kit and SIM card should be activated and can be validated on the Tera Term terminal.
Note: The SIM card includes free credit for the first 90 days/50MB.
After expiring the free data charge, Communication charges will be incurred.
Disclaimer

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
8
of 52
Jun.02.23
The activation steps above are provided by SIM Provider Truphone. They are the most current at the time of
publishing this application note. If you need help activating your SIM card, contact Truphone support
iot.truphone.com or Contact Support | Truphone.
If you have a SIM card from any other provider then contact the technical support for that provider.
For any other issue that cannot be resolved please contact Renesas Support at Technical Support.
Note: The SIM card provider for the Quick Start Guide example project is Truphone. If you use any other
SIM card provider you must change the Access Point Name required for the SIM card provider in your
global region. Failure to do so could result in the RYZ014A not connecting to the cellular network.
4.2 Activating a SIM card on MicroAI Launchpad
The MicroAI Launchpad platform will be needed for the activation of the SIM card. To activate the SIM
card, use the following steps:
1. Create a Launchpad account. Do so by registering on the sign-up page and verifying the account
through the verification email sent after registration.
2. Login to the new Launchpad account and click on the Create Device Profile tile. Make sure Renesas
CK-RX65N(or Renesas RSK-RX65N when missing CK-RX65N) is selected for the Device Type and
CAT-M for the Connectivity Type. Fill other fields as desired then click Next.
Figure 10. Create Device Profile on MicroAI Launchpad

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
9
of 52
Jun.02.23
Figure 11. Input the information of Profile
3. On Data Schema, click Next.
Renesas CK-RX65N

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
10
of 52
Jun.02.23
Figure 12. Data schema
4. On Select a Plan, apply any valid promo codes if applicable and click Next.
Note:
The SIM card contained in Kit credit for first 1 month/50MB fee. You can see
credited information in invoice center on your account.
After expiring the free data charge, Communication charges will be incurred.
If you need that it doesn’t need to use this SIM card with payment, please set the device status to
"suspended" to stop the communication charge.

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
11
of 52
Jun.02.23
Figure 13. See the plan of SIM and trial time
5. Provide a Payment Method and accept the terms and conditions. Click Finish.
Figure 14. Input he payment method
6. Click the Register a Device tile to begin registering the CK-RX65N kit and SIM card. Select the device
profile created from the device profile drop-down.
7. Select your Device Profile you created previous step.

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
12
of 52
Jun.02.23
8. Enter the IMEI value obtained from the CLI of section “4.14 Running the application & activation of SIM
card contain with CK-RX65N” into the “Device ID”. Fill other fields as needed.
Note: Please be careful, the “Device ID” cannot change after registration of this step.
Figure 15. Registering a device of CK-RX65N on MicroAI Launchpad
Figure 16. Enter Device ID

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
13
of 52
Jun.02.23
9. Click Next and click Add New SIM. Enter the ICCID value for the SIM EID field and click Save SIM.
Figure 17. Add new SIM
Figure 18. Activating the SIM card on MicroAI Launchpad
Finish the device registration. The CK-RX65N kit and SIM card should be activated on the Launchpad
platform and can be validated on the Tera Term terminal.

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
14
of 52
Jun.02.23
5. Azure Account and Credentials Creation
5.1 Install Azure CLI
To prepare Azure cloud resources and connect a device to Azure, you can use Azure CLI. Azure
CLI can beinstalled locally on your PC.
1. Azure CLI can be downloaded from the Microsoft site (https://docs.microsoft.com/en-
us/cli/azure/install-azure-cli)
2. Note: The installer name will be similar to azure-cli-2.44.x.msi. or later. Click on the installer
andthe install shield will guide you through the installation process.
3. Install the current release of the Azure CLI. After the installation is complete, you will need to
close andreopen any active Windows Command Prompt or PowerShell windows to use the
Azure CLI.
4. After the Azure CLI installation is successful, open and launch the Windows PowerShell to use
the AzureCLI. A screenshot of the Windows PowerShell is shown below.
Figure 19. Windows Power Shell
5. If you already have Azure CLI installed locally, run az - -version to check the version. This app
noterequires Azure CLI 2.44.0 or later.
Figure 20. AZURE CLI Version

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
15
of 52
Jun.02.23
5.2 Create an IoT Hub
You can use Azure CLI to create an IoT hub that handles events and messaging for your device.
Note 1: Before you start creating the IoT Hub you are required to have a login to your Azure Portal
via webbrowser. If not, then you may notice an error that you are not logged in while creating the IoT
hub, you maynotice an error that you are not logged in.
https://portal.azure.com/
Note 2: If you do not have the Azure Account, you can create one which is valid for 12 months
with limitedfeatures from the following link
https://azure.microsoft.com/en-us/free/
To create an IoT hub:
Note 3: Some of the user parameters while creating the IoT Hub needs to be unique. Users are
required totake care of this while creating the IoT Hub credentials.
1. In your CLI console, run the az extension add command to add the Microsoft Azure IoT
Extension for Azure CLI to your CLI shell. The IoT Extension adds IoT Hub, IoT Edge, and IoT
Device ProvisioningService (DPS) specific commands to Azure CLI.
⎯ az extension add --name azure-iot
Note 4: When you run the command for the first time you may not notice output on the console as shown
below. It just accepts the command.
Figure 21. Add Extension for Azure CLI
2. Run the az login command to login to the Azure account. Running the az login command
opens the browser for login. You can enter the login credentials to login to the Azure account.
You will notice asimilar message on the browser on successful login.
Note: You can find more info on the Azure CLI at Overview of the Azure CLI | Microsoft Docs
Figure 22. Successful Login to the Azure account

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
16
of 52
Jun.02.23
3. Run the az group create command to create a resource group. The following command
creates a resource group named MyRXResourceGroup in the westus region.
4. Note: Optionally, to set an alternate location, run az account list-locations to see
availablelocations. Then specify the alternate location in the following command in place of
westus.
⎯ az group create --name MyRXResourceGroup --location westus
Figure 23.Create Resource Group
5. Run the az iot hub create command to create an IoT hub. It might take a few minutes to
create an IoT hub.
Replace the YourIotHubName placeholder below with the name you chose for your IoT hub.
An IoT hub name must be globally unique in Azure. This placeholder is used in the rest of
this tutorial to represent your unique IoT hub name. Use any command given below.
⎯ az iot hub create --resource-group MyRXResourceGroup --name
{YourIoTHubName}
OR
⎯ az iot hub create --resource-group MyRXResourceGroup --name
{YourIoTHubName} --location {YourLocation}
Note: It may take few minutes to create the IoT Hub. In this case the IoTHub name used is
RXCLOUDHUB.
Note: Microsoft recommends to create new IoT Hub. If the IoT hub created previously (2-3 year
old ) it may not work as desired. So we recommend to create new IoT Hub to run the application
to yield the proper results
Figure 24.IoT Hub Creation in Progress
MyRXResourceGroup
MyRXResourceGroup”,
“MyRXResourceGroup”,
MyRXResourceGroup
RXCLOUDHUB

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
17
of 52
Jun.02.23
6. After the IoT hub is created, view the JSON output in the console, and copy the hostName
value to a safe place. You use this value in a later step. The hostName value looks like the
following example:
⎯ {Your IoT hub name}.azure-devices.net
Figure 25.JSON Output after IoT Hub Creation
MyRXResourceGroup
RXCLOUDHUB
“RXCLOUDHUB.azure-devices.net”,
“RXCLOUDHUB”,
RXCLOUDHUB”,
“rxcloudhub”,

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
18
of 52
Jun.02.23
5.3 Certificate Creation Process
You can use GIT BASH utility for this process. All OpenSSL commands and Self Signed Certificate
creation process is given on this link.
Steps as below
1. Set x509 configuration file for common name in cert.
Figure 26. Set X509 Configuration File
2. Create RSA self-signed certificate
Generate private key and certificate (public key) using the command as shown in the snapshot
“openssl genrsa -out privkey.pem 2048”
Figure 27. Generate private key and certificate
(public key)

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
19
of 52
Jun.02.23
3. Embed Device ID in certificate
This command will not give you any response if successfully executed.
openssl req -new -days 365 -nodes -x509 -key privkey.pem -out cert.pem -config x509_config.cfg -subj
"//CN=<Same as device Id>"
Figure 28. Embed Device ID in certificate
4. Convert format of key from pem to der “openssl rsa -outform der -in privkey.pem -out privkey.der"
Here you get response “writing RSA key”
Figure 29. Convert format from key to der
5. Convert format of cert from pem to der “openssl x509 -outform der -in cert.pem -out cert.der”
This command will not give you any response if successfully executed.
Figure 30. Convert format of cert from pem to der
6. Convert der to hex array (ubuntu) and set them in sample_device_identity.c
CK_RX65N_X509”

CK-RX65N Getting Started Guide with RYZ014A Azure Cellular Application
R01AN6870EJ0110 Rev.1.10 Page
20
of 52
Jun.02.23
7. Check whether sample_device_identity.c is created.
Figure 31. Convert der to hex array and set them in Sample_device_identity.c
8. Producing sample_device_cert_ptr and sample_device_private_key_ptr array containing
device certificate and private key equivalent hex values along with length.
“xxd -i cert.der | sed -E "s/(unsigned char) (¥w+)/¥1 sample_device_cert_ptr/g; s/(unsigned int)
(¥w+)_len/¥1 sample_device_cert_len/g" >> sample_device_identity.c”
“xxd -i privkey.der | sed -E "s/(unsigned char) (¥w+)/¥1 sample_device_private_key_ptr/g; s/(unsigned int)
(¥w+)_len/¥1 sample_device_private_key_len/g" >> sample_device_identity.c”
These commands will not give you any response if successfully executed.
Figure 32. Producing arrays containing hex values
Check the content of sample_device_identity.c with cat command. In this file you will get Device
certificate along with SHA1 fingerprint,Device Private Key, sample_device_cert_ptr and
sample_device_private_key_ptr array along with their length.This fingerprint you have to use in device
creation process.