Maintenance Mode Procedures

NORTHSTARSHOW SYSTEMS

Maintenance Mode Procedures

Entering, working in, and exiting Maintenance Mode

Two Routes Into Maintenance

Primary — Bridge Key Switch

Turn the maintenance key on the Polaris Bridge panel to the ON position. The Bridge sends a bridge-input event with role:"maint-mode",value:1. HelmOS's dispatcher intercepts this before any normal cue path, aborts active cues, broadcasts UDP STOP to all nodes, and flips store.maintenance to true. All Cuemaster clients swap to the amber Maintenance HMI within ~100 ms.

Override — Keyboard Shortcut

Press Ctrl+Shift+Alt+M with the Cuemaster dashboard focused. The shortcut POSTs to /api/maintenance/enter. The system responds identically to the key-switch path. The four-modifier combo prevents accidental triggers; the shortcut is not advertised in the operator UI but is documented here for administrators.

What Suspends

Every cue-firing path is gated by store.maintenance:

• Sensor events (event-input)
• Input combos (event-input-combo)
• Manual GO from Cuemaster
• Scheduled cues (event-schedule)
• Cuemaster events (event-cuemaster)
• Cue chains (event-cue-complete)
• HTTP /api/deploy returns 409 (with one exception path for unlicensed-state activation)

What Stays Active

• Actuator Test buttons in the Maintenance HMI — bypass the gate by design
• Firmware OTA push — actively required during maintenance windows
• HelmOS HTTP API for /api/health, /api/license/*, /api/firmware
• Show Loader uploads (with explicit override) for redeploying

Recommended Maintenance Tasks

• Run Actuator Test on every output to confirm wiring
• Push firmware updates after a Compose Build Firmware
• Inspect Interlock chain and Zone Diagnostics for any new faults
• Load a revised .nsss.compose if the show has changed
• Validate I/O Status reflects real-world switch positions

Exiting Maintenance

Turn the Bridge key OFF (or press the shortcut again). HelmOS receives bridge-input with value:0 (or POST /api/maintenance/exit), flips store.maintenance back to false, re-arms every trigger path, and broadcasts the state change. Cuemaster swaps back to Show Mode.

Related Documents

• NSSS-DOC-0042Maintenance HMI Reference
• NSSS-DOC-0054Polaris Bridge Datasheet

Revision History