ESPHome M5Stack Cardputer Adv Example

This repository contains an example ESPHome configuration for the M5Stack Cardputer Adv.

The main config file is:

• cardputer-adv.yaml

What this example includes

This sample is intended as a starting point and demonstrates:

• ESP32-S3 + ESP-IDF setup for the Cardputer Adv
• Display setup with mipi_spi and a graphical menu
• Keyboard support through the tca8418_keypad external component
• Wi-Fi, API, OTA, and captive portal basics
• Backlight control exposed as a Home Assistant light
• Button input via GPIO
• I2S audio/speaker pipeline and media source integration
• BMI270 motion sensors (accel/gyro/roll)

Requirements

• ESPHome installed locally (CLI or Home Assistant add-on)
• An M5Stack Cardputer Adv device connected over USB
• A valid secrets.yaml for Wi-Fi credentials

Example secrets.yaml values:

wifi_ssid: "YOUR_WIFI_NAME"
wifi_password: "YOUR_WIFI_PASSWORD"

Quick start

1. Clone this repository.
2. Review and adjust values in cardputer-adv.yaml for your environment.
3. Add or update secrets.yaml with your Wi-Fi credentials.
4. Compile and upload:

esphome run cardputer-adv.yaml

Notes

• This is a reference/example configuration and may need pin, peripheral, or feature adjustments depending on firmware/library versions and your hardware revision.
• If you reuse this config, replace any sample/default credentials with your own secure values.