part of this article is not done.

• Check the article wifitoggle. If you want, you can rewrite this.
• Some more inspiration: buttons TODO
• nslu2.hardware.button for the NSLU2

If a target platform is known to support buttons, appropriate kernel modules are selected by default.

If a platform is not known to support buttons, various kernel modules might be required. These might be diag, input-gpio-buttons, gpio-button-hotplug and others. However, installing various modules will not necessarily yield a successful result.

The first step is to make Hotplug execute scripts in /etc/hotplug.d/button when a button is clicked. Modify /etc/hotplug2.rules — remove '^' before 'button' as follow:

$include /etc/hotplug2-common.rules

SUBSYSTEM ~~ (^net$|^input$|button$|^usb$|^ieee1394$|^block$|^atm$|^zaptel$|^tty$) {
	exec /sbin/hotplug-call %SUBSYSTEM%
}

DEVICENAME == watchdog {
	exec /sbin/watchdog -t 5 /dev/watchdog
	next-event
}

The second step is to find out the internal name of the button you want to use: some images use generic names such as BTN_1, BTN_2, others have more specific ones like reset, wps, etc. Run the following:

# mkdir -p /etc/hotplug.d/button

Create the file /etc/hotplug.d/button/buttons with your favorite text editor, paste the following:

#!/bin/sh
logger $BUTTON
logger $ACTION 

Save and exit. Now press the button you want to use, then run logread.

Jan 1 00:01:15 OpenWrt user.notice root: BTN_1   
Jan 1 00:01:15 OpenWrt user.notice root: pressed   
Jan 1 00:01:16 OpenWrt user.notice root: BTN_1    
Jan 1 00:01:16 OpenWrt user.notice root: released 

BTN_1 is the name of the button you want to use. If you want or need to use another button, replace every instance of BTN_1 in the rest of this document with the correct text. From now on, there are several possible approaches: the first uses the 00-button script from the atheros target, the other a simpler shell script.

notice

If you want to run programs from hotplug's scripts you need to be sure PATH and the like are initialized properly, scripts invoked by hotplug only have a default env. Especially if you install stuff into nonstandard locations like /opt/usr/bin. It's possible by adding . /etc/profile after #!/bin/sh

#!/bin/sh
. /etc/profile

If you've installed the full version of wget, run the following:

# wget -O /etc/hotplug.d/button/00-button https://dev.openwrt.org/export/36332/trunk/target/linux/atheros/base-files/etc/hotplug.d/button/00-button

If you only have wget-nossl and don't want to or can't upgrade, create /etc/hotplug.d/button/00-button with your favorite editor, then paste the following:

#!/bin/sh
. /lib/functions.sh
do_button () {
        local button
        local action
        local handler
        local min
        local max

        config_get button $1 button
        config_get action $1 action
        config_get handler $1 handler
        config_get min $1 min
        config_get max $1 max

        [ "$ACTION" = "$action" -a "$BUTTON" = "$button" -a -n "$handler" ] && {
                [ -z "$min" -o -z "$max" ] && eval $handler
                [ -n "$min" -a -n "$max" ] && {
                        [ $min -le $SEEN -a $max -ge $SEEN ] && eval $handler
                }
        }
}

config_load system
config_foreach do_button button

Please note that after r34793 /etc/functions.sh → /lib/functions.sh so if you are using an old version change it!

Save and exit, then issue these commands:

uci add system button    
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=pressed
uci set system.@button[-1].handler='logger BTN_1 pressed'
uci commit system 

button is the name as the button, action is the event (two values: pressed and released), handler contains the command line to be run when the event is detected (can be a script as well).

You may need to reboot the router the make the change effective (mine would work with the simple shell script just fine but wouldn't budge when using the 00-button script — Frex 2011/03/25 22:29). If this works, you can change the handler to something more useful, and add more button handlers.

Example 1: Toggle Wi-Fi radio with a button press

uci add system button    
uci set system.@button[-1].button=wps    
uci set system.@button[-1].action=pressed
uci set system.@button[-1].handler='uci set wireless.@wifi-device[0].disabled=1 && wifi'
uci commit system 

Example 2: Assign two different functions to the same button: short press VS long press. This relies on tracking the released event rather than the pressed event.

uci add system button
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=released
uci set system.@button[-1].handler='logger timed pressed: 0-3s'
uci set system.@button[-1].min=0
uci set system.@button[-1].max=3
uci add system button
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=released
uci set system.@button[-1].handler='logger timed pressed: 8-10s'
uci set system.@button[-1].min=8
uci set system.@button[-1].max=10
uci commit system 

Example 3: Unmount USB storage using a long-ish press

uci add system button
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=released
uci set system.@button[-1].handler="for i in \$(mount | awk '/dev\/sd[b-z]/ { print \$1}'); do umount \$i; done"
uci set system.@button[-1].min=5
uci set system.@button[-1].max=10
uci commit system 

Example 4: Restore defaults

config button
        option button   reset
        option action   released
        option handler  "firstboot && reboot"
        option min              5
        option max             30

Example 5: Toggle Wi-Fi using a script

config button
        option button   wps
        option action   released
        option handler  "/usr/bin/wifionoff"
        option min      0
        option max      3

You'll have to create the file /usr/bin/wifionoff and paste this:

#!/bin/sh
SW=$(uci -q get wireless.@wifi-device[0].disabled)
[ "$SW" == "1" ] && uci set wireless.@wifi-device[0].disabled=0
[ "$SW" == "1" ] || uci set wireless.@wifi-device[0].disabled=1
wifi

Another option for wifionoff is this script (doesn't store the state in uci, so it remains what is set in the configuration) You can also call this script eg. from cron, to switch off your wifi at night.

#!/bin/sh
STATEFILE="/tmp/wifionoff.state"

if [ $# -eq 1 ]; then
  case $1 in
    "up"|"on")
      STATE=off
      ;;
    "down"|"off")
      STATE=on
      ;;
  esac
else
  if [ ! -e ${STATEFILE} ]; then
    STATE=on
  else
    . ${STATEFILE}
  fi
fi
if [ -z ${STATE} ]; then
  STATE=on
fi

if [ ${STATE} == "on" ]; then
  /sbin/wifi down
  STATE=off
else
  /sbin/wifi up
  STATE=on
fi
  
echo "STATE=${STATE}" > ${STATEFILE}

Example 6: Set transmission-daemon alt-speed, enable or disable.Short press will activate alt-speed or longer press will deactivate alt-speed and also turns on qss led about speed status on tl-wr1043nd

Edit your alt-speed limits from transmission-daemon , settings.json file.To execute script, you need to install transmission-remote package from opkg.

uci add system button    
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=pressed
uci set system.@button[-1].handler='transmission-remote -as'
uci add system button    
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=pressed
uci set system.@button[-1].handler='echo 1 > /sys/class/leds/tl-wr1043nd:green:qss/brightness'
uci add system button
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=released
uci set system.@button[-1].handler='transmission-remote -AS'
uci set system.@button[-1].min=1
uci set system.@button[-1].max=4
uci add system button
uci set system.@button[-1].button=BTN_1
uci set system.@button[-1].action=released
uci set system.@button[-1].handler='echo 0 > /sys/class/leds/tl-wr1043nd:green:qss/brightness'
uci set system.@button[-1].min=1
uci set system.@button[-1].max=4
uci commit system

mkdir -p /etc/hotplug.d/button
touch /etc/hotplug.d/button/00-button

if [ "$ACTION" = "pressed" ]; then
    if [ "$BUTTON" = "BTN_0" ]; then BTN_0
    elif [ "$BUTTON" = "BTN_1" ]; then BTN_1
    fi 
fi 

mkdir -p /etc/hotplug.d/button
wget -O /etc/hotplug.d/button/00-button http://dev.openwrt.org/export/21216/trunk/target/linux/atheros/base-files/etc/hotplug.d/button/00-button 
wget -O http://dev.openwrt.org/export/21216/trunk/target/linux/atheros/base-files/etc/hotplug.d/button/00-button

#!/bin/sh
[ "$BUTTON" = "BTN_1" ] && [ "$ACTION" = "pressed" ] && {
SW=$(uci get wireless.@wifi-device[0].disabled)
[ $SW == '0' ] && uci set wireless.@wifi-device[0].disabled=1
[ $SW == '0' ] || uci set wireless.@wifi-device[0].disabled=0
wifi
}

If you decide to use the wifitoggle package, you will need to change a few things on the default configuration. The following will work and make the QSS led blink "slowly" when wifi is on:

uci show wifitoggle
uci set wifitoggle.@wifitoggle[0]=wifitoggle
uci set wifitoggle.@wifitoggle[0].led_enable_trigger=timer
uci set wifitoggle.@wifitoggle[0].persistent=1
uci set wifitoggle.@wifitoggle[0].button=BTN_1
uci set wifitoggle.@wifitoggle[0].led_sysfs=tl-wr1043nd:green:qss
uci set wifitoggle.@wifitoggle[0].led_enable_delayon=2000
uci set wifitoggle.@wifitoggle[0].led_disable_default=1
uci set wifitoggle.@wifitoggle[0].led_enable_delayoff=3000
uci set wifitoggle.@wifitoggle[0].timer=0

You can probably get similar behaviour with phy0tpt trigger.

To manage the router buttons and also other HID buttons (i.e pad buttons of an usb device) we can use an application like triggerhappy.

First list your available buttons:

thd --dump /dev/input/event*

Now associate your buttons to commands or scripts
path /etc/triggerhappy/triggers.d/example.conf

KEY_WPS_BUTTON 1 /etc/mywifiscript.sh
KEY_VOLUMEUP 1 amixer -q set Speaker 3%+
KEY_VOLUMEDOWN 1 amixer -q set Speaker 3%-

/etc/init.d/triggerhappy start

cmdpad is another simpler application to manage buttons.