24. Configuring a System

• 24.1. Introduction
• 24.2. Default Value Selection Philosophy
• 24.3. Sizing the RTEMS Workspace
• 24.4. Potential Issues with RTEMS Workspace Size Estimation
• 24.5. Configuration Example
• 24.6. Unlimited Objects
  • 24.6.1. Unlimited Objects by Class
  • 24.6.2. Unlimited Objects by Default
• 24.7. General System Configuration
  • 24.7.1. CONFIGURE_DIRTY_MEMORY
  • 24.7.2. CONFIGURE_DISABLE_NEWLIB_REENTRANCY
  • 24.7.3. CONFIGURE_EXECUTIVE_RAM_SIZE
  • 24.7.4. CONFIGURE_EXTRA_TASK_STACKS
  • 24.7.5. CONFIGURE_INITIAL_EXTENSIONS
  • 24.7.6. CONFIGURE_INTERRUPT_STACK_SIZE
  • 24.7.7. CONFIGURE_MALLOC_DIRTY
  • 24.7.8. CONFIGURE_MAXIMUM_FILE_DESCRIPTORS
  • 24.7.9. CONFIGURE_MAXIMUM_PROCESSORS
  • 24.7.10. CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
  • 24.7.11. CONFIGURE_MEMORY_OVERHEAD
  • 24.7.12. CONFIGURE_MESSAGE_BUFFER_MEMORY
  • 24.7.13. CONFIGURE_MICROSECONDS_PER_TICK
  • 24.7.14. CONFIGURE_MINIMUM_TASK_STACK_SIZE
  • 24.7.15. CONFIGURE_STACK_CHECKER_ENABLED
  • 24.7.16. CONFIGURE_TICKS_PER_TIMESLICE
  • 24.7.17. CONFIGURE_UNIFIED_WORK_AREAS
  • 24.7.18. CONFIGURE_UNLIMITED_ALLOCATION_SIZE
  • 24.7.19. CONFIGURE_UNLIMITED_OBJECTS
  • 24.7.20. CONFIGURE_VERBOSE_SYSTEM_INITIALIZATION
  • 24.7.21. CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
• 24.8. Device Driver Configuration
  • 24.8.1. CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
  • 24.8.2. CONFIGURE_APPLICATION_EXTRA_DRIVERS
  • 24.8.3. CONFIGURE_APPLICATION_NEEDS_ATA_DRIVER
  • 24.8.4. CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
  • 24.8.5. CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
  • 24.8.6. CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
  • 24.8.7. CONFIGURE_APPLICATION_NEEDS_IDE_DRIVER
  • 24.8.8. CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
  • 24.8.9. CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
  • 24.8.10. CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER
  • 24.8.11. CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER
  • 24.8.12. CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
  • 24.8.13. CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
  • 24.8.14. CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
  • 24.8.15. CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
  • 24.8.16. CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
  • 24.8.17. CONFIGURE_ATA_DRIVER_TASK_PRIORITY
  • 24.8.18. CONFIGURE_MAXIMUM_DRIVERS
• 24.9. Classic API Configuration
  • 24.9.1. CONFIGURE_MAXIMUM_BARRIERS
  • 24.9.2. CONFIGURE_MAXIMUM_MESSAGE_QUEUES
  • 24.9.3. CONFIGURE_MAXIMUM_PARTITIONS
  • 24.9.4. CONFIGURE_MAXIMUM_PERIODS
  • 24.9.5. CONFIGURE_MAXIMUM_PORTS
  • 24.9.6. CONFIGURE_MAXIMUM_REGIONS
  • 24.9.7. CONFIGURE_MAXIMUM_SEMAPHORES
  • 24.9.8. CONFIGURE_MAXIMUM_TASKS
  • 24.9.9. CONFIGURE_MAXIMUM_TIMERS
  • 24.9.10. CONFIGURE_MAXIMUM_USER_EXTENSIONS
• 24.10. Classic API Initialization Task Configuration
  • 24.10.1. CONFIGURE_INIT_TASK_ARGUMENTS
  • 24.10.2. CONFIGURE_INIT_TASK_ATTRIBUTES
  • 24.10.3. CONFIGURE_INIT_TASK_ENTRY_POINT
  • 24.10.4. CONFIGURE_INIT_TASK_INITIAL_MODES
  • 24.10.5. CONFIGURE_INIT_TASK_NAME
  • 24.10.6. CONFIGURE_INIT_TASK_PRIORITY
  • 24.10.7. CONFIGURE_INIT_TASK_STACK_SIZE
  • 24.10.8. CONFIGURE_RTEMS_INIT_TASKS_TABLE
• 24.11. POSIX API Configuration
  • 24.11.1. CONFIGURE_MAXIMUM_POSIX_KEYS
  • 24.11.2. CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS
  • 24.11.3. CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
  • 24.11.4. CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
  • 24.11.5. CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
  • 24.11.6. CONFIGURE_MAXIMUM_POSIX_SHMS
  • 24.11.7. CONFIGURE_MAXIMUM_POSIX_THREADS
  • 24.11.8. CONFIGURE_MAXIMUM_POSIX_TIMERS
  • 24.11.9. CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE
• 24.12. POSIX Initialization Thread Configuration
  • 24.12.1. CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
  • 24.12.2. CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
  • 24.12.3. CONFIGURE_POSIX_INIT_THREAD_TABLE
• 24.13. Event Recording Configuration
  • 24.13.1. CONFIGURE_RECORD_EXTENSIONS_ENABLED
  • 24.13.2. CONFIGURE_RECORD_FATAL_DUMP_BASE64
  • 24.13.3. CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB
  • 24.13.4. CONFIGURE_RECORD_PER_PROCESSOR_ITEMS
• 24.14. Filesystem Configuration
  • 24.14.1. CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
  • 24.14.2. CONFIGURE_FILESYSTEM_ALL
  • 24.14.3. CONFIGURE_FILESYSTEM_DOSFS
  • 24.14.4. CONFIGURE_FILESYSTEM_FTPFS
  • 24.14.5. CONFIGURE_FILESYSTEM_IMFS
  • 24.14.6. CONFIGURE_FILESYSTEM_JFFS2
  • 24.14.7. CONFIGURE_FILESYSTEM_NFS
  • 24.14.8. CONFIGURE_FILESYSTEM_RFS
  • 24.14.9. CONFIGURE_FILESYSTEM_TFTPFS
  • 24.14.10. CONFIGURE_IMFS_DISABLE_CHMOD
  • 24.14.11. CONFIGURE_IMFS_DISABLE_CHOWN
  • 24.14.12. CONFIGURE_IMFS_DISABLE_LINK
  • 24.14.13. CONFIGURE_IMFS_DISABLE_MKNOD
  • 24.14.14. CONFIGURE_IMFS_DISABLE_MKNOD_DEVICE
  • 24.14.15. CONFIGURE_IMFS_DISABLE_MKNOD_FILE
  • 24.14.16. CONFIGURE_IMFS_DISABLE_MOUNT
  • 24.14.17. CONFIGURE_IMFS_DISABLE_READDIR
  • 24.14.18. CONFIGURE_IMFS_DISABLE_READLINK
  • 24.14.19. CONFIGURE_IMFS_DISABLE_RENAME
  • 24.14.20. CONFIGURE_IMFS_DISABLE_RMNOD
  • 24.14.21. CONFIGURE_IMFS_DISABLE_SYMLINK
  • 24.14.22. CONFIGURE_IMFS_DISABLE_UNMOUNT
  • 24.14.23. CONFIGURE_IMFS_DISABLE_UTIME
  • 24.14.24. CONFIGURE_IMFS_ENABLE_MKFIFO
  • 24.14.25. CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
  • 24.14.26. CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
  • 24.14.27. CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
• 24.15. Block Device Cache Configuration
  • 24.15.1. CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
  • 24.15.2. CONFIGURE_BDBUF_BUFFER_MAX_SIZE
  • 24.15.3. CONFIGURE_BDBUF_BUFFER_MIN_SIZE
  • 24.15.4. CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
  • 24.15.5. CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
  • 24.15.6. CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
  • 24.15.7. CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
  • 24.15.8. CONFIGURE_BDBUF_TASK_STACK_SIZE
  • 24.15.9. CONFIGURE_SWAPOUT_BLOCK_HOLD
  • 24.15.10. CONFIGURE_SWAPOUT_SWAP_PERIOD
  • 24.15.11. CONFIGURE_SWAPOUT_TASK_PRIORITY
  • 24.15.12. CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
  • 24.15.13. CONFIGURE_SWAPOUT_WORKER_TASKS
• 24.16. Task Stack Allocator Configuration
  • 24.16.1. CONFIGURE_TASK_STACK_ALLOCATOR
  • 24.16.2. CONFIGURE_TASK_STACK_ALLOCATOR_INIT
  • 24.16.3. CONFIGURE_TASK_STACK_DEALLOCATOR
  • 24.16.4. CONFIGURE_TASK_STACK_FROM_ALLOCATOR
  • 24.16.5. CONFIGURE_TASK_STACK_ALLOCATOR_AVOIDS_WORK_SPACE
• 24.17. Idle Task Configuration
  • 24.17.1. CONFIGURE_IDLE_TASK_BODY
  • 24.17.2. CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
  • 24.17.3. CONFIGURE_IDLE_TASK_STACK_SIZE
• 24.18. General Scheduler Configuration
  • 24.18.1. CONFIGURE_CBS_MAXIMUM_SERVERS
  • 24.18.2. CONFIGURE_MAXIMUM_PRIORITY
  • 24.18.3. CONFIGURE_SCHEDULER_ASSIGNMENTS
  • 24.18.4. CONFIGURE_SCHEDULER_CBS
  • 24.18.5. CONFIGURE_SCHEDULER_EDF
  • 24.18.6. CONFIGURE_SCHEDULER_EDF_SMP
  • 24.18.7. CONFIGURE_SCHEDULER_NAME
  • 24.18.8. CONFIGURE_SCHEDULER_PRIORITY
  • 24.18.9. CONFIGURE_SCHEDULER_PRIORITY_AFFINITY_SMP
  • 24.18.10. CONFIGURE_SCHEDULER_PRIORITY_SMP
  • 24.18.11. CONFIGURE_SCHEDULER_SIMPLE
  • 24.18.12. CONFIGURE_SCHEDULER_SIMPLE_SMP
  • 24.18.13. CONFIGURE_SCHEDULER_STRONG_APA
  • 24.18.14. CONFIGURE_SCHEDULER_USER
• 24.19. Clustered Scheduler Configuration
  • 24.19.1. Configuration Step 1 - Scheduler Algorithms
  • 24.19.2. Configuration Step 2 - Schedulers
  • 24.19.3. Configuration Step 3 - Scheduler Table
  • 24.19.4. Configuration Step 4 - Processor to Scheduler Assignment
  • 24.19.5. Configuration Example
  • 24.19.6. Configuration Errors
• 24.20. BSP Related Configuration Options
  • 24.20.1. BSP_IDLE_TASK_BODY
  • 24.20.2. BSP_IDLE_TASK_STACK_SIZE
  • 24.20.3. BSP_INITIAL_EXTENSION
  • 24.20.4. BSP_INTERRUPT_STACK_SIZE
  • 24.20.5. CONFIGURE_BSP_PREREQUISITE_DRIVERS
  • 24.20.6. CONFIGURE_DISABLE_BSP_SETTINGS
  • 24.20.7. CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
• 24.21. Multiprocessing Configuration
  • 24.21.1. CONFIGURE_MP_APPLICATION
  • 24.21.2. CONFIGURE_EXTRA_MPCI_RECEIVE_SERVER_STACK
  • 24.21.3. CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
  • 24.21.4. CONFIGURE_MP_MAXIMUM_NODES
  • 24.21.5. CONFIGURE_MP_MAXIMUM_PROXIES
  • 24.21.6. CONFIGURE_MP_MPCI_TABLE_POINTER
  • 24.21.7. CONFIGURE_MP_NODE_NUMBER
• 24.22. PCI Library Configuration
• 24.23. Ada Configuration
• 24.24. Obsolete Configuration Options
  • 24.24.1. CONFIGURE_BDBUF_BUFFER_COUNT
  • 24.24.2. CONFIGURE_BDBUF_BUFFER_SIZE
  • 24.24.3. CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS
  • 24.24.4. CONFIGURE_ENABLE_GO
  • 24.24.5. CONFIGURE_GNAT_RTEMS
  • 24.24.6. CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
  • 24.24.7. CONFIGURE_HAS_OWN_BDBUF_TABLE
  • 24.24.8. CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
  • 24.24.9. CONFIGURE_HAS_OWN_INIT_TASK_TABLE
  • 24.24.10. CONFIGURE_HAS_OWN_MOUNT_TABLE
  • 24.24.11. CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
  • 24.24.12. CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
  • 24.24.13. CONFIGURE_MAXIMUM_ADA_TASKS
  • 24.24.14. CONFIGURE_MAXIMUM_DEVICES
  • 24.24.15. CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
  • 24.24.16. CONFIGURE_MAXIMUM_GO_CHANNELS
  • 24.24.17. CONFIGURE_MAXIMUM_GOROUTINES
  • 24.24.18. CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
  • 24.24.19. CONFIGURE_NUMBER_OF_TERMIOS_PORTS
  • 24.24.20. CONFIGURE_MAXIMUM_POSIX_BARRIERS
  • 24.24.21. CONFIGURE_MAXIMUM_POSIX_CONDITION_VARIABLES
  • 24.24.22. CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUE_DESCRIPTORS
  • 24.24.23. CONFIGURE_MAXIMUM_POSIX_MUTEXES
  • 24.24.24. CONFIGURE_MAXIMUM_POSIX_RWLOCKS
  • 24.24.25. CONFIGURE_MAXIMUM_POSIX_SPINLOCKS
  • 24.24.26. CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
  • 24.24.27. CONFIGURE_SMP_APPLICATION
  • 24.24.28. CONFIGURE_SMP_MAXIMUM_PROCESSORS
  • 24.24.29. CONFIGURE_TERMIOS_DISABLED