begriffs open source - cmsis-freertos/blob - Demo/CORTEX_A9_Cyclone_V_SoC_DK/FreeRTOSConfig.h

   1 /*
   2  * FreeRTOS Kernel V10.0.1
   3  * Copyright (C) 2017 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a copy of
   6  * this software and associated documentation files (the "Software"), to deal in
   7  * the Software without restriction, including without limitation the rights to
   8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
   9  * the Software, and to permit persons to whom the Software is furnished to do so,
  10  * subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in all
  13  * copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
  17  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
  18  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  19  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  21  *
  22  * http://www.FreeRTOS.org
  23  * http://aws.amazon.com/freertos
  24  *
  25  * 1 tab == 4 spaces!
  26  */
  27
  28 #ifndef FREERTOS_CONFIG_H
  29 #define FREERTOS_CONFIG_H
  30
  31 /* Altera library includes. */
  32 #include "alt_timers.h"
  33 #include "alt_interrupt.h"
  34 #include "alt_globaltmr.h"
  35
  36 /*-----------------------------------------------------------
  37  * Application specific definitions.
  38  *
  39  * These definitions should be adjusted for your particular hardware and
  40  * application requirements.
  41  *
  42  * THESE PARAMETERS ARE DESCRIBED WITHIN THE 'CONFIGURATION' SECTION OF THE
  43  * FreeRTOS API DOCUMENTATION AVAILABLE ON THE FreeRTOS.org WEB SITE.
  44  *
  45  * See http://www.freertos.org/a00110.html for a full list of configuration
  46  * options.
  47  *----------------------------------------------------------*/
  48
  49 /*
  50  * The FreeRTOS Cortex-A port implements a full interrupt nesting model.
  51  *
  52  * Interrupts that are assigned a priority at or below
  53  * configMAX_API_CALL_INTERRUPT_PRIORITY (which counter-intuitively in the ARM
  54  * generic interrupt controller [GIC] means a priority that has a numerical
  55  * value above configMAX_API_CALL_INTERRUPT_PRIORITY) can call interrupt safe
  56  * FreeRTOS API functions and will nest.
  57  *
  58  * Interrupts that are assigned a priority above
  59  * configMAX_API_CALL_INTERRUPT_PRIORITY (which in the GIC means a numerical
  60  * value below configMAX_API_CALL_INTERRUPT_PRIORITY) cannot call any FreeRTOS
  61  * API functions, will nest, and will not be masked by FreeRTOS critical
  62  * sections (although it is necessary for interrupts to be globally disabled
  63  * extremely briefly as the interrupt mask is updated in the GIC).
  64  *
  65  * FreeRTOS functions that can be called from an interrupt are those that end in
  66  * "FromISR".  FreeRTOS maintains a separate interrupt safe API to enable
  67  * interrupt entry to be shorter, faster, simpler and smaller.
  68  *
  69  * The Cyclone V SoC implements 32 unique interrupt priorities.  For the
  70  * purpose of setting configMAX_API_CALL_INTERRUPT_PRIORITY 32 represents the
  71  * lowest priority.
  72  */
  73 #define configMAX_API_CALL_INTERRUPT_PRIORITY   18
  74
  75 /* The application will define the array used as the RTOS heap to ensure it can
  76 be located in the (faster) on-chip RAM.  When this parameter is set to 1 the
  77 application must define an array using the name and size as follows below, but
  78 is free to locate the array in any suitable RAM region (the faster the better as
  79 the stacks used by the tasks are allocated from this array):
  80
  81 uint8_t ucHeap[ configTOTAL_HEAP_SIZE ];
  82
  83 */
  84 #define configAPPLICATION_ALLOCATED_HEAP                1
  85
  86 #define configCPU_CLOCK_HZ                                              /* Not used in this demo. */
  87 #define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
  88 #define configUSE_TICKLESS_IDLE                                 0
  89 #define configTICK_RATE_HZ                                              ( ( TickType_t ) 1000 )
  90 #define configUSE_PREEMPTION                                    1
  91 #define configMAX_PRIORITIES                                    ( 7 )
  92 #define configMINIMAL_STACK_SIZE                                ( ( unsigned short ) 200 )
  93 #define configTOTAL_HEAP_SIZE                                   ( 50 * 1024 )
  94 #define configMAX_TASK_NAME_LEN                                 ( 10 )
  95 #define configUSE_TRACE_FACILITY                                1
  96 #define configUSE_16_BIT_TICKS                                  0
  97 #define configIDLE_SHOULD_YIELD                                 1
  98 #define configUSE_MUTEXES                                               1
  99 #define configQUEUE_REGISTRY_SIZE                               8
 100 #define configCHECK_FOR_STACK_OVERFLOW                  2
 101 #define configUSE_RECURSIVE_MUTEXES                             1
 102 #define configUSE_APPLICATION_TASK_TAG                  0
 103 #define configUSE_COUNTING_SEMAPHORES                   1
 104 #define configUSE_QUEUE_SETS                                    1
 105
 106 /* Hook/Callback related definitions. */
 107 #define configUSE_MALLOC_FAILED_HOOK                    1
 108 #define configUSE_IDLE_HOOK                                             1
 109 #define configUSE_TICK_HOOK                                             1
 110 #define configUSE_DAEMON_TASK_STARTUP_HOOK              1
 111
 112 /* Co-routine definitions. */
 113 #define configUSE_CO_ROUTINES                                   0
 114 #define configMAX_CO_ROUTINE_PRIORITIES                 ( 2 )
 115
 116 /* Software timer definitions. */
 117 #define configUSE_TIMERS                                                1
 118 #define configTIMER_TASK_PRIORITY                               ( configMAX_PRIORITIES - 1 )
 119 #define configTIMER_QUEUE_LENGTH                                5
 120 #define configTIMER_TASK_STACK_DEPTH                    ( configMINIMAL_STACK_SIZE * 2 )
 121
 122 /* Set the following definitions to 1 to include the API function, or zero
 123 to exclude the API function. */
 124 #define INCLUDE_vTaskPrioritySet                                1
 125 #define INCLUDE_uxTaskPriorityGet                               1
 126 #define INCLUDE_vTaskDelete                                             1
 127 #define INCLUDE_vTaskCleanUpResources                   1
 128 #define INCLUDE_vTaskSuspend                                    1
 129 #define INCLUDE_vTaskDelayUntil                                 1
 130 #define INCLUDE_vTaskDelay                                              1
 131 #define INCLUDE_xTimerPendFunctionCall                  1
 132 #define INCLUDE_eTaskGetState                                   1
 133
 134 /* This demo makes use of one or more example stats formatting functions.  These
 135 format the raw data provided by the uxTaskGetSystemState() function in to human
 136 readable ASCII form.  See the notes in the implementation of vTaskList() within
 137 FreeRTOS/Source/tasks.c for limitations. */
 138 #define configUSE_STATS_FORMATTING_FUNCTIONS    1
 139
 140 /* Run time stats related definitions. */
 141 #define configGENERATE_RUN_TIME_STATS 1
 142 #define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() alt_globaltmr_start()
 143 #define portGET_RUN_TIME_COUNTER_VALUE()  ( ( uint32_t ) ( alt_globaltmr_get64() >> ( uint64_t ) 16 ) )
 144
 145
 146 /* The size of the global output buffer that is available for use when there
 147 are multiple command interpreters running at once (for example, one on a UART
 148 and one on TCP/IP).  This is done to prevent an output buffer being defined by
 149 each implementation - which would waste RAM.  In this case, there is only one
 150 command interpreter running. */
 151 #define configCOMMAND_INT_MAX_OUTPUT_SIZE 2096
 152
 153 /* Normal assert() semantics without relying on the provision of an assert.h
 154 header file. */
 155 void vAssertCalled( const char * pcFile, unsigned long ulLine );
 156 #define configASSERT( x ) if( ( x ) == 0 ) vAssertCalled( __FILE__, __LINE__ );
 157
 158 /* If configTASK_RETURN_ADDRESS is not defined then a task that attempts to
 159 return from its implementing function will end up in a "task exit error"
 160 function - which contains a call to configASSERT().  However this can give GCC
 161 some problems when it tries to unwind the stack, as the exit error function has
 162 nothing to return to.  To avoid this define configTASK_RETURN_ADDRESS to 0.  */
 163 #define configTASK_RETURN_ADDRESS       NULL
 164
 165
 166 /****** Hardware specific settings. *******************************************/
 167
 168  typedef struct INT_DISPATCH_s
 169  {
 170      alt_int_callback_t pxISR;
 171      void *             pvContext;
 172  }
 173  INT_DISPATCH_t;
 174
 175 void vRegisterIRQHandler( uint32_t ulID, alt_int_callback_t pxHandlerFunction, void *pvContext );
 176 void vApplicationIRQHandler( uint32_t ulICCIAR );
 177
 178 /*
 179  * The application must provide a function that configures a peripheral to
 180  * create the FreeRTOS tick interrupt, then define configSETUP_TICK_INTERRUPT()
 181  * in FreeRTOSConfig.h to call the function.  This file contains a function
 182  * that is suitable for use on the Zynq MPU.  FreeRTOS_Tick_Handler() must
 183  * be installed as the peripheral's interrupt handler.
 184  */
 185 void vConfigureTickInterrupt( void );
 186 #define configSETUP_TICK_INTERRUPT() vConfigureTickInterrupt();
 187
 188 void vClearTickInterrupt( void );
 189 #define configCLEAR_TICK_INTERRUPT() alt_gpt_int_clear_pending( ALT_GPT_CPU_PRIVATE_TMR );
 190
 191 /* The following constant describe the hardware, and are correct for the
 192 Cyclone V SoC. */
 193 #define configINTERRUPT_CONTROLLER_BASE_ADDRESS                 ( 0xFFFED000 )
 194 #define configINTERRUPT_CONTROLLER_CPU_INTERFACE_OFFSET ( -0xf00 )
 195 #define configUNIQUE_INTERRUPT_PRIORITIES                               32
 196
 197 #endif /* FREERTOS_CONFIG_H */
 198