--- title: "BLE ADV Ceiling Fan / Lamps" description: "BLE ADV Ceiling Fan / Lamps is a Marketplace integration for Home Assistant. It has 1k installs sharing analytics and was last updated October 24, 2026." canonical: "https://vulpo.app/integrations/marketplace/nicoiit-ha-ble-adv" url: "https://vulpo.app/integrations/marketplace/nicoiit-ha-ble-adv.md" last-updated: "2026-10-23" version: "1.4" --- # BLE ADV Ceiling Fan / Lamps > BLE ADV Ceiling Fan / Lamps is a Marketplace integration for Home Assistant. It has 1k installs sharing analytics and was last updated October 24, 2026. BLE ADV Ceiling Fan / Lamps is a custom integration that controls ceiling fans and lamps through BLE raw advertising. It recognizes the protocols used by various phone apps and remotes, so it is not tied to one brand or device type, and it does not support standard BLE GATT devices. It adds fan and light entities, plus a switch for a no command mode and an event entity for encoded commands. Device configuration can be found by listening to an already paired phone app or physical remote, and commands from that controller update the entity states in Home Assistant. A second controller can be linked so that a phone app and a remote both keep the states in sync. Commands go out through the host Bluetooth adapter, an ESPHome proxy, or a Shelly Bluetooth proxy, and setup runs in the UI. An action injects raw BLE ADV data in hex format, and device triggers fire on state changes or received commands. Automatic summary of the README and code of NicoIIT/ha-ble-adv. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=NicoIIT&repository=ha-ble-adv&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=NicoIIT&repository=ha-ble-adv&category=integration) ## Supports - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Manual Input - **Device name** - **Codec** - **BLE ADV Adapter** - **Forced Id** - **Index** ### Manual Injection - **BLE ADV Adapter** - **Raw Data** - **Interval** - **Repeat** ### Decoding Raw BLE ADV - **Raw Data** ### Pairing - **BLE ADV Adapter** - **Phone Application** ### Adapter Selection - **BLE ADV Adapter** ### Controlled Entities - **Type** - **Minimum Brightness** - **Force color / brightness refresh when switched ON** - **Reverse Cold / Warm** - **Commands always sent even if nothing changed** - **Light Modes** - **Type** - **Minimum Brightness** - **Force color / brightness refresh when switched ON** - **Reverse Cold / Warm** - **Commands always sent even if nothing changed** - **Light Modes** - **Type** - **Minimum Brightness** - **Force color / brightness refresh when switched ON** ### Select Linked Controller - **Linked Controller** ### Configure Linked Controller Options - **Name** - **Controlling the Device** - **Translator Set** Texts from the code of [NicoIIT/ha-ble-adv](https://github.com/NicoIIT/ha-ble-adv). ## Entities - **Events**: Encoded Command - **Fans**: Main Fan, Second Fan, Third Fan - **Lights**: Main Light, Second Light, Third Light - **Switches**: No Command Mode ## Actions - **Inject Raw BLE ADV**: Inject raw BLE ADV in binary hex format. Fields: Adapter ID, Raw BLE ADV, Interval, Repeat, Device Queue Name, Minumum Duration ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > Home Assistant Custom Integration to control Ceiling Fan / Lamp Devices from various Brands using non standard BLE Raw Advertising as communication method. Please note this component will never support standard BLE GATT protocol as it is not its purpose. > > This integration is not limited to any specific device type or brand: it is able to recognize and reproduce the communication protocols used by various Phone Apps and Remotes. > > - Discover your device configuration simply by listening to an already paired controller (Android Phone App, Physical Remote) > - Create Home Assistant Fan / Light Entities using existing Home Assistant UI to control them > - Listen to the command emitted by the Phone App and updates Home Assistant Entities state > - Synchronize another controller: allows to have a Phone App and a remote both updating Home Assistant entities state > - Guided configuration fully based on Home Assistant User Interface configuration flow > - Use either the bluetooth of the HomeAssistant host, an ESPHome based ble\_adv\_proxy similar to the ESPHome bluetooth\_proxy but supporting BLE Raw Advertising or a Shelly device supporting HA… From the README of [NicoIIT/ha-ble-adv](https://github.com/NicoIIT/ha-ble-adv#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Lighting](https://vulpo.app/integrations/category/lighting.md), Bulbs and lamps - Number: 1k installs sharing analytics; 265 GitHub stars - Connection: Connection not stated - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.2.0, last updated October 24, 2026 - Domain: `ble_adv` - Source: - Issues: In Vulpo: Light card, Quick Toggle card, Fan card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-23. Source: https://vulpo.app/integrations/marketplace/nicoiit-ha-ble-adv --- - HTML version of this page: https://vulpo.app/integrations/marketplace/nicoiit-ha-ble-adv - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml