/************************************************************************************ * configs/cc3200/include/board.h * include/arch/board/board.h * * Copyright (C) 2010 Gregory Nutt. All rights reserved. * Authors: Gregory Nutt * Jim Ewing * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ************************************************************************************/ #ifndef __CONFIGS_CC3200_LAUNCHPAD_INCLUDE_BOARD_H #define __CONFIGS_CC3200_LAUNCHPAD_INCLUDE_BOARD_H /************************************************************************************ * Included Files ************************************************************************************/ /************************************************************************************ * Pre-processor Definitions ************************************************************************************/ /* Clocking *************************************************************************/ /* RCC settings. Crystal on-board the CC3200 LaunchPad include: * * 40MHz internal clock * 32.768kHz RTC clock */ #define SYSCON_RCC_XTAL SYSCON_RCC_XTAL40000KHZ /* On-board crystal is 40 MHz */ #define XTAL_FREQUENCY 40000000 /* Oscillator source is the main oscillator */ #define SYSCON_RCC_OSCSRC SYSCON_RCC_OSCSRC_MOSC #define SYSCON_RCC2_OSCSRC SYSCON_RCC2_OSCSRC2_MOSC #define OSCSRC_FREQUENCY XTAL_FREQUENCY #define TIVA_SYSDIV 5 #define SYSCLK_FREQUENCY 80000000 /* 80MHz */ /* Other RCC settings: * * - Main and internal oscillators enabled. * - PLL and sys dividers not bypassed * - PLL not powered down * - No auto-clock gating reset */ #define TIVA_RCC_VALUE (SYSCON_RCC_OSCSRC | SYSCON_RCC_XTAL | \ SYSCON_RCC_USESYSDIV | SYSCON_RCC_SYSDIV(TIVA_SYSDIV)) /* RCC2 settings * * - PLL and sys dividers not bypassed. * - PLL not powered down * - Not using RCC2 * * When SYSCON_RCC2_DIV400 is not selected, SYSDIV2 is the divisor-1. * When SYSCON_RCC2_DIV400 is selected, SYSDIV2 is the divisor-1)/2, plus * the LSB: * * SYSDIV2 SYSDIV2LSB DIVISOR * 0 N/A 2 * 1 0 3 * " 1 4 * 2 0 5 * " 1 6 * etc. */ #if (TIVA_SYSDIV & 1) == 0 # define TIVA_RCC2_VALUE (SYSCON_RCC2_OSCSRC | SYSCON_RCC2_SYSDIV2LSB | \ SYSCON_RCC2_SYSDIV_DIV400(TIVA_SYSDIV) | \ SYSCON_RCC2_DIV400 | SYSCON_RCC2_USERCC2) #else # define TIVA_RCC2_VALUE (SYSCON_RCC2_OSCSRC | SYSCON_RCC2_SYSDIV_DIV400(TIVA_SYSDIV) | \ SYSCON_RCC2_DIV400 | SYSCON_RCC2_USERCC2) #endif /* LED definitions ******************************************************************/ /* The CC3200 LaunchPad has three RGB LEDs. * * BOARD_LED_R -- Connected to PF1 * BOARD_LED_G -- Connected to PF3 * BOARD_LED_Y -- Connected to PF2 */ /* LED index values for use with cc3200_setled() */ #define BOARD_LED_R 1 #define BOARD_LED_G 2 #define BOARD_LED_Y 3 #define BOARD_NLEDS 3 /* LED bits for use with cc3200_setleds() */ #define BOARD_LED1_BIT (1 << BOARD_LED1) #define BOARD_LED2_BIT (1 << BOARD_LED2) /* If CONFIG_ARCH_LEDS is defined, then automated support for the LaunchPad LEDs * will be included in the build: * * OFF: * - OFF means that the OS is still initializing. Initialization is very fast so * if you see this at all, it probably means that the system is hanging up * somewhere in the initialization phases. * * GREEN * - This means that the OS completed initialization. * * BLUE: * - Whenever and interrupt or signal handler is entered, the BLUE LED is * illuminated and extinguished when the interrupt or signal handler exits. * * RED: * - If a recovered assertion occurs, the RED LED will be illuminated * briefly while the assertion is handled. You will probably never see this. * * Flashing RED: * - In the event of a fatal crash, * extinguished and the RED component will FLASH at a 2Hz rate. */ /* RED GREEN BLUE */ #define LED_STARTED 0 /* OFF OFF OFF */ #define LED_HEAPALLOCATE 0 /* OFF OFF OFF */ #define LED_IRQSENABLED 0 /* OFF OFF OFF */ #define LED_STACKCREATED 1 /* OFF ON OFF */ #define LED_INIRQ 2 /* NC NC ON (momentary) */ #define LED_SIGNAL 2 /* NC NC ON (momentary) */ #define LED_ASSERTION 3 /* ON NC NC (momentary) */ #define LED_PANIC 4 /* ON OFF OFF (flashing 2Hz) */ /* LED definitions ******************************************************************/ /* The CC3200 LaunchPad has two buttons: * * BOARD_SW1 -- Connected to PF4 * BOARD_SW2 -- Connected to PF0 */ #define BUTTON_SW1 0 #define BUTTON_SW2 1 #define BUTTON_SW3 2 #define NUM_BUTTONS 3 #define BUTTON_SW1_BIT (1 << BUTTON_SW1) #define BUTTON_SW2_BIT (1 << BUTTON_SW2) #define BUTTON_SW3_BIT (1 << BUTTON_SW3) /************************************************************************************ * Public Function Prototypes ************************************************************************************/ #ifndef __ASSEMBLY__ /************************************************************************************ * Name: tiva_boardinitialize * * Description: * All Tiva architectures must provide the following entry point. This entry * point is called early in the initialization -- after all memory has been * configured and mapped but before any devices have been initialized. * ************************************************************************************/ void tiva_boardinitialize(void); /************************************************************************************ * Name: cc3200_ledinit, cc3200_setled, and cc3200_setleds * * Description: * If CONFIG_ARCH_LEDS is defined, then NuttX will control the on-board LED. If * CONFIG_ARCH_LEDS is not defined, then the following interfaces are available to * control the LEDs from user applications. * ************************************************************************************/ #ifndef CONFIG_ARCH_LEDS void cc3200_ledinit(void); void cc3200_setled(int led, unsigned char ledon); void cc3200_setleds(unsigned char ledset); #endif /************************************************************************************ * Name: up_buttoninit * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_buttons() may be called to collect the current state of all buttons or * up_irqbutton() may be called to register button interrupt handlers. * ************************************************************************************/ #ifdef CONFIG_ARCH_BUTTONS void up_buttoninit(void); /************************************************************************************ * Name: up_buttons * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_buttons() may be called to collect the current state of all buttons. * * After up_buttoninit() has been called, up_buttons() may be called to collect * the state of all buttons. up_buttons() returns an 8-bit bit set with each bit * associated with a button. See the BOARD_BUTTON_*_BIT and BOARD_JOYSTICK_*_BIT * definitions above for the meaning of each bit. * ************************************************************************************/ uint8_t up_buttons(void); /************************************************************************************ * Button support. * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_irqbutton() may be called to register button interrupt handlers. * * up_irqbutton() may be called to register an interrupt handler that will be called * when a button is depressed or released. The ID value is a button enumeration * value that uniquely identifies a button resource. See the BOARD_BUTTON_* and * BOARD_JOYSTICK_* definitions in above for the meaning of enumeration values * The previous interrupt handler address is returned (so that it may restored, if * so desired). * * Note that up_irqbutton() also enables button interrupts. Button interrupts * will remain enabled after the interrupt handler is attached. Interrupts may * be disabled (and detached) by calling up_irqbutton with irqhandler equal to * NULL. * ************************************************************************************/ #if defined(CONFIG_ARCH_IRQBUTTONS) && defined(CONFIG_GPIO_IRQ) xcpt_t up_irqbutton(int id, xcpt_t irqhandler); #endif #endif /* CONFIG_ARCH_BUTTONS */ #endif /* __ASSEMBLY__ */ #endif /* __CONFIGS_CC3200_LAUNCHPAD_INCLUDE_BOARD_H */