atom-hmi-ui-chatgpt/SHOP-BUILD.md

Shop PLC dashboards

Built October 21, 2026 for https://dev.atomhmi.com/site_atom/. Device ID shop, display name Shop.

Scope and inventory

The register table contains 2,472 entries. The equipment/system inventory saved in artifacts/shop/register-inventory.json contains 264 non-alarm-manager entries, including 233 g_ entries. Alarm-manager internals were excluded from selection, pages, settings, trends, and alarms. No atGVL_alarmManager register or its configuration was modified.

All equipment registers used were already enabled. No enable or recording configuration changes were necessary. Existing operating setpoints, alarm thresholds, alarm-source enables, calibration, and output states were preserved. Runtime entry dialogs were opened and cancelled; no PLC setpoint or output commands were submitted during this build.

Published pages

Page	Route	Content
Overview	page_overview	Default page; office/shop temperatures, heat targets, heat-pump/window output statuses, equipment links and combined temperature history
Office Heating	page_office_heating	Office temperature; editable heating setpoint/deadband; demand/output/fault; temperature and target trend; four temperature limits and individual hysteresis; four controller alarm-reporting enables
Floor Heating	page_floor_heating	Shop temperature; editable floor heat target/deadband; demand/output/fault; trend; four limits/hysteresis and alarm-reporting enables
Window Actuator	page_window_actuator	Office temperature; editable automatic window setpoint/deadband; open/close solenoid status and faults; temperature/target trend
Temperature Trends	page_temperatures	Office vs shop temperature, office heating/window targets, and floor-heating target history; 1H/1D/7D selectors
Diagnostics	page_diagnostics	Two temperature sensor/channel/overrange/underrange fault groups, raw inputs, electrical signals/supplies, and two I/O card faults

Native Copy/Paste component trees are saved as artifacts/shop/*-template.json. New navigation entries were added with Overview as default. The Atom HMI brand link opens the default page.

Register map

All references below use shop:.

• Office temperature: g_teOffice_out_eu; shop temperature: g_teShop_out_eu.
• Office heating: g_officeHeatCtrl_sp, g_officeHeatCtrl_db, demand g_officeHeatCtrl_Q; actual output g_officeHeat_out_val, fault g_officeHeat_fault_out.
• Floor heating: g_shopFloorCtrl_sp, g_shopFloorCtrl_db, demand g_shopFloorCtrl_Q; output g_shopFloor_out_val, fault g_shopFloor_fault_out.
• Window control: g_windowSP, g_windowDB; solenoid outputs g_officeWndOpen_out_val, g_officeWndClose_out_val; corresponding _fault_out registers.
• For each temperature prefix g_teOffice / g_teShop, limits use _limits_{lo,lolo,hi,hihi}_in_sp, individual hysteresis _in_hyst, controller reporting enables _alm_in_en, and HMI alarm sources _alm_out.
• Temperature diagnostics use _sensorFault_out, _faults_chan_out, _faults_over_out, _faults_under_out; raw/signal/supply use _in_raw, _in_signal, _in_supVlt.
• Hardware faults: g_base1_card01_fault_out, g_base1_card02_fault_out.

Numeric settings read the register and write value back to the same register. Deadband/hysteresis entry limits are 0–100 °C; operating setpoints and thresholds retain signed numeric entry. Two-position alarm switches use 1 enabled / 0 disabled. They change PLC alarm reporting enable inputs, distinct from the HMI alarm definition's enabled setting.

Alarms

Created 22 HMI alarms from existing PLC fault and limit alarm outputs: 8 temperature-limit alarms, 8 temperature-input/sensor faults, 2 heating-output faults, 2 window-solenoid faults and 2 I/O card faults. All 22 were reopened and verified enabled/non-latching. Update interval 1 second, HMI delays 0; PLC source logic retains its existing delays. High/Low temperature alarms are Warning; High-High/Low-Low and faults are Critical. Alarm and return-to-normal messages identify equipment in plain language. No notification group was selected, and no external notification recipients were configured.

The full alarm manifest and verification is artifacts/shop/alarms-created.json. No alarms were generated from alarm-manager internals or reset/acknowledgement globals.

Commissioning notes

• Existing temperature limits are 0 °C. These were exposed rather than replaced with invented thresholds. Set coherent operating limits before relying on temperature alarming. HMI alarms follow existing _alm_out signals; HMI non-latching does not change PLC latching/source logic.
• g_teShop descriptions incorrectly repeat Office temperature. Page/alarm names follow the distinct Shop register prefix and control-loop mapping.
• No separate boiler-water temperature or boiler operating target was found. Floor Heating shows the floor loop's room-temperature demand and pump output; it does not claim to provide direct boiler control.
• Window open/close signals are solenoid output commands. No position-feedback register was found. Do not label these as confirmed fully open/closed or offer direct output writes without establishing control logic.
• Heating demand and pump output are deliberately separate. At inspection the floor demand was 1 with pump output 0; this build does not establish the interlock or pump-feedback behavior.
• Runtime counters _out_rt exist but their time units are not documented, so no guessed hours conversion was added.
• Historical chart loading takes longer than live numeric polling. Wait for plotted traces, not only axis labels, before recording QA screenshots.

Verification and artifacts

• Saved and opened all six pages; overview showed live office ~23.7–23.8 °C, shop ~18.5 °C and both heating targets 20 °C.
• Confirmed plotted sensor/target history on the Temperature Trends page.
• Opened Heating Setpoint at 20 °C and Window Setpoint at 22.5 °C; cancelled both.
• Reopened every new alarm and checked its ID, enabled=true and latching=false.
• Screenshots include overview.jpg, office-heating.jpg, floor_heating.jpg, window_actuator.jpg, temperatures.jpg, diagnostics.jpg and alarms.jpg. Early runtime-audit snapshots can contain temporary polling placeholders; final trend screenshot shows loaded traces.

Use ATOMHMI-PLAYBOOK.md for the general Copy/Paste, modal, and navigation editing workflow.