src/main/drivers/serial_uart_hal.c

   1 /*
   2  * This file is part of Cleanflight.
   3  *
   4  * Cleanflight is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation, either version 3 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * Cleanflight is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with Cleanflight.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17
  18 /*
  19  * Authors:
  20  * Dominic Clifton - Serial port abstraction, Separation of common STM32 code for cleanflight, various cleanups.
  21  * Hamasaki/Timecop - Initial baseflight code
  22 */
  23 #include <stdbool.h>
  24 #include <stdint.h>
  25 #include <stdlib.h>
  26
  27 #include "platform.h"
  28
  29 #include "build/build_config.h"
  30
  31 #include "common/utils.h"
  32 #include "drivers/io.h"
  33 #include "drivers/nvic.h"
  34
  35 #include "serial.h"
  36 #include "serial_uart.h"
  37 #include "serial_uart_impl.h"
  38
  39 static void usartConfigurePinInversion(uartPort_t *uartPort) {
  40     bool inverted = uartPort->port.options & SERIAL_INVERTED;
  41
  42     if (inverted)
  43     {
  44         if (uartPort->port.mode & MODE_RX)
  45         {
  46             uartPort->Handle.AdvancedInit.AdvFeatureInit |= UART_ADVFEATURE_RXINVERT_INIT;
  47             uartPort->Handle.AdvancedInit.RxPinLevelInvert = UART_ADVFEATURE_RXINV_ENABLE;
  48         }
  49         if (uartPort->port.mode & MODE_TX)
  50         {
  51             uartPort->Handle.AdvancedInit.AdvFeatureInit |= UART_ADVFEATURE_TXINVERT_INIT;
  52             uartPort->Handle.AdvancedInit.TxPinLevelInvert = UART_ADVFEATURE_TXINV_ENABLE;
  53         }
  54     }
  55 }
  56
  57 static void uartReconfigure(uartPort_t *uartPort)
  58 {
  59     /*RCC_PeriphCLKInitTypeDef RCC_PeriphClkInit;
  60     RCC_PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_USART1|RCC_PERIPHCLK_USART2|RCC_PERIPHCLK_USART3|
  61             RCC_PERIPHCLK_UART4|RCC_PERIPHCLK_UART5|RCC_PERIPHCLK_USART6|RCC_PERIPHCLK_UART7|RCC_PERIPHCLK_UART8;
  62     RCC_PeriphClkInit.Usart1ClockSelection = RCC_USART1CLKSOURCE_SYSCLK;
  63     RCC_PeriphClkInit.Usart2ClockSelection = RCC_USART2CLKSOURCE_SYSCLK;
  64     RCC_PeriphClkInit.Usart3ClockSelection = RCC_USART3CLKSOURCE_SYSCLK;
  65     RCC_PeriphClkInit.Uart4ClockSelection = RCC_UART4CLKSOURCE_SYSCLK;
  66     RCC_PeriphClkInit.Uart5ClockSelection = RCC_UART5CLKSOURCE_SYSCLK;
  67     RCC_PeriphClkInit.Usart6ClockSelection = RCC_USART6CLKSOURCE_SYSCLK;
  68     RCC_PeriphClkInit.Uart7ClockSelection = RCC_UART7CLKSOURCE_SYSCLK;
  69     RCC_PeriphClkInit.Uart8ClockSelection = RCC_UART8CLKSOURCE_SYSCLK;
  70     HAL_RCCEx_PeriphCLKConfig(&RCC_PeriphClkInit);*/
  71
  72     HAL_UART_DeInit(&uartPort->Handle);
  73     uartPort->Handle.Init.BaudRate = uartPort->port.baudRate;
  74     uartPort->Handle.Init.WordLength = (uartPort->port.options & SERIAL_PARITY_EVEN) ? UART_WORDLENGTH_9B : UART_WORDLENGTH_8B;
  75     uartPort->Handle.Init.StopBits = (uartPort->port.options & SERIAL_STOPBITS_2) ? USART_STOPBITS_2 : USART_STOPBITS_1;
  76     uartPort->Handle.Init.Parity = (uartPort->port.options & SERIAL_PARITY_EVEN) ? USART_PARITY_EVEN : USART_PARITY_NONE;
  77     uartPort->Handle.Init.HwFlowCtl = UART_HWCONTROL_NONE;
  78     uartPort->Handle.Init.OneBitSampling = UART_ONE_BIT_SAMPLE_DISABLE;
  79     uartPort->Handle.Init.Mode = 0;
  80
  81     if (uartPort->port.mode & MODE_RX)
  82         uartPort->Handle.Init.Mode |= UART_MODE_RX;
  83     if (uartPort->port.mode & MODE_TX)
  84         uartPort->Handle.Init.Mode |= UART_MODE_TX;
  85
  86
  87     usartConfigurePinInversion(uartPort);
  88
  89     if (uartPort->port.options & SERIAL_BIDIR)
  90     {
  91         HAL_HalfDuplex_Init(&uartPort->Handle);
  92     }
  93     else
  94     {
  95         HAL_UART_Init(&uartPort->Handle);
  96     }
  97
  98     if (uartPort->port.mode & MODE_RX) {
  99         /* Enable the UART Parity Error Interrupt */
 100         SET_BIT(uartPort->USARTx->CR1, USART_CR1_PEIE);
 101
 102         /* Enable the UART Error Interrupt: (Frame error, noise error, overrun error) */
 103         SET_BIT(uartPort->USARTx->CR3, USART_CR3_EIE);
 104
 105         /* Enable the UART Data Register not empty Interrupt */
 106         SET_BIT(uartPort->USARTx->CR1, USART_CR1_RXNEIE);
 107     }
 108
 109     // Transmit IRQ
 110     if (uartPort->port.mode & MODE_TX) {
 111         /* Enable the UART Transmit Data Register Empty Interrupt */
 112         SET_BIT(uartPort->USARTx->CR1, USART_CR1_TXEIE);
 113     }
 114     return;
 115 }
 116
 117 serialPort_t *uartOpen(USART_TypeDef *USARTx, serialReceiveCallbackPtr callback, void *rxCallbackData, uint32_t baudRate, portMode_t mode, portOptions_t options)
 118 {
 119     uartPort_t *s = NULL;
 120
 121     if (false) {
 122 #ifdef USE_UART1
 123     } else if (USARTx == USART1) {
 124         s = serialUART1(baudRate, mode, options);
 125 #endif
 126 #ifdef USE_UART2
 127     } else if (USARTx == USART2) {
 128         s = serialUART2(baudRate, mode, options);
 129 #endif
 130 #ifdef USE_UART3
 131     } else if (USARTx == USART3) {
 132         s = serialUART3(baudRate, mode, options);
 133 #endif
 134 #ifdef USE_UART4
 135     } else if (USARTx == UART4) {
 136         s = serialUART4(baudRate, mode, options);
 137 #endif
 138 #ifdef USE_UART5
 139     } else if (USARTx == UART5) {
 140         s = serialUART5(baudRate, mode, options);
 141 #endif
 142 #ifdef USE_UART6
 143     } else if (USARTx == USART6) {
 144         s = serialUART6(baudRate, mode, options);
 145 #endif
 146 #ifdef USE_UART7
 147     } else if (USARTx == UART7) {
 148         s = serialUART7(baudRate, mode, options);
 149 #endif
 150 #ifdef USE_UART8
 151     } else if (USARTx == UART8) {
 152         s = serialUART8(baudRate, mode, options);
 153 #endif
 154     } else {
 155         return (serialPort_t *)s;
 156     }
 157
 158
 159     // common serial initialisation code should move to serialPort::init()
 160     s->port.rxBufferHead = s->port.rxBufferTail = 0;
 161     s->port.txBufferHead = s->port.txBufferTail = 0;
 162     // callback works for IRQ-based RX ONLY
 163     s->port.rxCallback = callback;
 164     s->port.rxCallbackData = rxCallbackData;
 165     s->port.mode = mode;
 166     s->port.baudRate = baudRate;
 167     s->port.options = options;
 168
 169     uartReconfigure(s);
 170
 171     return (serialPort_t *)s;
 172 }
 173
 174 void uartSetBaudRate(serialPort_t *instance, uint32_t baudRate)
 175 {
 176     uartPort_t *uartPort = (uartPort_t *)instance;
 177     uartPort->port.baudRate = baudRate;
 178     uartReconfigure(uartPort);
 179 }
 180
 181 void uartSetMode(serialPort_t *instance, portMode_t mode)
 182 {
 183     uartPort_t *uartPort = (uartPort_t *)instance;
 184     uartPort->port.mode = mode;
 185     uartReconfigure(uartPort);
 186 }
 187
 188 uint32_t uartTotalRxBytesWaiting(const serialPort_t *instance)
 189 {
 190     uartPort_t *s = (uartPort_t*)instance;
 191
 192     if (s->port.rxBufferHead >= s->port.rxBufferTail) {
 193         return s->port.rxBufferHead - s->port.rxBufferTail;
 194     } else {
 195         return s->port.rxBufferSize + s->port.rxBufferHead - s->port.rxBufferTail;
 196     }
 197 }
 198
 199 uint32_t uartTotalTxBytesFree(const serialPort_t *instance)
 200 {
 201     uartPort_t *s = (uartPort_t*)instance;
 202
 203     uint32_t bytesUsed;
 204
 205     if (s->port.txBufferHead >= s->port.txBufferTail) {
 206         bytesUsed = s->port.txBufferHead - s->port.txBufferTail;
 207     } else {
 208         bytesUsed = s->port.txBufferSize + s->port.txBufferHead - s->port.txBufferTail;
 209     }
 210
 211     return (s->port.txBufferSize - 1) - bytesUsed;
 212 }
 213
 214 bool isUartTransmitBufferEmpty(const serialPort_t *instance)
 215 {
 216     uartPort_t *s = (uartPort_t *)instance;
 217     return s->port.txBufferTail == s->port.txBufferHead;
 218 }
 219
 220 uint8_t uartRead(serialPort_t *instance)
 221 {
 222     uint8_t ch;
 223     uartPort_t *s = (uartPort_t *)instance;
 224
 225
 226     ch = s->port.rxBuffer[s->port.rxBufferTail];
 227     if (s->port.rxBufferTail + 1 >= s->port.rxBufferSize) {
 228         s->port.rxBufferTail = 0;
 229     } else {
 230         s->port.rxBufferTail++;
 231     }
 232
 233     return ch;
 234 }
 235
 236 void uartWrite(serialPort_t *instance, uint8_t ch)
 237 {
 238     uartPort_t *s = (uartPort_t *)instance;
 239     s->port.txBuffer[s->port.txBufferHead] = ch;
 240     if (s->port.txBufferHead + 1 >= s->port.txBufferSize) {
 241         s->port.txBufferHead = 0;
 242     } else {
 243         s->port.txBufferHead++;
 244     }
 245
 246     __HAL_UART_ENABLE_IT(&s->Handle, UART_IT_TXE);
 247 }
 248
 249 bool isUartIdle(serialPort_t *instance)
 250 {
 251     uartPort_t *s = (uartPort_t *)instance;
 252     if(__HAL_UART_GET_FLAG(&s->Handle, UART_FLAG_IDLE)) {
 253         __HAL_UART_CLEAR_IDLEFLAG(&s->Handle);
 254         return true;
 255     } else {
 256         return false;
 257     }
 258 }
 259
 260 const struct serialPortVTable uartVTable[] = {
 261     {
 262         .serialWrite = uartWrite,
 263         .serialTotalRxWaiting = uartTotalRxBytesWaiting,
 264         .serialTotalTxFree = uartTotalTxBytesFree,
 265         .serialRead = uartRead,
 266         .serialSetBaudRate = uartSetBaudRate,
 267         .isSerialTransmitBufferEmpty = isUartTransmitBufferEmpty,
 268         .setMode = uartSetMode,
 269         .isConnected = NULL,
 270         .writeBuf = NULL,
 271         .beginWrite = NULL,
 272         .endWrite = NULL,
 273         .isIdle = isUartIdle,
 274     }
 275 };