Renesas RX200 and RX130

From ErikaWiki

(Difference between revisions)
Jump to: navigation, search
 
(10 intermediate revisions not shown)
Line 1: Line 1:
= Renesas RX200 Series support =
= Renesas RX200 Series support =
-
ERIKA Enterprise supports Renesas RX200 series microcontrollers, in particular the RX210 Group.
+
ERIKA Enterprise supports Renesas RX200 series microcontrollers, in particular the [https://www.renesas.com/en-us/products/microcontrollers-microprocessors/rx/rx200/rx210.html RX210] and [https://www.renesas.com/en-us/products/microcontrollers-microprocessors/rx/rx200/rx210.html RX130] Groups.
The support for RT-Druid is now available.<br>
The support for RT-Druid is now available.<br>
-
The Cortex RX200 support includes:  
+
Due to customer restrictions, the [https://www.renesas.com/en-us/products/microcontrollers-microprocessors/rx/rx200/rx210.html RX130] porting is not yet public. If you want to get more information about the [https://www.renesas.com/en-us/products/microcontrollers-microprocessors/rx/rx200/rx210.html RX130] porting, please contact [mailto:info@evidence.eu.com info@evidence.eu.com].
-
# support for CCRX Compiler;
+
 
 +
The Renesas RX200 support includes:  
 +
# support for [https://www.renesas.com/en-eu/products/software-tools/tools/compiler-assembler/compiler-package-for-rx-family.html C/C++ Compiler Package for RX Family];
# support for single and multi stack configurations;
# support for single and multi stack configurations;
# ISR Type 1 and Type 2 supported;
# ISR Type 1 and Type 2 supported;
-
# support for Renesas E1 Debugger.
+
# support for Renesas [https://www.renesas.com/en-sg/products/software-tools/tools/emulator/e1.html E1] debugger/emulator;
* Supported IDEs:
* Supported IDEs:
-
** Renesas High-performance Embedded Workshop
+
** Renesas [https://www.renesas.com/en-us/products/software-tools/tools/ide/hew.html High-performance Embedded Workshop];
 +
** Renesas [https://www.renesas.com/en-us/products/software-tools/tools/ide/e2studio.html e2studio] IDE;
* Mode of operation:
* Mode of operation:
Line 21: Line 24:
* The MCU currently supported is the following:
* The MCU currently supported is the following:
** R5F52108xxxx
** R5F52108xxxx
 +
** R5F51308xxxx
=== Boards ===
=== Boards ===
* The board currently supported is the following:
* The board currently supported is the following:
-
**Renesas Starter Kit for RX210 (part number R0K505210S000BE)
+
** [https://www.renesas.com/en-eu/products/software-tools/boards-and-kits/renesas-starter-kits/renesas-starter-kit-for-rx210.html Renesas Starter Kit for RX210] (part number R0K505210S000BE)
 +
** [https://www.renesas.com/en-us/products/software-tools/boards-and-kits/renesas-starter-kits/renesas-starter-kit-for-rx130-512kb.html Renesas Starter Kit for RX130-512KB] (part number RTK5051308C00000BE)
* List of functions:
* List of functions:
-
** Renesas Starter Kit for RX210 is supported by Erika RTOS. Currently only leds, buttons and the LCD module are supported.
+
** [https://www.renesas.com/en-eu/products/software-tools/boards-and-kits/renesas-starter-kits/renesas-starter-kit-for-rx210.html Renesas Starter Kit for RX210] is supported by Erika RTOS. Currently only leds, buttons and the LCD module are supported.
= Download and install =
= Download and install =
Line 112: Line 117:
* The software libraries currently supported are those provided with Erika:
* The software libraries currently supported are those provided with Erika:
-
** [[http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/board/renesas_rskrx210] Leds and Buttons].
+
** [http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/board/renesas_rskrx210 Leds and Buttons].
-
** [[http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/mcu/renesas_r5f5210x] System tick].  
+
** [http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/board/renesas_rskrx210 Operating Frequency Setup].
 +
** [http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/mcu/renesas_r5f5210x System tick].  
=== OIL file configuration ===
=== OIL file configuration ===
Line 132: Line 138:
  EE_OPT = "__USE_RSKRX120_BUTTONS__";
  EE_OPT = "__USE_RSKRX120_BUTTONS__";
 +
 +
To use the Operating Frequency Setup routine add:
 +
 +
EE_OPT = "__USE_RSKRX210_OP_FREQ_SETUP__";
If you want to add an external library, such as the Renesas RPDL library, and need to tell the linker to allocate the code Section "L" into the loadable module,
If you want to add an external library, such as the Renesas RPDL library, and need to tell the linker to allocate the code Section "L" into the loadable module,
Line 148: Line 158:
* [[Tutorial: Installing ERIKA and RT-Druid, and compile your first application]]
* [[Tutorial: Installing ERIKA and RT-Druid, and compile your first application]]
* [[Tutorial: RT-Druid and OIL basics]]
* [[Tutorial: RT-Druid and OIL basics]]
-
* [[http://am.renesas.com/products/mpumcu/rx/rx200/rx210/index.jsp] Renesas RX210 architecture webpage.]
+
* [http://am.renesas.com/products/mpumcu/rx/rx200/rx210/index.jsp Renesas RX210 architecture webpage.]
-
* [[http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_starter_kits/rsk_rx210/index.jsp] RX210 Starter Kit]
+
* [http://am.renesas.com/products/tools/introductory_evaluation_tools/renesas_starter_kits/rsk_rx210/index.jsp RX210 Starter Kit]
-
*[[http://am.renesas.com/products/tools/ide/ide_hew/index.jsp] Renesas High-performance Embedded Workshop ]
+
* [http://am.renesas.com/products/tools/ide/ide_hew/index.jsp Renesas High-performance Embedded Workshop ]
[[Category:Supported Devices]]}
[[Category:Supported Devices]]}

Latest revision as of 17:36, 4 June 2018

Contents

Renesas RX200 Series support

ERIKA Enterprise supports Renesas RX200 series microcontrollers, in particular the RX210 and RX130 Groups. The support for RT-Druid is now available.

Due to customer restrictions, the RX130 porting is not yet public. If you want to get more information about the RX130 porting, please contact info@evidence.eu.com.

The Renesas RX200 support includes:

  1. support for C/C++ Compiler Package for RX Family;
  2. support for single and multi stack configurations;
  3. ISR Type 1 and Type 2 supported;
  4. support for Renesas E1 debugger/emulator;
  • Mode of operation:
    • Mono-stack: The Monostack configuration of the ERIKA Kernel models the fact that all tasks and ISRs in the system share the same stack.
    • Multi-stack HAL: Every task can have its private stack, or it can share it with other tasks.

MCUs

  • The MCU currently supported is the following:
    • R5F52108xxxx
    • R5F51308xxxx

Boards

Download and install

RT-Druid and Erika Enterprise RTOS (version 1.6.1) can be freely downloaded from the following web address:

Once downloaded, extract all the files contained in it and copy the folder named eclipse in your preferred directory on your PC (a recommended path is: C:\\Evidence\\). Now, launch the program by double-clicking on the executable eclipse.exeinside the C:\Evidence\eclipse folder and choose the path of your workspace. The workspace is the default working directory in which the projects will be created.

If you want to download only a selected revision of the kernel, open the Cygwin shell and get an anonymous SVN checkout typing this command:

 svn co svn://svn.tuxfamily.org/svnroot/erika/erikae/repos/ee/trunk/ee -r number_of_revision

Note: Cygwin can be downloaded from this web site: http://www.cygwin.com/ To use SVN, the Cygwin SVN package must to be installed using the Cygwin Setup utility.

The Renesas RX200 plug-in for Eclipse is part of the official distribution of RT-Druid.

Target Configuration and Programming

ERIKA is configured through RT-Druid and an OIL file

Compiler Path

It is possible to choose the path of the compiler in three different ways:

  • environment var:
    • CCRX compiler: the CCRX_ROOT variable is able to override the path compiler set in RT-Druid during the build progress.
  • configuration file:
  • gui:
    • inside eclipse preferences, it is possible to set the paths of above compilers.

CPU

CPU_DATA must be set to RX200.
The exact model is specified with the MODEL item (supported values are M0 for Cortex M0 and M4 for Cortex M4).
The compiler is specificed with the COMPILER_TYPE item (currently the only supported value is CCRX<code>).
Example of a CPU_DATA section:

CPU_DATA = RX200 {

  APP_SRC = "code.c";
  COMPILER_TYPE = CCRX;
  MULTI_STACK = TRUE {
      IRQ_STACK = TRUE {
           SYS_SIZE=512;
      };
  };

};

MCU

<code>MCU_DATA must be set to RENESAS
The only item supported is MODEL. The model currently supported is the RF5210x
Example of a MCU_DATA section:

MCU_DATA = RENESAS {
   MODEL = R5F5210x;
};

Interrupt Handling

Renesas MCU R5F5210x is configured to have a flexible Interrupt Vector Table specified in http://svn.tuxfamily.org/viewvc.cgi/erika_erikae/repos/ee/trunk/ee/pkg/mcu/renesas_r5f5210x/src/ee_vtable_ccrx.c.
Each entry is specified by the following macro:

 EE_<ARCH>_<ENTRY>_ISR

Where <ARCH> is the architecture depended identifier (E.g. RX200), and <ENTRY> is the fixed Interrupt Vector Table Entry identifier (E.g. CMIA0).

To define each ISR an ISR object is needed to be added in the CPU object of the OSEK/VDX configuration:

 ISR <SYMBOL> {
   CATEGORY = <ISR_TYPE>;
   ENTRY = "<ENTRY>";
 };

Where <ISR_TYPE> is the type of the ISR (1 or 2), <SYMBOL> is the symbol that must be the parameter of ISR<ISR_TYPE>() ISR signature, and <ENTRY> is the variable Interrupt Vector Table Entry identifier.

Libraries

OIL file configuration

To enable system tick routines, the following code is needed in the OS object of the OSEK/VDX configuration:

EE_OPT = "__USE_SYSTICK__";

To enable board support library with Renesas RX210 starter kit, the following code is needed in the OS object of the OSEK/VDX configuration:

EE_OPT = "__RSKRX210__";

To use the board's leds add:

EE_OPT = "__USE_RSKRX120_USER_LED__";

To use the board's buttons add:

EE_OPT = "__USE_RSKRX120_BUTTONS__";

To use the Operating Frequency Setup routine add:

EE_OPT = "__USE_RSKRX210_OP_FREQ_SETUP__";

If you want to add an external library, such as the Renesas RPDL library, and need to tell the linker to allocate the code Section "L" into the loadable module, the following code is needed in the OS object of the OSEK/VDX configuration:

EE_OPT = "__ADD_LIB_SECT__";

Examples

See also

Personal tools