depz-sensor-sdk 0.1.0

Python SDK for the DEPZ USB sensor line — HC-SR04 ultrasonic, VL53L8CX/CH 8x8 ToF, BNO086 IMU.

depz-sensor-sdk

Python SDK for the DEPZ USB sensor line — three USB CDC-ACM sensors that speak one shared framed protocol:

• HC-SR04 — ultrasonic distance
• VL53L8CX / VL53L8CH — 8×8 multizone Time-of-Flight (host runs the ST ULD)
• BNO086 — 9-axis IMU (host runs the SH-2 stack)

Sync API with a background reader thread: open a device, configure it, consume a stream of decoded, timestamped results. A TypeScript SDK (@depz/sensor-sdk) mirrors this one byte-for-byte via shared golden test vectors.

Install

pip install depz-sensor-sdk

Linux: your user needs serial access (group dialout); ModemManager can grab CDC-ACM ports — disable it or add a udev rule if opens time out.

Quick start

from depz_sensor_sdk import open_device
from depz_sensor_sdk.vl53l8 import Vl53l8Cx, RESOLUTION_8X8

dev = open_device()                    # first DEPZ sensor by USB id; raises if none
if isinstance(dev, Vl53l8Cx):
    dev.init(progress=print)           # ~25 s: downloads the sensor firmware
    dev.set_resolution(RESOLUTION_8X8)
    dev.set_ranging_frequency_hz(15)   # must be >= 2 Hz
    dev.start_ranging()
    for frame in dev.frames():
        print(frame.grid())            # 8×8 numpy array of mm

open_device() finds the device by USB VID/PID; pass a serial (open_device(serial="...")), an index, or an explicit port. depz-sensor list shows what's connected.

See docs/guide.md for the full guide and docs/api.md for the API reference.

License

MIT. Bundled VL53L8 sensor-firmware blobs are © STMicroelectronics (BSD-3-Clause); see NOTICE.