1.. zephyr:code-sample:: ble_peripheral_hids
2   :name: HID Peripheral
3   :relevant-api: bt_gatt bluetooth
4
5   Implement a Bluetooth HID peripheral (generic mouse)
6
7Overview
8********
9
10Similar to the :zephyr:code-sample:`ble_peripheral` sample, except that this
11application specifically exposes the HID GATT Service. The report map used is
12for a generic mouse.
13
14In the default configuration the sample uses passkey authentication (displays a
15code on the peripheral and requires that to be entered on the host during
16pairing) and requires an authenticated link to access the GATT characteristics.
17To disable authentication and just use encrypted channels instead, build the
18sample with ``CONFIG_SAMPLE_BT_USE_AUTHENTICATION=n``.
19
20Requirements
21************
22
23* BlueZ running on the host, or
24* A board with Bluetooth LE support
25
26Building and Running
27********************
28
29This sample can be found under :zephyr_file:`samples/bluetooth/peripheral_hids` in the
30Zephyr tree.
31
32See :zephyr:code-sample-category:`bluetooth` samples for details.
33