samples: bluetooth: HID SCI support in HID samples

This commit adds usage of the HID SCI feature in the
central_hids sample as well as support for the HID
SCI characteristics in the peripheral_hids_mouse
and peripheral_hids_keyboard samples.

Signed-off-by: Artur Hadasz <artur.hadasz@nordicsemi.no>

Author: ahasztag

samples/bluetooth/central_hids/README.rst

@@ -69,6 +69,12 @@ User interface
          This function is available only if the connected HID has boot keyboard reports.
          It always writes CAPSLOCK information to the boot report, even if Report Protocol Mode is selected.
 
+      Button 4:
+         Switch to the "Additional button functions" mode.
+         In this mode the buttons have different functionalities:
+         - Button 2 (HID SCI configuration only): Switch to the next SCI mode (Currently only supported in HID SCI configuration).
+         - Button 4: Exit the "Additional button functions" mode.
+
    .. group-tab:: nRF54 DKs
 
       Button 0:
@@ -88,12 +94,20 @@ User interface
          This function is available only if the connected HID has boot keyboard reports.
          It always writes CAPSLOCK information to the boot report, even if Report Protocol Mode is selected.
 
+      Button 3:
+        Switch to the "Additional button functions" mode.
+        In this mode the buttons have different functionalities:
+        - Button 1 (HID SCI configuration only): Switch to the next SCI mode (Currently only supported in HID SCI configuration).
+        - Button 3: Exit the "Additional button functions" mode.
+
 Building and Running
 ********************
 .. |sample path| replace:: :file:`samples/bluetooth/central_hids`
 
 .. include:: /includes/build_and_run_ns.txt
 
+To build the sample with HID SCI support, build with ``-DEXTRA_CONF_FILE=hid_sci.conf``
+
 Testing
 =======
 
@@ -110,6 +124,7 @@ Testing with another development kit
       1. |connect_terminal_specific|
       #. Reset the kit.
       #. Program the other kit with the :ref:`peripheral_hids_keyboard` sample and reset it.
+      #. If you see "NFC configuration done" on the peripheral kit, press **Button 4** on the peripheral kit in order for it to start advertising.
       #. When connected, press **Button 1** on both devices to confirm the passkey value used for bonding, or press **Button 2** to reject it.
       #. Wait until the HIDS keyboard is detected by the central.
          All detected descriptors are listed.
@@ -153,6 +168,7 @@ Testing with another development kit
       1. |connect_terminal_specific|
       #. Reset the kit.
       #. Program the other kit with the :ref:`peripheral_hids_keyboard` sample and reset it.
+      #. If you see "NFC configuration done" on the peripheral kit, press **Button 3** on the peripheral kit in order for it to start advertising.
       #. When connected, press **Button 0** on both devices to confirm the passkey value used for bonding, or press **Button 1** to reject it.
       #. Wait until the HIDS keyboard is detected by the central.
          All detected descriptors are listed.
@@ -291,6 +307,32 @@ Testing with Bluetooth Low Energy app
       #. Press **Button 1** on the kit and observe that the **Protocol Mode** value changes from ``01`` to ``00``.
       #. Press **Button 0** and **Button 2** one after another and observe that the **Boot Keyboard Output Report** value toggles between ``00`` and ``02``.
 
+Testing with HID SCI support
+----------------------------
+
+To test the sample with HID SCI support, both the central and the peripheral must be built with ``-DEXTRA_CONF_FILE=hid_sci.conf``
+
+   .. group-tab:: nRF54 DKs
+
+      1. |connect_terminal_specific|
+      #. Reset the kit.
+      #. Program the other kit with the :ref:`peripheral_hids_keyboard` sample and reset it.
+      #. If you see "NFC configuration done" on the peripheral kit, press **Button 3** on the peripheral kit in order for it to start advertising.
+      #. When connected, press **Button 0** on both devices to confirm the passkey value used for bonding, or press **Button 1** to reject it.
+      #. Wait until the HIDS keyboard is detected by the central.
+         Check for information similar to the following::
+
+            HIDS is ready to work
+            Subscribe in report id: 1
+            Subscribe in boot keyboard report
+      #. Press **Button 4** on the central kit and wait for the SCI mode to change to DEFAULT.
+      #. Cycle through the HID SCI modes by pressing **Button 4** on the central kit.
+         The HID SCI mode will change to FAST, LOW POWER, FULL RANGE, and DEFAULT again.
+         Every time you might need to wait a few seconds for the mode to change.
+         You will see a message similar to the following::
+
+            SCI mode changed notification received, new mode: <mode_name>
+
 Dependencies
 *************
 

samples/bluetooth/central_hids/hid_sci.conf

@@ -0,0 +1,7 @@
+CONFIG_BT_GAP_PERIPHERAL_PREF_PARAMS=n
+
+CONFIG_BT_SUBRATING=y
+CONFIG_BT_LE_EXTENDED_FEAT_SET=y
+CONFIG_BT_SHORTER_CONNECTION_INTERVALS=y
+
+CONFIG_BT_HOGP_SCI=y

samples/bluetooth/central_hids/sample.yaml

@@ -1,6 +1,22 @@
 sample:
   description: Bluetooth Low Energy central Human Interface Device sample
   name: Bluetooth LE Central HIDS
+common:
+  sysbuild: true
+  harness: console
+  harness_config:
+    type: multi_line
+    ordered: true
+    regex:
+      - "Starting Bluetooth Central HIDS sample"
+      - "Bluetooth initialized"
+      - "Scanning successfully started"
+  timeout: 15
+  tags:
+    - bluetooth
+    - ci_build
+    - sysbuild
+    - ci_samples_bluetooth
 tests:
   sample.bluetooth.central_hids:
     sysbuild: true
@@ -25,17 +41,16 @@ tests:
       - nrf54lv10dk/nrf54lv10a/cpuapp
       - nrf54lv10dk/nrf54lv10a/cpuapp/ns
       - nrf54h20dk/nrf54h20/cpuapp
-    tags:
-      - bluetooth
-      - ci_build
-      - sysbuild
-      - ci_samples_bluetooth
-    harness: console
-    harness_config:
-      type: multi_line
-      ordered: true
-      regex:
-        - "Starting Bluetooth Central HIDS sample"
-        - "Bluetooth initialized"
-        - "Scanning successfully started"
-    timeout: 15
+  sample.bluetooth.central_hids.hid_sci:
+    sysbuild: true
+    integration_platforms:
+      - nrf54l15dk/nrf54l05/cpuapp
+      - nrf54lm20dk/nrf54lm20a/cpuapp
+      - nrf54lm20dk/nrf54lm20b/cpuapp
+      - nrf54lv10dk/nrf54lv10a/cpuapp
+    platform_allow:
+      - nrf54l15dk/nrf54l05/cpuapp
+      - nrf54lm20dk/nrf54lm20a/cpuapp
+      - nrf54lm20dk/nrf54lm20b/cpuapp
+      - nrf54lv10dk/nrf54lv10a/cpuapp
+    extra_args: EXTRA_CONF_FILE=hid_sci.conf