From bb698cf5e01346f22da7e1e2e41393c9ea56469f Mon Sep 17 00:00:00 2001
From: Benedict Reuschling <bcr@FreeBSD.org>
Date: Wed, 2 Jan 2019 18:01:55 +0000
Subject: 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
---
 .../books/handbook/multimedia/chapter.xml          | 47 ++++++++++++++++++++++
 1 file changed, 47 insertions(+)

(limited to 'en_US.ISO8859-1/books/handbook/multimedia/chapter.xml')

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 @@
       <listitem>
 	<para>Configure an image scanner.</para>
       </listitem>
+
+      <listitem>
+	<para>Configure a Bluetooth headset.</para>
+      </listitem>
     </itemizedlist>
 
     <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>
       </note>
     </sect2>
 
+    <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>
 
-- 
cgit v1.2.3