DSC-BRAIN USER GUIDE · DOCS MAINTENANCE
Source-of-truth map
Which repo files and docs feed which guide sections, so a changed file maps straight to the pages to review.
● verified for 9.0.0 · firmware train 8.2.0.0
● last verified 2026-09-17 · mirrored 2026-09-15
The repository is private. Paths are relative to its root.
| Area | Files | Guide pages to review |
|---|---|---|
| Versions | brain/dsc_brain/__init__.py, brain/dsc_brain/paths.py, RELEASE.md, CHANGELOG.md |
Welcome; Versions explained; Flash the SD image; every page's verified-for stamp |
| Navigation and desks | frontend/src/routes.ts, frontend/src/components/chrome.tsx, frontend/src/App.tsx |
Navigation; Routes and deep links; Preferences |
| Desk pages | frontend/src/pages/.tsx, frontend/src/components/.tsx (grep label=, title=, HelpTip) |
The matching desk page in section 2 |
| Settings | frontend/src/pages/settings/.tsx, settingsIndex.ts, frontend/src/components/settings/.tsx, brain/dsc_brain/settings.py, settings_manifest.py, hub_tunables.py |
Section 3, one page per settings section |
| Setup wizard | frontend/src/pages/SetupPage.tsx, brain/dsc_brain/kit_commission.py, usb_flash.py, SETUP.md, README.md |
Setup wizard; Flashing devices; Fleet Wi-Fi join |
| Alerts | brain/dsc_brain/alert_prefs.py, alert_acks.py, alert_presets.py, hazard_alarms.py, hazard_cutoff.py, frontend/src/pages/LiveMissionPage.tsx |
Alerts desk; Settings › Alerts; Alert catalogue; Troubleshooting pages |
| Climate and ladder | firmware/v4/dsc-hub-v4_0.yaml, brain/dsc_brain/hub_native.py, decision_loop.py, appliance_driver.py, hub_failover.py, climate_mode.py, docs/DSC-BRAIN.md |
Climate desk; Who decides what; The climate ladder; Plugs and appliances |
| Light | brain/dsc_brain/light_loop.py, light_plug.py, schedule_shift.py, dli_estimate.py, frontend/src/pages/LightPage.tsx, LampRollOn.tsx |
Light desk; Photoperiod; Lamp surprises |
| Root and probes | brain/dsc_brain/root_steering.py, irrigact.py, plant_probe.py, soil_tests.py, runoff_tray.py, ingest_cadence.py, sensor_trust.py |
Root desk; Settings › Root; Settings › Sensors; Sensor trust; Probe dark |
| Plants and catalog | brain/dsc_brain/compose_ops.py, stage_model.py, harvest_window.py, strain_profile.py, catalog*.py, libs.py, nutelib_feed.py, docs/ops/LIBRARIES.md, frontend/src/components/settings/LibrariesCard.tsx, frontend/src/pages/GrowPages.tsx, PlantWizard.tsx |
Plants; CannaLib desk; Plants, stages, harvest window and DLI; Settings › Integrations; Updating; Glossary |
| Journals | brain/dsc_brain/journal.py, journal_actions.py, journal_media.py, journal_reminders.py, journal_storage.py, frontend/src/components/journal/* |
Logs desk; Journals, reminders; Journal actions; Storage |
| Automation | brain/dsc_brain/automation_rules.py, automation_defaults.py |
Settings › Automation |
| Zigbee, Tuya and Bluetooth LE | brain/dsc_brain/zigbee_*.py, climate_placement.py, placement_model.py, tuya_*.py, ble_ingest.py, device_match.py, hazard_cutoff.py, frontend/src/pages/settings/DevicesSettingsPage.tsx, docs/ops/ZIGBEE-RECOVERY.md, docs/ops/TUYA-LOCAL-SETUP.md |
Zigbee setup; Tuya setup; Zigbee and Tuya (how it works); the two troubleshooting pages |
| Cameras | brain/dsc_brain/cameras.py, docs/cameras.md, frontend/src/components/settings/CamerasCard.tsx |
Cameras (setup); Cameras (viewing); Camera shows no frame |
| Twin | frontend/src/pages/TwinPage.tsx, TwinKioskPage.tsx, frontend/src/lib/twinLenses.ts, frontend/src/twin/, docs/design/plan-twin-v3-.md |
Twin desk; Known limitations; Routes and deep links |
| Updates and toolchain | UPGRADE.md, docs/ops/ESPHOME-TOOLCHAIN.md, brain/dsc_brain/kit_update.py, esphome_toolchain.py, esphome_jobs.py, services/dsc-hub/pi/*.sh, services/dsc-hub/docker-compose.yml |
Updating; Updates fail; Addresses and ports |
| Backup, reset, system | brain/dsc_brain/backup_ops.py, setup_profile.py, factory_reset.py, system_info.py, system_ops.py, network_apply.py, SystemCards.tsx |
Settings › Network and System; Backup and restore; Storage |
| Demo | brain/dsc_brain/demo_mode.py, demo_simulator.py, demo_history.py, services/dsc-hub/README.md |
Demo mode |
Not sources
docs/design/plan-.md (intent, not shipped behaviour), docs/qa/ (historical audits), _Archive_Legacy_Code, INSTALL.md and docs/HA-SCAFFOLD.md (retired Home Assistant lab). 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