head 1.2; access; symbols cjep_sun2x:1.2.0.44 cjep_sun2x-base:1.2 cjep_staticlib_x-base1:1.2 cjep_staticlib_x:1.2.0.42 cjep_staticlib_x-base:1.2 phil-wifi-20200421:1.2 phil-wifi-20200411:1.2 phil-wifi-20200406:1.2 pgoyette-compat-merge-20190127:1.2 pgoyette-compat-20190127:1.2 pgoyette-compat-20190118:1.2 pgoyette-compat-1226:1.2 pgoyette-compat-1126:1.2 pgoyette-compat-1020:1.2 pgoyette-compat-0930:1.2 pgoyette-compat-0906:1.2 pgoyette-compat-0728:1.2 pgoyette-compat-0625:1.2 pgoyette-compat-0521:1.2 pgoyette-compat-0502:1.2 pgoyette-compat-0422:1.2 pgoyette-compat-0415:1.2 pgoyette-compat-0407:1.2 pgoyette-compat-0330:1.2 pgoyette-compat-0322:1.2 pgoyette-compat-0315:1.2 pgoyette-compat:1.2.0.40 pgoyette-compat-base:1.2 perseant-stdc-iso10646:1.2.0.38 perseant-stdc-iso10646-base:1.2 prg-localcount2-base3:1.2 prg-localcount2-base2:1.2 prg-localcount2-base1:1.2 prg-localcount2:1.2.0.36 prg-localcount2-base:1.2 pgoyette-localcount-20170426:1.2 bouyer-socketcan-base1:1.2 pgoyette-localcount-20170320:1.2 bouyer-socketcan:1.2.0.34 bouyer-socketcan-base:1.2 pgoyette-localcount-20170107:1.2 pgoyette-localcount-20161104:1.2 localcount-20160914:1.2 pgoyette-localcount-20160806:1.2 pgoyette-localcount-20160726:1.2 pgoyette-localcount:1.2.0.32 pgoyette-localcount-base:1.2 netbsd-5-2-3-RELEASE:1.2 netbsd-5-1-5-RELEASE:1.2 yamt-pagecache-base9:1.2 yamt-pagecache-tag8:1.2 tls-earlyentropy:1.2.0.28 tls-earlyentropy-base:1.2 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.2 riastradh-drm2-base3:1.2 netbsd-5-2-2-RELEASE:1.2 netbsd-5-1-4-RELEASE:1.2 netbsd-5-2-1-RELEASE:1.2 netbsd-5-1-3-RELEASE:1.2 agc-symver:1.2.0.30 agc-symver-base:1.2 tls-maxphys-base:1.2 yamt-pagecache-base8:1.2 netbsd-5-2:1.2.0.26 yamt-pagecache-base7:1.2 netbsd-5-2-RELEASE:1.2 netbsd-5-2-RC1:1.2 yamt-pagecache-base6:1.2 yamt-pagecache-base5:1.2 yamt-pagecache-base4:1.2 netbsd-5-1-2-RELEASE:1.2 netbsd-5-1-1-RELEASE:1.2 yamt-pagecache-base3:1.2 yamt-pagecache-base2:1.2 yamt-pagecache:1.2.0.24 yamt-pagecache-base:1.2 bouyer-quota2-nbase:1.2 bouyer-quota2:1.2.0.22 bouyer-quota2-base:1.2 matt-nb5-pq3:1.2.0.20 matt-nb5-pq3-base:1.2 netbsd-5-1:1.2.0.18 netbsd-5-1-RELEASE:1.2 netbsd-5-1-RC4:1.2 netbsd-5-1-RC3:1.2 netbsd-5-1-RC2:1.2 netbsd-5-1-RC1:1.2 netbsd-5-0-2-RELEASE:1.2 netbsd-5-0-1-RELEASE:1.2 jym-xensuspend-nbase:1.2 netbsd-5-0:1.2.0.16 netbsd-5-0-RELEASE:1.2 netbsd-5-0-RC4:1.2 netbsd-5-0-RC3:1.2 netbsd-5-0-RC2:1.2 jym-xensuspend:1.2.0.14 jym-xensuspend-base:1.2 netbsd-5-0-RC1:1.2 netbsd-5:1.2.0.12 netbsd-5-base:1.2 mjf-devfs2:1.2.0.10 mjf-devfs2-base:1.2 yamt-pf42-base4:1.2 yamt-pf42-base3:1.2 hpcarm-cleanup-nbase:1.2 yamt-pf42-base2:1.2 yamt-pf42:1.2.0.8 yamt-pf42-base:1.2 keiichi-mipv6:1.2.0.6 keiichi-mipv6-base:1.2 cube-autoconf:1.2.0.4 cube-autoconf-base:1.2 hpcarm-cleanup:1.2.0.2 hpcarm-cleanup-base:1.2; locks; strict; comment @.\" @; 1.2 date 2006.07.26.11.11.04; author tron; state dead; branches; next 1.1; 1.1 date 2006.06.19.15.44.36; author gdamore; state Exp; branches; next ; desc @@ 1.2 log @Bluetooth fixes by Iain Hibbert: Remove bluetooth.conf(5) and config parsing from libbluetooth(3) as this is no longer required. @ text @.\" $NetBSD: bluetooth.conf.5,v 1.1 2006/06/19 15:44:36 gdamore Exp $ .\" .\" Copyright (c) 2006 Itronix Inc. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of Itronix Inc. may not be used to endorse .\" or promote products derived from this software without specific .\" prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY ITRONIX INC. ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ITRONIX INC. BE LIABLE FOR ANY .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND .\" ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" .\" .\" Copyright (c) 2001-2002 Maksim Yevmenkin .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd March 30, 2006 .Dt BLUETOOTH.CONF 5 .Os .Sh NAME .Nm bluetooth.conf .Nd Bluetooth remote devices configuration file. .Sh DESCRIPTION The .Nm file is the default configuration file used by the .Xr bthcid 8 , and .Xr btcontrol 8 programs. .Pp The .Nm file is a free-form .Tn ASCII text file. It is parsed by the recursive-descent parser built into the .Xr bluetooth 3 library. The file may contain extra tabs and newlines for formatting purposes. Keywords in the file are case-sensitive. Comments may be placed anywhere within the file (except within quotes). Comments begin with the .Ql # character and end at the end of the line. .Sh FILE FORMAT The .Nm file consists of a list of .Cm device entries. Each remote Bluetooth device is identified by its unique BD_ADDR. Each .Cm device entry defines options and information for a remote Bluetooth device. .Pp The .Cm device entry .Pp .Cm device { .Cm option Ar argument ; .Oo .Cm option Ar argument ; .Oc } .Pp The supported options and arguments are as follows: .Bl -tag -width indent .It Cm bdaddr Ar BD_ADDR This required value is the Bluetooth Device Address of the remote device and can be obtained by placing the device into Discoverable mode and using the .Xr btconfig 8 program .Pa Inquiry command. .It Cm type Ar type This optional entry will indicate to the .Xr btcontrol 8 program how to attach this device to the system. .Ar type can be one of: .Pp .Bl -tag -compact .It hid Human Interface Device .It hset Audio Headset .El .It Cm name Ar device_name Specify user friendly name for the entry. Name is a string in straight double quotes. .It Cm key Ar link_key Specify a link key for the entry. Link key is hexadecimal string up to 32 characters in length starting with .Ql 0x . .Pp It is not generally necessary to store link keys in the .Pa /etc/bluetooth/bluetooth.conf file as the .Xr bthcid 8 daemon will keep them elsewhere. .It Cm pin Ar PIN_code Specify PIN code for the entry. PIN code is a string up to 16 characters in length in straight double quotes. If no PIN is given, and the baseband connection requires authentication, the .Xr bthcid 8 daemon will attempt to contact clients for a PIN before sending a negative response. .Pp It is not generally necessary to store PINs in the .Pa /etc/bluetooth/bluetooth.conf file as the .Xr btpin 1 utility can be used to register PINs with the .Xr bthcid 8 daemon prior to pairing a device. .It Cm control_channel Ar channel This RFCOMM channel number used to contact the HSET device. .It Cm control_psm Ar psm The PSM value that an HID device uses for control messages. .It Cm interrupt_psm Ar psm The PSM value that an HID device uses for interrupt messages. .It Cm reconnect_initiate Ar bool This should be 'true' if the HID device normally initiates reconnection after link loss, and if not set (or set to 'false') will cause the .Xr bthidev 4 driver to initiate connections. .It Cm battery_power Ar bool This should be 'true' if the HID device runs from battery power. .It Cm normally_connectable Ar bool This should be 'true' if the HID device is normally available for incoming connections. .It Cm hid_descriptor This block of hexadecimal bytes is a description of HID device capabilities as according to the USB HID specifications, and can be displayed in human readable form using the .Xr btcontrol 8 program .Pa Parse command. .El .Sh EXAMPLES A sample .Nm file: .Bd -literal # Ericsson T68 phone device { bdaddr 00:80:37:5e:4d:d4; name "Ericsson T68 phone"; pin "0000"; # PIN code } # example HID device { bdaddr 00:50:f2:e5:68:84; attach hid; name "Example HID"; key 0x00112233445566778899aabbccddeeff; control_psm 0x0011; interrupt_psm 0x0013; reconnect_initiate false; normally_connectable false; hid_descriptor { 0x05 0x01 0x09 0x02 0xa1 0x01 0x85 0x02 0x09 0x01 0xa1 0x00 0x05 0x09 0x19 0x01 0x29 0x05 0x15 0x00 0x25 0x01 0x75 0x01 0x95 0x05 0x81 0x02 0x75 0x03 0x95 0x01 0x81 0x01 0x05 0x01 0x09 0x30 0x09 0x31 0x09 0x38 0x15 0x81 0x25 0x7f 0x75 0x08 0x95 0x03 0x81 0x06 0xc0 0xc0 0x05 0x0c 0x09 0x01 0xa1 0x01 0x85 0x03 0x05 0x01 0x09 0x02 0xa1 0x02 0x06 0x00 0xff 0x15 0x00 0x25 0x03 0x95 0x01 0x75 0x02 0x0a 0x01 0xfe 0x81 0x02 0x75 0x06 0x81 0x01 0xc0 0xc0 }; } .Ed .Sh FILES .Bl -tag -compact .It Pa /etc/bluetooth/bluetooth.conf .El .Sh SEE ALSO .Xr btpin 1 , .Xr bluetooth 3 , .Xr bthcid 8 , .Xr btcontrol 8 .Sh AUTHORS .An Maksim Yevmenkin Aq m_evmenkin@@yahoo.com .An Iain Hibbert for Itronix, Inc. @ 1.1 log @Initial import of bluetooth stack on behalf of Iain Hibbert. (plunky@@, NetBSD Foundation Membership still pending.) This stack was written by Iain under sponsorship from Itronix Inc. The stack includes support for rfcomm networking (networking via your bluetooth enabled cell phone), hid devices (keyboards/mice), and headsets. Drivers for both PCMCIA and USB bluetooth controllers are included. @ text @d1 1 a1 1 .\" $NetBSD: bluetooth.conf.5$ @