The Genius Gateway is a reverse-engineered interface for Hekatron Genius Plus X smoke detection systems. It enables real-time monitoring, MQTT integration, and web-based management of Genius smoke detectors without requiring proprietary Hekatron gateways.
- Manage smoke detectors
- Manage alarm lines
- Capture, visualize and analyze packets
- Manage gateway settings
- MQTT and WebSocket support
- Home Assistant integration
⚠️ USE AT YOUR OWN RISKThis is a reverse-engineered implementation NOT AFFILIATED with Hekatron.
You are solely responsible for ensuring compliance with all local regulations regarding RF communication and fire safety systems. The authors assume no liability for any damages or safety issues.
This project uses multiple licenses for different components:
| Component | License | Description |
|---|---|---|
| Hardware Design | CC BY-NC-SA 4.0 | PCB designs, schematics, CAD files |
| Software | AGPL-3.0 + Commons Clause | ESP32 firmware, web interface, all code |
| Documentation | CC BY-NC-SA 4.0 | All documentation, guides, images |
| Third-Party | Various (LGPL, MIT) | ESP32 SvelteKit, Arduino libraries |
⚠️ COMMERCIAL USE IS PROHIBITEDCommercial use is prohibited without explicit permission. All components are licensed for personal and educational purposes only.
For complete license details, see:
- LICENSE file in this repository
- License Documentation on GitHub Page
The gateway monitors RF communications between Hekatron smoke detectors and forwards fire alarms to home automation systems via standard protocols (MQTT, HTTP, WebSocket).
➡️ Complete documentation is available at https://hmbacher.github.io/genius-gateway/ ⬅️
The documentation includes:
- Background - Motivation and Introduction
- FM Basis X - PCB - Radio module PCB analysis
- FM Basis X - RF - Radio module RF transceiver analysis
- Protocol Analysis - RF communication details
- Protocol Captures - Packet examples and analysis
- Hardware - PCB design, schematics, and components
- General Setup - Hardware assembly, firmware flashing and basic connectivity settings
- Configure Gateway - Smoke detectors and alarm lines
- System Overview - Dashboard and alarm status
- Gateway Settings - Configuration and behavior control
- Device Management - Smoke detector management
- Packet Visualizer - RF packet analysis
- Alarm Lines Management - Alarm line configuration
- WebSocket Interface - Real-time logging
- Smart Home Integration - Home Assistant setup
- HTTP API - HTTP endpoints for frontend and monitoring
- WebSocket API - Real-time event and packet streaming
- MQTT Topics - Published MQTT topics
- Review Documentation - Understand the system architecture
- General Setup - Hardware assembly, firmware installation and basic connectivity
- Configure Gateway - Add smoke detectors and alarm lines
- Smart Home Integration - Connect to Home Assistant and other Smart Home systems
- Backend: C++ with Arduino framework and ESP-IDF via PlatformIO
- Frontend: SvelteKit with TypeScript and Vite
- Hardware: EasyEDA Pro for Schematics, PCB design and manufacturing
- Documentation: MkDocs with Material theme
genius-gateway/
├── src/ # C++ backend source code
├── interface/ # SvelteKit frontend application
├── lib/ # Arduino libraries and dependencies
│ ├── framework/ # ESP32 SvelteKit framework
│ └── PsychicHttp/ # Async HTTP server
├── docs/ # Documentation source (MkDocs)
└── scripts/ # Build and utility scripts