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

   1 /*\r
   2     FreeRTOS V7.5.2 - Copyright (C) 2013 Real Time Engineers Ltd.\r
   3 \r
   4     VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.\r
   5 \r
   6     ***************************************************************************\r
   7      *                                                                       *\r
   8      *    FreeRTOS provides completely free yet professionally developed,    *\r
   9      *    robust, strictly quality controlled, supported, and cross          *\r
  10      *    platform software that has become a de facto standard.             *\r
  11      *                                                                       *\r
  12      *    Help yourself get started quickly and support the FreeRTOS         *\r
  13      *    project by purchasing a FreeRTOS tutorial book, reference          *\r
  14      *    manual, or both from: http://www.FreeRTOS.org/Documentation        *\r
  15      *                                                                       *\r
  16      *    Thank you!                                                         *\r
  17      *                                                                       *\r
  18     ***************************************************************************\r
  19 \r
  20     This file is part of the FreeRTOS distribution.\r
  21 \r
  22     FreeRTOS is free software; you can redistribute it and/or modify it under\r
  23     the terms of the GNU General Public License (version 2) as published by the\r
  24     Free Software Foundation >>!AND MODIFIED BY!<< the FreeRTOS exception.\r
  25 \r
  26     >>! NOTE: The modification to the GPL is included to allow you to distribute\r
  27     >>! a combined work that includes FreeRTOS without being obliged to provide\r
  28     >>! the source code for proprietary components outside of the FreeRTOS\r
  29     >>! kernel.\r
  30 \r
  31     FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY\r
  32     WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS\r
  33     FOR A PARTICULAR PURPOSE.  Full license text is available from the following\r
  34     link: http://www.freertos.org/a00114.html\r
  35 \r
  36     1 tab == 4 spaces!\r
  37 \r
  38     ***************************************************************************\r
  39      *                                                                       *\r
  40      *    Having a problem?  Start by reading the FAQ "My application does   *\r
  41      *    not run, what could be wrong?"                                     *\r
  42      *                                                                       *\r
  43      *    http://www.FreeRTOS.org/FAQHelp.html                               *\r
  44      *                                                                       *\r
  45     ***************************************************************************\r
  46 \r
  47     http://www.FreeRTOS.org - Documentation, books, training, latest versions,\r
  48     license and Real Time Engineers Ltd. contact details.\r
  49 \r
  50     http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,\r
  51     including FreeRTOS+Trace - an indispensable productivity tool, a DOS\r
  52     compatible FAT file system, and our tiny thread aware UDP/IP stack.\r
  53 \r
  54     http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High\r
  55     Integrity Systems to sell under the OpenRTOS brand.  Low cost OpenRTOS\r
  56     licenses offer ticketed support, indemnification and middleware.\r
  57 \r
  58     http://www.SafeRTOS.com - High Integrity Systems also provide a safety\r
  59     engineered and independently SIL3 certified version for use in safety and\r
  60     mission critical applications that require provable dependability.\r
  61 \r
  62     1 tab == 4 spaces!\r
  63 */\r
  64 \r
  65 /*\r
  66         BASIC INTERRUPT DRIVEN SERIAL PORT DRIVER FOR UART0.\r
  67 */\r
  68 \r
  69 /* Scheduler includes. */\r
  70 #include "FreeRTOS.h"\r
  71 #include "queue.h"\r
  72 #include "semphr.h"\r
  73 \r
  74 /* Library includes. */\r
  75 #include "stm32f10x_lib.h"\r
  76 \r
  77 /* Demo application includes. */\r
  78 #include "serial.h"\r
  79 /*-----------------------------------------------------------*/\r
  80 \r
  81 /* Misc defines. */\r
  82 #define serINVALID_QUEUE                                ( ( xQueueHandle ) 0 )\r
  83 #define serNO_BLOCK                                             ( ( portTickType ) 0 )\r
  84 #define serTX_BLOCK_TIME                                ( 40 / portTICK_RATE_MS )\r
  85 \r
  86 /*-----------------------------------------------------------*/\r
  87 \r
  88 /* The queue used to hold received characters. */\r
  89 static xQueueHandle xRxedChars;\r
  90 static xQueueHandle xCharsForTx;\r
  91 \r
  92 /*-----------------------------------------------------------*/\r
  93 \r
  94 /* UART interrupt handler. */\r
  95 void vUARTInterruptHandler( void );\r
  96 \r
  97 /*-----------------------------------------------------------*/\r
  98 \r
  99 /*\r
 100  * See the serial2.h header file.\r
 101  */\r
 102 xComPortHandle xSerialPortInitMinimal( unsigned portLONG ulWantedBaud, unsigned portBASE_TYPE uxQueueLength )\r
 103 {\r
 104 xComPortHandle xReturn;\r
 105 USART_InitTypeDef USART_InitStructure;\r
 106 NVIC_InitTypeDef NVIC_InitStructure;\r
 107 GPIO_InitTypeDef GPIO_InitStructure;\r
 108 \r
 109         /* Create the queues used to hold Rx/Tx characters. */\r
 110         xRxedChars = xQueueCreate( uxQueueLength, ( unsigned portBASE_TYPE ) sizeof( signed portCHAR ) );\r
 111         xCharsForTx = xQueueCreate( uxQueueLength + 1, ( unsigned portBASE_TYPE ) sizeof( signed portCHAR ) );\r
 112         \r
 113         /* If the queue/semaphore was created correctly then setup the serial port\r
 114         hardware. */\r
 115         if( ( xRxedChars != serINVALID_QUEUE ) && ( xCharsForTx != serINVALID_QUEUE ) )\r
 116         {\r
 117                 /* Enable USART1 clock */\r
 118                 RCC_APB2PeriphClockCmd( RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE ); \r
 119 \r
 120                 /* Configure USART1 Rx (PA10) as input floating */\r
 121                 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;\r
 122                 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;\r
 123                 GPIO_Init( GPIOA, &GPIO_InitStructure );\r
 124                 \r
 125                 /* Configure USART1 Tx (PA9) as alternate function push-pull */\r
 126                 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;\r
 127                 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;\r
 128                 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;\r
 129                 GPIO_Init( GPIOA, &GPIO_InitStructure );\r
 130 \r
 131                 USART_InitStructure.USART_BaudRate = ulWantedBaud;\r
 132                 USART_InitStructure.USART_WordLength = USART_WordLength_8b;\r
 133                 USART_InitStructure.USART_StopBits = USART_StopBits_1;\r
 134                 USART_InitStructure.USART_Parity = USART_Parity_No ;\r
 135                 USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;\r
 136                 USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;\r
 137                 USART_InitStructure.USART_Clock = USART_Clock_Disable;\r
 138                 USART_InitStructure.USART_CPOL = USART_CPOL_Low;\r
 139                 USART_InitStructure.USART_CPHA = USART_CPHA_2Edge;\r
 140                 USART_InitStructure.USART_LastBit = USART_LastBit_Disable;\r
 141                 \r
 142                 USART_Init( USART1, &USART_InitStructure );\r
 143                 \r
 144                 USART_ITConfig( USART1, USART_IT_RXNE, ENABLE );\r
 145                 \r
 146                 NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQChannel;\r
 147                 NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = configLIBRARY_KERNEL_INTERRUPT_PRIORITY;\r
 148                 NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;\r
 149                 NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;\r
 150                 NVIC_Init( &NVIC_InitStructure );\r
 151                 \r
 152                 USART_Cmd( USART1, ENABLE );            \r
 153         }\r
 154         else\r
 155         {\r
 156                 xReturn = ( xComPortHandle ) 0;\r
 157         }\r
 158 \r
 159         /* This demo file only supports a single port but we have to return\r
 160         something to comply with the standard demo header file. */\r
 161         return xReturn;\r
 162 }\r
 163 /*-----------------------------------------------------------*/\r
 164 \r
 165 signed portBASE_TYPE xSerialGetChar( xComPortHandle pxPort, signed portCHAR *pcRxedChar, portTickType xBlockTime )\r
 166 {\r
 167         /* The port handle is not required as this driver only supports one port. */\r
 168         ( void ) pxPort;\r
 169 \r
 170         /* Get the next character from the buffer.  Return false if no characters\r
 171         are available, or arrive before xBlockTime expires. */\r
 172         if( xQueueReceive( xRxedChars, pcRxedChar, xBlockTime ) )\r
 173         {\r
 174                 return pdTRUE;\r
 175         }\r
 176         else\r
 177         {\r
 178                 return pdFALSE;\r
 179         }\r
 180 }\r
 181 /*-----------------------------------------------------------*/\r
 182 \r
 183 void vSerialPutString( xComPortHandle pxPort, const signed portCHAR * const pcString, unsigned portSHORT usStringLength )\r
 184 {\r
 185 signed portCHAR *pxNext;\r
 186 \r
 187         /* A couple of parameters that this port does not use. */\r
 188         ( void ) usStringLength;\r
 189         ( void ) pxPort;\r
 190 \r
 191         /* NOTE: This implementation does not handle the queue being full as no\r
 192         block time is used! */\r
 193 \r
 194         /* The port handle is not required as this driver only supports UART1. */\r
 195         ( void ) pxPort;\r
 196 \r
 197         /* Send each character in the string, one at a time. */\r
 198         pxNext = ( signed portCHAR * ) pcString;\r
 199         while( *pxNext )\r
 200         {\r
 201                 xSerialPutChar( pxPort, *pxNext, serNO_BLOCK );\r
 202                 pxNext++;\r
 203         }\r
 204 }\r
 205 /*-----------------------------------------------------------*/\r
 206 \r
 207 signed portBASE_TYPE xSerialPutChar( xComPortHandle pxPort, signed portCHAR cOutChar, portTickType xBlockTime )\r
 208 {\r
 209 signed portBASE_TYPE xReturn;\r
 210 \r
 211         if( xQueueSend( xCharsForTx, &cOutChar, xBlockTime ) == pdPASS )\r
 212         {\r
 213                 xReturn = pdPASS;\r
 214                 USART_ITConfig( USART1, USART_IT_TXE, ENABLE );\r
 215         }\r
 216         else\r
 217         {\r
 218                 xReturn = pdFAIL;\r
 219         }\r
 220 \r
 221         return xReturn;\r
 222 }\r
 223 /*-----------------------------------------------------------*/\r
 224 \r
 225 void vSerialClose( xComPortHandle xPort )\r
 226 {\r
 227         /* Not supported as not required by the demo application. */\r
 228 }\r
 229 /*-----------------------------------------------------------*/\r
 230 \r
 231 void vUARTInterruptHandler( void )\r
 232 {\r
 233 portBASE_TYPE xHigherPriorityTaskWoken = pdFALSE;\r
 234 portCHAR cChar;\r
 235 \r
 236         if( USART_GetITStatus( USART1, USART_IT_TXE ) == SET )\r
 237         {\r
 238                 /* The interrupt was caused by the THR becoming empty.  Are there any\r
 239                 more characters to transmit? */\r
 240                 if( xQueueReceiveFromISR( xCharsForTx, &cChar, &xHigherPriorityTaskWoken ) == pdTRUE )\r
 241                 {\r
 242                         /* A character was retrieved from the queue so can be sent to the\r
 243                         THR now. */\r
 244                         USART_SendData( USART1, cChar );\r
 245                 }\r
 246                 else\r
 247                 {\r
 248                         USART_ITConfig( USART1, USART_IT_TXE, DISABLE );                \r
 249                 }               \r
 250         }\r
 251         \r
 252         if( USART_GetITStatus( USART1, USART_IT_RXNE ) == SET )\r
 253         {\r
 254                 cChar = USART_ReceiveData( USART1 );\r
 255                 xQueueSendFromISR( xRxedChars, &cChar, &xHigherPriorityTaskWoken );\r
 256         }       \r
 257         \r
 258         portEND_SWITCHING_ISR( xHigherPriorityTaskWoken );\r
 259 }\r
 260 \r
 261 \r
 262 \r
 263 \r
 264 \r
 265         \r