Skip to content

waybeam: bump to the CV610 parity merge, and ship libbin.so - #6

Merged
snokvist merged 1 commit into
masterfrom
fix/waybeam-cv610-parity-bump
Sep 6, 2026
Merged

snokvist merged 1 commit into
masterfrom
fix/waybeam-cv610-parity-bump

Conversation

@snokvist

@snokvist snokvist commented Sep 6, 2026

Copy link
Copy Markdown
Owner

Summary

Bumps WAYBEAM_VERSION to 0c660fc5 (OpenIPC/waybeam#120), which brings the CV610 backend to parity: RTP sidecar, sensor orientation, ROI, live output retarget, portable AE ceilings, and PQTools .bin import/export.

Why libbin.so is here

The .bin features dlopen("libbin.so"), and nothing put it on the craft — so every image needed a manual scp, or isp.sensorBin and /api/v1/iq/export_bin silently no-opped.

The blob is carried in files/ and fed to waybeam's own stage step via CV610_PQ_LIB, so there is one source of truth for the file and the install comes from the staged output like every other artifact.

WAYBEAM_LICENSE names it. The waybeam sources are MIT; libbin.so is a third-party HiSilicon PQ library redistributed unmodified, and is neither ours nor MIT. Declaring plain MIT would have quietly extended that licence over a proprietary blob.

Also installed

iq-profiles/cv610-bin/imx662.bin/etc/sensors/imx662.bin, as an IQ restore point. Deliberately not named by the default config: importing a tune at boot is opt-in, and this one only reproduces the sensor plugin's own cold-boot state.

Degradation without the blob

A craft without libbin.so still boots — the import warns and no-ops, and since waybeam 0.81.0 it also advertises neither isp.sensorBin nor routes.iq_export_bin, so the control surface matches what it can actually serve. Verified on a CV610 bench by moving the library aside: both capability signals went false, the endpoint 501'd, and the craft streamed normally.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GwG8Jmv3daUQgZhMYyz3wB

WAYBEAM_VERSION moves to 0c660fc5 (OpenIPC/waybeam#120), which brings the
CV610 backend to parity: RTP sidecar, sensor orientation, ROI, live output
retarget, portable AE ceilings, and PQTools .bin import/export.

The .bin features dlopen libbin.so, and nothing put it on the craft -- so
every image needed a manual scp or isp.sensorBin and /api/v1/iq/export_bin
silently no-opped.  The blob is carried in files/ and fed to waybeam's own
stage step via CV610_PQ_LIB, so there is one source of truth for the file
and the install comes from the staged output like every other artifact.

WAYBEAM_LICENSE names it.  The waybeam sources are MIT; libbin.so is a
third-party HiSilicon PQ library redistributed unmodified, and is neither
ours nor MIT.  Declaring plain MIT would have quietly extended that licence
over a proprietary blob.

Also installs iq-profiles/cv610-bin/imx662.bin to /etc/sensors/ as an IQ
restore point.  Deliberately NOT named by the default config: importing a
tune at boot is opt-in, and this one only reproduces the sensor plugin's
own cold-boot state.

A craft without the blob still boots -- the import warns and no-ops, and
since 0.81.0 it also advertises neither isp.sensorBin nor
routes.iq_export_bin, so the control surface matches what it can serve.
Verified on a CV610 bench by moving the library aside.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GwG8Jmv3daUQgZhMYyz3wB
@snokvist
snokvist merged commit f293f58 into master Sep 6, 2026
8 of 10 checks passed
@snokvist
snokvist deleted the fix/waybeam-cv610-parity-bump branch September 6, 2026 06:22
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