# 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