BLE ADV Ceiling Fan / Lamps
NicoIIT/ha-ble-adv · vv2.2.0
BLE ADV Ceiling Fan / Lamp HA custom integration
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
fan | Fan |
What people report
Controls Bluetooth-advertisement fans and lamps assumed-state, from app or remote codecs. Newer remotes and rolling-code devices need reverse engineering.
- Works2
- Partly works1
- Not working1
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| eWeLink BLE ADV devices | Works Local | New codec mergedSaved copyDescription ## 🧪 Change Type - [ ] 🐛 Bug Fix - [ ] ✨ New Feature - [ ] 🚀 Perf improvment / Refactoring - [X] ✨ New codec - [ ] 📝 Documentation ## 📋 Checklist - [X] Once opened, I will link the Issue where this change was discussed and approved by the maintainer - [X] I read the Contribution Guidelines of the project and this change fully complies with them. - [X] I tested my software on a live HA server - [X] I added Unit Tests to test my new software - [X] I ran the existing Tests and all are OK Excerpt saved from GitHub on 2026-10-23. | PR #332 · 2026-09 | |
| Mantra R00134 remote with fan (Nepal Mini) | Works Local | Remote buttons fully supportedSaved copyThis PR adds support for Mantra R00134 physical remotes that control fans with lights such as the Nepal Mini, resolves #279. ### Problem The R00134 remote was recognized, but only some of its buttons were syncing to Home Assistant and after enough presses the remote stopped syncing entirely. ### Fix - Opt-in translator set: all R00134 signals are decoded by a dedicated `"R00134 remote"` translator set on the `mantra_v0` codecs, using the new multi translator set support. The default translators are strictly unchanged, so there is zero impact for existing users. Owners of an R00134 select the … Excerpt saved from GitHub on 2026-10-23. | PR #283 · 2026-08 | |
| Vaczon DC fan remote | Partly works | Rolling-code remote; eWeLink app encoder reverse engineeredSaved copy… particular if either of the mandatory info is not given then your request is useless and will be Closed. - [x] This only contains 1 "Support New Physical Remote" request (if you have multiple requests, open one request for each). - [x] This issue is not a duplicate "Support New Physical Remote" request of previous requests. ### Supported Android Application controlling your Device (effectivelly or as per provider documentation) There are no apps that seem to control this device, except Using the ble_adv.inject_raw service with the captured hex strings successfully controls the fan, but only … Excerpt saved from GitHub on 2026-10-23. | Issue #201 · 2026-02 | |
| Mantra Alisio fan with R00128 remote | Not working | Pairs but HA commands do nothing; codec problemsSaved copyHello @soniaalemany From what I see you have a `Mantra` Device, please be aware we are facing issues with this codec so before starting I would need to know if you tried to use the 'Duplicate' flow from the paired Mantra App or from your Remote R00128. As far as I can see the light ON/OFF should work at least (the light should blink during duplication), do you confirm? EDIT: I would also need the type of your Mantra Device (Groenland / Alisio / Nepal mini / other...) Thanks Excerpt saved from GitHub on 2026-10-23. | Issue #298 · 2026-08 | |
| Smart Light (Agarce) remotes, Revneey ceiling fan | Requested | Support PR closed unmergedSaved copySupport for Smart Light (Agarce) Physical Remotes This PR adds support for Smart Light (Agarce) physical remote controls (specifically those using prefix `0x03` and `0x04` such as the Revneey ceiling fan/light remote). It enables decoding incoming remote signals and sending direct controls from Home Assistant, resolving #191 and #58. ## Problem Physical remotes for these controllers utilize a protocol family similar to the existing `agarce` (app-based) codec but with key structural differences: 1. Decryption Seeding: The remote utilizes a 4-byte seed (compared to the app's 2-byte seed) to … Excerpt saved from GitHub on 2026-10-23. | PR #256 · 2026-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Assumed state
Sends commands but can’t read the device’s state back, so Home Assistant assumes it worked.
Details
| Installs (analytics) | 1,028 (0.15%) |
|---|---|
| GitHub stars | 264 |
| Latest version | v2.2.0 (2026-10-18) |
| Set up in the UI | Yes |
| Maintainers | @NicoIIT |
| License | MIT |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/NicoIIT/ha-ble-adv
- Source code: https://github.com/NicoIIT/ha-ble-adv
- Issues: https://github.com/NicoIIT/ha-ble-adv/issues
- HACS: https://hacs.xyz