# Highway 21 site guide

Verified October 26, 2026 (America/Edmonton). Production target: https://www.atomhmi.com/site_highway_21/page_well_14. Site ID highway_21; device selector Water. Updated after user import: all 30 well card-fault alarms created and verified; polling enabled for their 30 sources. Earlier discovery notes below describe the pre-import state.

## Program mapping confirmed by user

| Program ID | Well |
| --- | --- |
| 0 | Well 5 |
| 1 | Well 15 |
| 2 | Well 16 |
| 3 | Well 4 |
| 4 | Well 7 |
| 5 | Well 8 |
| 6 | Well 9 |
| 7 | Well 12 |
| 8 | Well 13 |
| 9 | Well 14 |
| 10 | Well 18 |
| 11 | Well 19 |
| 12 | Spare |
| 13 | Spare |
| 14 | Spare |

## Verified register and alarm catalog

Water has 2,766 register definitions. Search card returns zero matches in the ID/description table. Search unlatched returns 170 entries; search fault returns 60 VFD entries. Existing families include GVL_Well[n]_out_flow_flt_chan_unlatched, GVL_Well[n]_out_lvl_flt_chan_unlatched and GVL_Well[n]_out_vfd_Fault_unlatched, for program indices 0–14. Do not equate these with the requested fault.card.unlatched without confirmation.

Opened GVL_Well[0]_out_flow_flt_chan_unlatched: slave Water PLC; address {"tag":"Application.GVL.Well[0].out.flow.flt.chan.unlatched"}; On Change, one second, Enabled unchecked. Many other unlatched entries are disabled. Definition presence does not establish live readings.

Water has 26 HMI alarm definitions: 12 well low-flow, 12 well low-level, and cistern high/low-level. Existing well entries for index 10 say Well 19 and index 11 say Well 18, opposite the user's mapping. This discrepancy was observed and left unchanged pending scope resolution.

## Historical card fault import preparation

User confirmed these are new PLC tags requiring import. Native Manage Registers → Import → Water → Water PLC → Normal accepts an OPC UA XML file; no live tag browser is exposed. Import defaults observed: Delete Unused ON, Enabled OFF, On Change one second. Turn Delete Unused OFF for additive imports and inspect the validation preview before submission. Awaiting PLC export XML or exact full fault.card.unlatched paths and equipment/card assignments. No tags or alarms added. After receiving the source data, import only missing definitions, add equipment-specific alarm descriptions and quoted Message/Return to Normal expressions, verify persistence, and update this guide.

## Target page observations

Well 14 has flow in gpm, water level in ft, totals in gal, time displays, level/flow trends, and low-flow/low-level enable, threshold and delay controls. Read-only snapshot: 0.0 gpm, water level 8.7 ft. No runtime controls operated. Existing alarm create form supports calculation, importance, latching, on/off delays, notification groups and enabled state; opening a draft was inspection only.

## Card fault alarms completed — October 26, 2026

After the user imported the updated PLC XML, Water had 2,798 register definitions. The imported names use the correctly spelled suffix unlatched: GVL_Well[n]_out_flow_flt_card_unlatched and GVL_Well[n]_out_lvl_flt_card_unlatched, for n=0–14. Their OPC UA addresses follow Application.GVL.Well[n].out.{flow,lvl}.flt.card.unlatched on Water PLC.

Enabled polling for all 30 well card-fault sources, preserving On Change and one-second intervals. Fresh table readback verified all 30 Enabled Yes; the settled snapshot showed 0 for 29 sources, with the most recently enabled level source still blank at capture. No PLC values were written. The separate cistern card-fault definition was outside this well-specific request and remained disabled.

Created 30 enabled HMI alarms, bringing Water from 26 to 56 definitions. IDs CARD-00-FLOW/CARD-00-LEVEL through CARD-14-FLOW/CARD-14-LEVEL use the user's mapping above. Program10 is Well18 and program11 Well19. Programs12–14 are explicitly named Spare Program12–14. Descriptions follow “Well 5 Flow Input Card Fault” / “Well 5 Level Input Card Fault”. Messages are quoted expression strings, for example "Well 5: flow input card fault detected. Check the input module and its connection." Return text: "Well 5: flow input card fault has cleared."

Each calculation directly references |{register:water:GVL_Well[n]_out_flow_flt_card_unlatched}| or the corresponding lvl source. Settings: Warning, Enabled true, HMI Latching false, one-second update interval, Delay On0, Delay Off0; notification groups Default and Atom Notifications, matching the existing sampled well alarm.

Validation: reloaded the alarm page and reopened all 30 saved forms. Verified every ID, description, calculation, fault message, return message, enabled/latching state, interval, delays and notification groups. Filter CARD- returned exactly30 rows; total56. Existing26 descriptions/messages were retained, including the previously recorded Well18/19 discrepancy. No alarm conditions forced, reset/acknowledgement or notification-delivery test performed. Polling configuration and persisted alarm definitions are verified; physical card failure behavior is not tested.

Local deliverables: highway-21-card-alarms.png and highway-21-card-alarm-audit.json in this chat's outputs directory.