]> git.sur5r.net Git - freertos/blobdiff - FreeRTOS/Demo/WIN32-MingW/main_full.c
Update the demo directory to use the version 8 type naming conventions.
[freertos] / FreeRTOS / Demo / WIN32-MingW / main_full.c
index 75098dc0b3ab2f38109b6eb446338254aa553a8e..099a8aead079ca2028536573787113d983e89ffc 100644 (file)
@@ -1,5 +1,5 @@
 /*\r
-    FreeRTOS V7.6.0 - Copyright (C) 2013 Real Time Engineers Ltd. \r
+    FreeRTOS V8.0.0:rc1 - Copyright (C) 2014 Real Time Engineers Ltd.\r
     All rights reserved\r
 \r
     VISIT http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.\r
  * application.  It is provided as a convenient development and demonstration\r
  * test bed only.  This was tested using Windows XP on a dual core laptop.\r
  *\r
- * Windows will not be running the FreeRTOS simulator threads continuously, so \r
- * the timing information in the FreeRTOS+Trace logs have no meaningful units.  \r
- * See the documentation page for the Windows simulator for an explanation of \r
+ * Windows will not be running the FreeRTOS simulator threads continuously, so\r
+ * the timing information in the FreeRTOS+Trace logs have no meaningful units.\r
+ * See the documentation page for the Windows simulator for an explanation of\r
  * the slow timing:\r
  * http://www.freertos.org/FreeRTOS-Windows-Simulator-Emulator-for-Visual-Studio-and-Eclipse-MingW.html\r
  * - READ THE WEB DOCUMENTATION FOR THIS PORT FOR MORE INFORMATION ON USING IT -\r
  *\r
  * NOTE 2:  This project provides two demo applications.  A simple blinky style\r
  * project, and a more comprehensive test and demo application.  The\r
- * mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting in main.c is used to select \r
- * between the two.  See the notes on using mainCREATE_SIMPLE_BLINKY_DEMO_ONLY \r
+ * mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting in main.c is used to select\r
+ * between the two.  See the notes on using mainCREATE_SIMPLE_BLINKY_DEMO_ONLY\r
  * in main.c.  This file implements the comprehensive test and demo version.\r
  *\r
  * NOTE 3:  This file only contains the source code that is specific to the\r
- * basic demo.  Generic functions, such FreeRTOS hook functions, are defined in \r
+ * basic demo.  Generic functions, such FreeRTOS hook functions, are defined in\r
  * main.c.\r
  *******************************************************************************\r
  *\r
- * main() creates all the demo application tasks, then starts the scheduler.  \r
- * The web documentation provides more details of the standard demo application \r
- * tasks, which provide no particular functionality but do provide a good \r
+ * main() creates all the demo application tasks, then starts the scheduler.\r
+ * The web documentation provides more details of the standard demo application\r
+ * tasks, which provide no particular functionality but do provide a good\r
  * example of how to use the FreeRTOS API.\r
  *\r
  * In addition to the standard demo tasks, the following tasks and tests are\r
 #define mainBLOCK_Q_PRIORITY                   ( tskIDLE_PRIORITY + 2 )\r
 #define mainCREATOR_TASK_PRIORITY              ( tskIDLE_PRIORITY + 3 )\r
 #define mainFLASH_TASK_PRIORITY                        ( tskIDLE_PRIORITY + 1 )\r
-#define mainuIP_TASK_PRIORITY                  ( tskIDLE_PRIORITY + 2 )\r
 #define mainINTEGER_TASK_PRIORITY              ( tskIDLE_PRIORITY )\r
 #define mainGEN_QUEUE_TASK_PRIORITY            ( tskIDLE_PRIORITY )\r
 #define mainFLOP_TASK_PRIORITY                 ( tskIDLE_PRIORITY )\r
 /* Task function prototypes. */\r
 static void prvCheckTask( void *pvParameters );\r
 \r
-/* A task that is created from the idle task to test the functionality of \r
+/* A task that is created from the idle task to test the functionality of\r
 eTaskStateGet(). */\r
 static void prvTestTask( void *pvParameters );\r
 \r
@@ -162,6 +161,18 @@ static void prvTestTask( void *pvParameters );
  */\r
 static void prvDemonstrateTaskStateAndHandleGetFunctions( void );\r
 \r
+/*\r
+ * Called from the idle task hook function to demonstrate the use of \r
+ * xTimerPendFunctionCall() as xTimerPendFunctionCall() is not demonstrated by\r
+ * any of the standard demo tasks.\r
+ */\r
+static void prvDemonstratePendingFunctionCall( void );\r
+\r
+/*\r
+ * The function that is pended by prvDemonstratePendingFunctionCall().\r
+ */\r
+static void prvPendedFunction( void *pvParameter1, uint32_t ulParameter2 );\r
+\r
 /*\r
  * A task to demonstrate the use of the xQueueSpacesAvailable() function.\r
  */\r
@@ -174,14 +185,14 @@ static char *pcStatusMessage = "OK";
 \r
 /* This semaphore is created purely to test using the vSemaphoreDelete() and\r
 semaphore tracing API functions.  It has no other purpose. */\r
-static xSemaphoreHandle xMutexToDelete = NULL;\r
+static SemaphoreHandle_t xMutexToDelete = NULL;\r
 \r
 /*-----------------------------------------------------------*/\r
 \r
 int main_full( void )\r
 {\r
        /* Start the check task as described at the top of this file. */\r
-       xTaskCreate( prvCheckTask, ( signed char * ) "Check", configMINIMAL_STACK_SIZE, NULL, mainCHECK_TASK_PRIORITY, NULL );\r
+       xTaskCreate( prvCheckTask, "Check", configMINIMAL_STACK_SIZE, NULL, mainCHECK_TASK_PRIORITY, NULL );\r
 \r
        /* Create the standard demo tasks. */\r
        vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );\r
@@ -196,7 +207,7 @@ int main_full( void )
        vStartDynamicPriorityTasks();\r
        vStartQueueSetTasks();\r
        vStartQueueOverwriteTask( mainQUEUE_OVERWRITE_PRIORITY );\r
-       xTaskCreate( prvDemoQueueSpaceFunctions, ( signed char * ) "QSpace", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );\r
+       xTaskCreate( prvDemoQueueSpaceFunctions, "QSpace", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, NULL );\r
        vStartEventGroupTasks();\r
 \r
        #if( configUSE_PREEMPTION != 0  )\r
@@ -219,7 +230,7 @@ int main_full( void )
        /* Start the scheduler itself. */\r
        vTaskStartScheduler();\r
 \r
-    /* Should never get here unless there was not enough heap space to create \r
+    /* Should never get here unless there was not enough heap space to create\r
        the idle and other system tasks. */\r
     return 0;\r
 }\r
@@ -227,8 +238,8 @@ int main_full( void )
 \r
 static void prvCheckTask( void *pvParameters )\r
 {\r
-portTickType xNextWakeTime;\r
-const portTickType xCycleFrequency = 2500 / portTICK_RATE_MS;\r
+TickType_t xNextWakeTime;\r
+const TickType_t xCycleFrequency = 2500 / portTICK_PERIOD_MS;\r
 \r
        /* Just to remove compiler warning. */\r
        ( void ) pvParameters;\r
@@ -259,9 +270,9 @@ const portTickType xCycleFrequency = 2500 / portTICK_RATE_MS;
            else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )\r
            {\r
                        pcStatusMessage = "Error: IntMath";\r
-           }   \r
+           }\r
                else if( xAreGenericQueueTasksStillRunning() != pdTRUE )\r
-               {                       \r
+               {\r
                        pcStatusMessage = "Error: GenQueue";\r
                }\r
                else if( xAreQueuePeekTasksStillRunning() != pdTRUE )\r
@@ -309,7 +320,7 @@ const portTickType xCycleFrequency = 2500 / portTICK_RATE_MS;
                        pcStatusMessage = "Error: Queue overwrite";\r
                }\r
 \r
-               /* This is the only task that uses stdout so its ok to call printf() \r
+               /* This is the only task that uses stdout so its ok to call printf()\r
                directly. */\r
                printf( ( char * ) "%s - %u\r\n", pcStatusMessage, ( unsigned int ) xTaskGetTickCount() );\r
                fflush( stdout );\r
@@ -344,11 +355,11 @@ void *pvAllocated;
 \r
 /* These three functions are only meant for use by trace code, and not for\r
 direct use from application code, hence their prototypes are not in queue.h. */\r
-extern void vQueueSetQueueNumber( xQueueHandle pxQueue, unsigned portBASE_TYPE uxQueueNumber );\r
-extern unsigned portBASE_TYPE uxQueueGetQueueNumber( xQueueHandle pxQueue );\r
-extern unsigned char ucQueueGetQueueType( xQueueHandle pxQueue );\r
-extern void vTaskSetTaskNumber( xTaskHandle xTask, unsigned portBASE_TYPE uxHandle );\r
-extern unsigned portBASE_TYPE uxTaskGetTaskNumber( xTaskHandle xTask );\r
+extern void vQueueSetQueueNumber( QueueHandle_t pxQueue, unsigned portBASE_TYPE uxQueueNumber );\r
+extern unsigned portBASE_TYPE uxQueueGetQueueNumber( QueueHandle_t pxQueue );\r
+extern uint8_t ucQueueGetQueueType( QueueHandle_t pxQueue );\r
+extern void vTaskSetTaskNumber( TaskHandle_t xTask, unsigned portBASE_TYPE uxHandle );\r
+extern unsigned portBASE_TYPE uxTaskGetTaskNumber( TaskHandle_t xTask );\r
 \r
        /* Sleep to reduce CPU load, but don't sleep indefinitely in case there are\r
        tasks waiting to be terminated by the idle task. */\r
@@ -358,8 +369,12 @@ extern unsigned portBASE_TYPE uxTaskGetTaskNumber( xTaskHandle xTask );
        the standard demo tasks. */\r
        prvDemonstrateTaskStateAndHandleGetFunctions();\r
 \r
+       /* Demonstrate the use of xTimerPendFunctionCall(), which is not\r
+       demonstrated by any of the standard demo tasks. */\r
+       prvDemonstratePendingFunctionCall();\r
+\r
        /* If xMutexToDelete has not already been deleted, then delete it now.\r
-       This is done purely to demonstrate the use of, and test, the \r
+       This is done purely to demonstrate the use of, and test, the\r
        vSemaphoreDelete() macro.  Care must be taken not to delete a semaphore\r
        that has tasks blocked on it. */\r
        if( xMutexToDelete != NULL )\r
@@ -378,7 +393,7 @@ extern unsigned portBASE_TYPE uxTaskGetTaskNumber( xTaskHandle xTask );
                xMutexToDelete = NULL;\r
        }\r
 \r
-       /* Exercise heap_4 a bit.  The malloc failed hook will trap failed \r
+       /* Exercise heap_4 a bit.  The malloc failed hook will trap failed\r
        allocations so there is no need to test here. */\r
        pvAllocated = pvPortMalloc( ( rand() % 100 ) + 1 );\r
        vPortFree( pvAllocated );\r
@@ -400,21 +415,56 @@ void vFullDemoTickHookFunction( void )
        /* Call the periodic queue overwrite from ISR demo. */\r
        vQueueOverwritePeriodicISRDemo();\r
 \r
-       /* Write to a queue that is in use as part of the queue set demo to \r
+       /* Write to a queue that is in use as part of the queue set demo to\r
        demonstrate using queue sets from an ISR. */\r
        vQueueSetAccessQueueSetFromISR();\r
+\r
+       /* Exercise event groups from interrupts. */\r
+       vPeriodicEventGroupsProcessing();\r
+}\r
+/*-----------------------------------------------------------*/\r
+\r
+static void prvPendedFunction( void *pvParameter1, uint32_t ulParameter2 )\r
+{\r
+static uint32_t ulLastParameter1 = 1000UL, ulLastParameter2 = 0UL;\r
+uint32_t ulParameter1;\r
+\r
+       ulParameter1 = ( uint32_t ) pvParameter1;\r
+\r
+       /* Ensure the parameters are as expected. */\r
+       configASSERT( ulParameter1 == ( ulLastParameter1 + 1 ) );\r
+       configASSERT( ulParameter2 == ( ulLastParameter2 + 1 ) );\r
+\r
+       /* Remember the parameters for the next time the function is called. */\r
+       ulLastParameter1 = ulParameter1;\r
+       ulLastParameter2 = ulParameter2;\r
+}\r
+/*-----------------------------------------------------------*/\r
+\r
+static void prvDemonstratePendingFunctionCall( void )\r
+{\r
+static uint32_t ulParameter1 = 1000UL, ulParameter2 = 0UL;\r
+const TickType_t xDontBlock = 0; /* This is called from the idle task so must *not* attempt to block. */\r
+\r
+       /* prvPendedFunction() just expects the parameters to be incremented by one\r
+       each time it is called. */\r
+       ulParameter1++;\r
+       ulParameter2++;\r
+\r
+       /* Pend the function call, sending the parameters. */\r
+       xTimerPendFunctionCall( prvPendedFunction, ( void * ) ulParameter1, ulParameter2, xDontBlock );\r
 }\r
 /*-----------------------------------------------------------*/\r
 \r
 static void prvDemonstrateTaskStateAndHandleGetFunctions( void )\r
 {\r
-xTaskHandle xIdleTaskHandle, xTimerTaskHandle;\r
+TaskHandle_t xIdleTaskHandle, xTimerTaskHandle;\r
 const unsigned char ucConstTaskNumber = 0x55U;\r
-signed char *pcTaskName;\r
+char *pcTaskName;\r
 static portBASE_TYPE xPerformedOneShotTests = pdFALSE;\r
-xTaskHandle xTestTask;\r
+TaskHandle_t xTestTask;\r
 \r
-       /* Demonstrate the use of the xTimerGetTimerDaemonTaskHandle() and \r
+       /* Demonstrate the use of the xTimerGetTimerDaemonTaskHandle() and\r
        xTaskGetIdleTaskHandle() functions.  Also try using the function that sets\r
        the task number. */\r
        xIdleTaskHandle = xTaskGetIdleTaskHandle();\r
@@ -422,7 +472,7 @@ xTaskHandle xTestTask;
        vTaskSetTaskNumber( xIdleTaskHandle, ( unsigned long ) ucConstTaskNumber );\r
        configASSERT( uxTaskGetTaskNumber( xIdleTaskHandle ) == ucConstTaskNumber );\r
 \r
-       /* This is the idle hook, so the current task handle should equal the \r
+       /* This is the idle hook, so the current task handle should equal the\r
        returned idle task handle. */\r
        if( xTaskGetCurrentTaskHandle() != xIdleTaskHandle )\r
        {\r
@@ -431,7 +481,7 @@ xTaskHandle xTestTask;
 \r
        /* Check the timer task handle was returned correctly. */\r
        pcTaskName = pcTaskGetTaskName( xTimerTaskHandle );\r
-       if( strcmp( ( char * ) pcTaskName, "Tmr Svc" ) != 0 )\r
+       if( strcmp( pcTaskName, "Tmr Svc" ) != 0 )\r
        {\r
                pcStatusMessage = "Error:  Returned timer task handle was incorrect";\r
        }\r
@@ -457,7 +507,7 @@ xTaskHandle xTestTask;
                xPerformedOneShotTests = pdTRUE;\r
 \r
                /* Create a test task to use to test other eTaskStateGet() return values. */\r
-               if( xTaskCreate( prvTestTask, ( const signed char * const ) "Test", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, &xTestTask ) == pdPASS )\r
+               if( xTaskCreate( prvTestTask, "Test", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, &xTestTask ) == pdPASS )\r
                {\r
                        /* If this task is running, the test task must be in the ready state. */\r
                        if( eTaskStateGet( xTestTask ) != eReady )\r
@@ -485,7 +535,7 @@ xTaskHandle xTestTask;
 \r
 static void prvDemoQueueSpaceFunctions( void *pvParameters )\r
 {\r
-xQueueHandle xQueue = NULL;\r
+QueueHandle_t xQueue = NULL;\r
 const unsigned portBASE_TYPE uxQueueLength = 10;\r
 unsigned portBASE_TYPE uxReturn, x;\r
 \r
@@ -503,7 +553,7 @@ unsigned portBASE_TYPE uxReturn, x;
                {\r
                        /* Ask how many messages are available... */\r
                        uxReturn = uxQueueMessagesWaiting( xQueue );\r
-                       \r
+\r
                        /* Check the number of messages being reported as being available\r
                        is as expected, and force an assert if not. */\r
                        if( uxReturn != x )\r
@@ -515,7 +565,7 @@ unsigned portBASE_TYPE uxReturn, x;
 \r
                        /* Ask how many spaces remain in the queue... */\r
                        uxReturn = uxQueueSpacesAvailable( xQueue );\r
-                       \r
+\r
                        /* Check the number of spaces being reported as being available\r
                        is as expected, and force an assert if not. */\r
                        if( uxReturn != ( uxQueueLength - x ) )\r
@@ -537,7 +587,7 @@ unsigned portBASE_TYPE uxReturn, x;
                }\r
 \r
                uxReturn = uxQueueSpacesAvailable( xQueue );\r
-                       \r
+\r
                if( uxReturn != 0 )\r
                {\r
                        configASSERT( xQueue == NULL );\r