diff options
Diffstat (limited to 'static/netbsd/man4/btsco.4 4.html')
| -rw-r--r-- | static/netbsd/man4/btsco.4 4.html | 97 |
1 files changed, 97 insertions, 0 deletions
diff --git a/static/netbsd/man4/btsco.4 4.html b/static/netbsd/man4/btsco.4 4.html new file mode 100644 index 00000000..9a3070bf --- /dev/null +++ b/static/netbsd/man4/btsco.4 4.html @@ -0,0 +1,97 @@ +<table class="head"> + <tr> + <td class="head-ltitle">BTSCO(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">BTSCO(4)</td> + </tr> +</table> +<div class="manual-text"> +<section class="Sh"> +<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> +<p class="Pp"><code class="Nm">btsco</code> — <span class="Nd">Bluetooth + SCO Audio</span></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> +<p class="Pp"><code class="Cd">btsco* at bthub?</code> + <br/> + <code class="Cd">audio* at audiobus?</code></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> +<p class="Pp">The <code class="Nm">btsco</code> driver provides support for + Bluetooth SCO (Synchronous connection-oriented) Audio devices through the + <a class="Xr">audio(4)</a> driver.</p> +<p class="Pp">The <code class="Nm">btsco</code> driver must be configured at run + time with the <a class="Xr">btdevctl(8)</a> program. The following + properties are used by the <code class="Nm">btsco</code> driver during + autoconfiguration:</p> +<dl class="Bl-tag"> + <dt>local-bdaddr</dt> + <dd>Local device address.</dd> + <dt>remote-bdaddr</dt> + <dd>Remote device address.</dd> + <dt>service-name</dt> + <dd>The <code class="Nm">btsco</code> driver matches the ‘HF’ + and ‘HSET’ services. For the ‘HF’ service, the + <code class="Nm">btsco</code> device will, on <a class="Xr">open(2)</a>, + listen for incoming connections from the remote device. Otherwise, + <code class="Nm">btsco</code> will attempt to initiate a connection to the + remote device.</dd> + <dt>rfcomm-channel</dt> + <dd>This integer value is not used directly, but will be stored and passed via + the <code class="Dv">BTSCO_INFO</code> ioctl as below:</dd> +</dl> +<p class="Pp">SCO connections require a baseband connection between the two + devices before they can be created. The <code class="Nm">btsco</code> driver + does not create this, but can provide information to facilitate an + application setting up a control channel prior to use, via the + <code class="Dv">BTSCO_INFO</code> <a class="Xr">ioctl(2)</a> call on the + mixer device, which returns a <var class="Ar">btsco_info</var> structure as + follows:</p> +<div class="Bd Pp Li"> +<pre>#include <dev/bluetooth/btsco.h> + +struct btsco_info { + bdaddr_t laddr; /* controller bdaddr */ + bdaddr_t raddr; /* headset bdaddr */ + uint8_t channel; /* RFCOMM channel */ + int vgs; /* mixer index speaker */ + int vgm; /* mixer index mic */ +}; + +#define BTSCO_INFO _IOR('b', 16, struct btsco_info)</pre> +</div> +<p class="Pp">The <code class="Nm">btsco</code> driver can be configured to act + in Connect or Listen mode. In Connect mode, the + <code class="Nm">btsco</code> driver will initiate a connection to the + remote device on an <a class="Xr">open(2)</a> call, whereas in Listen mode, + <a class="Xr">open(2)</a> will block until the remote device initiates the + connection.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE + ALSO</a></h1> +<p class="Pp"><a class="Xr">bthset(1)</a>, <a class="Xr">ioctl(2)</a>, + <a class="Xr">audio(4)</a>, <a class="Xr">bluetooth(4)</a>, + <a class="Xr">bthub(4)</a>, <a class="Xr">btdevctl(8)</a></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> +<p class="Pp">The <code class="Nm">btsco</code> driver was written for + <span class="Ux">NetBSD 4.0</span> by <span class="An">Iain Hibbert</span> + under the sponsorship of Itronix, Inc.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp"><code class="Nm">btsco</code> takes no notice of the HCI Voice + Setting in the Bluetooth controller, and this must be 0x0060 (the default) + as alternate values are currently unsupported.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">November 29, 2014</td> + <td class="foot-os">NetBSD 10.1</td> + </tr> +</table> |