This product provides the reference of IoT solution with using RX family, AWS, and FreeRTOS. The RX family is a kind of MCUs provided by the Renesas. You can easily try to run AWS IoT demos using RX family while working with our various other products.
Refer to the Getting Started Guide for step by step instructions on setting up your development environment and running demos.

This reference is consist of demo applications, FreeRTOS kernel, middleware provided by AWS and 3rd party, middleware and drivers for RX family provided as the RX Driver Package by the Renesas, files to collaborate Renesas tools such as the IDE e2 studio, and etc. Summary of specifications explains in the following chapters.

• AWS IoT core

• CK-RX65N v2 with:
  • Ethernet
  • Cellular(LTE Cat-M1)
    • RYZ014A (Obsolete)
      • This product is no longer in production and technical support may be limited.
  • Wi-Fi
    • DA16600

The following table shows the demos and features available on CK-RX65N v2.

note 1: demo:

• PubSub
  Simple MQTT communication with AWS CLI or AWS Management Console
• OTA (Over-the-air) update
  Update device firmware using AWS
• Fleet Provisioning
  Generating and securely delivering device certificates and private keys to your devices by AWS when they connect to AWS IoT for the first time
• TCP minimal(Ethernet Only)
  • Provides basic TCP/IP functionality using FreeRTOS Kernel and FreeRTOS-Plus-TCP
  • Acquisition of IP address by DHCP
  • IP address search of URLs by DNS

note 2: TLS with TSIP:

• It uses the RX Family's built-in security hardware, Trusted Secure IP (TSIP).
• This enables secure key management and high-speed encryption and decryption for TLS communications.

note3 : The preceding demos use the following technical elements of the AWS IoT:

• AWS IoT Jobs
• MQTT File Delivery

The following table indicates name and version of OSS which are used in this reference. The column LTS Until indicates the support period as LTS.

The following table indicates name and version of FIT modules which are used in this reference and version of RX Driver Package in which each FIT module is packaged.

RX family of MCU has internal Data Flash Memory, and this references are using the Data Flash to store the data for connecting to the Cloud service.

• LittleFS management area
  • The demo project uses a maximum of 8960 bytes of Data Flash from address 0x00100000 to 0x001022FF using LittleFS.
    • If this area is less than 8960 bytes, the demo will not work properly.
  • You must NOT overwrite other data against IoT const data in this area.
  • If you intend to read/write user application data in this area, incrsease the value of LFS_FLASH_BLOCK_COUNT in the "Projects\...\frtos_config\rm_littlefs_flash_config.h".
    • LFS_FLASH_BLOCK_COUNT must be specified 71 ( == 9088 bytes) or more and 256 (32768 bytes, it is Data Flash size) or less.
    • You must use LittleFS's API to read/write this area.
  • When increasing LFS_FLASH_BLOCK_COUNT, you must also reset the address of the section for free area(C_USER_APPLICATION_AREA) considering the increased LittleFS management area.
    Open the project by e2 studio of IDE --> Right-click on the project at the project explore --> properties --> C/C++ Build --> Settings --> Section
    • If you do not set up a section, the demo may not work properly.
• Free area
  • The remaining area on Data Flash, 23808 bytes of Data Flash area at address 0x00102300 or above, can be used as user application area.
    • You must use FLASH FIT module's API to write this area.

The following figure indicates how memory in Data Flash in CK-RX65N v2 is used for each example of LFS_FLASH_BLOCK_COUNT value.

In case of `LFS_FLASH_BLOCK_COUNT` == 70 (8960 bytes)
 +----------------------------+-------------------------+ <- 0x00100000
 |  LittleFS management area  |  IoT const data         |    <8960 bytes>
 +----------------------------+-------------------------+ <- 0x00102300
 |  Free area                 |  User application data  |    <23808 bytes>
 |                            |                         |
 +----------------------------+-------------------------+ <- 0x00107FFF

In case of `LFS_FLASH_BLOCK_COUNT` == 170 (21760 bytes)
 +----------------------------+-------------------------+ <- 0x00100000
 |  LittleFS management area  |  IoT const data         |    <21760 bytes>
 |                            |  User application data  |
 +----------------------------+-------------------------+ <- 0x00105500
 |  Free area                 |  User application data  |    <11008 bytes>
 +----------------------------+-------------------------+ <- 0x00107FFF

The following submodules have been modified by Renesas.
These changes will be saved in the \Common\patches folder and will be incorporated into the project until they are merged into the FreeRTOS LTS.

• FreeRTOS-Plus-TCP
  • It will be stored in the following folder.
    \Common\patches\FreeRTOS-Plus-TCP
  • The FreeRTOS-Plus-TCP submodule code NetworkInterface.c was missing pxFillInterfaceDescriptor.
    As a temporary workaround, the missing pxFillInterfaceDescriptor function was added.
• Jobs-for-AWS-IoT-embedded-sdk
  • It will be stored in the following folder.
    \Common\patches\Jobs-for-AWS-IoT-embedded-sdk
  • The AWS IoT Jobs packaged in LTS_v202406.01 lacks "custom version string" support.
    So as a temporary workaround, we have modified the Jobs_UpdateMsg API to allow the custom version to be used.

• The configuration values of the FIT modules that have been changed from the default values are listed in the table below.
• However, each projects is evaluated only with preset values, including configuration values that have not been changed from the default values.
• If changed, the program may not work properly.

• Source code located in the Projects, Common, Middleware/AWS, and Middleware/FreeRTOS directories are available under the terms of the MIT License. See the LICENSE file for more details.
• Other libraries located in the Middleware directories are available under the terms specified in each source file.
• Each Renesas FIT Modules in RX driver package located in the Projects/xxx/xxx/src/smc_gen are available under the terms of the basically BSD3-Clause License. See the doc/license of following URL for more details. https://github.com/renesas/rx-driver-package

Visit the following official webpage if having any technical questions.

• English window
• Japanese window
• Chinese window