ao_runtime_supervisor

Top-level active object driving startup and dispatching periodic and asynchronous events.

Inherited Component

Runtime_Manager

Inherited Requirements

Relationship Diagram

SW Unit Relations

Outgoing Relations

Relation	UML Type	Visibility	Target Unit	Description
SWR-001	composition	private	evt_dispatcher	Runtime supervisor owns event dispatch lifecycle.
SWR-002	composition	private	evt_timer_service	Runtime supervisor owns timer event service.
SWR-003	composition	private	sm_operation_mode	Runtime supervisor embeds operation mode state machine.
SWR-007	dependency	public	ao_monitoring	Runtime supervisor dispatches monitoring events.
SWR-008	dependency	public	ao_control	Runtime supervisor dispatches control events.
SWR-009	dependency	public	ao_safety	Runtime supervisor dispatches safety events.
SWR-010	dependency	public	ao_diagnostics	Runtime supervisor dispatches diagnostics events.
SWR-011	dependency	public	ao_modbus_server	Runtime supervisor dispatches communication events.

Data Types

ao_runtime_supervisor_contextstruct

Internal runtime context for ao_runtime_supervisor.

Struct Members

Name	Type	Description
lifecycle_state	uint8_t	Runtime lifecycle state.
ready_gate_mask	uint16_t	Startup readiness mask.
degraded_active	bool	Degraded mode active.
watchdog_ok	bool	Watchdog health state.

ao_runtime_supervisor_eventstruct

Event payload handled by ao_runtime_supervisor.

Struct Members

Name	Type	Description
signal_id	uint16_t	Supervisor event signal id.
source_unit_id	uint16_t	Event source unit identifier.
gate_id	uint8_t	Readiness gate identifier.
fault_present	bool	Fault condition input.

ao_runtime_supervisor_resultenum

Result code for ao_runtime_supervisor operations.

Enum Members

Name	Value	Description
OK	0	Lifecycle transition applied.
INIT_TIMEOUT	1	Initialization timed out.
DEGRADED_ENTERED	2	Entered degraded lifecycle.

Attributes

Attribute	Type	Visibility	Description
ctx	ao_runtime_supervisor_context	private	Runtime context for ao_runtime_supervisor state timing and error tracking.

Methods

dispatch

Return Type: ao_runtime_supervisor_result
Visibility: public
Description: Process one ao_runtime_supervisor event and update runtime outputs.

Parameters

Name	Type	Direction	Description
event	ao_runtime_supervisor_event	in	Process one ao_runtime_supervisor event and update runtime outputs.

init

Return Type: ao_runtime_supervisor_result
Visibility: public
Description: Initialize ao_runtime_supervisor runtime state and dependencies.

Dynamic Behaviour

State Machines

ao_runtime_supervisor_state

Runtime supervisor lifecycle with explicit readiness gates degraded entry and recovery criteria and controlled shutdown completion conditions.

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-004_Modbus_Event_Servicing

Runtime-driven communication events are processed by the Modbus server through hardware-adapted UART event exchange.

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.