mpd/doc
Constantin Fuerst 955502f881 output/oss: enable DoP
Explanation

This adds support for DOP using the PcmExport function if the macro
ENABLE_DSD is defined. If enabled within the config-file using "dop",
the boolean dop_setting will be true. If DSD input is encountered and
the setting is on, it is checked whether the oss-device supports the
required samplerate. If that is the case, dop_active is set to true
and conversion of the input is prevented. If the sample rate is not
supported, conversion to S32 is requested. When playing back, the
PcmExport is used to pack the incoming stream into PCM.  Reasoning

This is required for OSs without the required driver support for
native DSD playback that also have no ALSA. Mainly *BSD users are the
target audience for this functionality, as ALSA here is only a proxy
without full functionality.  Requirements

    DAC that supports the DOP standard
    Building with OSS, DSD and S32-Format

Supported Formats / Required PCM Formats

DSF, DFF and WavPack-DSD will work.

DSD64, 1 Channel -> S24:176.4kHz (untested, lack of time / missing samples)
DSD64, 2 Channel -> S24:352.8kHz
DSD64, 4 Channel -> S24:705.6kHz (untested, lmissing equipment)
DSD128, 1 Channel -> S24:352.8kHz (untested, lack of time / missing samples)
DSD128, 2 Channel -> S24:705.6kHz
DSD256, 1 Channel -> S24:705.6kHz (untested, lack of time / missing samples)
Changes

    inclusion of required files
    adding new domain for logging
    adding dop_satisfied private function
    adding required member variables for storing dop state and for dop-packing
    adding dop boolean parameter to many functions that are required to act a little differently when dop is active

Testing

This has been tested to work with a Sabaj Da2 on FreeBSD, where the
red status indicator LED clearly shows that DSD playback is taking
place, instead of purple for "hi-res" which is seen when converting.
Issues

I have not tested this with S24 and right now AFMT_S32_NE is
required. If not defined, ENABLE_DSD will be undef'ed. This will be
addressed in a bit, however no DAC which supports DOP but not 32Bit is
known to me. Also, AFMT_S32_NE is not defined when building on FreeBSD
which is why this is just blatantly defined in the file at the moment.
Additionally, the new dop-option is not added into any documentation
whatsoever.
2021-08-05 16:21:43 +02:00
..
client.rst Merge branch 'timeout_in_second' of git://github.com/mxjeff/MPD 2021-02-20 20:11:38 +01:00
conf.py increment version number to 0.22.10 2021-07-16 07:23:00 +02:00
developer.rst doc/developer.rst: update branch names 2021-02-15 13:41:46 +01:00
doxygen.conf.in doc/doxygen.conf: enable HAVE_DOT and INTERACTIVE_SVG 2016-03-30 13:47:53 +02:00
index.rst doc/client.rst: new chapter about client development 2021-02-15 13:26:25 +01:00
meson.build Merge branch 'v0.22.x' 2021-05-17 19:33:15 +02:00
mpd.1.rst doc/mpd.1.rst: Update config file documentation. 2020-11-10 15:58:34 +01:00
mpd.conf.5.rst doc/mpd.conf.5.rst: updated ReplayGain website links 2021-01-20 14:58:35 +01:00
mpdconf.example doc/mpd.conf.5.rst: updated ReplayGain website links 2021-01-20 14:58:35 +01:00
plugins.rst output/oss: enable DoP 2021-08-05 16:21:43 +02:00
protocol.rst Add tags relevant to classical music. 2021-03-10 21:24:25 +01:00
user.rst Merge branch 'v0.22.x' 2021-08-05 15:17:07 +02:00