Welcome to Firefly
切换语言
Firefly文档中心
最近更新: 2026-07-09 16:39:00

LED 使用

前言

Face-RK3399 开发板上有 2 个 LED 灯,如下表所示:

LEDGPIO ref.GPIO number
BLUEGPIO2_D391
YellowGPIO2_D290

可通过使用 LED 设备子系统或者直接操作 GPIO 控制该 LED。

以设备的方式控制 LED

标准的 Linux 专门为 LED 设备定义了 LED 子系统。 在 Face-RK3399 开发板中的两个 LED 均以设备的形式被定义。

用户可以通过 /sys/class/leds/ 目录控制这两个 LED。

开发板上的 LED 的默认状态为:

  • Blue: 系统上电时打开
  • Yellow:用户自定义

用户可以通过 echo 命令向其 brightness 属性输入命令控制每一个 LED:

root@rk3399_firefly_box:~ # echo 0 >/sys/class/leds/firefly:blue:power/brightness  //蓝灯灭
root@rk3399_firefly_box:~ # echo 1 >/sys/class/leds/firefly:blue:power/brightness  //蓝灯亮

使用 trigger 方式控制 LED

Trigger 包含多种方式可以控制 LED,这里就用两个例子来说明。

  • Simple trigger LED
  • Complex trigger LED

更详细的说明请参考 leds-class.txt

首先我们需要知道定义多少个 LED,同时对应的 LED 的属性是什么。

kernel/arch/arm64/boot/dts/rockchip/rk3399-firefly-port.dtsi 文件中定义 LED 节点,具体定义如下:

leds {
       compatible = "gpio-leds";
       power_led: power {
           label = "firefly:blue:power";
           linux,default-trigger = "ir-power-click";
           default-state = "on";
           gpios = <&gpio2 27 GPIO_ACTIVE_HIGH>;
           pinctrl-names = "default";
           pinctrl-0 = <&led_power>;
       };
       user_led: user {
           label = "firefly:yellow:user";
           linux,default-trigger = "ir-user-click";
           default-state = "off";
           gpios = <&gpio0 13 GPIO_ACTIVE_HIGH>;
           pinctrl-names = "default";
           pinctrl-0 = <&led_user>;
       };
   };

若客户购买的是Face-X1人脸识别一体机,则控制补光灯板上面三个控制灯对应如下:

/sys/class/leds/face:green:user/brightness //绿灯
/sys/class/leds/face:red:user/brightness //红灯
/sys/class/leds/face:white:user/brightness //白灯

在 kernel/arch/arm64/boot/dts/rockchip/rk3399-firefly-face.dtsi 文件中定义LED节点,具体定义如下:

face_leds {
    compatible = "gpio-leds";
        face_green_led: face_green {
            label = "face:green:user";
            linux,default-trigger = "ir-user-click";
            default-state = "off";
            gpios = <&gpio3 0 GPIO_ACTIVE_HIGH>;
            pinctrl-names = "default";
            pinctrl-0 = <&led_user>;
        };
        face_red_led: face_red {
            label = "face:red:user";
            linux,default-trigger = "ir-user-click";
            default-state = "off";
            gpios = <&gpio3 1 GPIO_ACTIVE_HIGH>;
            pinctrl-names = "default";
            pinctrl-0 = <&led_user>;
        };
        face_white_led: face_white {
            label = "face:white:user";
            linux,default-trigger = "ir-user-click";
            default-state = "on";
            gpios = <&gpio4 27 GPIO_ACTIVE_HIGH>;
            pinctrl-names = "default";
            pinctrl-0 = <&led_user>;
        };
};

若客户购买的是Face-X2人脸识别一体机,则控制补光灯板上面三个控制灯对应如下:

/sys/class/leds/face:green:user/brightness //绿灯
/sys/class/leds/face:red:user/brightness //红灯
/sys/pwm/face_white_led //白灯

其中白灯亮度是可调的

echo x > /sys/pwm/face_white_led

x范围0-8

注意:compatible 的值要跟 drivers/leds/leds-gpio.c 中的 .compatible 的值要保持一致。

Simple trigger LED

按名字来是看就是简单的触发方式控制 LED,如下就默认打开黄灯,Face-RK3399 开机后黄灯就亮。

(1)定义 LED 触发器在 kernel/drivers/leds/trigger/led-firefly-demo.c 文件中有如下添加:

DEFINE_LED_TRIGGER(ledtrig_default_control);

(2)注册该触发器

led_trigger_register_simple("ir-user-click", &ledtrig_default_control);

(3)控制 LED 的亮。

led_trigger_event(ledtrig_default_control, LED_FULL);     #yellow led on

(4)打开LED demo

led-firefly-demo 默认没有打开,如果需要的话可以使用以下补丁打开 demo 驱动:

--- a/kernel/arch/arm64/boot/dts/rockchip/rk3399-firefly-demo.dtsi
+++ b/kernel/arch/arm64/boot/dts/rockchip/rk3399-firefly-demo.dtsi
@@ -52,7 +52,7 @@
            led_demo: led_demo {
-                status = "disabled";
+                status = "okay";
                 compatible = "firefly,rk3399-led";
                 };

Complex trigger LED

如下是 trigger 方式控制 LED 复杂一点的例子,timer trigger 就是让 LED 达到不断亮灭的效果:

我们需要在内核把 timer trigger 配置上。

kernel 路径下使用 make menuconfig,按照如下方法将 timer trigger 驱动选中。

Device Drivers
--->LED Support
   --->LED Trigger support
      --->LED Timer Trigger

保存配置并编译内核,把 kernel.img 烧到 Face-RK3399 板子上 我们可以使用串口输入命令,就可以看到蓝灯不停的间隔闪烁。

echo "timer" > sys/class/leds/firefly\:blue\:power/trigger

用户还可以使用 cat 命令获取 trigger 的可用值:

root@rk3399_firefly_box:/ # cat sys/class/leds/firefly\:blue\:power/trigger
none rc-feedback test_ac-online test_battery-charging-or-full test_battery-charging
test_battery-full test_battery-charging-blink-full-solid test_usb-online mmc0 mmc1
ir-user-click [timer] heartbeat backlight default-on rfkill0 mmc2 rfkill1 rfkill2

本页目录