git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_STM32F103_Keil/serial/serial.c

   1 /*\r
   2  * FreeRTOS Kernel V10.2.1\r
   3  * Copyright (C) 2019 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
   4  *\r
   5  * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
   6  * this software and associated documentation files (the "Software"), to deal in\r
   7  * the Software without restriction, including without limitation the rights to\r
   8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
   9  * the Software, and to permit persons to whom the Software is furnished to do so,\r
  10  * subject to the following conditions:\r
  11  *\r
  12  * The above copyright notice and this permission notice shall be included in all\r
  13  * copies or substantial portions of the Software.\r
  14  *\r
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
  17  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
  18  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
  19  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
  20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
  21  *\r
  22  * http://www.FreeRTOS.org\r
  23  * http://aws.amazon.com/freertos\r
  24  *\r
  25  * 1 tab == 4 spaces!\r
  26  */\r
  27 \r
  28 /*\r
  29         BASIC INTERRUPT DRIVEN SERIAL PORT DRIVER FOR UART0.\r
  30 */\r
  31 \r
  32 /* Scheduler includes. */\r
  33 #include "FreeRTOS.h"\r
  34 #include "queue.h"\r
  35 #include "semphr.h"\r
  36 \r
  37 /* Library includes. */\r
  38 #include "stm32f10x_lib.h"\r
  39 \r
  40 /* Demo application includes. */\r
  41 #include "serial.h"\r
  42 /*-----------------------------------------------------------*/\r
  43 \r
  44 /* Misc defines. */\r
  45 #define serINVALID_QUEUE                                ( ( QueueHandle_t ) 0 )\r
  46 #define serNO_BLOCK                                             ( ( TickType_t ) 0 )\r
  47 #define serTX_BLOCK_TIME                                ( 40 / portTICK_PERIOD_MS )\r
  48 \r
  49 /*-----------------------------------------------------------*/\r
  50 \r
  51 /* The queue used to hold received characters. */\r
  52 static QueueHandle_t xRxedChars;\r
  53 static QueueHandle_t xCharsForTx;\r
  54 \r
  55 /*-----------------------------------------------------------*/\r
  56 \r
  57 /* UART interrupt handler. */\r
  58 void vUARTInterruptHandler( void );\r
  59 \r
  60 /*-----------------------------------------------------------*/\r
  61 \r
  62 /*\r
  63  * See the serial2.h header file.\r
  64  */\r
  65 xComPortHandle xSerialPortInitMinimal( unsigned long ulWantedBaud, unsigned portBASE_TYPE uxQueueLength )\r
  66 {\r
  67 xComPortHandle xReturn;\r
  68 USART_InitTypeDef USART_InitStructure;\r
  69 NVIC_InitTypeDef NVIC_InitStructure;\r
  70 GPIO_InitTypeDef GPIO_InitStructure;\r
  71 \r
  72         /* Create the queues used to hold Rx/Tx characters. */\r
  73         xRxedChars = xQueueCreate( uxQueueLength, ( unsigned portBASE_TYPE ) sizeof( signed char ) );\r
  74         xCharsForTx = xQueueCreate( uxQueueLength + 1, ( unsigned portBASE_TYPE ) sizeof( signed char ) );\r
  75         \r
  76         /* If the queue/semaphore was created correctly then setup the serial port\r
  77         hardware. */\r
  78         if( ( xRxedChars != serINVALID_QUEUE ) && ( xCharsForTx != serINVALID_QUEUE ) )\r
  79         {\r
  80                 /* Enable USART1 clock */\r
  81                 RCC_APB2PeriphClockCmd( RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE ); \r
  82 \r
  83                 /* Configure USART1 Rx (PA10) as input floating */\r
  84                 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;\r
  85                 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;\r
  86                 GPIO_Init( GPIOA, &GPIO_InitStructure );\r
  87                 \r
  88                 /* Configure USART1 Tx (PA9) as alternate function push-pull */\r
  89                 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;\r
  90                 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;\r
  91                 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;\r
  92                 GPIO_Init( GPIOA, &GPIO_InitStructure );\r
  93 \r
  94                 USART_InitStructure.USART_BaudRate = ulWantedBaud;\r
  95                 USART_InitStructure.USART_WordLength = USART_WordLength_8b;\r
  96                 USART_InitStructure.USART_StopBits = USART_StopBits_1;\r
  97                 USART_InitStructure.USART_Parity = USART_Parity_No ;\r
  98                 USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;\r
  99                 USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;\r
 100                 USART_InitStructure.USART_Clock = USART_Clock_Disable;\r
 101                 USART_InitStructure.USART_CPOL = USART_CPOL_Low;\r
 102                 USART_InitStructure.USART_CPHA = USART_CPHA_2Edge;\r
 103                 USART_InitStructure.USART_LastBit = USART_LastBit_Disable;\r
 104                 \r
 105                 USART_Init( USART1, &USART_InitStructure );\r
 106                 \r
 107                 USART_ITConfig( USART1, USART_IT_RXNE, ENABLE );\r
 108                 \r
 109                 NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQChannel;\r
 110                 NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = configLIBRARY_KERNEL_INTERRUPT_PRIORITY;\r
 111                 NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;\r
 112                 NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;\r
 113                 NVIC_Init( &NVIC_InitStructure );\r
 114                 \r
 115                 USART_Cmd( USART1, ENABLE );            \r
 116         }\r
 117         else\r
 118         {\r
 119                 xReturn = ( xComPortHandle ) 0;\r
 120         }\r
 121 \r
 122         /* This demo file only supports a single port but we have to return\r
 123         something to comply with the standard demo header file. */\r
 124         return xReturn;\r
 125 }\r
 126 /*-----------------------------------------------------------*/\r
 127 \r
 128 signed portBASE_TYPE xSerialGetChar( xComPortHandle pxPort, signed char *pcRxedChar, TickType_t xBlockTime )\r
 129 {\r
 130         /* The port handle is not required as this driver only supports one port. */\r
 131         ( void ) pxPort;\r
 132 \r
 133         /* Get the next character from the buffer.  Return false if no characters\r
 134         are available, or arrive before xBlockTime expires. */\r
 135         if( xQueueReceive( xRxedChars, pcRxedChar, xBlockTime ) )\r
 136         {\r
 137                 return pdTRUE;\r
 138         }\r
 139         else\r
 140         {\r
 141                 return pdFALSE;\r
 142         }\r
 143 }\r
 144 /*-----------------------------------------------------------*/\r
 145 \r
 146 void vSerialPutString( xComPortHandle pxPort, const signed char * const pcString, unsigned short usStringLength )\r
 147 {\r
 148 signed char *pxNext;\r
 149 \r
 150         /* A couple of parameters that this port does not use. */\r
 151         ( void ) usStringLength;\r
 152         ( void ) pxPort;\r
 153 \r
 154         /* NOTE: This implementation does not handle the queue being full as no\r
 155         block time is used! */\r
 156 \r
 157         /* The port handle is not required as this driver only supports UART1. */\r
 158         ( void ) pxPort;\r
 159 \r
 160         /* Send each character in the string, one at a time. */\r
 161         pxNext = ( signed char * ) pcString;\r
 162         while( *pxNext )\r
 163         {\r
 164                 xSerialPutChar( pxPort, *pxNext, serNO_BLOCK );\r
 165                 pxNext++;\r
 166         }\r
 167 }\r
 168 /*-----------------------------------------------------------*/\r
 169 \r
 170 signed portBASE_TYPE xSerialPutChar( xComPortHandle pxPort, signed char cOutChar, TickType_t xBlockTime )\r
 171 {\r
 172 signed portBASE_TYPE xReturn;\r
 173 \r
 174         if( xQueueSend( xCharsForTx, &cOutChar, xBlockTime ) == pdPASS )\r
 175         {\r
 176                 xReturn = pdPASS;\r
 177                 USART_ITConfig( USART1, USART_IT_TXE, ENABLE );\r
 178         }\r
 179         else\r
 180         {\r
 181                 xReturn = pdFAIL;\r
 182         }\r
 183 \r
 184         return xReturn;\r
 185 }\r
 186 /*-----------------------------------------------------------*/\r
 187 \r
 188 void vSerialClose( xComPortHandle xPort )\r
 189 {\r
 190         /* Not supported as not required by the demo application. */\r
 191 }\r
 192 /*-----------------------------------------------------------*/\r
 193 \r
 194 void vUARTInterruptHandler( void )\r
 195 {\r
 196 portBASE_TYPE xHigherPriorityTaskWoken = pdFALSE;\r
 197 char cChar;\r
 198 \r
 199         if( USART_GetITStatus( USART1, USART_IT_TXE ) == SET )\r
 200         {\r
 201                 /* The interrupt was caused by the THR becoming empty.  Are there any\r
 202                 more characters to transmit? */\r
 203                 if( xQueueReceiveFromISR( xCharsForTx, &cChar, &xHigherPriorityTaskWoken ) == pdTRUE )\r
 204                 {\r
 205                         /* A character was retrieved from the queue so can be sent to the\r
 206                         THR now. */\r
 207                         USART_SendData( USART1, cChar );\r
 208                 }\r
 209                 else\r
 210                 {\r
 211                         USART_ITConfig( USART1, USART_IT_TXE, DISABLE );                \r
 212                 }               \r
 213         }\r
 214         \r
 215         if( USART_GetITStatus( USART1, USART_IT_RXNE ) == SET )\r
 216         {\r
 217                 cChar = USART_ReceiveData( USART1 );\r
 218                 xQueueSendFromISR( xRxedChars, &cChar, &xHigherPriorityTaskWoken );\r
 219         }       \r
 220         \r
 221         portEND_SWITCHING_ISR( xHigherPriorityTaskWoken );\r
 222 }\r
 223 \r
 224 \r
 225 \r
 226 \r
 227 \r
 228         \r