FireIntervention¶

Overview¶

Fire alarm intervention window on a panel: the confirmation timer, the investigation timer started by the operator, and whether the window ended with the fire brigade being called.

Use FireIntervention on the panel Thing that owns the intervention window. Use FirePanel for panel alarm, acknowledge and reset state, and FireRouting for the transmission output itself.

Namespace: Pq.Adapters.Framework

When to Use¶

Panels that hold back brigade transmission for a confirmation time
Panels where the operator can start an investigation time after acknowledging the alarm
Installations where the audit must show whether the brigade was called or the alarm was cancelled in time

States¶

State	Status id	Description
`InterventionIdle`	`fire.intervention.idle` (hidden)	No intervention window is running
`InterventionConfirming`	`fire.intervention.confirming`	Confirmation time is running, transmission is held back
`InterventionInvestigating`	`fire.intervention.investigating`	Investigation time is running after operator acknowledgement
`InterventionDispatched`	`fire.intervention.dispatched`	The fire brigade has been called

InterventionIdle is the hidden default state: SetInterventionIdle(ct) publishes no status string, so the idle case clears the status slot.

Actions¶

Action	Target State	Event	Meaning
`FireInterventionStarted(timestamp)`	`InterventionConfirming`	`pq.event.fire.intervention.started`	Alarm confirmation time started, transmission to the fire brigade is held back
`FireInterventionExtended(timestamp)`	`InterventionInvestigating`	`pq.event.fire.intervention.extended`	Investigation time started after the operator acknowledged the alarm
`FireInterventionDispatched(timestamp)`	`InterventionDispatched`	`pq.event.fire.intervention.dispatched`	Intervention window closed without cancellation, the fire brigade has been called
`FireInterventionCancelled(timestamp)`	`InterventionIdle`	`pq.event.fire.intervention.cancelled`	Intervention ended by the cancellation criterion, the fire brigade was not called
`FireInterventionCleared(timestamp)`	`InterventionIdle`	`pq.event.fire.intervention.cleared`	Intervention returned to idle

YAML Example¶

device_types:
  - type_id: FirePanel
    name: "Fire Panel"
    functions:
      FirePanel:
      FireIntervention:
      ConnectionBase:

Notes¶

FireIntervention is panel-level. Do not attach it to detectors or addresses.
FireInterventionCancelled and FireInterventionCleared both return the function to idle. Use Cancelled when the panel reports that the cancellation criterion ended the window, and Cleared when the panel only reports a return to idle.