nick/overland-controller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
overland-controller/docs/waveshare-5b-bringup-checklist.md
T

2.3 KiB
Raw Permalink Blame History

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.

Reference in New Issue View Git Blame Copy Permalink