zephyr/samples/bluetooth/peripheral_hids/README.rst
Benjamin Cabé 1db9b009a7 doc: samples: Adopt code-sample-category across tree
This commit uses the new .. zephyr:code-sample-category directive to
categorize code samples across the tree.
Updates existing legacy references to manually defined targets to now
use :zephyr:code-sample-category: role instead.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-09-23 12:00:00 +02:00

32 lines
1 KiB
ReStructuredText

.. zephyr:code-sample:: ble_peripheral_hids
:name: HID Peripheral
:relevant-api: bt_gatt bluetooth
Implement a Bluetooth HID peripheral (generic mouse)
Overview
********
Similar to the :zephyr:code-sample:`ble_peripheral` sample, except that this
application specifically exposes the HID GATT Service. The report map used is
for a generic mouse.
In the default configuration the sample uses passkey authentication (displays a
code on the peripheral and requires that to be entered on the host during
pairing) and requires an authenticated link to access the GATT characteristics.
To disable authentication and just use encrypted channels instead, build the
sample with ``CONFIG_SAMPLE_BT_USE_AUTHENTICATION=n``.
Requirements
************
* BlueZ running on the host, or
* A board with Bluetooth LE support
Building and Running
********************
This sample can be found under :zephyr_file:`samples/bluetooth/peripheral_hids` in the
Zephyr tree.
See :zephyr:code-sample-category:`bluetooth` samples for details.