2 * ============ Hardware Abstraction Layer for MSP-EXP430G2 LaunchPad ============
6 #include "Em_Message.h"
11 /* -------- INTERNAL FEATURES -------- */
13 #define GREEN_LED_CONFIG() (P1DIR |= BIT6)
14 #define GREEN_LED_ON() (P1OUT |= BIT6)
15 #define GREEN_LED_OFF() (P1OUT &= ~BIT6)
16 #define GREEN_LED_READ() (P1OUT & BIT6)
17 #define GREEN_LED_TOGGLE() (P1OUT ^= BIT6)
19 #define RED_LED_CONFIG() (P1DIR |= BIT0)
20 #define RED_LED_ON() (P1OUT |= BIT0)
21 #define RED_LED_OFF() (P1OUT &= ~BIT0)
22 #define RED_LED_READ() (P1OUT & BIT0)
23 #define RED_LED_TOGGLE() (P1OUT ^= BIT0)
25 #define BUTTON_CONFIG() (P1DIR &= ~BIT3, P1REN |= BIT3, P1OUT |= BIT3, P1IES |= BIT3);
26 #define BUTTON_ENABLE() (P1IFG &= ~BIT3, P1IE |= BIT3)
27 #define BUTTON_DISABLE() (P1IE &= ~BIT3, P1IFG &= ~BIT3)
28 #define BUTTON_FIRED() (P1IFG & BIT3)
29 #define BUTTON_PRESSED() (!(P1IN & BIT3))
30 #define BUTTON_DEBOUNCE_MSECS 100
32 #define DEBUG1_CONFIG() (P2DIR |= BIT3)
33 #define DEBUG1_ON() (P2OUT |= BIT3)
34 #define DEBUG1_OFF() (P2OUT &= ~BIT3)
36 #define DEBUG2_CONFIG() (P2DIR |= BIT4)
37 #define DEBUG2_ON() (P2OUT |= BIT4)
38 #define DEBUG2_OFF() (P2OUT &= ~BIT4)
40 #define EAP_RX_BUF UCA0RXBUF
41 #define EAP_TX_BUF UCA0TXBUF
43 #define EAP_RX_VECTOR USCIAB0RX_VECTOR
44 #define EAP_TX_VECTOR USCIAB0TX_VECTOR
45 #define EAP_TX_ACK_VECTOR PORT2_VECTOR
47 #define EAP_RX_ENABLE() (P1SEL |= BIT1, P1SEL2 |= BIT1)
48 #define EAP_RX_DISABLE() (P1SEL &= ~BIT1, P1SEL2 &= ~BIT1)
49 #define EAP_TX_ENABLE() (P1SEL |= BIT2, P1SEL2 |= BIT2)
50 #define EAP_TX_DISABLE() (P1SEL &= ~BIT2, P1SEL2 &= ~BIT2)
52 #define EAP_RX_ACK_CONFIG() (P2DIR |= BIT0)
53 #define EAP_RX_ACK_SET() (P2OUT |= BIT0)
54 #define EAP_RX_ACK_CLR() (P2OUT &= ~BIT0)
56 #define EAP_TX_ACK_CONFIG() (P2DIR &= ~BIT1, P2IES |= BIT1, P2IFG &= ~BIT1, P2IE |= BIT1)
57 #define EAP_TX_ACK_TST() (P2IFG & BIT1)
58 #define EAP_TX_ACK_CLR() (P2IFG &= ~BIT1)
60 #define EAP_RX_INT_CLR() (IFG2 &= ~UCA0RXIFG)
61 #define EAP_RX_INT_ENABLE() (IE2 |= UCA0RXIE)
62 #define EAP_TX_INT_CLR() (IFG2 &= ~UCA0TXIFG)
63 #define EAP_TX_INT_DISABLE() (IE2 &= ~UCA0TXIE)
64 #define EAP_TX_INT_ENABLE() (IE2 |= UCA0TXIE)
66 #define MCLK_TICKS_PER_MS 1000L
67 #define ACLK_TICKS_PER_SECOND 12000L
68 #define UART_WATCHDOG_PERIOD (ACLK_TICKS_PER_SECOND * 250) / 1000
70 #define UART_WATCH_DISABLE() (TA1CCTL1 = 0) // Turn off CCR1 Interrupt
71 #define UART_WATCH_ENABLE() (TA1CCR1 = TA1R + UART_WATCHDOG_PERIOD, TA1CCTL1 = CCIE) // Set CCR1, and Enable CCR1 Interrupt
74 #define DINT() __disable_interrupt()
75 #define EINT() __enable_interrupt()
77 #define SLEEP() _BIS_SR(LPM3_bits + GIE)
78 #define WAKEUP() _BIC_SR_IRQ(LPM3_bits)
81 #ifdef __TI_COMPILER_VERSION__
82 #define DINT() (_disable_interrupt())
83 #define EINT() (_enable_interrupt())
84 #define INTERRUPT interrupt
85 #define SLEEP() (__bis_SR_register(LPM3_bits + GIE))
86 #define WAKEUP() (__bic_SR_register_on_exit(LPM3_bits))
89 #define NUM_HANDLERS 5
91 #define BUTTON_HANDLER_ID 0
92 #define EVENT4_HANDLER_ID 1
93 #define EVENT5_HANDLER_ID 2
94 #define TICK_HANDLER_ID 3
95 #define DISPATCH_HANDLER_ID 4
97 static void buttonHandler(uint8_t id);
98 static void postEvent(uint8_t handlerId);
100 static Hal_Handler appButtonHandler;
101 static volatile uint16_t handlerEvents = 0;
102 static uint16_t clockTick = 0;
103 static Hal_Handler handlerTab[NUM_HANDLERS];
106 /* -------- APP-HAL INTERFACE -------- */
108 void Hal_buttonEnable(Hal_Handler handler) {
109 handlerTab[BUTTON_HANDLER_ID] = buttonHandler;
110 appButtonHandler = handler;
116 void Hal_connected(void) {
119 void Hal_debugOn(uint8_t line) {
129 void Hal_debugOff(uint8_t line) {
139 void Hal_debugPulse(uint8_t line) {
151 void Hal_delay(uint16_t msecs) {
153 __delay_cycles(MCLK_TICKS_PER_MS);
157 void Hal_disconnected(void) {
160 void Hal_init(void) {
164 WDTCTL = WDTPW + WDTHOLD;
165 BCSCTL2 = SELM_0 + DIVM_0 + DIVS_0;
166 if (CALBC1_1MHZ != 0xFF) {
168 BCSCTL1 = CALBC1_1MHZ; /* Set DCO to 1MHz */
169 DCOCTL = CALDCO_1MHZ;
171 BCSCTL1 |= XT2OFF + DIVA_0;
172 BCSCTL3 = XT2S_0 + LFXT1S_2 + XCAP_1;
181 /* setup debug pins */
183 DEBUG1_CONFIG(); DEBUG1_OFF();
184 DEBUG2_CONFIG(); DEBUG2_OFF();
186 DEBUG1_ON(); DEBUG1_OFF();
189 TA1CTL = TASSEL_1 + MC_2; // ACLK, Continuous mode
190 UART_WATCH_DISABLE();
207 UCA0CTL1 = UCSSEL_2 + UCSWRST;
208 UCA0MCTL = UCBRF_0 + UCBRS_6;
210 UCA0CTL1 &= ~UCSWRST;
212 handlerTab[DISPATCH_HANDLER_ID] = Em_Message_dispatch;
215 void Hal_idleLoop(void) {
220 // atomically read/clear all handlerEvents
222 uint16_t events = handlerEvents;
225 if (events) { // dispatch all current events
229 for (id = 0, mask = 0x1; id < NUM_HANDLERS; id++, mask <<= 1) {
230 if ((events & mask) && handlerTab[id]) {
235 else { // await more events
241 void Hal_greenLedOn(void) {
245 void Hal_greenLedOff(void) {
249 bool Hal_greenLedRead(void) {
250 return GREEN_LED_READ();
253 void Hal_greenLedToggle(void) {
257 void Hal_redLedOn(void) {
261 void Hal_redLedOff(void) {
265 bool Hal_redLedRead(void) {
266 return RED_LED_READ();
269 void Hal_redLedToggle(void) {
273 void Hal_tickStart(uint16_t msecs, Hal_Handler handler) {
274 handlerTab[TICK_HANDLER_ID] = handler;
275 clockTick = (ACLK_TICKS_PER_SECOND * msecs) / 1000;
276 TA1CCR0 = TA1R + clockTick; // Set the CCR0 interrupt for msecs from now.
277 TA1CCTL0 = CCIE; // Enable the CCR0 interrupt
280 void Hal_tickStop(void) {
281 handlerTab[TICK_HANDLER_ID] = 0;
286 /* -------- SRT-HAL INTERFACE -------- */
288 uint8_t Em_Hal_lock(void) {
289 uint8_t key = _get_interrupt_state();
291 __disable_interrupt();
293 #ifdef __TI_COMPILER_VERSION__
294 _disable_interrupt();
299 void Em_Hal_reset(void) {
300 uint8_t key = Em_Hal_lock();
301 EAP_RX_ACK_CLR(); // suspend the MCM
303 EAP_RX_ACK_SET(); // reset the MCM
312 void Em_Hal_startSend() {
313 EAP_TX_BUF = Em_Message_startTx();
316 void Em_Hal_unlock(uint8_t key) {
317 _set_interrupt_state(key);
320 void Em_Hal_watchOff(void) {
321 UART_WATCH_DISABLE();
324 void Em_Hal_watchOn(void) {
329 /* -------- INTERNAL FUNCTIONS -------- */
331 static void buttonHandler(uint8_t id) {
332 Hal_delay(BUTTON_DEBOUNCE_MSECS);
333 if (BUTTON_PRESSED() && appButtonHandler) {
334 appButtonHandler(id);
339 static void postEvent(uint8_t handlerId) {
340 uint8_t key = Em_Hal_lock();
341 handlerEvents |= 1 << handlerId;
345 /* -------- INTERRUPT SERVICE ROUTINES -------- */
348 __attribute__((interrupt(PORT1_VECTOR)))
350 #ifdef __TI_COMPILER_VERSION__
351 #pragma vector=PORT1_VECTOR
353 INTERRUPT void buttonIsr(void) {
355 postEvent(BUTTON_HANDLER_ID);
361 __attribute__((interrupt(EAP_RX_VECTOR)))
363 #ifdef __TI_COMPILER_VERSION__
364 #pragma vector=EAP_RX_VECTOR
366 INTERRUPT void rxIsr(void) {
367 uint8_t b = EAP_RX_BUF;
368 Em_Message_startRx();
371 if (Em_Message_addByte(b)) {
372 postEvent(DISPATCH_HANDLER_ID);
378 __attribute__((interrupt(TIMER1_A0_VECTOR)))
380 #ifdef __TI_COMPILER_VERSION__
381 #pragma vector=TIMER1_A0_VECTOR
383 INTERRUPT void timerIsr(void) {
384 TA1CCR0 += clockTick;
385 postEvent(TICK_HANDLER_ID);
390 __attribute__((interrupt(EAP_TX_ACK_VECTOR)))
392 #ifdef __TI_COMPILER_VERSION__
393 #pragma vector=EAP_TX_ACK_VECTOR
395 INTERRUPT void txAckIsr(void) {
396 if (EAP_TX_ACK_TST()) {
398 if (Em_Message_getByte(&b)) {
407 __attribute__((interrupt(TIMER1_A1_VECTOR)))
409 #ifdef __TI_COMPILER_VERSION__
410 #pragma vector=TIMER1_A1_VECTOR
412 INTERRUPT void uartWatchdogIsr(void) {
415 UART_WATCH_DISABLE();
416 Em_Message_restart();