This repository contains an ESPHome configuration for an ESP32-S3-based with 8x8 Onboard 8×8 RGB LED Matrix. The configuration uses the WS2812B LED chipset and supports various addressable light effects. This setup is ideal for creating colorful light displays, animations, and more, controlled over Wi-Fi.

• ESP32-S3-Matrix: This configuration is designed for the ESP32-S3-Matrix Development Board, Based on ESP32-S3, Onboard 8×8 RGB LED Matrix.
• ESPHome: Version 2024.6.0 or later.

This configuration uses substitutions to allow easy customization:

• name: Device name (default: esp32_s3_matrix)
• friendly_name: Friendly display name (default: esp32_s3_matrix)

You must replace the placeholders for Wi-Fi credentials with your actual details:

wifi:
  ssid: !secret wifi_ssid  # Replace with your actual Wi-Fi SSID
  password: !secret wifi_password  # Replace with your actual Wi-Fi password

Ensure you replace the API encryption key with your actual key:

api:
  encryption:
    key: !secret api_encryption_key  # Replace with your actual encryption key

The configuration supports the following light effects:

• Rainbow
• Color Wipe
• Scan
• Twinkle
• Flicker
• Fireworks
• Green Tick
• Red No Entry

This configuration supports multiple methods for provisioning Wi-Fi credentials and Over-The-Air (OTA) updates:

• Improv Serial: Allows provisioning via a serial connection.
• Captive Portal: Allows provisioning via a Wi-Fi access point.
• Bluetooth LE: Provisioning via Bluetooth LE (ESP32 Improv).

1. Clone this repository.
2. Modify the substitutions and Wi-Fi configuration sections as needed.
3. Upload the configuration to your ESP32-S3 board using ESPHome.
4. Once the upload is complete, your device should be available on your network with the friendly name specified.

This configuration includes a dashboard import from the official ESPHome firmware repository:

dashboard_import:
  package_import_url: github://esphome/firmware/esphome-web/esp32s3.yaml@main
  import_full_config: true

This allows you to extend the functionality by importing additional configurations.

This project uses the Unlicensed terms and conditions. See the LICENSE file for details.

For more information, visit the ESPHome documentation or the official ESP32-S3 documentation.