zephyr

History

Keith Packard 0b90fd5adf samples, tests, boards: Switch main return type from void to int As both C and C++ standards require applications running under an OS to return 'int', adapt that for Zephyr to align with those standard. This also eliminates errors when building with clang when not using -ffreestanding, and reduces the need for compiler flags to silence warnings for both clang and gcc. Most of these changes were automated using coccinelle with the following script: @@ @@ - void + int main(...) { ... - return; + return 0; ... } Approximately 40 files had to be edited by hand as coccinelle was unable to fix them. Signed-off-by: Keith Packard <keithp@keithp.com>		2023-04-14 07:49:41 +09:00
..
boards	samples: bluetooth: peripheral_hids: Move dts overlays under boards	2020-04-01 10:44:31 -04:00
src	samples, tests, boards: Switch main return type from void to int	2023-04-14 07:49:41 +09:00
CMakeLists.txt	cmake: increase minimal required version to 3.20.0	2021-08-20 09:47:34 +02:00
Kconfig	samples: bt: hids: add a non authenticated mode to the sample	2023-01-24 19:33:03 +01:00
prj.conf	samples: bt: hids: implement a sample report	2022-09-15 16:27:35 +00:00
README.rst	samples: bt: hids: add a non authenticated mode to the sample	2023-01-24 19:33:03 +01:00
sample.yaml	samples/tests: bluetooth: Remove qemu_cortex_m3	2023-04-12 09:01:34 +02: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.

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 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.