Skip to content

Commit

Permalink
ALSA PCM plugin hw compatibility modes silence
Browse files Browse the repository at this point in the history
  • Loading branch information
borine committed Dec 13, 2024
1 parent 06994fa commit 78eea84
Show file tree
Hide file tree
Showing 3 changed files with 325 additions and 74 deletions.
1 change: 1 addition & 0 deletions .github/spellcheck-wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,7 @@ renderer
scalable
signedness
stdin
sys
syslog
tmp
tty
Expand Down
16 changes: 11 additions & 5 deletions doc/bluealsa-plugins.7.rst
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ PCM Parameters
Modifies the behaviour of the plugin on ``a2dp-sink``, ``hfp-hf`` and
``hsp-hs`` nodes in order to align better with the behaviour of the ALSA
``hw`` plugin. This is a string option which takes the values **"none"**,
or **"busy"**.
**"busy"** or **silence**.
See `Transport acquisition`_ in the **NOTES** section below for more
information.

Expand Down Expand Up @@ -137,7 +137,7 @@ own configuration (e.g. in ~/.asoundrc.conf) for example:
defaults.bluealsa.codec "cvsd"
defaults.bluealsa.volume "50+"
defaults.bluealsa.softvol off
defaults.bluealsa.hwcompat "busy"
defaults.bluealsa.hwcompat "silence"
defaults.bluealsa.delay 5000
defaults.bluealsa.service "org.bluealsa.source"

Expand Down Expand Up @@ -187,7 +187,7 @@ configuration node has the following fields:
[codec STR] # Preferred codec
[volume STR] # Initial volume for this PCM
[softvol BOOLEAN] # Enable/disable BlueALSA's software volume
[hwcompat STR] # HW compatibility mode (none or busy)
[hwcompat STR] # HW compatibility mode (none, busy or silence)
[delay INT] # Extra delay (frames) to be reported (default 0)
[service STR] # DBus name of service (default org.bluealsa)
}
Expand Down Expand Up @@ -569,8 +569,8 @@ only the HFP-AG node can change the HFP codec.
Transport acquisition
---------------------

The audio connection of a profile is not established immediately that a device
connects. The A2DP source device, or HFP/HSP gateway device, must first
The audio connection of a Bluetooth profile is not established immediately that
a device connects. The A2DP source device, or HFP/HSP gateway device, must first

Check failure on line 573 in doc/bluealsa-plugins.7.rst

View workflow job for this annotation

GitHub Actions / doc8-lint

D001

Line too long
"acquire" the profile transport.

When the BlueALSA PCM plugin is used on a source A2DP or gateway HFP/HSP node,
Expand Down Expand Up @@ -605,6 +605,12 @@ takes the following values:
PCM stream and enters the **SND_PCM_STATE_DISCONNECTED** state if the remote

Check failure on line 605 in doc/bluealsa-plugins.7.rst

View workflow job for this annotation

GitHub Actions / doc8-lint

D001

Line too long
device releases the transport while in use.

- "silence"

Inserts silence for capture streams, or simply drops frames for playback
streams, whenever the transport is not acquired, thus maintaining a
continuous stream as far as the application is concerned.

PCM drain and non-blocking operation
------------------------------------

Expand Down
Loading

0 comments on commit 78eea84

Please sign in to comment.