clear_emergency_stop
Clear a printer's emergency stop latch by acknowledging the stop and providing a note. Check emergency status first to ensure interlocks allow clearing.
Instructions
Acknowledge and clear a printer's emergency stop latch.
This is a safety-critical operation. The latch may be blocked from
clearing if critical interlocks are still active (e.g. thermal sensor
failure). Call ``emergency_status()`` first to check whether clearing
is possible.
:param printer_name: Printer whose latch to clear.
:param acknowledgement_note: Free-text note explaining why the e-stop is
being cleared (required -- cannot be empty).
:param acknowledged_by: Identity of the person or system clearing the
latch (default ``"operator"``).
:returns: Updated latch state, or an error if critical interlocks prevent
clearing.
See also: ``emergency_status()``, ``emergency_stop()``.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | Yes | ||
| acknowledged_by | No | operator | |
| acknowledgement_note | Yes |