|
| 1 | +--- |
| 2 | +title: SmartHomeShopIO Ceiling-mounted All-in-One Sensor (CeilSense) |
| 3 | +date-published: 2025-11-03 |
| 4 | +type: sensor |
| 5 | +standard: uk,us,eu,au,global |
| 6 | +board: esp32 |
| 7 | +project-url: https://github.com/smarthomeshop/ceilsense |
| 8 | +made-for-esphome: true |
| 9 | +difficulty: 1 |
| 10 | +--- |
| 11 | + |
| 12 | + |
| 13 | + |
| 14 | +## Description |
| 15 | + |
| 16 | +**CeilSense** is a recessed, all-in-one smart room sensor for ceilings (and walls) that combines |
| 17 | +**24 GHz mmWave presence (HLK-LD2412)**, **ambient light (BH1750)**, **barometric pressure (BMP3xx)**, optional |
| 18 | +**CO₂/Temperature/Humidity (SCD41)**, plus a ring of **16 individually addressable WS2812 RGB LEDs**. |
| 19 | +Power it via **110–240 VAC**, **USB-C (5 V)**, or **PoE Ethernet**. It fits a **standard 68 mm** (GU10) cut-out; |
| 20 | +visible trim ring ≈ Ø 82 mm. |
| 21 | + |
| 22 | +### Highlights |
| 23 | + |
| 24 | +- Reliable **presence detection** (micro-motion) with **HLK-LD2412** |
| 25 | +- **BH1750** ambient light + **BMP3xx** pressure (always present) |
| 26 | +- **16× WS2812** status/ambient ring |
| 27 | +- **Complete** variant adds **SCD41 CO₂/Temp/Humidity** |
| 28 | +- **Wi-Fi or Ethernet (PoE)** firmware variants; **OTA** with ESPHome |
| 29 | +- Fully **local** and **open source**; maintained in the **CeilSense** GitHub repo |
| 30 | + |
| 31 | +### Specs at a glance |
| 32 | + |
| 33 | +- Cut-out: **68 mm**, install depth ≈ **45 mm** (allow ~+15 mm with RJ45 plug) |
| 34 | +- LEDs: **16× WS2812**, individually addressable |
| 35 | +- Radar: **HLK-LD2412** (24 GHz), tuned ESPHome config |
| 36 | +- Sensors (Basic): **BH1750** (illuminance) + **BMP3xx** (pressure) + **LD2412** (presence) |
| 37 | +- Sensors (Complete): **Basic + SCD41** (CO₂/Temp/Humidity) |
| 38 | + |
| 39 | +## Variants |
| 40 | + |
| 41 | +- **CeilSense Basic** — LD2412 + BH1750 + BMP3xx + 16× RGB ring |
| 42 | +- **CeilSense Complete** — **Basic + SCD41** (CO₂/Temp/Humidity) |
| 43 | + |
| 44 | +> Ethernet/PoE builds are separate YAMLs. Flash the **Ethernet** variant if you plan to use Ethernet (with or without PoE). |
| 45 | +
|
| 46 | +## Quickstart |
| 47 | + |
| 48 | +1. **Install** the device in a **68 mm** cut-out; connect mains or USB-C; optionally RJ45 for PoE. |
| 49 | +2. **Onboard** |
| 50 | + - **Wi-Fi** builds: join CeilSense AP → provide Wi-Fi credentials of your network → appears as **Discovered** in |
| 51 | + Home Assistant. |
| 52 | + - **Ethernet** builds: plug UTP → gets DHCP → appears as **Discovered** in Home Assistant. |
| 53 | +3. **Adopt** in ESPHome / Home Assistant and tune (radar thresholds, LED effects). |
| 54 | + |
| 55 | +> Please check our full documentation and Quick Start Guide: <https://smarthomeshop.io/quick-start-ceilsense> |
| 56 | +
|
| 57 | +## Support & Links |
| 58 | + |
| 59 | +- [Shop](https://ceilsense.nl/en) |
| 60 | +- [GitHub](https://github.com/smarthomeshop/ceilsense) |
| 61 | +- [Wiki](https://docs.smarthomeshop.io/) |
| 62 | +- [Discord](https://smarthomeshop.io/discord) |
| 63 | +- [YouTube](https://www.youtube.com/@smarthomeshop-io) |
| 64 | + |
| 65 | +## Gallery |
| 66 | + |
| 67 | +| Top view | In-ceiling (cut-out) | |
| 68 | +| ----------------------------------- | ---------------------------------------------- | |
| 69 | +|  |  | |
| 70 | + |
| 71 | +| Bottom view | |
| 72 | +| ---------------------------------------- | |
| 73 | +|  | |
0 commit comments