Updated Project Files (markdown)

Project-Files.md

@@ -267,36 +267,36 @@ cc-mek-scada/
 │   └── threads.lua                  - PLC runtime "threads" (co-routines, main app)
 ├── rtu/
 │   ├── dev/
-│   │   ├── boilerv_rtu.lua
-│   │   ├── envd_rtu.lua
-│   │   ├── imatrix_rtu.lua
-│   │   ├── redstone_rtu.lua
-│   │   ├── sna_rtu.lua
-│   │   ├── sps_rtu.lua
-│   │   └── turbinev_rtu.lua
+│   │   ├── boilerv_rtu.lua          - boiler [valve] RTU interface
+│   │   ├── envd_rtu.lua             - environment detector RTU interface
+│   │   ├── imatrix_rtu.lua          - induction matrix RTU interface
+│   │   ├── redstone_rtu.lua         - redstone RTU interface
+│   │   ├── sna_rtu.lua              - solar neutron activator RTU interface
+│   │   ├── sps_rtu.lua              - supercritical phase shifter RTU interface
+│   │   └── turbinev_rtu.lua         - turbine [valve] RTU interface
 │   ├── panel/
-│   │   ├── front_panel.lua
-│   │   └── style.lua
-│   ├── config.lua
-│   ├── databus.lua
-│   ├── modbus.lua
-│   ├── renderer.lua
-│   ├── rtu.lua
-│   ├── startup.lua
-│   └── threads.lua
+│   │   ├── front_panel.lua          - RTU front panel UI
+│   │   └── style.lua                - styling constants for RTU UI
+│   ├── config.lua                   - RTU configuration file
+│   ├── databus.lua                  - front panel PSIL
+│   ├── modbus.lua                   - MODBUS comms protocol and I/O control handling
+│   ├── renderer.lua                 - GUI renderer control
+│   ├── rtu.lua                      - RTU core functions: comms and RTU unit init
+│   ├── startup.lua                  - RTU startup application
+│   └── threads.lua                  - RTU runtime "threads" (co-routines, main app)
 ├── scada-common/
-│   ├── comms.lua
-│   ├── constants.lua
-│   ├── crash.lua
-│   ├── crypto.lua
-│   ├── log.lua
-│   ├── mqueue.lua
-│   ├── ppm.lua
+│   ├── comms.lua                    - system communications protocol and packet constructors
+│   ├── constants.lua                - system-wide constants, safety thresholds, and conversion factors
+│   ├── crash.lua                    - crash message handling
+│   ├── crypto.lua                   - cryptographic engine
+│   ├── log.lua                      - system logging
+│   ├── mqueue.lua                   - message queue object
+│   ├── ppm.lua                      - PPM - protected peripheral manager
 │   ├── psil.lua                     - PSIL - publisher-subscriber interface layer
-│   ├── rsio.lua
-│   ├── tcd.lua
-│   ├── types.lua
-│   └── util.lua
+│   ├── rsio.lua                     - redstone I/O mappings and helper functions
+│   ├── tcd.lua                      - TCD - timer callback dispatcher (call functions after a delay)
+│   ├── types.lua                    - common data types and constructors
+│   └── util.lua                     - system utility functions (prints, math, strings, clock & watchdog timers, etc)
 ├── supervisor/
 │   ├── panel/
 │   │   ├── components/