32#ifndef __STATEOS_BOX_H
33#define __STATEOS_BOX_H
48typedef struct __box box_t;
63typedef struct __box box_id [];
82#define _BOX_INIT( _limit, _size, _data ) { _OBJ_INIT(), 0, _limit * _size, _size, 0, 0, _data }
101#define _BOX_DATA( _limit, _size ) (char[_limit * _size]){ 0 }
112#define OS_BOX_BUFFER( buf, limit, size ) \
113 char buf[limit * size]
123#define OS_BOX( box, limit, size ) \
124 static char box##__buf[limit * size]; \
125 box_t box[] = { _BOX_INIT( limit, size, box##__buf ) }
128#define static_BOX( box, limit, size ) \
129 static char box##__buf[limit * size]; \
130 static box_t box[] = { _BOX_INIT( limit, size, box##__buf ) }
144#define BOX_INIT( limit, size ) \
145 _BOX_INIT( limit, size, _BOX_DATA( limit, size ) )
160#define BOX_CREATE( limit, size ) \
161 { BOX_INIT ( limit, size ) }
182void box_init( box_t *box,
size_t size,
void *
data,
size_t bufsize );
196box_t *
box_create(
unsigned limit,
size_t size );
492size_t box_size( box_t *box ) {
return box->size; }
504#if defined(__cplusplus) && (__cplusplus >= 201103L) && !defined(__STATEOS_STDCXX)
515template<
unsigned limit_,
size_t size_>
527 assert(_src.__box::count == 0 && _src.obj.queue ==
nullptr);
570#if __cplusplus >= 201402L
571 using Ptr = std::unique_ptr<MailBoxQueueT<limit_, size_>>;
593 box->__box::obj.res = box;
598 char data_[limit_ * size_];
609template<
unsigned limit_,
class C>
616#if __cplusplus >= 201402L
617 using Ptr = std::unique_ptr<MailBoxQueueTT<limit_, C>>;
639 box->__box::obj.res = box;
#define INFINITE
infinite waiting
Definition osbase.h:261
int box_giveAsync(box_t *box, const void *data)
Async alias of box_give().
int box_take(box_t *box, void *data)
try to transfer mailbox data from the mailbox queue object, don't wait if the mailbox queue object is...
void box_kill(box_t *box)
alias of box_reset()
Definition osmailboxqueue.h:213
int box_send(box_t *box, const void *data)
try to transfer mailbox data to the mailbox queue object, wait indefinitely while the mailbox queue o...
Definition osmailboxqueue.h:404
void box_destroy(box_t *box)
reset the mailbox queue object, wake up all waiting tasks with 'E_DELETED' event value and free alloc...
int box_takeISR(box_t *box, void *data)
ISR alias of box_take().
Definition osmailboxqueue.h:252
size_t box_size(box_t *box)
return size of a single mail
Definition osmailboxqueue.h:491
unsigned box_limit(box_t *box)
return the size of the mailbox queue
int box_takeAsync(box_t *box, void *data)
Async alias of box_take().
unsigned box_spaceISR(box_t *box)
ISR alias of box_space().
Definition osmailboxqueue.h:460
unsigned box_limitISR(box_t *box)
ISR alias of box_limit().
Definition osmailboxqueue.h:477
int box_sendFor(box_t *box, const void *data, cnt_t delay)
try to transfer mailbox data to the mailbox queue object, wait for given duration of time while the m...
void box_delete(box_t *box)
alias of box_destroy()
Definition osmailboxqueue.h:227
unsigned box_count(box_t *box)
return the amount of data contained in the mailbox queue
void box_init(box_t *box, size_t size, void *data, size_t bufsize)
initialize a mailbox queue object
int box_giveISR(box_t *box, const void *data)
ISR alias of box_give().
Definition osmailboxqueue.h:341
int box_sendUntil(box_t *box, const void *data, cnt_t time)
try to transfer mailbox data to the mailbox queue object, wait until given timepoint while the mailbo...
size_t box_sizeISR(box_t *box)
ISR alias of box_size().
Definition osmailboxqueue.h:495
int box_tryWait(box_t *box, void *data)
alias of box_take()
Definition osmailboxqueue.h:248
int box_give(box_t *box, const void *data)
try to transfer mailbox data to the mailbox queue object, don't wait if the mailbox queue object is f...
int box_wait(box_t *box, void *data)
try to transfer mailbox data from the mailbox queue object, wait indefinitely while the mailbox queue...
Definition osmailboxqueue.h:315
box_t * box_create(unsigned limit, size_t size)
create and initialize a new mailbox queue object
void box_pushISR(box_t *box, const void *data)
ISR alias of box_push().
Definition osmailboxqueue.h:426
unsigned box_countISR(box_t *box)
ISR alias of box_count().
Definition osmailboxqueue.h:443
unsigned box_space(box_t *box)
return the amount of free space in the mailbox queue
box_t * box_new(unsigned limit, size_t size)
alias of box_create()
Definition osmailboxqueue.h:199
void box_push(box_t *box, const void *data)
transfer mailbox data to the mailbox queue object, remove the oldest mailbox data if the mailbox queu...
int box_waitUntil(box_t *box, void *data, cnt_t time)
try to transfer mailbox data from the mailbox queue object, wait until given timepoint while the mail...
int box_sendAsync(box_t *box, const void *data)
Async alias of box_send().
void box_reset(box_t *box)
reset the mailbox queue object and wake up all waiting tasks with 'E_STOPPED' event value
int box_waitFor(box_t *box, void *data, cnt_t delay)
try to transfer mailbox data from the mailbox queue object, wait for given duration of time while the...
int box_waitAsync(box_t *box, void *data)
Async alias of box_wait().
char data[]
message data
Definition osmessagequeue.h:54
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
static Ptr Create()
create dynamic object with manageable resources
Definition osmailboxqueue.h:634
constexpr MailBoxQueueTT()
constructor, see the constructor parameters of the class
Definition osmailboxqueue.h:613
std::unique_ptr< MailBoxQueueTT< limit_, C > > Ptr
result type of Create()
Definition osmailboxqueue.h:616
create and initialize a mailbox queue object
Definition osmailboxqueue.h:516
int waitFor(void *_data, const T &_delay)
box_waitFor()
Definition osmailboxqueue.h:541
int takeISR(void *_data)
box_takeISR()
Definition osmailboxqueue.h:539
unsigned count()
box_count()
Definition osmailboxqueue.h:554
unsigned limit()
box_limit()
Definition osmailboxqueue.h:558
void kill()
box_kill()
Definition osmailboxqueue.h:535
int take(void *_data)
box_take()
Definition osmailboxqueue.h:537
int giveAsync(const void *_data)
box_giveAsync()
Definition osmailboxqueue.h:565
unsigned limitISR()
box_limitISR()
Definition osmailboxqueue.h:559
void destroy()
box_destroy()
Definition osmailboxqueue.h:536
void push(const void *_data)
box_push()
Definition osmailboxqueue.h:552
int takeAsync(void *_data)
box_takeAsync()
Definition osmailboxqueue.h:563
int wait(void *_data)
box_wait()
Definition osmailboxqueue.h:544
unsigned countISR()
box_countISR()
Definition osmailboxqueue.h:555
size_t sizeISR()
box_sizeISR()
Definition osmailboxqueue.h:561
unsigned spaceISR()
box_spaceISR()
Definition osmailboxqueue.h:557
int sendAsync(const void *_data)
box_sendAsync()
Definition osmailboxqueue.h:566
int sendUntil(const void *_data, const T &_time)
box_sendUntil()
Definition osmailboxqueue.h:550
std::unique_ptr< MailBoxQueueT< limit_, size_ > > Ptr
result type of Create()
Definition osmailboxqueue.h:570
int waitAsync(void *_data)
box_waitAsync()
Definition osmailboxqueue.h:564
int waitUntil(void *_data, const T &_time)
box_waitUntil()
Definition osmailboxqueue.h:543
static Ptr Create()
create dynamic object with manageable resources
Definition osmailboxqueue.h:588
int send(const void *_data)
box_send()
Definition osmailboxqueue.h:551
int sendFor(const void *_data, const T &_delay)
box_sendFor()
Definition osmailboxqueue.h:548
constexpr MailBoxQueueT()
constructor, see the constructor parameters of the class
Definition osmailboxqueue.h:519
size_t size()
box_size()
Definition osmailboxqueue.h:560
int giveISR(const void *_data)
box_giveISR()
Definition osmailboxqueue.h:546
unsigned space()
box_space()
Definition osmailboxqueue.h:556
int give(const void *_data)
box_give()
Definition osmailboxqueue.h:545
void reset()
box_reset()
Definition osmailboxqueue.h:534
int tryWait(void *_data)
box_tryWait()
Definition osmailboxqueue.h:538
void pushISR(const void *_data)
box_pushISR()
Definition osmailboxqueue.h:553