在 Wifi Stick (随身 WIFI 棒子) 上配置 USB 即可 ADB 救急模式

为了避免 Wifi Stick 的 USB 接口在仅 RNDIS (网络共享) 时 SSH 连接无效, 造成丢失对设备的访问性和可控性, 我们可以配置接口的救急模式, 自动在该模式下配置 ADB 设备连接

配置基于特定时间重启的触发器#

我们可以在配置 RNDIS 作为接口协议前等待一会儿, 并使用 LED 灯提示, 若在提示期间重启设备, 代表切换接口状态

新建重启检测脚本#

1
/usr/sbin/gadget-mode-selector

写入

1
#!/bin/sh
2
MARKER_DIR="/var/lib/gadget"
3
REBOOT_MARKER="${MARKER_DIR}/switch_mode"
4
WAIT_SECONDS=3
5

6
# LED 路径
7
LED_RED="/sys/class/leds/red:os"
8
LED_GREEN="/sys/class/leds/green:internet"
9
LED_BLUE="/sys/class/leds/blue:wifi"
10

11
mkdir -p "$MARKER_DIR"
12

13
led_red_long() {
14
    echo none > ${LED_RED}/trigger 2>/dev/null
15
    led_red_on
16
}
17

18
led_green_long() {
19
    echo none > ${LED_GREEN}/trigger 2>/dev/null
20
    led_green_on
21
}
22

23
led_red_on()   { echo 255 > ${LED_RED}/brightness 2>/dev/null; }
24
led_red_off()  { echo 0   > ${LED_RED}/brightness 2>/dev/null; }
25
led_green_on() { echo 255 > ${LED_GREEN}/brightness 2>/dev/null; }
26
led_green_off(){ echo 0   > ${LED_GREEN}/brightness 2>/dev/null; }
27
led_blue_on()  { echo 255 > ${LED_BLUE}/brightness 2>/dev/null; }
28
led_blue_off() { echo 0   > ${LED_BLUE}/brightness 2>/dev/null; }
29

30
init_leds() {
31
    echo none > ${LED_RED}/trigger 2>/dev/null
32
    echo none > ${LED_GREEN}/trigger 2>/dev/null
33
    echo none > ${LED_BLUE}/trigger 2>/dev/null
34
    led_red_off
35
    led_green_off
36
    led_blue_off
37
}
38

39
output_status() {
40
    echo "STATUS: $1"
41
    echo "MESSAGE: $2"
42
    echo "---"
43
}
44

45
main() {
46
    init_leds
47

48
    # 检查重启标记
49
    if [ -f "$REBOOT_MARKER" ]; then
50
        rm -f "$REBOOT_MARKER"
51
        output_status "switching" "Reboot detected, switching to ADB mode"
52
        led_red_long
53
        exit 10
54
    fi
55

56
    output_status "waiting" "Waiting $WAIT_SECONDS seconds, reboot during blue slow blink to switch mode"
57

58
    # 红绿蓝快闪各一次（启动提示，不可切换）
59
    led_red_on;   sleep 0.2; led_red_off
60
    led_green_on; sleep 0.2; led_green_off
61
    led_blue_on;  sleep 0.2; led_blue_off
62

63
    touch "$REBOOT_MARKER"
64
    # 蓝灯慢闪（可切换窗口）
65
    for i in $(seq 1 $WAIT_SECONDS); do
66
        led_blue_on
67
        sleep 0.3
68
        led_blue_off
69
        sleep 0.7
70
        echo "WAIT: $i/$WAIT_SECONDS - Blue slow blink, reboot now to switch mode" >&2
71
    done
72
    rm -f "$REBOOT_MARKER"
73

74
    output_status "ready" "No switch requested, using RNDIS mode"
75
    led_green_long
76

77
    exit 0
78
}
79

80
main "$@"

然后授予可执行权限

1
chmod +x /usr/sbin/gadget-mode-selector

修改如下脚本#

WARNING
下方脚本文件过大, 如果使用 SSH 直接粘贴可能导致文件损坏, 请使用 SFTP 或其他可靠传输方式

该脚本由 Systemd Unit mobian-usb-gadget.service 自动调起

1
/usr/sbin/mobian-usb-gadget

改为

1
#!/bin/sh
2
CONFIGFS="/sys/kernel/config/usb_gadget/g1"
3
MODE_SELECTOR="/usr/sbin/gadget-mode-selector"
4
FFS_MOUNT_POINT="/dev/usb-ffs/adb"
5

6
log() { echo "[$(date +%H:%M:%S)] $*"; }
7

8
cleanup() {
9
    log "Removing USB gadget..."
10

11
    if [ -d $CONFIGFS ]; then
12
        echo "" > $CONFIGFS/UDC 2>/dev/null
13
        rm -rf $CONFIGFS
14
    fi
15
}
16

17
setup_rndis() {
18
    log "Configuring RNDIS-ONLY mode..."
19

20
    modprobe libcomposite
21

22
    # 清理旧配置
23
    if [ -d $CONFIGFS ]; then
24
        echo "" > $CONFIGFS/UDC 2>/dev/null
25
        rm -rf $CONFIGFS
26
    fi
27

28
    mkdir -p $CONFIGFS
29
    cd $CONFIGFS || exit 1
30

31
    # ===== 基本设备信息 =====
32
    echo 0x1d6b > idVendor        # Linux Foundation
33
    echo 0x0104 > idProduct       # Multifunction Gadget
34

35
    echo 0xEF > bDeviceClass
36
    echo 0x02 > bDeviceSubClass
37
    echo 0x01 > bDeviceProtocol
38

39
    mkdir -p strings/0x409
40
    echo "wifi-stick-miruku" > strings/0x409/serialnumber
41
    echo "wifi-stick" > strings/0x409/manufacturer
42
    echo "RNDIS Ethernet" > strings/0x409/product
43

44
    # ===== 配置 =====
45
    mkdir -p configs/c.1
46
    mkdir -p configs/c.1/strings/0x409
47
    echo "RNDIS" > configs/c.1/strings/0x409/configuration
48
    echo 120 > configs/c.1/MaxPower
49

50
    # ===== RNDIS =====
51
    mkdir -p functions/rndis.usb0
52

53
    # MAC 地址（建议固定）
54
    echo "02:12:34:56:78:9a" > functions/rndis.usb0/dev_addr
55
    echo "02:98:76:54:32:10" > functions/rndis.usb0/host_addr
56

57
    # ===== Windows 关键：OS Descriptor =====
58
    mkdir -p os_desc
59
    echo 1 > os_desc/use
60
    echo 0xcd > os_desc/b_vendor_code
61
    echo MSFT100 > os_desc/qw_sign
62

63
    mkdir -p functions/rndis.usb0/os_desc/interface.rndis
64
    echo RNDIS > functions/rndis.usb0/os_desc/interface.rndis/compatible_id
65
    echo 5162001 > functions/rndis.usb0/os_desc/interface.rndis/sub_compatible_id
66

67
    # ===== 绑定 =====
68
    ln -s functions/rndis.usb0 configs/c.1/
69
    ln -s configs/c.1 os_desc
70

71
    # ===== 启动 =====
72
    UDC=$(ls /sys/class/udc | head -n 1)
73
    echo $UDC > UDC
74

75
    gc -e
76

77
    log "RNDIS gadget started"
78
}
79

80
setup_adb() {
81
    log "Configuring ADB-ONLY mode..."
82

83
    modprobe libcomposite
84

85
    # 1. 清理旧配置 (ConfigFS 必须先卸载 UDC 才能删除)
86
    if [ -d "$CONFIGFS" ]; then
87
        echo "" > "$CONFIGFS/UDC" 2>/dev/null
88
        # 递归清理 configs 下的链接，否则 rm -rf 可能会因 Busy 报错
89
        find "$CONFIGFS/configs" -maxdepth 2 -type l -delete 2>/dev/null
90
        rm -rf "$CONFIGFS"/* 2>/dev/null
91
    fi
92

93
    mkdir -p "$CONFIGFS"
94
    cd "$CONFIGFS" || exit 1
95

96
    # 2. 基础设备 ID 设置
97
    echo 0x18d1 > idVendor        # Google Inc.
98
    echo 0x4ee7 > idProduct       # Android ADB interface (Win7/10 识别关键)
99
    echo 0x0200 > bcdUSB          # 声明为 USB 2.0
100
    echo 0x00 > bDeviceClass
101
    echo 0x00 > bDeviceSubClass
102
    echo 0x00 > bDeviceProtocol
103

104
    # 3. 创建字符串描述符 (增强 Windows 兼容性，防止识别为未知设备)
105
    mkdir -p strings/0x409
106
    echo "wifi-stick-miruku" > strings/0x409/serialnumber
107
    echo "Google" > strings/0x409/manufacturer
108
    echo "ADB Gadget" > strings/0x409/product
109

110
    # 4. 初始化 FunctionFS
111
    # 假设你的 gc -a ffs 内部会执行 mkdir functions/ffs.adb
112
    gc -a ffs
113

114
    # 确保配置目录存在 (FunctionFS 需要关联到某个 config)
115
    # 这一步如果 gc 没做，adbd 启动后无法 bind
116
    mkdir -p configs/c.1/strings/0x409
117
    echo "adb" > configs/c.1/strings/0x409/configuration
118
    ln -s functions/ffs.adb configs/c.1/ 2>/dev/null
119

120
    # 5. 挂载并启动 adbd
121
    mkdir -p /dev/usb-ffs/adb
122
    # 如果已经挂载则先卸载，防止 busy
123
    umount /dev/usb-ffs/adb 2>/dev/null
124
    mount -t functionfs adb /dev/usb-ffs/adb
125

126
    # 启动 adbd
127
    # -D 模式下 adbd 会等待 /dev/usb-ffs/adb 准备就绪
128
    killall adbd 2>/dev/null
129

130
    # 切换默认工作路径到 HOME
131
    cd ~
132

133
    adbd -D &
134

135
    # 关键等待：adbd 必须写入 ep0 后，UDC 才能 bind 成功
136
    sleep 1
137

138
    # 6. 绑定控制器
139
    UDC_NAME=$(ls /sys/class/udc | head -n 1)
140
    if [ -n "$UDC_NAME" ]; then
141
        echo "$UDC_NAME" > UDC
142
    else
143
        log "Error: No UDC found!"
144
        return 1
145
    fi
146

147
    gc -e
148

149
    log "ADB gadget started on $UDC_NAME"
150
}
151

152
status() {
153
    echo "========================================="
154
    echo "USB Gadget Status"
155
    echo "========================================="
156
    if [ -d "$CONFIGFS" ]; then
157
        echo "Gadget configured: YES"
158
        if [ -f "$CONFIGFS/UDC" ]; then
159
            cur=$(cat "$CONFIGFS/UDC" 2>/dev/null)
160
            [ -n "$cur" ] && echo "UDC active: $cur" || echo "UDC active: NO"
161
        fi
162
        [ -f "$CONFIGFS/strings/0x409/product" ] && echo "Product: $(cat "$CONFIGFS/strings/0x409/product" 2>/dev/null)"
163
    else
164
        echo "Gadget configured: NO"
165
    fi
166
    echo ""
167
    echo "ADB Status:"
168
    pgrep adbd >/dev/null 2>&1 && echo "  adbd running: YES" || echo "  adbd running: NO"
169
    echo ""
170
    echo "UDC Devices: $(ls /sys/class/udc/ 2>/dev/null | tr '\n' ' ')"
171
    echo "========================================="
172
}
173

174
case "${1:-}" in
175
    setup|start)
176
        cleanup
177
        if [ -f "$MODE_SELECTOR" ]; then
178
            $MODE_SELECTOR
179
            code=$?
180
            if [ "$code" = "10" ]; then
181
                setup_adb
182
            else
183
                setup_rndis
184
            fi
185
        else
186
            setup_rndis
187
        fi
188
        ;;
189
    reset|stop)
190
        cleanup
191
        ;;
192
    status)
193
        status
194
        ;;
195
    *)
196
        echo "Usage: $0 {setup|start|reset|stop|status}"
197
        exit 1
198
        ;;
199
esac
200

201
exit

然后在 .bashrc 或 .profile 中

1
~/.bashrc

增加如下行, 以美化 ADB Shell

1
export HOME='/root'
2
export TERM='xterm-256color'
3
export PS1='\[\e[32m\]\u@\h:\[\e[34m\]\w\[\e[0m\]\$ '

用法#

时间段	LED 状态	能否切换	操作方式	结果
0 - 0.6s	红绿蓝快闪各一次	❌	启动提示，不可切换	-
0.6s - 3.6s	蓝色慢闪	✅	在蓝色慢闪期间重启	切换模式至 ADB 模式直至重启
> 3.6s	常亮绿	❌	-	当前为 RNDIS 模式
> 3.6s	常亮红	❌	-	当前为 ADB 模式

要查看当前状态, 请使用

1
mobian-usb-gadget status