/*\r
- FreeRTOS V6.1.0 - Copyright (C) 2010 Real Time Engineers Ltd.\r
+ FreeRTOS V7.0.0 - Copyright (C) 2011 Real Time Engineers Ltd.\r
+ \r
\r
***************************************************************************\r
- * *\r
- * If you are: *\r
- * *\r
- * + New to FreeRTOS, *\r
- * + Wanting to learn FreeRTOS or multitasking in general quickly *\r
- * + Looking for basic training, *\r
- * + Wanting to improve your FreeRTOS skills and productivity *\r
- * *\r
- * then take a look at the FreeRTOS books - available as PDF or paperback *\r
- * *\r
- * "Using the FreeRTOS Real Time Kernel - a Practical Guide" *\r
- * http://www.FreeRTOS.org/Documentation *\r
- * *\r
- * A pdf reference manual is also available. Both are usually delivered *\r
- * to your inbox within 20 minutes to two hours when purchased between 8am *\r
- * and 8pm GMT (although please allow up to 24 hours in case of *\r
- * exceptional circumstances). Thank you for your support! *\r
- * *\r
+ * *\r
+ * FreeRTOS tutorial books are available in pdf and paperback. *\r
+ * Complete, revised, and edited pdf reference manuals are also *\r
+ * available. *\r
+ * *\r
+ * Purchasing FreeRTOS documentation will not only help you, by *\r
+ * ensuring you get running as quickly as possible and with an *\r
+ * in-depth knowledge of how to use FreeRTOS, it will also help *\r
+ * the FreeRTOS project to continue with its mission of providing *\r
+ * professional grade, cross platform, de facto standard solutions *\r
+ * for microcontrollers - completely free of charge! *\r
+ * *\r
+ * >>> See http://www.FreeRTOS.org/Documentation for details. <<< *\r
+ * *\r
+ * Thank you for using FreeRTOS, and thank you for your support! *\r
+ * *\r
***************************************************************************\r
\r
+\r
This file is part of the FreeRTOS distribution.\r
\r
FreeRTOS is free software; you can redistribute it and/or modify it under\r
the terms of the GNU General Public License (version 2) as published by the\r
Free Software Foundation AND MODIFIED BY the FreeRTOS exception.\r
- ***NOTE*** The exception to the GPL is included to allow you to distribute\r
- a combined work that includes FreeRTOS without being obliged to provide the\r
- source code for proprietary components outside of the FreeRTOS kernel.\r
- FreeRTOS is distributed in the hope that it will be useful, but WITHOUT\r
- ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\r
- FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for\r
+ >>>NOTE<<< The modification to the GPL is included to allow you to\r
+ distribute a combined work that includes FreeRTOS without being obliged to\r
+ provide the source code for proprietary components outside of the FreeRTOS\r
+ kernel. FreeRTOS is distributed in the hope that it will be useful, but\r
+ WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\r
+ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for\r
more details. You should have received a copy of the GNU General Public\r
License and the FreeRTOS license exception along with FreeRTOS; if not it\r
can be viewed here: http://www.freertos.org/a00114.html and also obtained\r
\r
/* BASIC INTERRUPT DRIVEN SERIAL PORT DRIVER.\r
*\r
- * This file only supports UART A0 in loopback mode, and has not been tested\r
- * for real UART operation (only loopback mode) so is not guaranteed to have\r
- * a correct baud rate configuration.\r
+ * This is not a proper UART driver. It only supports one port, uses loopback\r
+ * mode, and is used to test interrupts that use the FreeRTOS API as part of\r
+ * a wider test suite. Nor is it intended to show an efficient implementation\r
+ * of a UART interrupt service routine as queues are used to pass individual\r
+ * characters one at a time!\r
*/\r
\r
/* Standard includes. */\r
/* Demo application includes. */\r
#include "serial.h"\r
\r
-/* HAL includes. */\r
-#include "hal_usb.h"\r
-\r
-/* Constants required to setup the hardware. */\r
-#define serTX_AND_RX ( ( unsigned portCHAR ) 0x03 )\r
-\r
/* Misc. constants. */\r
#define serNO_BLOCK ( ( portTickType ) 0 )\r
\r
xRxedChars = xQueueCreate( uxQueueLength, ( unsigned portBASE_TYPE ) sizeof( signed portCHAR ) );\r
xCharsForTx = xQueueCreate( uxQueueLength, ( unsigned portBASE_TYPE ) sizeof( signed portCHAR ) );\r
\r
-#if 0\r
/* Reset UART. */\r
- UCA0CTL1 |= UCSWRST;\r
+ UCA1CTL1 |= UCSWRST;\r
\r
/* Use SMCLK. */\r
- UCA0CTL1 = UCSSEL0 | UCSSEL1;\r
+ UCA1CTL1 = UCSSEL0 | UCSSEL1;\r
\r
/* Setup baud rate low byte. */\r
- UCA0BR0 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
+ UCA1BR0 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
\r
/* Setup baud rate high byte. */\r
ulBaudRateCount >>= 8UL;\r
- UCA0BR1 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
+ UCA1BR1 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
\r
/* UCLISTEN sets loopback mode! */\r
- UCA0STAT = UCLISTEN;\r
+ UCA1STAT = UCLISTEN;\r
\r
- /* Clear interrupts. */\r
-// UCA0IFG = 0;\r
- \r
/* Enable interrupts. */\r
- UCA0IE |= UCRXIE;\r
+ UCA1IE |= UCRXIE;\r
\r
/* Take out of reset. */\r
- UCA0CTL1 &= ~UCSWRST;\r
-#else\r
- USB_PORT_SEL |= USB_PIN_RXD + USB_PIN_TXD;\r
- USB_PORT_DIR |= USB_PIN_TXD;\r
- USB_PORT_DIR &= ~USB_PIN_RXD;\r
- \r
- UCA1CTL1 |= UCSWRST; //Reset State\r
- UCA1CTL0 = UCMODE_0;\r
- \r
- UCA1CTL0 &= ~UC7BIT; // 8bit char\r
- UCA1CTL1 |= UCSSEL_2;\r
-// UCA1BR0 = 16; // 8Mhz/57600=138\r
-// UCA1BR1 = 1;\r
- /* Setup baud rate low byte. */\r
- UCA0BR0 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
-\r
- /* Setup baud rate high byte. */\r
- ulBaudRateCount >>= 8UL;\r
- UCA0BR1 = ( unsigned portCHAR ) ( ulBaudRateCount & ( unsigned portLONG ) 0xff );\r
-\r
- UCA1MCTL = 0xE;\r
- UCA1CTL1 &= ~UCSWRST;\r
- UCA1IE |= UCRXIE;\r
-#endif\r
+ UCA1CTL1 &= ~UCSWRST;\r
}\r
portEXIT_CRITICAL();\r
\r
- /* Unlike other ports, this serial code does not allow for more than one\r
- com port. We therefore don't return a pointer to a port structure and can\r
- instead just return NULL. */\r
+ /* Note the comments at the top of this file about this not being a generic\r
+ UART driver. */\r
return NULL;\r
}\r
/*-----------------------------------------------------------*/\r
{\r
signed portBASE_TYPE xReturn;\r
\r
+ /* Send the next character to the queue of characters waiting transmission,\r
+ then enable the UART Tx interrupt, just in case UART transmission has already\r
+ completed and switched itself off. */\r
xReturn = xQueueSend( xCharsForTx, &cOutChar, xBlockTime );\r
- UCA0IE |= UCTXIE;\r
+ UCA1IE |= UCTXIE;\r
\r
return xReturn;\r
}\r
/*-----------------------------------------------------------*/\r
-char cTxedBytes[ 512 ];\r
-char cRxedBytes[ 512 ];\r
-volatile int xIndex = 0;\r
-volatile int xIndex2 = 0;\r
\r
-#pragma vector=USCI_A0_VECTOR\r
-static __interrupt void prvUSCI_A0_ISR( void )\r
+/* The implementation of this interrupt is provided to demonstrate the use\r
+of queues from inside an interrupt service routine. It is *not* intended to\r
+be an efficient interrupt implementation. A real application should make use\r
+of the DMA. Or, as a minimum, transmission and reception could use a simple\r
+RAM ring buffer, and synchronise with a task using a semaphore when a complete\r
+message has been received or transmitted. */\r
+#pragma vector=USCI_A1_VECTOR\r
+static __interrupt void prvUSCI_A1_ISR( void )\r
{\r
-signed portCHAR cChar;\r
-portBASE_TYPE xTaskWoken = pdFALSE;\r
+signed char cChar;\r
portBASE_TYPE xHigherPriorityTaskWoken = pdFALSE;\r
\r
- while( UCA0IFG & UCRXIFG )\r
+ while( ( UCA1IFG & UCRXIFG ) != 0 )\r
{\r
/* Get the character from the UART and post it on the queue of Rxed\r
characters. */\r
- cChar = UCA0RXBUF;\r
-\r
-if( xIndex2 < 500 )\r
-{\r
- cRxedBytes[ xIndex2++ ] = cChar;\r
-}\r
-\r
+ cChar = UCA1RXBUF;\r
xQueueSendFromISR( xRxedChars, &cChar, &xHigherPriorityTaskWoken );\r
}\r
\r
- if( UCA0IFG & UCTXIFG )\r
+ /* If there is a Tx interrupt pending and the tx interrupts are enabled. */\r
+ if( ( UCA1IFG & UCTXIFG ) != 0 )\r
{\r
/* The previous character has been transmitted. See if there are any\r
further characters waiting transmission. */\r
- if( xQueueReceiveFromISR( xCharsForTx, &cChar, &xTaskWoken ) == pdTRUE )\r
+ if( xQueueReceiveFromISR( xCharsForTx, &cChar, &xHigherPriorityTaskWoken ) == pdTRUE )\r
{\r
-if( xIndex < 500 )\r
-{\r
- cTxedBytes[ xIndex++ ] = cChar;\r
-}\r
-\r
/* There was another character queued - transmit it now. */\r
- UCA0TXBUF = cChar;\r
+ UCA1TXBUF = cChar;\r
}\r
else\r
{\r
/* There were no other characters to transmit - disable the Tx\r
interrupt. */\r
- UCA0IE &= ~UCTXIE;\r
+ UCA1IE &= ~UCTXIE;\r
}\r
}\r
\r
- __bic_SR_register_on_exit( SCG1 + SCG0 + OSCOFF + CPUOFF ); \r
+ __bic_SR_register_on_exit( SCG1 + SCG0 + OSCOFF + CPUOFF );\r
+ \r
+ /* If writing to a queue caused a task to unblock, and the unblocked task\r
+ has a priority equal to or above the task that this interrupt interrupted,\r
+ then lHigherPriorityTaskWoken will have been set to pdTRUE internally within\r
+ xQueuesendFromISR(), and portEND_SWITCHING_ISR() will ensure that this\r
+ interrupt returns directly to the higher priority unblocked task.\r
+ \r
+ THIS MUST BE THE LAST THING DONE IN THE ISR. */ \r
portYIELD_FROM_ISR( xHigherPriorityTaskWoken );\r
}\r
\r