335 lines
9.6 KiB
C
335 lines
9.6 KiB
C
/**************************************************************************************************
|
|
Filename: OnBoard.h
|
|
Revised: $Date: 2012-03-29 12:09:02 -0700 (Thu, 29 Mar 2012) $
|
|
Revision: $Revision: 29943 $
|
|
|
|
Description: Defines stuff for EVALuation boards
|
|
Notes: This file targets the Chipcon CC2530/31
|
|
|
|
|
|
Copyright 2005-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 ONBOARD_H
|
|
#define ONBOARD_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
* INCLUDES
|
|
*/
|
|
|
|
#include "hal_mcu.h"
|
|
#include "hal_uart.h"
|
|
#include "hal_sleep.h"
|
|
#include "osal.h"
|
|
|
|
/*********************************************************************
|
|
* GLOBAL VARIABLES
|
|
*/
|
|
|
|
// 64-bit Extended Address of this device
|
|
extern uint8 aExtendedAddress[8];
|
|
|
|
/*********************************************************************
|
|
* CONSTANTS
|
|
*/
|
|
|
|
// Timer clock and power-saving definitions
|
|
#define TIMER_DECR_TIME 1 // 1ms - has to be matched with TC_OCC
|
|
|
|
/* OSAL timer defines */
|
|
#define TICK_TIME 1000 // Timer per tick - in micro-sec
|
|
/*
|
|
Timer4 interrupts @ 1.0 msecs using 1/128 pre-scaler
|
|
TICK_COUNT = (CPUMHZ / 128) / 1000
|
|
*/
|
|
#define TICK_COUNT 1 // 32 Mhz Output Compare Count
|
|
|
|
/* CC2430 DEFINITIONS */
|
|
|
|
// MEMCTR bit definitions
|
|
#define ALWAYS1 0x01 // Reserved: always=1
|
|
#define CACHDIS 0x02 // Flash cache: disable=1
|
|
#define FMAP0 0x10 // Flash bank map, bit0
|
|
#define FMAP1 0x20 // Flash bank map, bit1
|
|
#define FMAP 0x30 // Flash bank map, mask
|
|
#define MUNIF 0x40 // Memory mapping: unified=1
|
|
|
|
// PCON bit definitions
|
|
#define PMODESET 0x01 // Power mode control: 1=set PMx
|
|
|
|
// Reset bit definitions
|
|
#define LRESET 0x18 // Last reset bit mask
|
|
#define RESETPO 0x00 // Power-On reset
|
|
#define RESETEX 0x08 // External reset
|
|
#define RESETWD 0x10 // WatchDog reset
|
|
|
|
/* GPIO PORT DEFINITIONS */
|
|
// GPIO bit definitions
|
|
#define GPIO_0 0x01 // Px_0: GPIO=0, PIO=1
|
|
#define GPIO_1 0x02 // Px_1: GPIO=0, PIO=1
|
|
#define GPIO_2 0x04 // Px_2: GPIO=0, PIO=1
|
|
#define GPIO_3 0x08 // Px_3: GPIO=0, PIO=1
|
|
#define GPIO_4 0x10 // Px_4: GPIO=0, PIO=1
|
|
#define GPIO_5 0x20 // Px_5: GPIO=0, PIO=1
|
|
#define GPIO_6 0x40 // Px_6: GPIO=0, PIO=1
|
|
#define GPIO_7 0x80 // Px_7: GPIO=0, PIO=1
|
|
|
|
/* WATCHDOG TIMER DEFINITIONS */
|
|
// WDCTL bit definitions
|
|
|
|
#define WDINT0 0x01 // Interval, bit0
|
|
#define WDINT1 0x02 // Interval, bit1
|
|
#define WDINT 0x03 // Interval, mask
|
|
#define WDMODE 0x04 // Mode: watchdog=0, timer=1
|
|
#define WDEN 0x08 // Timer: disabled=0, enabled=1
|
|
#define WDCLR0 0x10 // Clear timer, bit0
|
|
#define WDCLR1 0x20 // Clear timer, bit1
|
|
#define WDCLR2 0x40 // Clear timer, bit2
|
|
#define WDCLR3 0x80 // Clear timer, bit3
|
|
#define WDCLR 0xF0 // Clear timer, mask
|
|
|
|
// WD timer intervals
|
|
#define WDTISH 0x03 // Short: clk * 64
|
|
#define WDTIMD 0x02 // Medium: clk * 512
|
|
#define WDTILG 0x01 // Long: clk * 8192
|
|
#define WDTIMX 0x00 // Maximum: clk * 32768
|
|
|
|
// WD clear timer patterns
|
|
#define WDCLP1 0xA0 // Clear pattern 1
|
|
#define WDCLP2 0x50 // Clear pattern 2
|
|
|
|
/*********************************************************************
|
|
* MACROS
|
|
*/
|
|
|
|
// These Key definitions are unique to this development system.
|
|
// They are used to bypass functions when starting up the device.
|
|
#define SW_BYPASS_NV HAL_KEY_SW_5 // Bypass Network layer NV restore
|
|
#define SW_BYPASS_START HAL_KEY_SW_1 // Bypass Network initialization
|
|
|
|
// LCD Support Defintions
|
|
#ifdef LCD_SUPPORTED
|
|
#if !defined DEBUG
|
|
#define DEBUG 0
|
|
#endif
|
|
#if LCD_SUPPORTED==DEBUG
|
|
// #define SERIAL_DEBUG_SUPPORTED // Serial-debug
|
|
#endif
|
|
#else // No LCD support
|
|
#undef SERIAL_DEBUG_SUPPORTED // No serial-debug
|
|
#endif
|
|
|
|
/* Serial Port Definitions */
|
|
#if defined (ZAPP_P1)
|
|
#define ZAPP_PORT HAL_UART_PORT_0
|
|
#elif defined (ZAPP_P2)
|
|
#define ZAPP_PORT HAL_UART_PORT_1
|
|
#else
|
|
#undef ZAPP_PORT
|
|
#endif
|
|
#if defined (ZTOOL_P1)
|
|
#define ZTOOL_PORT HAL_UART_PORT_0
|
|
#elif defined (ZTOOL_P2)
|
|
#define ZTOOL_PORT HAL_UART_PORT_1
|
|
#else
|
|
#undef ZTOOL_PORT
|
|
#endif
|
|
|
|
#define MT_UART_TX_BUFF_MAX 128
|
|
#define MT_UART_RX_BUFF_MAX 128
|
|
#define MT_UART_THRESHOLD (MT_UART_RX_BUFF_MAX / 2)
|
|
#define MT_UART_IDLE_TIMEOUT 6
|
|
|
|
// Restart system from absolute beginning
|
|
// Disables interrupts, forces WatchDog reset
|
|
#define SystemReset() \
|
|
{ \
|
|
HAL_DISABLE_INTERRUPTS(); \
|
|
HAL_SYSTEM_RESET(); \
|
|
}
|
|
|
|
#define SystemResetSoft() Onboard_soft_reset()
|
|
|
|
/* Reset reason for reset indication */
|
|
#define ResetReason() ((SLEEPSTA >> 3) & 0x03)
|
|
|
|
/* WATCHDOG TIMER DEFINITIONS */
|
|
#define WatchDogEnable(wdti) \
|
|
{ \
|
|
WDCTL = WDCLP1 | WDEN | (wdti & WDINT); \
|
|
WDCTL = WDCLP2 | WDEN | (wdti & WDINT); \
|
|
}
|
|
|
|
// Wait for specified microseconds
|
|
#define MicroWait(t) Onboard_wait(t)
|
|
|
|
#define OSAL_SET_CPU_INTO_SLEEP(timeout) halSleep(timeout); /* Called from OSAL_PwrMgr */
|
|
|
|
#ifdef __IAR_SYSTEMS_ICC__
|
|
// Internal (MCU) Stack addresses
|
|
#define CSTACK_BEG ((uint8 const *)(_Pragma("segment=\"XSTACK\"") __segment_begin("XSTACK")))
|
|
#define CSTACK_END ((uint8 const *)(_Pragma("segment=\"XSTACK\"") __segment_end("XSTACK"))-1)
|
|
// Stack Initialization Value
|
|
#define STACK_INIT_VALUE 0xCD
|
|
#else
|
|
#error Check compiler compatibility.
|
|
#endif
|
|
|
|
/* The following Heap sizes are setup for typical TI sample applications,
|
|
* and should be adjusted to your systems requirements.
|
|
*/
|
|
#if !defined INT_HEAP_LEN
|
|
#if defined RTR_NWK
|
|
#define INT_HEAP_LEN 3072
|
|
#else
|
|
#define INT_HEAP_LEN 2048
|
|
#endif
|
|
#endif
|
|
#define MAXMEMHEAP INT_HEAP_LEN
|
|
|
|
#define KEY_CHANGE_SHIFT_IDX 1
|
|
#define KEY_CHANGE_KEYS_IDX 2
|
|
|
|
// Initialization levels
|
|
#define OB_COLD 0
|
|
#define OB_WARM 1
|
|
#define OB_READY 2
|
|
|
|
#ifdef LCD_SUPPORTED
|
|
#define BUZZER_OFF 0
|
|
#define BUZZER_ON 1
|
|
#define BUZZER_BLIP 2
|
|
#endif
|
|
|
|
typedef struct
|
|
{
|
|
osal_event_hdr_t hdr;
|
|
uint8 state; // shift
|
|
uint8 keys; // keys
|
|
} keyChange_t;
|
|
|
|
/*********************************************************************
|
|
* FUNCTIONS
|
|
*/
|
|
|
|
/*
|
|
* Initialize the Peripherals
|
|
* level: 0=cold, 1=warm, 2=ready
|
|
*/
|
|
extern void InitBoard( uint8 level );
|
|
|
|
/*
|
|
* Get elapsed timer clock counts
|
|
*/
|
|
extern uint32 TimerElapsed( void );
|
|
|
|
/*
|
|
* Register for all key events
|
|
*/
|
|
extern uint8 RegisterForKeys( uint8 task_id );
|
|
|
|
/* Keypad Control Functions */
|
|
|
|
/*
|
|
* Send "Key Pressed" message to application
|
|
*/
|
|
extern uint8 OnBoard_SendKeys( uint8 keys, uint8 shift );
|
|
|
|
/* LCD Emulation/Control Functions */
|
|
/*
|
|
* Convert an interger to an ascii string
|
|
*/
|
|
extern void _itoa( uint16 num, uint8 *buf, uint8 radix );
|
|
|
|
|
|
extern void Dimmer( uint8 lvl );
|
|
|
|
/* External I/O Processing Functions */
|
|
/*
|
|
* Turn on an external lamp
|
|
*/
|
|
extern void BigLight_On( void );
|
|
|
|
/*
|
|
* Turn off an external lamp
|
|
*/
|
|
extern void BigLight_Off( void );
|
|
|
|
/*
|
|
* Turn on/off an external buzzer
|
|
* on: BUZZER_ON or BUZZER_OFF
|
|
*/
|
|
extern void BuzzerControl( uint8 on );
|
|
|
|
/*
|
|
* Get setting of external dip switch
|
|
*/
|
|
extern uint8 GetUserDipSw( void );
|
|
|
|
/*
|
|
* Calculate the size of used stack
|
|
*/
|
|
extern uint16 OnBoard_stack_used( void );
|
|
|
|
/*
|
|
* Callback routine to handle keys
|
|
*/
|
|
extern void OnBoard_KeyCallback ( uint8 keys, uint8 state );
|
|
|
|
/*
|
|
* Board specific random number generator
|
|
*/
|
|
extern uint16 Onboard_rand( void );
|
|
|
|
/*
|
|
* Board specific micro-second wait
|
|
*/
|
|
extern void Onboard_wait( uint16 timeout );
|
|
|
|
/*
|
|
* Board specific soft reset.
|
|
*/
|
|
extern __near_func void Onboard_soft_reset( void );
|
|
|
|
/*********************************************************************
|
|
*********************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // ONBOARD_H
|