Skip to content

docs: add guide for capturing BLE data to support new devices#526

Draft
bluetoothbot wants to merge 1 commit into
sblibs:mainfrom
bluetoothbot:koan/doc-capturing-ble-traces
Draft

docs: add guide for capturing BLE data to support new devices#526
bluetoothbot wants to merge 1 commit into
sblibs:mainfrom
bluetoothbot:koan/doc-capturing-ble-traces

Conversation

@bluetoothbot

@bluetoothbot bluetoothbot commented Jun 21, 2026

Copy link
Copy Markdown
Collaborator

What

A contributor guide (docs/adding-device-support.md) explaining how to capture
the raw Bluetooth data the library needs to add a new device or feature, linked
from the README.

Why

A steady stream of device-support issues stalls for one reason: nobody has
captured the raw advertisement/GATT bytes the parser needs. There was no
documented self-serve path for non-coders to contribute that data, so the same
"how/what do I capture?" gets re-explained per issue (or never). This turns the
recurring blocker into a single referenceable page.

How

Testing

Docs-only — no code paths changed. Verified the referenced symbols
(SUPPORTED_TYPES, service UUIDs, company IDs, parse_advertisement_data
signature) against the current source.


Autonomous PR by Kōan, on behalf of @bdraco / the OpenHome team (nick@openhomefoundation.org).


Quality Report

Changes: 2 files changed, 135 insertions(+)

Code scan: 4 issue(s) found

  • docs/adding-device-support.md:62 — debug print statement
  • docs/adding-device-support.md:64 — debug print statement
  • docs/adding-device-support.md:65 — debug print statement
  • docs/adding-device-support.md:82 — debug print statement

Tests: passed (1300 passed)

Branch hygiene: clean

Generated by Kōan

@bluetoothbot bluetoothbot force-pushed the koan/doc-capturing-ble-traces branch from 9f7be4b to 2b65694 Compare June 22, 2026 04:59
@codecov

codecov Bot commented Jun 22, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant