A program for controlling an LED matrix display for a Protogen mask, featuring various facial expressions and Bluetooth LE control with an ESP32.
- Features ✨
- Hardware Requirements 🛠️
- Software Requirements 💻
- Installation ⚙️
- Usage 📖
- Facial Expressions 😃
- Contributing 🤝
- License 📜
- Multiple facial expressions (idle, happy, angry, playful, silly, kinky, and more)
- Smooth blinking animations
- Bluetooth Low Energy (BLE) connectivity to switch expressions remotely
- Boot-up animation with scrolling text
- ESP32 development board
- 14 x MAX7219 8x8 LED matrix modules
- Connecting wires and power supply
- VSCode with PlatformIO Extension
- MD_MAX72XX library
- NimBLE-Arduino library
-
Clone the repository:
git clone https://github.com/stef1949/LumiFur_Controller.git
-
Install the required libraries in Arduino IDE:
- Go to Sketch > Include Library > Manage Libraries...
- Search for MD_MAX72XX and install it.
- Follow the installation instructions here.
- Open the project:
- Open main.cpp in the Arduino IDE.
- Configure hardware settings if necessary:
- Check the pin definitions (CLK_PIN, DATA_PIN, CS_PIN) and adjust them to match your setup.
- Connect your ESP32 to the computer via USB.
- Select the correct board and port in the Arduino IDE.
- Click Upload to flash the code.
- Connect the LED matrix modules to the ESP32 according to your wiring configuration.
- Power on the device.
- The mask will display the default idle face with animations.
- Use the LumiFur app to connect to 'LumiFur_BLE'.
- Send values between 1 and 8 to change facial expressions.
- 1 - Idle Face
- 2 - Happy Face
- 3 - Angry Face
- 4 - Playful Face
- 5 - Silly Face
- 6 - Kinky Face
- 7 - Death Face
- 8 - Edgy Face
Contributions are welcome! Please fork the repository and submit a pull request with your improvements.
This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.