doc: renamed project
This commit is contained in:
SylvanArnold
committed by
Sylvan Arnold
Sylvan Arnold
parent
244e516bd8
commit
32618389d1
283
pico-sensor/McuLib/src/McuTimeout.c
Normal file
283
pico-sensor/McuLib/src/McuTimeout.c
Normal file
@@ -0,0 +1,283 @@
|
||||
/* ###################################################################
|
||||
** This component module is generated by Processor Expert. Do not modify it.
|
||||
** Filename : McuTimeout.h
|
||||
** Project : FRDM-K64F_Generator
|
||||
** Processor : MK64FN1M0VLL12
|
||||
** Component : Timeout
|
||||
** Version : Component 01.038, Driver 01.00, CPU db: 3.00.000
|
||||
** Compiler : GNU C Compiler
|
||||
** Date/Time : 2020-08-14, 06:24, # CodeGen: 679
|
||||
** Abstract :
|
||||
**
|
||||
The module implements timeout functionality. With this implementation,
|
||||
it is possible to wait for a given time, and the time is counted by
|
||||
a periodic interrupt.
|
||||
** Settings :
|
||||
** Component name : McuTimeout
|
||||
** Maximum counters : 1
|
||||
** Counter tick period (ms) : 10
|
||||
** RTOS : Disabled
|
||||
** Contents :
|
||||
** GetCounter - McuTimeout_CounterHandle McuTimeout_GetCounter(McuTimeout_CounterType nofTicks);
|
||||
** LeaveCounter - void McuTimeout_LeaveCounter(McuTimeout_CounterHandle handle);
|
||||
** Value - McuTimeout_CounterType McuTimeout_Value(McuTimeout_CounterHandle handle);
|
||||
** SetCounter - McuTimeout_CounterType McuTimeout_SetCounter(McuTimeout_CounterHandle handle,...
|
||||
** CounterExpired - bool McuTimeout_CounterExpired(McuTimeout_CounterHandle handle);
|
||||
** AddTick - void McuTimeout_AddTick(void);
|
||||
** Init - void McuTimeout_Init(void);
|
||||
**
|
||||
** * Copyright (c) 2011-2020, Erich Styger
|
||||
** * Web: https://mcuoneclipse.com
|
||||
** * SourceForge: https://sourceforge.net/projects/mcuoneclipse
|
||||
** * Git: https://github.com/ErichStyger/McuOnEclipse_PEx
|
||||
** * All rights reserved.
|
||||
** *
|
||||
** * Redistribution and use in source and binary forms, with or without modification,
|
||||
** * are permitted provided that the following conditions are met:
|
||||
** *
|
||||
** * - Redistributions of source code must retain the above copyright notice, this list
|
||||
** * of conditions and the following disclaimer.
|
||||
** *
|
||||
** * - Redistributions in binary form must reproduce the above copyright notice, this
|
||||
** * list of conditions and the following disclaimer in the documentation and/or
|
||||
** * other materials provided with the distribution.
|
||||
** *
|
||||
** * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
||||
** * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
||||
** * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
** * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
|
||||
** * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
** * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||
** * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
|
||||
** * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
** * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
||||
** * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
** ###################################################################*/
|
||||
/*!
|
||||
** @file McuTimeout.h
|
||||
** @version 01.00
|
||||
** @brief
|
||||
**
|
||||
The module implements timeout functionality. With this implementation,
|
||||
it is possible to wait for a given time, and the time is counted by
|
||||
a periodic interrupt.
|
||||
*/
|
||||
/*!
|
||||
** @addtogroup McuTimeout_module McuTimeout module documentation
|
||||
** @{
|
||||
*/
|
||||
|
||||
/* MODULE McuTimeout. */
|
||||
|
||||
#include "McuTimeout.h"
|
||||
|
||||
#define McuTimeout_NOF_COUNTERS 1 /* number of timeout counters available */
|
||||
|
||||
static McuTimeout_CounterType McuTimeout_Counters[McuTimeout_NOF_COUNTERS]; /* array of timeout counters */
|
||||
static bool McuTimeout_FreeCounters[McuTimeout_NOF_COUNTERS]; /* array to indicate which counters are free */
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : GetCounter (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Initializes a new timeout counter and returns the handle to
|
||||
** it. At the end, use LeaveCounter() to free up the resource.
|
||||
** Parameters :
|
||||
** NAME - DESCRIPTION
|
||||
** nofTicks - Number of ticks for the counter
|
||||
** until it expires.
|
||||
** Returns :
|
||||
** --- - Handle to the counter, to be used for
|
||||
** further API calls.
|
||||
** ===================================================================
|
||||
*/
|
||||
McuTimeout_CounterHandle McuTimeout_GetCounter(McuTimeout_CounterType nofTicks)
|
||||
{
|
||||
McuTimeout_CounterHandle handle;
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
handle = 0;
|
||||
if (nofTicks==0) {
|
||||
nofTicks = 1; /* wait at least for one tick, otherwise will timeout immediately */
|
||||
}
|
||||
McuCriticalSection_EnterCritical();
|
||||
while (handle<McuTimeout_NOF_COUNTERS && !McuTimeout_FreeCounters[handle]) {
|
||||
handle++;
|
||||
}
|
||||
if (handle<McuTimeout_NOF_COUNTERS) {
|
||||
McuTimeout_FreeCounters[handle]=FALSE;
|
||||
McuTimeout_Counters[handle] = nofTicks;
|
||||
}
|
||||
McuCriticalSection_ExitCritical();
|
||||
if (handle==McuTimeout_NOF_COUNTERS) {
|
||||
return McuTimeout_OUT_OF_HANDLE;
|
||||
}
|
||||
return handle;
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : LeaveCounter (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** To be called to return the counter. Note that a counter
|
||||
** always should be returned so it can be reused.
|
||||
** Parameters :
|
||||
** NAME - DESCRIPTION
|
||||
** handle - Counter handle
|
||||
** Returns : Nothing
|
||||
** ===================================================================
|
||||
*/
|
||||
void McuTimeout_LeaveCounter(McuTimeout_CounterHandle handle)
|
||||
{
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
if (handle==McuTimeout_OUT_OF_HANDLE) {
|
||||
return;
|
||||
}
|
||||
McuCriticalSection_EnterCritical();
|
||||
McuTimeout_Counters[handle] = 0;
|
||||
McuTimeout_FreeCounters[handle]=TRUE;
|
||||
McuCriticalSection_ExitCritical();
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : CounterExpired (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Returns true if the timeout counter has been expired
|
||||
** Parameters :
|
||||
** NAME - DESCRIPTION
|
||||
** handle - The timeout handle retrieved using
|
||||
** GetCounter()
|
||||
** Returns :
|
||||
** --- - Returns TRUE if the counter has been
|
||||
** expired, FALSE otherwise
|
||||
** ===================================================================
|
||||
*/
|
||||
bool McuTimeout_CounterExpired(McuTimeout_CounterHandle handle)
|
||||
{
|
||||
bool res;
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
if (handle==McuTimeout_OUT_OF_HANDLE) {
|
||||
return TRUE;
|
||||
}
|
||||
McuCriticalSection_EnterCritical();
|
||||
res = (bool)(McuTimeout_Counters[handle]==0);
|
||||
McuCriticalSection_ExitCritical();
|
||||
return res;
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : AddTick (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Method to be called from a periodic timer or interrupt. It
|
||||
** will decrement all current counters by one down to zero.
|
||||
** Parameters : None
|
||||
** Returns : Nothing
|
||||
** ===================================================================
|
||||
*/
|
||||
void McuTimeout_AddTick(void)
|
||||
{
|
||||
uint8_t i;
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
McuCriticalSection_EnterCritical();
|
||||
for(i=0;i<McuTimeout_NOF_COUNTERS;i++) {
|
||||
if (McuTimeout_Counters[i]>0) {
|
||||
McuTimeout_Counters[i]--;
|
||||
}
|
||||
}
|
||||
McuCriticalSection_ExitCritical();
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : Init (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Initialization of the driver
|
||||
** Parameters : None
|
||||
** Returns : Nothing
|
||||
** ===================================================================
|
||||
*/
|
||||
void McuTimeout_Init(void)
|
||||
{
|
||||
uint8_t i;
|
||||
|
||||
for(i=0;i<McuTimeout_NOF_COUNTERS;i++) {
|
||||
McuTimeout_Counters[i] = 0;
|
||||
McuTimeout_FreeCounters[i] = TRUE;
|
||||
}
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : Value (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Return the current value of the counter (in ticks)
|
||||
** Parameters :
|
||||
** NAME - DESCRIPTION
|
||||
** handle - Handle of the timeout counter
|
||||
** Returns :
|
||||
** --- - Returns the value of the timeout counter.
|
||||
** ===================================================================
|
||||
*/
|
||||
McuTimeout_CounterType McuTimeout_Value(McuTimeout_CounterHandle handle)
|
||||
{
|
||||
McuTimeout_CounterType val;
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
if (handle==McuTimeout_OUT_OF_HANDLE) {
|
||||
return 0; /* return dummy value */
|
||||
}
|
||||
McuCriticalSection_EnterCritical();
|
||||
val = McuTimeout_Counters[handle];
|
||||
McuCriticalSection_ExitCritical();
|
||||
return val;
|
||||
}
|
||||
|
||||
/*
|
||||
** ===================================================================
|
||||
** Method : SetCounter (component Timeout)
|
||||
**
|
||||
** Description :
|
||||
** Sets the counter to a new value and returns the value just
|
||||
** prior to the call.
|
||||
** Parameters :
|
||||
** NAME - DESCRIPTION
|
||||
** handle - Counter handle which shall get a new
|
||||
** value.
|
||||
** nofTicks - New value (tick count) of the
|
||||
** timeout counter. Pass zero to have it
|
||||
** expire immediately.
|
||||
** Returns :
|
||||
** --- - Value of counter before reset.
|
||||
** ===================================================================
|
||||
*/
|
||||
McuTimeout_CounterType McuTimeout_SetCounter(McuTimeout_CounterHandle handle, McuTimeout_CounterType nofTicks)
|
||||
{
|
||||
McuTimeout_CounterType res;
|
||||
McuCriticalSection_CriticalVariable();
|
||||
|
||||
if (handle==McuTimeout_OUT_OF_HANDLE) {
|
||||
return 0; /* return dummy value */
|
||||
}
|
||||
McuCriticalSection_EnterCritical();
|
||||
res = McuTimeout_Counters[handle];
|
||||
McuTimeout_Counters[handle] = nofTicks;
|
||||
McuCriticalSection_ExitCritical();
|
||||
return res;
|
||||
}
|
||||
|
||||
/* END McuTimeout. */
|
||||
|
||||
/*!
|
||||
** @}
|
||||
*/
|
||||
Reference in New Issue
Block a user