Auto/atom-hmi-ui-chatgpt
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: document KAV, Lone Pine, Lazy B and Sweet Grass configure context

Browse Source
This commit is contained in:
snkbyte
2026-10-21 16:53:13 +00:00
parent 2b1c36cd91
commit ddba519c3c
10 changed files with 494 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
KAV-GUIDE.md
+101
View File
@@ -0,0 +1,101 @@
# 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.