From 991ddf48f333176aa532e3399d9fa6d8edf06eb8 Mon Sep 17 00:00:00 2001 From: richardbarry Date: Wed, 8 Dec 2010 17:10:25 +0000 Subject: [PATCH] Change the terminology from 'pseudo' to 'simulated' in the Win32 port layer. git-svn-id: https://svn.code.sf.net/p/freertos/code/trunk@1168 1d2547de-c912-0410-9cb9-b8ca96c0e9e2 --- Source/portable/MSVC-MingW/port.c | 48 +++++++++++++------------- Source/portable/MSVC-MingW/portmacro.h | 6 ++-- 2 files changed, 27 insertions(+), 27 deletions(-) diff --git a/Source/portable/MSVC-MingW/port.c b/Source/portable/MSVC-MingW/port.c index 24b4577af..6c3727a6c 100644 --- a/Source/portable/MSVC-MingW/port.c +++ b/Source/portable/MSVC-MingW/port.c @@ -71,11 +71,11 @@ static DWORD WINAPI prvSimulatedPeripheralTimer( LPVOID lpParameter ); * Process all the simulated interrupts - each represented by a bit in * ulPendingInterrupts variable. */ -static void prvProcessPseudoInterrupts( void ); +static void prvProcessSimulatedInterrupts( void ); /* * Interrupt handlers used by the kernel itself. These are executed from the - * pseudo interrupt handler thread. + * simulated interrupt handler thread. */ static unsigned long prvProcessDeleteThreadInterrupt( void ); static unsigned long prvProcessYieldInterrupt( void ); @@ -95,16 +95,16 @@ typedef struct } xThreadState; -/* Pseudo interrupts waiting to be processed. This is a bit mask where each +/* Simulated interrupts waiting to be processed. This is a bit mask where each bit represents one interrupt, so a maximum of 32 interrupts can be simulated. */ static volatile unsigned long ulPendingInterrupts = 0UL; -/* An event used to inform the pseudo interrupt processing thread (a high +/* An event used to inform the simulated interrupt processing thread (a high priority thread that simulated interrupt processing) that an interrupt is pending. */ static void *pvInterruptEvent = NULL; -/* Mutex used to protect all the pseudo interrupt variables that are accessed +/* Mutex used to protect all the simulated interrupt variables that are accessed by multiple threads. */ static void *pvInterruptEventMutex = NULL; @@ -113,7 +113,7 @@ initialised to a non-zero value so interrupts do not become enabled during the initialisation phase. As each task has its own critical nesting value ulCriticalNesting will get set to zero when the first task runs. This initialisation is probably not critical in this simulated environment as the -pseudo interrupt handlers do not get created until the FreeRTOS scheduler is +simulated interrupt handlers do not get created until the FreeRTOS scheduler is started anyway. */ static unsigned long ulCriticalNesting = 9999UL; @@ -134,7 +134,7 @@ static DWORD WINAPI prvSimulatedPeripheralTimer( LPVOID lpParameter ) for(;;) { - /* Wait until the timer expires and we can access the pseudo interrupt + /* Wait until the timer expires and we can access the simulated interrupt variables. *NOTE* this is not a 'real time' way of generating tick events as the next wake time should be relative to the previous wake time, not the time that Sleep() is called. It is done this way to @@ -151,7 +151,7 @@ static DWORD WINAPI prvSimulatedPeripheralTimer( LPVOID lpParameter ) handler thread. */ SetEvent( pvInterruptEvent ); - /* Give back the mutex so the pseudo interrupt handler unblocks + /* Give back the mutex so the simulated interrupt handler unblocks and can access the interrupt handler variables. */ ReleaseMutex( pvInterruptEventMutex ); } @@ -209,7 +209,7 @@ xThreadState *pxThreadState; /* Set the priority of this thread such that it is above the priority of the threads that run tasks. This higher priority is required to ensure - pseudo interrupts take priority over tasks. */ + simulated interrupts take priority over tasks. */ pvHandle = GetCurrentThread(); if( pvHandle == NULL ) { @@ -229,7 +229,7 @@ xThreadState *pxThreadState; if( lSuccess == pdPASS ) { /* Start the thread that simulates the timer peripheral to generate - tick interrupts. The priority is set below that of the pseudo + tick interrupts. The priority is set below that of the simulated interrupt handler so the interrupt event mutex is used for the handshake / overrun protection. */ pvHandle = CreateThread( NULL, 0, prvSimulatedPeripheralTimer, NULL, 0, NULL ); @@ -250,12 +250,12 @@ xThreadState *pxThreadState; behave as an embedded engineer might expect. */ ResumeThread( pxThreadState->pvThread ); - /* Handle all pseudo interrupts - including yield requests and + /* Handle all simulated interrupts - including yield requests and simulated ticks. */ - prvProcessPseudoInterrupts(); + prvProcessSimulatedInterrupts(); } - /* Would not expect to return from prvProcessPseudoInterrupts(), so should + /* Would not expect to return from prvProcessSimulatedInterrupts(), so should not get here. */ return 0; } @@ -295,14 +295,14 @@ unsigned long ulSwitchRequired; } /*-----------------------------------------------------------*/ -static void prvProcessPseudoInterrupts( void ) +static void prvProcessSimulatedInterrupts( void ) { unsigned long ulSwitchRequired, i; xThreadState *pxThreadState; void *pvObjectList[ 2 ]; - /* Going to block on the mutex that ensured exclusive access to the pseudo - interrupt objects, and the event that signals that a pseudo interrupt + /* Going to block on the mutex that ensured exclusive access to the simulated + interrupt objects, and the event that signals that a simulated interrupt should be processed. */ pvObjectList[ 0 ] = pvInterruptEventMutex; pvObjectList[ 1 ] = pvInterruptEvent; @@ -311,7 +311,7 @@ void *pvObjectList[ 2 ]; { WaitForMultipleObjects( sizeof( pvObjectList ) / sizeof( void * ), pvObjectList, TRUE, INFINITE ); - /* Used to indicate whether the pseudo interrupt processing has + /* Used to indicate whether the simulated interrupt processing has necessitated a context switch to another task/thread. */ ulSwitchRequired = pdFALSE; @@ -319,7 +319,7 @@ void *pvObjectList[ 2 ]; represented by a bit in the 32bit ulPendingInterrupts variable. */ for( i = 0; i < portMAX_INTERRUPTS; i++ ) { - /* Is the pseudo interrupt pending? */ + /* Is the simulated interrupt pending? */ if( ulPendingInterrupts & ( 1UL << i ) ) { /* Is a handler installed? */ @@ -382,8 +382,8 @@ xThreadState *pxThreadState; { /* The task is deleting itself, and so the thread that is running now is also to be deleted. This has to be deferred until this thread is - no longer running, so its done in the pseudo interrupt handler thread. */ - vPortGeneratePseudoInterrupt( portINTERRUPT_DELETE_THREAD ); + no longer running, so its done in the simulated interrupt handler thread. */ + vPortGenerateSimulatedInterrupt( portINTERRUPT_DELETE_THREAD ); } else { @@ -405,7 +405,7 @@ void vPortEndScheduler( void ) } /*-----------------------------------------------------------*/ -void vPortGeneratePseudoInterrupt( unsigned long ulInterruptNumber ) +void vPortGenerateSimulatedInterrupt( unsigned long ulInterruptNumber ) { xThreadState *pxThreadState; @@ -415,7 +415,7 @@ xThreadState *pxThreadState; WaitForSingleObject( pvInterruptEventMutex, INFINITE ); ulPendingInterrupts |= ( 1 << ulInterruptNumber ); - /* The pseudo interrupt is now held pending, but don't actually process it + /* The simulated interrupt is now held pending, but don't actually process it yet if this call is within a critical section. It is possible for this to be in a critical section as calls to wait for mutexes are accumulative. */ if( ulCriticalNesting == 0 ) @@ -454,7 +454,7 @@ void vPortEnterCritical( void ) if( xTaskGetSchedulerState() != taskSCHEDULER_NOT_STARTED ) { /* The interrupt event mutex is held for the entire critical section, - effectively disabling (pseudo) interrupts. */ + effectively disabling (simulated) interrupts. */ WaitForSingleObject( pvInterruptEventMutex, INFINITE ); ulCriticalNesting++; } @@ -482,7 +482,7 @@ long lMutexNeedsReleasing; ulCriticalNesting--; /* Were any interrupts set to pending while interrupts were - (pseudo) disabled? */ + (simulated) disabled? */ if( ulPendingInterrupts != 0UL ) { SetEvent( pvInterruptEvent ); diff --git a/Source/portable/MSVC-MingW/portmacro.h b/Source/portable/MSVC-MingW/portmacro.h index a83fbd17a..cd1c7ab3a 100644 --- a/Source/portable/MSVC-MingW/portmacro.h +++ b/Source/portable/MSVC-MingW/portmacro.h @@ -81,7 +81,7 @@ #define portTICK_RATE_MS ( ( portTickType ) 1000 / configTICK_RATE_HZ ) #define portBYTE_ALIGNMENT 4 -#define portYIELD() vPortGeneratePseudoInterrupt( portINTERRUPT_YIELD ) +#define portYIELD() vPortGenerateSimulatedInterrupt( portINTERRUPT_YIELD ) void vPortDeleteThread( void *pvThreadToDelete ); #define traceTASK_DELETE( pxTCB ) vPortDeleteThread( pxTCB ) @@ -109,10 +109,10 @@ void vPortExitCritical( void ); * Each bit can be used to represent an individual interrupt - with the first * two bits being used for the Yield and Tick interrupts respectively. */ -void vPortGeneratePseudoInterrupt( unsigned long ulInterruptNumber ); +void vPortGenerateSimulatedInterrupt( unsigned long ulInterruptNumber ); /* - * Install an interrupt handler to be called by the pseudo interrupt handler + * Install an interrupt handler to be called by the simulated interrupt handler * thread. The interrupt number must be above any used by the kernel itself * (at the time of writing the kernel was using interrupt numbers 0, 1, and 2 * as defined above). The number must also be lower than 32. -- 2.39.5