This product provides the reference of IoT solution with using RL78 family, AWS, and FreeRTOS. The RL78 family is a kind of MCUs provided by Renesas. You can easily try to run AWS IoT demos using RL78 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 RL78 family provided as the Software Integration System by Renesas, files to collaborate Renesas tools such as the IDE e2 studio, and etc. Summary of specifications explains in the following chapters.
This reference consits the following demo projects:
- Demo project (PubSub)
- Perform simple data upload via MQTT communication.
This reference supports the following boards:
The documents for this reference are followings:
- Getting Started Guide
- For RL78/G23-128p Fast Prototyping Board with Wi-Fi (DA16600)
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 column Use indicates whether the OSS is performed in demo projects or not.
The following table indicates drivers provided by Renesas, that are Software Integration System (SIS), Firmware Integration Technology (FIT) , and CG (Code Generation) Modules.
| Component | Revision | Component Type | URL |
|---|---|---|---|
| r_bsp | 1.90 | SIS module | Board Support Package Module Using Software Integration System |
| r_byteq | 2.10 | FIT module | BYTEQ Module Using Firmware Integration Technology |
| Config_UART | 1.9.0 | CG module | - |
| Config_PORT | 1.7.0 | CG module | - |
- The configuration values of the SIS and 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.
| Component | Config name | Default Value | Project value | Reason for change |
|---|---|---|---|---|
| r_bsp | BSP_CFG_MCU_PART_ROM_SIZE | 0x3 | 0x6 | This value is set according to the RL78/G23-128p product. |
| BSP_CFG_CONFIGURATOR_SELECT | 0 | 1 | Because enable initialization of peripheral functions by Code Generator/Smart Configurator. | |
| BSP_CFG_SOFTWARE_DELAY_API_FUNCTIONS_DISABLE | 1 | 0 | To reduce using ROM/RAM. | |
| BSP_CFG_HISYSCLK_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_HISYSCLK_OPERATION | 0 | 1 | Clock setting. | |
| BSP_CFG_MOCO_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_ALLOW_FSUB_IN_STOPHALT | 1 | 0 | Clock setting. | |
| BSP_CFG_RTC_OUT_CLK_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_WAKEUP_MODE | 1 | 0 | Clock setting. | |
| BSP_CFG_RTOS_USED | 0 | 1 | Because using FreeRTOS. | |
| r_byteq | BYTEQ_CFG_PARAM_CHECKING_ENABLE | BSP_CFG_PARAM_CHECKING_ENABLE | 0 | To reduce using ROM/RAM. |
| BYTEQ_CFG_MAX_CTRL_BLKS | 32 | 8 | To reduce using RAM. | |
| r_fwup | FWUP_CFG_FUNCTION_MODE | 0 | 1 | This project is user program. |
| FWUP_CFG_MAIN_AREA_ADDR_L | 0xFFFC0000U | 0x01000U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_BUF_AREA_ADDR_L | 0xFFF80000U | 0x59000U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_AREA_SIZE | 0x34000U | 0x58000U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_CF_BLK_SIZE | 0x4000U | 2048U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_DF_ADDR_L | 0x00100000 | 0xF1000U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_DF_BLK_SIZE | 64U | 256U | This value is set according to the RL78/G23-128p product. | |
| FWUP_CFG_DF_NUM_BLKS | 256U | 32U | This value is set according to the RL78/G23-128p product. |
| Component | Config name | Default Value | Project value | Reason for change |
|---|---|---|---|---|
| r_bsp | BSP_CFG_MCU_PART_ROM_SIZE | 0x3 | 0x6 | This value is set according to the RL78/G23-128p product. |
| BSP_CFG_CONFIGURATOR_SELECT | 0 | 1 | Because enable initialization of peripheral functions by Code Generator/Smart Configurator. | |
| BSP_CFG_HISYSCLK_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_HISYSCLK_OPERATION | 0 | 1 | Clock setting. | |
| BSP_CFG_MOCO_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_ALLOW_FSUB_IN_STOPHALT | 1 | 0 | Clock setting. | |
| BSP_CFG_RTC_OUT_CLK_SOURCE | 1 | 0 | Clock setting. | |
| BSP_CFG_WAKEUP_MODE | 1 | 0 | Clock setting. |
- 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.
RL78/G22, RL78/G23, RL78/G24, RL78/L23 Firmware Update Module
See CONTRIBUTING for more information.
- 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 SIS, FIT, and other modules located in the Projects/xxx/projects/xxx/src/smc_gen and Projects/xxx/modules are available under the disclaimer written in source or header files.
- License of FIT modules: https://github.com/renesas/rx-driver-package
Visit the following official webpage if having any technical questions.