zephyr/samples/bluetooth/peripheral_hids
Luiz Augusto von Dentz 03b9ce487c Bluetooth: GATT: Add support to setting permission on CCCD
This adds support to set different permissions to CCCD so security can
be checked when enabling notification which conforms to:

BLUETOOTH CORE SPECIFICATION Version 5.1 | Vol 3, Part G page 2360:

  '3.3.3.3 Client Characteristic Configuration

   Authentication and authorization may be required by the server to
   write the configuration descriptor.'

In addition to that also ensure that notification are not re-enabled
until the proper security level is reached to conform to the following
statement:

  '10.3.1.1 Handling of GATT indications and notifications

   A client “requests” a server to send indications and notifications
   by appropriately configuring the server via a Client Characteristic
   Configuration Descriptor. Since the configuration is persistent
   across a disconnection and reconnection, security requirements must
   be checked against the configuration upon a reconnection before
   sending indications or notifications. When a server reconnects to a
   client to send an indication or notification for which security is
   required, the server shall initiate or request encryption with the
   client prior to sending an indication or notification. If the client
   does not have an LTK indicating that the client has lost the bond,
   enabling encryption will fail.'

Fixes #17983

Signed-off-by: Luiz Augusto von Dentz <luiz.von.dentz@intel.com>
2019-09-19 21:12:39 +03:00
..
src Bluetooth: GATT: Add support to setting permission on CCCD 2019-09-19 21:12:39 +03:00
CMakeLists.txt Bluetooth: services: Move HID over GATT service 2019-07-11 13:21:14 +03:00
README.rst doc: Bluetooth: Documentation overhaul 2019-03-13 10:40:05 +01:00
prj.conf Bluetooth: services: battery service enhancements 2019-07-11 13:21:14 +03:00
sample.yaml samples: add test identifier 2019-03-29 17:44:11 -04:00

README.rst

.. _peripheral_hids:

Bluetooth: Peripheral HIDs
##########################

Overview
********

Similar to the :ref:`Peripheral <ble_peripheral>` sample, except that this
application specifically exposes the HID GATT Service. The report map used is
for a generic mouse.


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

* BlueZ running on the host, or
* A board with BLE support

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

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

See :ref:`bluetooth samples section <bluetooth-samples>` for details.