Files
atom-hmi-ui-chatgpt/KAV-GUIDE.md
T

7.0 KiB
Raw Blame History

KAV site guide

Verified through production Configure Pages and native element Copy on 2026-10-21 (America/Edmonton). This was a read-only context survey: no page saves, pastes, register writes, alarm changes, device actions, or operational command tests. Bindings describe the configured UI, not proven PLC behavior. No credentials or camera/map endpoints are retained.

Site identity and coverage

Selector label Production site Catalog count
KAV Main - Mill https://www.atomhmi.com/site_kav/ 43
KAV East - Mill https://www.atomhmi.com/site_kav_east_mill/ 4
KAV Main - Water https://www.atomhmi.com/site_kav_water/ 29
KAV East - Water https://www.atomhmi.com/site_kav_east_water/ 38

The production host in this browser is www.atomhmi.com. The user identifies atomhmi.com and dev.atomhmi.com as the two work environments; development copies of these KAV sites were not verified in this survey. Each site's administration menu exposes Configure Pages. KAV's in-page Select Site components are separate from the global administrator site selector.

Read SITE-STUDY.md and PAGE-INVENTORY.md for the October 20 full catalog study. October 21 refreshed all four catalogs and selected active page trees, copied representative subtrees, and opened all four East Mill page trees. It did not repeat every legacy Main Mill/water page inspection. Main Mill now includes Mill 2 Test, absent from the earlier 42-page inventory; the other counts are unchanged.

Main Mill: where to start

Page title Slug after page_ Roots / role verified October 21
Mill 2 mill2 row diagram + Status controls; 285 total elements
Mill 2 Test mill_2_test row; 38 diagram elements, not a complete control-page substitute
Mill 2 Settings mill2_settings All + Status; 201 elements
Tempering tempering row diagram + All; 261 elements
Tempering 2 tempering2 All; 63 elements
Bin Inventory bin_inventory Totals, Receiving / Tempering Bins, Rolled Bins, Trend Row, Bin Weights
Receiving receiving row diagram + Control Row; 166 elements
Receiving Settings rec_settings Settings; 67 elements
Receiving Trend rec_trend Status; 30 elements

The diagram uses View Port level indicators, static/two-state/multi-state images and text. Receiving also uses a ten-state image. Inventory adds Dropdown Select, numeric values, gauges and a trend. Preserve every page root; copying the diagram alone omits the command controls.

Copied Mill 2 Status root has 247 elements. Its configured command targets use device prefix mill:

  • Start / Stop: mill:cmdMill2Start / mill:cmdMill2Stop, each writes 1.
  • Source/destination toggles include cmdMill2T1Tgl, cmdMill2T2Tgl, cmdMill2B2Tgl, cmdMill2B3Tgl, cmdMill2B4Tgl; corresponding ASTgl targets also occur.
  • Shutdown Timer reads mill:Mill2SDNTim * 1000 in Timespan (ms), writes value / 1000.
  • Some non-editable historical runtime fields retain test: update targets and inconsistent write expressions. Their editable flag was false; a populated updateRegister is not proof that the field is currently writable.

East Mill

Four pages: Bins (bins), Device Status (device_status), Select Site (select_site), Settings (settings).

Bins has four roots: Heading, row, Site Select, Molasses Tanks. The row contains the equipment viewport; the Molasses Tanks subtree includes the combined level trend. Its exact chart mappings are:

Series Register
Limestone East (%) mill:bin01Lvl_eu
Limestone West (%) mill:bin04lvl_eu
Rolling (%) mill:bin02lvl_eu
Receiving (%) mill:bin03lvl_eu
Molasses 1 (%) mill:bin05lvl_eu
Molasses 2 (%) mill:bin06lvl_eu

Axis 0–100%; navigator mill:bin06lvl_eu, default button index 2. Case differs between register names; preserve it. Diagnostics has one All root (111 elements); Settings is a small Site Select root (5 elements).

Main Water

Page Slug Structure verified October 21
Cistern cistern Main Info; 146 elements
Wells wells Wells; 195 elements
Well 1 New well_1_new div, control, information/map roots; 128 elements
Well 10 New well_10_new div, control, information/map roots; 136 elements
Out Pump 1 out_pump_1 control root; 34 elements
TruckWater truck_water two Control Row roots + Settings; 16 elements

Well 10 New's copied operating root has 67 elements:

  • Flow water:g_well10_flow_out_eu in gpm; level water:g_well10_lvl_out_eu in ft.
  • Run feedback water:g_well10Pump_out_run; mode g_well10Pump_in_autoMode (1 Auto / 0 Manual).
  • Start writes 1 to water:g_well10Pump_in_manFwd; Stop writes 1 to water:g_well10Pump_in_manStop.
  • Speed mode targets water:GVL_Well10SP_AutoSpeedMode (1/0).
  • Editable Flow SP g_well10_flow_limits_lo_in_sp: 0–30 gpm; Level SP g_well10_lvl_limits_lo_in_sp: 0–30 ft; manual g_well10Pump_in_manSpeedRef: 0–90 Hz.
  • Low-flow alarm enable: g_well10_flow_limits_lo_alm_in_en, 1/0. The same low-flow threshold is shown read-only elsewhere.
  • Concentration water:g_chemStrength is editable but limits=false, despite populated 0/20 fields. Rate g_well10Rate is read-only, mL/h.
  • History series use g_well10_lvlHistory_hi, g_well10_lvlHistory_lo, g_well10_lvl_out_eu; level axis 0–40, navigator current level.

Unresolved write mismatch: editable Chlorine Current PPM displays water:g_well10ChemPPM but writes water:g_well1ChemPPM. Verified from copied JSON on October 21; no write or correction was attempted. Check the intended target before using this field or template.

East Water

Page Slug Structure
Cisterns cisterns Main Info; 192 elements
Cistern 1 Transfer cist_1_trans div + three control roots; 82 elements
Outflow outflow Main Info + Pumps; 245 elements
Wells wells Wells; 245 elements, copied
Sys 1_1 sys11 div + control; 46 elements
Temps temps Trend Div; 2 elements
Well 25 New well25-new div, control, Water Settings; 97 elements
Well 26 New well26-new div, control, Water Settings; 97 elements

Do not derive slugs from titles: underscore, hyphen and spacing conventions vary.

The Wells chart has ten series. Older registers include water:well21GPM, well22GPM, well23GPM, well24Flow_eu, well25GPM, well26GPM, well27Flow_eu, well28Flow_eu; newer ones use water:g_well29_flow_out_eu and g_well30_flow_out_eu. Axis is 0–20 gpm; navigator water:inTotGPMCalc, default button 1.

Unresolved chart label: both final series are named Well 29, but the last is bound to Well 30. Reconfirmed October 21; unchanged.

Future work

Use this guide to locate the relevant page and equipment without repeating the whole site survey. Reopen only the page/subtree being changed, verify its current read/write bindings, and back it up before authorized edits. Neither alarm latching nor PLC interlocks were audited here. Operational testing requires its own site-specific authorization.