README - bluez-imx - Git at Google

 BlueZ - Bluetooth protocol stack for Linux
 ******************************************

 Copyright (C) 2000-2001  Qualcomm Incorporated
 Copyright (C) 2002-2003  Maxim Krasnyansky <maxk@qualcomm.com>
 Copyright (C) 2002-2010  Marcel Holtmann <marcel@holtmann.org>


 Compilation and installation
 ============================

 In order to compile Bluetooth utilities you need following software packages:
 	- GCC compiler
 	- GLib library
 	- D-Bus library
 	- udev library (optional)
 	- readline (command line clients)

 To configure run:
 	./configure --prefix=/usr --mandir=/usr/share/man \
 				--sysconfdir=/etc --localstatedir=/var

 Configure automatically searches for all required components and packages.

 To compile and install run:
 	make && make install


 Configuration and options
 =========================

 For a working system, certain configuration options need to be enabled:

 	--enable-library

 		Enable installation of Bluetooth library

 		By default the Bluetooth library is no longer installed.

 		The user interfaces or command line utilities do not
 		require an installed Bluetooth library anymore. This
 		option is provided for legacy third party applications
 		that still depend on the library.

 		When the library installation is enabled, it is a good
 		idea to use a separate bluez-library or libbluetooth
 		package for it.

 	--disable-tools

 		Disable support for Bluetooth utilities

 		By default the Bluetooth utilities are built and also
 		installed. For production systems the tools are not
 		needed and this option allows to disable them to save
 		build time and disk space.

 		When the tools are selected, it is a good idea to
 		use a separate bluez-tools package for them.

 	--disable-cups

 		Disable support for CUPS printer backend

 		By default the printer backend for CUPS is build and
 		also installed. For systems that do not require printing
 		over Bluetooth, this options allows to disable it.

 		When the CUPS backend is selected, it is a good idea to
 		use a separate bluez-cups package for it.

 	--disable-monitor

 		Disable support for the Bluetooth monitor utility

 		By default the monitor utility is enabled. It provides
 		support for HCI level tracing and debugging. For systems
 		that don't require any kind of tracing or debugging
 		capabilities, this options allows to disable it.

 		The monitor utility should be placed in the main package
 		along with the daemons. It is universally useful.

 	--disable-client

 		Disable support for the command line client

 		By default the command line client is enabled and uses the
 		readline library. For specific systems where BlueZ is
 		configured by other means, the command line client can be
 		disabled and the dependency on readline is removed.

 		The client should be placed in the main package along
 		with the daemons. It is universally useful.

 	--disable-systemd

 		Disable integration with systemd

 		By default the integration with systemd is enabled and
 		installed. This gives the best integration into all
 		distributions based on systemd.

 		This option is provided for distributions that do not
 		support systemd. In that case all integration with the
 		init system is up to the package.

 	--disable-a2dp

 		Disable A2DP profile

 		By default bluetoothd supports A2DP profile using a built-in
 		plugin, this option disables it.

 		This option is provided for distributions that do not have any
 		audio capabilities.

 	--disable-avrcp

 		Disable AVRCP profile

 		By default bluetoothd supports AVRCP profile using a built-in
 		plugin, this option disables it.

 		This option is provided for distributions that do not have any
 		audio capabilities.

 	--disable-network

 		Disable PANU, NAP, GN profiles

 		By default bluetoothd supports PANU, NAP and GN profile using a
 		built-in plugin, this option disables it.

 		This option is provided for distributions that do not have any
 		network capabilities.

 	--disable-hid

 		Disable HID profile

 		By default bluetoothd supports HID profile using a built-in
 		plugin, this option disables it.

 		This option is provided for distributions that do not have any
 		input capabilities.

 	--disable-hog

 		Disable HoG profile

 		By default bluetoothd supports HoG profile using a built-in
 		plugin, this option disables it.

 		This option is provided for distributions that do not have any
 		input capabilities.

 	--enable-testing

 		Enable testing tools

 		By default tools used only for testing emulation are disabled.
 		This option can be used to enable them.

 		It is not recommended to enable this option for production
 		systems. These tools may contain tests that depend on specific
 		environment or kernel features in development.

 	--enable-experimental

 		Enable experimental tools

 		By default all tools that are still in development
 		are disabled. This option can be used to enable them.

 		It is not recommended to enable this option for production
 		systems. The behavior of the experimental tools is unstable
 		and might still change.

 	--enable-deprecated

 		Enable deprecated tools

 		By defauld all tools that are no longer maintained are
 		disabled. This option can be used to enable them.

 		It is not recommended to enable this option for production
 		systems. The behavior of the deprecated tools may be unstable
 		or simply don't work anymore.

 	--enable-nfc

 		This option enable NFC pairing support.

 		By default the integration with neard is disabled, this gives
 		the option to enable it in system where neard is supported.

 		The plugin is built into bluetoothd therefore it does not need
 		to be package separately.

 	--enable-sap

 		This option enable SAP profile using sap plugin.

 		By default sap plugin is disabled since it requires tight
 		integration with systems and is very rarely required.

 		The plugin is built into bluetoothd therefore it does not need
 		to be package separately.

 	--enable-health

 		This option enable health profiles.

 		By default health plugin is disabled since its profiles are
 		target for the health industry.

 		The plugin is built into bluetoothd therefore it does not need
 		to be package separately.

 	--enable-midi

 		This option enable MIDI support via ALSA Sequencer.

 		By default midi plugin is disabled since it still considered
 		experimental. When bluetoothd will create a new ALSA Sequencer
 		client and port for each device connected that supports the
 		MIDI GATT primary service.

 		The plugin is built into bluetoothd therefore it does not need
 		to be package separately.

 Information
 ===========

 Mailing lists:
 	linux-bluetooth@vger.kernel.org

 For additional information about the project visit BlueZ web site:
 	http://www.bluez.org
	BlueZ - Bluetooth protocol stack for Linux
	******************************************

	Copyright (C) 2000-2001 Qualcomm Incorporated
	Copyright (C) 2002-2003 Maxim Krasnyansky <maxk@qualcomm.com>
	Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org>


	Compilation and installation
	============================

	In order to compile Bluetooth utilities you need following software packages:
	- GCC compiler
	- GLib library
	- D-Bus library
	- udev library (optional)
	- readline (command line clients)

	To configure run:
	./configure --prefix=/usr --mandir=/usr/share/man \
	--sysconfdir=/etc --localstatedir=/var

	Configure automatically searches for all required components and packages.

	To compile and install run:
	make && make install


	Configuration and options
	=========================

	For a working system, certain configuration options need to be enabled:

	--enable-library

	Enable installation of Bluetooth library

	By default the Bluetooth library is no longer installed.

	The user interfaces or command line utilities do not
	require an installed Bluetooth library anymore. This
	option is provided for legacy third party applications
	that still depend on the library.

	When the library installation is enabled, it is a good
	idea to use a separate bluez-library or libbluetooth
	package for it.

	--disable-tools

	Disable support for Bluetooth utilities

	By default the Bluetooth utilities are built and also
	installed. For production systems the tools are not
	needed and this option allows to disable them to save
	build time and disk space.

	When the tools are selected, it is a good idea to
	use a separate bluez-tools package for them.

	--disable-cups

	Disable support for CUPS printer backend

	By default the printer backend for CUPS is build and
	also installed. For systems that do not require printing
	over Bluetooth, this options allows to disable it.

	When the CUPS backend is selected, it is a good idea to
	use a separate bluez-cups package for it.

	--disable-monitor

	Disable support for the Bluetooth monitor utility

	By default the monitor utility is enabled. It provides
	support for HCI level tracing and debugging. For systems
	that don't require any kind of tracing or debugging
	capabilities, this options allows to disable it.

	The monitor utility should be placed in the main package
	along with the daemons. It is universally useful.

	--disable-client

	Disable support for the command line client

	By default the command line client is enabled and uses the
	readline library. For specific systems where BlueZ is
	configured by other means, the command line client can be
	disabled and the dependency on readline is removed.

	The client should be placed in the main package along
	with the daemons. It is universally useful.

	--disable-systemd

	Disable integration with systemd

	By default the integration with systemd is enabled and
	installed. This gives the best integration into all
	distributions based on systemd.

	This option is provided for distributions that do not
	support systemd. In that case all integration with the
	init system is up to the package.

	--disable-a2dp

	Disable A2DP profile

	By default bluetoothd supports A2DP profile using a built-in
	plugin, this option disables it.

	This option is provided for distributions that do not have any
	audio capabilities.

	--disable-avrcp

	Disable AVRCP profile

	By default bluetoothd supports AVRCP profile using a built-in
	plugin, this option disables it.

	This option is provided for distributions that do not have any
	audio capabilities.

	--disable-network

	Disable PANU, NAP, GN profiles

	By default bluetoothd supports PANU, NAP and GN profile using a
	built-in plugin, this option disables it.

	This option is provided for distributions that do not have any
	network capabilities.

	--disable-hid

	Disable HID profile

	By default bluetoothd supports HID profile using a built-in
	plugin, this option disables it.

	This option is provided for distributions that do not have any
	input capabilities.

	--disable-hog

	Disable HoG profile

	By default bluetoothd supports HoG profile using a built-in
	plugin, this option disables it.

	This option is provided for distributions that do not have any
	input capabilities.

	--enable-testing

	Enable testing tools

	By default tools used only for testing emulation are disabled.
	This option can be used to enable them.

	It is not recommended to enable this option for production
	systems. These tools may contain tests that depend on specific
	environment or kernel features in development.

	--enable-experimental

	Enable experimental tools

	By default all tools that are still in development
	are disabled. This option can be used to enable them.

	It is not recommended to enable this option for production
	systems. The behavior of the experimental tools is unstable
	and might still change.

	--enable-deprecated

	Enable deprecated tools

	By defauld all tools that are no longer maintained are
	disabled. This option can be used to enable them.

	It is not recommended to enable this option for production
	systems. The behavior of the deprecated tools may be unstable
	or simply don't work anymore.

	--enable-nfc

	This option enable NFC pairing support.

	By default the integration with neard is disabled, this gives
	the option to enable it in system where neard is supported.

	The plugin is built into bluetoothd therefore it does not need
	to be package separately.

	--enable-sap

	This option enable SAP profile using sap plugin.

	By default sap plugin is disabled since it requires tight
	integration with systems and is very rarely required.

	The plugin is built into bluetoothd therefore it does not need
	to be package separately.

	--enable-health

	This option enable health profiles.

	By default health plugin is disabled since its profiles are
	target for the health industry.

	The plugin is built into bluetoothd therefore it does not need
	to be package separately.

	--enable-midi

	This option enable MIDI support via ALSA Sequencer.

	By default midi plugin is disabled since it still considered
	experimental. When bluetoothd will create a new ALSA Sequencer
	client and port for each device connected that supports the
	MIDI GATT primary service.

	The plugin is built into bluetoothd therefore it does not need
	to be package separately.

	Information
	===========

	Mailing lists:
	linux-bluetooth@vger.kernel.org

	For additional information about the project visit BlueZ web site:
	http://www.bluez.org