evt_dispatcher

Event queue and dispatcher routing events to active objects.

Inherited Component

Runtime_Manager

Inherited Requirements

Relationship Diagram

SW Unit Relations

Incoming Relations

Relation	UML Type	Visibility	Source Unit	Description
SWR-001	composition	private	ao_runtime_supervisor	Runtime supervisor owns event dispatch lifecycle.

Data Types

evt_dispatcher_contextstruct

Internal runtime context for evt_dispatcher.

Struct Members

Name	Type	Description
queue_depth	uint16_t	Current queue depth.
max_queue_depth	uint16_t	Configured queue capacity.
overflow_flag	bool	Queue overflow indicator.
last_dispatch_tick	uint32_t	Last dispatch tick.

evt_dispatcher_eventstruct

Event payload handled by evt_dispatcher.

Struct Members

Name	Type	Description
signal_id	uint16_t	Dispatcher event id.
target_unit_id	uint16_t	Target unit id.
priority	uint8_t	Dispatch priority class.
enqueue_request	bool	True when event enqueued.

evt_dispatcher_resultenum

Result code for evt_dispatcher operations.

Enum Members

Name	Value	Description
OK	0	Event dispatched.
QUEUE_FULL	1	Queue full at enqueue.
TARGET_UNKNOWN	2	No route for target unit.

Attributes

Attribute	Type	Visibility	Description
ctx	evt_dispatcher_context	private	Runtime context for evt_dispatcher state timing and error tracking.

Methods

dispatch

Return Type: evt_dispatcher_result
Visibility: public
Description: Process one evt_dispatcher event and update runtime outputs.

Parameters

Name	Type	Direction	Description
event	evt_dispatcher_event	in	Process one evt_dispatcher event and update runtime outputs.

init

Return Type: evt_dispatcher_result
Visibility: public
Description: Initialize evt_dispatcher runtime state and dependencies.

Dynamic Behaviour

Activity Diagrams

evt_dispatcher_activity

This activity diagram describes dispatcher queue semantics and event routing policy showing enqueue dequeue target resolution and dispatch invocation ordering that underpins determinism across active objects.

Timing Diagrams

evt_dispatcher_timing

This timing diagram characterizes enqueue to dispatch latency segments and highlights where backlog or routing overhead can affect downstream deadline compliance for control and safety events.

Sequence Diagrams

SEQ-001_Runtime_Event_Orchestration

Primary runtime interoperability sequence showing scheduler tick propagation through dispatcher fan-out and deterministic active-object processing order across monitoring control safety diagnostics and communication units.

SEQ-005_Startup_To_Ready

Startup lifecycle sequence with explicit readiness gates before entering Run state.

SEQ-006_Degraded_Entry_And_Recovery

Lifecycle sequence for degraded entry triggers and guarded recovery back to Run.

SEQ-007_Controlled_Shutdown

Controlled shutdown sequence defining stop ordering and completion criteria.