Detailed Description

Event group.

An event group has an internal variable (of type unsigned int), which is interpreted as a bit pattern where each bit represents an event. An event group also has a wait queue for the tasks waiting on these events. A task may set specified bits when an event occurs and may clear specified bits when necessary.

The tasks waiting for an event(s) are placed in the event group's wait queue. An event group is a very suitable synchronization object for cases where (for some reasons) one task has to wait for many tasks, or vice versa, many tasks have to wait for one task.

Definition in file tn_eventgrp.h.

Go to the source code of this file.

Data Structures
struct	TN_EventGrp
	Event group. More...

struct	TN_EGrpTaskWait
	EventGrp-specific fields related to waiting task, to be included in struct TN_Task. More...

Enumerations
enum	TN_EGrpWaitMode { TN_EVENTGRP_WMODE_OR = (1 << 0), TN_EVENTGRP_WMODE_AND = (1 << 1) }
	Events waiting mode: wait for all flags to be set or just for any of the specified flags to be set. More...

enum	TN_EGrpOp { TN_EVENTGRP_OP_SET, TN_EVENTGRP_OP_CLEAR, TN_EVENTGRP_OP_TOGGLE }
	Modify operation: set, clear or toggle. More...

Functions
enum TN_RCode	tn_eventgrp_create (struct TN_EventGrp *eventgrp, unsigned int initial_pattern)
	Construct event group. More...

enum TN_RCode	tn_eventgrp_delete (struct TN_EventGrp *eventgrp)
	Destruct event group. More...

enum TN_RCode	tn_eventgrp_wait (struct TN_EventGrp eventgrp, unsigned int wait_pattern, enum TN_EGrpWaitMode wait_mode, unsigned int p_flags_pattern, TN_Timeout timeout)
	Wait for specified event(s) in the event group. More...

enum TN_RCode	tn_eventgrp_wait_polling (struct TN_EventGrp eventgrp, unsigned int wait_pattern, enum TN_EGrpWaitMode wait_mode, unsigned int p_flags_pattern)
	The same as `tn_eventgrp_wait()` with zero timeout. More...

enum TN_RCode	tn_eventgrp_iwait_polling (struct TN_EventGrp eventgrp, unsigned int wait_pattern, enum TN_EGrpWaitMode wait_mode, unsigned int p_flags_pattern)
	The same as `tn_eventgrp_wait()` with zero timeout, but for using in the ISR. More...

enum TN_RCode	tn_eventgrp_modify (struct TN_EventGrp *eventgrp, enum TN_EGrpOp operation, unsigned int pattern)
	Modify current events bit pattern in the event group. More...

enum TN_RCode	tn_eventgrp_imodify (struct TN_EventGrp *eventgrp, enum TN_EGrpOp operation, unsigned int pattern)
	The same as `tn_eventgrp_modify()`, but for using in the ISR. More...

Enumeration Type Documentation

enum TN_EGrpWaitMode

Events waiting mode: wait for all flags to be set or just for any of the specified flags to be set.

Enumerator
TN_EVENTGRP_WMODE_OR	Task waits for any of the event bits from the `wait_pattern` to be set in the event group.
TN_EVENTGRP_WMODE_AND	Task waits for all of the event bits from the `wait_pattern` to be set in the event group.

Definition at line 78 of file tn_eventgrp.h.

enum TN_EGrpOp

Modify operation: set, clear or toggle.

To be used in tn_eventgrp_modify() / tn_eventgrp_imodify() functions.

Enumerator

TN_EVENTGRP_OP_SET

Set flags that are set in given pattern argument.

Note that this operation can lead to the context switch, since other high-priority task(s) might wait for the event.

TN_EVENTGRP_OP_CLEAR

Clear flags that are set in the given pattern argument.

This operation can not lead to the context switch, since tasks can't wait for events to be cleared.

TN_EVENTGRP_OP_TOGGLE

Toggle flags that are set in the given pattern argument.

Note that this operation can lead to the context switch, since other high-priority task(s) might wait for the event that was just set (if any).

Definition at line 93 of file tn_eventgrp.h.

Function Documentation

enum TN_RCode tn_eventgrp_create	(	struct TN_EventGrp *	eventgrp,
		unsigned int	initial_pattern
	)

Construct event group.

id_event field should not contain TN_ID_EVENTGRP, otherwise, TN_RC_WPARAM is returned.

(refer to Legend for details)

Parameters

eventgrp	Pointer to already allocated struct TN_EventGrp
initial_pattern	Initial events pattern.

Returns

TN_RC_OK if event group was successfully created;
If TN_CHECK_PARAM is non-zero, additional return code is available: TN_RC_WPARAM.

enum TN_RCode tn_eventgrp_delete ( struct TN_EventGrp * eventgrp )

Destruct event group.

All tasks that wait for the event(s) become runnable with TN_RC_DELETED code returned.

(refer to Legend for details)

Parameters

eventgrp Pointer to event groupt to be deleted.

Returns

TN_RC_OK if event group was successfully deleted;
TN_RC_WCONTEXT if called from wrong context;
If TN_CHECK_PARAM is non-zero, additional return codes are available: TN_RC_WPARAM and TN_RC_INVALID_OBJ.

enum TN_RCode tn_eventgrp_wait	(	struct TN_EventGrp *	eventgrp,
		unsigned int	wait_pattern,
		enum TN_EGrpWaitMode	wait_mode,
		unsigned int *	p_flags_pattern,
		TN_Timeout	timeout
	)

Wait for specified event(s) in the event group.

If the specified event is already active, function returns TN_RC_OK immediately. Otherwise, behavior depends on timeout value: refer to TN_Timeout.

(refer to Legend for details)

Parameters

eventgrp	Pointer to event group to wait events from
wait_pattern	Events bit pattern for which task should wait
wait_mode	Specifies whether task should wait for all the event bits from `wait_pattern` to be set, or for just any of them (see enum `TN_EGrpWaitMode`)
p_flags_pattern	Pointer to the `unsigned int` variable in which actual event pattern that caused task to stop waiting will be stored. May be `NULL`.
timeout	refer to `TN_Timeout`

Returns

TN_RC_OK if specified event is active (so the task can check variable pointed to by p_flags_pattern if it wasn't NULL).
TN_RC_WCONTEXT if called from wrong context;
Other possible return codes depend on timeout value, refer to TN_Timeout
If TN_CHECK_PARAM is non-zero, additional return codes are available: TN_RC_WPARAM and TN_RC_INVALID_OBJ.

enum TN_RCode tn_eventgrp_wait_polling	(	struct TN_EventGrp *	eventgrp,
		unsigned int	wait_pattern,
		enum TN_EGrpWaitMode	wait_mode,
		unsigned int *	p_flags_pattern
	)

The same as tn_eventgrp_wait() with zero timeout.

(refer to Legend for details)

enum TN_RCode tn_eventgrp_iwait_polling	(	struct TN_EventGrp *	eventgrp,
		unsigned int	wait_pattern,
		enum TN_EGrpWaitMode	wait_mode,
		unsigned int *	p_flags_pattern
	)

The same as tn_eventgrp_wait() with zero timeout, but for using in the ISR.

(refer to Legend for details)

enum TN_RCode tn_eventgrp_modify	(	struct TN_EventGrp *	eventgrp,
		enum TN_EGrpOp	operation,
		unsigned int	pattern
	)

Modify current events bit pattern in the event group.

Behavior depends on the given operation: refer to enum TN_EGrpOp

(refer to Legend for details)

Parameters

eventgrp	Pointer to event group to modify events in
operation	Actual operation to perform: set, clear or toggle. Refer to `enum TN_EGrpOp`
pattern	Events pattern to be applied (depending on `operation` value)

Returns

TN_RC_OK on success;
TN_RC_WCONTEXT if called from wrong context;
If TN_CHECK_PARAM is non-zero, additional return codes are available: TN_RC_WPARAM and TN_RC_INVALID_OBJ.

enum TN_RCode tn_eventgrp_imodify	(	struct TN_EventGrp *	eventgrp,
		enum TN_EGrpOp	operation,
		unsigned int	pattern
	)

The same as tn_eventgrp_modify(), but for using in the ISR.

(refer to Legend for details)

Detailed Description

Data Structures

Enumerations

Functions

Enumeration Type Documentation

Function Documentation