zephyr/samples/bluetooth/ipsp
David B. Kinder 2bfff175ab doc: add labels to bluetooth sample docs
Docs need a label at the top so we can use :ref:`labelname`
to create a link to that doc from other docs.

Change-Id: Ide66f75ca8fac0d5f65fbfc50dc9d130cf45b392
Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2017-04-04 19:51:27 +00:00
..
src net: Rename Kconfig.samples and its main option for future changes 2017-03-31 11:24:26 +02:00
Makefile
prj.conf net: Rename Kconfig.samples and its main option for future changes 2017-03-31 11:24:26 +02:00
README.rst doc: add labels to bluetooth sample docs 2017-04-04 19:51:27 +00:00
testcase.ini

.. _bluetooth-ipsp-sample:

Bluetooth: IPSP Sample
######################

Overview
********
Application demonstrating the IPSP (Internet Protocol Support Profile) Node
role. IPSP is the Bluetooth profile that underneath utilizes 6LoWPAN, i.e. gives
you IPv6 connectivity over BLE.

Requirements
************

This application currently only works with HCI based firmware since it
requires L2CAP channels support.

Building and Running
********************

This sample can be found under :file:`samples/bluetooth/ipsp` in the
Zephyr tree.

Testing with a Linux host
=========================

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

.. code-block:: console

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

Then to connect:

.. code-block:: console

   $ 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:

.. code-block:: console

   $ echo-client -i bt0 <ip>