Skip to content

Home

Jump to bottom
github-actions[bot] edited this page Jul 30, 2026 · 2 revisions

Glowctl Wiki

Welcome to the glowctl documentation wiki!

glowctl is an open-source Python library and command-line interface for controlling Glowrium (INLEDCO) LED floor lamps over Bluetooth Low Energy (BLE).

Documentation Index

  • Protocol Specification: Wire protocol specification, CBOR property maps, GATT layout, and firmware quirks.
  • Integration and Scenes: Developer guide for Python library integration, device settings API, and custom dynamic scene synthesis (build_dydata).
  • CLI Reference: Complete glowctl command-line reference and --fast performance options.
  • Troubleshooting and FAQ: Platform Bluetooth permissions (Linux, macOS, Windows), Home Assistant integration, systemd service units, and FAQ.

Hardware Architecture Summary

  • Target Device: Glowrium H4 / Glowrium-C045 (ESP32 SoC)
  • Lighting Array: 20 vertically addressable segments, 4-channel per-segment RGBY emitters (Red, Green, Blue, Yellow).
  • BLE Service: GATT Service facebd00-7261-6262-6974-696f74626c65 (Write: facebd01, Read/Notify: facebd02).

Quick Links

Clone this wiki locally