mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-08-18 09:08:33 -04:00
Rename \FreeRTOS-Plus\Source\FreeRTOS-Plus-IoT-SDK to \FreeRTOS-Plus\Source\FreeRTOS-IoT-Libraries.
This commit is contained in:
Gaurav Aggarwal
parent
7af8756c97
commit
9dd72d4b44
45 changed files with 0 additions and 0 deletions
|
|
@ -0,0 +1,39 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_atomic.h
|
||||
* @brief Chooses the appropriate atomic operations header.
|
||||
*
|
||||
* On FreeRTOS, this file chooses the atomic header provided with the FreeRTOS
|
||||
* kernel.
|
||||
*/
|
||||
|
||||
#ifndef IOT_ATOMIC_H_
|
||||
#define IOT_ATOMIC_H_
|
||||
|
||||
#include "atomic.h"
|
||||
|
||||
#endif /* ifndef IOT_ATOMIC_H_ */
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_init.h
|
||||
* @brief Provides function signatures for common initialization and cleanup of
|
||||
* this SDK.
|
||||
*/
|
||||
|
||||
#ifndef IOT_INIT_H_
|
||||
#define IOT_INIT_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
|
||||
/**
|
||||
* @brief One-time initialization function for this SDK.
|
||||
*
|
||||
* This function initializes common libraries, such as static memory and task
|
||||
* pool. <b>It must be called once (and only once) before calling any other
|
||||
* function in this SDK.</b> Calling this function more than once without first
|
||||
* calling `IotSdk_Cleanup` may result in a crash.
|
||||
*
|
||||
* @return `true` if initialization succeeded; `false` otherwise. Logs may be
|
||||
* printed in case of failure.
|
||||
*
|
||||
* @warning No thread-safety guarantees are provided for this function.
|
||||
*/
|
||||
bool IotSdk_Init( void );
|
||||
|
||||
/**
|
||||
* @brief One-time deinitialization function for all common libraries.
|
||||
*
|
||||
* This function frees resources taken in `IotSdk_Init`. No other function
|
||||
* in this SDK may be called after calling this function unless `IotSdk_Init`
|
||||
* is called again.
|
||||
*
|
||||
* @warning No thread-safety guarantees are provided for this function.
|
||||
*/
|
||||
void IotSdk_Cleanup( void );
|
||||
|
||||
#endif /* IOT_INIT_H_ */
|
||||
|
|
@ -0,0 +1,956 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_linear_containers.h
|
||||
* @brief Declares and implements doubly-linked lists and queues.
|
||||
*/
|
||||
|
||||
#ifndef IOT_LINEAR_CONTAINERS_H_
|
||||
#define IOT_LINEAR_CONTAINERS_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/**
|
||||
* @defgroup linear_containers_datatypes_listqueue List and queue
|
||||
* @brief Structures that represent a list or queue.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @ingroup linear_containers_datatypes_listqueue
|
||||
* @brief Link member placed in structs of a list or queue.
|
||||
*
|
||||
* All elements in a list or queue must contain one of these members. The macro
|
||||
* #IotLink_Container can be used to calculate the starting address of the
|
||||
* link's container.
|
||||
*/
|
||||
typedef struct IotLink
|
||||
{
|
||||
struct IotLink * pPrevious; /**< @brief Pointer to the previous element. */
|
||||
struct IotLink * pNext; /**< @brief Pointer to the next element. */
|
||||
} IotLink_t;
|
||||
|
||||
/**
|
||||
* @ingroup linear_containers_datatypes_listqueue
|
||||
* @brief Represents a doubly-linked list.
|
||||
*/
|
||||
typedef IotLink_t IotListDouble_t;
|
||||
|
||||
/**
|
||||
* @ingroup linear_containers_datatypes_listqueue
|
||||
* @brief Represents a queue.
|
||||
*/
|
||||
typedef IotLink_t IotDeQueue_t;
|
||||
|
||||
/**
|
||||
* @constantspage{linear_containers,linear containers library}
|
||||
*
|
||||
* @section linear_containers_constants_initializers Linear Containers Initializers
|
||||
* @brief Provides default values for initializing the linear containers data types.
|
||||
*
|
||||
* @snippet this define_linear_containers_initializers
|
||||
*
|
||||
* All user-facing data types of the linear containers library should be initialized
|
||||
* using one of the following.
|
||||
*
|
||||
* @warning Failure to initialize a linear containers data type with the appropriate
|
||||
* initializer may result in a runtime error!
|
||||
* @note The initializers may change at any time in future versions, but their
|
||||
* names will remain the same.
|
||||
*/
|
||||
/* @[define_linear_containers_initializers] */
|
||||
#define IOT_LINK_INITIALIZER { 0 } /**< @brief Initializer for an #IotLink_t. */
|
||||
#define IOT_LIST_DOUBLE_INITIALIZER IOT_LINK_INITIALIZER /**< @brief Initializer for an #IotListDouble_t. */
|
||||
#define IOT_DEQUEUE_INITIALIZER IOT_LINK_INITIALIZER /**< @brief Initializer for an #IotDeQueue_t. */
|
||||
/* @[define_linear_containers_initializers] */
|
||||
|
||||
/**
|
||||
* @def IotContainers_Assert( expression )
|
||||
* @brief Assertion macro for the linear containers library.
|
||||
*
|
||||
* Set @ref IOT_CONTAINERS_ENABLE_ASSERTS to `1` to enable assertions in the linear
|
||||
* containers library.
|
||||
*
|
||||
* @param[in] expression Expression to be evaluated.
|
||||
*/
|
||||
#if IOT_CONTAINERS_ENABLE_ASSERTS == 1
|
||||
#ifndef IotContainers_Assert
|
||||
#include <assert.h>
|
||||
#define IotContainers_Assert( expression ) assert( expression )
|
||||
#endif
|
||||
#else
|
||||
#define IotContainers_Assert( expression )
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Calculates the starting address of a containing struct.
|
||||
*
|
||||
* @param[in] type Type of the containing struct.
|
||||
* @param[in] pLink Pointer to a link member.
|
||||
* @param[in] linkName Name of the #IotLink_t in the containing struct.
|
||||
*/
|
||||
#define IotLink_Container( type, pLink, linkName ) \
|
||||
( ( type * ) ( void * ) ( ( ( uint8_t * ) ( pLink ) ) - offsetof( type, linkName ) ) )
|
||||
|
||||
/**
|
||||
* @brief Iterates through all elements of a linear container.
|
||||
*
|
||||
* Container elements must not be freed or removed while iterating.
|
||||
*
|
||||
* @param[in] pStart The first element to iterate from.
|
||||
* @param[out] pLink Pointer to a container element.
|
||||
*/
|
||||
#define IotContainers_ForEach( pStart, pLink ) \
|
||||
for( ( pLink ) = ( pStart )->pNext; \
|
||||
( pLink ) != ( pStart ); \
|
||||
( pLink ) = ( pLink )->pNext )
|
||||
|
||||
/**
|
||||
* @functionspage{linear_containers,linear containers library}
|
||||
* - @functionname{linear_containers_function_link_islinked}
|
||||
* - @functionname{linear_containers_function_list_double_create}
|
||||
* - @functionname{linear_containers_function_list_double_count}
|
||||
* - @functionname{linear_containers_function_list_double_isempty}
|
||||
* - @functionname{linear_containers_function_list_double_peekhead}
|
||||
* - @functionname{linear_containers_function_list_double_peektail}
|
||||
* - @functionname{linear_containers_function_list_double_inserthead}
|
||||
* - @functionname{linear_containers_function_list_double_inserttail}
|
||||
* - @functionname{linear_containers_function_list_double_insertbefore}
|
||||
* - @functionname{linear_containers_function_list_double_insertafter}
|
||||
* - @functionname{linear_containers_function_list_double_insertsorted}
|
||||
* - @functionname{linear_containers_function_list_double_remove}
|
||||
* - @functionname{linear_containers_function_list_double_removehead}
|
||||
* - @functionname{linear_containers_function_list_double_removetail}
|
||||
* - @functionname{linear_containers_function_list_double_removeall}
|
||||
* - @functionname{linear_containers_function_list_double_findfirstmatch}
|
||||
* - @functionname{linear_containers_function_list_double_removefirstmatch}
|
||||
* - @functionname{linear_containers_function_list_double_removeallmatches}
|
||||
* - @functionname{linear_containers_function_queue_create}
|
||||
* - @functionname{linear_containers_function_queue_count}
|
||||
* - @functionname{linear_containers_function_queue_isempty}
|
||||
* - @functionname{linear_containers_function_queue_peekhead}
|
||||
* - @functionname{linear_containers_function_queue_peektail}
|
||||
* - @functionname{linear_containers_function_queue_enqueuehead}
|
||||
* - @functionname{linear_containers_function_queue_dequeuehead}
|
||||
* - @functionname{linear_containers_function_queue_enqueuetail}
|
||||
* - @functionname{linear_containers_function_queue_dequeuetail}
|
||||
* - @functionname{linear_containers_function_queue_remove}
|
||||
* - @functionname{linear_containers_function_queue_removeall}
|
||||
* - @functionname{linear_containers_function_queue_removeallmatches}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @functionpage{IotLink_IsLinked,linear_containers,link_islinked}
|
||||
* @functionpage{IotListDouble_Create,linear_containers,list_double_create}
|
||||
* @functionpage{IotListDouble_Count,linear_containers,list_double_count}
|
||||
* @functionpage{IotListDouble_IsEmpty,linear_containers,list_double_isempty}
|
||||
* @functionpage{IotListDouble_PeekHead,linear_containers,list_double_peekhead}
|
||||
* @functionpage{IotListDouble_PeekTail,linear_containers,list_double_peektail}
|
||||
* @functionpage{IotListDouble_InsertHead,linear_containers,list_double_inserthead}
|
||||
* @functionpage{IotListDouble_InsertTail,linear_containers,list_double_inserttail}
|
||||
* @functionpage{IotListDouble_InsertBefore,linear_containers,list_double_insertbefore}
|
||||
* @functionpage{IotListDouble_InsertAfter,linear_containers,list_double_insertafter}
|
||||
* @functionpage{IotListDouble_InsertSorted,linear_containers,list_double_insertsorted}
|
||||
* @functionpage{IotListDouble_Remove,linear_containers,list_double_remove}
|
||||
* @functionpage{IotListDouble_RemoveHead,linear_containers,list_double_removehead}
|
||||
* @functionpage{IotListDouble_RemoveTail,linear_containers,list_double_removetail}
|
||||
* @functionpage{IotListDouble_RemoveAll,linear_containers,list_double_removeall}
|
||||
* @functionpage{IotListDouble_FindFirstMatch,linear_containers,list_double_findfirstmatch}
|
||||
* @functionpage{IotListDouble_RemoveFirstMatch,linear_containers,list_double_removefirstmatch}
|
||||
* @functionpage{IotListDouble_RemoveAllMatches,linear_containers,list_double_removeallmatches}
|
||||
* @functionpage{IotDeQueue_Create,linear_containers,queue_create}
|
||||
* @functionpage{IotDeQueue_Count,linear_containers,queue_count}
|
||||
* @functionpage{IotDeQueue_IsEmpty,linear_containers,queue_isempty}
|
||||
* @functionpage{IotDeQueue_PeekHead,linear_containers,queue_peekhead}
|
||||
* @functionpage{IotDeQueue_PeekTail,linear_containers,queue_peektail}
|
||||
* @functionpage{IotDeQueue_EnqueueHead,linear_containers,queue_enqueuehead}
|
||||
* @functionpage{IotDeQueue_DequeueHead,linear_containers,queue_dequeuehead}
|
||||
* @functionpage{IotDeQueue_EnqueueTail,linear_containers,queue_enqueuetail}
|
||||
* @functionpage{IotDeQueue_DequeueTail,linear_containers,queue_dequeuetail}
|
||||
* @functionpage{IotDeQueue_Remove,linear_containers,queue_remove}
|
||||
* @functionpage{IotDeQueue_RemoveAll,linear_containers,queue_removeall}
|
||||
* @functionpage{IotDeQueue_RemoveAllMatches,linear_containers,queue_removeallmatches}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Check if an #IotLink_t is linked in a list or queue.
|
||||
*
|
||||
* @param[in] pLink The link to check.
|
||||
*
|
||||
* @return `true` if `pCurrent` is linked in a list or queue; `false` otherwise.
|
||||
*/
|
||||
/* @[declare_linear_containers_link_islinked] */
|
||||
static inline bool IotLink_IsLinked( const IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_link_islinked] */
|
||||
{
|
||||
bool isLinked = false;
|
||||
|
||||
if( pLink != NULL )
|
||||
{
|
||||
isLinked = ( pLink->pNext != NULL ) && ( pLink->pPrevious != NULL );
|
||||
}
|
||||
|
||||
return isLinked;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Create a new doubly-linked list.
|
||||
*
|
||||
* This function initializes a new doubly-linked list. It must be called on an
|
||||
* uninitialized #IotListDouble_t before calling any other doubly-linked list
|
||||
* function. This function must not be called on an already-initialized
|
||||
* #IotListDouble_t.
|
||||
*
|
||||
* This function will not fail. The function @ref linear_containers_function_list_double_removeall
|
||||
* may be called to destroy a list.
|
||||
*
|
||||
* @param[in] pList Pointer to the memory that will hold the new doubly-linked list.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_create] */
|
||||
static inline void IotListDouble_Create( IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_create] */
|
||||
{
|
||||
/* This function must not be called with a NULL parameter. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
|
||||
/* An empty list is a link pointing to itself. */
|
||||
pList->pPrevious = pList;
|
||||
pList->pNext = pList;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return the number of elements contained in an #IotListDouble_t.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list with the elements to count.
|
||||
*
|
||||
* @return The number of elements in the doubly-linked list.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_count] */
|
||||
static inline size_t IotListDouble_Count( const IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_count] */
|
||||
{
|
||||
size_t count = 0;
|
||||
|
||||
if( pList != NULL )
|
||||
{
|
||||
/* Get the list head. */
|
||||
const IotLink_t * pCurrent = pList->pNext;
|
||||
|
||||
/* Iterate through the list to count the elements. */
|
||||
while( pCurrent != pList )
|
||||
{
|
||||
count++;
|
||||
pCurrent = pCurrent->pNext;
|
||||
}
|
||||
}
|
||||
|
||||
return count;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Check if a doubly-linked list is empty.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list to check.
|
||||
*
|
||||
* @return `true` if the list is empty; `false` otherwise.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_isempty] */
|
||||
static inline bool IotListDouble_IsEmpty( const IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_isempty] */
|
||||
{
|
||||
/* An empty list is NULL link, or a link pointing to itself. */
|
||||
return( ( pList == NULL ) || ( pList->pNext == pList ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return an #IotLink_t representing the first element in a doubly-linked list
|
||||
* without removing it.
|
||||
*
|
||||
* @param[in] pList The list to peek.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the element at the head of the
|
||||
* list; `NULL` if the list is empty. The macro #IotLink_Container may be used to
|
||||
* determine the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_peekhead] */
|
||||
static inline IotLink_t * IotListDouble_PeekHead( const IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_peekhead] */
|
||||
{
|
||||
IotLink_t * pHead = NULL;
|
||||
|
||||
if( pList != NULL )
|
||||
{
|
||||
if( IotListDouble_IsEmpty( pList ) == false )
|
||||
{
|
||||
pHead = pList->pNext;
|
||||
}
|
||||
}
|
||||
|
||||
return pHead;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return an #IotLink_t representing the last element in a doubly-linked
|
||||
* list without removing it.
|
||||
*
|
||||
* @param[in] pList The list to peek.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the element at the tail of the
|
||||
* list; `NULL` if the list is empty. The macro #IotLink_Container may be used to
|
||||
* determine the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_peektail] */
|
||||
static inline IotLink_t * IotListDouble_PeekTail( const IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_peektail] */
|
||||
{
|
||||
IotLink_t * pTail = NULL;
|
||||
|
||||
if( pList != NULL )
|
||||
{
|
||||
if( IotListDouble_IsEmpty( pList ) == false )
|
||||
{
|
||||
pTail = pList->pPrevious;
|
||||
}
|
||||
}
|
||||
|
||||
return pTail;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Insert an element at the head of a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list that will hold the new element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_inserthead] */
|
||||
static inline void IotListDouble_InsertHead( IotListDouble_t * const pList,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_list_double_inserthead] */
|
||||
{
|
||||
/* This function must not be called with NULL parameters. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
IotContainers_Assert( pLink != NULL );
|
||||
|
||||
/* Save current list head. */
|
||||
IotLink_t * pHead = pList->pNext;
|
||||
|
||||
/* Place new element before list head. */
|
||||
pLink->pNext = pHead;
|
||||
pLink->pPrevious = pList;
|
||||
|
||||
/* Assign new list head. */
|
||||
pHead->pPrevious = pLink;
|
||||
pList->pNext = pLink;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Insert an element at the tail of a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The double-linked list that will hold the new element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_inserttail] */
|
||||
static inline void IotListDouble_InsertTail( IotListDouble_t * const pList,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_list_double_inserttail] */
|
||||
{
|
||||
/* This function must not be called with NULL parameters. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
IotContainers_Assert( pLink != NULL );
|
||||
|
||||
/* Save current list tail. */
|
||||
IotLink_t * pTail = pList->pPrevious;
|
||||
|
||||
pLink->pNext = pList;
|
||||
pLink->pPrevious = pTail;
|
||||
|
||||
pList->pPrevious = pLink;
|
||||
pTail->pNext = pLink;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Insert an element before another element in a doubly-linked list.
|
||||
*
|
||||
* @param[in] pElement The new element will be placed before this element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_insertbefore] */
|
||||
static inline void IotListDouble_InsertBefore( IotLink_t * const pElement,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_list_double_insertbefore] */
|
||||
{
|
||||
IotListDouble_InsertTail( pElement, pLink );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Insert an element after another element in a doubly-linked list.
|
||||
*
|
||||
* @param[in] pElement The new element will be placed after this element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_insertafter] */
|
||||
static inline void IotListDouble_InsertAfter( IotLink_t * const pElement,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_list_double_insertafter] */
|
||||
{
|
||||
IotListDouble_InsertHead( pElement, pLink );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Insert an element in a sorted doubly-linked list.
|
||||
*
|
||||
* Places an element into a list by sorting it into order. The function
|
||||
* `compare` is used to determine where to place the new element.
|
||||
*
|
||||
* @param[in] pList The list that will hold the new element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
* @param[in] compare Determines the order of the list. Returns a negative
|
||||
* value if its first argument is less than its second argument; returns
|
||||
* zero if its first argument is equal to its second argument; returns a
|
||||
* positive value if its first argument is greater than its second argument.
|
||||
* The parameters to this function are #IotLink_t, so the macro #IotLink_Container
|
||||
* may be used to determine the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_insertsorted] */
|
||||
static inline void IotListDouble_InsertSorted( IotListDouble_t * const pList,
|
||||
IotLink_t * const pLink,
|
||||
int32_t ( *compare )( const IotLink_t * const, const IotLink_t * const ) )
|
||||
/* @[declare_linear_containers_list_double_insertsorted] */
|
||||
{
|
||||
/* This function must not be called with NULL parameters. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
IotContainers_Assert( pLink != NULL );
|
||||
IotContainers_Assert( compare != NULL );
|
||||
|
||||
/* Insert at head for empty list. */
|
||||
if( IotListDouble_IsEmpty( pList ) == true )
|
||||
{
|
||||
IotListDouble_InsertHead( pList, pLink );
|
||||
}
|
||||
else
|
||||
{
|
||||
bool inserted = false;
|
||||
IotLink_t * pCurrent = pList->pNext;
|
||||
|
||||
/* Iterate through the list to find the correct position. */
|
||||
while( pCurrent != pList )
|
||||
{
|
||||
/* Comparing for '<' preserves the order of insertion. */
|
||||
if( compare( pLink, pCurrent ) < 0 )
|
||||
{
|
||||
IotListDouble_InsertBefore( pCurrent, pLink );
|
||||
inserted = true;
|
||||
|
||||
break;
|
||||
}
|
||||
|
||||
pCurrent = pCurrent->pNext;
|
||||
}
|
||||
|
||||
/* New element is greater than all elements in list. Insert at tail. */
|
||||
if( inserted == false )
|
||||
{
|
||||
IotListDouble_InsertTail( pList, pLink );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove a single element from a doubly-linked list.
|
||||
*
|
||||
* @param[in] pLink The element to remove.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_remove] */
|
||||
static inline void IotListDouble_Remove( IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_list_double_remove] */
|
||||
{
|
||||
/* This function must not be called with a NULL parameter. */
|
||||
IotContainers_Assert( pLink != NULL );
|
||||
|
||||
/* This function must be called on a linked element. */
|
||||
IotContainers_Assert( IotLink_IsLinked( pLink ) == true );
|
||||
|
||||
pLink->pPrevious->pNext = pLink->pNext;
|
||||
pLink->pNext->pPrevious = pLink->pPrevious;
|
||||
pLink->pPrevious = NULL;
|
||||
pLink->pNext = NULL;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove the element at the head of a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list that holds the element to remove.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the removed list head; `NULL`
|
||||
* if the list is empty. The macro #IotLink_Container may be used to determine
|
||||
* the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_removehead] */
|
||||
static inline IotLink_t * IotListDouble_RemoveHead( IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_removehead] */
|
||||
{
|
||||
IotLink_t * pHead = NULL;
|
||||
|
||||
if( IotListDouble_IsEmpty( pList ) == false )
|
||||
{
|
||||
pHead = pList->pNext;
|
||||
IotListDouble_Remove( pHead );
|
||||
}
|
||||
|
||||
return pHead;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove the element at the tail of a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list that holds the element to remove.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the removed list tail; `NULL`
|
||||
* if the list is empty. The macro #IotLink_Container may be used to determine
|
||||
* the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_removetail] */
|
||||
static inline IotLink_t * IotListDouble_RemoveTail( IotListDouble_t * const pList )
|
||||
/* @[declare_linear_containers_list_double_removetail] */
|
||||
{
|
||||
IotLink_t * pTail = NULL;
|
||||
|
||||
if( IotListDouble_IsEmpty( pList ) == false )
|
||||
{
|
||||
pTail = pList->pPrevious;
|
||||
IotListDouble_Remove( pTail );
|
||||
}
|
||||
|
||||
return pTail;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove all elements in a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The list to empty.
|
||||
* @param[in] freeElement A function to free memory used by each removed list
|
||||
* element. Optional; pass `NULL` to ignore.
|
||||
* @param[in] linkOffset Offset in bytes of a link member in its container, used
|
||||
* to calculate the pointer to pass to `freeElement`. This value should be calculated
|
||||
* with the C `offsetof` macro. This parameter is ignored if `freeElement` is `NULL`
|
||||
* or its value is `0`.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_removeall] */
|
||||
static inline void IotListDouble_RemoveAll( IotListDouble_t * const pList,
|
||||
void ( *freeElement )( void * ),
|
||||
size_t linkOffset )
|
||||
/* @[declare_linear_containers_list_double_removeall] */
|
||||
{
|
||||
/* This function must not be called with a NULL pList parameter. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
|
||||
/* Get the list head. */
|
||||
IotLink_t * pCurrent = pList->pNext;
|
||||
|
||||
/* Iterate through the list and remove all elements. */
|
||||
while( pCurrent != pList )
|
||||
{
|
||||
/* Save a pointer to the next list element. */
|
||||
IotLink_t * pNext = pCurrent->pNext;
|
||||
|
||||
/* Remove and free the current list element. */
|
||||
IotListDouble_Remove( pCurrent );
|
||||
|
||||
if( freeElement != NULL )
|
||||
{
|
||||
freeElement( ( ( uint8_t * ) pCurrent ) - linkOffset );
|
||||
}
|
||||
|
||||
/* Move the iterating pointer to the next list element. */
|
||||
pCurrent = pNext;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Search a doubly-linked list for the first matching element.
|
||||
*
|
||||
* If a match is found, the matching element is <b>not</b> removed from the list.
|
||||
* See @ref linear_containers_function_list_double_removefirstmatch for the function
|
||||
* that searches and removes.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list to search.
|
||||
* @param[in] pStartPoint An element in `pList`. Only elements between this one and
|
||||
* the list tail are checked. Pass `NULL` to search from the beginning of the list.
|
||||
* @param[in] isMatch Function to determine if an element matches. Pass `NULL` to
|
||||
* search using the address `pMatch`, i.e. `element == pMatch`.
|
||||
* @param[in] pMatch If `isMatch` is `NULL`, each element in the list is compared
|
||||
* to this address to find a match. Otherwise, it is passed as the second argument
|
||||
* to `isMatch`.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the first matched element; `NULL`
|
||||
* if no match is found. The macro #IotLink_Container may be used to determine the
|
||||
* address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_findfirstmatch] */
|
||||
static inline IotLink_t * IotListDouble_FindFirstMatch( const IotListDouble_t * const pList,
|
||||
const IotLink_t * const pStartPoint,
|
||||
bool ( *isMatch )( const IotLink_t * const, void * ),
|
||||
void * pMatch )
|
||||
/* @[declare_linear_containers_list_double_findfirstmatch] */
|
||||
{
|
||||
/* The const must be cast away to match this function's return value. Nevertheless,
|
||||
* this function will respect the const-ness of pStartPoint. */
|
||||
IotLink_t * pCurrent = ( IotLink_t * ) pStartPoint;
|
||||
|
||||
/* This function must not be called with a NULL pList parameter. */
|
||||
IotContainers_Assert( pList != NULL );
|
||||
|
||||
/* Search starting from list head if no start point is given. */
|
||||
if( pStartPoint == NULL )
|
||||
{
|
||||
pCurrent = pList->pNext;
|
||||
}
|
||||
|
||||
/* Iterate through the list to search for matches. */
|
||||
while( pCurrent != pList )
|
||||
{
|
||||
/* Call isMatch if provided. Otherwise, compare pointers. */
|
||||
if( isMatch != NULL )
|
||||
{
|
||||
if( isMatch( pCurrent, pMatch ) == true )
|
||||
{
|
||||
return pCurrent;
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
if( pCurrent == pMatch )
|
||||
{
|
||||
return pCurrent;
|
||||
}
|
||||
}
|
||||
|
||||
pCurrent = pCurrent->pNext;
|
||||
}
|
||||
|
||||
/* No match found, return NULL. */
|
||||
return NULL;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Search a doubly-linked list for the first matching element and remove
|
||||
* it.
|
||||
*
|
||||
* An #IotLink_t may be passed as `pList` to start searching after the head of a
|
||||
* doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list to search.
|
||||
* @param[in] pStartPoint An element in `pList`. Only elements between this one and
|
||||
* the list tail are checked. Pass `NULL` to search from the beginning of the list.
|
||||
* @param[in] isMatch Function to determine if an element matches. Pass `NULL` to
|
||||
* search using the address `pMatch`, i.e. `element == pMatch`.
|
||||
* @param[in] pMatch If `isMatch` is `NULL`, each element in the list is compared
|
||||
* to this address to find a match. Otherwise, it is passed as the second argument
|
||||
* to `isMatch`.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the matched and removed element;
|
||||
* `NULL` if no match is found. The macro #IotLink_Container may be used to determine
|
||||
* the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_removefirstmatch] */
|
||||
static inline IotLink_t * IotListDouble_RemoveFirstMatch( IotListDouble_t * const pList,
|
||||
const IotLink_t * const pStartPoint,
|
||||
bool ( *isMatch )( const IotLink_t *, void * ),
|
||||
void * pMatch )
|
||||
/* @[declare_linear_containers_list_double_removefirstmatch] */
|
||||
{
|
||||
IotLink_t * pMatchedElement = IotListDouble_FindFirstMatch( pList,
|
||||
pStartPoint,
|
||||
isMatch,
|
||||
pMatch );
|
||||
|
||||
if( pMatchedElement != NULL )
|
||||
{
|
||||
IotListDouble_Remove( pMatchedElement );
|
||||
}
|
||||
|
||||
return pMatchedElement;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove all matching elements from a doubly-linked list.
|
||||
*
|
||||
* @param[in] pList The doubly-linked list to search.
|
||||
* @param[in] isMatch Function to determine if an element matches. Pass `NULL` to
|
||||
* search using the address `pMatch`, i.e. `element == pMatch`.
|
||||
* @param[in] pMatch If `isMatch` is `NULL`, each element in the list is compared
|
||||
* to this address to find a match. Otherwise, it is passed as the second argument
|
||||
* to `isMatch`.
|
||||
* @param[in] freeElement A function to free memory used by each removed list
|
||||
* element. Optional; pass `NULL` to ignore.
|
||||
* @param[in] linkOffset Offset in bytes of a link member in its container, used
|
||||
* to calculate the pointer to pass to `freeElement`. This value should be calculated
|
||||
* with the C `offsetof` macro. This parameter is ignored if `freeElement` is `NULL`
|
||||
* or its value is `0`.
|
||||
*/
|
||||
/* @[declare_linear_containers_list_double_removeallmatches] */
|
||||
static inline void IotListDouble_RemoveAllMatches( IotListDouble_t * const pList,
|
||||
bool ( *isMatch )( const IotLink_t *, void * ),
|
||||
void * pMatch,
|
||||
void ( *freeElement )( void * ),
|
||||
size_t linkOffset )
|
||||
/* @[declare_linear_containers_list_double_removeallmatches] */
|
||||
{
|
||||
IotLink_t * pMatchedElement = NULL, * pNextElement = NULL;
|
||||
|
||||
/* Search the list for all matching elements. */
|
||||
do
|
||||
{
|
||||
pMatchedElement = IotListDouble_FindFirstMatch( pList,
|
||||
pMatchedElement,
|
||||
isMatch,
|
||||
pMatch );
|
||||
|
||||
if( pMatchedElement != NULL )
|
||||
{
|
||||
/* Save pointer to next element. */
|
||||
pNextElement = pMatchedElement->pNext;
|
||||
|
||||
/* Match found; remove and free. */
|
||||
IotListDouble_Remove( pMatchedElement );
|
||||
|
||||
if( freeElement != NULL )
|
||||
{
|
||||
freeElement( ( ( uint8_t * ) pMatchedElement ) - linkOffset );
|
||||
}
|
||||
|
||||
/* Continue search from next element. */
|
||||
pMatchedElement = pNextElement;
|
||||
}
|
||||
} while( pMatchedElement != NULL );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Create a new queue.
|
||||
*
|
||||
* This function initializes a new double-ended queue. It must be called on an uninitialized
|
||||
* #IotDeQueue_t before calling any other queue function. This function must not be
|
||||
* called on an already-initialized #IotDeQueue_t.
|
||||
*
|
||||
* This function will not fail.
|
||||
*
|
||||
* @param[in] pQueue Pointer to the memory that will hold the new queue.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_create] */
|
||||
static inline void IotDeQueue_Create( IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_create] */
|
||||
{
|
||||
IotListDouble_Create( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return the number of elements contained in an #IotDeQueue_t.
|
||||
*
|
||||
* @param[in] pQueue The queue with the elements to count.
|
||||
*
|
||||
* @return The number of items elements in the queue.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_count] */
|
||||
static inline size_t IotDeQueue_Count( const IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_count] */
|
||||
{
|
||||
return IotListDouble_Count( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Check if a queue is empty.
|
||||
*
|
||||
* @param[in] pQueue The queue to check.
|
||||
*
|
||||
* @return `true` if the queue is empty; `false` otherwise.
|
||||
*
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_isempty] */
|
||||
static inline bool IotDeQueue_IsEmpty( const IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_isempty] */
|
||||
{
|
||||
return IotListDouble_IsEmpty( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return an #IotLink_t representing the element at the front of the queue
|
||||
* without removing it.
|
||||
*
|
||||
* @param[in] pQueue The queue to peek.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the element at the head of the
|
||||
* queue; `NULL` if the queue is empty. The macro #IotLink_Container may be used
|
||||
* to determine the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_peekhead] */
|
||||
static inline IotLink_t * IotDeQueue_PeekHead( const IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_peekhead] */
|
||||
{
|
||||
return IotListDouble_PeekHead( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Return an #IotLink_t representing the element at the back of the queue
|
||||
* without removing it.
|
||||
*
|
||||
* @param[in] pQueue The queue to peek.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the element at the head of the
|
||||
* queue; `NULL` if the queue is empty. The macro #IotLink_Container may be used
|
||||
* to determine the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_peektail] */
|
||||
static inline IotLink_t * IotDeQueue_PeekTail( const IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_peektail] */
|
||||
{
|
||||
return IotListDouble_PeekTail( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Add an element at the head of the queue.
|
||||
*
|
||||
* @param[in] pQueue The queue that will hold the new element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_enqueuehead] */
|
||||
static inline void IotDeQueue_EnqueueHead( IotDeQueue_t * const pQueue,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_queue_enqueuehead] */
|
||||
{
|
||||
IotListDouble_InsertHead( pQueue, pLink );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove an element at the head of the queue.
|
||||
*
|
||||
* @param[in] pQueue The queue that holds the element to remove.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the removed queue element; `NULL`
|
||||
* if the queue is empty. The macro #IotLink_Container may be used to determine
|
||||
* the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_dequeuehead] */
|
||||
static inline IotLink_t * IotDeQueue_DequeueHead( IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_dequeuehead] */
|
||||
{
|
||||
return IotListDouble_RemoveHead( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Add an element at the tail of the queue.
|
||||
*
|
||||
* @param[in] pQueue The queue that will hold the new element.
|
||||
* @param[in] pLink Pointer to the new element's link member.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_enqueuetail] */
|
||||
static inline void IotDeQueue_EnqueueTail( IotDeQueue_t * const pQueue,
|
||||
IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_queue_enqueuetail] */
|
||||
{
|
||||
IotListDouble_InsertTail( pQueue, pLink );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove an element at the tail of the queue.
|
||||
*
|
||||
* @param[in] pQueue The queue that holds the element to remove.
|
||||
*
|
||||
* @return Pointer to an #IotLink_t representing the removed queue element; `NULL`
|
||||
* if the queue is empty. The macro #IotLink_Container may be used to determine
|
||||
* the address of the link's container.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_dequeuetail] */
|
||||
static inline IotLink_t * IotDeQueue_DequeueTail( IotDeQueue_t * const pQueue )
|
||||
/* @[declare_linear_containers_queue_dequeuetail] */
|
||||
{
|
||||
return IotListDouble_RemoveTail( pQueue );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove a single element from a queue.
|
||||
*
|
||||
* @param[in] pLink The element to remove.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_remove] */
|
||||
static inline void IotDeQueue_Remove( IotLink_t * const pLink )
|
||||
/* @[declare_linear_containers_queue_remove] */
|
||||
{
|
||||
IotListDouble_Remove( pLink );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove all elements in a queue.
|
||||
*
|
||||
* @param[in] pQueue The queue to empty.
|
||||
* @param[in] freeElement A function to free memory used by each removed queue
|
||||
* element. Optional; pass `NULL` to ignore.
|
||||
* @param[in] linkOffset Offset in bytes of a link member in its container, used
|
||||
* to calculate the pointer to pass to `freeElement`. This value should be calculated
|
||||
* with the C `offsetof` macro. This parameter is ignored if `freeElement` is `NULL`
|
||||
* or its value is `0`.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_removeall] */
|
||||
static inline void IotDeQueue_RemoveAll( IotDeQueue_t * const pQueue,
|
||||
void ( * freeElement )( void * ),
|
||||
size_t linkOffset )
|
||||
/* @[declare_linear_containers_queue_removeall] */
|
||||
{
|
||||
IotListDouble_RemoveAll( pQueue, freeElement, linkOffset );
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Remove all matching elements from a queue.
|
||||
*
|
||||
* @param[in] pQueue The queue to search.
|
||||
* @param[in] isMatch Function to determine if an element matches. Pass `NULL` to
|
||||
* search using the address `pMatch`, i.e. `element == pMatch`.
|
||||
* @param[in] pMatch If `isMatch` is `NULL`, each element in the queue is compared
|
||||
* to this address to find a match. Otherwise, it is passed as the second argument
|
||||
* to `isMatch`.
|
||||
* @param[in] freeElement A function to free memory used by each removed queue
|
||||
* element. Optional; pass `NULL` to ignore.
|
||||
* @param[in] linkOffset Offset in bytes of a link member in its container, used
|
||||
* to calculate the pointer to pass to `freeElement`. This value should be calculated
|
||||
* with the C `offsetof` macro. This parameter is ignored if `freeElement` is `NULL`
|
||||
* or its value is `0`.
|
||||
*/
|
||||
/* @[declare_linear_containers_queue_removeallmatches] */
|
||||
static inline void IotDeQueue_RemoveAllMatches( IotDeQueue_t * const pQueue,
|
||||
bool ( * isMatch )( const IotLink_t *, void * ),
|
||||
void * pMatch,
|
||||
void ( * freeElement )( void * ),
|
||||
size_t linkOffset )
|
||||
/* @[declare_linear_containers_queue_removeallmatches] */
|
||||
{
|
||||
IotListDouble_RemoveAllMatches( pQueue, isMatch, pMatch, freeElement, linkOffset );
|
||||
}
|
||||
|
||||
#endif /* IOT_LINEAR_CONTAINERS_H_ */
|
||||
|
|
@ -0,0 +1,223 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_logging_setup.h
|
||||
* @brief Defines the logging macro #IotLog.
|
||||
*/
|
||||
|
||||
#ifndef IOT_LOGGING_SETUP_H_
|
||||
#define IOT_LOGGING_SETUP_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Logging include. Because it's included here, iot_logging.h never needs
|
||||
* to be included in source. */
|
||||
#include "private/iot_logging.h"
|
||||
|
||||
/**
|
||||
* @functionpage{IotLog,logging,log}
|
||||
* @functionpage{IotLog_PrintBuffer,logging,printbuffer}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLog( messageLevel, pLogConfig, ... )
|
||||
* @brief Logging function for a specific library. In most cases, this is the
|
||||
* logging function to call.
|
||||
*
|
||||
* This function prints a single log message. It is available when @ref
|
||||
* LIBRARY_LOG_LEVEL is not #IOT_LOG_NONE. Log messages automatically
|
||||
* include the [log level](@ref logging_constants_levels), [library name]
|
||||
* (@ref LIBRARY_LOG_NAME), and time. An optional @ref IotLogConfig_t may
|
||||
* be passed to this function to hide information for a single log message.
|
||||
*
|
||||
* The logging library must be set up before this function may be called. See
|
||||
* @ref logging_setup_use for more information.
|
||||
*
|
||||
* This logging function also has the following abbreviated forms that can be used
|
||||
* when an #IotLogConfig_t isn't needed.
|
||||
*
|
||||
* Name | Equivalent to
|
||||
* ---- | -------------
|
||||
* #IotLogError | @code{c} IotLog( IOT_LOG_ERROR, NULL, ... ) @endcode
|
||||
* #IotLogWarn | @code{c} IotLog( IOT_LOG_WARN, NULL, ... ) @endcode
|
||||
* #IotLogInfo | @code{c} IotLog( IOT_LOG_INFO, NULL, ... ) @endcode
|
||||
* #IotLogDebug | @code{c} IotLog( IOT_LOG_DEBUG, NULL, ... ) @endcode
|
||||
*
|
||||
* @param[in] messageLevel Log level of this message. Must be one of the
|
||||
* @ref logging_constants_levels.
|
||||
* @param[in] pLogConfig Pointer to an #IotLogConfig_t. Optional; pass `NULL`
|
||||
* to ignore.
|
||||
* @param[in] ... Message and format specification.
|
||||
*
|
||||
* @return No return value. On errors, it prints nothing.
|
||||
*
|
||||
* @note This function may be implemented as a macro.
|
||||
* @see @ref logging_function_generic for the generic (not library-specific)
|
||||
* logging function.
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLog_PrintBuffer( pHeader, pBuffer, bufferSize )
|
||||
* @brief Log the contents of buffer as bytes. Only available when @ref
|
||||
* LIBRARY_LOG_LEVEL is #IOT_LOG_DEBUG.
|
||||
*
|
||||
* This function prints the bytes located at a given memory address. It is
|
||||
* intended for debugging only, and is therefore only available when @ref
|
||||
* LIBRARY_LOG_LEVEL is #IOT_LOG_DEBUG.
|
||||
*
|
||||
* Log messages printed by this function <b>always</b> include the [log level]
|
||||
* (@ref logging_constants_levels), [library name](@ref LIBRARY_LOG_NAME),
|
||||
* and time. In addition, this function may print an optional header `pHeader`
|
||||
* before it prints the contents of the buffer. This function does not have an
|
||||
* #IotLogConfig_t parameter.
|
||||
*
|
||||
* The logging library must be set up before this function may be called. See
|
||||
* @ref logging_setup_use for more information.
|
||||
*
|
||||
* @param[in] pHeader A message to log before the buffer. Optional; pass `NULL`
|
||||
* to ignore.
|
||||
* @param[in] pBuffer Pointer to start of buffer.
|
||||
* @param[in] bufferSize Size of `pBuffer`.
|
||||
*
|
||||
* @return No return value. On errors, it prints nothing.
|
||||
*
|
||||
* @note This function may be implemented as a macro.
|
||||
* @note To conserve memory, @ref logging_function_genericprintbuffer (the underlying
|
||||
* implementation) only allocates enough memory for a single line of output. Therefore,
|
||||
* in multithreaded systems, its output may appear "fragmented" if other threads are
|
||||
* logging simultaneously.
|
||||
* @see @ref logging_function_genericprintbuffer for the generic (not library-specific)
|
||||
* buffer logging function.
|
||||
*
|
||||
* <b>Example</b>
|
||||
* @code{c}
|
||||
* const uint8_t pBuffer[] = { 0x00, 0x01, 0x02, 0x03 };
|
||||
*
|
||||
* IotLog_PrintBuffer( "This buffer contains:",
|
||||
* pBuffer,
|
||||
* 4 );
|
||||
* @endcode
|
||||
* The code above prints something like the following:
|
||||
* @code{c}
|
||||
* [DEBUG][LIB_NAME][2018-01-01 12:00:00] This buffer contains:
|
||||
* 00 01 02 03
|
||||
* @endcode
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLogError( ... )
|
||||
* @brief Abbreviated logging macro for level #IOT_LOG_ERROR.
|
||||
*
|
||||
* Equivalent to:
|
||||
* @code{c}
|
||||
* IotLog( IOT_LOG_ERROR, NULL, ... )
|
||||
* @endcode
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLogWarn( ... )
|
||||
* @brief Abbreviated logging macro for level #IOT_LOG_WARN.
|
||||
*
|
||||
* Equivalent to:
|
||||
* @code{c}
|
||||
* IotLog( IOT_LOG_WARN, NULL, ... )
|
||||
* @endcode
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLogInfo( ... )
|
||||
* @brief Abbreviated logging macro for level #IOT_LOG_INFO.
|
||||
*
|
||||
* Equivalent to:
|
||||
* @code{c}
|
||||
* IotLog( IOT_LOG_INFO, NULL, ... )
|
||||
* @endcode
|
||||
*/
|
||||
|
||||
/**
|
||||
* @def IotLogDebug( ... )
|
||||
* @brief Abbreviated logging macro for level #IOT_LOG_DEBUG.
|
||||
*
|
||||
* Equivalent to:
|
||||
* @code{c}
|
||||
* IotLog( IOT_LOG_DEBUG, NULL, ... )
|
||||
* @endcode
|
||||
*/
|
||||
|
||||
/* Check that LIBRARY_LOG_LEVEL is defined and has a valid value. */
|
||||
#if !defined( LIBRARY_LOG_LEVEL ) || \
|
||||
( LIBRARY_LOG_LEVEL != IOT_LOG_NONE && \
|
||||
LIBRARY_LOG_LEVEL != IOT_LOG_ERROR && \
|
||||
LIBRARY_LOG_LEVEL != IOT_LOG_WARN && \
|
||||
LIBRARY_LOG_LEVEL != IOT_LOG_INFO && \
|
||||
LIBRARY_LOG_LEVEL != IOT_LOG_DEBUG )
|
||||
#error "Please define LIBRARY_LOG_LEVEL as either IOT_LOG_NONE, IOT_LOG_ERROR, IOT_LOG_WARN, IOT_LOG_INFO, or IOT_LOG_DEBUG."
|
||||
/* Check that LIBRARY_LOG_NAME is defined and has a valid value. */
|
||||
#elif !defined( LIBRARY_LOG_NAME )
|
||||
#error "Please define LIBRARY_LOG_NAME."
|
||||
#else
|
||||
/* Define IotLog if the log level is greater than "none". */
|
||||
#if LIBRARY_LOG_LEVEL > IOT_LOG_NONE
|
||||
#define IotLog( messageLevel, pLogConfig, ... ) \
|
||||
IotLog_Generic( LIBRARY_LOG_LEVEL, \
|
||||
LIBRARY_LOG_NAME, \
|
||||
messageLevel, \
|
||||
pLogConfig, \
|
||||
__VA_ARGS__ )
|
||||
|
||||
/* Define the abbreviated logging macros. */
|
||||
#define IotLogError( ... ) IotLog( IOT_LOG_ERROR, NULL, __VA_ARGS__ )
|
||||
#define IotLogWarn( ... ) IotLog( IOT_LOG_WARN, NULL, __VA_ARGS__ )
|
||||
#define IotLogInfo( ... ) IotLog( IOT_LOG_INFO, NULL, __VA_ARGS__ )
|
||||
#define IotLogDebug( ... ) IotLog( IOT_LOG_DEBUG, NULL, __VA_ARGS__ )
|
||||
|
||||
/* If log level is DEBUG, enable the function to print buffers. */
|
||||
#if LIBRARY_LOG_LEVEL >= IOT_LOG_DEBUG
|
||||
#define IotLog_PrintBuffer( pHeader, pBuffer, bufferSize ) \
|
||||
IotLog_GenericPrintBuffer( LIBRARY_LOG_NAME, \
|
||||
pHeader, \
|
||||
pBuffer, \
|
||||
bufferSize )
|
||||
#else
|
||||
#define IotLog_PrintBuffer( pHeader, pBuffer, bufferSize )
|
||||
#endif
|
||||
/* Remove references to IotLog from the source code if logging is disabled. */
|
||||
#else
|
||||
/* @[declare_logging_log] */
|
||||
#define IotLog( messageLevel, pLogConfig, ... )
|
||||
/* @[declare_logging_log] */
|
||||
/* @[declare_logging_printbuffer] */
|
||||
#define IotLog_PrintBuffer( pHeader, pBuffer, bufferSize )
|
||||
/* @[declare_logging_printbuffer] */
|
||||
#define IotLogError( ... )
|
||||
#define IotLogWarn( ... )
|
||||
#define IotLogInfo( ... )
|
||||
#define IotLogDebug( ... )
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#endif /* ifndef IOT_LOGGING_SETUP_H_ */
|
||||
|
|
@ -0,0 +1,558 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_taskpool.h
|
||||
* @brief User-facing functions of the task pool library.
|
||||
*/
|
||||
|
||||
#ifndef IOT_TASKPOOL_H_
|
||||
#define IOT_TASKPOOL_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stdint.h>
|
||||
#include <stddef.h>
|
||||
|
||||
/* Task pool types. */
|
||||
#include "types/iot_taskpool_types.h"
|
||||
|
||||
/*------------------------- Task Pool library functions --------------------------*/
|
||||
|
||||
/**
|
||||
* @functionspage{taskpool,task pool library}
|
||||
* - @functionname{taskpool_function_createsystemtaskpool}
|
||||
* - @functionname{taskpool_function_getsystemtaskpool}
|
||||
* - @functionname{taskpool_function_create}
|
||||
* - @functionname{taskpool_function_destroy}
|
||||
* - @functionname{taskpool_function_setmaxthreads}
|
||||
* - @functionname{taskpool_function_createjob}
|
||||
* - @functionname{taskpool_function_createrecyclablejob}
|
||||
* - @functionname{taskpool_function_destroyrecyclablejob}
|
||||
* - @functionname{taskpool_function_recyclejob}
|
||||
* - @functionname{taskpool_function_schedule}
|
||||
* - @functionname{taskpool_function_scheduledeferred}
|
||||
* - @functionname{taskpool_function_getstatus}
|
||||
* - @functionname{taskpool_function_trycancel}
|
||||
* - @functionname{taskpool_function_getjobstoragefromhandle}
|
||||
* - @functionname{taskpool_function_strerror}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @functionpage{IotTaskPool_CreateSystemTaskPool,taskpool,createsystemtaskpool}
|
||||
* @functionpage{IotTaskPool_GetSystemTaskPool,taskpool,getsystemtaskpool}
|
||||
* @functionpage{IotTaskPool_Create,taskpool,create}
|
||||
* @functionpage{IotTaskPool_Destroy,taskpool,destroy}
|
||||
* @functionpage{IotTaskPool_SetMaxThreads,taskpool,setmaxthreads}
|
||||
* @functionpage{IotTaskPool_CreateJob,taskpool,createjob}
|
||||
* @functionpage{IotTaskPool_CreateRecyclableJob,taskpool,createrecyclablejob}
|
||||
* @functionpage{IotTaskPool_DestroyRecyclableJob,taskpool,destroyrecyclablejob}
|
||||
* @functionpage{IotTaskPool_RecycleJob,taskpool,recyclejob}
|
||||
* @functionpage{IotTaskPool_Schedule,taskpool,schedule}
|
||||
* @functionpage{IotTaskPool_ScheduleDeferred,taskpool,scheduledeferred}
|
||||
* @functionpage{IotTaskPool_GetStatus,taskpool,getstatus}
|
||||
* @functionpage{IotTaskPool_TryCancel,taskpool,trycancel}
|
||||
* @functionpage{IotTaskPool_GetJobStorageFromHandle,taskpool,getjobstoragefromhandle}
|
||||
* @functionpage{IotTaskPool_strerror,taskpool,strerror}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Creates the one single instance of the system task pool.
|
||||
*
|
||||
* This function should be called once by the application to initialize the one single instance of the system task pool.
|
||||
* An application should initialize the system task pool early in the boot sequence, before initializing any other library
|
||||
* and before posting any jobs. Early initialization it typically easy to accomplish by creating the system task pool
|
||||
* before starting the scheduler.
|
||||
*
|
||||
* This function does not allocate memory to hold the task pool data structures and state, but it
|
||||
* may allocate memory to hold the dependent entities and data structures, e.g. the threads of the task
|
||||
* pool. The system task pool handle is recoverable for later use by calling @ref IotTaskPool_GetSystemTaskPool or
|
||||
* the shortcut @ref IOT_SYSTEM_TASKPOOL.
|
||||
*
|
||||
* @param[in] pInfo A pointer to the task pool initialization data.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_NO_MEMORY
|
||||
*
|
||||
* @warning This function should be called only once. Calling this function more that once will result in
|
||||
* undefined behavior.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_createsystemtaskpool] */
|
||||
IotTaskPoolError_t IotTaskPool_CreateSystemTaskPool( const IotTaskPoolInfo_t * const pInfo );
|
||||
/* @[declare_taskpool_createsystemtaskpool] */
|
||||
|
||||
/**
|
||||
* @brief Retrieves the one and only instance of a system task pool
|
||||
*
|
||||
* This function retrieves the system task pool created with @ref IotTaskPool_CreateSystemTaskPool, and it is functionally
|
||||
* equivalent to using the shortcut @ref IOT_SYSTEM_TASKPOOL.
|
||||
*
|
||||
* @return The system task pool handle.
|
||||
*
|
||||
* @warning This function should be called after creating the system task pool with @ref IotTaskPool_CreateSystemTaskPool.
|
||||
* Calling this function before creating the system task pool may return a pointer to an uninitialized task pool, NULL, or otherwise
|
||||
* fail with undefined behaviour.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_getsystemtaskpool] */
|
||||
IotTaskPool_t IotTaskPool_GetSystemTaskPool( void );
|
||||
/* @[declare_taskpool_getsystemtaskpool] */
|
||||
|
||||
/**
|
||||
* @brief Creates one instance of a task pool.
|
||||
*
|
||||
* This function should be called by the user to initialize one instance of a task
|
||||
* pool. The task pool instance will be created around the storage pointed to by the `pTaskPool`
|
||||
* parameter. This function will create the minimum number of threads requested by the user
|
||||
* through an instance of the #IotTaskPoolInfo_t type specified with the `pInfo` parameter.
|
||||
* This function does not allocate memory to hold the task pool data structures and state, but it
|
||||
* may allocates memory to hold the dependent data structures, e.g. the threads of the task
|
||||
* pool.
|
||||
*
|
||||
* @param[in] pInfo A pointer to the task pool initialization data.
|
||||
* @param[out] pTaskPool A pointer to the task pool handle to be used after initialization.
|
||||
* The pointer `pTaskPool` will hold a valid handle only if (@ref IotTaskPool_Create)
|
||||
* completes successfully.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_NO_MEMORY
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_create] */
|
||||
IotTaskPoolError_t IotTaskPool_Create( const IotTaskPoolInfo_t * const pInfo,
|
||||
IotTaskPool_t * const pTaskPool );
|
||||
/* @[declare_taskpool_create] */
|
||||
|
||||
/**
|
||||
* @brief Destroys a task pool instance and collects all memory associated with a task pool and its
|
||||
* satellite data structures.
|
||||
*
|
||||
* This function should be called to destroy one instance of a task pool previously created with a call
|
||||
* to @ref IotTaskPool_Create or @ref IotTaskPool_CreateSystemTaskPool.
|
||||
* Calling this fuction release all underlying resources. After calling this function, any job scheduled but not yet executed
|
||||
* will be canceled and destroyed.
|
||||
* The `taskPool` instance will no longer be valid after this function returns.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool, e.g. as returned by a call to @ref IotTaskPool_Create or
|
||||
* @ref IotTaskPool_CreateSystemTaskPool. The `taskPool` instance will no longer be valid after this function returns.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_destroy] */
|
||||
IotTaskPoolError_t IotTaskPool_Destroy( IotTaskPool_t taskPool );
|
||||
/* @[declare_taskpool_destroy] */
|
||||
|
||||
/**
|
||||
* @brief Sets the maximum number of threads for one instance of a task pool.
|
||||
*
|
||||
* This function sets the maximum number of threads for the task pool
|
||||
* pointed to by `taskPool`.
|
||||
*
|
||||
* If the number of currently active threads in the task pool is greater than `maxThreads`, this
|
||||
* function causes the task pool to shrink the number of active threads.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool that must have been previously initialized with
|
||||
* a call to @ref IotTaskPool_Create or @ref IotTaskPool_CreateSystemTaskPool.
|
||||
* @param[in] maxThreads The maximum number of threads for the task pool.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_setmaxthreads] */
|
||||
IotTaskPoolError_t IotTaskPool_SetMaxThreads( IotTaskPool_t taskPool,
|
||||
uint32_t maxThreads );
|
||||
/* @[declare_taskpool_setmaxthreads] */
|
||||
|
||||
/**
|
||||
* @brief Creates a job for the task pool around a user-provided storage.
|
||||
*
|
||||
* This function may allocate memory to hold the state for a job.
|
||||
*
|
||||
* @param[in] userCallback A user-specified callback for the job.
|
||||
* @param[in] pUserContext A user-specified context for the callback.
|
||||
* @param[in] pJobStorage The storage for the job data structure.
|
||||
* @param[out] pJob A pointer to an instance of @ref IotTaskPoolJob_t that will be initialized when this
|
||||
* function returns successfully. This handle can be used to inspect the job status with
|
||||
* @ref IotTaskPool_GetStatus or cancel the job with @ref IotTaskPool_TryCancel, etc....
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
*
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_createjob] */
|
||||
IotTaskPoolError_t IotTaskPool_CreateJob( IotTaskPoolRoutine_t userCallback,
|
||||
void * pUserContext,
|
||||
IotTaskPoolJobStorage_t * const pJobStorage,
|
||||
IotTaskPoolJob_t * const pJob );
|
||||
/* @[declare_taskpool_createjob] */
|
||||
|
||||
/**
|
||||
* brief Creates a job for the task pool by allocating the job dynamically.
|
||||
*
|
||||
* A recyclable job does not need to be allocated twice, but it can rather be reused through
|
||||
* subsequent calls to @ref IotTaskPool_CreateRecyclableJob.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool for which to create a recyclable job.
|
||||
* @param[in] userCallback A user-specified callback for the job.
|
||||
* @param[in] pUserContext A user-specified context for the callback.
|
||||
* @param[out] pJob A pointer to an instance of @ref IotTaskPoolJob_t that will be initialized when this
|
||||
* function returns successfully. This handle can be used to inspect the job status with
|
||||
* @ref IotTaskPool_GetStatus or cancel the job with @ref IotTaskPool_TryCancel, etc....
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_NO_MEMORY
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
* @note This function will not allocate memory. //_RB_ Incorrect comment.
|
||||
*
|
||||
* @warning A recyclable job should be recycled with a call to @ref IotTaskPool_RecycleJob rather than destroyed.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_createrecyclablejob] */
|
||||
IotTaskPoolError_t IotTaskPool_CreateRecyclableJob( IotTaskPool_t taskPool,
|
||||
IotTaskPoolRoutine_t userCallback,
|
||||
void * pUserContext,
|
||||
IotTaskPoolJob_t * const pJob );
|
||||
/* @[declare_taskpool_createrecyclablejob] */
|
||||
|
||||
/**
|
||||
* @brief This function un-initializes a job.
|
||||
*
|
||||
* This function will destroy a job created with @ref IotTaskPool_CreateRecyclableJob.
|
||||
* A job should not be destroyed twice. A job that was previously scheduled but has not completed yet should not be destroyed,
|
||||
* but rather the application should attempt to cancel it first by calling @ref IotTaskPool_TryCancel.
|
||||
* An attempt to destroy a job that was scheduled but not yet executed or canceled, may result in a
|
||||
* @ref IOT_TASKPOOL_ILLEGAL_OPERATION error.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool, e.g. as returned by a call to @ref IotTaskPool_Create or @ref IotTaskPool_CreateSystemTaskPool.
|
||||
* @param[in] job A handle to a job that was create with a call to @ref IotTaskPool_CreateJob.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_ILLEGAL_OPERATION
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
* @warning The task pool will try and prevent destroying jobs that are currently queued for execution, but does
|
||||
* not enforce strict ordering of operations. It is up to the user to make sure @ref IotTaskPool_DestroyRecyclableJob is not called
|
||||
* our of order.
|
||||
*
|
||||
* @warning Calling this function on job that was not previously created with @ref IotTaskPool_CreateRecyclableJob
|
||||
* will result in a @ref IOT_TASKPOOL_ILLEGAL_OPERATION error.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_destroyrecyclablejob] */
|
||||
IotTaskPoolError_t IotTaskPool_DestroyRecyclableJob( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job );
|
||||
/* @[declare_taskpool_destroyrecyclablejob] */
|
||||
|
||||
/**
|
||||
* @brief Recycles a job into the task pool job cache.
|
||||
*
|
||||
* This function will try and recycle the job into the task pool cache. If the cache is full,
|
||||
* the job memory is destroyed as if the user called @ref IotTaskPool_DestroyRecyclableJob. The job should be recycled into
|
||||
* the task pool instance from where it was allocated.
|
||||
* Failure to do so will yield undefined results. A job should not be recycled twice. A job
|
||||
* that was previously scheduled but not completed or canceled cannot be safely recycled. An attempt to do so will result
|
||||
* in an @ref IOT_TASKPOOL_ILLEGAL_OPERATION error.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool, e.g. as returned by a call to @ref IotTaskPool_Create.
|
||||
* @param[out] job A pointer to a job that was create with a call to @ref IotTaskPool_CreateJob.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_ILLEGAL_OPERATION
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
* @warning The `taskPool` used in this function should be the same
|
||||
* used to create the job pointed to by `job`, or the results will be undefined.
|
||||
*
|
||||
* @warning Attempting to call this function on a statically allocated job will result in @ref IOT_TASKPOOL_ILLEGAL_OPERATION
|
||||
* error.
|
||||
*
|
||||
* @warning This function should be used to recycle a job in the task pool cache when after the job executed.
|
||||
* Failing to call either this function or @ref IotTaskPool_DestroyRecyclableJob will result is a memory leak. Statically
|
||||
* allocated jobs do not need to be recycled or destroyed.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_recyclejob] */
|
||||
IotTaskPoolError_t IotTaskPool_RecycleJob( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job );
|
||||
/* @[declare_taskpool_recyclejob] */
|
||||
|
||||
/**
|
||||
* @brief This function schedules a job created with @ref IotTaskPool_CreateJob or @ref IotTaskPool_CreateRecyclableJob
|
||||
* against the task pool pointed to by `taskPool`.
|
||||
*
|
||||
* See @ref taskpool_design for a description of the jobs lifetime and interaction with the threads used in the task pool
|
||||
* library.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool that must have been previously initialized with.
|
||||
* a call to @ref IotTaskPool_Create.
|
||||
* @param[in] job A job to schedule for execution. This must be first initialized with a call to @ref IotTaskPool_CreateJob.
|
||||
* @param[in] flags Flags to be passed by the user, e.g. to identify the job as high priority by specifying #IOT_TASKPOOL_JOB_HIGH_PRIORITY.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_ILLEGAL_OPERATION
|
||||
* - #IOT_TASKPOOL_NO_MEMORY
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
*
|
||||
* @note This function will not allocate memory, so it is guaranteed to succeed if the paramters are correct and the task pool
|
||||
* was correctly initialized, and not yet destroyed.
|
||||
*
|
||||
* @warning The `taskPool` used in this function should be the same used to create the job pointed to by `job`, or the
|
||||
* results will be undefined.
|
||||
*
|
||||
* <b>Example</b>
|
||||
* @code{c}
|
||||
* // An example of a user context to pass to a callback through a task pool thread.
|
||||
* typedef struct JobUserContext
|
||||
* {
|
||||
* uint32_t counter;
|
||||
* } JobUserContext_t;
|
||||
*
|
||||
* // An example of a user callback to invoke through a task pool thread.
|
||||
* static void ExecutionCb( IotTaskPool_t taskPool, IotTaskPoolJob_t job, void * context )
|
||||
* {
|
||||
* ( void )taskPool;
|
||||
* ( void )job;
|
||||
*
|
||||
* JobUserContext_t * pUserContext = ( JobUserContext_t * )context;
|
||||
*
|
||||
* pUserContext->counter++;
|
||||
* }
|
||||
*
|
||||
* void TaskPoolExample( )
|
||||
* {
|
||||
* JobUserContext_t userContext = { 0 };
|
||||
* IotTaskPoolJob_t job;
|
||||
* IotTaskPool_t taskPool;
|
||||
*
|
||||
* // Configure the task pool to hold at least two threads and three at the maximum.
|
||||
* // Provide proper stack size and priority per the application needs.
|
||||
*
|
||||
* const IotTaskPoolInfo_t tpInfo = { .minThreads = 2, .maxThreads = 3, .stackSize = 512, .priority = 0 };
|
||||
*
|
||||
* // Create a task pool.
|
||||
* IotTaskPool_Create( &tpInfo, &taskPool );
|
||||
*
|
||||
* // Statically allocate one job, schedule it.
|
||||
* IotTaskPool_CreateJob( &ExecutionCb, &userContext, &job );
|
||||
*
|
||||
* IotTaskPoolError_t errorSchedule = IotTaskPool_Schedule( taskPool, &job, 0 );
|
||||
*
|
||||
* switch ( errorSchedule )
|
||||
* {
|
||||
* case IOT_TASKPOOL_SUCCESS:
|
||||
* break;
|
||||
* case IOT_TASKPOOL_BAD_PARAMETER: // Invalid parameters, such as a NULL handle, can trigger this error.
|
||||
* case IOT_TASKPOOL_ILLEGAL_OPERATION: // Scheduling a job that was previously scheduled or destroyed could trigger this error.
|
||||
* case IOT_TASKPOOL_NO_MEMORY: // Scheduling a with flag #IOT_TASKPOOL_JOB_HIGH_PRIORITY could trigger this error.
|
||||
* case IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS: // Scheduling a job after trying to destroy the task pool could trigger this error.
|
||||
* // ASSERT
|
||||
* break;
|
||||
* default:
|
||||
* // ASSERT
|
||||
* }
|
||||
*
|
||||
* //
|
||||
* // ... Perform other operations ...
|
||||
* //
|
||||
*
|
||||
* IotTaskPool_Destroy( taskPool );
|
||||
* }
|
||||
* @endcode
|
||||
*/
|
||||
/* @[declare_taskpool_schedule] */
|
||||
IotTaskPoolError_t IotTaskPool_Schedule( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job,
|
||||
uint32_t flags );
|
||||
/* @[declare_taskpool_schedule] */
|
||||
|
||||
/**
|
||||
* @brief This function schedules a job created with @ref IotTaskPool_CreateJob against the task pool
|
||||
* pointed to by `taskPool` to be executed after a user-defined time interval.
|
||||
*
|
||||
* See @ref taskpool_design for a description of the jobs lifetime and interaction with the threads used in the task pool
|
||||
* library.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool that must have been previously initialized with.
|
||||
* a call to @ref IotTaskPool_Create.
|
||||
* @param[in] job A job to schedule for execution. This must be first initialized with a call to @ref IotTaskPool_CreateJob.
|
||||
* @param[in] timeMs The time in milliseconds to wait before scheduling the job.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_ILLEGAL_OPERATION
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
*
|
||||
* @note This function will not allocate memory.
|
||||
*
|
||||
* @warning The `taskPool` used in this function should be the same
|
||||
* used to create the job pointed to by `job`, or the results will be undefined.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_scheduledeferred] */
|
||||
IotTaskPoolError_t IotTaskPool_ScheduleDeferred( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job,
|
||||
uint32_t timeMs );
|
||||
/* @[declare_taskpool_scheduledeferred] */
|
||||
|
||||
/**
|
||||
* @brief This function retrieves the current status of a job.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool that must have been previously initialized with
|
||||
* a call to @ref IotTaskPool_Create or @ref IotTaskPool_CreateSystemTaskPool.
|
||||
* @param[in] job The job to cancel.
|
||||
* @param[out] pStatus The status of the job at the time of cancellation.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
*
|
||||
* @warning This function is not thread safe and the job status returned in `pStatus` may be invalid by the time
|
||||
* the calling thread has a chance to inspect it.
|
||||
*/
|
||||
/* @[declare_taskpool_getstatus] */
|
||||
IotTaskPoolError_t IotTaskPool_GetStatus( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job,
|
||||
IotTaskPoolJobStatus_t * const pStatus );
|
||||
/* @[declare_taskpool_getstatus] */
|
||||
|
||||
/**
|
||||
* @brief This function tries to cancel a job that was previously scheduled with @ref IotTaskPool_Schedule.
|
||||
*
|
||||
* A job can be canceled only if it is not yet executing, i.e. if its status is
|
||||
* @ref IOT_TASKPOOL_STATUS_READY or @ref IOT_TASKPOOL_STATUS_SCHEDULED. Calling
|
||||
* @ref IotTaskPool_TryCancel on a job whose status is @ref IOT_TASKPOOL_STATUS_COMPLETED,
|
||||
* or #IOT_TASKPOOL_STATUS_CANCELED will yield a #IOT_TASKPOOL_CANCEL_FAILED return result.
|
||||
*
|
||||
* @param[in] taskPool A handle to the task pool that must have been previously initialized with
|
||||
* a call to @ref IotTaskPool_Create.
|
||||
* @param[in] job The job to cancel.
|
||||
* @param[out] pStatus The status of the job at the time of cancellation.
|
||||
*
|
||||
* @return One of the following:
|
||||
* - #IOT_TASKPOOL_SUCCESS
|
||||
* - #IOT_TASKPOOL_BAD_PARAMETER
|
||||
* - #IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS
|
||||
* - #IOT_TASKPOOL_CANCEL_FAILED
|
||||
*
|
||||
* @warning The `taskPool` used in this function should be the same
|
||||
* used to create the job pointed to by `job`, or the results will be undefined.
|
||||
*
|
||||
*/
|
||||
/* @[declare_taskpool_trycancel] */
|
||||
IotTaskPoolError_t IotTaskPool_TryCancel( IotTaskPool_t taskPool,
|
||||
IotTaskPoolJob_t job,
|
||||
IotTaskPoolJobStatus_t * const pStatus );
|
||||
/* @[declare_taskpool_trycancel] */
|
||||
|
||||
/**
|
||||
* @brief Returns a pointer to the job storage from an instance of a job handle
|
||||
* of type @ref IotTaskPoolJob_t. This function is guaranteed to succeed for a
|
||||
* valid job handle.
|
||||
*
|
||||
* @param[in] job The job handle.
|
||||
*
|
||||
* @return A pointer to the storage associated with the job handle `job`.
|
||||
*
|
||||
* @warning If the `job` handle used is invalid, the results will be undefined.
|
||||
*/
|
||||
/* @[declare_taskpool_getjobstoragefromhandle] */
|
||||
IotTaskPoolJobStorage_t * IotTaskPool_GetJobStorageFromHandle( IotTaskPoolJob_t job );
|
||||
/* @[declare_taskpool_getjobstoragefromhandle] */
|
||||
|
||||
/**
|
||||
* @brief Returns a string that describes an @ref IotTaskPoolError_t.
|
||||
*
|
||||
* Like the POSIX's `strerror`, this function returns a string describing a
|
||||
* return code. In this case, the return code is a task pool library error code,
|
||||
* `status`.
|
||||
*
|
||||
* The string returned by this function <b>MUST</b> be treated as read-only: any
|
||||
* attempt to modify its contents may result in a crash. Therefore, this function
|
||||
* is limited to usage in logging.
|
||||
*
|
||||
* @param[in] status The status to describe.
|
||||
*
|
||||
* @return A read-only string that describes `status`.
|
||||
*
|
||||
* @warning The string returned by this function must never be modified.
|
||||
*/
|
||||
/* @[declare_taskpool_strerror] */
|
||||
const char * IotTaskPool_strerror( IotTaskPoolError_t status );
|
||||
/* @[declare_taskpool_strerror] */
|
||||
|
||||
/**
|
||||
* @brief The maximum number of task pools to be created when using
|
||||
* a memory pool.
|
||||
*/
|
||||
#ifndef IOT_TASKPOOLS
|
||||
#define IOT_TASKPOOLS ( 4 )
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief The maximum number of jobs to cache.
|
||||
*/
|
||||
#ifndef IOT_TASKPOOL_JOBS_RECYCLE_LIMIT
|
||||
#define IOT_TASKPOOL_JOBS_RECYCLE_LIMIT ( 8UL )
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief The maximum timeout in milliseconds to wait for a job to be scheduled before waking up a worker thread.
|
||||
* A worker thread that wakes up as a result of a timeout may exit to allow the task pool to fold back to its
|
||||
* minimum number of threads.
|
||||
*/
|
||||
#ifndef IOT_TASKPOOL_JOB_WAIT_TIMEOUT_MS
|
||||
#define IOT_TASKPOOL_JOB_WAIT_TIMEOUT_MS ( 60 * 1000UL )
|
||||
#endif
|
||||
|
||||
#endif /* ifndef IOT_TASKPOOL_H_ */
|
||||
|
|
@ -0,0 +1,117 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_error.h
|
||||
* @brief Provides macros for error checking and function cleanup.
|
||||
*
|
||||
* The macros in this file are generic. They may be customized by each library
|
||||
* by setting the library prefix.
|
||||
*/
|
||||
|
||||
#ifndef IOT_ERROR_H_
|
||||
#define IOT_ERROR_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/**
|
||||
* @brief Declare the status variable and an initial value.
|
||||
*
|
||||
* This macro should be at the beginning of any functions that use cleanup sections.
|
||||
*
|
||||
* @param[in] statusType The type of the status variable for this function.
|
||||
* @param[in] initialValue The initial value to assign to the status variable.
|
||||
*/
|
||||
#define IOT_FUNCTION_ENTRY( statusType, initialValue ) statusType status = initialValue
|
||||
|
||||
/**
|
||||
* @brief Declares the label that begins a cleanup section.
|
||||
*
|
||||
* This macro should be placed at the end of a function and followed by
|
||||
* #IOT_FUNCTION_CLEANUP_END.
|
||||
*/
|
||||
#define IOT_FUNCTION_CLEANUP_BEGIN() iotCleanup:
|
||||
|
||||
/**
|
||||
* @brief Declares the end of a cleanup section.
|
||||
*
|
||||
* This macro should be placed at the end of a function and preceded by
|
||||
* #IOT_FUNCTION_CLEANUP_BEGIN.
|
||||
*/
|
||||
#define IOT_FUNCTION_CLEANUP_END() return status
|
||||
|
||||
/**
|
||||
* @brief Declares an empty cleanup section.
|
||||
*
|
||||
* This macro should be placed at the end of a function to exit on error if no
|
||||
* cleanup is required.
|
||||
*/
|
||||
#define IOT_FUNCTION_EXIT_NO_CLEANUP() IOT_FUNCTION_CLEANUP_BEGIN(); IOT_FUNCTION_CLEANUP_END()
|
||||
|
||||
/**
|
||||
* @brief Jump to the cleanup section.
|
||||
*/
|
||||
#define IOT_GOTO_CLEANUP() goto iotCleanup
|
||||
|
||||
/**
|
||||
* @brief Assign a value to the status variable and jump to the cleanup section.
|
||||
*
|
||||
* @param[in] statusValue The value to assign to the status variable.
|
||||
*/
|
||||
#define IOT_SET_AND_GOTO_CLEANUP( statusValue ) { status = ( statusValue ); IOT_GOTO_CLEANUP(); }
|
||||
|
||||
/**
|
||||
* @brief Jump to the cleanup section if a condition is `false`.
|
||||
*
|
||||
* This macro may be used in place of `assert` to exit a function is a condition
|
||||
* is `false`.
|
||||
*
|
||||
* @param[in] condition The condition to check.
|
||||
*/
|
||||
#define IOT_GOTO_CLEANUP_IF_FALSE( condition ) { if( ( condition ) == false ) { IOT_GOTO_CLEANUP(); } }
|
||||
|
||||
/**
|
||||
* @brief Assign a value to the status variable and jump to the cleanup section
|
||||
* if a condition is `false`.
|
||||
*
|
||||
* @param[in] statusValue The value to assign to the status variable.
|
||||
* @param[in] condition The condition to check.
|
||||
*/
|
||||
#define IOT_SET_AND_GOTO_CLEANUP_IF_FALSE( statusValue, condition ) \
|
||||
if( ( condition ) == false ) \
|
||||
IOT_SET_AND_GOTO_CLEANUP( statusValue )
|
||||
|
||||
/**
|
||||
* @brief Check a condition; if `false`, assign the "Bad parameter" status value
|
||||
* and jump to the cleanup section.
|
||||
*
|
||||
* @param[in] libraryPrefix The library prefix of the status variable.
|
||||
* @param[in] condition The condition to check.
|
||||
*/
|
||||
#define IOT_VALIDATE_PARAMETER( libraryPrefix, condition ) \
|
||||
IOT_SET_AND_GOTO_CLEANUP_IF_FALSE( libraryPrefix ## _BAD_PARAMETER, condition )
|
||||
|
||||
#endif /* ifndef IOT_ERROR_H_ */
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
#ifndef _AWS_LIB_INIT_H_
|
||||
#define _AWS_LIB_INIT_H_
|
||||
|
||||
#include "FreeRTOS.h"
|
||||
|
||||
#define lib_initDECLARE_LIB_INIT( f ) extern BaseType_t f( void )
|
||||
|
||||
#endif /* _AWS_LIB_INIT_H_ */
|
||||
|
|
@ -0,0 +1,229 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_logging.h
|
||||
* @brief Generic logging function header file.
|
||||
*
|
||||
* Declares the generic logging function and the log levels. This file never
|
||||
* needs to be included in source code. The header iot_logging_setup.h should
|
||||
* be included instead.
|
||||
*
|
||||
* @see iot_logging_setup.h
|
||||
*/
|
||||
|
||||
#ifndef IOT_LOGGING_H_
|
||||
#define IOT_LOGGING_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/**
|
||||
* @constantspage{logging,logging library}
|
||||
*
|
||||
* @section logging_constants_levels Log levels
|
||||
* @brief Log levels for the libraries in this SDK.
|
||||
*
|
||||
* Each library should specify a log level by setting @ref LIBRARY_LOG_LEVEL.
|
||||
* All log messages with a level at or below the specified level will be printed
|
||||
* for that library.
|
||||
*
|
||||
* Currently, there are 4 log levels. In the order of lowest to highest, they are:
|
||||
* - #IOT_LOG_NONE <br>
|
||||
* @copybrief IOT_LOG_NONE
|
||||
* - #IOT_LOG_ERROR <br>
|
||||
* @copybrief IOT_LOG_ERROR
|
||||
* - #IOT_LOG_WARN <br>
|
||||
* @copybrief IOT_LOG_WARN
|
||||
* - #IOT_LOG_INFO <br>
|
||||
* @copybrief IOT_LOG_INFO
|
||||
* - #IOT_LOG_DEBUG <br>
|
||||
* @copybrief IOT_LOG_DEBUG
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief No log messages.
|
||||
*
|
||||
* Log messages with this level will be silently discarded. When @ref
|
||||
* LIBRARY_LOG_LEVEL is #IOT_LOG_NONE, logging is disabled and no [logging functions]
|
||||
* (@ref logging_functions) can be called.
|
||||
*/
|
||||
#define IOT_LOG_NONE 0
|
||||
|
||||
/**
|
||||
* @brief Only critical, unrecoverable errors.
|
||||
*
|
||||
* Log messages with this level will be printed when a library encounters an
|
||||
* error from which it cannot easily recover.
|
||||
*/
|
||||
#define IOT_LOG_ERROR 1
|
||||
|
||||
/**
|
||||
* @brief Message about an abnormal but recoverable event.
|
||||
*
|
||||
* Log messages with this level will be printed when a library encounters an
|
||||
* abnormal event that may be indicative of an error. Libraries should continue
|
||||
* execution after logging a warning.
|
||||
*/
|
||||
#define IOT_LOG_WARN 2
|
||||
|
||||
/**
|
||||
* @brief A helpful, informational message.
|
||||
*
|
||||
* Log messages with this level may indicate the normal status of a library
|
||||
* function. They should be used to track how far a program has executed.
|
||||
*/
|
||||
#define IOT_LOG_INFO 3
|
||||
|
||||
/**
|
||||
* @brief Detailed and excessive debug information.
|
||||
*
|
||||
* Log messages with this level are intended for developers. They may contain
|
||||
* excessive information such as internal variables, buffers, or other specific
|
||||
* information.
|
||||
*/
|
||||
#define IOT_LOG_DEBUG 4
|
||||
|
||||
/**
|
||||
* @paramstructs{logging,logging}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @ingroup logging_datatypes_paramstructs
|
||||
* @brief Log message configuration struct.
|
||||
*
|
||||
* @paramfor @ref logging_function_log, @ref logging_function_generic
|
||||
*
|
||||
* By default, log messages print the library name, log level, and a timestring.
|
||||
* This struct can be passed to @ref logging_function_generic to disable one of
|
||||
* the above components in the log message.
|
||||
*
|
||||
* <b>Example:</b>
|
||||
*
|
||||
* @code{c}
|
||||
* IotLog_Generic( IOT_LOG_DEBUG, "SAMPLE", IOT_LOG_DEBUG, NULL, "Hello world!" );
|
||||
* @endcode
|
||||
* The code above prints the following message:
|
||||
* @code
|
||||
* [DEBUG][SAMPLE][2018-01-01 12:00:00] Hello world!
|
||||
* @endcode
|
||||
*
|
||||
* The timestring can be disabled as follows:
|
||||
* @code
|
||||
* IotLogConfig_t logConfig = { .hideLogLevel = false, .hideLibraryName = false, .hideTimestring = true};
|
||||
* IotLog_Generic( IOT_LOG_DEBUG, "SAMPLE", IOT_LOG_DEBUG, &logConfig, "Hello world!" );
|
||||
* @endcode
|
||||
* The resulting log message will be:
|
||||
* @code
|
||||
* [DEBUG][SAMPLE] Hello world!
|
||||
* @endcode
|
||||
*/
|
||||
typedef struct IotLogConfig
|
||||
{
|
||||
bool hideLogLevel; /**< @brief Don't print the log level string for this message. */
|
||||
bool hideLibraryName; /**< @brief Don't print the library name for this message. */
|
||||
bool hideTimestring; /**< @brief Don't print the timestring for this message. */
|
||||
} IotLogConfig_t;
|
||||
|
||||
/**
|
||||
* @functionspage{logging,logging library}
|
||||
*
|
||||
* - @functionname{logging_function_log}
|
||||
* - @functionname{logging_function_printbuffer}
|
||||
* - @functionname{logging_function_generic}
|
||||
* - @functionname{logging_function_genericprintbuffer}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @functionpage{IotLog_Generic,logging,generic}
|
||||
* @functionpage{IotLog_PrintBuffer,logging,genericprintbuffer}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Generic logging function that prints a single message.
|
||||
*
|
||||
* This function is the generic logging function shared across all libraries.
|
||||
* The library-specific logging function @ref logging_function_log is implemented
|
||||
* using this function. Like @ref logging_function_log, this function is only
|
||||
* available when @ref LIBRARY_LOG_LEVEL is #IOT_LOG_NONE.
|
||||
*
|
||||
* In most cases, the library-specific logging function @ref logging_function_log
|
||||
* should be called instead of this function.
|
||||
*
|
||||
* @param[in] libraryLogSetting The log level setting of the library, used to
|
||||
* determine if the log message should be printed. Must be one of the @ref
|
||||
* logging_constants_levels.
|
||||
* @param[in] pLibraryName The library name to print. See @ref LIBRARY_LOG_NAME.
|
||||
* @param[in] messageLevel The log level of the this message. See @ref LIBRARY_LOG_LEVEL.
|
||||
* @param[in] pLogConfig Pointer to a #IotLogConfig_t. Optional; pass `NULL` to ignore.
|
||||
* @param[in] pFormat Format string for the log message.
|
||||
* @param[in] ... Arguments for format specification.
|
||||
*
|
||||
* @return No return value. On errors, it prints nothing.
|
||||
*/
|
||||
/* @[declare_logging_generic] */
|
||||
void IotLog_Generic( int libraryLogSetting,
|
||||
const char * const pLibraryName,
|
||||
int messageLevel,
|
||||
const IotLogConfig_t * const pLogConfig,
|
||||
const char * const pFormat,
|
||||
... );
|
||||
/* @[declare_logging_generic] */
|
||||
|
||||
/**
|
||||
* @brief Generic function to log the contents of a buffer as bytes.
|
||||
*
|
||||
* This function is the generic buffer logging function shared across all libraries.
|
||||
* The library-specific buffer logging function @ref logging_function_printbuffer is
|
||||
* implemented using this function. Like @ref logging_function_printbuffer, this
|
||||
* function is only available when @ref LIBRARY_LOG_LEVEL is #IOT_LOG_DEBUG.
|
||||
*
|
||||
* In most cases, the library-specific buffer logging function @ref
|
||||
* logging_function_printbuffer should be called instead of this function.
|
||||
*
|
||||
* @param[in] pLibraryName The library name to print with the log. See @ref LIBRARY_LOG_NAME.
|
||||
* @param[in] pHeader A message to print before printing the buffer.
|
||||
* @param[in] pBuffer The buffer to print.
|
||||
* @param[in] bufferSize The number of bytes in `pBuffer` to print.
|
||||
*
|
||||
* @return No return value. On errors, it prints nothing.
|
||||
*
|
||||
* @note To conserve memory, this function only allocates enough memory for a
|
||||
* single line of output. Therefore, in multithreaded systems, its output may
|
||||
* appear "fragmented" if other threads are logging simultaneously.
|
||||
*/
|
||||
/* @[declare_logging_genericprintbuffer] */
|
||||
void IotLog_GenericPrintBuffer( const char * const pLibraryName,
|
||||
const char * const pHeader,
|
||||
const uint8_t * const pBuffer,
|
||||
size_t bufferSize );
|
||||
/* @[declare_logging_genericprintbuffer] */
|
||||
|
||||
#endif /* ifndef IOT_LOGGING_H_ */
|
||||
|
|
@ -0,0 +1,250 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_static_memory.h
|
||||
* @brief Common functions for managing static buffers. Only used when
|
||||
* @ref IOT_STATIC_MEMORY_ONLY is `1`.
|
||||
*/
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* The functions in this file should only exist in static memory only mode, hence
|
||||
* the check for IOT_STATIC_MEMORY_ONLY in the double inclusion guard. */
|
||||
#if !defined( IOT_STATIC_MEMORY_H_ ) && ( IOT_STATIC_MEMORY_ONLY == 1 )
|
||||
#define IOT_STATIC_MEMORY_H_
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/**
|
||||
* @functionspage{static_memory,static memory component}
|
||||
* - @functionname{static_memory_function_init}
|
||||
* - @functionname{static_memory_function_cleanup}
|
||||
* - @functionname{static_memory_function_findfree}
|
||||
* - @functionname{static_memory_function_returninuse}
|
||||
* - @functionname{static_memory_function_messagebuffersize}
|
||||
* - @functionname{static_memory_function_mallocmessagebuffer}
|
||||
* - @functionname{static_memory_function_freemessagebuffer}
|
||||
*/
|
||||
|
||||
/*----------------------- Initialization and cleanup ------------------------*/
|
||||
|
||||
/**
|
||||
* @functionpage{IotStaticMemory_Init,static_memory,init}
|
||||
* @functionpage{IotStaticMemory_Cleanup,static_memory,cleanup}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief One-time initialization function for static memory.
|
||||
*
|
||||
* This function performs internal setup of static memory. <b>It must be called
|
||||
* once (and only once) before calling any other static memory function.</b>
|
||||
* Calling this function more than once without first calling
|
||||
* @ref static_memory_function_cleanup may result in a crash.
|
||||
*
|
||||
* @return `true` if initialization succeeded; `false` otherwise.
|
||||
*
|
||||
* @attention This function is called by `IotSdk_Init` and does not need to be
|
||||
* called by itself.
|
||||
*
|
||||
* @warning No thread-safety guarantees are provided for this function.
|
||||
*
|
||||
* @see static_memory_function_cleanup
|
||||
*/
|
||||
/* @[declare_static_memory_init] */
|
||||
bool IotStaticMemory_Init( void );
|
||||
/* @[declare_static_memory_init] */
|
||||
|
||||
/**
|
||||
* @brief One-time deinitialization function for static memory.
|
||||
*
|
||||
* This function frees resources taken in @ref static_memory_function_init.
|
||||
* It should be called after to clean up static memory. After this function
|
||||
* returns, @ref static_memory_function_init must be called again before
|
||||
* calling any other static memory function.
|
||||
*
|
||||
* @attention This function is called by `IotSdk_Cleanup` and does not need
|
||||
* to be called by itself.
|
||||
*
|
||||
* @warning No thread-safety guarantees are provided for this function.
|
||||
*
|
||||
* @see static_memory_function_init
|
||||
*/
|
||||
/* @[declare_static_memory_cleanup] */
|
||||
void IotStaticMemory_Cleanup( void );
|
||||
/* @[declare_static_memory_cleanup] */
|
||||
|
||||
/*------------------------- Buffer allocation and free ----------------------*/
|
||||
|
||||
/**
|
||||
* @functionpage{IotStaticMemory_FindFree,static_memory,findfree}
|
||||
* @functionpage{IotStaticMemory_ReturnInUse,static_memory,returninuse}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Find a free buffer using the "in-use" flags.
|
||||
*
|
||||
* If a free buffer is found, this function marks the buffer in-use. This function
|
||||
* is common to the static memory implementation.
|
||||
*
|
||||
* @param[in] pInUse The "in-use" flags to search.
|
||||
* @param[in] limit How many flags to check, i.e. the size of `pInUse`.
|
||||
*
|
||||
* @return The index of a free buffer; `-1` if no free buffers are available.
|
||||
*
|
||||
* <b>Example</b>:
|
||||
* @code{c}
|
||||
* // To use this function, first declare two arrays. One provides the statically-allocated
|
||||
* // objects, the other provides flags to determine which objects are in-use.
|
||||
* #define NUMBER_OF_OBJECTS ...
|
||||
* #define OBJECT_SIZE ...
|
||||
* static bool _pInUseObjects[ NUMBER_OF_OBJECTS ] = { 0 };
|
||||
* static uint8_t _pObjects[ NUMBER_OF_OBJECTS ][ OBJECT_SIZE ] = { { 0 } }; // Placeholder for objects.
|
||||
*
|
||||
* // The function to statically allocate objects. Must have the same signature
|
||||
* // as malloc().
|
||||
* void * Iot_MallocObject( size_t size )
|
||||
* {
|
||||
* int32_t freeIndex = -1;
|
||||
* void * pNewObject = NULL;
|
||||
*
|
||||
* // Check that sizes match.
|
||||
* if( size != OBJECT_SIZE )
|
||||
* {
|
||||
* // Get the index of a free object.
|
||||
* freeIndex = IotStaticMemory_FindFree( _pInUseMessageBuffers,
|
||||
* IOT_MESSAGE_BUFFERS );
|
||||
*
|
||||
* if( freeIndex != -1 )
|
||||
* {
|
||||
* pNewBuffer = &( _pMessageBuffers[ freeIndex ][ 0 ] );
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* return pNewBuffer;
|
||||
* }
|
||||
* @endcode
|
||||
*/
|
||||
/* @[declare_static_memory_findfree] */
|
||||
int32_t IotStaticMemory_FindFree( bool * pInUse,
|
||||
size_t limit );
|
||||
/* @[declare_static_memory_findfree] */
|
||||
|
||||
/**
|
||||
* @brief Return an "in-use" buffer.
|
||||
*
|
||||
* This function is common to the static memory implementation.
|
||||
*
|
||||
* @param[in] ptr Pointer to the buffer to return.
|
||||
* @param[in] pPool The pool of buffers that the in-use buffer was allocated from.
|
||||
* @param[in] pInUse The "in-use" flags for pPool.
|
||||
* @param[in] limit How many buffers (and flags) to check while searching for ptr.
|
||||
* @param[in] elementSize The size of a single element in pPool.
|
||||
*
|
||||
* <b>Example</b>:
|
||||
* @code{c}
|
||||
* // To use this function, first declare two arrays. One provides the statically-allocated
|
||||
* // objects, the other provides flags to determine which objects are in-use.
|
||||
* #define NUMBER_OF_OBJECTS ...
|
||||
* #define OBJECT_SIZE ...
|
||||
* static bool _pInUseObjects[ NUMBER_OF_OBJECTS ] = { 0 };
|
||||
* static uint8_t _pObjects[ NUMBER_OF_OBJECTS ][ OBJECT_SIZE ] = { { 0 } }; // Placeholder for objects.
|
||||
*
|
||||
* // The function to free statically-allocated objects. Must have the same signature
|
||||
* // as free().
|
||||
* void Iot_FreeObject( void * ptr )
|
||||
* {
|
||||
* IotStaticMemory_ReturnInUse( ptr,
|
||||
* _pObjects,
|
||||
* _pInUseObjects,
|
||||
* NUMBER_OF_OBJECTS,
|
||||
* OBJECT_SIZE );
|
||||
* }
|
||||
* @endcode
|
||||
*/
|
||||
/* @[declare_static_memory_returninuse] */
|
||||
void IotStaticMemory_ReturnInUse( void * ptr,
|
||||
void * pPool,
|
||||
bool * pInUse,
|
||||
size_t limit,
|
||||
size_t elementSize );
|
||||
/* @[declare_static_memory_returninuse] */
|
||||
|
||||
/*------------------------ Message buffer management ------------------------*/
|
||||
|
||||
/**
|
||||
* @functionpage{Iot_MessageBufferSize,static_memory,messagebuffersize}
|
||||
* @functionpage{Iot_MallocMessageBuffer,static_memory,mallocmessagebuffer}
|
||||
* @functionpage{Iot_FreeMessageBuffer,static_memory,freemessagebuffer}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Get the fixed size of a message buffer.
|
||||
*
|
||||
* The size of the message buffers are known at compile time, but it is a [constant]
|
||||
* (@ref IOT_MESSAGE_BUFFER_SIZE) that may not be visible to all source files.
|
||||
* This function allows other source files to know the size of a message buffer.
|
||||
*
|
||||
* @return The size, in bytes, of a single message buffer.
|
||||
*/
|
||||
/* @[declare_static_memory_messagebuffersize] */
|
||||
size_t Iot_MessageBufferSize( void );
|
||||
/* @[declare_static_memory_messagebuffersize] */
|
||||
|
||||
/**
|
||||
* @brief Get an empty message buffer.
|
||||
*
|
||||
* This function is the analog of [malloc]
|
||||
* (http://pubs.opengroup.org/onlinepubs/9699919799/functions/malloc.html)
|
||||
* for message buffers.
|
||||
*
|
||||
* @param[in] size Requested size for a message buffer.
|
||||
*
|
||||
* @return Pointer to the start of a message buffer. If the `size` argument is larger
|
||||
* than the [fixed size of a message buffer](@ref IOT_MESSAGE_BUFFER_SIZE)
|
||||
* or no message buffers are available, `NULL` is returned.
|
||||
*/
|
||||
/* @[declare_static_memory_mallocmessagebuffer] */
|
||||
void * Iot_MallocMessageBuffer( size_t size );
|
||||
/* @[declare_static_memory_mallocmessagebuffer] */
|
||||
|
||||
/**
|
||||
* @brief Free an in-use message buffer.
|
||||
*
|
||||
* This function is the analog of [free]
|
||||
* (http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html)
|
||||
* for message buffers.
|
||||
*
|
||||
* @param[in] ptr Pointer to the message buffer to free.
|
||||
*/
|
||||
/* @[declare_static_memory_freemessagebuffer] */
|
||||
void Iot_FreeMessageBuffer( void * ptr );
|
||||
/* @[declare_static_memory_freemessagebuffer] */
|
||||
|
||||
#endif /* if !defined( IOT_STATIC_MEMORY_H_ ) && ( IOT_STATIC_MEMORY_ONLY == 1 ) */
|
||||
|
|
@ -0,0 +1,293 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_taskpool_internal.h
|
||||
* @brief Internal header of task pool library. This header should not be included in
|
||||
* typical application code.
|
||||
*/
|
||||
|
||||
#ifndef IOT_TASKPOOL_INTERNAL_H_
|
||||
#define IOT_TASKPOOL_INTERNAL_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Task pool include. */
|
||||
#include "private/iot_error.h"
|
||||
#include "iot_taskpool.h"
|
||||
|
||||
/* FreeRTOS includes. */
|
||||
#include "FreeRTOS.h"
|
||||
#include "semphr.h"
|
||||
#include "timers.h"
|
||||
|
||||
/* Establish a few convenience macros to handle errors in a standard way. */
|
||||
|
||||
/**
|
||||
* @brief Every public API return an enumeration value with an undelying value of 0 in case of success.
|
||||
*/
|
||||
#define TASKPOOL_SUCCEEDED( x ) ( ( x ) == IOT_TASKPOOL_SUCCESS )
|
||||
|
||||
/**
|
||||
* @brief Every public API returns an enumeration value with an undelying value different than 0 in case of success.
|
||||
*/
|
||||
#define TASKPOOL_FAILED( x ) ( ( x ) != IOT_TASKPOOL_SUCCESS )
|
||||
|
||||
/**
|
||||
* @brief Jump to the cleanup area.
|
||||
*/
|
||||
#define TASKPOOL_GOTO_CLEANUP() IOT_GOTO_CLEANUP()
|
||||
|
||||
/**
|
||||
* @brief Declare the storage for the error status variable.
|
||||
*/
|
||||
#define TASKPOOL_FUNCTION_ENTRY( result ) IOT_FUNCTION_ENTRY( IotTaskPoolError_t, result )
|
||||
|
||||
/**
|
||||
* @brief Check error and leave in case of failure.
|
||||
*/
|
||||
#define TASKPOOL_ON_ERROR_GOTO_CLEANUP( expr ) \
|
||||
{ if( TASKPOOL_FAILED( status = ( expr ) ) ) { IOT_GOTO_CLEANUP(); } \
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Exit if an argument is NULL.
|
||||
*/
|
||||
#define TASKPOOL_ON_NULL_ARG_GOTO_CLEANUP( ptr ) IOT_VALIDATE_PARAMETER( IOT_TASKPOOL, ( ptr != NULL ) )
|
||||
|
||||
/**
|
||||
* @brief Exit if an argument is NULL.
|
||||
*/
|
||||
#define TASKPOOL_ON_ARG_ERROR_GOTO_CLEANUP( expr ) IOT_VALIDATE_PARAMETER( IOT_TASKPOOL, ( ( expr ) == false ) )
|
||||
|
||||
/**
|
||||
* @brief Set error and leave.
|
||||
*/
|
||||
#define TASKPOOL_SET_AND_GOTO_CLEANUP( expr ) IOT_SET_AND_GOTO_CLEANUP( expr )
|
||||
|
||||
/**
|
||||
* @brief Initialize error and declare start of cleanup area.
|
||||
*/
|
||||
#define TASKPOOL_FUNCTION_CLEANUP() IOT_FUNCTION_CLEANUP_BEGIN()
|
||||
|
||||
/**
|
||||
* @brief Initialize error and declare end of cleanup area.
|
||||
*/
|
||||
#define TASKPOOL_FUNCTION_CLEANUP_END() IOT_FUNCTION_CLEANUP_END()
|
||||
|
||||
/**
|
||||
* @brief Create an empty cleanup area.
|
||||
*/
|
||||
#define TASKPOOL_NO_FUNCTION_CLEANUP() IOT_FUNCTION_EXIT_NO_CLEANUP()
|
||||
|
||||
/**
|
||||
* @brief Does not create a cleanup area.
|
||||
*/
|
||||
#define TASKPOOL_NO_FUNCTION_CLEANUP_NOLABEL() return status
|
||||
|
||||
/**
|
||||
* @def IotTaskPool_Assert( expression )
|
||||
* @brief Assertion macro for the Task pool library.
|
||||
*
|
||||
* Set @ref IOT_TASKPOOL_ENABLE_ASSERTS to `1` to enable assertions in the Task pool
|
||||
* library.
|
||||
*
|
||||
* @param[in] expression Expression to be evaluated.
|
||||
*/
|
||||
#if IOT_TASKPOOL_ENABLE_ASSERTS == 1
|
||||
#ifndef IotTaskPool_Assert
|
||||
#include <assert.h>
|
||||
#define IotTaskPool_Assert( expression ) assert( expression )
|
||||
#endif
|
||||
#else
|
||||
#define IotTaskPool_Assert( expression )
|
||||
#endif
|
||||
|
||||
/* Configure logs for TASKPOOL functions. */
|
||||
#ifdef IOT_LOG_LEVEL_TASKPOOL
|
||||
#define LIBRARY_LOG_LEVEL IOT_LOG_LEVEL_TASKPOOL
|
||||
#else
|
||||
#ifdef IOT_LOG_LEVEL_GLOBAL
|
||||
#define LIBRARY_LOG_LEVEL IOT_LOG_LEVEL_GLOBAL
|
||||
#else
|
||||
#define LIBRARY_LOG_LEVEL IOT_LOG_NONE
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#define LIBRARY_LOG_NAME ( "TASKPOOL" )
|
||||
#include "iot_logging_setup.h"
|
||||
|
||||
/*
|
||||
* Provide default values for undefined memory allocation functions based on
|
||||
* the usage of dynamic memory allocation.
|
||||
*/
|
||||
#if IOT_STATIC_MEMORY_ONLY == 1
|
||||
#include "private/iot_static_memory.h"
|
||||
|
||||
/**
|
||||
* @brief Allocate an #_taskPool_t. This function should have the
|
||||
* same signature as [malloc].
|
||||
*/
|
||||
void * IotTaskPool_MallocTaskPool( size_t size );
|
||||
|
||||
/**
|
||||
* @brief Free an #_taskPool_t. This function should have the
|
||||
* same signature as [malloc].
|
||||
*/
|
||||
void IotTaskPool_FreeTaskPool( void * ptr );
|
||||
|
||||
/**
|
||||
* @brief Allocate an #IotTaskPoolJob_t. This function should have the
|
||||
* same signature as [malloc].
|
||||
*/
|
||||
void * IotTaskPool_MallocJob( size_t size );
|
||||
|
||||
/**
|
||||
* @brief Free an #IotTaskPoolJob_t. This function should have the same
|
||||
* same signature as [malloc].
|
||||
* (http://pubs.opengroup.org/onlinepubs/9699919799/functions/malloc.html).
|
||||
*/
|
||||
void IotTaskPool_FreeJob( void * ptr );
|
||||
|
||||
/**
|
||||
* @brief Allocate an #_taskPoolTimerEvent_t. This function should have the
|
||||
* same signature as [malloc].
|
||||
*/
|
||||
void * IotTaskPool_MallocTimerEvent( size_t size );
|
||||
|
||||
/**
|
||||
* @brief Free an #_taskPoolTimerEvent_t. This function should have the
|
||||
* same signature as[ free ].
|
||||
*/
|
||||
void IotTaskPool_FreeTimerEvent( void * ptr );
|
||||
|
||||
#else /* if IOT_STATIC_MEMORY_ONLY == 1 */
|
||||
#include <stdlib.h>
|
||||
|
||||
#ifndef IotTaskPool_MallocTaskPool
|
||||
#define IotTaskPool_MallocTaskPool malloc
|
||||
#endif
|
||||
|
||||
#ifndef IotTaskPool_FreeTaskPool
|
||||
#define IotTaskPool_FreeTaskPool free
|
||||
#endif
|
||||
|
||||
#ifndef IotTaskPool_MallocJob
|
||||
#define IotTaskPool_MallocJob malloc
|
||||
#endif
|
||||
|
||||
#ifndef IotTaskPool_FreeJob
|
||||
#define IotTaskPool_FreeJob free
|
||||
#endif
|
||||
|
||||
#ifndef IotTaskPool_MallocTimerEvent
|
||||
#define IotTaskPool_MallocTimerEvent malloc
|
||||
#endif
|
||||
|
||||
#ifndef IotTaskPool_FreeTimerEvent
|
||||
#define IotTaskPool_FreeTimerEvent free
|
||||
#endif
|
||||
|
||||
#endif /* if IOT_STATIC_MEMORY_ONLY == 1 */
|
||||
|
||||
/* ---------------------------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
* @cond DOXYGEN_IGNORE
|
||||
* Doxygen should ignore this section.
|
||||
*
|
||||
* A macros to manage task pool memory allocation.
|
||||
*/
|
||||
#define IOT_TASK_POOL_INTERNAL_STATIC ( ( uint32_t ) 0x00000001 ) /* Flag to mark a job as user-allocated. */
|
||||
/** @endcond */
|
||||
|
||||
/**
|
||||
* @brief Task pool jobs cache.
|
||||
*
|
||||
* @warning This is a system-level data type that should not be modified or used directly in any application.
|
||||
* @warning This is a system-level data type that can and will change across different versions of the platform, with no regards for backward compatibility.
|
||||
*
|
||||
*/
|
||||
typedef struct _taskPoolCache
|
||||
{
|
||||
IotListDouble_t freeList; /**< @brief A list ot hold cached jobs. */
|
||||
|
||||
uint32_t freeCount; /**< @brief A counter to track the number of jobs in the cache. */
|
||||
} _taskPoolCache_t;
|
||||
|
||||
/**
|
||||
* @brief The task pool data structure keeps track of the internal state and the signals for the dispatcher threads.
|
||||
* The task pool is a thread safe data structure.
|
||||
*
|
||||
* @warning This is a system-level data type that should not be modified or used directly in any application.
|
||||
* @warning This is a system-level data type that can and will change across different versions of the platform, with no regards for backward compatibility.
|
||||
*
|
||||
*/
|
||||
typedef struct _taskPool
|
||||
{
|
||||
IotDeQueue_t dispatchQueue; /**< @brief The queue for the jobs waiting to be executed. */
|
||||
IotListDouble_t timerEventsList; /**< @brief The timeouts queue for all deferred jobs waiting to be executed. */
|
||||
_taskPoolCache_t jobsCache; /**< @brief A cache to re-use jobs in order to limit memory allocations. */
|
||||
uint32_t activeThreads; /**< @brief The number of threads in the task pool at any given time. */
|
||||
int32_t priority; /**< @brief The priority for all task pool threads. */
|
||||
SemaphoreHandle_t dispatchSignal; /**< @brief The synchronization object on which threads are waiting for incoming jobs. */
|
||||
StaticSemaphore_t dispatchSignalBuffer; /**< @brief The semaphore buffer. */
|
||||
StaticSemaphore_t startStopSignalBuffer; /**< @brief The semaphore buffer. */
|
||||
TimerHandle_t timer; /**< @brief The timer for deferred jobs. */
|
||||
StaticTimer_t timerBuffer; /**< @brief The timer buffer. */
|
||||
bool running; /**< @brief A flag to track whether the task pool is operational or should shut down. */
|
||||
} _taskPool_t;
|
||||
|
||||
/**
|
||||
* @brief The job data structure keeps track of the user callback and context, as well as the status of the job.
|
||||
*
|
||||
* @warning This is a system-level data type that should not be modified or used directly in any application.
|
||||
* @warning This is a system-level data type that can and will change across different versions of the platform, with no regards for backward compatibility.
|
||||
*
|
||||
*/
|
||||
typedef struct _taskPoolJob
|
||||
{
|
||||
IotLink_t link; /**< @brief The link to insert the job in the dispatch queue. */
|
||||
IotTaskPoolRoutine_t userCallback; /**< @brief The user provided callback. */
|
||||
void * pUserContext; /**< @brief The user provided context. */
|
||||
uint32_t flags; /**< @brief Internal flags. */
|
||||
IotTaskPoolJobStatus_t status; /**< @brief The status for the job. */
|
||||
} _taskPoolJob_t;
|
||||
|
||||
/**
|
||||
* @brief Represents an operation that is subject to a timer.
|
||||
*
|
||||
* These events are queued per MQTT connection. They are sorted by their
|
||||
* expiration time.
|
||||
*/
|
||||
typedef struct _taskPoolTimerEvent
|
||||
{
|
||||
IotLink_t link; /**< @brief List link member. */
|
||||
TickType_t expirationTime; /**< @brief When this event should be processed. */
|
||||
IotTaskPoolJob_t job; /**< @brief The task pool job associated with this event. */
|
||||
} _taskPoolTimerEvent_t;
|
||||
|
||||
#endif /* ifndef IOT_TASKPOOL_INTERNAL_H_ */
|
||||
|
|
@ -0,0 +1,362 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_taskpool_types.h
|
||||
* @brief Types of the task pool.
|
||||
*/
|
||||
|
||||
#ifndef IOT_TASKPOOL_TYPES_H_
|
||||
#define IOT_TASKPOOL_TYPES_H_
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stdint.h>
|
||||
|
||||
/* Platform types includes. */
|
||||
#include "types/iot_platform_types.h"
|
||||
|
||||
/* Linear containers (lists and queues) include. */
|
||||
#include "iot_linear_containers.h"
|
||||
|
||||
/*-------------------------- Task pool enumerated types --------------------------*/
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_enums
|
||||
* @brief Return codes of [task pool functions](@ref taskpool_functions).
|
||||
*/
|
||||
typedef enum IotTaskPoolError
|
||||
{
|
||||
/**
|
||||
* @brief Task pool operation completed successfully.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_createsystemtaskpool
|
||||
* - @ref taskpool_function_create
|
||||
* - @ref taskpool_function_destroy
|
||||
* - @ref taskpool_function_setmaxthreads
|
||||
* - @ref taskpool_function_createjob
|
||||
* - @ref taskpool_function_createrecyclablejob
|
||||
* - @ref taskpool_function_destroyrecyclablejob
|
||||
* - @ref taskpool_function_recyclejob
|
||||
* - @ref taskpool_function_schedule
|
||||
* - @ref taskpool_function_scheduledeferred
|
||||
* - @ref taskpool_function_getstatus
|
||||
* - @ref taskpool_function_trycancel
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_SUCCESS = 0,
|
||||
|
||||
/**
|
||||
* @brief Task pool operation failed because at least one parameter is invalid.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_createsystemtaskpool
|
||||
* - @ref taskpool_function_create
|
||||
* - @ref taskpool_function_destroy
|
||||
* - @ref taskpool_function_setmaxthreads
|
||||
* - @ref taskpool_function_createjob
|
||||
* - @ref taskpool_function_createrecyclablejob
|
||||
* - @ref taskpool_function_destroyrecyclablejob
|
||||
* - @ref taskpool_function_recyclejob
|
||||
* - @ref taskpool_function_schedule
|
||||
* - @ref taskpool_function_scheduledeferred
|
||||
* - @ref taskpool_function_getstatus
|
||||
* - @ref taskpool_function_trycancel
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_BAD_PARAMETER,
|
||||
|
||||
/**
|
||||
* @brief Task pool operation failed because it is illegal.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_createjob
|
||||
* - @ref taskpool_function_createrecyclablejob
|
||||
* - @ref taskpool_function_destroyrecyclablejob
|
||||
* - @ref taskpool_function_recyclejob
|
||||
* - @ref taskpool_function_schedule
|
||||
* - @ref taskpool_function_scheduledeferred
|
||||
* - @ref taskpool_function_trycancel
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_ILLEGAL_OPERATION,
|
||||
|
||||
/**
|
||||
* @brief Task pool operation failed because allocating memory failed.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_createsystemtaskpool
|
||||
* - @ref taskpool_function_create
|
||||
* - @ref taskpool_function_setmaxthreads
|
||||
* - @ref taskpool_function_createrecyclablejob
|
||||
* - @ref taskpool_function_scheduledeferred
|
||||
* - @ref taskpool_function_getstatus
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_NO_MEMORY,
|
||||
|
||||
/**
|
||||
* @brief Task pool operation failed because of an invalid parameter.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_setmaxthreads
|
||||
* - @ref taskpool_function_createrecyclablejob
|
||||
* - @ref taskpool_function_destroyrecyclablejob
|
||||
* - @ref taskpool_function_recyclejob
|
||||
* - @ref taskpool_function_schedule
|
||||
* - @ref taskpool_function_scheduledeferred
|
||||
* - @ref taskpool_function_getstatus
|
||||
* - @ref taskpool_function_trycancel
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_SHUTDOWN_IN_PROGRESS,
|
||||
|
||||
/**
|
||||
* @brief Task pool cancellation failed.
|
||||
*
|
||||
* Functions that may return this value:
|
||||
* - @ref taskpool_function_trycancel
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_CANCEL_FAILED,
|
||||
} IotTaskPoolError_t;
|
||||
|
||||
/**
|
||||
* @enums{taskpool,Task pool library}
|
||||
*/
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_enums
|
||||
* @brief Status codes of [task pool Job](@ref IotTaskPoolJob_t).
|
||||
*
|
||||
*/
|
||||
typedef enum IotTaskPoolJobStatus
|
||||
{
|
||||
/**
|
||||
* @brief Job is ready to be scheduled.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_READY = 0,
|
||||
|
||||
/**
|
||||
* @brief Job has been queued for execution.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_SCHEDULED,
|
||||
|
||||
/**
|
||||
* @brief Job has been scheduled for deferred execution.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_DEFERRED,
|
||||
|
||||
/**
|
||||
* @brief Job is executing.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_COMPLETED,
|
||||
|
||||
/**
|
||||
* @brief Job has been canceled before executing.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_CANCELED,
|
||||
|
||||
/**
|
||||
* @brief Job status is undefined.
|
||||
*
|
||||
*/
|
||||
IOT_TASKPOOL_STATUS_UNDEFINED,
|
||||
} IotTaskPoolJobStatus_t;
|
||||
|
||||
/*------------------------- Task pool types and handles --------------------------*/
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_handles
|
||||
* @brief Opaque handle of a Task Pool instance.
|
||||
*
|
||||
* This type identifies a Task Pool instance, which is valid after a successful call
|
||||
* to @ref taskpool_function_createsystemtaskpool or @ref taskpool_function_create. A
|
||||
* variable of this type is passed as the first
|
||||
* argument to [Task Pool library functions](@ref taskpool_functions) to identify which
|
||||
* task pool that function acts on.
|
||||
*
|
||||
* A call to @ref taskpool_function_destroy makes a task pool handle invalid. Once
|
||||
* @ref taskpool_function_destroy returns, the task handle should no longer
|
||||
* be used.
|
||||
*
|
||||
* @initializer{IotTaskPool_t,IOT_TASKPOOL_INITIALIZER}
|
||||
*/
|
||||
typedef struct _taskPool * IotTaskPool_t;
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_structs
|
||||
* @brief The job storage data structure provides the storage for a statically allocated Task Pool Job instance.
|
||||
*
|
||||
* @warning This is a system-level data type that should not be modified or used directly in any application.
|
||||
* @warning This is a system-level data type that can and will change across different versions of the platform, with no regards for backward compatibility.
|
||||
*
|
||||
*/
|
||||
typedef struct IotTaskPoolJobStorage
|
||||
{
|
||||
IotLink_t link; /**< @brief Placeholder. */
|
||||
void * dummy2; /**< @brief Placeholder. */
|
||||
void * dummy3; /**< @brief Placeholder. */
|
||||
uint32_t dummy4; /**< @brief Placeholder. */
|
||||
IotTaskPoolJobStatus_t status; /**< @brief Placeholder. */
|
||||
} IotTaskPoolJobStorage_t;
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_handles
|
||||
* @brief Opaque handle of a Task Pool Job.
|
||||
*
|
||||
* This type identifies a Task Pool Job instance, which is valid after a successful call
|
||||
* to @ref taskpool_function_createjob or @ref taskpool_function_createrecyclablejob.
|
||||
*
|
||||
* A call to @ref taskpool_function_recyclejob or @ref taskpool_function_destroyrecyclablejob makes a
|
||||
* task pool job handle invalid. Once @ref taskpool_function_recyclejob or
|
||||
* @ref taskpool_function_destroyrecyclablejob returns, the task job handle should no longer be used.
|
||||
*
|
||||
* @initializer{IotTaskPoolJob_t,IOT_TASKPOOL_JOB_INITIALIZER}
|
||||
*
|
||||
*/
|
||||
typedef struct _taskPoolJob * IotTaskPoolJob_t;
|
||||
|
||||
/*------------------------- Task pool parameter structs --------------------------*/
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_functionpointers
|
||||
* @brief Callback type for a user callback.
|
||||
*
|
||||
* This type identifies the user callback signature to execute a task pool job. This callback will be invoked
|
||||
* by the task pool threads with the `pUserContext` parameter, as specified by the user when
|
||||
* calling @ref IotTaskPool_Schedule.
|
||||
*
|
||||
*/
|
||||
typedef void ( * IotTaskPoolRoutine_t )( IotTaskPool_t pTaskPool,
|
||||
IotTaskPoolJob_t pJob,
|
||||
void * pUserContext );
|
||||
|
||||
/**
|
||||
* @ingroup taskpool_datatypes_paramstructs
|
||||
* @brief Initialization information to create one task pool instance.
|
||||
*
|
||||
* @paramfor @ref taskpool_function_createsystemtaskpool @ref taskpool_function_create.
|
||||
*
|
||||
* Passed as an argument to @ref taskpool_function_create.
|
||||
*
|
||||
* @initializer{IotTaskPoolInfo_t,IOT_TASKPOOL_INFO_INITIALIZER}
|
||||
*/
|
||||
typedef struct IotTaskPoolInfo
|
||||
{
|
||||
/**
|
||||
* @brief Specifies the operating parameters for a task pool.
|
||||
*
|
||||
* @attention #IotTaskPoolInfo_t.minThreads <b>MUST</b> be at least 1.
|
||||
* #IotTaskPoolInfo_t.maxThreads <b>MUST</b> be greater or equal to #IotTaskPoolInfo_t.minThreads.
|
||||
* If the minimum number of threads is same as the maximum, then the task pool will not try and grow the
|
||||
* number of worker threads at run time.
|
||||
*/
|
||||
|
||||
uint32_t minThreads; /**< @brief Minimum number of threads in a task pool. These threads will be created when the task pool is first created with @ref taskpool_function_create. */
|
||||
uint32_t maxThreads; /**< @brief Maximum number of threads in a task pool. A task pool may try and grow the number of active threads up to #IotTaskPoolInfo_t.maxThreads. */
|
||||
uint32_t stackSize; /**< @brief Stack size for every task pool thread. The stack size for each thread is fixed after the task pool is created and cannot be changed. */
|
||||
int32_t priority; /**< @brief priority for every task pool thread. The priority for each thread is fixed after the task pool is created and cannot be changed. */
|
||||
} IotTaskPoolInfo_t;
|
||||
|
||||
/*------------------------- TASKPOOL defined constants --------------------------*/
|
||||
|
||||
/**
|
||||
* @constantspage{taskpool,task pool library}
|
||||
*
|
||||
* @section taskpool_constants_initializers Task pool Initializers
|
||||
* @brief Provides default values for initializing the data types of the task pool library.
|
||||
*
|
||||
* @snippet this define_taskpool_initializers
|
||||
*
|
||||
* All user-facing data types of the task pool library can be initialized using
|
||||
* one of the following.
|
||||
*
|
||||
* @warning Failure to initialize a task pool data type with the appropriate initializer
|
||||
* may result in a runtime error!
|
||||
* @note The initializers may change at any time in future versions, but their
|
||||
* names will remain the same.
|
||||
*
|
||||
* <b>Example</b>
|
||||
* @code{c}
|
||||
*
|
||||
* IotTaskPool_t * pTaskPool;
|
||||
*
|
||||
* const IotTaskPoolInfo_t tpInfo = IOT_TASKPOOL_INFO_INITIALIZER_LARGE;
|
||||
*
|
||||
* IotTaskPoolError_t error = IotTaskPool_Create( &tpInfo, &pTaskPool );
|
||||
*
|
||||
* // Use the task pool
|
||||
* // ...
|
||||
*
|
||||
* @endcode
|
||||
*
|
||||
*/
|
||||
/* @[define_taskpool_initializers] */
|
||||
/** @brief Initializer for a small #IotTaskPoolInfo_t. */
|
||||
#define IOT_TASKPOOL_INFO_INITIALIZER_SMALL { .minThreads = 1, .maxThreads = 1, .stackSize = IOT_THREAD_DEFAULT_STACK_SIZE, .priority = IOT_THREAD_DEFAULT_PRIORITY }
|
||||
/** @brief Initializer for a medium #IotTaskPoolInfo_t. */
|
||||
#define IOT_TASKPOOL_INFO_INITIALIZER_MEDIUM { .minThreads = 1, .maxThreads = 2, .stackSize = IOT_THREAD_DEFAULT_STACK_SIZE, .priority = IOT_THREAD_DEFAULT_PRIORITY }
|
||||
/** @brief Initializer for a large #IotTaskPoolInfo_t. */
|
||||
#define IOT_TASKPOOL_INFO_INITIALIZER_LARGE { .minThreads = 2, .maxThreads = 3, .stackSize = IOT_THREAD_DEFAULT_STACK_SIZE, .priority = IOT_THREAD_DEFAULT_PRIORITY }
|
||||
/** @brief Initializer for a very large #IotTaskPoolInfo_t. */
|
||||
#define IOT_TASKPOOL_INFO_INITIALIZER_XLARGE { .minThreads = 2, .maxThreads = 4, .stackSize = IOT_THREAD_DEFAULT_STACK_SIZE, .priority = IOT_THREAD_DEFAULT_PRIORITY }
|
||||
/** @brief Initializer for a typical #IotTaskPoolInfo_t. */
|
||||
#define IOT_TASKPOOL_INFO_INITIALIZER IOT_TASKPOOL_INFO_INITIALIZER_MEDIUM
|
||||
/** @brief Initializer for a #IotTaskPool_t. */
|
||||
#define IOT_TASKPOOL_INITIALIZER NULL
|
||||
/** @brief Initializer for a #IotTaskPoolJobStorage_t. */
|
||||
#define IOT_TASKPOOL_JOB_STORAGE_INITIALIZER { { NULL, NULL }, NULL, NULL, 0, IOT_TASKPOOL_STATUS_UNDEFINED }
|
||||
/** @brief Initializer for a #IotTaskPoolJob_t. */
|
||||
#define IOT_TASKPOOL_JOB_INITIALIZER NULL
|
||||
/* @[define_taskpool_initializers] */
|
||||
|
||||
/**
|
||||
* @brief Flag for scheduling a job to execute immediately, even if the maximum number of threads in the
|
||||
* task pool was reached already.
|
||||
*
|
||||
* @warning This flag may cause the task pool to create a worker to serve the job immediately, and
|
||||
* therefore using this flag may incur in additional memory usage and potentially fail scheduling the job.
|
||||
*/
|
||||
#define IOT_TASKPOOL_JOB_HIGH_PRIORITY ( ( uint32_t ) 0x00000001 )
|
||||
|
||||
/**
|
||||
* @brief Allows the use of the handle to the system task pool.
|
||||
*
|
||||
* @warning The task pool handle is not valid unless @ref IotTaskPool_CreateSystemTaskPool is
|
||||
* called before the handle is used.
|
||||
*/
|
||||
#define IOT_SYSTEM_TASKPOOL ( IotTaskPool_GetSystemTaskPool() )
|
||||
|
||||
#endif /* ifndef IOT_TASKPOOL_TYPES_H_ */
|
||||
|
|
@ -0,0 +1,454 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_logging.c
|
||||
* @brief Implementation of logging functions from iot_logging.h
|
||||
*/
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdarg.h>
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
|
||||
/* Platform clock include. */
|
||||
#include "platform/iot_clock.h"
|
||||
|
||||
/* Logging includes. */
|
||||
#include "private/iot_logging.h"
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/* This implementation assumes the following values for the log level constants.
|
||||
* Ensure that the values have not been modified. */
|
||||
#if IOT_LOG_NONE != 0
|
||||
#error "IOT_LOG_NONE must be 0."
|
||||
#endif
|
||||
#if IOT_LOG_ERROR != 1
|
||||
#error "IOT_LOG_ERROR must be 1."
|
||||
#endif
|
||||
#if IOT_LOG_WARN != 2
|
||||
#error "IOT_LOG_WARN must be 2."
|
||||
#endif
|
||||
#if IOT_LOG_INFO != 3
|
||||
#error "IOT_LOG_INFO must be 3."
|
||||
#endif
|
||||
#if IOT_LOG_DEBUG != 4
|
||||
#error "IOT_LOG_DEBUG must be 4."
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @def IotLogging_Puts( message )
|
||||
* @brief Function the logging library uses to print a line.
|
||||
*
|
||||
* This function can be set by using a define. By default, the standard library
|
||||
* [puts](http://pubs.opengroup.org/onlinepubs/9699919799/functions/puts.html)
|
||||
* function is used.
|
||||
*/
|
||||
#ifndef IotLogging_Puts
|
||||
#define IotLogging_Puts puts
|
||||
#endif
|
||||
|
||||
/*
|
||||
* Provide default values for undefined memory allocation functions based on
|
||||
* the usage of dynamic memory allocation.
|
||||
*/
|
||||
#if IOT_STATIC_MEMORY_ONLY == 1
|
||||
/* Static memory allocation header. */
|
||||
#include "private/iot_static_memory.h"
|
||||
|
||||
/**
|
||||
* @brief Allocate a new logging buffer. This function must have the same
|
||||
* signature as [malloc](http://pubs.opengroup.org/onlinepubs/9699919799/functions/malloc.html).
|
||||
*/
|
||||
#ifndef IotLogging_Malloc
|
||||
#define IotLogging_Malloc Iot_MallocMessageBuffer
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Free a logging buffer. This function must have the same signature
|
||||
* as [free](http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html).
|
||||
*/
|
||||
#ifndef IotLogging_Free
|
||||
#define IotLogging_Free Iot_FreeMessageBuffer
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Get the size of a logging buffer. Statically-allocated buffers
|
||||
* should all have the same size.
|
||||
*/
|
||||
#ifndef IotLogging_StaticBufferSize
|
||||
#define IotLogging_StaticBufferSize Iot_MessageBufferSize
|
||||
#endif
|
||||
#else /* if IOT_STATIC_MEMORY_ONLY == 1 */
|
||||
#ifndef IotLogging_Malloc
|
||||
#include <stdlib.h>
|
||||
#define IotLogging_Malloc malloc
|
||||
#endif
|
||||
|
||||
#ifndef IotLogging_Free
|
||||
#include <stdlib.h>
|
||||
#define IotLogging_Free free
|
||||
#endif
|
||||
#endif /* if IOT_STATIC_MEMORY_ONLY == 1 */
|
||||
|
||||
/**
|
||||
* @brief A guess of the maximum length of a timestring.
|
||||
*
|
||||
* There's no way for this logging library to know the length of a timestring
|
||||
* before it's generated. Therefore, the logging library will assume a maximum
|
||||
* length of any timestring it may get. This value should be generous enough
|
||||
* to accommodate the vast majority of timestrings.
|
||||
*
|
||||
* @see @ref platform_clock_function_gettimestring
|
||||
*/
|
||||
#define MAX_TIMESTRING_LENGTH ( 64 )
|
||||
|
||||
/**
|
||||
* @brief The longest string in #_pLogLevelStrings (below), plus 3 to accommodate
|
||||
* `[]` and a null-terminator.
|
||||
*/
|
||||
#define MAX_LOG_LEVEL_LENGTH ( 8 )
|
||||
|
||||
/**
|
||||
* @brief How many bytes @ref logging_function_genericprintbuffer should output on
|
||||
* each line.
|
||||
*/
|
||||
#define BYTES_PER_LINE ( 16 )
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/**
|
||||
* @brief Lookup table for log levels.
|
||||
*
|
||||
* Converts one of the @ref logging_constants_levels to a string.
|
||||
*/
|
||||
static const char * const _pLogLevelStrings[ 5 ] =
|
||||
{
|
||||
"", /* IOT_LOG_NONE */
|
||||
"ERROR", /* IOT_LOG_ERROR */
|
||||
"WARN ", /* IOT_LOG_WARN */
|
||||
"INFO ", /* IOT_LOG_INFO */
|
||||
"DEBUG" /* IOT_LOG_DEBUG */
|
||||
};
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
#if !defined( IOT_STATIC_MEMORY_ONLY ) || ( IOT_STATIC_MEMORY_ONLY == 0 )
|
||||
static bool _reallocLoggingBuffer( void ** pOldBuffer,
|
||||
size_t newSize,
|
||||
size_t oldSize )
|
||||
{
|
||||
bool status = false;
|
||||
|
||||
/* Allocate a new, larger buffer. */
|
||||
void * pNewBuffer = IotLogging_Malloc( newSize );
|
||||
|
||||
/* Ensure that memory allocation succeeded. */
|
||||
if( pNewBuffer != NULL )
|
||||
{
|
||||
/* Copy the data from the old buffer to the new buffer. */
|
||||
( void ) memcpy( pNewBuffer, *pOldBuffer, oldSize );
|
||||
|
||||
/* Free the old buffer and update the pointer. */
|
||||
IotLogging_Free( *pOldBuffer );
|
||||
*pOldBuffer = pNewBuffer;
|
||||
|
||||
status = true;
|
||||
}
|
||||
|
||||
return status;
|
||||
}
|
||||
#endif /* if !defined( IOT_STATIC_MEMORY_ONLY ) || ( IOT_STATIC_MEMORY_ONLY == 0 ) */
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void IotLog_Generic( int libraryLogSetting,
|
||||
const char * const pLibraryName,
|
||||
int messageLevel,
|
||||
const IotLogConfig_t * const pLogConfig,
|
||||
const char * const pFormat,
|
||||
... )
|
||||
{
|
||||
int requiredMessageSize = 0;
|
||||
size_t bufferSize = 0,
|
||||
bufferPosition = 0, timestringLength = 0;
|
||||
char * pLoggingBuffer = NULL;
|
||||
va_list args;
|
||||
|
||||
/* If the library's log level setting is lower than the message level,
|
||||
* return without doing anything. */
|
||||
if( ( messageLevel == 0 ) || ( messageLevel > libraryLogSetting ) )
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideLogLevel == false ) )
|
||||
{
|
||||
/* Add length of log level if requested. */
|
||||
bufferSize += MAX_LOG_LEVEL_LENGTH;
|
||||
}
|
||||
|
||||
/* Estimate the amount of buffer needed for this log message. */
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideLibraryName == false ) )
|
||||
{
|
||||
/* Add size of library name if requested. Add 2 to accommodate "[]". */
|
||||
bufferSize += strlen( pLibraryName ) + 2;
|
||||
}
|
||||
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideTimestring == false ) )
|
||||
{
|
||||
/* Add length of timestring if requested. */
|
||||
bufferSize += MAX_TIMESTRING_LENGTH;
|
||||
}
|
||||
|
||||
/* Add 64 as an initial (arbitrary) guess for the length of the message. */
|
||||
bufferSize += 64;
|
||||
|
||||
/* In static memory mode, check that the log message will fit in the a
|
||||
* static buffer. */
|
||||
#if IOT_STATIC_MEMORY_ONLY == 1
|
||||
if( bufferSize >= IotLogging_StaticBufferSize() )
|
||||
{
|
||||
/* If the static buffers are likely too small to fit the log message,
|
||||
* return. */
|
||||
return;
|
||||
}
|
||||
|
||||
/* Otherwise, update the buffer size to the size of a static buffer. */
|
||||
bufferSize = IotLogging_StaticBufferSize();
|
||||
#endif
|
||||
|
||||
/* Allocate memory for the logging buffer. */
|
||||
pLoggingBuffer = ( char * ) IotLogging_Malloc( bufferSize );
|
||||
|
||||
if( pLoggingBuffer == NULL )
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
/* Print the message log level if requested. */
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideLogLevel == false ) )
|
||||
{
|
||||
/* Ensure that message level is valid. */
|
||||
if( ( messageLevel >= IOT_LOG_NONE ) && ( messageLevel <= IOT_LOG_DEBUG ) )
|
||||
{
|
||||
/* Add the log level string to the logging buffer. */
|
||||
requiredMessageSize = snprintf( pLoggingBuffer + bufferPosition,
|
||||
bufferSize - bufferPosition,
|
||||
"[%s]",
|
||||
_pLogLevelStrings[ messageLevel ] );
|
||||
|
||||
/* Check for encoding errors. */
|
||||
if( requiredMessageSize <= 0 )
|
||||
{
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/* Update the buffer position. */
|
||||
bufferPosition += ( size_t ) requiredMessageSize;
|
||||
}
|
||||
}
|
||||
|
||||
/* Print the library name if requested. */
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideLibraryName == false ) )
|
||||
{
|
||||
/* Add the library name to the logging buffer. */
|
||||
requiredMessageSize = snprintf( pLoggingBuffer + bufferPosition,
|
||||
bufferSize - bufferPosition,
|
||||
"[%s]",
|
||||
pLibraryName );
|
||||
|
||||
/* Check for encoding errors. */
|
||||
if( requiredMessageSize <= 0 )
|
||||
{
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/* Update the buffer position. */
|
||||
bufferPosition += ( size_t ) requiredMessageSize;
|
||||
}
|
||||
|
||||
/* Print the timestring if requested. */
|
||||
if( ( pLogConfig == NULL ) || ( pLogConfig->hideTimestring == false ) )
|
||||
{
|
||||
/* Add the opening '[' enclosing the timestring. */
|
||||
pLoggingBuffer[ bufferPosition ] = '[';
|
||||
bufferPosition++;
|
||||
|
||||
/* Generate the timestring and add it to the buffer. */
|
||||
if( IotClock_GetTimestring( pLoggingBuffer + bufferPosition,
|
||||
bufferSize - bufferPosition,
|
||||
×tringLength ) == true )
|
||||
{
|
||||
/* If the timestring was successfully generated, add the closing "]". */
|
||||
bufferPosition += timestringLength;
|
||||
pLoggingBuffer[ bufferPosition ] = ']';
|
||||
bufferPosition++;
|
||||
}
|
||||
else
|
||||
{
|
||||
/* Sufficient memory for a timestring should have been allocated. A timestring
|
||||
* probably failed to generate due to a clock read error; remove the opening '['
|
||||
* from the logging buffer. */
|
||||
bufferPosition--;
|
||||
pLoggingBuffer[ bufferPosition ] = '\0';
|
||||
}
|
||||
}
|
||||
|
||||
/* Add a padding space between the last closing ']' and the message, unless
|
||||
* the logging buffer is empty. */
|
||||
if( bufferPosition > 0 )
|
||||
{
|
||||
pLoggingBuffer[ bufferPosition ] = ' ';
|
||||
bufferPosition++;
|
||||
}
|
||||
|
||||
va_start( args, pFormat );
|
||||
|
||||
/* Add the log message to the logging buffer. */
|
||||
requiredMessageSize = vsnprintf( pLoggingBuffer + bufferPosition,
|
||||
bufferSize - bufferPosition,
|
||||
pFormat,
|
||||
args );
|
||||
|
||||
va_end( args );
|
||||
|
||||
/* If the logging buffer was too small to fit the log message, reallocate
|
||||
* a larger logging buffer. */
|
||||
if( ( size_t ) requiredMessageSize >= bufferSize - bufferPosition )
|
||||
{
|
||||
#if IOT_STATIC_MEMORY_ONLY == 1
|
||||
|
||||
/* There's no point trying to allocate a larger static buffer. Return
|
||||
* immediately. */
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
|
||||
return;
|
||||
#else
|
||||
if( _reallocLoggingBuffer( ( void ** ) &pLoggingBuffer,
|
||||
( size_t ) requiredMessageSize + bufferPosition + 1,
|
||||
bufferSize ) == false )
|
||||
{
|
||||
/* If buffer reallocation failed, return. */
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/* Reallocation successful, update buffer size. */
|
||||
bufferSize = ( size_t ) requiredMessageSize + bufferPosition + 1;
|
||||
|
||||
/* Add the log message to the buffer. Now that the buffer has been
|
||||
* reallocated, this should succeed. */
|
||||
va_start( args, pFormat );
|
||||
requiredMessageSize = vsnprintf( pLoggingBuffer + bufferPosition,
|
||||
bufferSize - bufferPosition,
|
||||
pFormat,
|
||||
args );
|
||||
va_end( args );
|
||||
#endif /* if IOT_STATIC_MEMORY_ONLY == 1 */
|
||||
}
|
||||
|
||||
/* Check for encoding errors. */
|
||||
if( requiredMessageSize <= 0 )
|
||||
{
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/* Print the logging buffer to stdout. */
|
||||
IotLogging_Puts( pLoggingBuffer );
|
||||
|
||||
/* Free the logging buffer. */
|
||||
IotLogging_Free( pLoggingBuffer );
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void IotLog_GenericPrintBuffer( const char * const pLibraryName,
|
||||
const char * const pHeader,
|
||||
const uint8_t * const pBuffer,
|
||||
size_t bufferSize )
|
||||
{
|
||||
size_t i = 0, offset = 0;
|
||||
|
||||
/* Allocate memory to hold each line of the log message. Since each byte
|
||||
* of pBuffer is printed in 4 characters (2 digits, a space, and a null-
|
||||
* terminator), the size of each line is 4 * BYTES_PER_LINE. */
|
||||
char * pMessageBuffer = IotLogging_Malloc( 4 * BYTES_PER_LINE );
|
||||
|
||||
/* Exit if no memory is available. */
|
||||
if( pMessageBuffer == NULL )
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
/* Print pHeader before printing pBuffer. */
|
||||
if( pHeader != NULL )
|
||||
{
|
||||
IotLog_Generic( IOT_LOG_DEBUG,
|
||||
pLibraryName,
|
||||
IOT_LOG_DEBUG,
|
||||
NULL,
|
||||
pHeader );
|
||||
}
|
||||
|
||||
/* Print each byte in pBuffer. */
|
||||
for( i = 0; i < bufferSize; i++ )
|
||||
{
|
||||
/* Print a line if BYTES_PER_LINE is reached. But don't print a line
|
||||
* at the beginning (when i=0). */
|
||||
if( ( i % BYTES_PER_LINE == 0 ) && ( i != 0 ) )
|
||||
{
|
||||
IotLogging_Puts( pMessageBuffer );
|
||||
|
||||
/* Reset offset so that pMessageBuffer is filled from the beginning. */
|
||||
offset = 0;
|
||||
}
|
||||
|
||||
/* Print a single byte into pMessageBuffer. */
|
||||
( void ) snprintf( pMessageBuffer + offset, 4, "%02x ", pBuffer[ i ] );
|
||||
|
||||
/* Move the offset where the next character is printed. */
|
||||
offset += 3;
|
||||
}
|
||||
|
||||
/* Print the final line of bytes. This line isn't printed by the for-loop above. */
|
||||
IotLogging_Puts( pMessageBuffer );
|
||||
|
||||
/* Free memory used by this function. */
|
||||
IotLogging_Free( pMessageBuffer );
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
|
@ -0,0 +1,250 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/* FreeRTOS includes. */
|
||||
#include "FreeRTOS.h"
|
||||
#include "task.h"
|
||||
#include "queue.h"
|
||||
|
||||
/* Logging includes. */
|
||||
#include "iot_logging_task.h"
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdio.h>
|
||||
#include <stdarg.h>
|
||||
#include <string.h>
|
||||
|
||||
/* Sanity check all the definitions required by this file are set. */
|
||||
#ifndef configPRINT_STRING
|
||||
#error configPRINT_STRING( x ) must be defined in FreeRTOSConfig.h to use this logging file. Set configPRINT_STRING( x ) to a function that outputs a string, where X is the string. For example, #define configPRINT_STRING( x ) MyUARTWriteString( X )
|
||||
#endif
|
||||
|
||||
#ifndef configLOGGING_MAX_MESSAGE_LENGTH
|
||||
#error configLOGGING_MAX_MESSAGE_LENGTH must be defined in FreeRTOSConfig.h to use this logging file. configLOGGING_MAX_MESSAGE_LENGTH sets the size of the buffer into which formatted text is written, so also sets the maximum log message length.
|
||||
#endif
|
||||
|
||||
#ifndef configLOGGING_INCLUDE_TIME_AND_TASK_NAME
|
||||
#error configLOGGING_INCLUDE_TIME_AND_TASK_NAME must be defined in FreeRTOSConfig.h to use this logging file. Set configLOGGING_INCLUDE_TIME_AND_TASK_NAME to 1 to prepend a time stamp, message number and the name of the calling task to each logged message. Otherwise set to 0.
|
||||
#endif
|
||||
|
||||
/* A block time of 0 just means don't block. */
|
||||
#define loggingDONT_BLOCK 0
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/*
|
||||
* The task that actually performs the print output. Using a separate task
|
||||
* enables the use of slow output, such as as a UART, without the task that is
|
||||
* outputting the log message having to wait for the message to be completely
|
||||
* written. Using a separate task also serializes access to the output port.
|
||||
*
|
||||
* The structure of this task is very simple; it blocks on a queue to wait for
|
||||
* a pointer to a string, sending any received strings to a macro that performs
|
||||
* the actual output. The macro is port specific, so implemented outside of
|
||||
* this file. This version uses dynamic memory, so the buffer that contained
|
||||
* the log message is freed after it has been output.
|
||||
*/
|
||||
static void prvLoggingTask( void * pvParameters );
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/*
|
||||
* The queue used to pass pointers to log messages from the task that created
|
||||
* the message to the task that will performs the output.
|
||||
*/
|
||||
static QueueHandle_t xQueue = NULL;
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
BaseType_t xLoggingTaskInitialize( uint16_t usStackSize,
|
||||
UBaseType_t uxPriority,
|
||||
UBaseType_t uxQueueLength )
|
||||
{
|
||||
BaseType_t xReturn = pdFAIL;
|
||||
|
||||
/* Ensure the logging task has not been created already. */
|
||||
if( xQueue == NULL )
|
||||
{
|
||||
/* Create the queue used to pass pointers to strings to the logging task. */
|
||||
xQueue = xQueueCreate( uxQueueLength, sizeof( char ** ) );
|
||||
|
||||
if( xQueue != NULL )
|
||||
{
|
||||
if( xTaskCreate( prvLoggingTask, "Logging", usStackSize, NULL, uxPriority, NULL ) == pdPASS )
|
||||
{
|
||||
xReturn = pdPASS;
|
||||
}
|
||||
else
|
||||
{
|
||||
/* Could not create the task, so delete the queue again. */
|
||||
vQueueDelete( xQueue );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return xReturn;
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static void prvLoggingTask( void * pvParameters )
|
||||
{
|
||||
char * pcReceivedString = NULL;
|
||||
|
||||
for( ; ; )
|
||||
{
|
||||
/* Block to wait for the next string to print. */
|
||||
if( xQueueReceive( xQueue, &pcReceivedString, portMAX_DELAY ) == pdPASS )
|
||||
{
|
||||
configPRINT_STRING( pcReceivedString );
|
||||
vPortFree( ( void * ) pcReceivedString );
|
||||
}
|
||||
}
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/*!
|
||||
* \brief Formats a string to be printed and sends it
|
||||
* to the print queue.
|
||||
*
|
||||
* Appends the message number, time (in ticks), and task
|
||||
* that called vLoggingPrintf to the beginning of each
|
||||
* print statement.
|
||||
*
|
||||
*/
|
||||
void vLoggingPrintf( const char * pcFormat,
|
||||
... )
|
||||
{
|
||||
size_t xLength = 0;
|
||||
int32_t xLength2 = 0;
|
||||
va_list args;
|
||||
char * pcPrintString = NULL;
|
||||
|
||||
/* The queue is created by xLoggingTaskInitialize(). Check
|
||||
* xLoggingTaskInitialize() has been called. */
|
||||
configASSERT( xQueue );
|
||||
|
||||
/* Allocate a buffer to hold the log message. */
|
||||
pcPrintString = pvPortMalloc( configLOGGING_MAX_MESSAGE_LENGTH );
|
||||
|
||||
if( pcPrintString != NULL )
|
||||
{
|
||||
/* There are a variable number of parameters. */
|
||||
va_start( args, pcFormat );
|
||||
|
||||
if( strcmp( pcFormat, "\n" ) != 0 )
|
||||
{
|
||||
#if ( configLOGGING_INCLUDE_TIME_AND_TASK_NAME == 1 )
|
||||
{
|
||||
const char * pcTaskName;
|
||||
const char * pcNoTask = "None";
|
||||
static BaseType_t xMessageNumber = 0;
|
||||
|
||||
/* Add a time stamp and the name of the calling task to the
|
||||
* start of the log. */
|
||||
if( xTaskGetSchedulerState() != taskSCHEDULER_NOT_STARTED )
|
||||
{
|
||||
pcTaskName = pcTaskGetName( NULL );
|
||||
}
|
||||
else
|
||||
{
|
||||
pcTaskName = pcNoTask;
|
||||
}
|
||||
|
||||
xLength = snprintf( pcPrintString, configLOGGING_MAX_MESSAGE_LENGTH, "%lu %lu [%s] ",
|
||||
( unsigned long ) xMessageNumber++,
|
||||
( unsigned long ) xTaskGetTickCount(),
|
||||
pcTaskName );
|
||||
}
|
||||
#else /* if ( configLOGGING_INCLUDE_TIME_AND_TASK_NAME == 1 ) */
|
||||
{
|
||||
xLength = 0;
|
||||
}
|
||||
#endif /* if ( configLOGGING_INCLUDE_TIME_AND_TASK_NAME == 1 ) */
|
||||
}
|
||||
|
||||
xLength2 = vsnprintf( pcPrintString + xLength, configLOGGING_MAX_MESSAGE_LENGTH - xLength, pcFormat, args );
|
||||
|
||||
if( xLength2 < 0 )
|
||||
{
|
||||
/* vsnprintf() failed. Restore the terminating NULL
|
||||
* character of the first part. Note that the first
|
||||
* part of the buffer may be empty if the value of
|
||||
* configLOGGING_INCLUDE_TIME_AND_TASK_NAME is not
|
||||
* 1 and as a result, the whole buffer may be empty.
|
||||
* That's the reason we have a check for xLength > 0
|
||||
* before sending the buffer to the logging task.
|
||||
*/
|
||||
xLength2 = 0;
|
||||
pcPrintString[ xLength ] = '\0';
|
||||
}
|
||||
|
||||
xLength += ( size_t ) xLength2;
|
||||
va_end( args );
|
||||
|
||||
/* Only send the buffer to the logging task if it is
|
||||
* not empty. */
|
||||
if( xLength > 0 )
|
||||
{
|
||||
/* Send the string to the logging task for IO. */
|
||||
if( xQueueSend( xQueue, &pcPrintString, loggingDONT_BLOCK ) != pdPASS )
|
||||
{
|
||||
/* The buffer was not sent so must be freed again. */
|
||||
vPortFree( ( void * ) pcPrintString );
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
/* The buffer was not sent, so it must be
|
||||
* freed. */
|
||||
vPortFree( ( void * ) pcPrintString );
|
||||
}
|
||||
}
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void vLoggingPrint( const char * pcMessage )
|
||||
{
|
||||
char * pcPrintString = NULL;
|
||||
size_t xLength = 0;
|
||||
|
||||
/* The queue is created by xLoggingTaskInitialize(). Check
|
||||
* xLoggingTaskInitialize() has been called. */
|
||||
configASSERT( xQueue );
|
||||
|
||||
xLength = strlen( pcMessage ) + 1;
|
||||
pcPrintString = pvPortMalloc( xLength );
|
||||
|
||||
if( pcPrintString != NULL )
|
||||
{
|
||||
strncpy( pcPrintString, pcMessage, xLength );
|
||||
|
||||
/* Send the string to the logging task for IO. */
|
||||
if( xQueueSend( xQueue, &pcPrintString, loggingDONT_BLOCK ) != pdPASS )
|
||||
{
|
||||
/* The buffer was not sent so must be freed again. */
|
||||
vPortFree( ( void * ) pcPrintString );
|
||||
}
|
||||
}
|
||||
}
|
||||
File diff suppressed because it is too large
Load diff
|
|
@ -0,0 +1,175 @@
|
|||
/*
|
||||
* Amazon FreeRTOS Common V1.0.0
|
||||
* Copyright (C) 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*
|
||||
* http://aws.amazon.com/freertos
|
||||
* http://www.FreeRTOS.org
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file iot_taskpool_static_memory.c
|
||||
* @brief Implementation of task pool static memory functions.
|
||||
*/
|
||||
|
||||
/* The config header is always included first. */
|
||||
#include "iot_config.h"
|
||||
|
||||
/* This file should only be compiled if dynamic memory allocation is forbidden. */
|
||||
#if IOT_STATIC_MEMORY_ONLY == 1
|
||||
|
||||
/* Standard includes. */
|
||||
#include <stdbool.h>
|
||||
#include <stddef.h>
|
||||
#include <string.h>
|
||||
|
||||
/* Static memory include. */
|
||||
#include "private/iot_static_memory.h"
|
||||
|
||||
/* Task pool internal include. */
|
||||
#include "private/iot_taskpool_internal.h"
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/* Validate static memory configuration settings. */
|
||||
#if IOT_TASKPOOL_JOBS_RECYCLE_LIMIT <= 0
|
||||
#error "IOT_TASKPOOL_JOBS_RECYCLE_LIMIT cannot be 0 or negative."
|
||||
#endif
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
/*
|
||||
* Static memory buffers and flags, allocated and zeroed at compile-time.
|
||||
*/
|
||||
static bool _pInUseTaskPools[ IOT_TASKPOOLS ] = { 0 }; /**< @brief Task pools in-use flags. */
|
||||
static _taskPool_t _pTaskPools[ IOT_TASKPOOLS ] = { { .dispatchQueue = IOT_DEQUEUE_INITIALIZER } }; /**< @brief Task pools. */
|
||||
|
||||
static bool _pInUseTaskPoolJobs[ IOT_TASKPOOL_JOBS_RECYCLE_LIMIT ] = { 0 }; /**< @brief Task pool jobs in-use flags. */
|
||||
static _taskPoolJob_t _pTaskPoolJobs[ IOT_TASKPOOL_JOBS_RECYCLE_LIMIT ] = { { .link = IOT_LINK_INITIALIZER } }; /**< @brief Task pool jobs. */
|
||||
|
||||
static bool _pInUseTaskPoolTimerEvents[ IOT_TASKPOOL_JOBS_RECYCLE_LIMIT ] = { 0 }; /**< @brief Task pool timer event in-use flags. */
|
||||
static _taskPoolTimerEvent_t _pTaskPoolTimerEvents[ IOT_TASKPOOL_JOBS_RECYCLE_LIMIT ] = { { .link = { 0 } } }; /**< @brief Task pool timer events. */
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void * IotTaskPool_MallocTaskPool( size_t size )
|
||||
{
|
||||
int freeIndex = -1;
|
||||
void * pNewTaskPool = NULL;
|
||||
|
||||
/* Check size argument. */
|
||||
if( size == sizeof( _taskPool_t ) )
|
||||
{
|
||||
/* Find a free task pool job. */
|
||||
freeIndex = IotStaticMemory_FindFree( _pInUseTaskPools, IOT_TASKPOOLS );
|
||||
|
||||
if( freeIndex != -1 )
|
||||
{
|
||||
pNewTaskPool = &( _pTaskPools[ freeIndex ] );
|
||||
}
|
||||
}
|
||||
|
||||
return pNewTaskPool;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void IotTaskPool_FreeTaskPool( void * ptr )
|
||||
{
|
||||
/* Return the in-use task pool job. */
|
||||
IotStaticMemory_ReturnInUse( ptr,
|
||||
_pTaskPools,
|
||||
_pInUseTaskPools,
|
||||
IOT_TASKPOOLS,
|
||||
sizeof( _taskPool_t ) );
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void * IotTaskPool_MallocJob( size_t size )
|
||||
{
|
||||
int32_t freeIndex = -1;
|
||||
void * pNewJob = NULL;
|
||||
|
||||
/* Check size argument. */
|
||||
if( size == sizeof( _taskPoolJob_t ) )
|
||||
{
|
||||
/* Find a free task pool job. */
|
||||
freeIndex = IotStaticMemory_FindFree( _pInUseTaskPoolJobs,
|
||||
IOT_TASKPOOL_JOBS_RECYCLE_LIMIT );
|
||||
|
||||
if( freeIndex != -1 )
|
||||
{
|
||||
pNewJob = &( _pTaskPoolJobs[ freeIndex ] );
|
||||
}
|
||||
}
|
||||
|
||||
return pNewJob;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void IotTaskPool_FreeJob( void * ptr )
|
||||
{
|
||||
/* Return the in-use task pool job. */
|
||||
IotStaticMemory_ReturnInUse( ptr,
|
||||
_pTaskPoolJobs,
|
||||
_pInUseTaskPoolJobs,
|
||||
IOT_TASKPOOL_JOBS_RECYCLE_LIMIT,
|
||||
sizeof( _taskPoolJob_t ) );
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void * IotTaskPool_MallocTimerEvent( size_t size )
|
||||
{
|
||||
int32_t freeIndex = -1;
|
||||
void * pNewTimerEvent = NULL;
|
||||
|
||||
/* Check size argument. */
|
||||
if( size == sizeof( _taskPoolTimerEvent_t ) )
|
||||
{
|
||||
/* Find a free task pool timer event. */
|
||||
freeIndex = IotStaticMemory_FindFree( _pInUseTaskPoolTimerEvents,
|
||||
IOT_TASKPOOL_JOBS_RECYCLE_LIMIT );
|
||||
|
||||
if( freeIndex != -1 )
|
||||
{
|
||||
pNewTimerEvent = &( _pTaskPoolTimerEvents[ freeIndex ] );
|
||||
}
|
||||
}
|
||||
|
||||
return pNewTimerEvent;
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void IotTaskPool_FreeTimerEvent( void * ptr )
|
||||
{
|
||||
/* Return the in-use task pool timer event. */
|
||||
IotStaticMemory_ReturnInUse( ptr,
|
||||
_pTaskPoolTimerEvents,
|
||||
_pInUseTaskPoolTimerEvents,
|
||||
IOT_TASKPOOL_JOBS_RECYCLE_LIMIT,
|
||||
sizeof( _taskPoolTimerEvent_t ) );
|
||||
}
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
#endif
|
||||
Loading…
Add table
Add a link
Reference in a new issue