View source for Using embOS with Renesas RA family, Flexible Software Package (FSP) and IAR

==Introduction==
The [https://github.com/renesas/fsp Renesas Flexible Software Package] (FSP) is an enhanced software package designed to provide easy-to-use, scalable, high-quality software for embedded system designs using Renesas RA family of Arm Microcontrollers.

This Wiki describes how to add embOS Cortex-M IAR to an existing Renesas FSP project.
With the resulting project you can still use the Renesas Smart Configurator.
The following description uses Renesas FSP 3.1 and Renesas Smart Configurator 2021-04.

[[File:RA_SmartConfigurator_version.png]]

==Generate the Renesas FSP project== 
Start the Renesas Smart Configurator and create a new IAR EWARM project with the following options. 
Project name and location are up to you. 
This Wiki article assumes the project is created within an [https://www.segger.com/downloads/embos/ embOS shipment] in ''c:\Work\embOS_CortexM_IAR_V8_Free_V5.14.0.0\Start\BoardSupport\Renesas\R7FA4M2AD_EK_RA4M2\''.

[[File:RA_SmartConfigurator_Project.png]]

[[File:RA_SmartConfigurator_IAR.png]]

[[File:RA_SmartConfigurator_Flat.png]]

[[File:RA_SmartConfigurator_NoRTOS.png]]

[[File:RA_SmartConfigurator_BareMetal.png]]

==Open the project in IAR EWARM== 

[[File:IAR_open.png]]

==Add an embOS application and exclude main.c==

[[File:IAR_application.png]]

==Add an embOS library and BSP files==
Add all files from the embOS BSP folder ''SEGGER'' and ''Setup'' and one embOS library. You can take these two folders from an other embOS BSP within that shipment.
BSP.c might need to be updated according to your hardware.

[[File:IAR_BSP_Lib.png]]

==Add Include paths and define==
* Add the include paths ''$PROJ_DIR$/../../../Inc'' and ''$PROJ_DIR$/SEGGER''.
* Add the define ''OS_LIBMODE_DP''.

[[File:IAR_Preprocessor.png]]

==Update Renesas FSP files regarding stack symbol==
The Renesas FSP files use the stack symbol ''.stack''.
embOS instead uses the stack symbol ''CSTACK''. 
Therefore all occurrences of ''.stack'' needs to be replaced with ''CSTACK''.

* fsp.icf
<source lang="C">
rw section CSTACK };

rw section CSTACK,
</source>

* bsp_compiler_support.h
<source lang="C">
#define BSP_SECTION_STACK                  BSP_UNINIT_SECTION_PREFIX "CSTACK"
</source>

* system.c
<source lang="C">
#define BSP_PRV_STACK_LIMIT                          ((uint32_t) __section_begin("CSTACK"))
#define BSP_PRV_STACK_TOP                            ((uint32_t) __section_end("CSTACK"))

#pragma section="CSTACK"
</source>

==Build the project==
You should now be able to successfully build the project:

[[File:IAR_build.png]]

==Renesas Smart Configurator==
If IAR EWARM is configured accordingly you can start the Renesas Smart Configurator directly from within the IDE and generate new FSP files:

[[File:IAR_SmartConfigurator.png]]

==Conclusion==
With only a few steps it is possible to create an embOS project for any Renesas RA device and to still be able to use the Renesas Smart Configurator to generate or modify FSP files.