path: root/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
diff options
authorBenedict Reuschling <bcr@FreeBSD.org>2019-01-02 18:01:55 +0000
committerBenedict Reuschling <bcr@FreeBSD.org>2019-01-02 18:01:55 +0000
commitbb698cf5e01346f22da7e1e2e41393c9ea56469f (patch)
treed716619c91aa23e431563d78e98c65a677f54a59 /en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
parent8726e8cb1a780c6196ec49a513e14ef08fca7aad (diff)
Add more information about Bluetooth usage.
The patch shows how to create a remote device connection and how to manage devices in /etc/bluetooth/hosts. The multimedia chapter was extended with a description on how to set up and connect a Bluetooth audio device as a sound sink. It also adds man page references to man-refs.ent for hcsecd(8) and virtual_oss(8), respectively. I cleaned up the patch a bit for consistency and proper markup. PR: 228879 Submitted by: nekoxmachina@gmail.com Take a look at this PR by: lme
Notes: svn path=/head/; revision=52744
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/multimedia/chapter.xml')
1 files changed, 47 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
index 3351673e28..a62776be79 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
@@ -84,6 +84,10 @@
<para>Configure an image scanner.</para>
+ <listitem>
+ <para>Configure a Bluetooth headset.</para>
+ </listitem>
<para>Before reading this chapter, you should:</para>
@@ -286,6 +290,49 @@ pcm2: &lt;Conexant CX20590 (Analog 2.0+HP/2.0)&gt; (play/rec) default</screen>
+ <sect2 xml:id="bluetooth-headset">
+ <title>Setting up Bluetooth Sound Devices</title>
+ <indexterm>
+ <primary>Bluetooth audio</primary>
+ </indexterm>
+ <para>Connecting to a Bluetooth device is out of scope for this
+ chapter. Refer to <xref
+ linkend="network-bluetooth"/> for more information.</para>
+ <para>To get Bluetooth sound sink working with FreeBSD's sound
+ system, users have to install
+ <package>audio/virtual_oss</package> first:</para>
+ <screen>&prompt.root; <userinput>pkg install virtual_oss</userinput></screen>
+ <para><package>audio/virtual_oss</package> requires
+ <literal>cuse</literal> to be loaded into the kernel:</para>
+ <screen>&prompt.root; <userinput>kldload cuse</userinput></screen>
+ <para>To load <literal>cuse</literal> during system startup, run
+ this command:</para>
+ <screen>&prompt.root; <userinput>sysrc -f /boot/loader.conf cuse_load=yes</userinput></screen>
+ <para>To use headphones as a sound sink with
+ <package>audio/virtual_oss</package>, users need to create a
+ virtual device after connecting to a Bluetooth audio
+ device:</para>
+ <screen>&prompt.root; <userinput>virtual_oss -C 2 -c 2 -r 48000 -b 16 -s 768 -R /dev/null -P /dev/bluetooth/<replaceable>headphones</replaceable> -d dsp</userinput></screen>
+ <note>
+ <para><replaceable>headphones</replaceable> in this example is
+ a hostname from <filename>/etc/bluetooth/hosts</filename>.
+ <literal>BT_ADDR</literal> could be used instead.</para>
+ </note>
+ <para>Refer to &man.virtual_oss.8; for more information.</para>
+ </sect2>
<sect2 xml:id="troubleshooting">
<title>Troubleshooting Sound</title>