Getting Started
This guide focuses strictly on the installation, configuration, and operation of the custom firmware. It assumes you have already assembled your hardware, whether as a completed build or a breadboard prototype.
🛠️ Hardware & Build Reference
If you are looking for wiring diagrams, assembly instructions, or a complete parts list, please refer to the following external resources:
Setup Roadmap
To achieve a fully functional system, you must complete the following steps in the specific order listed below. Each section builds upon the previous one.
1. Firmware Installation
The first step is flashing the custom C++ firmware to your Primary and Display (CYD) controllers using a compatible flashing utility or the Arduino IDE.
2. Network Onboarding
Once flashed, you will connect each controller to your local Wi-Fi network. Remember: this system is designed for local-first operation and does not require an active internet connection for core functionality.
3. System Interfaces
Establish the internal communication paths between the controllers and configure the API settings to ensure the “Triumvirate” works as a single unified device.
4. Boot Process
Verify your setup by observing the default boot sequence. This section explains how to confirm that all services (Wi-Fi, MQTT, and Internal API) have initialized correctly.
What’s Next?
The system will not be fully functional until all four steps above are completed. Once finished, you can proceed to the General Use and the remaining topics to customize your alarms, lighting modes, and optional Home Assistant integrations.