https://github.com/usimd/window-sensor

BLE window sensor — nRF54L10 + BTHome v2 for Home Assistant
https://github.com/usimd/window-sensor

Last synced: about 1 month ago
JSON representation

BLE window sensor — nRF54L10 + BTHome v2 for Home Assistant

• Host: GitHub
• URL: https://github.com/usimd/window-sensor
• Owner: usimd
• License: other
• Created: 2026-06-01T11:57:13.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-06-01T18:49:55.000Z (about 2 months ago)
• Last Synced: 2026-06-01T20:17:17.353Z (about 2 months ago)
• Language: Rust
• Size: 1020 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# BLE window sensor for Homeassistant

![License HW: CERN-OHL-W-2.0](https://img.shields.io/badge/license_HW-CERN--OHL--W--2.0-blue)

![License FW: Apache-2.0](https://img.shields.io/badge/license_FW-Apache--2.0-blue)

[![CI](https://github.com/usimd/window-sensor/actions/workflows/ci.yaml/badge.svg)](https://github.com/usimd/window-sensor/actions/workflows/ci.yaml)

[![codecov](https://codecov.io/gh/usimd/window-sensor/branch/main/graph/badge.svg)](https://codecov.io/gh/usimd/window-sensor)

[![Upload to AISLER](https://img.shields.io/badge/Upload_to_-AISLER-ff8000)](https://aisler.net/p/new?url=https://raw.githubusercontent.com/usimd/window-sensor/refs/heads/main/window-sensor.kicad_pcb&ref=github)

BLE window/door sensor built around the u-blox NORA-B226 (nRF54L10). Broadcasts open/closed/tilt state via BTHome v2 non-connectable advertising. MCUboot OTA-capable.

![Rendered PCB](window-sensor.png)

## Hardware

- **MCU**: nRF54L10 (Cortex-M33, 1 MiB RRAM, 192 KB RAM) in u-blox NORA-B226-00B module

- **Sensor**: TMAG5273 3D Hall-effect sensor for contactless magnet detection

- **Power**: CR14250 (½AA) lithium cell, target multi-year battery life

- **Enclosure**: 3D-printed case with magnet holder (FreeCAD, `case/`)

## Firmware

Rust + Embassy async runtime, BLE via nrf-sdc + trouble-host.

- Non-connectable BTHome v2 advertising (open / closed / tilt)

- MCUboot bootloader with ed25519-signed OTA images

- Host-side unit tests for classifier and gesture logic

## Repository Structure

| Path | Description |

|---|---|

| `*.kicad_*` | KiCad 10 schematic, PCB, and project files |

| `lib/` | Local symbol/footprint libraries and 3D models |

| `firmware/` | Rust firmware (Embassy, BLE, MCUboot support) |

| `firmware/mcuboot/` | MCUboot config and partition overlay |

| `case/` | FreeCAD enclosure design and 3MF exports |

| `scripts/` | BLE scanner and dev utilities |

| `sim/` | Magnetic simulation data |

## Building

```bash

# Install toolchain

rustup target add thumbv8m.main-none-eabihf

cargo install just cargo-binutils

# Build, lint, test

just ci

# Flash (requires probe-rs + debug probe)

just run

```

## License

Dual-licensed: hardware under CERN-OHL-W-2.0, firmware under Apache-2.0. See [`LICENSE`](LICENSE).

## AISLER discount

In case you want to build this (or any other) project at AISLER, here's a 10€ discount code for you: `MakeInEurope-ZDCTN`.