applications: nrf_desktop: Add HID system ctrl report provider

Introduce HID report provider for generating standard system control
reports.

Jira: NCSDK-31548

Signed-off-by: Marek Pieta <[email protected]>

Author: MarekPieta

applications/nrf_desktop/src/modules/CMakeLists.txt

@@ -52,6 +52,9 @@ target_sources_ifdef(CONFIG_DESKTOP_HID_REPORT_PROVIDER_MOUSE
 target_sources_ifdef(CONFIG_DESKTOP_HID_REPORT_PROVIDER_KEYBOARD
 		     app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/hid_provider_keyboard.c)
 
+target_sources_ifdef(CONFIG_DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL
+		     app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/hid_provider_system_ctrl.c)
+
 target_sources_ifdef(CONFIG_DESKTOP_HID_STATE_PM_ENABLE
 		     app PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/hid_state_pm.c)
 

applications/nrf_desktop/src/modules/Kconfig

@@ -17,6 +17,7 @@ menu "HID report providers"
 rsource "Kconfig.hid_provider_consumer_ctrl"
 rsource "Kconfig.hid_provider_mouse"
 rsource "Kconfig.hid_provider_keyboard"
+rsource "Kconfig.hid_provider_system_ctrl"
 
 endmenu
 

applications/nrf_desktop/src/modules/Kconfig.hid_provider_system_ctrl

@@ -0,0 +1,62 @@
+#
+# Copyright (c) 2025 Nordic Semiconductor ASA
+#
+# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
+#
+
+config DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL
+	bool
+	default y if !DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL_ALT
+	depends on DESKTOP_HID_REPORT_SYSTEM_CTRL_SUPPORT
+	select DESKTOP_HID_KEYMAP
+	select DESKTOP_HID_EVENTQ
+	select DESKTOP_KEYS_STATE
+	help
+	  This option automatically enables the default HID system control
+	  report provider for HID peripheral that supports HID system control
+	  report.
+
+config DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL_ALT
+	bool "Use custom HID system control report provider"
+	depends on DESKTOP_HID_REPORT_SYSTEM_CTRL_SUPPORT
+	help
+	  Enable this option if you want to support HID system control report
+	  and use a custom HID system control report provider. Make sure to
+	  introduce the custom HID system control report provider if you
+	  enable this option.
+
+if DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL
+
+config DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL_KEYPRESS_EXPIRATION
+	int "HID keypress expiration [ms]"
+	default DESKTOP_HID_REPORT_EXPIRATION
+	default 500
+	help
+	  If a keypress is recorded before HID subscriber connects, it is stored
+	  in HID event queue and processed after the subscriber connects. This
+	  Kconfig option specifies time after which a queued keypress will be
+	  considered expired. The higher the value, the longer the period from
+	  which the module will recall pressed keys when the connection with HID
+	  host is established.
+
+	  The first default is deprecated and used for backwards compatibility.
+
+config DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL_EVENT_QUEUE_SIZE
+	int "HID keypress queue size"
+	default DESKTOP_HID_EVENT_QUEUE_SIZE
+	default 12
+	range 2 255
+	help
+	  The option limits the number of keypresses (button press or release)
+	  on the HID event queue where the keypresses are stored before the
+	  connection with HID host is established. If there is no space in the
+	  queue to enqueue a new key state change, the oldest element is
+	  released.
+
+	  The first default is deprecated and used for backwards compatibility.
+
+module = DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL
+module-str = HID provider system control
+source "subsys/logging/Kconfig.template.log_config"
+
+endif # DESKTOP_HID_REPORT_PROVIDER_SYSTEM_CTRL