depz-sensor-sdk

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

HC-SR04 — ultrasonic distance
VL53L4CD — single-zone Time-of-Flight to ~1.3 m (host runs the ST ULD)
VL53L8CX — 8×8 multizone Time-of-Flight, the base ToF imager (host runs the ST ULD)
VL53L8CH — the VL53L8CX superset, adding Compact-Network-Histogram output
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).

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.

Open source — source and issue tracker: https://github.com/depz-ai/depz-sensor-sdk.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

depz_sensor_sdk-0.2.1.tar.gz (260.7 kB view details)

Uploaded Sep 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

depz_sensor_sdk-0.2.1-py3-none-any.whl (247.4 kB view details)

Uploaded Sep 6, 2026 Python 3

File details

Details for the file depz_sensor_sdk-0.2.1.tar.gz.

File metadata

Download URL: depz_sensor_sdk-0.2.1.tar.gz
Upload date: Sep 6, 2026
Size: 260.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for depz_sensor_sdk-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`863cf683bbdeeb9a448598f27e4653d58c98a0e60f0169ed4dc8d3b0f92f0b09`
MD5	`574f481af68710d8aeb2f049f37b8a15`
BLAKE2b-256	`e3b134cedc2979e7f47756a3b8370616a50f858d559ee571006775c238d4451d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for depz_sensor_sdk-0.2.1.tar.gz:

Publisher: publish-pypi.yml on depz-ai/depz-sensor-sdk-and-viewer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: depz_sensor_sdk-0.2.1.tar.gz
- Subject digest: 863cf683bbdeeb9a448598f27e4653d58c98a0e60f0169ed4dc8d3b0f92f0b09
- Sigstore transparency entry: 2732870237
- Sigstore integration time: Sep 6, 2026
Source repository:
- Permalink: depz-ai/depz-sensor-sdk-and-viewer@6fe2d9a113406ad29f3b751d3ed6d81a425ebe15
- Branch / Tag: refs/tags/v0.2.1
- Owner: https://github.com/depz-ai
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@6fe2d9a113406ad29f3b751d3ed6d81a425ebe15
- Trigger Event: push