zephyr/samples/bluetooth
Luiz Augusto von Dentz 4aae7ec31f Bluetooth: Fix header documentation of GATT service samples
Change-Id: I8dc2643aa755811549cc54fef0be0ec589e2dab9
Signed-off-by: Luiz Augusto von Dentz <luiz.von.dentz@intel.com>
2016-03-14 11:04:22 +02:00
..
beacon Bluetooth: samples/beacon: Advertize http://www.zephyrproject.org 2016-02-15 16:35:02 +00:00
central tests: Fix Bluetooth tests and samples platform blacklisting 2016-02-15 15:06:53 +00:00
central_hr Bluetooth: Remove CONFIG_TEST_RANDOM_GENERATOR from sample apps 2016-02-10 19:13:01 -05:00
gatt Bluetooth: Fix header documentation of GATT service samples 2016-03-14 11:04:22 +02:00
ipsp Bluetooth: IPSS: Move sample service to gatt 2016-03-11 11:29:13 +02:00
peripheral Bluetooth/sample: Fix exit after first indication sent 2016-03-10 15:41:00 +00:00
peripheral_csc Bluetooth: Change GATT callback return values to ssize_t 2016-02-20 15:39:33 +00:00
peripheral_dis Bluetooth: Change GATT callback return values to ssize_t 2016-02-20 15:39:33 +00:00
peripheral_esp Bluetooth: Change GATT callback return values to ssize_t 2016-02-20 15:39:33 +00:00
peripheral_hr Bluetooth: Change GATT callback return values to ssize_t 2016-02-20 15:39:33 +00:00
peripheral_sc_only Bluetooth: Change GATT callback return values to ssize_t 2016-02-20 15:39:33 +00:00
README Bluetooth: Fix HCI driver Kconfig references in samples 2016-02-05 20:25:03 -05:00

README

Bluetooth subsystem

= Building =

Build samples

$ make -C samples/bluetooth/<app>

= Bluetooth Sample application =

Host Bluetooth controller is connected to the second qemu serial line
through a UNIX socket (qemu option -serial unix:/tmp/bt-server-bredr).
This option is already added to qemu through QEMU_EXTRA_FLAGS in Makefile.

On the host side BlueZ allows to "connect" Bluetooth controller through
a so-called user channel. Use the btproxy tool for that:

$ sudo tools/btproxy -u
Listening on /tmp/bt-server-bredr

Note that before calling btproxy make sure that Bluetooth controller is down.

Now running qemu result connecting second serial line to 'bt-server-bredr'
UNIX socket. When Bluetooth (CONFIG_BLUETOOTH) and Bluetooth HCI UART driver
(CONFIG_BLUETOOTH_H4) are enabled, Bluetooth driver registers to the system.
From now on Bluetooth might be used by the application. To run application in
the qemu run:

$ make qemu

== Bluetooth IPSP application ==

To test IPSP please take a look at samples/net/README, in addition to running
echo-client it is necessary to enable 6LowPAN module in Linux with the
following commands:

$ modprobe bluetooth_6lowpan
$ echo 1 > /sys/kernel/debug/bluetooth/6lowpan_enable

Then to connect:

echo "connect <bdaddr> <type>" > /sys/kernel/debug/bluetooth/6lowpan_control

Once connected a dedicated interface will be created, usually bt0, which can
then be used as following:

$ echo-client -i bt0 <ip>

= Bluetooth sanity check =

There is smoke test application in nanokernel and microkernel test
directories which gets run in sanity check script:

$ scripts/sanity_chk/sanity_chk [-P <platform>]

For quick regression test use bt_regression, it only check Bluetooth test

$ samples/bluetooth/bt_regression.sh