RTEMS
5.0.0
|
Functions | |
RTEMS_INLINE_ROUTINE rtems_status_code | rtems_event_transient_send (rtems_id id) |
See rtems_event_system_send(). More... | |
RTEMS_INLINE_ROUTINE rtems_status_code | rtems_event_transient_receive (rtems_option option_set, rtems_interval ticks) |
See rtems_event_system_receive(). More... | |
RTEMS_INLINE_ROUTINE void | rtems_event_transient_clear (void) |
See rtems_event_system_receive(). More... | |
The transient event can be used by a client task to issue a request to another task or interrupt service (server). The server can send the transient event to the client task to notify about a request completion, see rtems_event_transient_send(). The client task can wait for the transient event reception with rtems_event_transient_receive().
The user of the transient event must ensure that this event is not pending once the request is finished or cancelled. A successful reception of the transient event with rtems_event_transient_receive() will clear the transient event. If a reception with timeout is used the transient event state is undefined after a timeout return status. The transient event can be cleared unconditionally with the non-blocking rtems_event_transient_clear().
Suppose you have a task that wants to issue a certain request and then waits for request completion. It can create a request structure and store its task identifier there. Now it can place the request on a work queue of another task (or interrupt handler). Afterwards the task waits for the reception of the transient event. Once the server task is finished with the request it can send the transient event to the waiting task and wake it up.
RTEMS_INLINE_ROUTINE void rtems_event_transient_clear | ( | void | ) |
See rtems_event_system_receive().
The system event RTEMS_EVENT_SYSTEM_TRANSIENT will be cleared.
RTEMS_INLINE_ROUTINE rtems_status_code rtems_event_transient_receive | ( | rtems_option | option_set, |
rtems_interval | ticks | ||
) |
See rtems_event_system_receive().
The system event RTEMS_EVENT_SYSTEM_TRANSIENT will be received.
RTEMS_INLINE_ROUTINE rtems_status_code rtems_event_transient_send | ( | rtems_id | id | ) |
See rtems_event_system_send().
The system event RTEMS_EVENT_SYSTEM_TRANSIENT will be sent.