0.1

first release

Bruce update 1.13

🧰 Hardware Requirements

• ADV Cardputer
• SPI TFT Display (ILI9341 compatible)
• Jumper wires / soldered connection
• USB cable

---

📌 External Display Pinout

SPI TFT Wiring

Signal	GPIO
MOSI	GPIO 13
SCLK	GPIO 15
CS	GPIO 4
DC	GPIO 3
RST	GPIO 6
BL (Backlight)	GPIO 5
Touch CS	Not used

---

⚙️ TFT_eSPI Configuration (Bruce)

-DUSER_SETUP_LOADED=1
-DUSE_HSPI_PORT=1
-DILI9341_DRIVER=1
-DTFT_RGB_ORDER=1
-DTFT_WIDTH=320
-DTFT_HEIGHT=240
-DTFT_BACKLIGHT_ON=1
-DTFT_BL=5
-DTFT_RST=6
-DTFT_DC=3
-DTFT_MOSI=13
-DTFT_SCLK=15
-DTFT_CS=4
-DTOUCH_CS=-1
-DSMOOTH_FONT=1
-DSPI_FREQUENCY=20000000
-DSPI_READ_FREQUENCY=20000000
-DSPI_TOUCH_FREQUENCY=2500000

---

🚀 Flashing the Firmware

Recommended: Bruce Web Launcher

Use the official BMorcelli Launcher:

👉 https://bmorcelli.github.io/Launcher/

Steps

1. Open the launcher in a Chromium-based browser\
2. Connect the ADV Cardputer via USB\
3. Click Connect
4. Select the Bruce Cardputer External Display firmware
5. Flash and reboot

---

Manual Flash (Advanced)

esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-m5stack-cardputer.bin

Replace the port as needed: - Linux: /dev/ttyACM0 - macOS:
/dev/cu.usbmodemXXXX - Windows: COMx

---

🖥️ Behavior

• Display initializes automatically on boot
• Backlight controlled via GPIO 5
• Touch input disabled
• Uses HSPI for maximum performance

---

🛠️ Troubleshooting

• Black screen
  • Check BL pin (GPIO 5)
  • Verify CS and DC wiring
• Wrong colors
  • Confirm RGB order support
• No output
  • Verify HSPI pins and wiring

---

🤝 Credits

• Bruce Firmware
  https://bruce.computer/flasher
• BMorcelli Launcher
  https://bmorcelli.github.io/Launcher
• TFT_eSPI by Bodmer
  https://github.com/Bodmer/TFT_eSPI
• AndyAiCardputer
  https://github.com/AndyAiCardputer
• ADV Cardputer community