|
1 | | -# RH850 U2Ax FreeRTOS Partner Supported Demo |
| 1 | +# RH850 U2Ax FreeRTOS Partner Supported Demo with CC-RH Compiler |
2 | 2 |
|
3 | 3 | ## Introduction |
4 | | -This directory contains demo project for Renesas RH850 U2A8 |
5 | | - |
6 | | -This example implements the standard test demos detailed in following link: [RTOS Third Party Demo](https://github.com/FreeRTOS/FreeRTOS/blob/main/FreeRTOS/Demo/ThirdParty/Template/README.md) |
| 4 | +This directory contains demo project for Renesas RH850 U2A8 using the CC-RH compiler.<br /> |
| 5 | +This example implements the standard test demos detailed in following link: [RTOS Third Party Demo](https://github.com/FreeRTOS/FreeRTOS/blob/main/FreeRTOS/Demo/ThirdParty/Template/README.md). |
7 | 6 |
|
8 | 7 | ## IDE |
9 | | -- [CS+ suport RH850 family](https://www.renesas.com/en/software-tool/cs?srsltid=AfmBOoqK5LDXK_CY45rHXBlWg4XojnYUopLwSC9DjUXsDYs4pa0oTZke#downloads) |
| 8 | +- [CS+ support RH850 family](https://www.renesas.com/en/software-tool/cs?srsltid=AfmBOoqK5LDXK_CY45rHXBlWg4XojnYUopLwSC9DjUXsDYs4pa0oTZke#downloads).<br /> |
| 9 | + More guidelines for building and running the CC-RH compiler can be found in the [C Compiler Package for RH850 Family](https://www.renesas.com/en/software-tool/c-compiler-package-rh850-family-cc-rh). |
| 10 | + |
| 11 | +## How to build and run the Demo Project |
| 12 | + 1. Open CS+ (File *.mtpj) and import this project **File->Open**.<br /> |
| 13 | + Select test case you want to run by changing definition `configSTART_<Test_Name>_TESTS` in `freertos_cfg\FreeRTOSConfig.h` macros to `0` or ` 1` as needed.<br /> |
| 14 | + |
| 15 | + Monitoring results via Tera Term (Using UART Interface).<br /> |
| 16 | + Please download Tera Term from the following link [Tera Term Official Website](https://teratermproject.github.io/index-en.html).<br /> |
10 | 17 |
|
11 | | -## How to use |
12 | | -Open CS+ and import this project File->Open |
| 18 | + 1.1. Configure Tera Term transmit options.<br /> |
| 19 | +  |
13 | 20 |
|
14 | | -Select test case you want to run by changing definition `configSTART_<Test_Name>_TESTS` in `freertos\FreeRTOSConfig.h` macros to `0` or ` 1` as needed |
| 21 | + 1.2. Set up the Tera Term connection.<br /> |
| 22 | + Choose the appropriate COM port.<br /> |
| 23 | +  |
15 | 24 |
|
16 | | -Add breakpoint at line `configPRINTF(("%s \r\n", pcStatusMessage));` in `prvCheckTask` function in file `TestRunner.c` to check the result. |
| 25 | + 1.3. View results in Tera Term terminal.<br /> |
| 26 | + The output from the device will be displayed in the terminal window.<br /> |
| 27 | +  |
| 28 | + |
| 29 | + The UART configuration:<br /> |
| 30 | + - The UART TX pin of U2x device: P02_6 (with U2Bx) / P10_0 (with U2Ax) connects to the UART RX pin of USB UART<br /> |
| 31 | + - Baudrate: 115200<br /> |
| 32 | + - Data bit: 8<br /> |
| 33 | + - Stop bit: 1<br /> |
| 34 | + - Parity: None |
17 | 35 |
|
18 | 36 | ## Linker Script |
19 | | -Add below linker script to your linker section |
| 37 | +Add below linker script to your linker section. |
20 | 38 | ```c |
21 | | -RESET,STARTUP_CODE_PE0,STARTUP_CODE_PEn,STARTUP_CODE/00000000,ex_entry_PE0/00000800,ex_entry_PE1,.const,.INIT_BSEC.const,.INIT_DSEC.const,.data,.text/00005000,ex_entry_PE2/00035000,.stack_pe2.bss/FD800000,.stack_pe1.bss/FDA00000,.stack.bss,.data.R,.bss/FDC00000,.mev_address.bss/FE000000 |
| 39 | +RESET,STARTUP_CODE_PE0,STARTUP_CODE_PEn,STARTUP_CODE/00000000,ex_entry_PE0/00001000,ex_entry_PE1/00001400,.const,.INIT_BSEC.const,.INIT_DSEC.const,.data,.text/00004000,.inttable_PE0.const/00040000,.inttable_PE1.const/00041000,.stack_pe1.bss/FDA00000,.stack.bss/FDC00000,.data.R,.bss,.mev_address.bss/FE000000 |
22 | 40 | ``` |
23 | | - |
| 41 | + |
| 42 | + |
24 | 43 |
|
25 | 44 | ## Note |
26 | | -1. The configuration `configRUN_MULTIPLE_PRIORITIES` must be set to `0` to PASS the following test cases: |
27 | | -- `configSTART_GENERIC_QUEUE_TESTS` = `1` |
28 | | -- `configSTART_PEEK_QUEUE_TESTS` = `1` |
29 | | -- `configSTART_RECURSIVE_MUTEX_TESTS` = `1` |
30 | | -- `configSTART_EVENT_GROUP_TESTS` = `1` |
31 | | -- `configSTART_INTERRUPT_SEMAPHORE_TESTS` = `1` |
32 | | -- `configSTART_TIMER_TESTS` = `1` |
33 | | -2. The test case `configSTART_INTERRUPT_QUEUE_TESTS` are out of scope. |
34 | | -3. For other test cases, please use default configuraton (`configRUN_MULTIPLE_PRIORITIES` = `1`) |
| 45 | + 1. The configuration `configRUN_MULTIPLE_PRIORITIES` must be set to `0` to PASS the following test cases:<br /> |
| 46 | + - `configSTART_GENERIC_QUEUE_TESTS` = `1`<br /> |
| 47 | + - `configSTART_PEEK_QUEUE_TESTS` = `1`<br /> |
| 48 | + - `configSTART_RECURSIVE_MUTEX_TESTS` = `1`<br /> |
| 49 | + - `configSTART_EVENT_GROUP_TESTS` = `1`<br /> |
| 50 | + - `configSTART_INTERRUPT_SEMAPHORE_TESTS` = `1`<br /> |
| 51 | + - `configSTART_BLOCK_TIME_TESTS` = `1`<br /> |
| 52 | + - `configSTART_TIMER_TESTS` = `1` |
| 53 | + |
| 54 | + 2. For more information on setting up the vector table and configuring the interrupt vector method, disabling the FPU/FXU Units when not in use, and configuring interrupts, please refer to the [README.md](https://github.com/FreeRTOS/FreeRTOS-Kernel-Partner-Supported-Ports/blob/main/CCRH/U2x/README.md) file included with the Port files.<br /> |
| 55 | + It provides helpful background information on system initialization and hardware-specific settings. |
0 commit comments