/*
|
/*
|
* FreeRTOS Kernel V10.3.0
|
* FreeRTOS Kernel V10.3.0
|
* Copyright (C) 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
* Copyright (C) 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
*
|
*
|
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
* this software and associated documentation files (the "Software"), to deal in
|
* this software and associated documentation files (the "Software"), to deal in
|
* the Software without restriction, including without limitation the rights to
|
* the Software without restriction, including without limitation the rights to
|
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
* the Software, and to permit persons to whom the Software is furnished to do so,
|
* the Software, and to permit persons to whom the Software is furnished to do so,
|
* subject to the following conditions:
|
* subject to the following conditions:
|
*
|
*
|
* The above copyright notice and this permission notice shall be included in all
|
* The above copyright notice and this permission notice shall be included in all
|
* copies or substantial portions of the Software.
|
* copies or substantial portions of the Software.
|
*
|
*
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
*
|
*
|
* http://www.FreeRTOS.org
|
* http://www.FreeRTOS.org
|
* http://aws.amazon.com/freertos
|
* http://aws.amazon.com/freertos
|
*
|
*
|
* 1 tab == 4 spaces!
|
* 1 tab == 4 spaces!
|
*/
|
*/
|
|
|
/******************************************************************************
|
/******************************************************************************
|
* This project provides two demo applications. A simple blinky style project,
|
* This project provides two demo applications. A simple blinky style project,
|
* and a more comprehensive test and demo application. The
|
* and a more comprehensive test and demo application. The
|
* mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting (defined in this file) is used to
|
* mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting (defined in this file) is used to
|
* select between the two. The simply blinky demo is implemented and described
|
* select between the two. The simply blinky demo is implemented and described
|
* in main_blinky.c. The more comprehensive test and demo application is
|
* in main_blinky.c. The more comprehensive test and demo application is
|
* implemented and described in main_full.c.
|
* implemented and described in main_full.c.
|
*
|
*
|
* This file implements the code that is not demo specific, including the
|
* This file implements the code that is not demo specific, including the
|
* hardware setup and standard FreeRTOS hook functions.
|
* hardware setup and standard FreeRTOS hook functions.
|
*
|
*
|
* ENSURE TO READ THE DOCUMENTATION PAGE FOR THIS PORT AND DEMO APPLICATION ON
|
* ENSURE TO READ THE DOCUMENTATION PAGE FOR THIS PORT AND DEMO APPLICATION ON
|
* THE http://www.FreeRTOS.org WEB SITE FOR FULL INFORMATION ON USING THIS DEMO
|
* THE http://www.FreeRTOS.org WEB SITE FOR FULL INFORMATION ON USING THIS DEMO
|
* APPLICATION, AND ITS ASSOCIATE FreeRTOS ARCHITECTURE PORT!
|
* APPLICATION, AND ITS ASSOCIATE FreeRTOS ARCHITECTURE PORT!
|
*
|
*
|
*/
|
*/
|
|
|
/*
|
/*
|
* Modified for the NEORV32 processor by Stephan Nolting.
|
* Modified for the NEORV32 processor by Stephan Nolting.
|
*/
|
*/
|
|
|
/* UART hardware constants. */
|
/* UART hardware constants. */
|
#define BAUD_RATE 19200
|
#define BAUD_RATE 19200
|
|
|
#ifdef RUN_FREERTOS_DEMO
|
#ifdef RUN_FREERTOS_DEMO
|
|
|
#include <stdint.h>
|
#include <stdint.h>
|
|
|
/* FreeRTOS kernel includes. */
|
/* FreeRTOS kernel includes. */
|
#include <FreeRTOS.h>
|
#include <FreeRTOS.h>
|
#include <semphr.h>
|
#include <semphr.h>
|
#include <queue.h>
|
#include <queue.h>
|
#include <task.h>
|
#include <task.h>
|
|
|
/* NEORV32 includes. */
|
/* NEORV32 includes. */
|
#include <neorv32.h>
|
#include <neorv32.h>
|
|
|
/* misc */
|
/* misc */
|
//#include "driver_wrapper/uart_serial.h"
|
//#include "driver_wrapper/uart_serial.h"
|
|
|
/* Set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to one to run the simple blinky demo,
|
/* Set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to one to run the simple blinky demo,
|
or 0 to run the more comprehensive test and demo application. */
|
or 0 to run the more comprehensive test and demo application. */
|
#define mainCREATE_SIMPLE_BLINKY_DEMO_ONLY 1
|
#define mainCREATE_SIMPLE_BLINKY_DEMO_ONLY 1
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
/*
|
/*
|
* main_blinky() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 1.
|
* main_blinky() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 1.
|
* main_full() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 0.
|
* main_full() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 0.
|
*/
|
*/
|
#if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1
|
#if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1
|
extern void main_blinky( void );
|
extern void main_blinky( void );
|
#else
|
#else
|
extern void main_full( void );
|
extern void main_full( void );
|
#endif /* #if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 */
|
#endif /* #if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 */
|
|
|
extern void freertos_risc_v_trap_handler( void );
|
extern void freertos_risc_v_trap_handler( void );
|
|
|
/*
|
/*
|
* Prototypes for the standard FreeRTOS callback/hook functions implemented
|
* Prototypes for the standard FreeRTOS callback/hook functions implemented
|
* within this file. See https://www.freertos.org/a00016.html
|
* within this file. See https://www.freertos.org/a00016.html
|
*/
|
*/
|
void vApplicationMallocFailedHook( void );
|
void vApplicationMallocFailedHook( void );
|
void vApplicationIdleHook( void );
|
void vApplicationIdleHook( void );
|
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName );
|
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName );
|
void vApplicationTickHook( void );
|
void vApplicationTickHook( void );
|
|
|
/* Prepare hardware to run the demo. */
|
/* Prepare hardware to run the demo. */
|
static void prvSetupHardware( void );
|
static void prvSetupHardware( void );
|
|
|
/* System */
|
/* System */
|
void vToggleLED( void );
|
void vToggleLED( void );
|
void vSendString( const char * pcString );
|
void vSendString( const char * pcString );
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
int main( void )
|
int main( void )
|
{
|
{
|
prvSetupHardware();
|
prvSetupHardware();
|
|
|
/* say hi */
|
/* say hi */
|
neorv32_uart_printf("FreeRTOS %s on NEORV32 Demo\n\n", tskKERNEL_VERSION_NUMBER);
|
neorv32_uart_printf("FreeRTOS %s on NEORV32 Demo\n\n", tskKERNEL_VERSION_NUMBER);
|
|
|
/* The mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting is described at the top
|
/* The mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting is described at the top
|
of this file. */
|
of this file. */
|
#if( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 )
|
#if( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 )
|
main_blinky();
|
main_blinky();
|
#else
|
#else
|
main_full();
|
main_full();
|
#endif
|
#endif
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
static void prvSetupHardware( void )
|
static void prvSetupHardware( void )
|
{
|
{
|
// configure trap handler entry point
|
// configure trap handler entry point
|
neorv32_cpu_csr_write(CSR_MTVEC, (uint32_t)&freertos_risc_v_trap_handler);
|
neorv32_cpu_csr_write(CSR_MTVEC, (uint32_t)&freertos_risc_v_trap_handler);
|
|
|
// clear GPIO.out port
|
// clear GPIO.out port
|
neorv32_gpio_port_set(0);
|
neorv32_gpio_port_set(0);
|
|
|
// init UART at default baud rate, no parity bits, ho hw flow control
|
// init UART at default baud rate, no parity bits, ho hw flow control
|
neorv32_uart_setup(BAUD_RATE, PARITY_NONE, FLOW_CONTROL_NONE);
|
neorv32_uart_setup(BAUD_RATE, PARITY_NONE, FLOW_CONTROL_NONE);
|
|
|
// check available hardware extensions and compare with compiler flags
|
// check available hardware extensions and compare with compiler flags
|
neorv32_rte_check_isa(0); // silent = 0 -> show message if isa mismatch
|
neorv32_rte_check_isa(0); // silent = 0 -> show message if isa mismatch
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vToggleLED( void )
|
void vToggleLED( void )
|
{
|
{
|
neorv32_gpio_pin_toggle(0);
|
neorv32_gpio_pin_toggle(0);
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vSendString( const char * pcString )
|
void vSendString( const char * pcString )
|
{
|
{
|
neorv32_uart_print( ( const char * ) pcString );
|
neorv32_uart_print( ( const char * ) pcString );
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vApplicationMallocFailedHook( void )
|
void vApplicationMallocFailedHook( void )
|
{
|
{
|
/* vApplicationMallocFailedHook() will only be called if
|
/* vApplicationMallocFailedHook() will only be called if
|
configUSE_MALLOC_FAILED_HOOK is set to 1 in FreeRTOSConfig.h. It is a hook
|
configUSE_MALLOC_FAILED_HOOK is set to 1 in FreeRTOSConfig.h. It is a hook
|
function that will get called if a call to pvPortMalloc() fails.
|
function that will get called if a call to pvPortMalloc() fails.
|
pvPortMalloc() is called internally by the kernel whenever a task, queue,
|
pvPortMalloc() is called internally by the kernel whenever a task, queue,
|
timer or semaphore is created. It is also called by various parts of the
|
timer or semaphore is created. It is also called by various parts of the
|
demo application. If heap_1.c or heap_2.c are used, then the size of the
|
demo application. If heap_1.c or heap_2.c are used, then the size of the
|
heap available to pvPortMalloc() is defined by configTOTAL_HEAP_SIZE in
|
heap available to pvPortMalloc() is defined by configTOTAL_HEAP_SIZE in
|
FreeRTOSConfig.h, and the xPortGetFreeHeapSize() API function can be used
|
FreeRTOSConfig.h, and the xPortGetFreeHeapSize() API function can be used
|
to query the size of free heap space that remains (although it does not
|
to query the size of free heap space that remains (although it does not
|
provide information on how the remaining heap might be fragmented). */
|
provide information on how the remaining heap might be fragmented). */
|
taskDISABLE_INTERRUPTS();
|
taskDISABLE_INTERRUPTS();
|
neorv32_uart_print("FreeRTOS_FAULT: vApplicationMallocFailedHook (solution: increase 'configTOTAL_HEAP_SIZE' in FreeRTOSConfig.h)\n");
|
neorv32_uart_print("FreeRTOS_FAULT: vApplicationMallocFailedHook (solution: increase 'configTOTAL_HEAP_SIZE' in FreeRTOSConfig.h)\n");
|
__asm volatile( "ebreak" );
|
__asm volatile( "ebreak" );
|
for( ;; );
|
for( ;; );
|
}
|
}
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vApplicationIdleHook( void )
|
void vApplicationIdleHook( void )
|
{
|
{
|
/* vApplicationIdleHook() will only be called if configUSE_IDLE_HOOK is set
|
/* vApplicationIdleHook() will only be called if configUSE_IDLE_HOOK is set
|
to 1 in FreeRTOSConfig.h. It will be called on each iteration of the idle
|
to 1 in FreeRTOSConfig.h. It will be called on each iteration of the idle
|
task. It is essential that code added to this hook function never attempts
|
task. It is essential that code added to this hook function never attempts
|
to block in any way (for example, call xQueueReceive() with a block time
|
to block in any way (for example, call xQueueReceive() with a block time
|
specified, or call vTaskDelay()). If the application makes use of the
|
specified, or call vTaskDelay()). If the application makes use of the
|
vTaskDelete() API function (as this demo application does) then it is also
|
vTaskDelete() API function (as this demo application does) then it is also
|
important that vApplicationIdleHook() is permitted to return to its calling
|
important that vApplicationIdleHook() is permitted to return to its calling
|
function, because it is the responsibility of the idle task to clean up
|
function, because it is the responsibility of the idle task to clean up
|
memory allocated by the kernel to any task that has since been deleted. */
|
memory allocated by the kernel to any task that has since been deleted. */
|
neorv32_cpu_sleep();
|
neorv32_cpu_sleep();
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName )
|
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName )
|
{
|
{
|
( void ) pcTaskName;
|
( void ) pcTaskName;
|
( void ) pxTask;
|
( void ) pxTask;
|
|
|
/* Run time stack overflow checking is performed if
|
/* Run time stack overflow checking is performed if
|
configCHECK_FOR_STACK_OVERFLOW is defined to 1 or 2. This hook
|
configCHECK_FOR_STACK_OVERFLOW is defined to 1 or 2. This hook
|
function is called if a stack overflow is detected. */
|
function is called if a stack overflow is detected. */
|
taskDISABLE_INTERRUPTS();
|
taskDISABLE_INTERRUPTS();
|
neorv32_uart_print("FreeRTOS_FAULT: vApplicationStackOverflowHook\n");
|
neorv32_uart_print("FreeRTOS_FAULT: vApplicationStackOverflowHook\n");
|
__asm volatile( "ebreak" );
|
__asm volatile( "ebreak" );
|
for( ;; );
|
for( ;; );
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
void vApplicationTickHook( void )
|
void vApplicationTickHook( void )
|
{
|
{
|
/* The tests in the full demo expect some interaction with interrupts. */
|
/* The tests in the full demo expect some interaction with interrupts. */
|
#if( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY != 1 )
|
#if( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY != 1 )
|
{
|
{
|
extern void vFullDemoTickHook( void );
|
extern void vFullDemoTickHook( void );
|
vFullDemoTickHook();
|
vFullDemoTickHook();
|
}
|
}
|
#endif
|
#endif
|
}
|
}
|
|
|
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
|
|
/* This handler is responsible for handling all interrupts. Only the machine timer interrupt is handled by the kernel. */
|
/* This handler is responsible for handling all interrupts. Only the machine timer interrupt is handled by the kernel. */
|
void SystemIrqHandler( uint32_t mcause )
|
void SystemIrqHandler( uint32_t mcause )
|
{
|
{
|
neorv32_uart_printf("freeRTOS: Unknown interrupt (0x%x)\n", mcause);
|
neorv32_uart_printf("freeRTOS: Unknown interrupt (0x%x)\n", mcause);
|
}
|
}
|
|
|
|
|
|
|
|
|
|
|
// ---------- Primitive main in case this demo is not enabled (i.e. RUN_FREERTOS_DEMO is not defined) ----------
|
// ---------- Primitive main in case this demo is not enabled (i.e. RUN_FREERTOS_DEMO is not defined) ----------
|
#else
|
#else
|
#warning FREERTOS DEMO HAS NOT BEEN COMPILED! Use >>make USER_FLAGS+=-DRUN_FREERTOS_DEMO clean_all exe<< to compile it.
|
#warning FREERTOS DEMO HAS NOT BEEN COMPILED! Use >>make USER_FLAGS+=-DRUN_FREERTOS_DEMO clean_all exe<< to compile it.
|
|
|
#include <neorv32.h>
|
#include <neorv32.h>
|
int main() {
|
int main() {
|
|
|
// init UART at default baud rate, no parity bits, ho hw flow control
|
// init UART at default baud rate, no parity bits, ho hw flow control
|
neorv32_uart_setup(BAUD_RATE, PARITY_NONE, FLOW_CONTROL_NONE);
|
neorv32_uart_setup(BAUD_RATE, PARITY_NONE, FLOW_CONTROL_NONE);
|
neorv32_uart_print("ERROR! FreeRTOS has not been compiled. Use >>make USER_FLAGS+=-DRUN_FREERTOS_DEMO clean_all exe<< to compile it.\n");
|
neorv32_uart_print("ERROR! FreeRTOS has not been compiled. Use >>make USER_FLAGS+=-DRUN_FREERTOS_DEMO clean_all exe<< to compile it.\n");
|
return 0;
|
return 1;
|
}
|
}
|
#endif
|
#endif
|
|
|
