Skip to content

Commit

Permalink
Release v2.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
renesas-fsp-development committed Oct 6, 2020
1 parent a678257 commit 560904f
Show file tree
Hide file tree
Showing 348 changed files with 153,447 additions and 67,124 deletions.
18 changes: 13 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,36 @@

## 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, FreeRTOS, and portable middleware stacks.
FSP includes best-in-class HAL drivers with high performance and low memory footprint. Middleware stacks with 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.
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.
FSP uses an open software ecosystem and provides flexibility in using your preferred RTOS, legacy code, and third-party ecosystem solutions.

Download the latest FSP version from the [Releases page](https://github.com/renesas/fsp/releases).

### Supported RA MCU Kits

- EK-RA2A1
- EK-RA4M1
- EK-RA4W1
- EK-RA6M1
- EK-RA6M2
- EK-RA6M3
- EK-RA6M3G
- EK-RA6M4

### Setup Instructions

#### For existing users that are using FSP with e² studio

FSP versions of 2.0.0 and later require a minimum e² studio version of 2020-10.

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, and an installer version, FSP_Packs_\<version\>.exe.

#### For new users that are using FSP with e² studio

1. Download the FSP with e² studio Installer from the Assets section of the [latest release](https://github.com/renesas/fsp/releases).
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.

Expand All @@ -34,9 +39,12 @@ If you have already installed a previous FSP release that included e² studio th
1. See [RA SC User Guide for MDK and IAR](https://renesas.github.io/fsp/_s_t_a_r_t__d_e_v.html#RASC-MDK-IAR-user-guide).

### Starting Development
1. Open e² studio and click File > New > RA C/C++ Project.

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
Expand All @@ -53,4 +61,4 @@ Example Projects : www.renesas.com/ra/example-projects

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

Support: www.renesas.com/support
Support: www.renesas.com/support
62 changes: 62 additions & 0 deletions ra/board/ra6m4_ek/board.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
/***********************************************************************************************************************
* Copyright [2020] Renesas Electronics Corporation and/or its affiliates. All Rights Reserved.
*
* This software and documentation are supplied by Renesas Electronics America Inc. and may only be used with products
* of Renesas Electronics Corp. and its affiliates ("Renesas"). No other uses are authorized. Renesas products are
* sold pursuant to Renesas terms and conditions of sale. Purchasers are solely responsible for the selection and use
* of Renesas products and Renesas assumes no liability. No license, express or implied, to any intellectual property
* right is granted by Renesas. This software is protected under all applicable laws, including copyright laws. Renesas
* reserves the right to change or discontinue this software and/or this documentation. THE SOFTWARE AND DOCUMENTATION
* IS DELIVERED TO YOU "AS IS," AND RENESAS MAKES NO REPRESENTATIONS OR WARRANTIES, AND TO THE FULLEST EXTENT
* PERMISSIBLE UNDER APPLICABLE LAW, DISCLAIMS ALL WARRANTIES, WHETHER EXPLICITLY OR IMPLICITLY, INCLUDING WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT, WITH RESPECT TO THE SOFTWARE OR
* DOCUMENTATION. RENESAS SHALL HAVE NO LIABILITY ARISING OUT OF ANY SECURITY VULNERABILITY OR BREACH. TO THE MAXIMUM
* EXTENT PERMITTED BY LAW, IN NO EVENT WILL RENESAS BE LIABLE TO YOU IN CONNECTION WITH THE SOFTWARE OR DOCUMENTATION
* (OR ANY PERSON OR ENTITY CLAIMING RIGHTS DERIVED FROM YOU) FOR ANY LOSS, DAMAGES, OR CLAIMS WHATSOEVER, INCLUDING,
* WITHOUT LIMITATION, ANY DIRECT, CONSEQUENTIAL, SPECIAL, INDIRECT, PUNITIVE, OR INCIDENTAL DAMAGES; ANY LOST PROFITS,
* OTHER ECONOMIC DAMAGE, PROPERTY DAMAGE, OR PERSONAL INJURY; AND EVEN IF RENESAS HAS BEEN ADVISED OF THE POSSIBILITY
* OF SUCH LOSS, DAMAGES, CLAIMS OR COSTS.
**********************************************************************************************************************/

/*******************************************************************************************************************//**
* @ingroup BOARDS
* @defgroup BOARD_RA6M4_EK BSP for the RA6M4-EK board
* @brief BSP for the RA6M4-EK Board
*
* The RA6M4_EK is a development kit for the Renesas R7FA6M4AF3CFB microcontroller in a LQFP144 package.
*
* @{
**********************************************************************************************************************/

#ifndef BOARD_H
#define BOARD_H

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

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

/***********************************************************************************************************************
* Macro definitions
**********************************************************************************************************************/
#define BOARD_RA6M4_EK

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

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

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

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

#endif
Original file line number Diff line number Diff line change
Expand Up @@ -18,31 +18,43 @@
* OF SUCH LOSS, DAMAGES, CLAIMS OR COSTS.
**********************************************************************************************************************/

/////////////////////////////////////////////////////////////////////////////////////////
// <SC32#4 initialization2> //
// Procedure number: 02 //
// File name : SC324_p02.prc //
// State Diagram : main(FSM1) //
// Start State : main01 //
// End State : Pass :main03, Retry :main01 //
// Input Data : void //
// Output Data : void //
// Return value : Pass, Retry, Resource_Conflict //
// -------------------------------------------------------------------------------------//
// total cycle : polling + write access + read access //
// polling : cycle //
// polling access : times //
// write access : times //
// read access : times //
/////////////////////////////////////////////////////////////////////////////////////////

#include "hw_sce_private.h"
#include "fsp_common_api.h"

/*******************************************************************************************************************//**
* TSIP Initialization2
* @retval FSP_SUCCESS The operation completed successfully.
* @ingroup BOARD_RA6M4_EK
* @defgroup BOARD_RA6M4_EK_ETHERNET_PHY Board Ethernet Phy
* @brief Ethernet Phy information for this board.
*
* This is code specific to the RA6M4_EK board.
*
* @{
**********************************************************************************************************************/

#ifndef BSP_ETHERNET_PHY_H
#define BSP_ETHERNET_PHY_H

/** Common macro for FSP header files. There is also a corresponding FSP_FOOTER macro at the end of this file. */
FSP_HEADER

/***********************************************************************************************************************
* Macro definitions
**********************************************************************************************************************/
#define BOARD_PHY_TYPE (1)
#define BOARD_PHY_REF_CLK (1)

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

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

/***********************************************************************************************************************
* Public Functions
**********************************************************************************************************************/
fsp_err_t HW_SCE_Initialization2 () {
return FSP_SUCCESS;
}

/** Common macro for FSP header files. There is also a corresponding FSP_HEADER macro at the top of this file. */
FSP_FOOTER

#endif

/** @} (end defgroup BOARD_RA6M4_EK_ETHERNET_PHY) */
62 changes: 62 additions & 0 deletions ra/board/ra6m4_ek/board_init.c
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
/***********************************************************************************************************************
* Copyright [2020] Renesas Electronics Corporation and/or its affiliates. All Rights Reserved.
*
* This software and documentation are supplied by Renesas Electronics America Inc. and may only be used with products
* of Renesas Electronics Corp. and its affiliates ("Renesas"). No other uses are authorized. Renesas products are
* sold pursuant to Renesas terms and conditions of sale. Purchasers are solely responsible for the selection and use
* of Renesas products and Renesas assumes no liability. No license, express or implied, to any intellectual property
* right is granted by Renesas. This software is protected under all applicable laws, including copyright laws. Renesas
* reserves the right to change or discontinue this software and/or this documentation. THE SOFTWARE AND DOCUMENTATION
* IS DELIVERED TO YOU "AS IS," AND RENESAS MAKES NO REPRESENTATIONS OR WARRANTIES, AND TO THE FULLEST EXTENT
* PERMISSIBLE UNDER APPLICABLE LAW, DISCLAIMS ALL WARRANTIES, WHETHER EXPLICITLY OR IMPLICITLY, INCLUDING WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT, WITH RESPECT TO THE SOFTWARE OR
* DOCUMENTATION. RENESAS SHALL HAVE NO LIABILITY ARISING OUT OF ANY SECURITY VULNERABILITY OR BREACH. TO THE MAXIMUM
* EXTENT PERMITTED BY LAW, IN NO EVENT WILL RENESAS BE LIABLE TO YOU IN CONNECTION WITH THE SOFTWARE OR DOCUMENTATION
* (OR ANY PERSON OR ENTITY CLAIMING RIGHTS DERIVED FROM YOU) FOR ANY LOSS, DAMAGES, OR CLAIMS WHATSOEVER, INCLUDING,
* WITHOUT LIMITATION, ANY DIRECT, CONSEQUENTIAL, SPECIAL, INDIRECT, PUNITIVE, OR INCIDENTAL DAMAGES; ANY LOST PROFITS,
* OTHER ECONOMIC DAMAGE, PROPERTY DAMAGE, OR PERSONAL INJURY; AND EVEN IF RENESAS HAS BEEN ADVISED OF THE POSSIBILITY
* OF SUCH LOSS, DAMAGES, CLAIMS OR COSTS.
**********************************************************************************************************************/

/*******************************************************************************************************************//**
* @addtogroup BOARD_RA6M4_EK
*
* @{
**********************************************************************************************************************/

/***********************************************************************************************************************
* Includes <System Includes> , "Project Includes"
**********************************************************************************************************************/
#include "bsp_api.h"

#if defined(BOARD_RA6M4_EK)

/***********************************************************************************************************************
* Macro definitions
**********************************************************************************************************************/

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

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

/***********************************************************************************************************************
* Private global variables and functions
**********************************************************************************************************************/

/*******************************************************************************************************************//**
* @brief Performs any initialization specific to this BSP.
*
* @param[in] p_args Pointer to arguments of the user's choice.
**********************************************************************************************************************/
void bsp_init (void * p_args)
{
FSP_PARAMETER_NOT_USED(p_args);
}

#endif

/** @} (end addtogroup BOARD_RA6M4_EK) */
Original file line number Diff line number Diff line change
Expand Up @@ -18,31 +18,41 @@
* OF SUCH LOSS, DAMAGES, CLAIMS OR COSTS.
**********************************************************************************************************************/

//////////////////////////////////////////////////////////////////////////
// <SC32#7 Secure Boot procedure> //
// Procedure number: 99 //
// File name : SC327_p99.prc //
// State Diagram : main(FSM1) //
// Start State : main02 //
// End State : main03 //
// Input Data : void //
// Output Data : void //
// Return value : Pass, Resource_Conflict //
// ----------------------------------------------------------------------//
// total cycle : polling + write access + read access //
// polling : TBD //
// polling access : TBD //
// write access : TBD //
// read access : TBD //
//////////////////////////////////////////////////////////////////////////

#include "SCE_ProcCommon.h"
#include "hw_sce_private.h"

/*******************************************************************************************************************//**
* Secure Boot procedure
* @retval FSP_SUCCESS The operation completed successfully.
* @addtogroup BOARD_RA6M4_EK
* @brief Board specific code for the RA6M4-EK Board
*
* This include file is specific to the RA6M4-EK board.
*
* @{
**********************************************************************************************************************/

#ifndef BOARD_INIT_H
#define BOARD_INIT_H

/** Common macro for FSP header files. There is also a corresponding FSP_FOOTER macro at the end of this file. */
FSP_HEADER

/***********************************************************************************************************************
* Macro definitions
**********************************************************************************************************************/

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

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

/***********************************************************************************************************************
* Exported global functions (to be accessed by other files)
**********************************************************************************************************************/
fsp_err_t HW_SCE_secureBoot (void) {
return FSP_SUCCESS;
}
void bsp_init(void * p_args);

/** Common macro for FSP header files. There is also a corresponding FSP_HEADER macro at the top of this file. */
FSP_FOOTER

#endif

/** @} (end addtogroup BOARD_RA6M4_EK) */
Loading

0 comments on commit 560904f

Please sign in to comment.