← All projects

service · development

Souveraine USB

Dock roles, USB display, input, networking and storage under one session authority.

Documentation only Source declaration: 0.1.0 License: AGPL-3.0-or-later

Information collected 2026-11-12

The USB integration component for Souveraine: dock roles, gadget profiles, display, input, networking and host-backed storage under one session authority.

The USB receiver presents incoming display frames in an ordinary Wayland window and returns local keyboard and pointer input through the prepared HID endpoints. It attaches to an existing gadget; it does not take the display controller or create a competing gadget owner.

The composite profile combines display, input and networking, with optional host-backed storage. Sessiond owns mode changes and their admission. Powered dock input and charging have been exercised together; automatic docking and the complete port lifecycle remain in development.

Car display uses a dedicated ViewTop zone, reached through the existing Move control. Its first acceptance is a maps application on the car touchscreen with input returned to that application. The capture and input integration remain open.

Keep the dependency boundary visible

The receiver uses Sam Day’s GUD gadget work at a pinned revision. Casey reports Sam’s permission to use his upstream repositories in this integration. The pinned dependency’s missing license declaration remains visible; source use, the private package route and public redistribution are distinct decisions.

What remains open

  • Complete port-lifecycle enforcement and the admitted USB Hands route remain under the existing session authority.
  • Viewing, host input and monitor behavior need separate physical acceptance.
  • The substrate builds the pinned receiver source into its aarch64 package; Pixel3Arch packages the companion gadget and storage mechanisms.
Documentation and evidence record

Source CI observed for this documentation revision: not-observed. Application builds and device acceptance are separate evidence.

Documentation owner: Fimeg/souveraine-usb
Repository revision: 52dc1a08a22f3158437537839a5c3cbae06b9aba
Document: public-docs/usb.md
Document SHA-256: cbba6fb3c559cf90d3a2307633056bdec6f3d5755f6212291fa0f2b98f273de4