Nios® V Processor Software Developer Handbook

ID 743810
Date 7/08/2024
Public
Document Table of Contents

16.4.3.3. FreeRTOS BSP

freertos.heap_method

  • Identifier: HEAP_METHOD
  • Type: Decimal number
  • Default Value: 4
  • Destination File: system.h
  • Description: Choose and implement one of the following heap_x.c source files:
    • heap_1.c – Simplest and does not permit memory to be freed.
    • heap_2.c – Permits memory to be freed, but does not coalescence adjacent free blocks.
    • heap_3.c – Wraps the standard malloc() and free() for thread safety.
    • heap_4.c – Coalescences adjacent free blocks to avoid fragmentation, and includes absolute address placement option.
    • heap_5.c – As per heap_4.c, in addition to span heap across multiple non-adjacent memory areas.
  • Restriction: Valid inputs as 1,2,3,4, and 5 only

freertos.os_port_has_mtime

  • Identifier: OS_PORT_HAS_MTIME
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: OS port has Machine Timer driver.
  • Restriction: none

freertos.os_thread_safe_newlib

  • Identifier: OS_THREAD_SAFE_C_LIBRARY
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable thread-safe C library.
  • Restriction: none

freertos.os_use_preemption

  • Identifier: OS_USE_PREEMPTION
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable OS preemption.
  • Restriction: none

freertos.os_use_16_bit_ticks

  • Identifier: OS_USE_16_BIT_TICKS
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Configure tick type. Select true for 16-bits, or false for 32-bits.
  • Restriction: none

freertos.os_max_priorities

  • Identifier: OS_MAX_PRIORITIES
  • Type: Decimal number
  • Default Value: 7
  • Destination File: system.h
  • Description: Maximum number of priorities supported.
  • Restriction: none

freertos.os_min_stack_size

  • Identifier: OS_MIN_STACK_SIZE
  • Type: Decimal number
  • Default Value: 300
  • Destination File: system.h
  • Description: OS minimum stack size.
  • Restriction: none

freertos.task.os_task_priority_set_en

  • Identifier: OS_TASK_PRIORITY_SET_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskPrioritySet().
  • Restriction: none

freertos.task.os_task_priority_get_en

  • Identifier: OS_TASK_PRIORITY_GET_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable uxTaskPriorityGet().
  • Restriction: none

freertos.task.os_task_delete_en

  • Identifier: OS_TASK_DELETE_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskDelete().
  • Restriction: none

freertos.task.os_task_clean_up_resources_en

  • Identifier: OS_TASK_CLEAN_UP_RESOURCES_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskCleanUpResources().
  • Restriction: none

freertos.task.os_task_suspend_en

  • Identifier: OS_TASK_SUSPEND_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskSuspend().
  • Restriction: none

freertos.task.os_task_delay_until_en

  • Identifier: OS_TASK_DELAY_UNTIL_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskDelayUntil().
  • Restriction: none

freertos.task.os_task_delay_en

  • Identifier: OS_TASK_DELAY_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable vTaskDelay().
  • Restriction: none

freertos.task.os_task_get_state_en

  • Identifier:OS_TASK_GET_STATE_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable eTaskGetState().
  • Restriction: none

freertos.task.os_task_abort_delay_en

  • Identifier: OS_TASK_ABORT_DELAY_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable xTaskAbortDelay().
  • Restriction: none

freertos.task.os_task_get_handle_en

  • Identifier: OS_TASK_GET_HANDLE_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable xTaskGetHandle().
  • Restriction: none

freertos.task.os_use_idle_hook

  • Identifier: OS_USE_IDLE_HOOK
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Include OS idle hook – vApplicationIdleHook().
  • Restriction: none

freertos.task.os_max_task_name_len

  • Identifier: OS_MAX_TASK_NAME_LEN
  • Type: Decimal number
  • Default Value: 16
  • Destination File: system.h
  • Description: Maximum task name length.
  • Restriction: none

freertos.task.os_tls_bytes

  • Identifier: OS_TLS_BYTES_PER_TASK
  • Type: Decimal number
  • Default Value: 256
  • Destination File: system.h
  • Description: Number of bytes for thread local support variables which map to the .tdata and .tbss program sections. The value can be determined by referring to the _tls_size linker symbol.
  • Restriction: none

freertos.task.os_use_timers

  • Identifier: OS_USE_TIMERS
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Use OS timers.
  • Restriction: none

freertos.task.os_timer_pend_function_call_en

  • Identifier: OS_TIMER_PEND_FUNCTION_CALL_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable xTimerPendFunctionCall().
  • Restriction: none

freertos.task.os_use_tick_hook

  • Identifier: OS_USE_TICK_HOOK
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Include OS tick hook – vApplicationTickHook().
  • Restriction: none

freertos.task.os_timer_queue_len

  • Identifier: OS_TIMER_QUEUE_LEN
  • Type: Decimal number
  • Default Value: 8
  • Destination File: system.h
  • Description: Timer queue length.
  • Restriction: none

freertos.task.os_timer_task_depth

  • Identifier: OS_TIMER_TASK_DEPTH
  • Type: Decimal number
  • Default Value: 160
  • Destination File: system.h
  • Description: OS timer task depth.
  • Restriction: none

freertos.mutex.os_mutex_en

  • Identifier: OS_MUTEX_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable mutex semaphores.
  • Restriction: none

freertos.mutex.os_recursive_mutex_en

  • Identifier:
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable recursive mutex.
  • Restriction: none

freertos.semaphore.os_counting_sem_en

  • Identifier: OS_COUNTING_SEM_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable counting semaphores.
  • Restriction: none

freertos.semaphore.os_semaphore_get_mutex_holder_en

  • Identifier: OS_SEMAPHORE_GET_MUTEX_HOLDER_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable xSemaphoreGetMutexHolder().
  • Restriction: none

freertos.queue.os_use_q_sets

  • Identifier: OS_USE_QUEUE_SETS
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Use OS queue sets.
  • Restriction: none

freertos.queue.os_q_reg_size

  • Identifier: OS_Q_REG_SIZE
  • Type: Decimal number
  • Default Value: 8
  • Destination File: system.h
  • Description: OS queue registry size.
  • Restriction: none

freertos.memory.os_memory_dynamic_allocation_en

  • Identifier: OS_MEMORY_DYNAMIC_ALLOCATION_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable memory dynamic allocation.
  • Restriction: none

freertos.memory.os_malloc_failed_hook_en

  • Identifier: OS_MALLOC_FAILED_HOOK_EN
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable malloc failed hook.
  • Restriction: none

freertos.memory.os_total_heap_size

  • Identifier: OS_TOTAL_HEAP_SIZE
  • Type: Decimal number
  • Default Value: 80000
  • Destination File: system.h
  • Description: OS total heap size.
  • Restriction: none

freertos.miscellaneous.os_use_trace_facility

  • Identifier: OS_USE_TRACE_FACILITY
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Use OS trace facility.
  • Restriction: none

freertos.miscellaneous.os_check_stack_overflow

  • Identifier: OS_CHECK_STACK_OVERFLOW
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Include OS stack overflow checking – vApplicationStackOverflowHook().
  • Restriction: none

freertos.miscellaneous.os_idle_should_yield

  • Identifier: OS_IDLE_SHOULD_YIELD
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Control the behavior of tasks at the idle priority.
  • Restriction: none