2010-11-15 05:01:50 +08:00
/*
2015-01-16 21:20:28 +08:00
FreeRTOS V8 .2 .0 - Copyright ( C ) 2015 Real Time Engineers Ltd .
2013-10-15 03:56:47 +08:00
All rights reserved
2012-10-16 20:17:47 +08:00
2013-07-18 02:32:57 +08:00
VISIT http : //www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.
2010-11-15 05:01:50 +08:00
This file is part of the FreeRTOS distribution .
FreeRTOS is free software ; you can redistribute it and / or modify it under
the terms of the GNU General Public License ( version 2 ) as published by the
2013-07-18 02:32:57 +08:00
Free Software Foundation > > ! AND MODIFIED BY ! < < the FreeRTOS exception .
2013-02-20 02:36:58 +08:00
2015-01-16 21:20:28 +08:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2014-04-24 22:26:36 +08:00
> > ! NOTE : The modification to the GPL is included to allow you to ! < <
> > ! distribute a combined work that includes FreeRTOS without being ! < <
> > ! obliged to provide the source code for proprietary components ! < <
> > ! outside of the FreeRTOS kernel . ! < <
2015-01-16 21:20:28 +08:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2013-02-20 02:36:58 +08:00
FreeRTOS is distributed in the hope that it will be useful , but WITHOUT ANY
WARRANTY ; without even the implied warranty of MERCHANTABILITY or FITNESS
2014-12-22 03:09:18 +08:00
FOR A PARTICULAR PURPOSE . Full license text is available on the following
2013-07-18 02:32:57 +08:00
link : http : //www.freertos.org/a00114.html
2010-11-15 05:01:50 +08:00
2014-12-22 03:09:18 +08:00
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* *
* FreeRTOS provides completely free yet professionally developed , *
* robust , strictly quality controlled , supported , and cross *
* platform software that is more than just the market leader , it *
* is the industry ' s de facto standard . *
* *
* Help yourself get started quickly while simultaneously helping *
* to support the FreeRTOS project by purchasing a FreeRTOS *
* tutorial book , reference manual , or both : *
* http : //www.FreeRTOS.org/Documentation *
* *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2015-01-16 21:20:28 +08:00
http : //www.FreeRTOS.org/FAQHelp.html - Having a problem? Start by reading
the FAQ page " My application does not run, what could be wrong? " . Have you
defined configASSERT ( ) ?
2014-12-22 03:09:18 +08:00
2015-01-16 21:20:28 +08:00
http : //www.FreeRTOS.org/support - In return for receiving this top quality
embedded software for free we request you assist our global community by
participating in the support forum .
2014-12-22 03:09:18 +08:00
2015-01-16 21:20:28 +08:00
http : //www.FreeRTOS.org/training - Investing in training allows your team to
be as productive as possible as early as possible . Now you can receive
FreeRTOS training directly from Richard Barry , CEO of Real Time Engineers
Ltd , and the world ' s leading authority on the world ' s leading RTOS .
2013-02-20 02:36:58 +08:00
2012-05-09 00:36:52 +08:00
http : //www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,
2013-07-18 02:32:57 +08:00
including FreeRTOS + Trace - an indispensable productivity tool , a DOS
compatible FAT file system , and our tiny thread aware UDP / IP stack .
2014-12-22 03:09:18 +08:00
http : //www.FreeRTOS.org/labs - Where new FreeRTOS products go to incubate.
Come and try FreeRTOS + TCP , our new open source TCP / IP stack for FreeRTOS .
2015-01-16 21:20:28 +08:00
http : //www.OpenRTOS.com - Real Time Engineers ltd. license FreeRTOS to High
2014-12-22 03:09:18 +08:00
Integrity Systems ltd . to sell under the OpenRTOS brand . Low cost OpenRTOS
licenses offer ticketed support , indemnification and commercial middleware .
2013-07-18 02:32:57 +08:00
http : //www.SafeRTOS.com - High Integrity Systems also provide a safety
engineered and independently SIL3 certified version for use in safety and
2013-02-20 02:36:58 +08:00
mission critical applications that require provable dependability .
2013-07-18 02:32:57 +08:00
1 tab = = 4 spaces !
2010-11-15 05:01:50 +08:00
*/
# ifndef PORTMACRO_H
# define PORTMACRO_H
# include <Windows.h>
/******************************************************************************
Defines
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* Type definitions. */
# define portCHAR char
# define portFLOAT float
# define portDOUBLE double
# define portLONG long
# define portSHORT short
2015-02-11 23:41:30 +08:00
# define portSTACK_TYPE size_t
2013-12-29 22:06:04 +08:00
# define portBASE_TYPE long
2015-02-11 23:41:30 +08:00
# define portPOINTER_SIZE_TYPE size_t
2013-12-29 22:06:04 +08:00
typedef portSTACK_TYPE StackType_t ;
typedef long BaseType_t ;
typedef unsigned long UBaseType_t ;
2010-11-15 05:01:50 +08:00
2011-03-01 00:12:55 +08:00
# if( configUSE_16_BIT_TICKS == 1 )
2013-12-29 22:06:04 +08:00
typedef uint16_t TickType_t ;
# define portMAX_DELAY ( TickType_t ) 0xffff
2010-11-15 05:01:50 +08:00
# else
2013-12-29 22:06:04 +08:00
typedef uint32_t TickType_t ;
# define portMAX_DELAY ( TickType_t ) 0xffffffffUL
2014-12-18 19:02:15 +08:00
2015-02-11 23:41:30 +08:00
/* 32/64-bit tick type on a 32/64-bit architecture, so reads of the tick
count do not need to be guarded with a critical section . */
2014-12-18 19:02:15 +08:00
# define portTICK_TYPE_IS_ATOMIC 1
2010-11-15 05:01:50 +08:00
# endif
/* Hardware specifics. */
# define portSTACK_GROWTH ( -1 )
2014-01-06 04:40:55 +08:00
# define portTICK_PERIOD_MS ( ( TickType_t ) 1000 / configTICK_RATE_HZ )
2015-02-11 23:41:30 +08:00
2015-02-17 22:28:10 +08:00
# if defined( __x86_64__) || defined( _M_X64 )
2015-02-11 23:41:30 +08:00
# define portBYTE_ALIGNMENT 8
# else
# define portBYTE_ALIGNMENT 4
# endif
2010-11-15 05:01:50 +08:00
2010-12-09 01:10:25 +08:00
# define portYIELD() vPortGenerateSimulatedInterrupt( portINTERRUPT_YIELD )
2010-11-22 17:52:36 +08:00
2013-12-29 22:06:04 +08:00
void vPortCloseRunningThread ( void * pvTaskToDelete , volatile BaseType_t * pxPendYield ) ;
2010-11-22 17:52:36 +08:00
void vPortDeleteThread ( void * pvThreadToDelete ) ;
2012-04-24 21:09:22 +08:00
# define portCLEAN_UP_TCB( pxTCB ) vPortDeleteThread( pxTCB )
2013-12-14 21:16:05 +08:00
# define portPRE_TASK_DELETE_HOOK( pvTaskToDelete, pxPendYield ) vPortCloseRunningThread( ( pvTaskToDelete ), ( pxPendYield ) )
2013-12-24 00:02:03 +08:00
# define portDISABLE_INTERRUPTS() vPortEnterCritical()
# define portENABLE_INTERRUPTS() vPortExitCritical()
2010-11-15 05:01:50 +08:00
/* Critical section handling. */
void vPortEnterCritical ( void ) ;
void vPortExitCritical ( void ) ;
# define portENTER_CRITICAL() vPortEnterCritical()
# define portEXIT_CRITICAL() vPortExitCritical()
2014-09-03 06:39:54 +08:00
# ifndef configUSE_PORT_OPTIMISED_TASK_SELECTION
# define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
# endif
2013-12-24 00:02:03 +08:00
# if configUSE_PORT_OPTIMISED_TASK_SELECTION == 1
2012-09-23 22:35:12 +08:00
/* Check the configuration. */
2012-09-24 20:10:08 +08:00
# if( configMAX_PRIORITIES > 32 )
2012-09-23 22:35:12 +08:00
# error configUSE_PORT_OPTIMISED_TASK_SELECTION can only be set to 1 when configMAX_PRIORITIES is less than or equal to 32. It is very rare that a system requires more than 10 to 15 difference priorities as tasks that share a priority will time slice.
# endif
2013-12-24 00:02:03 +08:00
/* Store/clear the ready priorities in a bit map. */
# define portRECORD_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) |= ( 1UL << ( uxPriority ) )
# define portRESET_READY_PRIORITY( uxPriority, uxReadyPriorities ) ( uxReadyPriorities ) &= ~( 1UL << ( uxPriority ) )
2012-09-23 22:35:12 +08:00
2013-12-24 00:02:03 +08:00
/*-----------------------------------------------------------*/
2012-09-23 22:35:12 +08:00
2013-12-24 00:02:03 +08:00
# ifdef __GNUC__
# define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) \
__asm volatile ( " mov %0, %%eax \n \t " \
" bsr %%eax, %%eax \n \t " \
" mov %%eax, %1 \n \t " \
: " =r " ( uxTopPriority ) : " r " ( uxReadyPriorities ) : " eax " )
# else
2012-09-23 22:35:12 +08:00
/* BitScanReverse returns the bit position of the most significant '1'
in the word . */
2014-09-03 06:39:54 +08:00
# define portGET_HIGHEST_PRIORITY( uxTopPriority, uxReadyPriorities ) _BitScanReverse( ( DWORD * ) &( uxTopPriority ), ( uxReadyPriorities ) )
2013-12-24 00:02:03 +08:00
# endif /* __GNUC__ */
# endif /* taskRECORD_READY_PRIORITY */
2012-09-23 22:35:12 +08:00
2014-01-17 17:45:02 +08:00
# ifndef __GNUC__
__pragma ( warning ( disable : 4211 ) ) /* Nonstandard extension used, as extern is only nonstandard to MSVC. */
# endif
2012-09-23 22:35:12 +08:00
2010-11-15 05:01:50 +08:00
/* Task function macros as described on the FreeRTOS.org WEB site. */
# define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void * pvParameters )
# define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void * pvParameters )
# define portINTERRUPT_YIELD ( 0UL )
# define portINTERRUPT_TICK ( 1UL )
2013-12-12 18:19:07 +08:00
/*
2010-11-15 05:01:50 +08:00
* Raise a simulated interrupt represented by the bit mask in ulInterruptMask .
* Each bit can be used to represent an individual interrupt - with the first
* two bits being used for the Yield and Tick interrupts respectively .
*/
2013-12-29 22:06:04 +08:00
void vPortGenerateSimulatedInterrupt ( uint32_t ulInterruptNumber ) ;
2010-11-15 05:01:50 +08:00
2010-11-22 18:38:43 +08:00
/*
2013-12-12 18:19:07 +08:00
* Install an interrupt handler to be called by the simulated interrupt handler
2010-11-22 18:38:43 +08:00
* 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
2013-12-12 18:19:07 +08:00
* as defined above ) . The number must also be lower than 32.
2010-11-22 18:38:43 +08:00
*
* Interrupt handler functions must return a non - zero value if executing the
2013-12-12 18:19:07 +08:00
* handler resulted in a task switch being required .
2010-11-22 18:38:43 +08:00
*/
2013-12-29 22:06:04 +08:00
void vPortSetInterruptHandler ( uint32_t ulInterruptNumber , uint32_t ( * pvHandler ) ( void ) ) ;
2010-11-15 05:01:50 +08:00
# endif
2015-02-11 23:41:30 +08:00