Skip to content

Release RX MCUs FreeRTOS IoT Reference 1.3.2 comes from original 202210.01-LTS

Latest
Compare
Choose a tag to compare
@xuan97z1 xuan97z1 released this 28 Oct 05:36
· 2 commits to main since this release

Summary for package v202210.01-LTS-1.3.2

New update in this version

  • Implement new feature which allows FreeRTOS-Plus-TCP component to be added/removed in SmartConfigurator.
  • Implement new feature which allows user to filter applications by connectivity.
    (Note: This feature is only available in e2studio v2024-10 or later)
  • Added .gitattributes file to normalize the line endings across different platforms.
  • Added new application option: minimal FreeRTOS-Plus-TCP project.

Supported Boards

RX MCU and Board Compiler Endian Connectivity Import project Project generation (PG)
CK-RX65N v1 CCRX Little Ethernet Yes Yes
CK-RX65N v1 GCC Little Ethernet Yes Yes
CK-RX65N v2 CCRX Little Ethernet(*1) No Yes
CK-RX65N v2 GCC Little Ethernet(*1) No Yes
CK-RX65N v1 CCRX Little Cellular(CAT M1) RYZ014A Yes Yes
CK-RX65N v1 GCC Little Cellular(CAT M1) RYZ014A Yes No
CK-RX65N v2 CCRX Little Wi-Fi DA16600 Yes Yes
CK-RX65N v2 GCC Little Wi-Fi DA16600 Yes Yes

Note:

  • (*1)CK-RX65N v2 with Ethernet connectivity only supports minimal FreeRTOS-Plus-TCP project.
  • PG creates a new project in e2studio using the New Project Wizard to workspace.
  • Import project means using e2studio to import existing project in package to workspace.
  • From e2studio_2024-04 onwards, (DUAL) target board is no longer supported. Please configure bank mode as Dual Bank in the PG wizard.
  • MbedTLS w/ TSIP PubSub and OTA update are supported for Ethernet and Cellular project, CC-RX compiler only.
  • Minimal FreeRTOS-Plus-TCP project is supported for Ethernet connection, CK-RX65N-V2 only.

FIT Modules and RX Driver Package

The following table indicates name and version of FIT modules are using under reference and version of RX Driver Package.

FIT module Revision of FIT module Version of RX Driver Package
r_bsp 7.42 1.42
r_s12ad_rx 5.30 1.41 - 1.42
r_byteq 2.10 1.37 - 1.42
r_cellular 1.11 1.40 - 1.42
r_ether_rx 1.23 1.36 - 1.42
r_flash_rx 5.11 1.42
r_sci_rx 5.00 1.42
r_tsip_rx 1.20.l --
r_fwup 2.03 --
r_irq_rx 4.40 1.40 - 1.42
r_wifi_da16xxx 1.20 1.42
Note: Minimal FreeRTOS-Plus-TCP project supports up to RDP_v1.45 FIT modules.

Demos

  • Minimal FreeRTOS-Plus-TCP
    • Demonstrates the use of FreeRTOS + TCP module with Ethernet.
  • PubSub
  • PubSub (MbedTLS with TSIP)
  • 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
  • OTA Update
    • Update new firmware via MQTT
  • OTA Update (MbedTLS with TSIP)
    • Update new firmware via MQTT using TSIP for TLS communication
  • FreeRTOS TCP minimal(CK-RX65N-v2/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
      • Send ping to the specified IP Address

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

Limitation

  • CLI task cannot run after starting the demo to avoid the SCI conflict.
  • OTA demo will not work properly unless otaconfigMAX_NUM_BLOCKS_REQUEST is set to "1".
    If otaconfigMAX_NUM_BLOCKS_REQUEST is set to anything other than 1, a build error will occur.
  • The following macros are not supported by this source code.
    If you build the above macros, a build error will occur.
    LFS_NO_MALLOC
    LFS_THREADSAFE
  • After generating code by Smart Configurator, sections (C_FIRMWARE_UPDATE_CONTROL_BLOCK and C_FIRMWARE_UPDATE_CONTROL_BLOCK_MIRROR) will be added at address 0x00100000 due to the TSIP module (v1.17.l and above).
    They are empty sections and will not use any additional memory.
  • The MAC address included in the sample code uses the address assigned by the vendor ID of Renesas Electronics Corporation.
    When operating the sample program on multiple devices simultaneously in the same LAN environment, change the MAC addresses so that they do not overlap.
    If the MAC addresses duplicate on multiple devices, the sample program may not operate properly.
  • Limitations on the xGetMQTTAgentState() function
    In the following case, the xGetMQTTAgentState() function for monitoring the communication status returns the state of established MQTT connection with AWS (MQTT_AGENT_STATE_CONNECTED) without detecting the disconnection:
    The hook function *1 is called by occuring an error of a TCP_Sockets API *2 (disconnection with AWS) inner the xGetMQTTAgentState(), then this hook restores the connection to established state.
    *1 The hook function defined in USER_TCP_HOOK_FUNCTION macro in src/frtos_config/user_tcp_hook_config.h
    *2 TCP_Sockets API is a function defined in TCP_Sockets_xxxx
  • Fleet Provisioning demo is not supported when using TSIP for MbedTLS communication.
  • Notes on redundant linker section after generating code with Smart Configurator.
    After generating code with Smart Configurator, sections 'C_FIRMWARE_UPDATE_CONTROL_BLOCK' and 'C_FIRMWARE_UPDATE_CONTROL_BLOCK_MIRROR' will be created at address 0x00100000.
    These sections are redundant, it does not impact memory usage of the project.
    This behavior is according to the specification of r_tsip_rx FIT module (from version 1.17.l).
  • Notes on bootloader to application transition.
    When transitioning from the bootloader sample program to the application, the settings of the bootloader's peripheral functions are taken over by the application.
    For more information, check chapter 7 of the following document.
    RX Family Firmware Update module Using Firmware Integration Technology Application Notes.
  • Limitations on transmission with multiple sockets
    If using multiple sockets and one of socket happens error, Reset Hook function is executed. In this case, all socket information is removed, while the remaining socket attempts to send or receive data. The communication in this socket will not work properly.
    Do not use multiple sockets with Reset Hook function.
  • Socket wrapper/TCP_socket_hook works in single thread. Do not trigger TCP_socket_hook in multiple threads.
  • Demos with TSIP do not support fleet provisioning (only Pubsub and OTA demos are supported).
  • Limitations on using the LittleFS module
    The LittleFS is not thread-safe.
    Calling the LittleFS API from multiple tasks is prohibited.
  • When you connect to a GCC project in the debugger using e2 studio version 2024-10, you may see the following error message:
    Exception occurred during launch
    In this case, you can make a debug connection by performing the following steps.
    • Click the following from the e2 studio menu.
      Help -> About e2 studio
    • Click the button Installation Details at the bottom left of the About e2 studio window.
    • Click the tab Support Folders
    • Click the link e2 studio support Area
    • Open the following folders from the opened Windows Explorer screen.
       \DebugComp\RX\RtosPlugins
    • Delete the following files: FreeRtosDll.dll