Skip to content

Latest commit

 

History

History
134 lines (110 loc) · 7.39 KB

README.md

File metadata and controls

134 lines (110 loc) · 7.39 KB

slide-switch

slide-switch translates slide switch position changes into normal button presses and releases for OpenWrt devices.

Usage

After installing slide-switch, follow the instructions in the OpenWrt User Guide to add scripts for each switch position. Both procd scripts (in /etc/rc.button) and hotplug scripts (in /etc/hotplug.d/button) are supported.

Each switch position has a corresponding button name in the form <switch name>-<switch position>. For example, the TP-Link TL-MR3020 has a switch named mode with positions "3g", "wisp" and "ap"; button names for the positions would be mode-3g, mode-wisp and mode-ap. See Supported Devices for a list of switch names and positions.

slide-switch will trigger both button presses and releases. For example, if the mode switch is moved from "3g" to "wisp", a release action will be triggered for "3g" (BUTTON=mode-3g ACTION=released), and a press action will be triggered for "wisp" (BUTTON=mode-wisp ACTION=pressed). Note that the timeout action is not supported at this time.

On boot, slide-switch will also trigger a button press for the active position of each switch. To disable or re-enable this behaviour, run slide-switch boot disable or slide-switch boot enable, respectively.

Supported Devices

Device Switch Name Switch Positions Verified Notes
Buffalo WZR-600DHP movie-engine on / off
Buffalo WZR-600DHP router on / off / auto
Buffalo WZR-HP-AG300H movie-engine on / off
Buffalo WZR-HP-AG300H router on / off / auto
Buffalo WZR-HP-G300NH movie-engine on / off ✔️
Buffalo WZR-HP-G300NH router on / off / auto ✔️
GL.iNet GL-AR150 mode left / center / right
GL.iNet GL-AR300M mode left / center / right ✔️
GL.iNet GL-AR300M-Lite mode left / center / right
GL.iNet GL-AR300M16 mode left / center / right ✔️
GL.iNet GL-AR750 mode dot / clear ✔️
GL.iNet GL-AR750S mode dot / clear ✔️
GL.iNet GL-E750 mode dot / clear ✔️
GL.iNet GL-MT1300 mode dot / clear ✔️
GL.iNet GL-MT300A mode left / center / right ✔️
GL.iNet GL-MT300N v1 mode left / center / right
GL.iNet GL-MT300N v2 mode left / center / right ✔️
GL.iNet GL-MV1000 mode dot / clear
HooToo HT-TM02 mode wired / wireless ✔️
TP-Link TL-MR3020 v1 mode 3g / wisp / ap ✔️
TP-Link TL-MR3020 v3 mode 3g / wisp / ap ✔️
TP-Link TL-MR3040 v2 mode 3g / wisp / ap ✔️
TP-Link TL-WR810N(EU) v1.1 mode router-ap / repeater / client ✔️
TP-Link TL-WR810N(EU) v2 mode router-ap / repeater / client
TP-Link TL-WR902AC v1 mode share-eth / share-hotspot / ap ✔️
TP-Link TL-WR902AC v3 mode share-eth / share-hotspot / ap ✔️

For most devices, switch data is initially collected from the OpenWrt wiki and from OpenWrt's source code. The Verified column indicates cases where the switch data has been tested and verified correct by users.

Changelog

See NEWS.

Backward-Incompatible Changes

1.0.0

  • GL.iNet GL-AR150,
    GL.iNet GL-AR300M,
    GL.iNet GL-MT300A,
    GL.iNet GL-MT300N v1,
    GL.iNet GL-MT300N v2:
    • Changed switch name from switch to mode
  • GL.iNet GL-AR750,
    GL.iNet GL-AR750S:
    • Changed switch name from switch to mode
    • Changed position names from "left" and "right" to "clear" and "dot", respectively

Contributing

Beyond code for bug fixes or new features, any help to verify switch data or add data for new devices would be greatly appreciated.

License

Copyright (C) 2016-2019, 2022 The slide-switch authors
https://github.com/jefferyto/openwrt-slide-switch

slide-switch is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

slide-switch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with slide-switch. If not, see http://www.gnu.org/licenses/.