/************************************************************************************************** Filename: hal_board_cfg.h Revised: $Date: 2012-03-29 12:09:02 -0700 (Thu, 29 Mar 2012) $ Revision: $Revision: 29943 $ Description: Declarations for the CC2531 USB dongle. Copyright 2009-2010 Texas Instruments Incorporated. All rights reserved. IMPORTANT: Your use of this Software is limited to those specific rights granted under the terms of a software license agreement between the user who downloaded the software, his/her employer (which must be your employer) and Texas Instruments Incorporated (the "License"). You may not use this Software unless you agree to abide by the terms of the License. The License limits your use, and you acknowledge, that the Software may not be modified, copied or distributed unless embedded on a Texas Instruments microcontroller or used solely and exclusively in conjunction with a Texas Instruments radio frequency transceiver, which is integrated into your product. Other than for the foregoing purpose, you may not use, reproduce, copy, prepare derivative works of, modify, distribute, perform, display or sell this Software and/or its documentation for any purpose. YOU FURTHER ACKNOWLEDGE AND AGREE THAT THE SOFTWARE AND DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY, TITLE, NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL TEXAS INSTRUMENTS OR ITS LICENSORS BE LIABLE OR OBLIGATED UNDER CONTRACT, NEGLIGENCE, STRICT LIABILITY, CONTRIBUTION, BREACH OF WARRANTY, OR OTHER LEGAL EQUITABLE THEORY ANY DIRECT OR INDIRECT DAMAGES OR EXPENSES INCLUDING BUT NOT LIMITED TO ANY INCIDENTAL, SPECIAL, INDIRECT, PUNITIVE OR CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST DATA, COST OF PROCUREMENT OF SUBSTITUTE GOODS, TECHNOLOGY, SERVICES, OR ANY CLAIMS BY THIRD PARTIES (INCLUDING BUT NOT LIMITED TO ANY DEFENSE THEREOF), OR OTHER SIMILAR COSTS. Should you have any questions regarding your right to use this Software, contact Texas Instruments Incorporated at www.TI.com. **************************************************************************************************/ #ifndef HAL_BOARD_CFG_H #define HAL_BOARD_CFG_H /* ------------------------------------------------------------------------------------------------ * Includes * ------------------------------------------------------------------------------------------------ */ #include "hal_mcu.h" #include "hal_defs.h" #include "hal_types.h" #include "usb_board_cfg.h" /* ------------------------------------------------------------------------------------------------ * CC2590/CC2591 support * * Define HAL_PA_LNA_CC2590 if CC2530+CC2590EM is used * Define HAL_PA_LNA if CC2530+CC2591EM is used * Note that only one of them can be defined * ------------------------------------------------------------------------------------------------ */ #define xHAL_PA_LNA #define xHAL_PA_LNA_CC2590 /* ------------------------------------------------------------------------------------------------ * Board Indentifier * * Define the Board Identifier to HAL_BOARD_CC2530EB_REV13 for SmartRF05 EB 1.3 board * ------------------------------------------------------------------------------------------------ */ #if !defined (HAL_BOARD_CC2530EB_REV17) && !defined (HAL_BOARD_CC2530EB_REV13) #define HAL_BOARD_CC2530EB_REV17 #endif #define HAL_BOARD_CC2530USB /* ------------------------------------------------------------------------------------------------ * Clock Speed * ------------------------------------------------------------------------------------------------ */ #define HAL_CPU_CLOCK_MHZ 32 /* This flag should be defined if the SoC uses the 32MHz crystal * as the main clock source (instead of DCO). */ #define HAL_CLOCK_CRYSTAL #define OSC32K_CRYSTAL_INSTALLED FALSE /* 32 kHz clock source select in CLKCONCMD */ #if !defined (OSC32K_CRYSTAL_INSTALLED) || (defined (OSC32K_CRYSTAL_INSTALLED) && (OSC32K_CRYSTAL_INSTALLED == TRUE)) #define OSC_32KHZ 0x00 /* external 32 KHz xosc */ #else #define OSC_32KHZ 0x80 /* internal 32 KHz rcosc */ #endif #define HAL_CLOCK_STABLE() st( while (CLKCONSTA != (CLKCONCMD_32MHZ | OSC_32KHZ)); ) /* ------------------------------------------------------------------------------------------------ * LED Configuration * ------------------------------------------------------------------------------------------------ */ #define HAL_NUM_LEDS 2 #define HAL_LED_BLINK_DELAY() st( { volatile uint32 i; for (i=0; i<0x5800; i++) { }; } ) /* 1 - Green */ #define LED1_BV BV(0) #define LED1_SBIT P0_0 #define LED1_DDR P0DIR #define LED1_POLARITY ACTIVE_LOW /* 2 - Red */ #define LED2_BV BV(1) #define LED2_SBIT P1_1 #define LED2_DDR P1DIR #define LED2_POLARITY ACTIVE_HIGH /* ------------------------------------------------------------------------------------------------ * Push Button Configuration * ------------------------------------------------------------------------------------------------ */ #define ACTIVE_LOW ! #define ACTIVE_HIGH !! /* double negation forces result to be '1' */ /* S1 */ #define PUSH1_BV BV(2) #define PUSH1_SBIT P1_2 #define PUSH1_POLARITY ACTIVE_LOW /* S2 */ #define PUSH2_BV BV(3) #define PUSH2_SBIT P1_3 #define PUSH2_POLARITY ACTIVE_LOW /* ------------------------------------------------------------------------------------------------ * OSAL NV implemented by internal flash pages. * ------------------------------------------------------------------------------------------------ */ // Flash is partitioned into 8 banks of 32 KB or 16 pages. #define HAL_FLASH_PAGE_PER_BANK 16 // Flash is constructed of 128 pages of 2 KB. #define HAL_FLASH_PAGE_SIZE 2048 #define HAL_FLASH_WORD_SIZE 4 // CODE banks get mapped into the XDATA range 8000-FFFF. #define HAL_FLASH_PAGE_MAP 0x8000 // The last 16 bytes of the last available page are reserved for flash lock bits. // NV page definitions must coincide with segment declaration in project *.xcl file. #if defined NON_BANKED #define HAL_FLASH_LOCK_BITS 16 #define HAL_NV_PAGE_END 30 #define HAL_NV_PAGE_CNT 2 #else #define HAL_FLASH_LOCK_BITS 16 #define HAL_NV_PAGE_END 126 #define HAL_NV_PAGE_CNT 6 #endif // Re-defining Z_EXTADDR_LEN here so as not to include a Z-Stack .h file. #define HAL_FLASH_IEEE_SIZE 8 #define HAL_FLASH_IEEE_PAGE (HAL_NV_PAGE_END+1) #define HAL_FLASH_IEEE_OSET (HAL_FLASH_PAGE_SIZE - HAL_FLASH_LOCK_BITS - HAL_FLASH_IEEE_SIZE) #define HAL_INFOP_IEEE_OSET 0xC #define HAL_FLASH_DEV_PRIVATE_KEY_OSET 0x7D2 #define HAL_FLASH_CA_PUBLIC_KEY_OSET 0x7BC #define HAL_FLASH_IMPLICIT_CERT_OSET 0x78C #define HAL_NV_PAGE_BEG (HAL_NV_PAGE_END-HAL_NV_PAGE_CNT+1) // Used by DMA macros to shift 1 to create a mask for DMA registers. #define HAL_NV_DMA_CH 0 #define HAL_DMA_CH_RX 3 #define HAL_DMA_CH_TX 4 #define HAL_NV_DMA_GET_DESC() HAL_DMA_GET_DESC0() #define HAL_NV_DMA_SET_ADDR(a) HAL_DMA_SET_ADDR_DESC0((a)) /* ------------------------------------------------------------------------------------------------ * Serial Boot Loader: reserving the first 4 pages of flash and other memory in cc2530-sb.xcl. * ------------------------------------------------------------------------------------------------ */ #define HAL_SB_IMG_ADDR 0x2000 #define HAL_SB_CRC_ADDR 0x2090 // Size of internal flash less 4 pages for boot loader, 6 pages for NV, & 1 page for lock bits. #define HAL_SB_IMG_SIZE (0x40000 - 0x2000 - 0x3000 - 0x0800) /* ------------------------------------------------------------------------------------------------ * Macros * ------------------------------------------------------------------------------------------------ */ /* ----------- Cache Prefetch control ---------- */ #define PREFETCH_ENABLE() st( FCTL = 0x08; ) #define PREFETCH_DISABLE() st( FCTL = 0x04; ) /* ----------- Board Initialization ---------- */ #define HAL_BOARD_INIT() \ { \ uint16 i; \ \ SLEEPCMD &= ~OSC_PD; /* turn on 16MHz RC and 32MHz XOSC */ \ while (!(SLEEPSTA & XOSC_STB)); /* wait for 32MHz XOSC stable */ \ asm("NOP"); /* chip bug workaround */ \ for (i=0; i<504; i++) asm("NOP"); /* Require 63us delay for all revs */ \ CLKCONCMD = (CLKCONCMD_32MHZ | OSC_32KHZ); /* Select 32MHz XOSC and the source for 32K clock */ \ while (CLKCONSTA != (CLKCONCMD_32MHZ | OSC_32KHZ)); /* Wait for the change to be effective */ \ SLEEPCMD |= OSC_PD; /* turn off 16MHz RC */ \ \ /* Turn on cache prefetch mode */ \ PREFETCH_ENABLE(); \ \ HAL_TURN_OFF_LED1(); \ LED1_DDR |= LED1_BV; \ HAL_TURN_OFF_LED2(); \ LED2_DDR |= LED2_BV; \ } /* ----------- Debounce ---------- */ #define HAL_DEBOUNCE(expr) { int i; for (i=0; i<500; i++) { if (!(expr)) i = 0; } } /* ----------- Push Buttons ---------- */ #define HAL_PUSH_BUTTON1() (PUSH1_POLARITY (PUSH1_SBIT)) #define HAL_PUSH_BUTTON2() (PUSH2_POLARITY (PUSH2_SBIT)) #define HAL_PUSH_BUTTON3() (0) #define HAL_PUSH_BUTTON4() (0) #define HAL_PUSH_BUTTON5() (0) #define HAL_PUSH_BUTTON6() (0) /* ----------- LED's ---------- */ #define HAL_TURN_OFF_LED1() st( LED1_SBIT = LED1_POLARITY (0); ) #define HAL_TURN_OFF_LED2() st( LED2_SBIT = LED2_POLARITY (0); ) #define HAL_TURN_OFF_LED3() HAL_TURN_OFF_LED1() #define HAL_TURN_OFF_LED4() HAL_TURN_OFF_LED2() #define HAL_TURN_ON_LED1() st( LED1_SBIT = LED1_POLARITY (1); ) #define HAL_TURN_ON_LED2() st( LED2_SBIT = LED2_POLARITY (1); ) #define HAL_TURN_ON_LED3() HAL_TURN_ON_LED1() #define HAL_TURN_ON_LED4() HAL_TURN_ON_LED2() #define HAL_TOGGLE_LED1() st( if (LED1_SBIT) { LED1_SBIT = 0; } else { LED1_SBIT = 1;} ) #define HAL_TOGGLE_LED2() st( if (LED2_SBIT) { LED2_SBIT = 0; } else { LED2_SBIT = 1;} ) #define HAL_TOGGLE_LED3() HAL_TOGGLE_LED1() #define HAL_TOGGLE_LED4() HAL_TOGGLE_LED2() #define HAL_STATE_LED1() (LED1_POLARITY (LED1_SBIT)) #define HAL_STATE_LED2() (LED2_POLARITY (LED2_SBIT)) #define HAL_STATE_LED3() HAL_STATE_LED1() #define HAL_STATE_LED4() HAL_STATE_LED2() /* ----------- Minimum safe bus voltage ---------- */ // Vdd/3 / Internal Reference X ENOB --> (Vdd / 3) / 1.15 X 127 #define VDD_2_0 74 // 2.0 V required to safely read/write internal flash. #define VDD_MIN_RUN VDD_2_0 #define VDD_MIN_NV (VDD_2_0+4) // 5% margin over minimum to survive a page erase and compaction. /* ------------------------------------------------------------------------------------------------ * Driver Configuration * ------------------------------------------------------------------------------------------------ */ /* Set to TRUE enable H/W TIMER usage, FALSE disable it */ #ifndef HAL_TIMER #define HAL_TIMER FALSE #endif /* Set to TRUE enable ADC usage, FALSE disable it */ #ifndef HAL_ADC #define HAL_ADC TRUE #endif /* Set to TRUE enable DMA usage, FALSE disable it */ #ifndef HAL_DMA #define HAL_DMA TRUE #endif /* Set to TRUE enable Flash access, FALSE disable it */ #ifndef HAL_FLASH #define HAL_FLASH TRUE #endif /* Set to TRUE enable AES usage, FALSE disable it */ #ifndef HAL_AES #define HAL_AES TRUE #endif #ifndef HAL_AES_DMA #define HAL_AES_DMA TRUE #endif /* Set to TRUE enable LCD usage, FALSE disable it */ #ifndef HAL_LCD #define HAL_LCD FALSE #endif /* Set to TRUE enable LED usage, FALSE disable it */ #ifndef HAL_LED #define HAL_LED TRUE #endif #if (!defined BLINK_LEDS) && (HAL_LED == TRUE) #define BLINK_LEDS #endif /* Set to TRUE enable KEY usage, FALSE disable it */ #ifndef HAL_KEY #define HAL_KEY TRUE #endif /* Set to TRUE enable UART usage, FALSE disable it */ #ifndef HAL_UART #define HAL_UART TRUE #define HAL_UART_DMA 0 #define HAL_UART_ISR 0 #define HAL_UART_USB 1 #endif #ifndef HAL_UART_DMA #define HAL_UART_DMA 0 #endif #ifndef HAL_UART_ISR #define HAL_UART_ISR 0 #endif #ifndef HAL_UART_USB # if HAL_UART # define HAL_UART_USB 1 # else # define HAL_UART_USB 0 # endif #endif /* Set to TRUE enable HID usage, FALSE disable it */ #ifndef HAL_HID #define HAL_HID FALSE #endif #endif /******************************************************************************************************* */