Skip to content

This code is designed for automating the LED control in my Gundam models using HomeAssistant

License

Notifications You must be signed in to change notification settings

macbury/GunplaESPKit

Repository files navigation

GunplaESPKit

logo

Manage your Gunpla ESP Kit here

About

This code is designed for automating the LED control in my Gundam models using HomeAssistant (https://www.home-assistant.io/). Initially, I considered using ESPHome, but I needed more advanced features like power-on effects and diverse animations, particularly for elements like GN Drives.

How it works

This software is composed of two parts. ESP32 Firmware and PWA React app that can upload firmware and configure HomeKit accessories on board. Web dashboard is using WebBluetooth to manage board and WebSerial to upload firmware. Everything stays in the browser.

UI

1 2 3 4 5 6

Example Gunpla

alt text alt text alt text alt text alt text alt text alt text alt text

Stack

GunplaESPKit is composed from two parts firmware and PWA web app to upload and manage firmware

Firmware

Firmware is stored in root directory under src. It is using platform.io for managing dependencies and compiling.

  • platform.io
  • C++
  • ESP32
  • Arduino Framework
  • HomeKit using HomeSpan
  • Bluetooth using NimBLE
  • MsgPack using ArduinoJson

WebApp

Web app resides under ui/ directory. It contains everything required to build final dashboard.

Requirements

  • platformio
  • Python 3
  • HomeAssistant or HomeKit
  • ESP32 board with Bluetooth and WiFi

Supported ESP32 dev kits

You need ESP32 kit with WiFi and bluetooth on board, 4 MB of memory.

Disclaimer

🐒 Hey there! Just a heads-up: I, a singular, exceptionally skilled yet noticeably tipsy monkey, have rapidly put together the code you're about to see. It's worth mentioning that in my enthusiastic and slightly inebriated state, I completely skipped the testing phase. So, while you can expect some creative solutions, be prepared for a few surprises along the way. Enjoy the adventure and happy debugging! 🍌

References

About

This code is designed for automating the LED control in my Gundam models using HomeAssistant

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published