raphael
1da56f973f
A2 — alarms: optional 'name:' on alarm config (a LOCAL key — SEMI only
defines numeric ALID + freetext ALTX; field appended last so existing
{id, text, category} brace-inits compile unchanged), parsed by the loader,
checked by the validator, shipped in equipment.yaml. SetAlarm/ClearAlarm
RPCs resolve config name OR stringified ALID via a constructor snapshot.
A3 — control state + health: RequestControlState fires operator events on
the io thread (read_sync) and reports what the E30 table actually did —
ACCEPT iff the equipment landed in the requested state, CANNOT_DO_NOW naming
the actual state otherwise (the shipped table has no operator path to
EquipmentOffline; the test pins that honesty). ATTEMPT_ONLINE is rejected as
transient. WatchHealth streams an immediate snapshot then pushes on link/
control-state changes via service observers (add_link_observer +
add_control_state_observer — the HandlerSlot work paying off), spool depth
sampled at the 500ms poll; ends on cancel or engine stop.
Tests: daemon suite 61 -> 101 assertions (alarm lifecycle by name/id/unknown,
WatchHealth initial + change push, all four RequestControlState semantics);
loader test for the alarm name (present + absent fallback); core 467/3055.
Interop now 15 checks incl. gRPC SetAlarm -> host receives S5F1 ALCD=0x84
ALID=1, and RequestControlState(HOST_OFFLINE) -> GetControlState confirms.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
96 lines
4.2 KiB
YAML
96 lines
4.2 KiB
YAML
# Equipment data dictionary loaded by secs_server at startup. Adding a
|
|
# capability (SVID, ECID, CEID, alarm, recipe, command) is a YAML edit;
|
|
# no code change is required as long as the underlying message handler
|
|
# already exists in the C++ Router.
|
|
|
|
device:
|
|
id: 0
|
|
model_name: "SECSGEM-SIM"
|
|
software_rev: "0.1.0"
|
|
equipment_type: "EQUIPMENT" # S1F20 EQPTYP string
|
|
|
|
# Reported on S1F19 -> S1F20 (Get GEM Compliance). CCODE values follow
|
|
# E30 Appendix A; CDESC is implementer-defined. Keep this list honest:
|
|
# it should reflect what the equipment actually implements (see
|
|
# docs/COMPLIANCE.md for the audit).
|
|
capabilities:
|
|
- {code: 1, name: "Establish Communications"}
|
|
- {code: 2, name: "Dynamic Event Report Configuration"}
|
|
- {code: 3, name: "Variable Data Collection"}
|
|
- {code: 5, name: "Status Data Collection"}
|
|
- {code: 6, name: "Alarm Management"}
|
|
- {code: 7, name: "Remote Control"}
|
|
- {code: 8, name: "Equipment Constants"}
|
|
- {code: 9, name: "Process Program Management"}
|
|
- {code: 11, name: "Equipment Terminal Services"}
|
|
- {code: 12, name: "Clock"}
|
|
- {code: 14, name: "Spooling (partial; S2F43/F44 + S6F23/F24)"}
|
|
- {code: 15, name: "Control (operator initiated)"}
|
|
# GEM300 extensions (declared so the host can probe with S1F19).
|
|
- {code: 40, name: "E40 Process Job Management"}
|
|
- {code: 94, name: "E94 Control Job Management"}
|
|
|
|
# Reported on S1F3 (values) and S1F11 (namelist). `value` is the initial.
|
|
# `type` controls the SECS-II Item format.
|
|
svids:
|
|
- {id: 1, name: ControlState, units: "", type: ASCII, value: ""}
|
|
- {id: 2, name: Clock, units: "", type: ASCII, value: ""}
|
|
- {id: 3, name: EventsEnabled, units: "", type: BOOLEAN, value: true}
|
|
|
|
# Reported on S1F21/F22 (DVID namelist). Same shape as SVIDs.
|
|
dvids:
|
|
- {id: 100, name: WaferCounter, units: "wafer", type: U4, value: 0}
|
|
- {id: 101, name: ChamberPressure, units: "Torr", type: F4, value: 0.000001}
|
|
|
|
# Reported on S2F13 (values) / S2F29 (namelist) / S2F15 (set).
|
|
ecids:
|
|
- {id: 10, name: TimeFormat, units: "code", type: U4, value: 1, min: "0", max: "1"}
|
|
- {id: 11, name: EstablishCommTimeout, units: "sec", type: U4, value: 10, min: "1", max: "60"}
|
|
|
|
# Reported on S6F11. The host links these to reports via S2F35 and
|
|
# enables them via S2F37.
|
|
ceids:
|
|
- {id: 100, name: ControlStateChanged}
|
|
- {id: 200, name: AlarmSetEvent}
|
|
- {id: 300, name: ProcessStarted}
|
|
- {id: 400, name: ControlJobExecuting} # E94 CJ entered Executing
|
|
- {id: 401, name: ControlJobCompleted} # E94 CJ entered Completed
|
|
|
|
# Reported on S5F5 / S5F1. `category` is the lower-7 of ALCD. `name` is an
|
|
# optional local key for the daemon's name-based API (gRPC SetAlarm/ClearAlarm);
|
|
# it never goes on the wire — SEMI only defines numeric ALID + freetext text.
|
|
alarms:
|
|
- {id: 1, name: chiller_temp_high, text: "Chiller Temp High", category: 4}
|
|
- {id: 2, name: door_open, text: "Door Open", category: 1}
|
|
|
|
# Reported on S7F19. Body served by S7F5/F6.
|
|
recipes:
|
|
- {id: "RECIPE-A", body: "STEP CHAMBER ARGON 30s\nSTEP CHAMBER NITROGEN 60s\nEND"}
|
|
- {id: "RECIPE-B", body: "STEP HEATER 800C 120s\nEND"}
|
|
|
|
# Dispatched by S2F41. `ack` is the HCACK enum value. Optional `emit_ceid`
|
|
# fires a CEID after dispatch (e.g. ProcessStarted on START), and optional
|
|
# `set_alarm` activates an alarm (e.g. FAULT -> alarm 1). `force_spool`
|
|
# (true/false) flips the spool store's test-force flag — for the demo this
|
|
# stands in for "the host link has gone down" without actually dropping
|
|
# TCP.
|
|
host_commands:
|
|
- {name: START, ack: Accept, emit_ceid: 300}
|
|
- {name: STOP, ack: Accept}
|
|
- {name: PAUSE, ack: CannotDoNow}
|
|
- {name: FAULT, ack: Accept, set_alarm: 1}
|
|
- {name: SPOOL_ON, ack: Accept, force_spool: true}
|
|
- {name: SPOOL_OFF, ack: Accept, force_spool: false}
|
|
|
|
# Spool (E30 §6.22). Streams listed here may be queued by the equipment
|
|
# when the host is unreachable; queued messages drain when the host sends
|
|
# S6F23 with RSDC=0. max_size caps the in-memory queue (FIFO eviction on
|
|
# overflow).
|
|
spool:
|
|
max_size: 100
|
|
spoolable_streams: [5, 6]
|
|
|
|
# CEID emitted automatically whenever the control state machine transitions
|
|
# (i.e. on every change-handler call). Set to null to disable.
|
|
emit_on_control_change: 100
|