openwrt中LED的控制

痛定思痛。 2022-12-20 08:39 2839阅读 0赞

# openwrt中LED的控制 #

### 上手总结 ###

> #### 配置方法一 简单操作 ####
> 
> 直接进入`/sys/class/leds`目录下面。以`<路由器名字>:颜色:<功能>`格式命名的目录均对应一个LED。
> 
> 进入要操作的目录，重点是 `trigger`(触发方式) 、`brightness` （开关）、`delay_off`(熄灯时间)、`delay_on`(亮灯时间)
> 
>     #ls
>     brightness      delay_on        max_brightness  trigger
>     delay_off       device          subsystem       uevent
> 
> 对文件brightness写入0/1，关闭/打开LED灯。如 ：`echo 0 > brightness`.
> 
> 设置闪烁：
> 
>     echo timer > trigger
>     echo 1000  > delay_on
>     echo 1000  > delay_off
> 
> 常用示例：关闭路由器所有led脚本
> 
>     #!/bin/ash
>     for i in `ls /sys/class/leds` 
>     do cd /sys/class/leds 
>     cd $i 
>     echo 0 > brightness
>     done

> #### 配置方法二 ####
> 
> 修改配置文件`/etc/config/system`
> 
> 往下细看

### 配置文件 ###

#### `/etc/config/system` ####

#......
    config led 'led_internet'
            option name 'internet'
            option sysfs 'newifi-d2:amber:internet'
            option trigger 'switch0'
            option port_mask '0x10'
    
    config led 'led_wlan2g'
            option name 'WiFi 2.4GHz'
            option sysfs 'newifi-d2:blue:wlan2g'
            option trigger 'netdev'
            option mode 'link tx rx'
            option dev 'ra0'
    
    config led 'led_wlan5g'
            option name 'WiFi 5GHz'
            option sysfs 'newifi-d2:blue:wlan5g'
            option trigger 'netdev'
            option mode 'link tx rx'
            option dev 'rai0'

#### 添加配置 ####

所有可以被控制的LED灯均在`/sys/class/leds`目录下。例如：

ls /sys/class/leds/
    newifi-d2:amber:internet  newifi-d2:blue:power      newifi-d2:blue:wlan5g
    newifi-d2:amber:power     newifi-d2:blue:usb
    newifi-d2:blue:internet   newifi-d2:blue:wlan2g

LED受系统中的各种事件控制，由对应的`trigger`指定。：

# cat /sys/class/leds/newifi-d2:blue:usb/trigger
    [none] switch0 timer default-on netdev usbport phy0rx phy0tx phy0assoc phy0radio phy0tpt phy1rx phy1tx phy1assoc phy1radio phy1tpt
    # echo "default-on" > /sys/class/leds/newifi-d2:blue:usb/trigger
    # cat /sys/class/leds/newifi-d2:blue:usb/trigger
    none switch0 timer [default-on] netdev usbport phy0rx phy0tx phy0assoc phy0radio phy0tpt phy1rx phy1tx phy1assoc phy1radio phy1tpt

执行以上命令，可以打开对应的LED灯，重启系统会失效。需要永久生效则写入`/etc/config/system`。

例如：

#查看
    #uci show system | grep 'system.led'
    system.led_usb=led
    system.led_usb.name='USB'
    system.led_usb.sysfs='newifi-d2:blue:usb'
    system.led_usb.trigger='usbport'
    system.led_usb.interval='50'
    system.led_usb.dev='1-1'
    
    #修改
    uci set system.led_sub.trigger='default-on'
    uci commit
    
    #或者
    
    uci batch <<EOF set system.led_usb=led set system.led_usb.name='USB' set system.led_usb.sysfs='newifi-d2:blue:usb' set system.led_usb.trigger='default-on' EOF
    uci commit
    
    #重启 生效
    service led restart

### Led triggers ###

*  **`none`** : LED始终处于默认状态。未列出的LED默认为OFF，因此仅在声明LED始终为ON时有用。

*  **`switch0`** : 如果已在已配置的交换机端口之一上建立链接，则该指示灯点亮。

<table> 
 <thead> 
  <tr> 
   <th align="left">Name</th> 
   <th align="left">Type</th> 
   <th align="left">Required</th> 
   <th align="left">Default</th> 
   <th align="left">Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><em>default</em></td> 
   <td align="left">integer</td> 
   <td align="left">no</td> 
   <td align="left">0</td> 
   <td align="left">LED state before trigger: <em>0</em> means OFF and <em>1</em> means ON</td> 
  </tr> 
  <tr> 
   <td align="left"><em>sysfs</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">LED device name</td> 
  </tr> 
  <tr> 
   <td align="left"><em>port_mask</em></td> 
   <td align="left">integer</td> 
   <td align="left">no</td> 
   <td align="left">0</td> 
   <td align="left">Hexadecimal bit mask that encodes the regarded switch ports</td> 
  </tr> 
  <tr> 
   <td align="left"><em>speed_mask</em></td> 
   <td align="left">?</td> 
   <td align="left">?</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">Example value: ‘0xf’</td> 
  </tr> 
  <tr> 
   <td align="left"><em>trigger</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left"><em>switch0</em></td> 
  </tr> 
 </tbody> 
</table>

*  **`Timer`** : 配置LED的开/关频率闪烁。

#安装命令
    opkg install kmod-ledtrig-timer

<table> 
 <thead> 
  <tr> 
   <th align="left">Name</th> 
   <th align="left">Type</th> 
   <th align="left">Required</th> 
   <th align="left">Default</th> 
   <th align="left">Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">default</td> 
   <td align="left">integer</td> 
   <td align="left">no</td> 
   <td align="left">0</td> 
   <td align="left">LED state before trigger: <em>0</em> means OFF and <em>1</em> means ON</td> 
  </tr> 
  <tr> 
   <td align="left">delayoff</td> 
   <td align="left">integer</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">How long (in milliseconds) the LED should be off.</td> 
  </tr> 
  <tr> 
   <td align="left">delayon</td> 
   <td align="left">integer</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">How long (in milliseconds) the LED should be on.</td> 
  </tr> 
  <tr> 
   <td align="left">sysfs</td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">LED device name</td> 
  </tr> 
  <tr> 
   <td align="left">trigger</td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left"><em>timer</em></td> 
  </tr> 
 </tbody> 
</table>

*  **`default-on`** : LED灯常亮，已经被弃用，使用`default=1 trigger=none`

#安装命令
    opkg install kmod-ledtrig-default-on

*  **`heartbeat`** : LED闪烁以模拟实际的心跳<频率与1分钟平均CPU负载成正比。

#安装
    opkg install kmod-ledtrig-heartbeat

*  **`nand-disk`** : 当数据写入闪存时，LED闪烁。

*  **`netdev`** : LED闪烁并显示链接状态和/或已配置接口上的发送和接收活动。

#安装
    opkg install kmod-ledtrig-netdev

<table> 
 <thead> 
  <tr> 
   <th align="left">Name</th> 
   <th align="left">Type</th> 
   <th align="left">Required</th> 
   <th align="left">Default</th> 
   <th align="left">Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">default</td> 
   <td align="left">integer</td> 
   <td align="left">no</td> 
   <td align="left">0</td> 
   <td align="left">LED state before trigger: <em>0</em> means OFF and <em>1</em> means ON</td> 
  </tr> 
  <tr> 
   <td align="left"><em>dev</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">Name of the network interface which status should be reflected</td> 
  </tr> 
  <tr> 
   <td align="left"><em>mode</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">One or more of <em>link</em>, <em>tx</em>, or <em>rx</em>, seperated by spaces</td> 
  </tr> 
  <tr> 
   <td align="left"><em>sysfs</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">LED device name</td> 
  </tr> 
  <tr> 
   <td align="left"><em>trigger</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left"><em>netdev</em></td> 
  </tr> 
  <tr> 
   <td align="left">interval</td> 
   <td align="left">?</td> 
   <td align="left">?</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">Example value: ‘50’</td> 
  </tr> 
 </tbody> 
</table>

*  **`WiFi Activity triggers`** : 当在物理接口而不是软件网络接口中触发的事件上，LED闪烁。除了*phy*触发器具有更多事件之外，如果您想分别监视2.4 GHz无线电（通常为*phy0*）和5 GHz无线电（通常为*phy1*），它还提供了静态LED设置的可能性。*netdev*无法保证这种区分，因为根据当前的网络设置，*wlan0*可能是指2.4 GHz或5 GHz无线电。

> **phy0rx-** 接收时闪烁。  
> **phy0tx-** 传输时闪烁。  
> **phy0assoc-** 在客户端关联上闪烁。  
> **phy0radio-**（未知，此选项对我的tl-wr1043nd无效）  
> **phy0tpt-** 网络活动缓慢且稳定地闪烁。与tx和rx模式的充满活力的闪烁相比

*  **`usbdev / usbport`** : 如果连接了USB设备，则LED点亮。

#安装
    opkg install kmod-ledtrig-usbdev

<table> 
 <thead> 
  <tr> 
   <th align="left">Name</th> 
   <th align="left">Type</th> 
   <th align="left">Required</th> 
   <th align="left">Default</th> 
   <th align="left">Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><em>default</em></td> 
   <td align="left">integer</td> 
   <td align="left">no</td> 
   <td align="left">0</td> 
   <td align="left">LED state before trigger: <em>0</em> means OFF and <em>1</em> means ON</td> 
  </tr> 
  <tr> 
   <td align="left"><em>dev</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">Name of USB device to monitor.</td> 
  </tr> 
  <tr> 
   <td align="left"><em>interval</em></td> 
   <td align="left">integer</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">Interval in ms when device is active.</td> 
  </tr> 
  <tr> 
   <td align="left"><em>sysfs</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">LED device name</td> 
  </tr> 
  <tr> 
   <td align="left"><em>trigger</em></td> 
   <td align="left">string</td> 
   <td align="left">yes</td> 
   <td align="left"><em>(none)</em></td> 
   <td align="left">usbdev – <strong>This may be <code>usbport</code> (March 2019)</strong></td> 
  </tr> 
 </tbody> 
</table>

*  **`gpio`** : 允许通过gpio事件控制LED。

#安装
     opkg install kmod-ledtrig-gpio

*  **`Net filter`** : 当特定数据包通过您的计算机时，指示灯会闪烁。

#安装
    opkg install kmod-ipt-led
    
    #示例：当ssh连接通信时触发
    iptables -A INPUT -p tcp --dport 22 -j LED --led-trigger-id ssh --led-delay 1000
    #然后将新触发器连接到系统上的LED
    echo netfilter-ssh > /sys/class/leds/<ledname>/trigger

### 示例 ###

#### Heartbeat led ####

config 'led'
    	option 'sysfs'		'wrt160nl:amber:wps'
    	option 'trigger'	'heartbeat'

#### WLAN led ####

config 'led' 'wlan_led'
    	option 'name'           'WLAN'
    	option 'sysfs'          'tl-wr1043nd:green:wlan'
    	option 'trigger'        'netdev'
    	option 'dev'            'wlan0'
    	option 'mode'           'link tx rx'

#### 3G led ####

当USB正确注册到3G / EDGE / GPRS网络时，此指示灯点亮。

config 'led'
    	option 'name'           '3G'
    	option 'sysfs'          'asus:blue:3g'
    	option 'trigger'        'netdev'
    	option 'dev'            '3g-wan'
    	option 'mode'           'link'

#### Timer led - 500ms ON, 2000ms OFF ####

config 'led'
    	option 'sysfs'		'wrt160nl:blue:wps'
    	option 'trigger'	'timer'
    	option 'delayon'	'500'
    	option 'delayoff'	'2000'

### led服务脚本 ###

`/etc/init.d/led`

#!/bin/sh /etc/rc.common
    # Copyright (C) 2008 OpenWrt.org
    
    START=96
    
    load_led() { 
            local name
            local sysfs
            local trigger
            local dev
            local ports
            local mode
            local default
            local delayon
            local delayoff
            local interval
    
            config_get sysfs $1 sysfs
            config_get name $1 name "$sysfs"
            config_get trigger $1 trigger "none"
            config_get dev $1 dev
            config_get ports $1 port
            config_get mode $1 mode
            config_get_bool default $1 default "nil"
            config_get delayon $1 delayon
            config_get delayoff $1 delayoff
            config_get interval $1 interval "50"
            config_get port_state $1 port_state
            config_get delay $1 delay "150"
            config_get message $1 message ""
            config_get gpio $1 gpio "0"
            config_get inverted $1 inverted "0"
    
            if [ "$trigger" = "rssi" ]; then
                    # handled by rssileds userspace process
                    return
            fi
    
            [ "$trigger" = "usbdev" ] && { 
                    # Backward compatibility: translate to the new trigger
                    trigger="usbport"
                    # Translate port of root hub, e.g. 4-1 -> usb4-port1
                    ports=$(echo "$dev" | sed -n 's/^$[0-9]*$-$[0-9]*$$/usb\1-port\2/p') # Translate port of extra hub, e.g. 2-2.4 -> 2-2-port4 [ -z "$ports" ] && ports=$(echo "$dev" | sed -n 's/\./-port/p') } [ -e /sys/class/leds/${sysfs}/brightness ] && { echo "setting up led ${name}" printf "%s %s %d\n" \ "$sysfs" \ "$(sed -ne 's/^.*\[$.*$\].*$/\1/p' /sys/class/leds/${sysfs}/trigger)" \
                            "$(cat /sys/class/leds/${ sysfs}/brightness)" \
                                    >> /var/run/led.state
    
                    [ "$default" = 0 ] &&
                            echo 0 >/sys/class/leds/${sysfs}/brightness
    
                    echo $trigger > /sys/class/leds/${sysfs}/trigger 2> /dev/null
                    ret="$?"
    
                    [ $default = 1 ] &&
                            cat /sys/class/leds/${sysfs}/max_brightness > /sys/class/leds/${sysfs}/brightness
    
                    [ $ret = 0 ] || { 
                            echo >&2 "Skipping trigger '$trigger' for led '$name' due to missing kernel module"
                            return 1
                    }
                    case "$trigger" in
                    "netdev")
                            [ -n "$dev" ] && { 
                                    echo $dev > /sys/class/leds/${sysfs}/device_name
                                    for m in $mode; do
                                            [ -e "/sys/class/leds/${sysfs}/$m" ] && \
                                                    echo 1 > /sys/class/leds/${sysfs}/$m
                                    done
                                    echo $interval > /sys/class/leds/${sysfs}/interval
                            }
                            ;;
    
                    "timer"|"oneshot")
                            [ -n "$delayon" ] && \
                                    echo $delayon > /sys/class/leds/${sysfs}/delay_on
                            [ -n "$delayoff" ] && \
                                    echo $delayoff > /sys/class/leds/${sysfs}/delay_off
                            ;;
    
                    "usbport")
                            local p
    
                            for p in $ports; do
                                    echo 1 > /sys/class/leds/${sysfs}/ports/$p
                            done
                            ;;
    
                    "port_state")
                            [ -n "$port_state" ] && \
                                    echo $port_state > /sys/class/leds/${sysfs}/port_state
                            ;;
    
                    "gpio")
                            echo $gpio > /sys/class/leds/${sysfs}/gpio
                            echo $inverted > /sys/class/leds/${sysfs}/inverted
                            ;;
    
                    switch[0-9]*)
                            local port_mask speed_mask
    
                            config_get port_mask $1 port_mask
                            [ -n "$port_mask" ] && \
                                    echo $port_mask > /sys/class/leds/${sysfs}/port_mask
                            config_get speed_mask $1 speed_mask
                            [ -n "$speed_mask" ] && \
                                    echo $speed_mask > /sys/class/leds/${sysfs}/speed_mask
                            [ -n "$mode" ] && \
                                    echo "$mode" > /sys/class/leds/${sysfs}/mode
                            ;;
                    esac
            }
    }
    
    start() { 
            [ -e /sys/class/leds/ ] && { 
                    [ -s /var/run/led.state ] && { 
                            local led trigger brightness
                            while read led trigger brightness; do
                                    [ -e "/sys/class/leds/$led/trigger" ] && \
                                            echo "$trigger" > "/sys/class/leds/$led/trigger"
    
                                    [ -e "/sys/class/leds/$led/brightness" ] && \
                                            echo "$brightness" > "/sys/class/leds/$led/brightness"
                            done < /var/run/led.state
                            rm /var/run/led.state
                    }
    
                    config_load system
                    config_foreach load_led led
            }
    }