v4

Device library device-v4 · wire protocol version 1 · compatibility · docs

Install: the archive for your platform below (or the download page), pip install uclog==4, the .vsix for VS Code, or the web app at uclog.unitcircle.ca/app/ (also one file: uclog-app-4.html).

Changes

• Hub: another ephemeral port when its UDP side is refused; pulse test slack for CI (6673289)
• VS Code e2e: focus the terminal's helper textarea, not a click (5eb5b4e)
• Hub registry on Windows: retry reads and the rename; focus the VS Code terminal test (370347d)
• Scripts: the Cargo.lock test compares line by line (8de9ccb)
• Version 4 (host and device) (e5b2502)
• Release: macOS x64 cross-compiled on macos-14 (ad54072)
• Release: sign the Windows programs with Azure Artifact Signing (plan 07 task 6) (6056013)
• CI: make disk space for the Zephyr CI image (fc95399)
• CI: keep artifacts 7 days (72c8935)
• CI: Node 24 actions, a device workflow button, no Web Bluetooth on Linux (7150d8d)
• Release: trusted publishing for the Marketplace and Open VSX; plan 08 step A done (27e3e83)
• Plan 08 checklist: the first npm publish by hand, no token (595c426)
• Spec: the layer diagram as a table (58d1fcd)
• Plan 07 task 30: GUI fallback fonts for symbols (7d322d1)
• Plan 07 task 29: character mode in the GUI terminal (1f720fc)
• Plan 07 task 28: uclog hub --config FILE (83b62e7)
• Plan 07 task 9: show how to get access when Linux refuses a device (e909712)
• Plan 07 task 8: Linux armv7 (Raspberry Pi OS) release build (965e168)
• Plan 07 tasks 12, 13a and 13b: publish jobs, and the go-public checklist (aae1f42)
• Plan 08 task 16: bench results on the three boards from a clean build (72e2309)
• Device: relative file names on Zephyr, and no absolute paths in the logdata (f4fab54)
• Plan 07 tasks 4, 5 and 10: macOS signing, notarisation and ucLog.app (7cf7301)
• Plan 08 task 16: bench command, firmware/bench.py and the performance page (fffdce9)
• Plan 08 tasks 17 and 18: download page, and release notes from tags (5beac44)
• Plan 08 task 15: Python examples run in CI, and the Python reference from docstrings (88958e2)
• Plan 08 task 12: docs for getting started, the hosts, logdata and security (bd461a1)
• Plan 08 task 13: device examples (bare metal: make and CMake; Zephyr) and the device docs (ee3cfe2)
• Plan 08 task 14: embedding docs with both examples, and a generated reference (87b4102)
• Docs: embedding in a web page; build.py replaces only its own outputs (d3bf7a3)
• Plan 08 tasks 9, 9a, 9b and 11: the site, versioned docs, the app offline, screenshots (dab025e)
• Plan 08 tasks 8 and 10: device plot API, hub allows the hosted web app (60cb8ab)
• Device: ucComm v5 (builds on x86-64); host test on x86-64 and Arm64 (fc9fe3f)
• Plan 08 tasks 5-7: device builds, device CI, uclog-device mirror (f99982e)
• Plan 08 task 4: one device library for bare metal and Zephyr (6e25736)
• device: retire the legacy host scripts (uclog.py, uccon.py, cobs.py) (87bda1c)
• Versions: SoloVer mapped to every manifest; the tree is at 4-alpha1 (6ff4848)
• Native: cargo fmt (50213b7)
• Plan 08: device LICENSE done; import includes post-v3 commits; merge fixes device issue #2 (3f6303b)
• Plan 07: platform checks done for now; Apple signing and notarisation tested (d899ff3)
• Firmware: C071 CDC 332 -> 464.5 kB/s; burst warns only over BLE (ff63d43)
• Web: semihost folder files reach disk while open; handles share writes (98eea0c)
• Hardware e2e reruns; burst flags short bursts over BLE (3b81527)
• Web: one copy of the code shared by core and the VS Code extension (4f86d7b)
• NUCLEO-C071RB USB: endpoint halt and data toggle reset (c0db9eb)
• VS Code: connecting to a device stops the other kept hubs (c14b626)
• firmware/README.md: native uclog BLE rate with Intel's 2026 driver (621f072)
• Docs: BLE throughput on Windows depends on the Bluetooth driver (58e70da)
• native/README.md: logdata settings first, env vars for CLI and tests (65eed6c)
• VS Code: list devices held by a kept hub; Stop Hub (301bf19)
• .envrc: Homebrew's rustup only where brew exists; direnv on Windows (e71be35)
• Semihost sandbox: tested on Windows; refuse names that are not portable (01085d6)
• Native: skip the keyring without a D-Bus session; Windows and WSL2 notes (ebadf56)
• GUI: don't persist egui memory; silence btleplug's own log output (227f2ab)
• Logdata: one shared cache, clearer service errors, retry without a token (0e21a29)
• .envrc: source an ignored .secrets file (logdata service tokens) (f8f1f31)
• Plan 08: public repository, distribution and documentation site (5641c63)
• Docs: why C071 HID and CDC are slower than the bus (2ea1ec5)
• Docs: macOS build setup (Homebrew rustup, direnv) (9d24326)
• Add .envrc: put Homebrew rustup's cargo on PATH (direnv) (b2a1e80)
• Release CI runs locally with act; plan 07 review follow-ups (7a5341b)
• … and 24 more

Device library 4

The ucLog device library 4 (device/; mirrored as v4 in UnitCircleInc/uclog-device).