32#ifndef __STATEOS_FLG_H
33#define __STATEOS_FLG_H
50#define flgAnyNew ( flgAny | flgNew )
51#define flgAllNew ( flgAll | flgNew )
57typedef struct __flg flg_t;
66typedef struct __flg flg_id [];
83#define _FLG_INIT( _init ) { _OBJ_INIT(), _init }
95#define _VA_FLG( _init ) ( _init + 0 )
104#define OS_FLG( flg, ... ) \
105 flg_t flg[] = { _FLG_INIT( _VA_FLG(__VA_ARGS__) ) }
108#define static_FLG( flg, ... ) \
109 static flg_t flg[] = { _FLG_INIT( _VA_FLG(__VA_ARGS__) ) }
122#define FLG_INIT( ... ) \
123 _FLG_INIT( _VA_FLG(__VA_ARGS__) )
137#define FLG_CREATE( ... ) \
138 { FLG_INIT ( _VA_FLG(__VA_ARGS__) ) }
157void flg_init( flg_t *flg,
unsigned init );
222unsigned flg_take( flg_t *flg,
unsigned flags,
unsigned mode );
226unsigned flg_tryWait( flg_t *flg,
unsigned flags,
unsigned mode ) {
return flg_take(flg, flags, mode); }
230unsigned flg_takeISR( flg_t *flg,
unsigned flags,
unsigned mode ) {
return flg_take(flg, flags, mode); }
254int flg_waitFor( flg_t *flg,
unsigned flags,
unsigned mode, cnt_t delay );
276int flg_waitUntil( flg_t *flg,
unsigned flags,
unsigned mode, cnt_t time );
311unsigned flg_give( flg_t *flg,
unsigned flags );
315unsigned flg_set( flg_t *flg,
unsigned flags ) {
return flg_give(flg, flags); }
333unsigned flg_clear( flg_t *flg,
unsigned flags );
362#if defined(__cplusplus) && (__cplusplus >= 201103L) && !defined(__STATEOS_STDCXX)
372struct Flag :
public __flg
376 Flag(
const unsigned _init = 0 ): __flg _FLG_INIT(_init) {}
378 ~Flag() { assert(__flg::obj.queue ==
nullptr); }
383 assert(_src.obj.queue ==
nullptr);
388 Flag& operator=(
const Flag& ) =
delete;
393 unsigned take (
unsigned _flags,
unsigned _mode =
flgAll ) {
return flg_take (
this, _flags, _mode); }
402 unsigned set (
unsigned _flags ) {
return flg_set (
this, _flags); }
409#if __cplusplus >= 201402L
410 using Ptr = std::unique_ptr<Flag>;
428 auto flg =
new (std::nothrow)
Flag(_init);
430 flg->__flg::obj.res = flg;
#define INFINITE
infinite waiting
Definition osbase.h:261
unsigned flg_tryWait(flg_t *flg, unsigned flags, unsigned mode)
alias of flg_take()
Definition osflag.h:225
void flg_delete(flg_t *flg)
alias of flg_destroy()
Definition osflag.h:201
unsigned flg_set(flg_t *flg, unsigned flags)
alias of flg_give()
Definition osflag.h:314
void flg_kill(flg_t *flg)
alias of flg_reset()
Definition osflag.h:187
unsigned flg_takeISR(flg_t *flg, unsigned flags, unsigned mode)
ISR alias of flg_take().
Definition osflag.h:229
unsigned flg_take(flg_t *flg, unsigned flags, unsigned mode)
check if required flags have been set in the flag object
unsigned flg_getISR(flg_t *flg)
ISR alias of flg_get().
Definition osflag.h:353
unsigned flg_get(flg_t *flg)
get current flags from flag object
unsigned flg_give(flg_t *flg, unsigned flags)
set given flags in flag object
unsigned flg_giveISR(flg_t *flg, unsigned flags)
ISR alias of flg_give().
Definition osflag.h:318
unsigned flg_clear(flg_t *flg, unsigned flags)
clear given flags in flag object
flg_t * flg_create(unsigned init)
create and initialize a new flag object
void flg_reset(flg_t *flg)
reset the flag object and wake up all waiting tasks with 'E_STOPPED' event value
flg_t * flg_new(unsigned init)
alias of flg_create()
Definition osflag.h:173
#define flgAll
wait for all flags to be set
Definition osflag.h:47
void flg_init(flg_t *flg, unsigned init)
initialize a flag object
void flg_destroy(flg_t *flg)
reset the flag object, wake up all waiting tasks with 'E_DELETED' event value and free allocated reso...
int flg_waitFor(flg_t *flg, unsigned flags, unsigned mode, cnt_t delay)
wait on flag object for given flags for given duration of time
int flg_waitUntil(flg_t *flg, unsigned flags, unsigned mode, cnt_t time)
wait on flag object for given flags until given timepoint
unsigned flg_clearISR(flg_t *flg, unsigned flags)
ISR alias of flg_clear().
Definition osflag.h:336
int flg_wait(flg_t *flg, unsigned flags, unsigned mode)
wait indefinitely on flag object until required flags have been set
Definition osflag.h:296
static constexpr rep count(const std::chrono::duration< _Rep, _Period > &_delay)
delay in ticks, rounded up to whole ticks; negative delay: IMMEDIATE, delay out of range: INFINITE
Definition osclock.h:109
static constexpr rep until(const std::chrono::time_point< Clock, _Duration > &_time)
time point in ticks, rounded up to whole ticks (only a time point of this clock)
Definition osclock.h:116
create and initialize a flag object
Definition osflag.h:372
unsigned tryWait(unsigned _flags, unsigned _mode=flgAll)
flg_tryWait()
Definition osflag.h:393
int waitFor(unsigned _flags, unsigned _mode, const T &_delay)
flg_waitFor()
Definition osflag.h:396
unsigned set(unsigned _flags)
flg_set()
Definition osflag.h:401
void reset()
flg_reset()
Definition osflag.h:389
unsigned takeISR(unsigned _flags, unsigned _mode=flgAll)
flg_takeISR()
Definition osflag.h:394
void destroy()
flg_destroy()
Definition osflag.h:391
constexpr Flag(const unsigned _init=0)
constructor, see the constructor parameters of the class
Definition osflag.h:375
unsigned give(unsigned _flags)
flg_give()
Definition osflag.h:400
std::unique_ptr< Flag > Ptr
result type of Create()
Definition osflag.h:409
unsigned giveISR(unsigned _flags)
flg_giveISR()
Definition osflag.h:402
unsigned getISR()
flg_getISR()
Definition osflag.h:406
void kill()
flg_kill()
Definition osflag.h:390
static Ptr Create(const unsigned _init=0)
create dynamic object with manageable resources
Definition osflag.h:425
unsigned take(unsigned _flags, unsigned _mode=flgAll)
flg_take()
Definition osflag.h:392
unsigned get()
flg_get()
Definition osflag.h:405
int waitUntil(unsigned _flags, unsigned _mode, const T &_time)
flg_waitUntil()
Definition osflag.h:398
unsigned clearISR(unsigned _flags)
flg_clearISR()
Definition osflag.h:404
int wait(unsigned _flags, unsigned _mode=flgAll)
flg_wait()
Definition osflag.h:399
unsigned clear(unsigned _flags)
flg_clear()
Definition osflag.h:403