[ln882h_ble_tracker] Add component documentation by Bl00d-B0b · Pull Request #6703 · esphome/esphome.io

Bl00d-B0b · 2026-05-27T16:22:21Z

Adds documentation for the ln882h_ble_tracker component introduced in esphome/esphome#16691, and updates related BLE platform pages to mention LN882H support.

New files

src/content/docs/components/ln882h_ble_tracker.mdx — Full component documentation:
configuration variables, all four automation triggers, start_scan/stop_scan actions,
Bluetooth Proxy support (bluetooth_proxy: true), single-core WiFi/BLE coexistence guidance,
and a BLE Scanner debugging section.
src/content/docs/components/sensor/bthome_mithermometer.mdx — New page for the BTHome v2 /
ATC Mi Thermometer sensor platform. Covers both ESP32 and LN882H, with a note that AES-CCM
encryption (bindkey) is not supported on LN882H.

Updated files

src/content/docs/components/bluetooth_proxy.mdx — Added a note that on LN882H the proxy
is built into ln882h_ble_tracker (bluetooth_proxy: true) and supports passive advertisement
forwarding only; updated See Also.
src/content/docs/components/binary_sensor/ble_presence.mdx — Added LN882H compatibility
note and See Also link.
src/content/docs/components/sensor/ble_rssi.mdx — Same.
src/content/docs/components/text_sensor/ble_scanner.mdx — Same, with a link to the
LN882H debugging section.

Related: esphome/esphome#16691

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome · 2026-05-27T16:22:53Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

netlify · 2026-05-27T16:24:10Z

✅ Deploy Preview for esphome ready!

Name	Link
🔨 Latest commit	`1c88942`
🔍 Latest deploy log	https://app.netlify.com/projects/esphome/deploys/6a197d82afd5570008430dc1
😎 Deploy Preview	https://deploy-preview-6703--esphome.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

coderabbitai · 2026-05-27T16:24:52Z

Walkthrough

This PR adds complete documentation for the ln882h_ble_tracker ESPHome component. It covers the component's role as a BLE hub, scan configuration options, available automations and triggers for BLE advertisements, scan control actions, practical guidance for single-core WiFi/BLE coexistence, and references to related BLE components.

Changes

LN882H BLE Tracker Documentation

Layer / File(s)	Summary
Component overview and configuration `src/content/docs/components/ln882h_ble_tracker.mdx`	Introduces the ln882h_ble_tracker as a global BLE hub compatible with existing ESP32 BLE sensor platforms. Documents configuration variables for scan behavior (interval, window, duration, active, continuous modes), BLE proxy forwarding, component ID, and lists supported automations.
Automations, triggers, and actions `src/content/docs/components/ln882h_ble_tracker.mdx`	Details automations and triggers: `on_ble_advertise` with optional mac_address filtering, manufacturer-specific and service-specific advertisement triggers with `manufacturer_id`/`service_uuid` and optional `mac_address` filtering, `on_scan_end` trigger, plus `start_scan` and `stop_scan` actions with the `continuous` option.
Practical guidance and related resources `src/content/docs/components/ln882h_ble_tracker.mdx`	Dedicated section on single-core WiFi/BLE coexistence with example configuration that starts scanning on Home Assistant client connect and stops on disconnect. Includes scan duty cycle notes for detection reliability and a See Also section linking to related BLE sensor and scanner components.

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically identifies the main change: adding component documentation for ln882h_ble_tracker.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description check	✅ Passed	The pull request description clearly describes the changes: adding documentation for the ln882h_ble_tracker component, creating new documentation files, and updating related BLE platform pages with LN882H support.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

esphome

As this is a feature matched with a PR in https://github.com/esphome/esphome, please target your PR to the next branch and rebase.

Base branch has been corrected - dismissing previous review.

Bl00d-B0b mentioned this pull request May 27, 2026

[ln882h_ble_tracker] BLE 5.1 passive/active scanner for LN882H esphome/esphome#16691

Draft

3 tasks

esphome Bot added component: ble_presence component: ble_rssi component: ble_scanner component: bthome_mithermometer current has-parent wrong-base-branch component: ln882h_ble_tracker labels May 27, 2026

esphome Bot previously requested changes May 27, 2026

View reviewed changes

esphome Bot marked this pull request as draft May 27, 2026 16:22

esphome Bot previously requested changes May 27, 2026

View reviewed changes

esphome Bot previously requested changes May 29, 2026

View reviewed changes

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from b6a85f8 to 12b0bc1 Compare May 29, 2026 10:23

esphome Bot previously requested changes May 29, 2026

View reviewed changes

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 716250f to a8738ae Compare May 29, 2026 10:25

esphome Bot previously requested changes May 29, 2026

View reviewed changes

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 7537940 to f030a9a Compare May 29, 2026 10:26

esphome Bot previously requested changes May 29, 2026

View reviewed changes

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 32e826e to 44413e1 Compare May 29, 2026 10:35

esphome Bot previously requested changes May 29, 2026

View reviewed changes

Bl00d-B0b changed the base branch from current to next May 29, 2026 10:36

esphome Bot added the next label May 29, 2026

esphome Bot removed wrong-base-branch current labels May 29, 2026

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from c3cee90 to 6c21c79 Compare May 29, 2026 10:48

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 6c21c79 to 3496fd8 Compare May 29, 2026 10:50

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 3496fd8 to 2e62ed5 Compare May 29, 2026 10:55

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 2e62ed5 to 90f4665 Compare May 29, 2026 11:02

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 90f4665 to 002c5db Compare May 29, 2026 11:24

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 002c5db to 13176ec Compare May 29, 2026 11:29

Add LN882H BLE Tracker documentation and update related BLE sensor pages

1c88942

Bl00d-B0b force-pushed the ln882h-ble-tracker-docs branch from 7565a4a to 1c88942 Compare May 29, 2026 11:50

Uh oh!

Conversation

Bl00d-B0b commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New files

Updated files

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot commented May 27, 2026

Uh oh!

netlify Bot commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for esphome ready!

Uh oh!

coderabbitai Bot commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

esphome Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Bl00d-B0b commented May 27, 2026 •

edited

Loading

netlify Bot commented May 27, 2026 •

edited

Loading

coderabbitai Bot commented May 27, 2026 •

edited

Loading