| /* |
| * ------------------------------------------- |
| * MSP432 DriverLib - v3_10_00_09 |
| * ------------------------------------------- |
| * |
| * --COPYRIGHT--,BSD,BSD |
| * Copyright (c) 2014, Texas Instruments Incorporated |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * |
| * * 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. |
| * |
| * * Neither the name of Texas Instruments Incorporated 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. |
| * --/COPYRIGHT--*/ |
| #include <uart.h> |
| #include <interrupt.h> |
| #include <debug.h> |
| #include <eusci.h> |
| |
| bool UART_initModule(uint32_t moduleInstance, const eUSCI_UART_Config *config) |
| { |
| bool retVal = true; |
| |
| ASSERT( |
| (EUSCI_A_UART_MODE == config->uartMode) |
| || (EUSCI_A_UART_IDLE_LINE_MULTI_PROCESSOR_MODE |
| == config->uartMode) |
| || (EUSCI_A_UART_ADDRESS_BIT_MULTI_PROCESSOR_MODE |
| == config->uartMode) |
| || (EUSCI_A_UART_AUTOMATIC_BAUDRATE_DETECTION_MODE |
| == config->uartMode)); |
| |
| ASSERT( |
| (EUSCI_A_UART_CLOCKSOURCE_ACLK == config->selectClockSource) |
| || (EUSCI_A_UART_CLOCKSOURCE_SMCLK |
| == config->selectClockSource)); |
| |
| ASSERT( |
| (EUSCI_A_UART_MSB_FIRST == config->msborLsbFirst) |
| || (EUSCI_A_UART_LSB_FIRST == config->msborLsbFirst)); |
| |
| ASSERT( |
| (EUSCI_A_UART_ONE_STOP_BIT == config->numberofStopBits) |
| || (EUSCI_A_UART_TWO_STOP_BITS == config->numberofStopBits)); |
| |
| ASSERT( |
| (EUSCI_A_UART_NO_PARITY == config->parity) |
| || (EUSCI_A_UART_ODD_PARITY == config->parity) |
| || (EUSCI_A_UART_EVEN_PARITY == config->parity)); |
| |
| /* Disable the USCI Module */ |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_SWRST_OFS) = 1; |
| |
| /* Clock source select */ |
| EUSCI_A_CMSIS(moduleInstance)->CTLW0 = |
| (EUSCI_A_CMSIS(moduleInstance)->CTLW0 & ~EUSCI_A_CTLW0_SSEL_MASK) |
| | config->selectClockSource; |
| |
| /* MSB, LSB select */ |
| if (config->msborLsbFirst) |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_MSB_OFS) = 1; |
| else |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_MSB_OFS) = 0; |
| |
| /* UCSPB = 0(1 stop bit) OR 1(2 stop bits) */ |
| if (config->numberofStopBits) |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_SPB_OFS) = 1; |
| else |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_SPB_OFS) = 0; |
| |
| /* Parity */ |
| switch (config->parity) |
| { |
| case EUSCI_A_UART_NO_PARITY: |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_PEN_OFS) = 0; |
| break; |
| case EUSCI_A_UART_ODD_PARITY: |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_PEN_OFS) = 1; |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_PAR_OFS) = 0; |
| break; |
| case EUSCI_A_UART_EVEN_PARITY: |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_PEN_OFS) = 1; |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_PAR_OFS) = 1; |
| break; |
| } |
| |
| /* BaudRate Control Register */ |
| EUSCI_A_CMSIS(moduleInstance)->BRW = config->clockPrescalar; |
| EUSCI_A_CMSIS(moduleInstance)->MCTLW = ((config->secondModReg << 8) |
| + (config->firstModReg << 4) + config->overSampling); |
| |
| /* Asynchronous mode & 8 bit character select & clear mode */ |
| EUSCI_A_CMSIS(moduleInstance)->CTLW0 = |
| (EUSCI_A_CMSIS(moduleInstance)->CTLW0 |
| & ~(EUSCI_A_CTLW0_SYNC | EUSCI_A_CTLW0_SEVENBIT | EUSCI_A_CTLW0_MODE_3 | EUSCI_A_CTLW0_RXEIE | EUSCI_A_CTLW0_BRKIE | EUSCI_A_CTLW0_DORM |
| | EUSCI_A_CTLW0_TXADDR | EUSCI_A_CTLW0_TXBRK)) | config->uartMode; |
| |
| return retVal; |
| } |
| |
| void UART_transmitData(uint32_t moduleInstance, uint_fast8_t transmitData) |
| { |
| /* If interrupts are not used, poll for flags */ |
| if (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IE, EUSCI_A__TXIE_OFS)) |
| while (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IFG, EUSCI_A_IFG_TXIFG_OFS)) |
| ; |
| |
| EUSCI_A_CMSIS(moduleInstance)->TXBUF = transmitData; |
| } |
| |
| uint8_t UART_receiveData(uint32_t moduleInstance) |
| { |
| /* If interrupts are not used, poll for flags */ |
| if (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IE, EUSCI_A__RXIE_OFS)) |
| while (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IFG, EUSCI_A_IFG_RXIFG_OFS)) |
| ; |
| |
| return EUSCI_A_CMSIS(moduleInstance)->RXBUF; |
| } |
| |
| void UART_enableModule(uint32_t moduleInstance) |
| { |
| /* Reset the UCSWRST bit to enable the USCI Module */ |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_SWRST_OFS) = 0; |
| } |
| |
| void UART_disableModule(uint32_t moduleInstance) |
| { |
| /* Set the UCSWRST bit to disable the USCI Module */ |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_SWRST_OFS) = 1; |
| } |
| |
| uint_fast8_t UART_queryStatusFlags(uint32_t moduleInstance, uint_fast8_t mask) |
| { |
| ASSERT( |
| 0x00 != mask |
| && (EUSCI_A_UART_LISTEN_ENABLE + EUSCI_A_UART_FRAMING_ERROR |
| + EUSCI_A_UART_OVERRUN_ERROR |
| + EUSCI_A_UART_PARITY_ERROR |
| + EUSCI_A_UART_BREAK_DETECT |
| + EUSCI_A_UART_RECEIVE_ERROR |
| + EUSCI_A_UART_ADDRESS_RECEIVED |
| + EUSCI_A_UART_IDLELINE + EUSCI_A_UART_BUSY)); |
| |
| return EUSCI_A_CMSIS(moduleInstance)->STATW & mask; |
| } |
| |
| void UART_setDormant(uint32_t moduleInstance) |
| { |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_DORM_OFS) = 1; |
| } |
| |
| void UART_resetDormant(uint32_t moduleInstance) |
| { |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_DORM_OFS) = 0; |
| } |
| |
| void UART_transmitAddress(uint32_t moduleInstance, uint_fast8_t transmitAddress) |
| { |
| /* Set UCTXADDR bit */ |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_TXADDR_OFS) = 1; |
| |
| /* Place next byte to be sent into the transmit buffer */ |
| EUSCI_A_CMSIS(moduleInstance)->TXBUF = transmitAddress; |
| } |
| |
| void UART_transmitBreak(uint32_t moduleInstance) |
| { |
| /* Set UCTXADDR bit */ |
| BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->CTLW0, EUSCI_A_CTLW0_TXBRK_OFS) = 1; |
| |
| /* If current mode is automatic baud-rate detection */ |
| if (EUSCI_A_UART_AUTOMATIC_BAUDRATE_DETECTION_MODE |
| == (EUSCI_A_CMSIS(moduleInstance)->CTLW0 |
| & EUSCI_A_UART_AUTOMATIC_BAUDRATE_DETECTION_MODE)) |
| EUSCI_A_CMSIS(moduleInstance)->TXBUF = |
| EUSCI_A_UART_AUTOMATICBAUDRATE_SYNC; |
| else |
| EUSCI_A_CMSIS(moduleInstance)->TXBUF = DEFAULT_SYNC; |
| |
| /* If interrupts are not used, poll for flags */ |
| if (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IE, EUSCI_A__TXIE_OFS)) |
| while (!BITBAND_PERI(EUSCI_A_CMSIS(moduleInstance)->IFG, EUSCI_A_IFG_TXIFG_OFS)) |
| ; |
| } |
| |
| uint32_t UART_getReceiveBufferAddressForDMA(uint32_t moduleInstance) |
| { |
| return (uint32_t)&EUSCI_A_CMSIS(moduleInstance)->RXBUF; |
| } |
| |
| uint32_t UART_getTransmitBufferAddressForDMA(uint32_t moduleInstance) |
| { |
| return (uint32_t)&EUSCI_B_CMSIS(moduleInstance)->TXBUF; |
| } |
| |
| void UART_selectDeglitchTime(uint32_t moduleInstance, uint32_t deglitchTime) |
| { |
| ASSERT( |
| (EUSCI_A_UART_DEGLITCH_TIME_2ns == deglitchTime) |
| || (EUSCI_A_UART_DEGLITCH_TIME_50ns == deglitchTime) |
| || (EUSCI_A_UART_DEGLITCH_TIME_100ns == deglitchTime) |
| || (EUSCI_A_UART_DEGLITCH_TIME_200ns == deglitchTime)); |
| |
| EUSCI_A_CMSIS(moduleInstance)->CTLW1 = |
| (EUSCI_A_CMSIS(moduleInstance)->CTLW1 & ~(EUSCI_A_CTLW1_GLIT_MASK)) |
| | deglitchTime; |
| |
| } |
| |
| void UART_enableInterrupt(uint32_t moduleInstance, uint_fast8_t mask) |
| { |
| uint_fast8_t locMask; |
| |
| ASSERT( |
| !(mask |
| & ~(EUSCI_A_UART_RECEIVE_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_INTERRUPT |
| | EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT |
| | EUSCI_A_UART_BREAKCHAR_INTERRUPT |
| | EUSCI_A_UART_STARTBIT_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT))); |
| |
| locMask = (mask |
| & (EUSCI_A_UART_RECEIVE_INTERRUPT | EUSCI_A_UART_TRANSMIT_INTERRUPT |
| | EUSCI_A_UART_STARTBIT_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT)); |
| |
| EUSCI_A_CMSIS(moduleInstance)->IE |= locMask; |
| |
| locMask = (mask |
| & (EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT |
| | EUSCI_A_UART_BREAKCHAR_INTERRUPT)); |
| EUSCI_A_CMSIS(moduleInstance)->CTLW0 |= locMask; |
| } |
| |
| void UART_disableInterrupt(uint32_t moduleInstance, uint_fast8_t mask) |
| { |
| uint_fast8_t locMask; |
| |
| ASSERT( |
| !(mask |
| & ~(EUSCI_A_UART_RECEIVE_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_INTERRUPT |
| | EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT |
| | EUSCI_A_UART_BREAKCHAR_INTERRUPT |
| | EUSCI_A_UART_STARTBIT_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT))); |
| |
| locMask = (mask |
| & (EUSCI_A_UART_RECEIVE_INTERRUPT | EUSCI_A_UART_TRANSMIT_INTERRUPT |
| | EUSCI_A_UART_STARTBIT_INTERRUPT |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT)); |
| EUSCI_A_CMSIS(moduleInstance)->IE &= ~locMask; |
| |
| locMask = (mask |
| & (EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT |
| | EUSCI_A_UART_BREAKCHAR_INTERRUPT)); |
| EUSCI_A_CMSIS(moduleInstance)->CTLW0 &= ~locMask; |
| } |
| |
| uint_fast8_t UART_getInterruptStatus(uint32_t moduleInstance, uint8_t mask) |
| { |
| ASSERT( |
| !(mask |
| & ~(EUSCI_A_UART_RECEIVE_INTERRUPT_FLAG |
| | EUSCI_A_UART_TRANSMIT_INTERRUPT_FLAG |
| | EUSCI_A_UART_STARTBIT_INTERRUPT_FLAG |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT_FLAG))); |
| |
| return EUSCI_A_CMSIS(moduleInstance)->IFG & mask; |
| } |
| |
| uint_fast8_t UART_getEnabledInterruptStatus(uint32_t moduleInstance) |
| { |
| uint_fast8_t intStatus = UART_getInterruptStatus(moduleInstance, |
| EUSCI_A_UART_RECEIVE_INTERRUPT_FLAG | EUSCI_A_UART_TRANSMIT_INTERRUPT_FLAG); |
| uint_fast8_t intEnabled = EUSCI_A_CMSIS(moduleInstance)->IE; |
| |
| if (!(intEnabled & EUSCI_A_UART_RECEIVE_INTERRUPT)) |
| { |
| intStatus &= ~EUSCI_A_UART_RECEIVE_INTERRUPT; |
| } |
| |
| if (!(intEnabled & EUSCI_A_UART_TRANSMIT_INTERRUPT)) |
| { |
| intStatus &= ~EUSCI_A_UART_TRANSMIT_INTERRUPT; |
| } |
| |
| intEnabled = EUSCI_A_CMSIS(moduleInstance)->CTLW0; |
| |
| if (!(intEnabled & EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT)) |
| { |
| intStatus &= ~EUSCI_A_UART_RECEIVE_ERRONEOUSCHAR_INTERRUPT; |
| } |
| |
| if (!(intEnabled & EUSCI_A_UART_BREAKCHAR_INTERRUPT)) |
| { |
| intStatus &= ~EUSCI_A_UART_BREAKCHAR_INTERRUPT; |
| } |
| |
| return intStatus; |
| } |
| |
| void UART_clearInterruptFlag(uint32_t moduleInstance, uint_fast8_t mask) |
| { |
| ASSERT( |
| !(mask |
| & ~(EUSCI_A_UART_RECEIVE_INTERRUPT_FLAG |
| | EUSCI_A_UART_TRANSMIT_INTERRUPT_FLAG |
| | EUSCI_A_UART_STARTBIT_INTERRUPT_FLAG |
| | EUSCI_A_UART_TRANSMIT_COMPLETE_INTERRUPT_FLAG))); |
| |
| //Clear the UART interrupt source. |
| EUSCI_A_CMSIS(moduleInstance)->IFG &= ~(mask); |
| } |
| |
| void UART_registerInterrupt(uint32_t moduleInstance, void (*intHandler)(void)) |
| { |
| switch (moduleInstance) |
| { |
| case EUSCI_A0_BASE: |
| Interrupt_registerInterrupt(INT_EUSCIA0, intHandler); |
| Interrupt_enableInterrupt(INT_EUSCIA0); |
| break; |
| case EUSCI_A1_BASE: |
| Interrupt_registerInterrupt(INT_EUSCIA1, intHandler); |
| Interrupt_enableInterrupt(INT_EUSCIA1); |
| break; |
| #ifdef EUSCI_A2_BASE |
| case EUSCI_A2_BASE: |
| Interrupt_registerInterrupt(INT_EUSCIA2, intHandler); |
| Interrupt_enableInterrupt(INT_EUSCIA2); |
| break; |
| #endif |
| #ifdef EUSCI_A3_BASE |
| case EUSCI_A3_BASE: |
| Interrupt_registerInterrupt(INT_EUSCIA3, intHandler); |
| Interrupt_enableInterrupt(INT_EUSCIA3); |
| break; |
| #endif |
| default: |
| ASSERT(false); |
| } |
| } |
| |
| void UART_unregisterInterrupt(uint32_t moduleInstance) |
| { |
| switch (moduleInstance) |
| { |
| case EUSCI_A0_BASE: |
| Interrupt_disableInterrupt(INT_EUSCIA0); |
| Interrupt_unregisterInterrupt(INT_EUSCIA0); |
| break; |
| case EUSCI_A1_BASE: |
| Interrupt_disableInterrupt(INT_EUSCIA1); |
| Interrupt_unregisterInterrupt(INT_EUSCIA1); |
| break; |
| #ifdef EUSCI_A2_BASE |
| case EUSCI_A2_BASE: |
| Interrupt_disableInterrupt(INT_EUSCIA2); |
| Interrupt_unregisterInterrupt(INT_EUSCIA2); |
| break; |
| #endif |
| #ifdef EUSCI_A3_BASE |
| case EUSCI_A3_BASE: |
| Interrupt_disableInterrupt(INT_EUSCIA3); |
| Interrupt_unregisterInterrupt(INT_EUSCIA3); |
| break; |
| #endif |
| default: |
| ASSERT(false); |
| } |
| } |