renesas / fsp

Flexible Software Package (FSP) for Renesas RA MCU Family
https://renesas.github.io/fsp/
Other
201 stars 82 forks source link
fsp renesas

Overview

Flexible Software Package (FSP) for Renesas RA MCU Family

FSP is the next generation Arm® MCU software package from Renesas, that enables secure devices and IoT connectivity through production ready peripheral drivers, Azure RTOS or FreeRTOS, and portable 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 implementation of complex modules like communication and security. The e² studio ISDE 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 your preferred RTOS, legacy code, and third-party ecosystem solutions.

Current Release

FSP v5.6.0

Supported RA MCU Kits

Supported Software Packaged with FSP

For a list of software modules packaged with FSP, see Supported Software.

Important Notice Regarding Azure RTOS

On November 21, 2023, Microsoft announced that they have decided to contribute Azure RTOS to open source under the stewardship of the Eclipse foundation and Azure RTOS will become Eclipse ThreadX. For detailed information, please refer to the announcement at Microsoft Contributes Azure RTOS to Open Source.

The support strategy scheme for Eclipse ThreadX will be determined and communicated at a later date. Microsoft will discontinue the Azure RTOS and Azure RTOS Middleware under the existing agreement LICENSED-HARDWARE.txt.

It is important to note that updates for Azure RTOS on these hardware will no longer be provided.

Product Security Advisories

Product Security Advisories for FSP and third party software (where available) are tagged with the 'product_security_advisory' label. Please check these issues for information from the respective vendors for affected versions and a recommended workaround or patch upgrade.

Known Issues

Visit GitHub Issues for this project.

Critical issues that cause an MCU to operate out of the hardware manual documented specifications are tagged with the 'critical' label. Please check critical issues before going to production for a workaround or recommended patch upgrade.

Setup Instructions

For existing users that are using FSP with e² studio

If you have already installed a previous FSP release that included e² studio then you can download the packs separately. These are available for download under the Assets section for each release. There is a zipped version, FSPPacks\<version>.zip, that will work on any supported OS. There is also a self-extracting installer version, FSPPacks\<version>.exe, that will work on Windows.

When using the zipped version of the packs the zip file should be extracted into the e² studio support area. This directory is typically found under the user's home directory with a path such as ~/.eclipse/com.renesas.platform_2047834950. The number on the end of the path is unique to each e² studio installation. If you have two e² studio installations then you will have two directories with names of the format ~/.eclipse/com.renesas.platform_<unique_number>. Please note that e² studio must have been run at least once for this directory to be created. You can find the support area for a particular e² studio installation by clicking Help >> About e² studio. In the window that pops up click Installation Details and choose the Support Folders tab. The e² studio support area path will be shown.

For new users that are using FSP with e² studio

  1. Download the FSP with e² studio Installer from the Assets section of the current release.
  2. Run the installer. This will install the e² studio tool, FSP packs, chosen toolchains (GCC and/or LLVM) and other tools required to use this software. No additional installations are required.

If using RA Smart Configurator (RASC) with IAR Embedded Workbench or Keil MDK

  1. See RASC User Guide for MDK and IAR.

Starting Development

  1. Open e² studio and click File > New > C/C++ Project.
  2. In the window that pops up, choose Renesas RA in the left pane.

Related Links

FSP Releases : https://github.com/renesas/fsp/releases

FSP Documentation : https://renesas.github.io/fsp

FSP Webpage: www.renesas.com/ra/fsp

RA Product Information: www.renesas.com/ra

RA Product Support Forum: www.renesas.com/ra/forum

e² studio : www.renesas.com/e2studio

Example Projects : https://github.com/renesas/ra-fsp-examples

Knowledge Base: https://en-support.renesas.com/knowledgeBase/category/31087

Support: www.renesas.com/support