2 FreeRTOS MCF5235 port - Copyright (C) 2006 Christian Walter.
4 This file is part of the FreeRTOS distribution.
6 FreeRTOS is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 FreeRTOS is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with FreeRTOS; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 A special exception to the GPL can be applied should you wish to distribute
21 a combined work that includes FreeRTOS, without being obliged to provide
22 the source code for any proprietary components. See the licensing section
23 of http://www.FreeRTOS.org for full details of how and when the exception
26 ***************************************************************************
27 See http://www.FreeRTOS.org for documentation, latest information, license
28 and contact details. Please ensure to read the configuration and relevant
29 port sections of the online documentation.
30 ***************************************************************************
33 /* ------------------------ MCF523x includes ------------------------------ */
37 /* ------------------------ FreeRTOS includes ----------------------------- */
44 /* ----------------------- Defines ----------------------------------------- */
45 #define BAUDRATE_VALUE(fsys, baud) ( ( fsys )/(32UL * baud) )
46 #define MCF_UART_VECTOR ( 64 + 13 )
48 #define COM_BLOCK_RETRYTIME 10
50 /* ------------------------ Static functions ------------------------------ */
51 static void prvSerialISR( void );
53 /* ------------------------ Static variables ------------------------------ */
56 portBASE_TYPE xInitialized;
57 xQueueHandle xRXChars;
58 xQueueHandle xTXChars;
61 static xComPortIF_t xComPortIF[ COM_NIFACE ];
63 /* ------------------------ Begin implementation -------------------------- */
65 xSerialPortInitMinimal( unsigned portLONG ulWantedBaud,
66 unsigned portBASE_TYPE uxQueueLength )
68 extern void ( *__RAMVEC[] ) ( );
69 xComPortHandle xReturn;
70 portBASE_TYPE xOldIPL;
72 /* Create the queues used to hold Rx and Tx characters. */
73 xComPortIF[ 0 ].xRXChars =
74 xQueueCreate( uxQueueLength, ( unsigned portBASE_TYPE )sizeof( signed portCHAR ) );
75 xComPortIF[ 0 ].xTXChars =
76 xQueueCreate( uxQueueLength + 1, ( unsigned portBASE_TYPE )sizeof( signed portCHAR ) );
78 /* If the queues were created correctly then setup the serial port hardware. */
79 if( ( xComPortIF[ 0 ].xRXChars != 0 ) && ( xComPortIF[ 0 ].xTXChars != 0 ) )
81 xOldIPL = portSET_IPL( portIPL_MAX );
83 /* UART 0: Reset transmitter, receiver and mode register pointer */
84 MCF_UART_UCR0 = MCF_UART_UCR_MISC( 0x3 );
85 MCF_UART_UCR0 = MCF_UART_UCR_MISC( 0x2 );
86 MCF_UART_UCR0 = MCF_UART_UCR_MISC( 0x1 );
88 /* Enable receive interrupts. */
89 MCF_UART_UIMR0 = MCF_UART_UIMR_RXRDY_FU;
91 /* 8 Databits, 1 Stopbit and no parity */
92 MCF_UART_UMR0 = MCF_UART_UMR_PM( 0x3 ) | MCF_UART_UMR_SB( 0x7 ) | MCF_UART_UMR_BC( 0x3 );
95 MCF_UART_UCSR0 = MCF_UART_UCSR_RCS( 0xd ) | MCF_UART_UCSR_TCS( 0xd );
96 MCF_UART_UBG10 = BAUDRATE_VALUE( FSYS_2, ulWantedBaud ) >> 8U;
97 MCF_UART_UBG20 = BAUDRATE_VALUE( FSYS_2, ulWantedBaud ) & 0xFFU;
99 /* UART 0: Enable interrupts */
100 __RAMVEC[MCF_UART_VECTOR] = prvSerialISR;
101 MCF_INTC0_ICR13 = MCF_INTC0_ICRn_IL( 0x2 ) | MCF_INTC0_ICRn_IP( 0x1 );
102 MCF_INTC0_IMRL &= ~MCF_INTC0_IMRL_INT_MASK13;
104 /* UART 0 Miscellaneous */
107 /* UART 0: Enable pins */
108 MCF_GPIO_PAR_UART = MCF_GPIO_PAR_UART_PAR_U0RXD | MCF_GPIO_PAR_UART_PAR_U0TXD;
110 /* Enable the UART. */
111 MCF_UART_UCR0 = MCF_UART_UCR_RXC( 0x1 ) | MCF_UART_UCR_TXC( 0x1 );
113 xComPortIF[ 0 ].xInitialized = TRUE;
114 xReturn = ( xComPortHandle ) &xComPortIF[ 0 ];
116 ( void )portSET_IPL( xOldIPL );
120 xReturn = ( xComPortHandle ) 0;
127 xSerialGetChar( xComPortHandle pxPort, signed portCHAR * pcRxedChar,
128 portTickType xBlockTime )
131 portBASE_TYPE xResult = pdFALSE;
132 /* Lookup the correct interface. */
133 for( i = 0; i < COM_NIFACE; i++ )
135 if( pxPort == ( xComPortHandle ) &xComPortIF[ i ] )
140 /* This COM port is available. */
141 if( ( i != COM_NIFACE ) && xComPortIF[ i ].xInitialized )
143 /* Get the next character from the buffer. Return false if no characters
144 * are available, or arrive before xBlockTime expires.
146 if( xQueueReceive( xComPortIF[ i ].xRXChars, pcRxedChar, xBlockTime ) )
155 vSerialPutString( xComPortHandle pxPort, const signed portCHAR *
156 const pcString, unsigned portSHORT usStringLength )
159 signed portCHAR *pChNext;
161 /* Send each character in the string, one at a time. */
162 pChNext = ( signed portCHAR * )pcString;
163 for( i = 0; i < usStringLength; i++ )
165 /* Block until character has been transmitted. */
166 while( xSerialPutChar( pxPort, *pChNext, COM_BLOCK_RETRYTIME ) != pdTRUE ); pChNext++;
171 xSerialPutChar( xComPortHandle pxPort, signed portCHAR cOutChar,
172 portTickType xBlockTime )
175 portBASE_TYPE xResult = pdFALSE;
176 portBASE_TYPE xOldIPL;
177 /* Lookup the correct interface. */
178 for( i = 0; i < COM_NIFACE; i++ )
180 if( pxPort == ( xComPortHandle ) &xComPortIF[ i ] )
185 /* This COM port is available. */
186 if( ( i != COM_NIFACE ) && xComPortIF[ i ].xInitialized )
188 /* Place the character in the queue of characters to be transmitted. */
189 if( xQueueSend( xComPortIF[ i ].xTXChars, &cOutChar, xBlockTime ) == pdPASS )
191 /* Turn on the Tx interrupt so the ISR will remove the character from the
192 * queue and send it. */
193 MCF_UART_UIMR0 = MCF_UART_UIMR_TXRDY | MCF_UART_UIMR_RXRDY_FU;
201 xSerialPutCharNOISR( xComPortHandle pxPort, signed portCHAR cOutChar )
204 portBASE_TYPE xResult = pdFALSE;
205 portBASE_TYPE xOldIPL = portSET_IPL( portIPL_MAX );
206 /* Lookup the correct interface. */
207 for( i = 0; i < COM_NIFACE; i++ )
209 if( pxPort == ( xComPortHandle ) &xComPortIF[ i ] )
214 /* This COM port is available. Support for this only available for COM1 right now. */
215 if( ( i != COM_NIFACE ) && ( i == 0 ) )
217 /* Wait until the transmit buffer is ready. */
218 while( !( MCF_UART_USR0 & MCF_UART_USR_TXRDY ) );
219 /* Place the character in the transmit buffer. */
220 MCF_UART_UTB0 = cOutChar;
223 ( void )portSET_IPL( xOldIPL );
228 vSerialPutStringNOISR( xComPortHandle pxPort, const signed portCHAR *
229 const pcString, unsigned portSHORT usStringLength )
232 signed portCHAR *pChNext;
233 portBASE_TYPE xOldIPL = portSET_IPL( portIPL_MAX );
235 /* Send each character in the string, one at a time. */
236 pChNext = ( signed portCHAR * )pcString;
237 for( i = 0; i < usStringLength; i++ )
239 /* Block until character has been transmitted. */
240 while( xSerialPutCharNOISR( pxPort, *pChNext ) != pdTRUE );
243 ( void )portSET_IPL( xOldIPL );
247 vSerialClose( xComPortHandle xPort )
249 /* Not supported as not required by the demo application. */
255 static signed portCHAR cChar;
256 static portBASE_TYPE xTaskWokenByTx = pdFALSE, xTaskWokenByRx = pdFALSE;
258 /* We have to remvoe the effect of the GCC. Please note that the
259 * __attribute__ ((interrupt_handler)) does not work here because we
260 * have to do the storing of the registers ourself. Another problem
261 * is the usage of a frame pointer which is unlinked on entry.
263 #if _GCC_USES_FP == 1
264 asm volatile ( "unlk %fp\n\t" );
266 /* This ISR can cause a context switch, so the first statement must be
267 * a call to the portENTER_SWITCHING_ISR() macro. This must be BEFORE any
268 * variable declarations.
270 portENTER_SWITCHING_ISR();
272 /* Ready to send a character from the buffer. */
273 if( MCF_UART_USR0 & MCF_UART_USR_TXRDY )
275 /* Transmit buffer is ready. Test if there are characters available. */
276 if( xQueueReceiveFromISR( xComPortIF[ 0 ].xTXChars, &cChar, &xTaskWokenByTx ) ==
279 /* A character was retrieved from the queue so can be sent. */
280 MCF_UART_UTB0 = cChar;
284 /* Leave only receiver enabled. */
285 MCF_UART_UIMR0 = MCF_UART_UIMR_RXRDY_FU;
288 if( MCF_UART_USR0 & MCF_UART_USR_RXRDY )
290 cChar = MCF_UART_URB0;
292 xQueueSendFromISR( xComPortIF[ 0].xRXChars, &cChar, xTaskWokenByRx );
294 /* Exit the ISR. If a task was woken by either a character being
295 * or transmitted then a context switch will occur.
297 portEXIT_SWITCHING_ISR( ( xTaskWokenByTx || xTaskWokenByRx ) );