Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gtxaspec/ingenic-audiodaemon
audio input/output daemon and client for ingenic hardware
https://github.com/gtxaspec/ingenic-audiodaemon
audio ingenic microphone speaker t10 t20 t21 t23 t31 t40 t41 thingino
Last synced: about 1 month ago
JSON representation
audio input/output daemon and client for ingenic hardware
- Host: GitHub
- URL: https://github.com/gtxaspec/ingenic-audiodaemon
- Owner: gtxaspec
- Created: 2023-09-21T18:47:50.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-08T14:53:16.000Z (3 months ago)
- Last Synced: 2024-10-31T22:42:06.064Z (about 2 months ago)
- Topics: audio, ingenic, microphone, speaker, t10, t20, t21, t23, t31, t40, t41, thingino
- Language: C
- Homepage:
- Size: 2.26 MB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ingenic Audio Daemon
The **Ingenic Audio Daemon** (iad) serves as an intermediary between the audio kernel modules and client applications, facilitating audio input and output operations on Ingenic hardware.
- **iad (Ingenic Audio Daemon)**: A background process for handling audio on Ingenic devices.
- **iac (Ingenic Audio Client)**: A client-side utility to interact with the audio daemon.
- **audioplay**: A standalone audio player for Ingenic devices.
- **web_client**: A client utility that establishes a WebSocket server, enabling the capture and streaming of audio data from web browsers.
- **wc-console**: A client tool that establishes a WebSocket server, used for audio debugging, outputting the audio stream to stdout.
---
## Prerequisites
- T20/T31/T40 Devices: Audio Input & Playback tested on T20/T31. If you have a T40 device, feedback is welcome.
- Before running the audio daemon, ensure that the audio kernel modules are loaded.
- The daemon sets up the `IMP_AI` and `IMP_AO` devices, so it's essential for these modules to be initialized first.
---
## Features
- Low latency
- AI supports multiple clients
- AO supports queued playback from multiple sources
---
## Compiling
### Prerequisites
Before you begin, ensure you have:
- A Linux-based operating system.
- The required cross-compilation tools for Ingenic devices.
- Git (for versioning support in the build system).
### Directory Structure
- `src/`: Contains the source code for the tools. Each tool has its own subdirectory.
- `lib/`: Contains necessary libraries.
- `include/`: Contains header files.
- `build/`: Contains object files and binaries after compilation.
- `config/`: Contains configuration files and templates.
### Compiling the Tools
1. **Prepare the Environment**: Ensure you have set up the cross-compilation environment for Ingenic devices.
2. **Clone the Repository**
3. **Compile All Tools**: `make`
This will compile the audio daemon (iad), audio client (iac), and the standalone audio player (audioplay)
4. **Compile Individual Tools**:
If you only need to compile one of the tools, you can do so individually:
```
make iad # For the audio daemon
make iac # For the audio client
make audioplay # For the standalone audio player
make deps # Build dependencies for websocket servers
make web_client # For the websocket server
make wc-console # For the websocket debugging server
```
5. **Clean the Build**:
If you need to clean up the compiled objects and binaries:
`make clean`
For a deeper clean (removes the compiled binaries as well):
`make distclean`
---
## Running the Daemon
To run the audio daemon:
```
./iad [-c] [-d ] [-h]
```
#### Options:
- `-c`: - Path to configuration file specified by (default: ./iad.json)
- `-d`: Disable AI (Audio Input) or AO (Audio Output)
- `-h`: Display this help message
---
## Using the Audio Client
The audio client provides various functionalities, from playing audio to recording it. Audio client functionality can be integrated into your own program to interface with the daemon if desired.
### Usage:
```
./iac [-f ] [-s] [-r ] [-o]
```
#### Options:
- `-f`: AO - Play an audio file specified by ``.
- `-s`: AO - Read audio from the standard input (`stdin`).
- `-r`: AI - Record audio and save it to a file specified by ``.
- `-o`: AI - Output audio to the standard output (`stdout`).
For example, if you want to play a specific audio file, you can use:
```
./iac -f path_to_your_audio_file.wav
```
---
### stdin examples:
```
ffmpeg -re -i https://wpr-ice.streamguys1.com/wpr-ideas-mp3-64 -af volume=-15dB -f s16le -ac 1 -ar 48000 - | ./iac -s
ffmpeg -f s16le -ar 16000 -ac 1 -i test_file.pcm -acodec pcm_s16le -f s16le -ac 1 -ar 48000 - | ./iac -s
```
#### Play or send audio to the device over the network:
#### On device ( using `nc`, listen persistently on device ip, port 8081 )
```
nc -ll -p 8081 -e ./iac -s
```
#### On PC:
1. Capture microphone:
```
ffmpeg -f alsa -ac 1 -i default -f s16le -ar 48000 -ac 1 tcp://192.168.2.2:8081
```
2. Play live audio stream:
```
ffmpeg -re -i https://wpr-ice.streamguys1.com/wpr-ideas-mp3-64 -af volume=-5dB -f s16le -ac 1 -ar 48000 tcp://192.168.2.2:8081
```
3. Play computer audio output:
Find your output source:
`pactl list short sources`:
```
$ pactl list short sources
49 alsa_output.pci-0000_00_1f.3.analog-stereo.monitor PipeWire s32le 2ch 48000Hz SUSPENDED
50 alsa_input.pci-0000_00_1f.3.analog-stereo PipeWire s32le 2ch 48000Hz SUSPENDED
```
Set your source on the ffmpeg commandline:
```
ffmpeg -f pulse -ac 1 -i alsa_output.pci-0000_00_1f.3.analog-stereo.monitor -f s16le -ar 48000 -ac 1 tcp://192.168.2.2:8081
```
Latency is very decent!
Note: Set the sample rate on the ffmpeg command line to match your settings.