# Waveshare ESP32-S3 Touch LCD 5B Bring-Up Checklist

Use this checklist when the Waveshare ESP32-S3 Touch LCD 5B arrives.

## Hardware Target

Selected dashboard hardware:

- Waveshare ESP32-S3 Touch LCD 5B
- 5-inch touchscreen
- 1024x600 display
- ESP32-S3
- USB-C
- Capacitive touch
- Integrated CAN transceiver available for future vehicle work

## Bring-Up Goal

Confirm the display works as a standalone dashboard platform before integrating it with the Cargo ESP.

Do not connect it to vehicle CAN, WUPP, Cargo ESP wiring, or external sensors during first bring-up.

## First Bench Test

- [ ] Inspect board for shipping damage
- [ ] Confirm exact board variant is 5B / 1024x600
- [ ] Connect by USB-C only
- [ ] Confirm Mac detects the serial/USB device
- [ ] Flash or run a known-good Waveshare demo first
- [ ] Confirm display backlight turns on
- [ ] Confirm 1024x600 display output
- [ ] Confirm touch input works
- [ ] Confirm reset button works
- [ ] Confirm bootloader mode works if needed

Bootloader reminder:

- Hold BOOT
- Connect USB-C
- Release BOOT
- Flash firmware
- Press RESET after flashing

## Arduino Settings To Verify

When using Arduino examples, verify settings match the 5B hardware:

- Flash: 16MB
- PSRAM: 8MB OPI / enabled
- Board package supports ESP32-S3
- Correct USB/serial port selected

## ESP-IDF / LVGL Notes

The 5B is large enough that UI performance matters.

Early dashboard work should favor:

- Simple LVGL screens
- Large readable labels
- Low redraw areas
- Static layout before animation
- API polling before complex live graphs

## First Project-Specific Test

Before building the full dashboard, create a simple local screen that shows:

- Dashboard boot status
- WiFi status placeholder
- Cargo API base: `/api/v1`
- Hardware: Waveshare 5B 1024x600
- Touch test button

## First Cargo ESP Integration Test

After standalone display and touch are confirmed:

- [ ] Connect dashboard to Cargo ESP WiFi AP
- [ ] Request `/api/v1/status`
- [ ] Request `/api/v1/config`
- [ ] Display hardware profile
- [ ] Display output count
- [ ] Display relay/output list dynamically
- [ ] Display DS18B20 temperature telemetry from Cargo ESP API

The dashboard should consume Cargo ESP data. It should not directly own cargo/fridge DS18B20 sensors or relay authority.