genode/repos/dde_bsd
Josef Söntgen 47990f37d7 dde_bsd: update audio driver to OpenBSD 5.9
In addition to updating the contrib sources the driver now uses the
new Component API and will report the internal mixer state.

Reporting of the mixer state is enabled by adding the 'report_mixer'
attribute to the drivers configuration and setting its value to 'yes'.

The following snippets illustrates the format of the report:

!<mixer_state>
!  <mixer field="inputs.beep" value="108"/>
!  <mixer field="outputs.hp_sense" value="plugged"/>
!  <mixer field="outputs.master" value="128,128"/>
!  <mixer field="outputs.mic_sense" value="unplugged"/>
!  <mixer field="outputs.spkr_muters" value="hp,mic"/>
!</mixer_state>

The mixer state may expose other mixer fields as well, depending on the
used sound card. The naming scheme of the attributes intentionally
matches the naming scheme of OpenBSD's mixerctl(1) program.

Each 'mixer' node can be used to configure the audio driver by using it
in its configuration, e.g.:

!<config report_mixer="yes">
!  <mixer field="outputs.master" value="255,255"/>
!</config>

This configuration will set the output volume to the highest possible
value. Although it is now also possible to update the configuration
at run-time it should not be done while the driver is currently playing
or recording because it may provoke the generation of artefacts.

Fixes #1973.
2016-05-23 15:52:51 +02:00
..
include/audio dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
lib dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
patches dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
ports dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
run dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
src dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00
README tool: remove deprecated 'make prepare' mechanism 2016-03-17 17:02:04 +01:00
audio.list dde_bsd: update audio driver to OpenBSD 5.9 2016-05-23 15:52:51 +02:00

README

This repository contains device drivers ported from OpenBSD.

Audio
#####

The audio driver is ported from OpenBSD 5.7 and includes support for
Intel HD Audio as well as for Ensoniq AudioPCI (ES1370) compatible
soundcards. The HDA driver works on real hardware and Virtualbox
whereas the ES1370 driver is only used in Qemu.


Usage
=====

You have to prepare the contrib sources for this repository by
executing _./tool/ports/prepare_port dde_bsd_. Also you need to make
sure to add the 'dde_bsd' repository to the REPOSITORIES variable
in your 'etc/build.conf'.


Example
=======

The driver can be tested by executing the run script 'run/audio_out.run'.
This example plays a sample file in a loop. The file format is header less
two channel float 32 at 44100 Hz. You may use the 'sox' utility to create
these audio files:

! sox -c 2 -r 44100 foo.wav foo.f32