ESP32-S3-Matrix Swarm + ESP-NOW🐝

A synchronized LED matrix display system powered by ESP-NOW. One "Master" board detects its orientation (Pitch/Roll) using the built-in QMI8658 IMU and broadcasts visualization data to multiple "Slave" boards in real-time.

Features 🌟

• Decentralized: No WiFi router or internet connection required. Uses ESP-NOW broadcast.
• Scalable: Supports 1 Master and practically unlimited Slaves within range.
• Dynamic Roles: Any board can be the Master. No hardcoded roles.
• Smooth Visuals:
  • Fade Effect: Smooth color transitions based on tilt.
  • Axis Cursors: "Highway" visualization with independent Pitch/Roll cursors.
• Plug & Play: Single firmware for all devices.

Hardware 🛠️

• Board: Waveshare ESP32-S3-Matrix (ESP32-S3 Mini + 8x8 RGB LED Matrix)
• Sensor: QMI8658 (6-Axis IMU)
• Display: Onboard 8x8 WS2812B RGB Matrix

Usage 🎮

1. Flash: Upload this firmware to all your boards.
2. Power On: All boards start as SLAVE (waiting for data) by default.
3. Select Master:
   • Pick ONE board.
   • Press and HOLD the BOOT button for 2 seconds.
   • The screen will turn YELLOW, then flash GREEN.
   • Release the button. It is now the MASTER.
4. Play: Tilt the Master board. All Slave boards will mimic the color and cursor movements instantly.

Quick Start (No Coding Required) ⚡

If you just want to use the swarm without modifying the code:

1. Download the latest firmware binary from this repo.
2. Connect your ESP32-S3-Matrix to your PC.
3. Use ESP Tool (Web Browser) or esptool.py to flash the .bin file to address 0x10000.

Installation (For Developers) 💻

This project is built with PlatformIO.

1. Clone the repo.
2. Open in VS Code with PlatformIO extension.
3. Upload to your ESP32-S3-Matrix boards.

pio run -t upload

Technical Details ⚙️

• Communication: ESP-NOW Broadcast (Address: FF:FF:FF:FF:FF:FF)
• Channel: 1 (Forced)
• Update Rate: ~50Hz