Chihiros LED Control
This repository contains a python CLI script as well as a Home Assistant integration that can be used to control Chihiros LEDs for aquariums via bluetooth without the vendor app. For this purpose, the protocol to control the LED has been reversed engineered with the help of decompiling the old Magic App as well as sniffing and analyzing of bluetooth packages that are sent by the new My Chihiros App. The new app is based on flutter and only contains a binary that can not easily be analyzed.
[!CAUTION] ## NICHT VERWENDEN ODER HERUNTERLADEN / DO NOT USE OR DOWNLOAD Dieses Repository enthält einen unfertigen, experimentellen Entwicklungsstand. Das Projekt sollte derzeit nicht heruntergeladen, installiert, weitergegeben oder produktiv verwendet werden. Die Nutzung erfolgt vollständig auf eigene Gefahr. Der Betreiber dieses Entwicklungs-Repositorys übernimmt keine Verantwortung oder Haftung für Schäden, Datenverlust, Fehlfunktionen an Home Assistant oder angeschlossenen Geräten. Falls diese Arbeiten nach Prüfung freigegeben werden, erscheint eine freigegebene Version ausschließlich bei Michel im ursprünglichen Projekt TheMicDiet/chihiros-led-control. Dieses Repository ist kein offizieller Veröffentlichungs- oder Installationskanal. This repository contains unfinished and experimental development code. Do not download, install, redistribute, or use it in production. Any use is entirely at your own risk. The maintainer of this development repository accepts no responsibility or liability for damage, data loss, Home Assistant failures, or connected-device malfunctions. Any reviewed and approved release will be published exclusively through Michel's original TheMicDiet/chihiros-led-control project.
Supported Devices
- Chihiros LED A2
- Chihiros WRGB II (Regular, Pro, Slim; Pro is true WRGB)
- Chihiros WRGB VIVID III (true WRGB, including fan control and fan RPM/temperature sensors)
- Chihiros Tiny Terrarium Egg
- Chihiros C II (RGB, White)
- Chihiros Universal WRGB
- Chihiros Z Light TINY
- Chihiros Commander 1
- Chihiros Commander 4
- other LED models might work as well but are not tested
Using the Home Assistant integration
Setup with HACS
- Inside HACS add this repository as a custom repository: HACS - Integrations - 3 dots on the top right- Custom repositories
- Search for Chihiros in the repositories and download it
- Restart Home Assistant
- Go to the integrations user interface and add the Chihiros integration
- Supported devices should be discovered at this point
Manual Setup
- Copy the contents of customcomponents/chihiros to <config dir/customcomponents/chihirosledcore
- Restart Home-Assistant
- Add the Chihiros integration to your Home Assistant instance via the integrations user interface
Home Assistant services
The integration provides services for changing the auto mode schedule from Developer Tools - Actions or from automations:
- chihirosledcore.addschedule: add one schedule period.
- chihirosledcore.removeschedule: remove one schedule period.
- chihirosledcore.resetschedule: remove all schedule periods.
- chihirosledcore.setschedule: replace the complete schedule.
If only one Chihiros device is configured, entryid and address can be omitted. If multiple devices are configured, include either the config entry ID or Bluetooth address.
Replace the complete schedule:
service: chihiros_led_core.set_schedule
data:
address: "AA:BB:CC:DD:EE:FF"
periods:
- start: "08:00"
end: "12:00"
brightness: 40
ramp_up_minutes: 30
weekdays:
- monday
- tuesday
- start: "09:00"brightness: 55 weekdays: