Initialisation depot

ESP32/DCC-Bench/QUICK_REFERENCE.md

@@ -0,0 +1,105 @@
+# ESP32-2432S028R Quick Reference Card
+
+## 🎯 Quick Start
+1. Connect USB-C cable
+2. Display shows touchscreen UI
+3. Tap [POWER] to turn ON (green)
+4. Use slider to control speed
+5. Tap [DIR] to change direction
+
+## 📱 UI Button Guide
+
+```
+┌──────────────────────────────────────┐
+│ [POWER] [MODE] [RAILS] [DIR]        │
+└──────────────────────────────────────┘
+```
+
+### [POWER] Button
+- **Green** = Power ON → Motor/DCC active
+- **Red** = Power OFF → No output
+- Tap to toggle
+
+### [MODE] Button
+- **Cyan** = DCC Digital mode
+- **Yellow** = DC Analog mode
+- ⚠️ **Auto powers OFF when switching!**
+
+### [RAILS] Button
+- **2-Rail** = Standard configuration (relay OFF)
+- **3-Rail** = Center rail mode (relay ON)
+- Relay clicks when toggling
+
+### [DIR] Button
+- **FWD** = Forward direction
+- **REV** = Reverse direction
+- Changes immediately if powered
+
+### Speed Slider
+- Drag white knob OR tap anywhere on slider
+- Range: 0-100%
+- Real-time updates
+
+## ⚡ Pin Quick Reference
+
+| Function | GPIO | External Connection |
+|----------|------|---------------------|
+| PWM/DCC_A | 18 | LM18200 PWM (dual purpose) |
+| DIR/DCC_B | 19 | LM18200 DIR (dual purpose) |
+| Motor BRAKE | 23 | LM18200 BRAKE |
+| Relay | 4 | Relay Module IN |
+| Ground | GND | All GNDs |
+
+## 🔒 Safety Features
+
+✅ **Auto Power-Off**: Switching DCC↔Analog automatically turns power OFF  
+✅ **Emergency Stop**: Tap [POWER] button for immediate stop  
+✅ **Settings Saved**: All configurations persist after reboot  
+
+## 🚨 Important Notes
+
+- **Always power OFF before switching modes** (automatic)
+- **DCC requires booster circuit** (ESP32 outputs logic-level only)
+- **Motor controller handles high current** (not ESP32 directly)
+- **Common ground required** for all external circuits
+
+## 🛠️ Default Settings
+
+- **DCC Address**: 3 (change in code)
+- **Power**: OFF on startup
+- **Mode**: DC Analog
+- **Rails**: 2-Rail
+- **Speed**: 0%
+- **Direction**: Forward
+
+## 📊 Serial Monitor Commands
+
+Baud rate: **115200**
+
+Watch for:
+- Configuration loaded
+- Relay Controller initialized
+- Touchscreen UI initialized
+- Mode changes
+- Power state changes
+
+## 🔄 Factory Reset
+
+To reset all settings:
+1. Flash firmware with PlatformIO
+2. Settings will revert to defaults
+3. Or call `config.reset()` in code
+
+## 📞 Troubleshooting Quick Fixes
+
+| Problem | Quick Fix |
+|---------|-----------|
+| Touch not working | Adjust calibration in code |
+| Display blank | Check USB power |
+| Motor not running | Check power is ON + correct mode |
+| Relay not clicking | Verify 5V power to relay |
+| Settings not saving | Check NVS partition |
+
+---
+
+**Tip**: Keep this card handy near your test bench!