commit 4f432941252424bc5eedc2fc8126a96bbb7fe335 parent 6a8b7e55def725cbb89f98d7715d8a8e19781fd8 Author: Stéphan Kochen <git@stephank.nl> Date: Thu, 03 Sep 2026 22:47:03 +0200 Update README
diff --git a/README b/README new file mode 100644 index 0000000000000000000000000000000000000000..b204d7ddfbdc137698e0afd85a4e47888cbd6f1e --- /dev/null +++ b/README @@ -0,0 +1,7 @@ +# in-lite Outdoor Lighting for Home Assistant + +Extremely vibe-coded fork of [bbruenings/ha-inlite]. Look there first. + +Experimental. Minimal testing performed with a SMART HUB 75, firmware 56. + +[bbruenings/ha-inlite]: https://github.com/bbruenings/ha-inlite diff --git a/README.md b/README.md deleted file mode 100644 index aa78bf28ffb42a394f665577171d8f79e82f0a30..0000000000000000000000000000000000000000 --- a/README.md +++ /dev/null @@ -1,178 +0,0 @@ -# in-lite Outdoor Lighting for Home Assistant - -[![HACS][hacs-badge]][hacs-url] -[![GitHub Release][release-badge]][release-url] -[![License][license-badge]][license-url] -[![Validate][validate-badge]][validate-url] -[![Tests][tests-badge]][tests-url] - -Custom [Home Assistant](https://www.home-assistant.io/) integration for -**in-lite outdoor lighting** systems. Controls lights via Bluetooth Low -Energy (BLE) mesh using the CSRmesh protocol. - -> [!NOTE] -> **Disclaimer:** This project is not affiliated with, endorsed by, or -> connected to in-lite Design BV. "in-lite" is a trademark of in-lite -> Design BV. This integration was developed independently through -> protocol analysis. - -## Features - -- 💡 Turn lights on/off per zone through Home Assistant -- 📡 Bluetooth Low Energy (BLE) mesh control — no cloud dependency for operation -- 🔐 Local-only factory-reset onboarding; no in-lite account is used -- 🔄 Automatic BLE discovery of the in-lite hub -- 🔁 Reliable command delivery with retry and reconnect logic -- 🔌 Persistent BLE connection with idle disconnect to save resources -- 🕒 Automatic daily local clock and timezone-offset synchronization - -## Requirements - -- **Home Assistant** 2024.12.0 or newer -- **Bluetooth adapter** — built-in, USB dongle, or [ESPHome Bluetooth Proxy](https://esphome.github.io/bluetooth-proxies/) -- **in-lite SMART HUB-150** or **SMART HUB-75** with BLE gateway (device advertises as `inlitebt`) -- A **factory-reset** in-lite hub. During setup, Home Assistant makes the - selected hub blink, then creates its own local mesh key. - -## Supported Devices - -| Device | Status | -|--------|--------| -| in-lite SMART HUB-150 | ✅ Tested | -| in-lite SMART HUB-75 | ✅ Community verified | - -> [!TIP] -> The **SMART HUB-75** has been confirmed working by the community using an -> ESPHome Bluetooth Proxy on an ESP32. Setup is the same as for the HUB-150. - -The integration controls all transformer zones connected to the hub. If you -have tested additional hardware, please -[open an issue](https://github.com/bbruenings/ha-inlite/issues) to let us know. - -## Installation - -### HACS (Recommended) - -1. Make sure [HACS](https://hacs.xyz/) is installed in your Home Assistant instance -2. Add this repository as a custom repository: - - Go to **HACS** → **Integrations** → **⋮** (top right) → **Custom repositories** - - Enter `https://github.com/bbruenings/ha-inlite` and select **Integration** - - Click **Add** -3. Search for **in-lite Outdoor Lighting** in HACS and click **Download** -4. Restart Home Assistant - -### Manual Installation - -1. Download the [latest release](https://github.com/bbruenings/ha-inlite/releases/latest) -2. Copy the `custom_components/inlite/` folder to your Home Assistant - `config/custom_components/` directory -3. Restart Home Assistant - -## Configuration - -The integration is configured through the Home Assistant UI. No YAML configuration needed. - -### Automatic Discovery - -If your in-lite hub is powered on and within Bluetooth range, Home Assistant -will automatically discover it and prompt you to set it up. - -### Manual Setup - -1. Go to **Settings** → **Devices & Services** → **Add Integration** -2. Search for **in-lite Outdoor Lighting** -3. Select the discovered in-lite gateway -4. Select a factory-reset hub and verify that it blinks -5. Confirm the blinking hub; Home Assistant creates a local-only mesh key -6. The integration reconnects and creates light entities for each zone - -### Entities Created - -For each transformer zone, the integration creates a **Light** entity: -- `light.inlite_<hub_name>_zone_<N>` — supports on/off control - -### Clock synchronization and smart-lamp teach-in - -The integration synchronizes every hub with Home Assistant's clock and local -timezone offset after setup and daily at 03:00. Older hub firmware receives its -supported UTC clock format; RTC-capable firmware also receives the local offset. - -Smart lamps and accessories are not added automatically. To explicitly start -the official app-compatible teach-in flow, call the following service: - -```yaml -service: inlite.start_teach_in -data: - device_id: 4660 - confirm: true -``` - -Teach-in re-applies the local mesh password and removes group assignments below -ten. During the process, Home Assistant emits `inlite_teach_in_progress` events -with `device_id`, `step`, and `step_code`; the final `step` is `done`. - -## Troubleshooting - -### Hub not discovered - -- Ensure the in-lite hub is powered on and within Bluetooth range -- Check that your Bluetooth adapter is working: **Settings** → **Devices & Services** → **Bluetooth** -- If using an ESPHome BLE proxy, ensure it's online and connected - -### Commands fail intermittently - -The integration automatically retries commands up to 3 times with -disconnect-reconnect between attempts. If commands still fail: - -- Move the Bluetooth adapter closer to the hub -- Consider using an [ESPHome Bluetooth Proxy](https://esphome.github.io/bluetooth-proxies/) positioned near the hub -- Check Home Assistant logs for BLE connection errors - -### Enable debug logging - -Add the following to your `configuration.yaml` for detailed logs: - -```yaml -logger: - default: warning - logs: - custom_components.inlite: debug - inlite_ble: debug -``` - -## Contributing - -Contributions are welcome! Please: - -1. [Open an issue](https://github.com/bbruenings/ha-inlite/issues) to discuss your idea first -2. Fork the repository and create a feature branch -3. Submit a pull request - -### Adding support for new devices - -If you want to contribute support for hardware you don't own (or help capture -data from devices you do own), see the -**[Reverse Engineering Guide](docs/reverse-engineering.md)** — it covers -HTTP proxy setup (mitmproxy) and BLE packet capture (PacketLogger) on iOS and -macOS. - -## License - -This project is licensed under the [MIT License](LICENSE). - -## Acknowledgements - -This integration was built with the help of [GitHub Copilot](https://github.com/features/copilot). - ---- - -[hacs-badge]: https://img.shields.io/badge/HACS-Custom-orange.svg -[hacs-url]: https://github.com/hacs/integration -[release-badge]: https://img.shields.io/github/v/release/bbruenings/ha-inlite -[release-url]: https://github.com/bbruenings/ha-inlite/releases -[license-badge]: https://img.shields.io/github/license/bbruenings/ha-inlite -[license-url]: https://github.com/bbruenings/ha-inlite/blob/main/LICENSE -[validate-badge]: https://github.com/bbruenings/ha-inlite/actions/workflows/validate.yml/badge.svg -[validate-url]: https://github.com/bbruenings/ha-inlite/actions/workflows/validate.yml -[tests-badge]: https://github.com/bbruenings/ha-inlite/actions/workflows/tests.yml/badge.svg -[tests-url]: https://github.com/bbruenings/ha-inlite/actions/workflows/tests.yml