[PATCH v2 3/4] dt-bindings: led: add virtual LED bindings

From: Jonathan Brophy

Date: Mon Oct 13 2025 - 08:10:37 EST


From: Jonathan Brophy <professor_jonny@xxxxxxxxxxx>

Add device tree bindings for virtual LED groups.

The use of the virtual status function identifier allows users to distinguish
virtual LEDs from real LEDs in sysfs.

If a virtual LED and a real LED are triggered at the same time, an undefined
state may occur. Therefore, it is assumed that hardware LEDs are blocked when
a LED is under the control of a virtual LED driver.

Having its own function definition helps reduce ambiguity and improves
clarity in LED behavior and trigger resolution.

Co-developed-by: Radoslav Tsvetkov <rtsvetkov@xxxxxxxxxxxx>
Signed-off-by: Radoslav Tsvetkov <rtsvetkov@xxxxxxxxxxxx>
Signed-off-by: Jonathan Brophy <professor_jonny@xxxxxxxxxxx>
---
include/dt-bindings/leds/common.h | 4 ++++
1 file changed, 4 insertions(+)

diff --git a/include/dt-bindings/leds/common.h b/include/dt-bindings/leds/common.h
index 4f017bea0123..39c34d585a47 100644
--- a/include/dt-bindings/leds/common.h
+++ b/include/dt-bindings/leds/common.h
@@ -63,6 +63,10 @@
"lp5523:{r,g,b}" (Nokia N900) */
#define LED_FUNCTION_STATUS "status"

+/* Virtual system LEDs Used for virtual LED groups, multifunction RGB
+ indicators or status LEDs that reflect complex system states */
+#define LED_FUNCTION_VIRTUAL_STATUS "virtual-status"
+
#define LED_FUNCTION_MICMUTE "micmute"
#define LED_FUNCTION_MUTE "mute"

--
2.43.0