Skip to content

Commit

Permalink
Release v5.5.0
Browse files Browse the repository at this point in the history
  • Loading branch information
renesas-fsp-development committed Aug 29, 2024
1 parent 5e538cf commit 3fb7603
Show file tree
Hide file tree
Showing 303 changed files with 127,262 additions and 5,986 deletions.
65 changes: 65 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Contributing to FSP for Renesas RA MCU Family

Thank you for your interest in contributing to FSP for RA. This document will help you navigate the contribution process.

## Table of Contents

- [Bug Reports](#bug-reports)
- [Feature/Enhancement Requests](#featureenhancement-requests)
- [Contributing Code](#contributing-code)
- [Signing Contributor License Agreement](#signing-contributor-license-agreement)
- [Contributing through a Pull Request](#contributing-through-a-pull-request)
- [Technical support](#technical-support)

## Bug Reports

If the bug is a security vulnerability, follow the instructions for reporting a vulnerability [here](https://github.com/renesas/fsp/security).

For all other bugs, [create a Github issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue). To help us reproduce and address the bug, please include the following information:

- Expected behavior
- Actual behavior
- Steps to reproduce
- Logs/screenshots/measurements (if relevant to the issue)

An FSP maintainer will review the issue and follow up in a comment.

## Feature/Enhancement Requests

We consider all feature requests made through [Github issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue).

- The FSP team will review your request and may respond with follow-up questions.
- If we determine the feature is a good fit for FSP, we will prioritize and assign it internally.
- When work begins on a feature, we will add a comment to the issue.
- When the feature is included in an FSP release, we will close the issue and add a comment containing the release version that contains the feature.
- Unfortunately, not all feature requests can be implemented. Issues that will not be implemented (ex. not feasible, not a good fit for FSP, insufficient details) will be closed.

If you would like to implement a feature request made by someone else, and work has not already started on that issue, please comment on the issue that you would like to work on it, and your plan for implementation. Then follow the [Contributing Code](#contributing-code) process to make the updates.

## Contributing Code

### Signing Contributor License Agreement

We require community contributors to sign a Contributor License Agreement (CLA). If you or your organization haven't previously signed, a bot comment will prompt you to sign the CLA when you create a pull request.

Ensure a CLA has been signed for your GitHub account by checking the [CLA page](https://cla-assistant.io/renesas/fsp).

### Contributing through a Pull Request

We welcome contributions via Github Pull Requests. If you're interested in contributing, please follow these steps:

1. Make sure the code change is relevant to FSP for the Renesas RA MCU Family
1. Search the Github issues (including closed issues) to confirm the change is not a duplicate of another issue
1. [Create a GitHub issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue) with details of the proposed features or improvements or comment the planned changes on the existing issue (if applicable)
- The FSP team will review the plan and either approve it or suggest changes as needed.
- We highly recommend waiting for FSP team approval for all substantial changes, however if your change is very straightforward (ex. 1-line bug fix), you can make a PR without waiting for approval.
1. [Fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) to your GitHub account for the feature development.
- Once development is complete, create a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork).
1. The FSP team will review your PR, ask questions if we have any, and perform internal integration and testing.
- When the change is accepted, we will let you know in a Github comment and close the pull request.

**Important:** If you are contributing multiple independent features/bug fixes, please submit a separate pull request for each item.

## Technical Support

Need help with something other than RA FSP? For general support requests or questions related to Renesas products, tools, or environments, feel free to submit a ticket in our support [system](https://www.renesas.com/us/en/support). We're here to help!
9 changes: 7 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ FSP uses an open software ecosystem and provides flexibility in using your prefe

### Current Release

[FSP v5.4.0](https://github.com/renesas/fsp/releases/tag/v5.4.0)
[FSP v5.5.0](https://github.com/renesas/fsp/releases/tag/v5.5.0)

### Supported RA MCU Kits

Expand Down Expand Up @@ -54,6 +54,10 @@ FSP uses an open software ecosystem and provides flexibility in using your prefe
- MCK-RA8T1
- RSSK-RA2L1
- RSSK-RA6T1
- VK-RA8M1
- VOICE-RA2L1
- VOICE-RA4E1
- VOICE-RA6E1

### Supported Software Packaged with FSP

Expand Down Expand Up @@ -96,14 +100,15 @@ It is important to note that updates for Azure RTOS on these hardware will no lo
- FSP versions of 5.0.0 and later require a minimum e² studio version of 2023-10.
- FSP versions of 5.2.0 and later require a minimum e² studio version of 2024-01.1.
- FSP versions of 5.3.0 and later require a minimum e² studio version of 2024-04.
- FSP versions of 5.5.0 and later require a minimum e² studio version of 2024-07.

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, FSP_Packs_\<version\>.zip, that will work on any supported OS. There is also a self-extracting installer version, FSP_Packs_\<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](https://github.com/renesas/fsp/releases/tag/v5.4.0).
1. Download the FSP with e² studio Installer from the Assets section of the [current release](https://github.com/renesas/fsp/releases/tag/v5.5.0).
2. Run the installer. This will install the e² studio tool, FSP packs, GCC toolchain 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 ####
Expand Down
25 changes: 18 additions & 7 deletions SUPPORTED_SOFTWARE.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,13 +175,15 @@
* [BLE Mesh Network (rm_ble_mesh_network)](https://renesas.github.io/fsp/group___r_m___b_l_e___m_e_s_h___n_e_t_w_o_r_k.html)
* [BLE Mesh Provision (rm_ble_mesh_provision)](https://renesas.github.io/fsp/group___r_m___b_l_e___m_e_s_h___p_r_o_v_i_s_i_o_n.html)
* [BLE Mesh Upper Trans (rm_ble_mesh_upper_trans)](https://renesas.github.io/fsp/group___r_m___b_l_e___m_e_s_h___u_p_p_e_r___t_r_a_n_s.html)
* [AWS Cellular Interface on GM (rm_cellular_gm_aws)](https://renesas.github.io/fsp/group___r_m___c_e_l_l_u_l_a_r___r_y_z___a_w_s.html)
* [AWS Cellular Interface on RYZ (rm_cellular_ryz_aws) [Deprecated]](https://renesas.github.io/fsp/group___r_m___c_e_l_l_u_l_a_r___r_y_z___a_w_s.html)
* [AWS Core HTTP](https://docs.aws.amazon.com/freertos/latest/userguide/core-http.html)
* [AWS Core MQTT](https://docs.aws.amazon.com/freertos/latest/userguide/coremqtt.html)
* [AWS IoT Over-the-air Update Library](https://github.com/aws/ota-for-aws-iot-embedded-sdk)
* [AWS Transport Interface on MbedTLS/PKCS11 (rm_aws_transport_interface_port)](https://docs.aws.amazon.com/embedded-csdk/latest/lib-ref/libraries/standard/coreMQTT/docs/doxygen/output/html/mqtt_transport_interface.html)
* [Azure EWF Adapter on RYZ014A [Deprecated]](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___r_y_z.html)
* [Azure EWF Adapter on RYZ024A [Deprecated]](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___r_y_z.html)
* [Azure EWF Adapter on GM02S](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___g_m.html)
* [Azure EWF Adapter on RYZ014A [Deprecated]](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___g_m.html)
* [Azure EWF Adapter on RYZ024A [Deprecated]](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___g_m.html)
* [Azure RTOS NetX Duo Auto IP](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/netx-duo/netx-duo-auto-ip/chapter1.md)
* [Azure RTOS NetX Duo BSD Support](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/netx-duo/netx-duo-bsd/chapter1.md)
* [Azure RTOS NetX Duo Common](https://github.com/eclipse-threadx/rtos-docs/blob/main/rtos-docs/netx-duo/index.md)
Expand Down Expand Up @@ -217,14 +219,16 @@
* [FreeRTOS+TCP](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html)
* [GTL BLE Abstraction (rm_ble_abs_gtl)](https://renesas.github.io/fsp/group___b_l_e___a_b_s.html)
* [HTTP Client on DA16XXX (rm_http_onchip_da16xxx)](https://renesas.github.io/fsp/group___h_t_t_p___o_n_c_h_i_p___d_a16_x_x_x.html)
* [LwIP system FreeRTOS port](https://www.nongnu.org/lwip/2_1_x/index.html)
* [MQTT Client on DA16XXX (rm_mqtt_onchip_da16xxx)](https://renesas.github.io/fsp/group___m_q_t_t___o_n_c_h_i_p___d_a16_x_x_x.html)
* [PTP (r_ptp)](https://renesas.github.io/fsp/group___p_t_p.html)
* [SPP BLE Abstraction (rm_ble_abs_spp)](https://renesas.github.io/fsp/group___b_l_e___a_b_s.html)
* [lwIP tcpip (lwip_tcpip)](https://www.nongnu.org/lwip/2_1_x/index.html)
* Power
* [Low Power Modes (r_lpm)](https://renesas.github.io/fsp/group___l_p_m.html)
* RTOS
* [Azure RTOS ThreadX Port (rm_threadx_port)](https://renesas.github.io/fsp/group___r_m___t_h_r_e_a_d_x___p_o_r_t.html)
* [FreeRTOS Buffer Allocation 2](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/Embedded_Ethernet_Buffer_Management.html)
* [FreeRTOS Buffer Allocation 2](https://www.freertos.org/Documentation/03-Libraries/02-FreeRTOS-plus/02-FreeRTOS-plus-TCP/05-Buffer-management)
* [FreeRTOS Heap 1](https://www.freertos.org/a00111.html#heap_1)
* [FreeRTOS Heap 2](https://www.freertos.org/a00111.html#heap_2)
* [FreeRTOS Heap 3](https://www.freertos.org/a00111.html#heap_3)
Expand All @@ -245,11 +249,11 @@
* [Trusted Firmware-M Non-Secure](https://tf-m-user-guide.trustedfirmware.org/)
* Sensor
* [FS1015 Flow Sensor (rm_fs1015)](https://renesas.github.io/fsp/group___r_m___f_s1015.html)
* [FS2012 Flow Sensor (rm_fs2012)](https://renesas.github.io/fsp/group___r_m___f_s2012.html)
* [FS2012 Flow Sensor (rm_fs2012) [Deprecated]](https://renesas.github.io/fsp/group___r_m___f_s2012.html)
* [FS3000 Flow Sensor (rm_fs3000)](https://renesas.github.io/fsp/group___r_m___f_s3000.html)
* [HS300X Temperature/Humidity Sensor (rm_hs300x)](https://renesas.github.io/fsp/group___r_m___h_s300_x.html)
* [HS400X Temperature/Humidity Sensor (rm_hs400x)](https://renesas.github.io/fsp/group___r_m___h_s400_x.html)
* [OB1203 Light/Proximity/PPG Sensor (rm_ob1203)](https://renesas.github.io/fsp/group___r_m___o_b1203.html)
* [OB1203 Light/Proximity/PPG Sensor (rm_ob1203) [Deprecated]](https://renesas.github.io/fsp/group___r_m___o_b1203.html)
* [RRH46410 Gas Sensor Module (rm_rrh46410)](https://renesas.github.io/fsp/group___r_m___r_r_h46410.html)
* [ZMOD4XXX Gas Sensor (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* Storage
Expand Down Expand Up @@ -347,6 +351,7 @@
* [AWS PKCS11 to MbedTLS](https://docs.aws.amazon.com/freertos/latest/userguide/security-pkcs.html)
* [AWS Silex WiFi Sockets Wrapper (rm_aws_sockets_wrapper_silex)](https://docs.aws.amazon.com/embedded-csdk/latest/lib-ref/libraries/standard/coreMQTT/docs/doxygen/output/html/mqtt_transport_interface.html)
* [AWS TCP Sockets Wrapper](https://docs.aws.amazon.com/embedded-csdk/latest/lib-ref/libraries/standard/coreMQTT/docs/doxygen/output/html/mqtt_transport_interface.html)
* [Azure EWF Adapter on GM01Q](https://renesas.github.io/fsp/group___r_m___a_z_u_r_e___e_w_f___g_m.html)
* [Azure EWF Heap Allocator](https://azure.github.io/embedded-wireless-framework/html/index.html)
* [Azure EWF Interface on r_uart](https://azure.github.io/embedded-wireless-framework/html/index.html)
* [Azure EWF Memory Pool Allocator](https://azure.github.io/embedded-wireless-framework/html/index.html)
Expand Down Expand Up @@ -380,11 +385,15 @@
* [WiFi Common](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html)
* [WiFi DA16XXX Framework Driver (rm_wifi_da16xxx)](https://renesas.github.io/fsp/group___w_i_f_i___d_a16_x_x_x.html)
* [WiFi Onchip Silex Driver using UART (rm_wifi_onchip_silex)](https://renesas.github.io/fsp/group___w_i_f_i___o_n_c_h_i_p___s_i_l_e_x.html)
* [lwIP Wrapper to r_ether (rm_lwip_ether)](https://renesas.github.io/fsp/group___r_m___l_w_i_p___e_t_h_e_r.html)
* [lwIP system baremetal (rm_lwip_sys_baremetal)](https://renesas.github.io/fsp/group___r_m___l_w_i_p___s_y_s___b_a_r_e_m_e_t_a_l.html)
* [lwIP system freertos Ethernet (rm_lwip_sys_freertos)](https://renesas.github.io/fsp/group___r_m___l_w_i_p___s_y_s___f_r_e_e_r_t_o_s.html)
* Security
* [Azure RTOS NetX Crypto HW Acceleration (rm_netx_secure_crypto)](https://renesas.github.io/fsp/group___r_m___n_e_t_x___s_e_c_u_r_e___c_r_y_p_t_o.html)
* [Azure RTOS NetX Crypto Software Only](https://renesas.github.io/fsp/group___r_m___n_e_t_x___s_e_c_u_r_e___c_r_y_p_t_o.html)
* [Crypto AES2](https://renesas.github.io/fsp/)
* [Crypto RA2](https://renesas.github.io/fsp/)
* [Crypto RSIP E11A](https://renesas.github.io/fsp/)
* [FreeRTOS MbedTLS Port](https://renesas.github.io/fsp/)
* [Key Injection for PSA Crypto](https://renesas.github.io/fsp/group___s_c_e___k_e_y___i_n_j_e_c_t_i_o_n.html)
* [MCUBoot TinyCrypt H/W Acceleration (rm_mcuboot_tinycrypt_port)](https://renesas.github.io/fsp/group___r_m___t_i_n_y_c_r_y_p_t___p_o_r_t.html)
Expand Down Expand Up @@ -413,13 +422,14 @@
* [ZMOD4410 IAQ 1st Generation (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 IAQ 2nd Generation (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 IAQ 2nd Generation Ultra Low Power (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 Odor (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 Odor (rm_zmod4xxx) [Deprecated]](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 PBAQ (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 Relative IAQ (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 Relative IAQ Ultra Low Power (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4410 Sulfur-based Odor (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4450 RAQ (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4510 OAQ 1st Generation (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4510 NO2 O3 (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4510 OAQ 1st Generation (rm_zmod4xxx) [Deprecated]](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* [ZMOD4510 OAQ 2nd Generation (rm_zmod4xxx)](https://renesas.github.io/fsp/group___r_m___z_m_o_d4_x_x_x.html)
* Storage
* [AWS OTA PAL (rm_aws_ota_pal_mcuboot)](https://renesas.github.io/fsp/group___r_m___a_w_s___o_t_a___p_a_l___m_c_u_b_o_o_t.html)
Expand All @@ -430,6 +440,7 @@
* [FreeRTOS+FAT Port for RA (rm_freertos_plus_fat)](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_FAT/index.html)
* [LevelX NOR Port (rm_levelx_nor_spi)](https://renesas.github.io/fsp/group___r_m___l_e_v_e_l_x___n_o_r___s_p_i.html)
* [LittleFS on Flash (rm_littlefs_flash)](https://renesas.github.io/fsp/group___r_m___l_i_t_t_l_e_f_s___f_l_a_s_h.html)
* [LittleFS on SPI Flash (rm_littlefs_spi_flash)](https://renesas.github.io/fsp/group___r_m___l_i_t_t_l_e_f_s___f_l_a_s_h.html)
* System
* [Arm CMSIS6 Core (M)](https://arm-software.github.io/CMSIS_6/latest/Core/index.html)
* Timers
Expand Down
47 changes: 47 additions & 0 deletions ra/board/ra2l1_voice/board.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
/*
* Copyright (c) 2020 - 2024 Renesas Electronics Corporation and/or its affiliates
*
* SPDX-License-Identifier: BSD-3-Clause
*/

/*******************************************************************************************************************//**
* @ingroup BOARDS
* @defgroup BOARD_RA2L1_VOICE for the RA2L1-VOICE board
* @brief BSP for the RA2L1-VOICE Board
*
* The RA2L1-VOICE is a development kit for the Renesas R7FA2L1AB3CFL microcontroller in a LQFP48 package.
*
* @{
**********************************************************************************************************************/

#ifndef BOARD_H
#define BOARD_H

/***********************************************************************************************************************
* Includes <System Includes> , "Project Includes"
**********************************************************************************************************************/

/* BSP Board Specific Includes. */
#include "board_init.h"
#include "board_leds.h"

/***********************************************************************************************************************
* Macro definitions
**********************************************************************************************************************/
#define BOARD_RA2L1_VOICE

/***********************************************************************************************************************
* Typedef definitions
**********************************************************************************************************************/

/***********************************************************************************************************************
* Exported global variables
**********************************************************************************************************************/

/***********************************************************************************************************************
* Exported global functions (to be accessed by other files)
**********************************************************************************************************************/

/** @} (end defgroup BOARD_RA2L1_VOICE) */

#endif
Loading

0 comments on commit 3fb7603

Please sign in to comment.