Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update audio-interfaces documentation & related media #670

Open
wants to merge 8 commits into
base: master
Choose a base branch
from
Open

docs: update audio-interfaces documentation & related media #670

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
2bd07df
dac-vars Replacement
theoisadoor Sep 8, 2024
a83ccc5
Update 05-audio-interfaces.md
theoisadoor Sep 8, 2024
db9517a
Update 05-audio-interfaces.md
theoisadoor Sep 8, 2024
5e4b6f2
Update 05-audio-interfaces.md
theoisadoor Sep 8, 2024
dac7ef9
Merge pull request #1 from theoisadoor/theoisadoor-patch-1
theoisadoor Sep 8, 2024
97ef2f1
Replace dac-vars.png
theoisadoor Sep 8, 2024
bf2d9b9
Update 05-audio-interfaces.md
theoisadoor Sep 8, 2024
cd67c56
Merge pull request #2 from theoisadoor/theoisadoor-patch-1
theoisadoor Sep 8, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 39 additions & 39 deletions docs/05-audio-interfaces.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,53 +38,53 @@ To get a DAC board to work with balenaSound you will need to enable its correspo
In the balenaCloud dashboard:

- Click on the specific device within your fleet and select `Configuration` in the left-side menu.
- Add an additional custom configuration variable called `BALENA_HOST_CONFIG_dtoverlay`. The value of this will depend on your DAC board (see tables below in each DAC category subsection).
- Add an additional custom configuration variable called `BALENA_HOST_CONFIG_dtoverlay`, and where necessary `BALENA_HOST_CONFIG_gpio`. The value of this will depend on your DAC board (see tables below in each DAC category subsection).
- Cycle the power by unplugging your device.

![DAC Configuration](https://raw.githubusercontent.com/balenalabs/balena-sound/master/docs/images/dac-vars.png)
![DAC Configuration](https://github.com/theoisadoor/balena-sound/blob/97ef2f10761d44d3e0cbcebec238daee5cc01c24/docs/images/dac-vars.png)

If you're using multiple devices with multiple DACs for multi-room audio, you'll want to do this process per unique device that is using a DAC. Do not set this variable fleet-wide as it will affect every device within your fleet.
If you're using multiple devices with multiple DACs for multi-room audio, you'll want to do this process per unique device that is using a DAC. Unless your configuration is identical across all devices within your fleet (same device and DAC setup), do not set this variable fleet-wide as it will affect every device within your fleet. Device specific `Custom configuration` is found within `Fleet > Devices > (Your Device) > Device Configuration`.

### Supported DACs

These are the DACs that are known to work with balenaSound. If you have trouble setting one up, please reach us at our [forums](https://forums.balena.io/) where we'll gladly help you troubleshoot the issue. Please **do not** create new GitHub issues for supported DACs unless you've been instructed to do so by our forums support agents.

| DAC Name | BALENA_HOST_CONFIG_dtoverlay |
| -------------------------------------------- | ---------------------------- |
| [Suptronics X400][1] | iqaudio-dacplus |
| [Pimoroni Pirate Audio][12] | hifiberry-dac |
| [Pimoroni pHAT DAC][2] | hifiberry-dac |
| [Justboom DAC HAT/Zero][3] | justboom-dac |
| [Justboom Amp HAT/Zero][30] | justboom-dac |
| [Justboom Digi HAT/Zero][25] | justboom-digi |
| [Pisound][4] | pisound |
| [InnoMaker HiFi DAC HAT][8] | allo-boss-dac-pcm512x-audio |
| [InnoMaker HiFi Amp HAT][35] | hifiberry-amp |
| [Boss DAC v1.2][29] | allo-boss-dac-pcm512x-audio |
| [miniBoss DAC][10] | allo-boss-dac-pcm512x-audio |
| [PiFi Digi+][11] | hifiberry-digi |
| [IQaudIO Pi-DAC+][13] | iqaudio-dacplus |
| [IQaudIO Pi-DAC Pro][31] | iqaudio-dacplus |
| [IQaudIO Pi-DACZero][32] | iqaudio-dacplus |
| [IQaudIO Pi-Digi+][33] | iqaudio-digi-wm8804-audio |
| [IQaudIO Pi-DigiAMP+][34] | iqaudio-dacplus,unmute_amp |
| [Hifiberry Amp2][14] | hifiberry-dacplus |
| [Hifiberry DAC+][6] | hifiberry-dacplus |
| [Hifiberry DAC+ Light][15] | hifiberry-dac |
| [Hifiberry DAC+ Standard][16] | hifiberry-dacplus |
| [Hifiberry DAC+ Pro][17] | hifiberry-dacplus |
| [Hifiberry DAC Zero][18] | hifiberry-dac |
| [Hifiberry Amp+][19] | hifiberry-amp |
| [Hifiberry Digi][20] | hifiberry-digi |
| [Hifiberry Digi+][21] | hifiberry-digi |
| [Hifiberry Beocreate][22] | hifiberry-dac |
| [Hifiberry DAC+ DSP][23] | hifiberry-dac |
| [Hifiberry MiniAmp][24] | hifiberry-dac |
| [Hifiberry DAC2 HD][27] | hifiberry-dacplushd |
| [Adafruit I2S Audio Bonnet][26] | "hifiberry-dac","i2s-mmap" |
| [Adafruit MAX98357 I2S Class-D Mono Amp][28] | "hifiberry-dac”,"i2s-mmap" |
| [RasPiAudio Audio+ DAC][37] | hifiberry-dac |
| [AUDIOPHONICS I-Sabre DAC ES9023][39] | hifiberry-dac |
| DAC Name | BALENA_HOST_CONFIG_dtoverlay | BALENA_HOST_CONFIG_gpio |
| -------------------------------------------- | ---------------------------- | ----------------------- |
| [Suptronics X400][1] | iqaudio-dacplus | |
| [Pimoroni Pirate Audio][12] | hifiberry-dac | 25=op,dh |
| [Pimoroni pHAT DAC][2] | hifiberry-dac | |
| [Justboom DAC HAT/Zero][3] | justboom-dac | |
| [Justboom Amp HAT/Zero][30] | justboom-dac | |
| [Justboom Digi HAT/Zero][25] | justboom-digi | |
| [Pisound][4] | pisound | |
| [InnoMaker HiFi DAC HAT][8] | allo-boss-dac-pcm512x-audio | |
| [InnoMaker HiFi Amp HAT][35] | hifiberry-amp | |
| [Boss DAC v1.2][29] | allo-boss-dac-pcm512x-audio | |
| [miniBoss DAC][10] | allo-boss-dac-pcm512x-audio | |
| [PiFi Digi+][11] | hifiberry-digi | |
| [IQaudIO Pi-DAC+][13] | iqaudio-dacplus | |
| [IQaudIO Pi-DAC Pro][31] | iqaudio-dacplus | |
| [IQaudIO Pi-DACZero][32] | iqaudio-dacplus | |
| [IQaudIO Pi-Digi+][33] | iqaudio-digi-wm8804-audio | |
| [IQaudIO Pi-DigiAMP+][34] | iqaudio-dacplus,unmute_amp | |
| [Hifiberry Amp2][14] | hifiberry-dacplus | |
| [Hifiberry DAC+][6] | hifiberry-dacplus | |
| [Hifiberry DAC+ Light][15] | hifiberry-dac | |
| [Hifiberry DAC+ Standard][16] | hifiberry-dacplus | |
| [Hifiberry DAC+ Pro][17] | hifiberry-dacplus | |
| [Hifiberry DAC Zero][18] | hifiberry-dac | |
| [Hifiberry Amp+][19] | hifiberry-amp | |
| [Hifiberry Digi][20] | hifiberry-digi | |
| [Hifiberry Digi+][21] | hifiberry-digi | |
| [Hifiberry Beocreate][22] | hifiberry-dac | |
| [Hifiberry DAC+ DSP][23] | hifiberry-dac | |
| [Hifiberry MiniAmp][24] | hifiberry-dac | |
| [Hifiberry DAC2 HD][27] | hifiberry-dacplushd | |
| [Adafruit I2S Audio Bonnet][26] | "hifiberry-dac","i2s-mmap" | |
| [Adafruit MAX98357 I2S Class-D Mono Amp][28] | "hifiberry-dac”,"i2s-mmap" | |
| [RasPiAudio Audio+ DAC][37] | hifiberry-dac | |
| [AUDIOPHONICS I-Sabre DAC ES9023][39] | hifiberry-dac | |

[1]: http://www.suptronics.com/Xseries/x400.html
[2]: https://shop.pimoroni.com/products/phat-dac
Expand Down
Binary file modified docs/images/dac-vars.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading