How yueze/cardmic works
Cardmic turns a Cardputer into a microphone over USB or Wi-Fi. On-device, audio is captured and processed, then sent by USB Audio or as network packets; pairing protects wireless audio. On the computer, the receiver discovers the device, authenticates and orders packets, handles loss and buffering, and plays samples into a virtual loopback device that dictation apps select as a microphone. The desktop app adds device status, pairing, settings, and updates. The README documents these capabilities; some implementation links below rely on that documentation because the relevant source was not sampled.
Main entry points: lib.rs Receiving engine · app.rs Menu and status · cardmic_net.c Wi-Fi audio and discovery · app_cardmic.cpp Device settings and display
Components 20
Cardputer firmware
- Audio capture and DSP
firmware/main/apps/app_cardmic/app_cardmic.cpp - Device settings and display
firmware/main/apps/app_cardmic/app_cardmic.cpp
Audio transport
- USB audio and talk key
firmware/main/apps/app_cardmic/cardmic_usb.c - Wi-Fi audio and discovery
firmware/main/apps/app_cardmic/cardmic_net.c - Pairing and encryption
firmware/main/apps/app_cardmic/cardmic_pair.c - Packet protocol
client/core/src/protocol.rs - Key derivation
client/core/src/pairing.rs
Desktop receiver
- Receiving engine
client/engine/src/lib.rs - Discovery targets
client/engine/src/net.rs - Buffer and drift control
client/engine/src/drift.rs - Audio visualization data
client/engine/src/spectrum.rs - Loopback playback
client/audio/src/sink.rs
Desktop experience
- Menu and status
client/tray/src/app.rs - Device selection
client/tray/src/devices.rs - App settings
client/tray/src/settings.rs - Self-updater
client/tray/src/update.rs - USB pairing monitor
client/tray/src/usb.rs
Other components
- Cardputer user
- Dictation app
- Virtual audio device
Connections 23
- Cardputer user → Device settings and display: configures
- Audio capture and DSP → USB audio and talk key: provides audio
- Audio capture and DSP → Wi-Fi audio and discovery: provides audio
- Device settings and display → Pairing and encryption: sets pairing
- Device settings and display → Wi-Fi audio and discovery: sets device name
firmware/main/apps/app_cardmic/app_cardmic.cpp - Pairing and encryption → Wi-Fi audio and discovery: secures stream
- USB audio and talk key → Cardputer user: sends talk key
- USB audio and talk key → Dictation app: provides microphone
- Wi-Fi audio and discovery → Receiving engine: streams packets
- Receiving engine → Discovery targets: gets targets
client/engine/src/lib.rs - Receiving engine → Packet protocol: decodes packets
- Receiving engine → Key derivation: opens encrypted audio
- Receiving engine → Buffer and drift control: controls buffering
client/engine/src/lib.rs - Receiving engine → Audio visualization data: reports spectrum
client/engine/src/lib.rs - Receiving engine → Loopback playback: plays samples
client/engine/src/lib.rs - Loopback playback → Virtual audio device: outputs audio
client/audio/src/sink.rs - Virtual audio device → Dictation app: feeds microphone
- Menu and status → Receiving engine: starts receiver
- Menu and status → Device selection: reads devices
client/tray/src/app.rs - Menu and status → App settings: reads settings
client/tray/src/app.rs - Menu and status → Self-updater: checks updates
client/tray/src/app.rs - Menu and status → USB pairing monitor: monitors USB
client/tray/src/app.rs - USB pairing monitor → Key derivation: transfers pairing code