bluetooth: service: HID service

* Add Bluetooth HID service.
* Add HID keyboard sample.
* Add HID mouse sample.

Co-authored-by: Eivind Jølsgard <[email protected]>
Signed-off-by: Emanuele Di Santo <[email protected]>

Author: lemrey

include/bluetooth/services/ble_hids.h

@@ -1,4 +1,4 @@
-
+#include "ble_gap.h"
 #include <ble.h>
 #include <zephyr/sys/byteorder.h>
 
@@ -13,3 +13,72 @@ static inline uint16_t is_notification_enabled(const uint8_t *gatts_write_data)
 	{                                                                                          \
 		.sm = ((x) >> 4) & 0xf, .lv = (x) & 0xf,                                           \
 	}
+
+static inline bool ble_gap_conn_sec_mode_equal(const ble_gap_conn_sec_mode_t *a,
+					       const ble_gap_conn_sec_mode_t *b)
+{
+	return (a->sm == b->sm) && (a->lv == b->lv);
+}
+
+/**
+ * @brief Set sec_mode to have no access rights.
+ */
+#define BLE_GAP_CONN_SEC_MODE_NO_ACCESS                                                            \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 0, .lv = 0                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require no protection, open link.
+ */
+#define BLE_GAP_CONN_SEC_MODE_OPEN                                                                 \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 1, .lv = 1                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require encryption, but no MITM protection.
+ */
+#define BLE_GAP_CONN_SEC_MODE_ENC_NO_MITM                                                          \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 1, .lv = 2                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require encryption and MITM protection.
+ */
+#define BLE_GAP_CONN_SEC_MODE_ENC_WITH_MITM                                                        \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 1, .lv = 3                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require LESC encryption and MITM protection.
+ */
+#define BLE_GAP_CONN_SEC_MODE_LESC_ENC_WITH_MITM                                                   \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 1, .lv = 4                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require signing or encryption, no MITM protection needed.
+ */
+#define BLE_GAP_CONN_SEC_MODE_SIGNED_NO_MITM                                                       \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 2, .lv = 1                                                                   \
+	}
+
+/**
+ * @brief Set sec_mode to require signing or encryption with MITM protection.
+ */
+#define BLE_GAP_CONN_SEC_MODE_SIGNED_WITH_MITM                                                     \
+	(ble_gap_conn_sec_mode_t)                                                                  \
+	{                                                                                          \
+		.sm = 2, .lv = 2                                                                   \
+	}

include/bluetooth/services/common.h

@@ -0,0 +1,12 @@
+#
+# Copyright (c) 2025 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(ble_hid_keyboard)
+
+target_sources(app PRIVATE src/main.c)

samples/bluetooth/ble_hid_keyboard/CMakeLists.txt

@@ -0,0 +1,33 @@
+CONFIG_LOG=y
+CONFIG_LOG_MODE_MINIMAL=y
+CONFIG_CONSOLE=y
+CONFIG_LITE_UARTE_CONSOLE=y
+
+CONFIG_SOFTDEVICE=y
+
+CONFIG_BLE_ADV=y
+CONFIG_BLE_ADV_NAME="NCS-Lite HID Keyboard"
+CONFIG_BLE_ADV_EXTENDED_ADVERTISING=n
+CONFIG_BLE_ADV_DIRECTED_ADVERTISING=n
+
+# BLE connection parameter
+CONFIG_BLE_CONN_PARAMS=y
+
+# Device information service
+CONFIG_BLE_DIS=y
+CONFIG_BLE_DIS_SERIAL_NUMBER="ABCD"
+CONFIG_BLE_DIS_HW_REVISION="hw 54.15.0"
+CONFIG_BLE_DIS_FW_REVISION="fw 17.2.0"
+CONFIG_BLE_DIS_SW_REVISION="sw 1.0.0"
+
+# Battery service
+CONFIG_BLE_BAS=y
+
+# Buttons and timer
+CONFIG_LITE_TIMER=y
+CONFIG_LITE_BUTTONS=y
+
+# HIDS service
+CONFIG_BLE_HIDS=y
+CONFIG_BLE_HIDS_BOOT_KEYBOARD=y
+CONFIG_BLE_HIDS_LOG_LEVEL_DBG=y

samples/bluetooth/ble_hid_keyboard/prj.conf

@@ -0,0 +1,11 @@
+sample:
+  name: BLE HID Keyboard
+tests:
+  sample.ble_hid_keyboard:
+    sysbuild: true
+    build_only: true
+    integration_platforms:
+      - lite_nrf54l15/nrf54l15/cpuapp
+    platform_allow:
+      - lite_nrf54l15/nrf54l15/cpuapp
+    tags: ci_build