ao_control

Active object processing measurement and config events to generate control actions.

Inherited Component

Control_Manager

Inherited Requirements

Relationship Diagram

SW Unit Relations

Outgoing Relations

Relation	UML Type	Visibility	Target Unit	Description
SWR-004	composition	private	sm_fan_control	Control active object embeds fan control state machine.
SWR-012	association	public	ao_safety	Control and safety coordinate control override behavior.
SWR-013	association	public	ao_diagnostics	Control publishes operational and fault-relevant events to diagnostics.

Incoming Relations

Relation	UML Type	Visibility	Source Unit	Description
SWR-008	dependency	public	ao_runtime_supervisor	Runtime supervisor dispatches control events.
SWR-021	association	public	ao_monitoring	Monitoring publishes validated sensor snapshots to control for decision logic.

Data Types

ao_control_contextstruct

Internal runtime context for ao_control.

Struct Members

Name	Type	Description
control_mode	uint8_t	Control mode state.
fan_command_on	bool	Last commanded fan output.
threshold_c	int16_t	Configured activation threshold.
hysteresis_band_c	int16_t	Configured hysteresis band.

ao_control_eventstruct

Event payload handled by ao_control.

Struct Members

Name	Type	Description
signal_id	uint16_t	Control event signal id.
snapshot_valid	bool	Incoming sensor snapshot validity.
temperature_c	int16_t	Temperature sample for decision.
protect_active	bool	Protection override input.

ao_control_resultenum

Result code for ao_control operations.

Enum Members

Name	Value	Description
OK	0	Control command computed.
INVALID_SNAPSHOT	1	Snapshot rejected due to invalidity.
SAFETY_OVERRIDE	2	Command forced by safety policy.

Attributes

Attribute	Type	Visibility	Description
ctx	ao_control_context	private	Runtime context for ao_control state timing and error tracking.

Methods

dispatch

Return Type: ao_control_result
Visibility: public
Description: Process one ao_control event and update runtime outputs.

Parameters

Name	Type	Direction	Description
event	ao_control_event	in	Process one ao_control event and update runtime outputs.

init

Return Type: ao_control_result
Visibility: public
Description: Initialize ao_control runtime state and dependencies.

Dynamic Behaviour

Activity Diagrams

ao_control_activity

This activity diagram defines ao_control decision flow from validated sensor snapshot intake through threshold and hysteresis evaluation to fan command generation with explicit protective override logic and status publication side effects.

Timing Diagrams

ao_control_timing

This timing diagram allocates the control cycle budget relative to the sampling tick and shows ordering from input availability to command publication to support deterministic control latency analysis and schedulability review.

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-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.