/* ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 Giovanni Di Sirio. This file is part of ChibiOS/RT. ChibiOS/RT is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. ChibiOS/RT is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ /** * @defgroup MSP430 MSP430 * @details MSP430 port details. This section how the ChibiOS/RT features are * implemented on this architecture. * * @section MSP430_STATES Mapping of the System States in the MSP430 port * The ChibiOS/RT logical @ref system_states are mapped as follow in the MSP430 * 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. Not yet implemented. * - 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. The MSP430 has several non * maskable interrupt sources that can be associated to this state. * - Halted. Implemented as an infinite loop with interrupts disabled. * . * @section MSP430_NOTES The MSP430 port notes * - The MSP430 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/MSP430/chcore.h. * - The state of the hardware multiplier is not saved in the thread context, * make sure to use it in Suspended state (interrupts masked). * - The port code does not define the switch to a low power mode for the * idle thread because the MSP430 has several low power modes. You can * select the proper low power mode for you application by defining the * macro @p port_wait_for_interrupt(). * . * @ingroup ports */ /** * @defgroup MSP430_CONF Configuration Options * @brief MSP430 Configuration Options. * @details The MSP430 port allows some architecture-specific configurations * settings that can be overridden by redefining them in @p chconf.h. * Usually there is no need to change the default values. * - @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 ./os/ports/GCC/MSP430/chcore.h. * - @p IDLE_THREAD_STACK_SIZE, stack area size to be assigned to the IDLE * thread. Usually there is no need to change this value unless inserting * code in the IDLE thread hook macro. * . * @ingroup MSP430 */ /** * @defgroup MSP430_CORE Core Port Implementation * @brief MSP430 specific port code, structures and macros. * * @ingroup MSP430 * @file MSP430/chtypes.h Port types. * @file MSP430/chcore.h Port related structures and macros. * @file MSP430/chcore.c Port related code. */