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
ATOMHMI-PLAYBOOK.md
+14
View File
@@ -72,3 +72,17 @@ Updated October 20, 2026 after owner feedback:
Navigation editor caution: after deleting an entry, reload before another mutation. Its table can display new rows while event handlers still refer to prior row positions. A removed Ventilation entry was corrected during verification; final navigation has Compressor, Well, Washer, Ventilation, Coop, Water Usage and Device Status, with no Temperature/Hot Tub. Navigation editor caution: after deleting an entry, reload before another mutation. Its table can display new rows while event handlers still refer to prior row positions. A removed Ventilation entry was corrected during verification; final navigation has Compressor, Well, Washer, Ventilation, Coop, Water Usage and Device Status, with no Temperature/Hot Tub.
Page roots matter: Copy on the first root does not capture additional roots. Read the DOM-backed root list before replacements; preserve unrelated site-information roots. A pasted replacement appends at the bottom; use the root Up arrow to restore desired order. Page roots matter: Copy on the first root does not capture additional roots. Read the DOM-backed root list before replacements; preserve unrelated site-information roots. A pasted replacement appends at the bottom; use the root Up arrow to restore desired order.
## Read-only context inspection, verified October 21, 2026
Use the relevant KAV-GUIDE.md, LONE-PINE-GUIDE.md, LAZY-B-GUIDE.md or SWEET-GRASS-GUIDE.md first; then inspect only the current target page/subtree. The full baseline survey need not be repeated for every task.
Native Copy succeeded in production on all four site families. Exported JSON has id, name, type, data and nested elements. Validate the copied root's identity against the current tree before interpreting the clipboard; an empty/stale clipboard is not evidence that Copy uses an internal-only format. The older SITE-STUDY.md inference has been corrected.
For a large page, enumerate top-level editor roots from the visible DOM and copy each required root separately. Resolve the direct Copy button under that root's header, rather than searching all descendant buttons. This allowed Sweet Grass Motors (1,435 elements) and old Motors (1,246) to be inspected. Do not infer a complete page from the first copied root.
Reload clean Configure Pages between previews, particularly after large charts/motor pages. On timeout, inspect current UI and clipboard identity before retrying. Keep survey batches small and record verified findings immediately; a browser-tool session reset can discard in-memory analysis.
For bindings, record display value, editable flag, updateRegister, writeValue/updateValue, limits flag and units independently. A read-only field can retain a stale write target. Legacy (Dont Use) components can have both register and updateRegister keys; behavior is not established by an internal name alone. Limit values do not enforce anything when limits=false.
This survey used Copy only and discarded editors. No production paste, Save, register command, device action or alarm test was performed. Earlier Mandel development tests remain separate evidence with separate authorization.
HANDOFF.md
+29 -13
View File
@@ -1,25 +1,41 @@
# Current handoff # Current handoff
Last updated: 2026-10-21 Last updated: 2026-10-21 (America/Edmonton)
## Completed ## Completed this session
Imported the Atom HMI project Markdown guides from the existing chat workspace into this repository. Preserved the original repository instructions and added the site-documentation upkeep instructions. Atom GIT connection recovered. Read repository AGENTS.md, PROJECT.md, HANDOFF.md, playbook/study/inventory and current cloud knowledge before inspection. Used the signed-in production browser at www.atomhmi.com.
Prior site work is documented in the imported guides: Mandel dashboards and settings, navigation cleanup, 81 non-latching HMI alarms; Shop overview, heating, actuator, temperature trends, diagnostics and 22 non-latching alarms. These are prior verified work, not new site changes in this repository-import task. - Created KAV-GUIDE.md, LONE-PINE-GUIDE.md, LAZY-B-GUIDE.md and SWEET-GRASS-GUIDE.md with verified configure-page maps, subtree patterns, representative read/write bindings, units and limits.
- Opened every Lone Pine (16), Lazy B (21) and KAV East Mill (4) page tree. Refreshed all seven site catalogs and selected active pages in the other KAV sites and Sweet Grass; preserved the previous full survey for remaining pages.
- KAV Main Mill has 43 listed pages, including newly observed Mill 2 Test (mill_2_test). Other KAV counts remain 4/29/38; Sweet Grass 51.
- Resolved Sweet Grass Motors and old Motors inspection gaps: 1,435 and 1,246 elements respectively; native root Copy verified.
- Corrected stale clipboard inference, expanded PAGE-INVENTORY.md and added large-tree Copy inspection guidance to ATOMHMI-PLAYBOOK.md.
- Saved cloud copies of the four guides and updated the knowledge-base index/common notes. Repository and cloud documents are manually maintained, not automatically synchronized.
## Current state and next steps ## Validation and scope
1. Read AGENTS.md, PROJECT.md and the relevant site guide before further work. Verified page Title/URL and visible element structure; native Copy root identity checked before interpreting JSON. Findings distinguish this session's inspections from October 20 register/alarm observations. No production page saves/pastes, register/setpoint writes, operational buttons, device actions, alarm modifications or live control tests. No raw JSON/credentials/camera/map endpoints uploaded. Browser timeouts were recovered with clean Configure Pages reloads.
2. Reconnect to the signed-in target browser; session state is not transferred through Git.
3. Confirm the requested site/environment and current state before editing.
4. Shop temperature limits are still 0 °C and need commissioning. A separate boiler-water sensor/target was not found. Do not edit atGVL_alarmManager.
5. Keep guides, cloud knowledge and handoff notes current with verified changes, tests and unresolved questions.
## Included and excluded material ## Unresolved findings — no correction authorized/performed
All Atom HMI Markdown guides and the project README are included. Existing AGENTS.md was merged rather than replaced. Secrets, environment files, screenshots, and JSON artifacts were not uploaded. Local artifact references require the original workspace until separately uploaded. 1. KAV Main Water, Well 10 New: editable chlorine field reads water:g_well10ChemPPM but writes water:g_well1ChemPPM.
2. Lazy B Well 3: Time Since Start and editable Hours use water:wellNW1_tssTmr / wellNW1_totalTmr, unlike other Well 3 bindings.
3. KAV East Water Wells: final Well 29-labeled trend series targets water:g_well30_flow_out_eu.
4. Lazy B: duplicate main/Main navigation targets; M03 PID Tn suffix KP; Loadout internal 100% Button name on an 80-value command. Internal names are not behavioral proof.
5. Lone Pine dryer uses legacy (Dont Use) components. Inspect supported semantics before reusing/migrating.
6. Alarm latching, notification policies, PLC interlocks and operational write behavior were not audited here.
## Next task
Read AGENTS.md, PROJECT.md and the specific site guide; reconnect the signed-in browser and inspect only the current affected subtree. This baseline context survey need not be repeated. Verify intended target before any change to a flagged binding. User's work environments are dev.atomhmi.com and atomhmi.com.
## Prior work retained
Earlier repository import preserved project knowledge. Mandel dashboards/settings, navigation cleanup and 81 non-latching HMI alarms; Shop overview/heating/actuator/trends/diagnostics and 22 non-latching alarms remain in their guides, not new work in this survey. Shop temperature limits remain 0 °C pending commissioning; a separate boiler-water sensor/target was not found. Do not edit Shop atGVL_alarmManager.
Original screenshots/JSON artifacts remain outside this repository. Browser sessions and chat history do not transfer through Git.
## Resume prompt ## Resume prompt
Use Atom Git to open Auto/atom-hmi-ui-chatgpt. Read AGENTS.md, PROJECT.md, HANDOFF.md and the relevant site guide, then continue with the requested site task. Use Atom GIT to open Auto/atom-hmi-ui-chatgpt on master. Read AGENTS.md, PROJECT.md, HANDOFF.md and the relevant site guide. Target site: [dev.atomhmi.com or atomhmi.com URL]. Task: [requested change]. Inspect current affected elements, update guides with verified changes, then commit and push documentation.
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.
LAZY-B-GUIDE.md
+107
View File
@@ -0,0 +1,107 @@
# Lazy B Farm & Ranch 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.
## Identity and scope
Production: https://www.atomhmi.com/site_lazy_b/
Configure: https://www.atomhmi.com/site_lazy_b/configure_pages
All 21 page trees were opened on October 21. Native Copy inspected representative main, sequence, water, valve, compressor and boiler subtrees. The site combines water/heating (`water` device prefix) and grain handling (`grain`). Development equivalence, PLC tag addresses, polling/logging and alarm latching were not verified.
## Page map
| Configure label | Slug | Role / roots |
| --- | --- | --- |
| Main | main | Trend + Wells and Pumps |
| Outflow | outflow | div + row; 127 elements |
| Well 1 | well_1 | div + operating row + information/map row; 111 elements |
| Well 2 | well_2 | same three-root layout; 106 elements |
| Well 3 | well_3 | same three-root layout; includes motor/speed control |
| Air Compressor | air | layout div + all operating root |
| Boiler | boiler | layout div + row operating root |
| House Valve | valve | spacer + all operating root |
| Alarms | alarms | spacer + all; 16 elements |
| Grain Alarms | grain_alarms | Main; 209 elements |
| Grain Motors | grain_motors | Motors; 357 elements |
| Receiving | receiving | Control Row; 77 elements |
| Receiving Start Stop Delays | rec_startstopdelays | Motors; 52 elements |
| Reclaim | reclaim | Control Row; 91 elements |
| Reclaim Start/Stop Delays | rcl_startstopdelays | Motors; 112 elements |
| Loadout | loadout | Control Row; 23 elements |
| Device Status (Grain) | device_status_grain | All; 111 elements |
| Device Status (Water) | device_status_water | All; 106 elements |
| Settings | settings | div + Wells and Pumps; 65 elements |
| Testing | testing | one Adjustible Gauge named Well 1 Flow rate |
| testing grounds | test | Trend; 60 elements |
Navigation table listed Grain Motors, Loadout, main, Main, Outflow, Receiving, Reclaim, Settings. Both main and Main target page_main. No cleanup performed. Well 1's inspected tree contains displays/charts and no switch/button motor-control types, while Wells 2 and 3 include controls. Do not assume the three wells have identical templates.
## Water examples: Well 3
Copied operating row contains 55 elements:
| Role | Binding | Display/configuration |
| --- | --- | --- |
| Flow | water:aiWell3Flow_eu | gpm; gauge 0–25 |
| Level | water:aiWell3Lvl_eu | ft |
| Run feedback | water:well3_q_run | On/Off |
| Mode | water:well3_i_autoMode | 1 Auto / 0 Manual; separate run feedback |
| Start / Stop | water:well3_i_manStart / well3_i_manStop | each writes 1 |
| Off / On level SP | water:well3OffLvlSP / well3OnLvlSP | editable, 0–100% |
| Flow SP | water:Well3PIDSP | editable, 0–30 gpm |
| Manual speed | water:Well3SpeedRefManSP | editable, 0–90 Hz |
| Today / Yesterday volume | water:iWell3Vol_volDaily[0] / [1] | gal |
| Power | water:well3Power_kw | kW |
| Energy | water:well3Power_today_kwh / month_kwh / lastMonth_kwh | kWh |
| Historical levels | water:aiWell3LvlAgg_Past24Avg / Max / Min | ft |
Current flow/level chart navigator is water:aiWell3Flow_eu. Historical level navigator is water:aiWell3LvlAgg_Past24Avg, default button index 1. The information/map/report root is separate; preserve it during control-page replacement and do not publish its location details unnecessarily.
**Unresolved timer reference:** Well 3's Time Since Start reads `water:wellNW1_tssTmr * 1000`; editable Hours reads `water:wellNW1_totalTmr * 1000` and writes `value / 1000` to `water:wellNW1_totalTmr`. These names differ from the Well 3 family. Verified in copied JSON; intended PLC mapping remains unknown. No reset/write was made.
## Valve, compressor and boiler
House Valve:
- Feedback reads `water:doHouseVlvOp` and `water:doHouseVlvCl`.
- Mode `water:HouseVlvAuto`, 1/0.
- Open / Close / Stop → `water:HouseVlvCmdOpen` / `HouseVlvCmdClose` / `HouseVlvCmdStop`, each 1.
- Maintain Pressure `water:spHousePrs` and Deadband `water:spHouseVlvCtrlDb`, direct editable values with configured limits 0–100 psi.
Air Compressor:
- Feedback `water:AirComp_q_run`; mode `AirComp_i_autoMode`, 1/0.
- Start/Stop → `water:AirComp_i_manStart` / `AirComp_i_manStop`, each 1.
- On Time displays `water:AirCompTimeSP * 1000` in Timespan (ms), writes `value / 1000`. Preserve conversion symmetry.
Boiler:
- Pressure `water:aiBoilerPrs_eu`, psi.
- Water temperature `water:aiBoilerTe_eu`, °F.
- Outside temperature `water:aiAmbianteu`, °C.
- Trend uses separate case-sensitive scales `temp` (0–200 °F), `psi` (0–20), `Temp` (-40–40 °C), navigator water:aiBoilerTe_eu.
- Internal element names such as Well 3 Water Temp / boiler water temp do not reliably describe their displayed binding.
## Grain sequences
| Function | Receiving | Reclaim |
| --- | --- | --- |
| Status | grain:g_rec_out_status | grain:g_rcl_out_status |
| Destination/source selection | grain:g_b_recDstIdx | grain:g_b_rclSrcIdx |
| Start | grain:g_rec_in_manStart = 1 | grain:g_rcl_in_manStart = 1 |
| Normal stop | grain:g_rec_in_manStop = 1 | grain:g_rcl_in_manStop = 1 |
| Rapid stop | grain:g_hmiRecRpdStp = 1 | grain:g_hmiRclRpdStp = 1 |
| Timed-stop value | grain:g_rec_in_manOnMaxSP | grain:g_rcl_in_manOnMaxSP |
Both timed-stop fields use Timespan (ms), direct writeValue=value, configured limits 0–356400000 and HH:mm:ss. Their disable buttons write 0 to the same target. Receiving enable uses grain:g_recEn (1/0). Its chart includes M01/M03/M04 speed % and current A; navigator grain:g_m01_out_current.
Receiving also shows M02Temp, M01, M02, M03, M04 feedback. M03 current control uses grain:g_m03CurCtlEn, g_m03CurSp, g_m03PID_Kp and g_m03PID_Tn. Kp/Tn limits=false despite populated 0/100 fields. Tn's displayed suffix is KP, a possible label issue left unchanged.
Reclaim includes M21–M29 run feedback among its motor cards. Reopen the precise motor before adapting it.
Loadout controls M41:
- Position buttons target grain:g_m41_in_autoPos with values 0,20,40,60,80,100.
- Mode grain:g_m41_in_autoMode (1/0); Open/Stop/Close grain:g_m41_in_manOpen/manStop/manClose, each 1.
- One internal name is 100% Button but its configured value is 80; another writes 100. Internal element names alone are insufficient to establish a button's behavior.
- Status expression references grain:g_m41_out_fault/open/close. No claim about physical valve movement or interlocks.
## Future use
Use Main/Settings for navigation context, the specific well for water, Receiving/Reclaim for sequence controls, and Grain Motors for individual equipment. Diagnostics contains consequential maintenance actions; inspect its element configuration without clicking the operational buttons. Treat alarms pages as UI content, not an audit of Manage Alarms definitions. Test-named pages are existing content, not authorized disposable pages.
LONE-PINE-GUIDE.md
+77
View File
@@ -0,0 +1,77 @@
# Lone Pine 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.
## Identity
Production: https://www.atomhmi.com/site_lone_pine/
Configure: https://www.atomhmi.com/site_lone_pine/configure_pages
The global selector labels this site Lone Pine. The user's “Lonepint” request was resolved to that visible site. A development counterpart was not verified.
All 16 page trees were opened and native root Copy was used across the catalog. Exact representative bindings below were read from copied JSON; not every copied field is reproduced here. Main navigation has Dryer → page_control, Recycling → page_rec_control, Overview → page_overview; Overview appeared in the configuration table but not the observed top bar. Do not infer the default flag from blank table text.
## Page map
| Configure label | Slug | Observed roots / purpose |
| --- | --- | --- |
| 1- Dryer Overview | dry_overview | Site Select, Temperatures, Video Row |
| 2- Dryer Control | control | Site Select, Temperatures, Settings, Control Row |
| 3- Dryer Motors | motors | Site Select + M01–M17 and M21–M23 motor roots |
| 4- Dryer Trend | trend | Site Select, Temperatures, VFDs, Temperature Trend Row |
| 5- Dryer Settings | settings | Site Select, Walking Floor Settings, Fuel Auger Settings |
| 6- Dryer Device Status | dry_device_status | All; CPU, disk, memory, Pi status and service actions |
| 7- Recycling Overview | rec_overview | Site Select, alllllll |
| 8- Recycling Control | rec_control | Site Select, Overview Row |
| 9- Recycling Motors | rec_motors | Site Select, Recycling Motors |
| 9a- Recycling Settings | rec_settings | two roots both named Site Select |
| 9b- Rec Device Status | rec_device_status | All |
| Communications | comms | Walking Floor Settings |
| Dryer Video | dry_video | Site Select, Video Row |
| Overview | overview | Main Selection; shaker, recycling, dryer and motors cards |
| Temperatures | temperatures | Temperatures |
| Test | test | Reset; no claim that it is disposable |
Some actual Title fields have extra spaces after the number; dropdown labels normalize that spacing. Select by the observed catalog label and verify Title/URL after loading.
## Dryer bindings
Device prefix `sawdust_dryer`. The Control page has a 9-element Control Row:
- Start → `sawdust_dryer:drySeqUserStart` = 1.
- Stop → `sawdust_dryer:drySeqUserStop` = 1.
- Emergency Shutdown → `sawdust_dryer:drySeqUserESD` = 1.
- Pause → `sawdust_dryer:drySeqUserPause` = 1.
- Sequence status reads `|{register:sawdust_dryer:drySeqStatus}|`.
The 15-element Temperatures root uses:
| Role | Configured binding | Units |
| --- | --- | --- |
| Burner gauge | sawdust_dryer:AIBurnerTempEU | °F |
| Inlet gauge | sawdust_dryer:AIInletTempEU | °F |
| Outlet gauge | sawdust_dryer:AIOutletTempEU | °F |
| Startup wait threshold | sawdust_dryer:StartupWaitTemp read/updateRegister | °F |
| Startup wait enable | sawdust_dryer:startupTempWait, On 1 / Off 0 | binary |
| Fuel auger inlet target | sawdust_dryer:FuelAugInletTarget read/updateRegister | °F |
| Outlet/walking-floor target | sawdust_dryer:WalkingFloor_Target read/updateRegister | °F |
Gauges use the short expression form `|{sawdust_dryer:AIBurnerTempEU}|`; other elements use the register-prefixed form. Preserve supported syntax.
The Control preview includes fuel-auger speed control, burner-fan Hz, walking-floor/U-trough speed control, fill/empty seconds and temperature/VFD history. This is a useful combined temperature/sequence example.
## Recycling bindings
Device prefix `recycling`. Control's Overview Row has 143 elements. It contains separate stage controls:
- Stage 1 Start/Stop → `recycling:recycStg1_in_manStart` / `recycStg1_in_manStop`, each writes 1.
- Stage 2 Start/Stop → `recycling:recycStg2_in_manStart` / `recycStg2_in_manStop`, each writes 1.
- Bypass Mode → `recycling:recycStg2BypassMode`, 1/0.
- VecoPlan 1/2 level setpoints → `recycling:veco1LvlSet` / `veco2LvlSet`, editable direct value, limits 0–100%.
- Auto fixed speed references shown include `m0301_in_autoFixedRef`, `m0304_in_autoFixedRef`, `m0305_in_autoFixedRef`, `m0401_in_autoFixedRef`, `m0402_in_autoFixedRef`, `m0601_in_autoFixedRef`, `m0602_in_autoFixedRef`, all recycling-prefixed, editable 0–100%.
- VecoPlan level trends use `recycling:veco1Lvl_out_eu` / `veco2Lvl_out_eu` as both series and navigator; axis 0–110%, default button index 1.
## Reuse cautions and unknowns
Dryer pages contain components explicitly named (Dont Use) Numerical Button, Numerical Adjustment Button, Numerical Display and Button Set Value. Their copied JSON can contain both a legacy `register` key and `updateRegister`; for example Startup Wait Temp retains `register: sawdust_dryer:WalkingFloor_Target` while its display/updateRegister use StartupWaitTemp. The configured values are evidence; active legacy runtime behavior was not tested. Prefer supported current native components when building new pages and verify semantics before migration.
Root names can be duplicated or generic. Count roots and preserve menu, video and diagnostic sections. Do not copy the entire diagnostics root into another installation without reviewing Update/Reboot/Restart command targets. Camera/video endpoints were intentionally omitted from these notes.
Register polling/logging, controller addresses, alarm definitions/latching, safety interlocks and writable behavior were not audited. Initial runtime placeholder/NaN values populated after loading; do not diagnose disconnected equipment from an immediate preview alone. Future tasks can start from this map and inspect only the intended current subtree.
PAGE-INVENTORY.md
+53 -5
View File
@@ -1,8 +1,8 @@
# Atom HMI page inventory # Atom HMI page inventory
Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless marked incomplete, each page's preview and element tree were opened. See SITE-STUDY.md for scope limits. Original inventory observed October 20, 2026; follow-up October 21. Names are Configure Pages dropdown labels. Coverage is cumulative across those dates, not every field inspected. October 21 refreshed all seven catalogs (202 pages total), opened all 16 Lone Pine and 21 Lazy B page trees, and resolved both Sweet Grass motor-tree gaps. Exact slugs and current core page structures are in the four site guides. See SITE-STUDY.md for scope limits.
## Sweet Grass — 51 listed, 49 inspected ## Sweet Grass — 51 listed; all trees covered across October 20–21
- 20' Loading - 20' Loading
- Air Screen - Air Screen
@@ -26,7 +26,7 @@ Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless
- Indents - Indents
- Maintenance - Maintenance
- Modes - Modes
- Motors — rendered page inspected; element tree incomplete because editor timed out - Motors — tree inspected October 21: 1,435 elements; native root Copy verified
- Office - Office
- old Air Screen - old Air Screen
- old Bin 2 - old Bin 2
@@ -35,7 +35,7 @@ Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless
- old Dust Collection - old Dust Collection
- old Grader - old Grader
- old Indents - old Indents
- old Motors — incomplete: editor timed out - old Motors — tree inspected October 21: 1,246 elements; native root Copy verified
- old Paddy Table - old Paddy Table
- old Precleaner - old Precleaner
- old Screenings - old Screenings
@@ -56,7 +56,7 @@ Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless
- Start Stop Delays - Start Stop Delays
- testing - testing
## KAV Main - Mill — 42 inspected ## KAV Main - Mill — 43 listed; 42 studied October 20, additional page inspected October 21
- Bin Inventory - Bin Inventory
- Bins - Bins
@@ -68,6 +68,7 @@ Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless
- Maintenance - Maintenance
- Mill 2 - Mill 2
- Mill 2 Settings - Mill 2 Settings
- Mill 2 Test — additionally observed October 21; slug mill_2_test, diagram subtree
- Mill2Debug - Mill2Debug
- Motors - Motors
- Out Pump 1 - Out Pump 1
@@ -180,3 +181,50 @@ Observed October 20, 2026. Names are the Configure Pages dropdown labels. Unless
- Well 29 - Well 29
- Well 30 - Well 30
- Wells - Wells
## Lone Pine — 16 trees inspected October 21
See LONE-PINE-GUIDE.md for slugs, roots and bindings.
- 1- Dryer Overview
- 2- Dryer Control
- 3- Dryer Motors
- 4- Dryer Trend
- 5- Dryer Settings
- 6- Dryer Device Status
- 7- Recycling Overview
- 8- Recycling Control
- 9- Recycling Motors
- 9a- Recycling Settings
- 9b- Rec Device Status
- Communications
- Dryer Video
- Overview
- Temperatures
- Test
## Lazy B Farm & Ranch — 21 trees inspected October 21
See LAZY-B-GUIDE.md for slugs, roots and bindings.
- Air Compressor
- Alarms
- Boiler
- Device Status (Grain)
- Device Status (Water)
- Grain Alarms
- Grain Motors
- House Valve
- Loadout
- Main
- Outflow
- Receiving
- Receiving Start Stop Delays
- Reclaim
- Reclaim Start/Stop Delays
- Settings
- Testing
- testing grounds
- Well 1
- Well 2
- Well 3
PROJECT.md
+18
View File
@@ -30,3 +30,21 @@ This repository is the shared home for project instructions, confirmed facts, an
- Atom HMI Editor cloud Space: https://chatgpt.com/space/page_6ad8d4bee7fc8191ba246a2fdf29a5bf - Atom HMI Editor cloud Space: https://chatgpt.com/space/page_6ad8d4bee7fc8191ba246a2fdf29a5bf
Keep site guides current during project work and reconcile cloud/repository edits before overwriting either. There is no automatic synchronization. Keep site guides current during project work and reconcile cloud/repository edits before overwriting either. There is no automatic synchronization.
## Standard workflow and expanded site context — October 21, 2026
All Atom HMI UI work uses dev.atomhmi.com or atomhmi.com; the browser's observed production host is www.atomhmi.com. Use Atom GIT to open Auto/atom-hmi-ui-chatgpt (default branch master). Read AGENTS.md, PROJECT.md, HANDOFF.md and the relevant site guide before work. Update guides with verified discoveries/changes and commit them remotely after each substantive task. Browser sign-in remains device-specific.
New production guides:
- KAV-GUIDE.md — all four KAV sites; Mill Main catalog 43, Mill East 4, Water Main 29, Water East 38.
- LONE-PINE-GUIDE.md — visible selector Lone Pine (the “Lonepint” request), site_lone_pine, 16 pages; sawdust_dryer and recycling bindings.
- LAZY-B-GUIDE.md — site_lazy_b, 21 pages; water and grain bindings.
- SWEET-GRASS-GUIDE.md — site_sweetgrass, 51 pages; previously missing motor trees now inspected.
These guides replace repeated initial reconnaissance. Verify the current target page and affected bindings before edits, without repeating the full baseline survey. Counts are dated observations, not fixed application guarantees. The October 21 task changed documentation only.
Cloud guide links:
- [KAV-GUIDE.md](https://chatgpt.com/space/page_d9313668d27c81919b7c480852c0c082)
- [LONE-PINE-GUIDE.md](https://chatgpt.com/space/page_814209734aa88191bede6b68a663098e)
- [LAZY-B-GUIDE.md](https://chatgpt.com/space/page_de033ca7a7b881918b94f89dddea9820)
- [SWEET-GRASS-GUIDE.md](https://chatgpt.com/space/page_c260b18f6fc08191b2f64da8e5b97182)
README.md
+9
View File
@@ -18,3 +18,12 @@ Original screenshots, register inventories, page templates and audits remain at
- Shop development: https://dev.atomhmi.com/site_atom/ - Shop development: https://dev.atomhmi.com/site_atom/
Keep site-specific authorization and exclusions in force; the Shop atGVL_alarmManager is excluded from editing. Keep site-specific authorization and exclusions in force; the Shop atGVL_alarmManager is excluded from editing.
## Production site context — October 21, 2026
- [KAV, all four sites](KAV-GUIDE.md)
- [Lone Pine](LONE-PINE-GUIDE.md)
- [Lazy B Farm & Ranch](LAZY-B-GUIDE.md)
- [Sweet Grass](SWEET-GRASS-GUIDE.md)
Use these guides before repeating initial site discovery. PAGE-INVENTORY.md is the cumulative catalog; SITE-STUDY.md records dated scope. Work environments are dev.atomhmi.com and atomhmi.com (observed production host www.atomhmi.com). The repository's default branch is master.
SITE-STUDY.md
+17 -7
View File
@@ -2,7 +2,17 @@
Inspected through the signed-in browser on October 20, 2026. Purpose: prepare to build another Atom HMI installation using existing page patterns and copy/paste. No pages, registers, alarms, device connections, or element definitions were saved or changed. The element Copy control was exercised once; no paste was performed. Inspected through the signed-in browser on October 20, 2026. Purpose: prepare to build another Atom HMI installation using existing page patterns and copy/paste. No pages, registers, alarms, device connections, or element definitions were saved or changed. The element Copy control was exercised once; no paste was performed.
## Coverage ## October 21, 2026 follow-up
Read the site-specific guides before future work: [KAV](KAV-GUIDE.md), [Lone Pine](LONE-PINE-GUIDE.md), [Lazy B](LAZY-B-GUIDE.md), [Sweet Grass](SWEET-GRASS-GUIDE.md). They record production URLs, page slugs, roots, representative register bindings, units/conversions and unresolved issues. Start with the relevant guide and current target subtree; the general discovery survey does not need to be repeated.
Catalogs now cover 202 pages: KAV Main Mill 43, East Mill 4, Main Water 29, East Water 38, Sweet Grass 51, Lone Pine 16, Lazy B 21. The table below is the **historical October 20 coverage**, not a claim that every page was revisited October 21. The follow-up opened all Lone Pine/Lazy B/East Mill trees, refreshed selected active KAV/Sweet Grass trees, inspected the newly listed Mill 2 Test, and resolved both Sweet Grass motor-tree gaps.
Scope was production Configure Pages and native Copy inspection only. No pastes, site saves, register writes, device actions or operational tests. Development equivalence was not checked. User's two work environments are dev.atomhmi.com and atomhmi.com (observed production host www.atomhmi.com).
Notable unresolved findings: Well 10 New chlorine display reads g_well10ChemPPM but writes g_well1ChemPPM; Lazy B Well 3 timer fields reference wellNW1; East Water Wells has two Well 29 series, one bound to Well 30. These are documented, unchanged configurations, not verified corrections.
## Original October 20 coverage
| Site | Pages listed | Page trees inspected | Main use | | Site | Pages listed | Page trees inspected | Main use |
| --- | ---: | ---: | --- | | --- | ---: | ---: | --- |
@@ -13,9 +23,9 @@ Inspected through the signed-in browser on October 20, 2026. Purpose: prepare to
| KAV East - Water (`site_kav_east_water`) | 38 | 38 | Multiple cisterns, transfers, distribution circuits, wells, temperature | | KAV East - Water (`site_kav_east_water`) | 38 | 38 | Multiple cisterns, transfers, distribution circuits, wells, temperature |
| Total | 164 | 162 | | | Total | 164 | 162 | |
Coverage means opening each page in Configure Pages and inspecting its rendered preview and element names/types. It does not mean every element's settings were opened or every runtime control tested. Sweetgrass `Motors` and `old Motors` timed out in their large editors and remain incomplete. Representative configuration dialogs were inspected for rows, status indicators, gauges, trends, numeric data, command buttons, viewports, and images. All dialogs were closed without saving. No source-code or backend API access was established. Coverage means opening each page in Configure Pages and inspecting its rendered preview and element names/types. It does not mean every element's settings were opened or every runtime control tested. Sweetgrass `Motors` and `old Motors` timed out in the original study; both trees and native root Copy were successfully inspected on October 21 (see SWEET-GRASS-GUIDE.md). Representative configuration dialogs were inspected for rows, status indicators, gauges, trends, numeric data, command buttons, viewports, and images. All dialogs were closed without saving. No source-code or backend API access was established.
The rendered Sweetgrass Motors page was successfully inspected separately after the builder timeout. It repeats motor-ID/name cards with Auto/Manual, Start/Stop, time since start, and optional frequency adjustment; the South Elevator Valve has Rev/Stop/Fwd and raw position. Its element tree and exact write bindings remain unverified. The rendered Sweetgrass Motors page was successfully inspected separately after the builder timeout. It repeats motor-ID/name cards with Auto/Manual, Start/Stop, time since start, and optional frequency adjustment; the South Elevator Valve has Rev/Stop/Fwd and raw position. Its element tree and representative write bindings were subsequently verified on October 21; see SWEET-GRASS-GUIDE.md. Physical command behavior remains untested.
The complete page-name inventory is in `PAGE-INVENTORY.md`. The complete page-name inventory is in `PAGE-INVENTORY.md`.
@@ -36,7 +46,7 @@ The builder requires cancelling or saving the currently selected page before sel
Pages are nested trees. Rows and Divs contain labels, indicators, readouts, buttons, gauges, links, charts, or other containers. The Overview page is a good small example: a Main Selection row contains equipment cards, and each card includes a title, separator, status indicator, and page link with a settings icon. Pages are nested trees. Rows and Divs contain labels, indicators, readouts, buttons, gauges, links, charts, or other containers. The Overview page is a good small example: a Main Selection row contains equipment cards, and each card includes a title, separator, status indicator, and page link with a settings icon.
The UI exposes element copy, paste, reorder, add, edit, and delete controls; there are also page-level Add Element and Paste Element controls. The copy icon was confirmed as `fa-copy`, and paste as `fa-paste`. Copying the top row of KAV East Water Wells left the browser text clipboard empty. **Inference:** the builder uses an application-managed clipboard or another mechanism. Its serialization, child-copy behavior, persistence across navigation, and cross-site compatibility have not been verified. Do not promise external JSON paste until a disposable-page test confirms it. The UI exposes element copy, paste, reorder, add, edit, and delete controls, including page-level Add Element and Paste Element. **Correction, October 21:** native Copy exports plain-text JSON with id, name, type, data and nested elements. Successful copies across KAV, Lone Pine, Lazy B and Sweet Grass supersede the earlier inference from an empty clipboard. Verify the copied root id/name before using it. A root copy includes that subtree, not the page's other roots. This survey used Copy only; see ATOMHMI-PLAYBOOK.md for earlier authorized development paste tests.
Styling uses Classes and Styles. Observed classes include `col-6`, `col-12`, `w-100`, `h-100`, `border`, `rounded`, `badge`, `badge-pill`, `bg-danger`, `bg-warning`, `bg-on`, `bg-off`, `btn-start`, and `btn-entry`. These resemble Bootstrap conventions plus application-specific classes. Reuse the parent container's spacing and widths instead of reconstructing each child independently. Styling uses Classes and Styles. Observed classes include `col-6`, `col-12`, `w-100`, `h-100`, `border`, `rounded`, `badge`, `badge-pill`, `bg-danger`, `bg-warning`, `bg-on`, `bg-off`, `btn-start`, and `btn-entry`. These resemble Bootstrap conventions plus application-specific classes. Reuse the parent container's spacing and widths instead of reconstructing each child independently.
@@ -126,11 +136,11 @@ Manage Elements lists 46 component definitions, with five marked “Dont Use.”
## Remaining evidence needed ## Remaining evidence needed
- Sweetgrass Motors and old Motors trees, which timed out. - Resolved October 21: Sweetgrass Motors (1,435 elements) and old Motors (1,246) trees and native root Copy. See SWEET-GRASS-GUIDE.md.
- Actual application clipboard format, nested copy semantics, and cross-site paste behavior. - Clipboard JSON format and subtree copying are verified; cross-site paste behavior still requires destination-specific validation. This production survey did not paste.
- A controlled new-page save/reopen test and navigation/default-page test. - A controlled new-page save/reopen test and navigation/default-page test.
- Intended new installation's equipment, controller tags, units, ranges, and command mapping. - Intended new installation's equipment, controller tags, units, ranges, and command mapping.
- Required alarm/notification rules, user roles, history retention, and exports. - Required alarm/notification rules, user roles, history retention, and exports.
- Whether a supported Atom HMI API or import/export interface can replace browser editing for a standalone agent. No such interface was verified in this study. - Whether a supported Atom HMI API or import/export interface can replace browser editing for a standalone agent. No such interface was verified in this study.
This survey establishes a browser editing approach and a template map. It does not yet establish a fully tested autonomous editing agent. This survey establishes a browser editing approach and a template map. It does not yet establish a fully tested autonomous editing agent.
SWEET-GRASS-GUIDE.md
+69
View File
@@ -0,0 +1,69 @@
# Sweet Grass 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.
## Identity and coverage
Production: https://www.atomhmi.com/site_sweetgrass/
Configure: https://www.atomhmi.com/site_sweetgrass/configure_pages
Catalog remains 51 pages. PAGE-INVENTORY.md preserves the full list from October 20. October 21 refreshed the catalog and selected active pages, resolving both previous motor-tree inspection gaps. Combined historical coverage now includes every listed page tree, but this is not an audit of every element's behavior.
## Useful starting pages
| Page | Slug | Roots / element count observed October 21 |
| --- | --- | --- |
| Overview | overview | Main Selection; 49 |
| Center Receiving | center_receiving | Control Row; 228 |
| South Receiving | south_receiving | Control Row; 83 |
| Receiving Sequence | receiving_sequence | Control Row; 100 |
| Crimping | crimping | Control Row; 103 |
| Groater | groater | Control Row; 313 |
| Shipping | shipping | Control Row; 103 |
| dryer | dryer | Dryer Chart Div + Overview Row; 137 |
| Power Main | power_main | Menu + Main Row + Table; 186 |
| Power Dryer | power_dryer | Menu + Main Row + Table; 186 |
| Motors | motors | Motors; 1,435 |
| old Motors | old_motors | Motors; 1,246 |
| Receiving PID Tuning | receiving_pid_tuning | no roots/elements |
Use Overview for compact status cards; Center/South Receiving for routing and sequence controls; Groater for dropdown and equipment control; Shipping for four-state indicators and destination selection; dryer for chart-plus-controls; Power pages for chart/readouts/tables. Empty Receiving PID Tuning is not an established tuning interface.
## Motor tree gap resolved
Motors and old Motors both loaded on October 21. Native Copy exported each whole root; active Motors has 103 direct children and old Motors has 83. These include menu/group structure, so do not interpret the counts as a proven motor count.
Active groups include dryer-style m02_01 through m90 families and other groups named M001, M002, M016, M101, M202, M301, etc. Group names and prefixes differ; inspect each intended unit rather than applying one global rename.
Representative active dryer motor m02_01:
| Function | Configured binding |
| --- | --- |
| Auto/Manual | main:dryer_g_m02_01_in_autoMode; 1/0 |
| Start | main:dryer_g_m02_01_in_manFwd; writes 1 |
| Stop | main:dryer_g_m02_01_in_manStop; writes 1 |
| Hertz display | main:dryer_g_m02_01_out_speedActHz |
| Hertz write target | main:dryer_g_m02_01_in_manSpeedRef; direct value |
| Time since start | main:dryer_g_m02_01_out_tss multiplied by 1000; non-editable HH:mm:ss |
The editable Hertz field intentionally separates actual-speed display from manual demand target. A configured target on the non-editable time display does not authorize writing an output.
For large trees, use the root's direct Copy control rather than resolving every descendant button. Reload a clean Configure Pages session before each large page; accumulated previews caused timeouts during this survey. See ATOMHMI-PLAYBOOK.md.
## Prior verified context retained
The October 20 study in SITE-STUDY.md established:
- Device IDs global (Global) and main (Main PC).
- Main PC slave labels Codesys PLC, Groater PLC, Main PLC, SG Dryer, Shipping PLC, Terminal.
- Page → device-qualified register → slave → PLC tag mapping. Register presence does not establish enabled/updating/logged state.
- Overview's six-state indicator references main:dryer_g_m77_01_out_status.
- Center Receiving Start targets main:recvSeqStart with value 1.
- A Center Receiving ratio reads main:dryer_g_centRecBin21Ratio but writes main:dryer_g_centRecBin21RatioSel, writeValue=value. Limits checkbox was false despite populated 0/100.
- Sample dryer status address: tag sg_dryer.g.m77_01.out_status; enabled On Change/one-second polling, logging disabled in that earlier inspected definition.
These are dated prior observations, not a new register-table audit on October 21. The prior counts of 20,055 register definitions and 1,538 alarm definitions are historical, not freshly verified totals.
## Future work boundaries
Use this guide and the earlier full catalog instead of repeating the general survey. Verify current Title/slug and the particular subtree before editing. Preserve roots, location anchors, read/write distinctions, state mappings, chart series/scales/navigator and time conversions.
No PLC commands, setpoint writes, motor tests, alarm-latching changes or device actions were performed. History retention, alarm notification/latching and physical interlocks remain outside this survey. Old/test page names do not establish which content is current or safe to modify.