88 lines
2.3 KiB
Markdown
88 lines
2.3 KiB
Markdown
# 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.
|