FreeRTOS/Demo/CORTEX_A9_Cyclone_V_SoC_DK/FreeRTOSConfig.h - third_party/github/FreeRTOS/FreeRTOS-Kernel - Git at Google

 /*
  * FreeRTOS Kernel V10.3.0
  * 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
  * this software and associated documentation files (the "Software"), to deal in
  * the Software without restriction, including without limitation the rights to
  * 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,
  * subject to the following conditions:
  *
  * The above copyright notice and this permission notice shall be included in all
  * copies or substantial portions of the Software.
  *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
  * 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
  * 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.
  *
  * http://www.FreeRTOS.org
  * http://aws.amazon.com/freertos
  *
  * 1 tab == 4 spaces!
  */

 #ifndef FREERTOS_CONFIG_H
 #define FREERTOS_CONFIG_H

 /* Altera library includes. */
 #include "alt_timers.h"
 #include "alt_interrupt.h"
 #include "alt_globaltmr.h"

 /*-----------------------------------------------------------
  * Application specific definitions.
  *
  * These definitions should be adjusted for your particular hardware and
  * application requirements.
  *
  * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
  * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
  *
  * See http://www.freertos.org/a00110.html for a full list of configuration
  * options.
  *----------------------------------------------------------*/

 /*
  * The FreeRTOS Cortex-A port implements a full interrupt nesting model.
  *
  * Interrupts that are assigned a priority at or below
  * configMAX_API_CALL_INTERRUPT_PRIORITY (which counter-intuitively in the ARM
  * generic interrupt controller [GIC] means a priority that has a numerical
  * value above configMAX_API_CALL_INTERRUPT_PRIORITY) can call interrupt safe
  * FreeRTOS API functions and will nest.
  *
  * Interrupts that are assigned a priority above
  * configMAX_API_CALL_INTERRUPT_PRIORITY (which in the GIC means a numerical
  * value below configMAX_API_CALL_INTERRUPT_PRIORITY) cannot call any FreeRTOS
  * API functions, will nest, and will not be masked by FreeRTOS critical
  * sections (although it is necessary for interrupts to be globally disabled
  * extremely briefly as the interrupt mask is updated in the GIC).
  *
  * FreeRTOS functions that can be called from an interrupt are those that end in
  * "FromISR".  FreeRTOS maintains a separate interrupt safe API to enable
  * interrupt entry to be shorter, faster, simpler and smaller.
  *
  * The Cyclone V SoC implements 32 unique interrupt priorities.  For the
  * purpose of setting configMAX_API_CALL_INTERRUPT_PRIORITY 32 represents the
  * lowest priority.
  */
 #define configMAX_API_CALL_INTERRUPT_PRIORITY	18

 /* The application will define the array used as the RTOS heap to ensure it can
 be located in the (faster) on-chip RAM.  When this parameter is set to 1 the
 application must define an array using the name and size as follows below, but
 is free to locate the array in any suitable RAM region (the faster the better as
 the stacks used by the tasks are allocated from this array):

 uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];

 */
 #define configAPPLICATION_ALLOCATED_HEAP		1

 #define configCPU_CLOCK_HZ						/* Not used in this demo. */
 #define configUSE_PORT_OPTIMISED_TASK_SELECTION	1
 #define configUSE_TICKLESS_IDLE					0
 #define configTICK_RATE_HZ						( ( TickType_t ) 1000 )
 #define configUSE_PREEMPTION					1
 #define configMAX_PRIORITIES					( 7 )
 #define configMINIMAL_STACK_SIZE				( ( unsigned short ) 200 )
 #define configTOTAL_HEAP_SIZE					( 50 * 1024 )
 #define configMAX_TASK_NAME_LEN					( 10 )
 #define configUSE_TRACE_FACILITY				1
 #define configUSE_16_BIT_TICKS					0
 #define configIDLE_SHOULD_YIELD					1
 #define configUSE_MUTEXES						1
 #define configQUEUE_REGISTRY_SIZE				8
 #define configCHECK_FOR_STACK_OVERFLOW			2
 #define configUSE_RECURSIVE_MUTEXES				1
 #define configUSE_APPLICATION_TASK_TAG			0
 #define configUSE_COUNTING_SEMAPHORES			1
 #define configUSE_QUEUE_SETS					1

 /* Hook/Callback related definitions. */
 #define configUSE_MALLOC_FAILED_HOOK			1
 #define configUSE_IDLE_HOOK						1
 #define configUSE_TICK_HOOK						1
 #define configUSE_DAEMON_TASK_STARTUP_HOOK		1

 /* Co-routine definitions. */
 #define configUSE_CO_ROUTINES 					0
 #define configMAX_CO_ROUTINE_PRIORITIES 		( 2 )

 /* Software timer definitions. */
 #define configUSE_TIMERS						1
 #define configTIMER_TASK_PRIORITY				( configMAX_PRIORITIES - 1 )
 #define configTIMER_QUEUE_LENGTH				5
 #define configTIMER_TASK_STACK_DEPTH			( configMINIMAL_STACK_SIZE * 2 )

 /* Set the following definitions to 1 to include the API function, or zero
 to exclude the API function. */
 #define INCLUDE_vTaskPrioritySet				1
 #define INCLUDE_uxTaskPriorityGet				1
 #define INCLUDE_vTaskDelete						1
 #define INCLUDE_vTaskCleanUpResources			1
 #define INCLUDE_vTaskSuspend					1
 #define INCLUDE_vTaskDelayUntil					1
 #define INCLUDE_vTaskDelay						1
 #define INCLUDE_xTimerPendFunctionCall			1
 #define INCLUDE_eTaskGetState					1

 /* This demo makes use of one or more example stats formatting functions.  These
 format the raw data provided by the uxTaskGetSystemState() function in to human
 readable ASCII form.  See the notes in the implementation of vTaskList() within
 FreeRTOS/Source/tasks.c for limitations. */
 #define configUSE_STATS_FORMATTING_FUNCTIONS	1

 /* Run time stats related definitions. */
 #define configGENERATE_RUN_TIME_STATS 1
 #define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() alt_globaltmr_start()
 #define portGET_RUN_TIME_COUNTER_VALUE()  ( ( uint32_t ) ( alt_globaltmr_get64() >> ( uint64_t ) 16 ) )


 /* The size of the global output buffer that is available for use when there
 are multiple command interpreters running at once (for example, one on a UART
 and one on TCP/IP).  This is done to prevent an output buffer being defined by
 each implementation - which would waste RAM.  In this case, there is only one
 command interpreter running. */
 #define configCOMMAND_INT_MAX_OUTPUT_SIZE 2096

 /* Normal assert() semantics without relying on the provision of an assert.h
 header file. */
 void vAssertCalled( const char * pcFile, unsigned long ulLine );
 #define configASSERT( x ) if( ( x ) == 0 ) vAssertCalled( __FILE__, __LINE__ );

 /* If configTASK_RETURN_ADDRESS is not defined then a task that attempts to
 return from its implementing function will end up in a "task exit error"
 function - which contains a call to configASSERT().  However this can give GCC
 some problems when it tries to unwind the stack, as the exit error function has
 nothing to return to.  To avoid this define configTASK_RETURN_ADDRESS to 0.  */
 #define configTASK_RETURN_ADDRESS	NULL


 /****** Hardware specific settings. *******************************************/

  typedef struct INT_DISPATCH_s
  {
      alt_int_callback_t pxISR;
      void *             pvContext;
  }
  INT_DISPATCH_t;

 void vRegisterIRQHandler( uint32_t ulID, alt_int_callback_t pxHandlerFunction, void *pvContext );
 void vApplicationIRQHandler( uint32_t ulICCIAR );

 /*
  * The application must provide a function that configures a peripheral to
  * create the FreeRTOS tick interrupt, then define configSETUP_TICK_INTERRUPT()
  * in FreeRTOSConfig.h to call the function.  This file contains a function
  * that is suitable for use on the Zynq MPU.  FreeRTOS_Tick_Handler() must
  * be installed as the peripheral's interrupt handler.
  */
 void vConfigureTickInterrupt( void );
 #define configSETUP_TICK_INTERRUPT() vConfigureTickInterrupt();

 void vClearTickInterrupt( void );
 #define configCLEAR_TICK_INTERRUPT() alt_gpt_int_clear_pending( ALT_GPT_CPU_PRIVATE_TMR );

 /* The following constant describe the hardware, and are correct for the
 Cyclone V SoC. */
 #define configINTERRUPT_CONTROLLER_BASE_ADDRESS 		( 0xFFFED000 )
 #define configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET ( -0xf00 )
 #define configUNIQUE_INTERRUPT_PRIORITIES				32

 #endif /* FREERTOS_CONFIG_H */
	/*
	* FreeRTOS Kernel V10.3.0
	* 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
	* this software and associated documentation files (the "Software"), to deal in
	* the Software without restriction, including without limitation the rights to
	* 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,
	* subject to the following conditions:
	*
	* The above copyright notice and this permission notice shall be included in all
	* copies or substantial portions of the Software.
	*
	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
	* 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
	* 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.
	*
	* http://www.FreeRTOS.org
	* http://aws.amazon.com/freertos
	*
	* 1 tab == 4 spaces!
	*/

	#ifndef FREERTOS_CONFIG_H
	#define FREERTOS_CONFIG_H

	/* Altera library includes. */
	#include "alt_timers.h"
	#include "alt_interrupt.h"
	#include "alt_globaltmr.h"

	/*-----------------------------------------------------------
	* Application specific definitions.
	*
	* These definitions should be adjusted for your particular hardware and
	* application requirements.
	*
	* THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
	* FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
	*
	* See http://www.freertos.org/a00110.html for a full list of configuration
	* options.
	----------------------------------------------------------/

	/*
	* The FreeRTOS Cortex-A port implements a full interrupt nesting model.
	*
	* Interrupts that are assigned a priority at or below
	* configMAX_API_CALL_INTERRUPT_PRIORITY (which counter-intuitively in the ARM
	* generic interrupt controller [GIC] means a priority that has a numerical
	* value above configMAX_API_CALL_INTERRUPT_PRIORITY) can call interrupt safe
	* FreeRTOS API functions and will nest.
	*
	* Interrupts that are assigned a priority above
	* configMAX_API_CALL_INTERRUPT_PRIORITY (which in the GIC means a numerical
	* value below configMAX_API_CALL_INTERRUPT_PRIORITY) cannot call any FreeRTOS
	* API functions, will nest, and will not be masked by FreeRTOS critical
	* sections (although it is necessary for interrupts to be globally disabled
	* extremely briefly as the interrupt mask is updated in the GIC).
	*
	* FreeRTOS functions that can be called from an interrupt are those that end in
	* "FromISR". FreeRTOS maintains a separate interrupt safe API to enable
	* interrupt entry to be shorter, faster, simpler and smaller.
	*
	* The Cyclone V SoC implements 32 unique interrupt priorities. For the
	* purpose of setting configMAX_API_CALL_INTERRUPT_PRIORITY 32 represents the
	* lowest priority.
	*/
	#define configMAX_API_CALL_INTERRUPT_PRIORITY 18

	/* The application will define the array used as the RTOS heap to ensure it can
	be located in the (faster) on-chip RAM. When this parameter is set to 1 the
	application must define an array using the name and size as follows below, but
	is free to locate the array in any suitable RAM region (the faster the better as
	the stacks used by the tasks are allocated from this array):

	uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];

	*/
	#define configAPPLICATION_ALLOCATED_HEAP 1

	#define configCPU_CLOCK_HZ /* Not used in this demo. */
	#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
	#define configUSE_TICKLESS_IDLE 0
	#define configTICK_RATE_HZ ( ( TickType_t ) 1000 )
	#define configUSE_PREEMPTION 1
	#define configMAX_PRIORITIES ( 7 )
	#define configMINIMAL_STACK_SIZE ( ( unsigned short ) 200 )
	#define configTOTAL_HEAP_SIZE ( 50 * 1024 )
	#define configMAX_TASK_NAME_LEN ( 10 )
	#define configUSE_TRACE_FACILITY 1
	#define configUSE_16_BIT_TICKS 0
	#define configIDLE_SHOULD_YIELD 1
	#define configUSE_MUTEXES 1
	#define configQUEUE_REGISTRY_SIZE 8
	#define configCHECK_FOR_STACK_OVERFLOW 2
	#define configUSE_RECURSIVE_MUTEXES 1
	#define configUSE_APPLICATION_TASK_TAG 0
	#define configUSE_COUNTING_SEMAPHORES 1
	#define configUSE_QUEUE_SETS 1

	/* Hook/Callback related definitions. */
	#define configUSE_MALLOC_FAILED_HOOK 1
	#define configUSE_IDLE_HOOK 1
	#define configUSE_TICK_HOOK 1
	#define configUSE_DAEMON_TASK_STARTUP_HOOK 1

	/* Co-routine definitions. */
	#define configUSE_CO_ROUTINES 0
	#define configMAX_CO_ROUTINE_PRIORITIES ( 2 )

	/* Software timer definitions. */
	#define configUSE_TIMERS 1
	#define configTIMER_TASK_PRIORITY ( configMAX_PRIORITIES - 1 )
	#define configTIMER_QUEUE_LENGTH 5
	#define configTIMER_TASK_STACK_DEPTH ( configMINIMAL_STACK_SIZE * 2 )

	/* Set the following definitions to 1 to include the API function, or zero
	to exclude the API function. */
	#define INCLUDE_vTaskPrioritySet 1
	#define INCLUDE_uxTaskPriorityGet 1
	#define INCLUDE_vTaskDelete 1
	#define INCLUDE_vTaskCleanUpResources 1
	#define INCLUDE_vTaskSuspend 1
	#define INCLUDE_vTaskDelayUntil 1
	#define INCLUDE_vTaskDelay 1
	#define INCLUDE_xTimerPendFunctionCall 1
	#define INCLUDE_eTaskGetState 1

	/* This demo makes use of one or more example stats formatting functions. These
	format the raw data provided by the uxTaskGetSystemState() function in to human
	readable ASCII form. See the notes in the implementation of vTaskList() within
	FreeRTOS/Source/tasks.c for limitations. */
	#define configUSE_STATS_FORMATTING_FUNCTIONS 1

	/* Run time stats related definitions. */
	#define configGENERATE_RUN_TIME_STATS 1
	#define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() alt_globaltmr_start()
	#define portGET_RUN_TIME_COUNTER_VALUE() ( ( uint32_t ) ( alt_globaltmr_get64() >> ( uint64_t ) 16 ) )


	/* The size of the global output buffer that is available for use when there
	are multiple command interpreters running at once (for example, one on a UART
	and one on TCP/IP). This is done to prevent an output buffer being defined by
	each implementation - which would waste RAM. In this case, there is only one
	command interpreter running. */
	#define configCOMMAND_INT_MAX_OUTPUT_SIZE 2096

	/* Normal assert() semantics without relying on the provision of an assert.h
	header file. */
	void vAssertCalled( const char * pcFile, unsigned long ulLine );
	#define configASSERT( x ) if( ( x ) == 0 ) vAssertCalled( __FILE__, __LINE__ );

	/* If configTASK_RETURN_ADDRESS is not defined then a task that attempts to
	return from its implementing function will end up in a "task exit error"
	function - which contains a call to configASSERT(). However this can give GCC
	some problems when it tries to unwind the stack, as the exit error function has
	nothing to return to. To avoid this define configTASK_RETURN_ADDRESS to 0. */
	#define configTASK_RETURN_ADDRESS NULL


	/**** Hardware specific settings. *****************************************/

	typedef struct INT_DISPATCH_s
	{
	alt_int_callback_t pxISR;
	void * pvContext;
	}
	INT_DISPATCH_t;

	void vRegisterIRQHandler( uint32_t ulID, alt_int_callback_t pxHandlerFunction, void *pvContext );
	void vApplicationIRQHandler( uint32_t ulICCIAR );

	/*
	* The application must provide a function that configures a peripheral to
	* create the FreeRTOS tick interrupt, then define configSETUP_TICK_INTERRUPT()
	* in FreeRTOSConfig.h to call the function. This file contains a function
	* that is suitable for use on the Zynq MPU. FreeRTOS_Tick_Handler() must
	* be installed as the peripheral's interrupt handler.
	*/
	void vConfigureTickInterrupt( void );
	#define configSETUP_TICK_INTERRUPT() vConfigureTickInterrupt();

	void vClearTickInterrupt( void );
	#define configCLEAR_TICK_INTERRUPT() alt_gpt_int_clear_pending( ALT_GPT_CPU_PRIVATE_TMR );

	/* The following constant describe the hardware, and are correct for the
	Cyclone V SoC. */
	#define configINTERRUPT_CONTROLLER_BASE_ADDRESS ( 0xFFFED000 )
	#define configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET ( -0xf00 )
	#define configUNIQUE_INTERRUPT_PRIORITIES 32

	#endif /* FREERTOS_CONFIG_H */