ao_diagnostics

Active object managing fault and status event processing.

Inherited Component

Diagnostics_Manager

Inherited Requirements

Relationship Diagram

SW Unit Relations

Outgoing Relations

Relation	UML Type	Visibility	Target Unit	Description
SWR-015	association	public	ao_status_indication	Diagnostics publishes status events to indication.

Incoming Relations

Relation	UML Type	Visibility	Source Unit	Description
SWR-010	dependency	public	ao_runtime_supervisor	Runtime supervisor dispatches diagnostics events.
SWR-013	association	public	ao_control	Control publishes operational and fault-relevant events to diagnostics.
SWR-014	association	public	ao_safety	Safety publishes protective-state and fault events to diagnostics.

Data Types

ao_diagnostics_contextstruct

Internal runtime context for ao_diagnostics.

Struct Members

Name	Type	Description
fault_state	uint8_t	Fault lifecycle state.
active_fault_code	uint16_t	Current fault code.
fault_latched	bool	Fault latch status.
last_publish_tick	uint32_t	Last diagnostics publish tick.

ao_diagnostics_eventstruct

Event payload handled by ao_diagnostics.

Struct Members

Name	Type	Description
signal_id	uint16_t	Diagnostics event signal id.
fault_code	uint16_t	Fault code payload.
severity	uint8_t	Fault severity level.
clear_request	bool	Fault clear request.

ao_diagnostics_resultenum

Result code for ao_diagnostics operations.

Enum Members

Name	Value	Description
OK	0	Diagnostics update published.
FAULT_CAPTURED	1	Fault captured and reported.
CLEAR_REJECTED	2	Clear rejected by diagnostics policy.

Attributes

Attribute	Type	Visibility	Description
ctx	ao_diagnostics_context	private	Runtime context for ao_diagnostics state timing and error tracking.

Methods

dispatch

Return Type: ao_diagnostics_result
Visibility: public
Description: Process one ao_diagnostics event and update runtime outputs.

Parameters

Name	Type	Direction	Description
event	ao_diagnostics_event	in	Process one ao_diagnostics event and update runtime outputs.

init

Return Type: ao_diagnostics_result
Visibility: public
Description: Initialize ao_diagnostics runtime state and dependencies.

Dynamic Behaviour

State Machines

ao_diagnostics_state

This state machine formalizes diagnostics fault lifecycle handling across no fault active fault and latched fault states and clarifies when status publication and fault clear requests are accepted or rejected.

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-002_Protection_And_Fault_Propagation

Control and safety coordinate fan command decisions and publish operating/fault status into diagnostics for downstream handling.

SEQ-003_Status_To_LED_Indication

Diagnostics status outputs are transformed by status indication logic into concrete LED driver commands.

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.