ondotori-ble

Unofficial software. This project is independent of T&D Corporation.

ondotori-ble is a typed Python library for receiving selected current-value advertisements from T&D Ondotori data loggers over Bluetooth Low Energy (BLE). It does not pair with a logger, change settings, download recorded history, or provide a command-line interface.

from ondotori_ble import read_all

for reading in read_all(duration=75):
    print(reading.serial_number, reading.product_name, reading.measurements)

Support boundary

The package keeps unknown T&D packets observable, but it only converts a value when the layout and conversion have adequate evidence.

This release does not claim support for every T&D Bluetooth model or mode. See the protocol documentation for the exact evidence boundary.

Install

Python 3.11 or newer is required:

uv add ondotori-ble

Read without knowing a serial number

read() returns the first T&D advertisement observed before its deadline:

from ondotori_ble import read

reading = read(timeout=75)
if reading.is_decoded:
    print(reading.temperature_c, reading.humidity_percent)
else:
    print(f"Raw family {reading.family_code:02X}: {reading.raw_data.hex()}")

Use read("5F440123") when the eight-digit serial is known. The serial in this example is synthetic.

Read every observed logger

from ondotori_ble import read_all

readings = read_all(duration=75)

The function waits for the complete collection window and returns the newest packet from every serial observed in that interval, sorted by serial. BLE discovery is probabilistic: no finite duration can guarantee that every nearby device was received. Use decoded_only=True to exclude raw-only packets.

Async and server use

Async applications have matching read_async(), read_all_async(), and scan_async() functions:

import asyncio

from ondotori_ble import read_all_async


async def main() -> None:
    for reading in await read_all_async(duration=75):
        print(reading.serial_number, reading.product_name, reading.measurements)


asyncio.run(main())

A long-running service can use the managed stream:

from ondotori_ble import stream_readings

async for reading in stream_readings(deduplicate=False):
    await repository.store(reading.as_dict())

deduplicate=False emits every received advertisement. With the default True, only payload changes are emitted per serial. Storage should still use an application-defined idempotency policy because BLE does not guarantee exactly-once delivery.

Advanced applications can manage lifecycle and inspect health directly:

from ondotori_ble import OndotoriScanner

async with OndotoriScanner() as scanner:
    async for reading in scanner:
        print(reading.as_dict())

print(scanner.state, scanner.stats, scanner.last_error)

Decode an existing packet

The pure decoder does not require Bluetooth hardware:

from ondotori_ble import decode_advertisement

reading = decode_advertisement(
    bytes.fromhex("2301445f00000000d2041f06000000000000")
)
assert reading.temperature_c == 23.4
assert reading.humidity_percent == 56.7

Bleak separates T&D's company identifier (0x0392) from its payload. Set company_id_included=True only when input still begins with little-endian 92 03.

reading.product_name is the verified product name derived from the T&D manufacturer payload, such as TR42A. reading.name is the local or cached BLE name reported by the operating system and may be missing or less specific.

Development

uv sync --all-groups
lefthook install
uv run ruff check .
uv run ruff format --check .
uv run ty check
uv run pytest
uv run --group docs mkdocs build --strict
uv build --no-sources

The full documentation is at ameyanagi.github.io/ondotori-ble. Ondotori, T&D, and related product names are trademarks of their respective owner.