Overview

Description

download Download Latest FSP (v5.3.0):

FSP Windows Platform Installer
FSP Linux Platform Installer
FSP RASC Windows Installer
FSP RASC Linux Installer

See All FSP Releases & Patches on GitHub

The Renesas Flexible Software Package (FSP) is an enhanced software package designed to deliver user-friendly, scalable, high-quality software for embedded system designs using the Renesas RA family of Arm Microcontrollers, ensuring software compatibility across the RA family, from entry-level to high-performance microcontrollers. With the support of new Arm® TrustZone® and other advanced security features, FSP provides a quick and versatile way to build secure, connected IoT devices using production-ready drivers, Azure® RTOS, FreeRTOS™, and other middleware stacks.

FSP includes best-in-class HAL drivers with high performance and low memory footprint. Middleware stacks with Azure RTOS and FreeRTOS integration are included to ease the implementation of complex modules like communication and security. The e² studio IDE provides support with intuitive configurators and intelligent code generation to make programming and debugging easier and faster.

FSP uses an open software ecosystem and provides flexibility in using bare-metal programming, including Azure RTOS or FreeRTOS, your preferred RTOS, legacy code, and third-party ecosystem solutions. FSP and e² studio can be used free of charge on any Renesas device.

Features

  • Small memory footprint HAL drivers
  • Intuitive configurator and code generator
  • Static and dynamic analysis using industry-standard tools
  • Application support using RTOS and non-RTOS environments
  • Azure RTOS and its middleware stacks with Flexible Software Package
    • Azure RTOS ThreadX, NetX Duo & Add-ons, USBX, GUIX & GUIX Studio, FileX, TraceX, exFAT, LevelX, NetX Duo Secure & NetX Crypto (HW acceleration)
  • FreeRTOS support – Includes Kernel and set of software libraries
    • FreeRTOS Kernel, FreeRTOS-Plus-TCP, Core MQTT, Core HTTP/HTTPS, Task pool, Secure Sockets, Cellular Interface
  • Tool configurable RTOS resources (Threads, mutexes, etc.)
  • Middleware stacks from Renesas and third parties.
    • TCP/IP and other connectivity protocol stacks including MQTT
    • USB middleware support for CDC, HID, and MSC
    • Wireless connectivity through Cellular (Cat-M1), Wi-Fi, and Bluetooth Low Energy LE 5.0 (BLE Mesh)
    • File System support with FreeRTOS+FAT and LittleFS
    • Storage (Block Media) support for SDMMC, SPI, and USB.
    • Virtual EEPROM on Flash
    • Capacitive touch middleware to implement widgets like Button, Slider, and Wheels.
    • Motor control algorithms
    • Secure Bootloader through MCUboot
    • Sensor Module APIs
  • TrustZone support (for applications on CM33-based MCUs)
    • TrustZone enabled drivers and middleware
    • Easy-to-use tool support for TrustZone configuration
  • PSA Level 2 Certified
  • AWS qualified for FreeRTOS
  • Easy connectivity options to major cloud providers
  • Secure connections through NetX Duo Secure and Mbed TLS
  • Cryptographic APIs and integrated Hardware Acceleration support
    • Arm PSA Cryptographic APIs
    • Azure RTOS NetX Crypto APIs
    • Ultimate security with FSP Crypto APIs (SCE9 protected mode)
    • TinyCrypt targeting constrained devices
  • Graphics interface support and tools
    • Segger emWin (RA customers can use Segger emWin graphic tools and libraries for free from Downloads below)
    • Azure RTOS GUIX and GUIX Studio (available free on Microsoft Apps Store)
  • Secure debugging capabilities
  • Extensive tool support from Renesas and leading third-party solutions
  • Integrated package with all required components for easy setup and starting development (single installer with e2 studio, CMSIS packs, toolchain, and Segger J-Link drivers)
  • Complete source code available through GitHub

Release Information

For additional information and links go to GitHub.

v5.3.0

Release Notes

Flexible Software Package (FSP) for Renesas RA MCU Family, version 5.3.0.

Minimum e2 studio version for FSP 5.3.0 is e2 studio 2024-04

Download the FSP with e2 studio Windows installer for this release: FSP Windows Platform Installer

Download the FSP with e2 studio Linux AppImage for this release: FSP Linux Platform Installer
Refer to https://en-support.renesas.com/knowledgeBase/19934358 for information on installing e2 studio and related software components in a Linux PC.

Download the FSP with e2 studio MacOS installer for this release: FSP MacOS Platform Installer

If using IAR or Keil MDK, download the Renesas Advanced Smart Configurator for this release,
FSP RASC Windows Installer
FSP RASC Linux Installer

All installers are available in the Assets section of this release.

Refer to the README.md in the FSP root folder for setup instructions, hardware details, and related links.

Features Added

  • Support new development kits:
    • AIK-RA6M3
    • AIK-RA4E1
    • BGK-RA6E2
  • The following modules are now supported in RA0E1 projects:
    • LPM
    • IICA
    • TML32
  • Support 4096-bit RSA key generation for RA8 devices
  • Support MCUBoot TrustZone for external QSPI-based memory
  • Support HOCOCR2 register for RA4M1
  • Support GPT trigger for ADC
  • Added Netxduo Wi-Fi and on-chip Silex Wi-Fi documentation
  • Baremetal support for DA16xxx Wi-Fi and on-chip MQTT/HTTP client modules
  • Support for Reality AI over USB
  • Dual motor support for MCK-RA8T1
  • Support RRH46410 sensor
  • Support USBX composite PCDC+PMSC
  • DTC event selection now limited to only DTC-compatible events with an enabled interrupt
  • Support IICA for 20 and 16-pin devices of RA0E1

Fixes and Improvements

  • Platform installer updated to include e2 studio 2024-04
  • Segger J-Link version updated to 7.96a
  • IAR compiler version updated to 9.50.2
  • Common FSP API support updated to v1.5.0
  • Code size optimization and new build-time options for the following modules:
    • ADC_D
    • RTC_C
    • SAU I2C
    • SAU UART
    • TAU
  • Support RSIP-E51A protected mode for RA8D1 and RA8T1 devices
  • RSIP-E51A protected mode supports new cryptographic feature
    • SHA-512
    • ECC P-521
    • RSA 3072/4096 bit key generation
    • AES key wrap/unwrap following RFC3394
    • Injected key import API
  • Support IICA Master in rm_comms_i2c
  • Updated GPT driver to support compare match
  • Updated documentation for USB
  • Updated documentation for Reality AI over USB
  • Updated MCUBoot documentation to address a TrustZone issue on RA8M1
  • Fixed some artifacting issues when using D-Cache in emWin projects
  • Fixed DOTF configuration key type
  • Fixed compilation failure when selecting 'use own target' for Ethernet PHY leads
  • Fixed limitation of LLVM support on BLE Mesh
  • Fixed limitation related to the restart of SAU-I2C driver
  • Fixed OSPI clock divider options for RA8D1
  • Fixed ADCR register for RA0E1
  • Fixed ADC conversion with synchronous trigger
  • Resolved USB event handling issue when connected to Android/Linux hosts
  • Fixed constraint issue with MCUBoot VTOR offset
  • Fixed MCUBoot dual bank mode on RA8M1
  • RTC on RA0E1 no longer pauses during Open if already running
  • Fixed a parameter checking issue in R_LVD_Open on RA8M1, RA8D1 and RA8T1 devices
  • Fixed issue when using UARTA with SOSC as the clock source
  • Improved rtc_alarm_time_t configuration for RTC_C to match other RTC implementations
  • Wi-Fi API header file (rm_wifi_api.h) was updated to support baremetal and not be dependent on FreeRTOS
    • portmacro and rm_wifi_config header files were wrapped to check for FreeRTOS
    • Wi-Fi configuration macros were included and wrapped to check for baremetal
    • WIFI_IsConnected() function return type was changed from BaseType_t to WIFI_Return Code_t to remove FreeRTOS dependency
    • Users will need to change their return value check (success return value changed from 1 to 0)

Known Issues

  • RA0E1:
    • e2 studio projects automatically reset compiler optimization to a Size setting on every generate or build operation
      • Add optimization flags (e.g. `-O0`) manually to "Other optimization flags" to override the `-Oz` setting
    • HS400x, ZMOD4xxx and OB1203 sensors cannot be used on RA0E1
    • FS1015 and FS3000 sensors do not support SAU-I2C driver
  • Selecting 'Safely Remove Hardware and Eject Media' on Windows and eject the mass storage (PMSC), when using USBX composite device (PCDC+PMSC), the Windows Explorer for PMSC does not disappear.
  • PMSC may not work properly when USBX Composite Device (PCDC+PMSC) is connected to specific Linux OS (USB Host).

Visit GitHub Issues for this project.

Target Devices

Downloads

Type Title Date
Software & Tools - Software 简体中文
Software & Tools - Software 简体中文
Software & Tools - Software 简体中文
Software & Tools - Software 简体中文
4 items

Documentation

Design & Development

Sample Code

Related Boards & Kits

Boards & Kits

e² studio Tips - How to Import Example Project in e² studio for RA

This video shows how to import the Renesas RA Flat project and TrustZone project in e² studio.

e² studio Tips - How to Import Example Project in e² studio for RA
0:00:00 Opening
0:00:14 Flat Project and TrustZone Project
0:00:34 Set up IDE
0:00:54 Download Example Project
0:01:07 Import Flat Project
0:02:44 Import TrustZone Project
0:04:30 e² studio User Guide

Additional Details

Components

  • CMSIS compliant pack files for e2 studio integrated development environment
  • BSPs for RA MCUs and boards
  • HAL drivers to access peripherals
  • Real Time Operating Systems (RTOS)
  • Middleware stacks and protocols
  • Module configurators and code generators
  • Source files to integrate with any development environment and third-party tools

Supported Toolchains

Software components in the FSP support following toolchains:

  • e2 studio Integrated Development Environment, with toolchain supports of GCC Arm Embedded and LLVM Embedded Toolchain for Arm
  • IAR Embedded Workbench
  • Arm Keil MDK

Software Installation Instructions

Refer to the FSP GitHub page for installation and usage instructions: FSP GitHub Instructions

e2 studio Integrated Development Environment

The FSP provides a host of efficiency-enhancing tools for developing projects targeting the Renesas RA series of MCU devices. The e2 studio Integrated Development Environment provides a familiar development cockpit from which the key steps of project creation, module selection and configuration, code development, code generation, and debugging are all managed. FSP uses a Graphical User Interface (GUI) to simplify the selection, configuration, code generation and code development of high level modules and their associated Application Program Interfaces (APIs) to dramatically accelerate the development process.

e2 studio is equipped with set of options to configure various aspects of your application project. Some of these options include:

BSP configuration

Configure or change MCU and board-specific parameters from the initial project selection.

Clock Configuration

Configure the MCU clock settings for your project. The Clock Configuration presents a graphical view of the MCU's clock tree, allowing the various clock dividers and sources to be modified.

Pin Configuration

The Pin Configuration provides flexible configuration of the MCU's pins. This configures the electrical characteristics and functions of each port pin. As many pins are able to provide multiple functions, the pin configurator makes it easy to configure the pins on a peripheral basis. The Pin Configuration tool simplifies the configuration of large packages with highly multiplexed pins by highlighting errors and presenting the options for each pin or for each peripheral.

Module Configuration

The Module Configuration provides options to add FSP modules (HAL drivers, Middleware stacks and RTOS) for RTOS and non-RTOS based applications and configure various parameters of the modules. For each module selected, the Properties window provides access to the configuration parameters, interrupt priorities, pin selections etc.

Interrupt Configuration

Interrupt Configuration allows to add new user interrupts or events and set interrupt priorities. This will also allow the user to bypass a peripheral interrupt and have user-defined ISRs for the peripheral interrupts.

Components Configuration

The Components configuration enables the individual modules required by the application to be included or excluded. All modules that are necessary for the modules added to the application are included automatically. You can easily include or exclude additional modules by ticking the box next to the required component.

QE Tools

QE for Capacitive Touch is an assistance tool for applications which operate under the e2 studio. For the development of embedded systems that work with capacitive touch sensors, this tool simplifies the initial settings of the touch user interface and the tuning of the sensitivity, thus shortening developing times.

The QE for BLE is a dedicated tool for developing embedded software in systems which support the Bluetooth®low energy protocol stack. This solution toolkit runs in the e2 studio integrated development environment. The combination of the e2 studio and QE for BLE makes it easy to test the communications features of Bluetooth®low energy.

Other Tool Features

  • Context-sensitive Autocomplete feature that provides intelligent options for completing a programming element
  • Developer Assistance tool for selection of and drag and drop placement of API functions directly in application code
  • Smart Manual that provides driver and device documentation in the form of tooltips right in the code
  • Edit Hover feature to show detailed descriptions of code elements while editing
  • Welcome Window with links to example projects, application notes and a variety of other self-help support resources
  • Information Icon for each module is provided in the graphic configuration viewer that links to specific design resources for that module in the user manual.

Third Party Tool Support

In addition to the Renesas e2 studio IDE, FSP supports third party tools and IDEs as well. This support is provided through RA Smart configurators (RASC) application. The Renesas RA Smart Configurator is a desktop application that allows you to configure the software system (BSP, drivers, RTOS and middleware) for a Renesas RA microcontroller when using a 3rd-party IDE and toolchain. The RA Smart Configurator can currently be used with IAR Embedded Workbench, Keil MDK and the Arm compiler 6 toolchains.