zephyr/samples/bluetooth/hci_spi/README.rst
Martí Bolívar 6e57b42758 doc: dts: revisit documentation
This is joint work with Kumar Gala (see signed-off-by).

Document the changes to the generated node macros in macros.bnf,
moving the old file to legacy-macros.bnf and putting it in its own
section.

The actual generated macros are now a low-level detail, so rewrite the
foregoing sections as examples in terms of the new <devicetree.h> APIs.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-03-24 10:11:20 -05:00

43 lines
1.3 KiB
ReStructuredText

.. _bluetooth-hci-spi-sample:
Bluetooth: HCI SPI
##################
Overview
********
Expose Zephyr Bluetooth Controller support over SPI to another device/CPU using
the Zephyr SPI HCI transport protocol (similar to BlueNRG).
Requirements
************
* A board with SPI slave, GPIO and BLE support.
Building and Running
********************
In order to use this application, you need a board with a Bluetooth
controller and SPI slave drivers, and a spare GPIO to use as an
interrupt line to the SPI master.
You then need to ensure that your :ref:`devicetree <dt-guide>`
settings provide a definition for the slave HCI SPI device::
bt-hci@0 {
compatible = "zephyr,bt-hci-spi-slave";
...
};
You can then build this application and flash it onto your board in
the usual way; see :ref:`boards` for board-specific building and
flashing information.
You will also need a separate chip acting as BT HCI SPI master. This
application is compatible with the HCI SPI master driver provided by
Zephyr's Bluetooth HCI driver core; see the help associated with the
BT_SPI configuration option for more information.
Refer to :ref:`bluetooth-samples` for general Bluetooth information, and
to :ref:`96b_carbon_nrf51_bluetooth` for instructions specific to the
96Boards Carbon board.