Skip to content

dz0ny/esphome-bthome

Repository files navigation

ESPHome BTHome Component

A custom ESPHome component that broadcasts sensor data using the BTHome v2 BLE protocol for seamless Home Assistant integration.

Features

  • BTHome v2 Protocol - Full compliance with the BTHome specification
  • Multi-Platform - ESP32 (ESP-IDF) and nRF52 (Zephyr)
  • 60+ Sensor Types - Temperature, humidity, pressure, power, and more
  • 28 Binary Sensor Types - Motion, door, window, smoke, etc.
  • AES-CCM Encryption - Optional 128-bit encryption
  • Home Assistant Auto-Discovery - Devices appear automatically

Quick Start

external_components:
  - source:
      type: git
      url: https://github.com/dz0ny/esphome-bthome
      ref: main
    components: [bthome]

sensor:
  - platform: bme280_i2c
    temperature:
      id: temperature
    humidity:
      id: humidity

bthome:
  sensors:
    - type: temperature
      id: temperature
    - type: humidity
      id: humidity

Documentation

Full documentation is available at dz0ny.github.io/esphome-bthome

Supported Platforms

Platform Board Example Framework
ESP32 esp32dev, XIAO ESP32-C3 ESP-IDF
nRF52840 Seeed XIAO BLE Zephyr

License

MIT License - See bthome.io for protocol specification.

About

BTHome component for ESPHome

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors 2

  •  
  •