Files
overland-controller/docs/hardware-status.md
T

408 lines
5.2 KiB
Markdown

# Hardware Status
Last Updated: 2026-06-03
--------------------------------------------------
## Dashboard Hardware
### Raspberry Pi Pico 2 W
Status:
- Ordered
Purpose:
- Dashboard controller
- Touchscreen UI
- Audible alarms
- UART communications
Notes:
- Waiting for delivery
--------------------------------------------------
### 3.5 Inch Touchscreen
Display Controller:
- ST7796S
Touch Controller:
- FT6336U
Status:
- Ordered
Purpose:
- Main dashboard display
Testing Required:
- Display initialization
- Touch functionality
- Performance testing
--------------------------------------------------
### Active 5V Buzzer
Status:
- Ordered
Purpose:
- Audible alarms
Testing Required:
- Alarm volume
- Dashboard mounting location
--------------------------------------------------
## Controller Hardware
### ESP32 2-Channel Relay Board
Status:
- On Hand
Purpose:
- Relay control
- Sensor collection
- Communications
Known Information:
GPIO16 = Relay Output 1
GPIO17 = Relay Output 2
Relay ON = HIGH
Relay OFF = LOW
Testing Required:
- Verify relay operation
- Verify startup behavior
--------------------------------------------------
## Communications Hardware
### CAT5 Cable
Status:
- On Hand
Purpose:
- Dashboard power
- UART communications
- Ignition sense
--------------------------------------------------
### RS485 Modules
Status:
- Ordered
Purpose:
- Future fallback communication
Current Plan:
- Not used initially
Testing Required:
- Only if UART proves unreliable
--------------------------------------------------
## Sensor Hardware
### DS18B20 Waterproof Sensors
Quantity:
- 4
Status:
- Ordered
Assignments:
Sensor 1
- Fridge Zone 1
Sensor 2
- Fridge Zone 2
Sensor 3
- Rear Seat Area
Sensor 4
- Outside Air
Testing Required:
- Address discovery
- Temperature validation
--------------------------------------------------
## Power Hardware
### 12V To 5V Buck Converter
Status:
- Planned
Purpose:
- Dashboard power
Requirements:
Input:
- Vehicle 12V
Output:
- 5V
Recommended:
- 3A minimum
--------------------------------------------------
### Bosch Relays
Status:
- Planned
Purpose:
- Starlink power
- Fridge power
Future:
- Inverter
- Camp lights
Requirements:
- 30A or 40A automotive relays
--------------------------------------------------
### Fuse Block
Status:
- Planned
Purpose:
- Circuit protection
--------------------------------------------------
## Future Hardware
### JBD / Xiaoxiang BMS
Status:
- Existing battery system
Purpose:
- Battery monitoring
Future Integration:
- BLE communications
--------------------------------------------------
### ELM327
Status:
- Future
Purpose:
- OBD-II integration
--------------------------------------------------
### GPS Module
Status:
- Future
Purpose:
- Vehicle tracking
- Trip logging
--------------------------------------------------
## Bring-Up Checklist
ESP32
[ ] Verify relay outputs
[ ] Verify WiFi AP
[ ] Verify HTTP status endpoint
[ ] Verify DS18B20 support
Pico
[ ] Display test
[ ] Touch test
[ ] Buzzer test
[ ] UART communications
Vehicle
[ ] Install CAT5 run
[ ] Install buck converter
[ ] Install relays
[ ] Install sensors
[ ] Install dashboard enclosure
--------------------------------------------------
## Notes
Current Communication Plan:
Primary:
- UART over CAT5
Backup:
- WiFi HTTP API
Fallback:
- RS485
Current UI Plan:
- Touchscreen only
- No physical buttons required
Current Logging Plan:
- No persistent logging planned
- Focus on live monitoring and alarms
## ESP32 Cargo Controller Bring-Up Results
### Date
2026-06-04
### Hardware
- ESP32 2-channel relay board
- ESP32-WROOM-32
- Integrated dual relay module
### Firmware Status
- Firmware compiles successfully
- Firmware uploads successfully
- Board boots reliably
- No watchdog resets observed
### WiFi Access Point
Status: PASS
Verified:
- AP starts correctly
- SSID visible
- Client devices can connect
- HTTP API accessible
### Status Endpoint
Status: PASS
Endpoint:
/status
Issue Found:
- Original streaming JSON implementation produced malformed responses
- Browser reported "cannot parse response"
Resolution:
- Replaced streamed response with serialized JSON string response
Result:
- Valid JSON returned successfully
### Relay Control
Status: PASS
Verified:
/relay/starlink/on
/relay/starlink/off
/relay/fridge/on
/relay/fridge/off
Results:
- Relay 1 responds correctly
- Relay 2 responds correctly
- Relay state updates correctly
- Relay state reflected correctly in status API
### Relay Default State
Issue Found:
- Fridge relay defaulted to ON
Root Cause:
bool fridge = true;
Resolution:
bool fridge = false;
Result:
- Both relays now default OFF at boot
### DS18B20 Testing
Status: BLOCKED
Hardware:
- Waterproof DS18B20 sensors
- 5 meter leads
Current Result:
- Sensors not detected
Likely Cause:
- Missing 4.7kΩ pull-up resistor on 1-Wire bus
Planned Fix:
- Install 4.7kΩ resistor between GPIO4 and 3.3V
- Retest sensor detection
### Overall Milestone Status
ESP32 Hardware Bring-Up
Status: COMPLETE
Completed:
- Boot validation
- WiFi validation
- HTTP API validation
- Relay validation
Remaining:
- DS18B20 validation after resistor installation