/** * @defgroup AVR MegaAVR * @{ * @details AVR port details. This section how the ChibiOS/RT features are * implemented on this architecture. * * @section AVR_STATES Mapping of the System States in the AVR port * The ChibiOS/RT logical @ref system_states are mapped as follow in the AVR * port: * - Init. This state is represented by the startup code and the * initialization code before @p chSysInit() is executed. It has not a * special hardware state associated. * - Normal. This is the state the system has after executing * @p chSysInit(). Interrupts are enabled. * - Suspended. Interrupts are disabled. * - Disabled. Interrupts are enabled. This state is equivalent to the * Suspended state because there are no fast interrupts in this architecture. * - Sleep. This state is entered with the execution of the specific * instruction @p sleep. * - S-Locked. Interrupts are disabled. * - I-Locked. This state is equivalent to the SRI state, the * @p chSysLockI() and @p chSysUnlockI() APIs do nothing (still use them in * order to formally change state because this may change). * - Serving Regular Interrupt. Normal interrupt service code. * - Serving Fast Interrupt. Not present in this architecture. * - Serving Non-Maskable Interrupt. Not present in this architecture. * - Halted. Implemented as an infinite loop with interrupts disabled. * * @section AVR_NOTES The AVR port notes * - The AVR does not have a dedicated interrupt stack, make sure to reserve * enough stack space for interrupts in each thread stack. This can be done * by modifying the @p INT_REQUIRED_STACK macro into * ./ports/AVR/chcore.h. * * @ingroup Ports */ /** @} */ /** * @defgroup AVR_CONF Configuration Options * @{ * @brief AVR Configuration Options. * @details The AVR port allows some architecture-specific configurations * settingsthat can be specified externally, as example on the compiler * command line: * - @p INT_REQUIRED_STACK, this value represent the amount of stack space * used by the interrupt handlers.
* The default for this value is @p 32, this space is allocated for each * thread so be careful in order to not waste precious RAM space.
* The default value is set into ./ports/AVR/chcore.h. * * @ingroup AVR */ /** @} */ /** * @defgroup AVR_CORE AVR Core Implementation * @{ * @brief AVR specific port code, structures and macros. * * @ingroup AVR * @file ports/AVR/chtypes.h Port types. * @file ports/AVR/chcore.h Port related structures and macros. * @file ports/AVR/chcore.c Port related code. */ /** @} */ /** * @defgroup AVR_DRIVERS AVR Drivers * @{ * @brief Device drivers included in the AVR support. * * @ingroup AVR */ /** @} */ /** * @defgroup AVR_SERIAL USART Support * @{ * @brief USART support. * @details The serial driver supports both the AVR USARTs in asynchronous * mode. * * @ingroup AVR_DRIVERS */ /** @} */