DSC-BRAIN USER GUIDE · DOCS MAINTENANCE
Source-of-truth map
Which parts of the product and which documents feed which guide sections, so a changed area maps straight to the pages to review.
● verified for 9.0.0 · corrected for 9.8.9 on 2026-10-01
● first mirrored 2026-09-15
The source repository is private, so each source is described in words.
| Area | Sources | Guide pages to review |
|---|---|---|
| Versions | the brain's version constant and firmware table, the release notes and the changelog | Welcome; Versions explained; Flash the SD image; every page's verified-for stamp |
| Navigation and desks | the dashboard's route table, its navigation chrome (the five-item bar and the More sheet), the space pages and its app shell | Navigation; Routes and deep links; Preferences |
| Issues, Devices and the planner | the dashboard's Issues and Devices screens, the Who is in charge and Kit model screens, and the brain's device model, planner and cut-over code | Issues; Devices and the Kit desk; Who decides what |
| Desk pages | the dashboard's page and component code (search for control labels, titles and help tips) | The matching desk page in section 2 |
| Settings | the dashboard's settings pages, their index and shared cards, and the brain's settings, settings manifest and hub tunables | Section 3, one page per settings section |
| Setup wizard | the dashboard's setup page, the brain's kit commissioning and USB flashing code, and the setup and readme documents | Setup wizard; Flashing devices; Fleet Wi-Fi join |
| Alerts | the brain's alert preferences, acknowledgements and presets, its hazard alarms and hazard cut-off, and the dashboard's Issues screen and live mission page | Alerts desk; Settings › Alerts; Alert catalogue; Troubleshooting pages |
| Climate and ladder | the hub firmware and the plug (Sonoff) firmware, the brain's native hub handling, decision loop, appliance driver, hub failover and climate mode, and the brain design document | Climate desk; Who decides what; The climate ladder; Plugs and appliances; When the brain stops: the hub and the plugs |
| Light | the brain's light loop, light plug control, schedule shift and DLI estimate, and the dashboard's light page and lamp roll-on component | Light desk; Photoperiod; Lamp surprises |
| Root and probes | the brain's root steering, irrigation, plant probe, soil tests, runoff tray, ingest cadence and sensor trust code | Root desk; Settings › Root; Settings › Sensors; Sensor trust; Probe dark |
| Plants and catalog | the brain's plant composition, stage model, harvest window, strain profile, catalogue, libraries and feed chart code, the libraries operations document, and the dashboard's libraries card, grow pages and plant wizard | Plants; CannaLib desk; Plants, stages, harvest window and DLI; Settings › Integrations; Updating; Glossary |
| Journals | the brain's journal code (actions, media, reminders, storage) and the dashboard's journal components | Logs desk; Journals, reminders; Journal actions; Storage |
| Automation | the brain's automation rules and automation defaults | Settings › Automation |
| Zigbee, Tuya and Bluetooth LE | the brain's Zigbee, placement, Tuya, Bluetooth ingest, device matching and hazard cut-off code, the dashboard's devices settings page, and the Zigbee recovery and Tuya local setup documents | Zigbee setup; Tuya setup; Zigbee and Tuya (how it works); the two troubleshooting pages |
| Cameras | the brain's camera code, the cameras document and the dashboard's cameras card | Cameras (setup); Cameras (viewing); Camera shows no frame |
| Twin | the dashboard's twin pages, lens definitions and twin scene code, and the twin design plans | Twin desk; Known limitations; Routes and deep links |
| Updates and toolchain | the upgrade document, the ESPHome toolchain document, the brain's kit update, ESPHome toolchain and ESPHome job code, and the Pi helper scripts and compose file shipped with the kit | Updating; Updates fail; Addresses and ports |
| Backup, reset, system | the brain's backup, setup profile, factory reset, system information, system operations and network code, and the dashboard's system cards | Settings › Network and System; Backup and restore; Storage |
| Demo | the brain's demo mode, demo simulator and demo history code, and the demo deployment readme | Demo mode |
Not sources
The design plan documents (intent, not shipped behaviour), the historical quality audits, the archived legacy code, the old install guide and the retired Home Assistant lab scaffold. The old engineering wiki is HA-era and is not a source for this guide.
DSC-Brain user guide · Source-of-truth map · this page is edited on the site; the Notion original was retired after the mirror