Skip to content

Add PID 1209:AEEE for Aemeath Virtual Audio Device - #1387

Open
Yukari316 wants to merge 1 commit into
pidcodes:masterfrom
Hoshikawa-Kaguya:pid-AEEE
Open

Yukari316 wants to merge 1 commit into
pidcodes:masterfrom
Hoshikawa-Kaguya:pid-AEEE

Conversation

@Yukari316

Copy link
Copy Markdown

This PR requests PID 1209:AEEE for Aemeath, and adds an organisation page for Hoshikawa-Kaguya.

Project

  • Aemeath is an open-source virtual audio console for Windows (node-graph routing, per-app routing, recording).
  • License: AGPL-3.0. The LICENSE file is at the repository root.
  • Source: https://github.com/Hoshikawa-Kaguya/Aemeath

Why a software project needs a PID
Aemeath has no physical hardware. Its 8 virtual inputs and 8 virtual outputs are software-emulated USB Audio Class 2.0 devices. They are served over USB/IP and attached through the usbip-win2 VHCI driver, so Windows loads its in-box usbaudio2 class driver for them. This means users don't need a custom kernel driver, test signing, or to turn off Secure Boot.

  • Windows identifies a device instance by VID/PID + serial number. Audio endpoint IDs, and the devices users pick in apps like OBS, are tied to that instance. So the ID has to stay the same for every installation and every release.
  • Every user runs the same program, so users can't request their own PIDs.
  • During development we use the test PIDs 1209:0001 / 1209:0002. Those aren't meant for distribution.

USB descriptors
The descriptors are generated in engine/aemeath-usbip/src/descriptors.rs. The identity values are in engine/aemeath-usbip/src/identity.rs#L37-L45.

  • Device: high-speed, bcdUSB 0x0200. Device class 0xEF/0x02/0x01 (Miscellaneous / IAD). idVendor 0x1209, idProduct 0xAEEE.
  • bcdDevice: 0x0100 for inputs (playback devices), 0x0101 for outputs (recording devices).
  • Strings: manufacturer Aemeath; product Aemeath In 1–Aemeath In 8 and Aemeath Out 1–Aemeath Out 8; serial AEMIN01–AEMIN08 and AEMOUT01–AEMOUT08.
  • One configuration with one UAC2 function (an IAD followed by an AudioControl interface and an AudioStreaming interface). Function category is I/O Box. The function has one internal programmable clock source and one stereo terminal pair.
  • Each device has a single direction, because the Windows usbaudio2 driver supports only one clock source per device:
    • Input: USB Streaming input terminal → Speaker output terminal. Isochronous OUT endpoint 0x01, adaptive synchronization.
    • Output: Line Connector input terminal → USB Streaming output terminal. Isochronous IN endpoint 0x82, asynchronous synchronization.
  • AudioStreaming alternate settings 1–5 offer 16-bit PCM, 24-bit PCM, 32-bit PCM, 32-bit IEEE float and 24-in-32-bit PCM.
  • Sample rates are 44.1 kHz to 768 kHz. Stereo only. Bus-powered, 100 mA.

Scope
We need only this one PID. All 16 virtual devices share it: bcdDevice separates the two directions, and the serial number identifies each device.

python -m test.validate_pids passes locally.

This branch has not been deployed

No deployments
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