进入 Fastboot#

插入电脑 USB 接口 (若无法识别请使用主板 IO 侧接口, 而不是机箱前面板接口), 后立即长按 Wifi Stick 按钮不松

然后运行

1
fastboot devices

可以成功看到有 Fastboot 设备连接

对于 Windows 操作系统, 需要手动安装 Fastboot 驱动. 也可以直接使用图形化刷机工具 刷机匣
刷机匣需要使用 -a 版本, 该版本才有 fastboot 选项卡

See Also, 进入 9008#

1
paru -S edl

1
sudo edl <command> --loader=MSM8916.elf

1
DeviceClass - [LIB]: Couldn't get device configuration.

刷机#

连接 Wifi Stick SSH#

不同固件的 Wifi Stick 连接方式各异, 但基本上就是连接 Wifi Stick 提供的热点或使用 RNDIS 作为 USB 网卡连接, 然后再 SSH 至其的 IP 地址

RNDIS 设备连接方式参见 连接 RNDIS 设备

TIP

部分二改的刷机包可能没有修改脚本内说明的 IP 地址, 可以通过查看自动获取到的 IP 地址, 然后尝试连接该 IP 的常见网关地址 (.1 或 .254)

大部分固件默认启用了 USB 融合模式, 会同时提供一个 RNDIS 设备和一个 ADB 设备, 一般情况下可以直接使用 adb shell连接终端

连接 WI-FI#

为了安装软件包或进行其他操作, 我们须要使 Wifi Stick 接入互联网

在大部分固件的系统内, 默认使用 NetworkManager 作为网络管理器, 我们可以使用 nmcli 命令行工具连接 WI-FI

某些固件默认开启了 WI-FI 热点, 这会导致 WI-FI 设备被占用, 无法扫描现有 WI-FI (直接连接会覆盖配置不受影响, 如果你知道你的 WI-FI 名称就不需要管了). 要删除该配置, 请使用

1
nmcli connection show

1
NAME   UUID                                  TYPE      DEVICE
2
USB    2eed87e1-0ca6-4625-8b07-d80514fe1ef3  ethernet  usb0
3
wifi   bb317ee5-d497-4f07-8815-7eac62e72b88  wifi      wlan0
4
modem  bbf76fd3-010e-402e-a68c-135f893c828b  gsm       --

查看 DEVICE 为 wlan* 的项, 然后删除

1
nmcli connection delete "wifi"

1
nmcli radio wifi on  # 开启 WI-FI

如下命令是可选的

1
# 扫描 WI-FI
2
nmcli device wifi rescan
3
# 列出 WI-FI
4
nmcli device wifi list

连接 WI-FI

1
nmcli device wifi connect "<SSID>" password "<PASSWORD>" [name "<NAME>"]

例如, 要连接名为 test-wifi, 密码为 testtest 的 WI-FI 并命名为 default-wlan, 请使用

1
nmcli device wifi connect "test-wifi" password "testtest" name "default-wlan"

然后可以使用如下命令查看连接情况

1
nmcli connection show

软件包换源#

为了加速在中国大陆境内的软件下载速度, 推荐更换 APT 软件源

NOTE

下载速度过慢可以查看 Wifi Stick 连接 WIFI 后速率过慢

1
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
2

3
sudo tee /etc/apt/sources.list <<-'EOF'
4
deb https://mirror.nju.edu.cn/debian/ bullseye main contrib non-free
5
deb https://mirror.nju.edu.cn/debian-security/ bullseye-security main contrib non-free
6
EOF
7

8
sudo apt update

配置 USB 接口模式#

为了方便切换模式, 我们需要测试固件对于按钮的支持性

1
# 安装输入事件测试工具
2
sudo apt install evtest
3

4
# 启动, 并选择要测试的设备
5
sudo evtest --grab /dev/input/event0

/dev/input/event0 是按钮的设备标识, 请按照实际情况修改

要列出全部的输入设备, 可以使用

1
cat /proc/bus/input/devices | grep -E 'Name=|Handlers='

在默认情况下, 按钮被映射到了 KEY_RESTART, 导致按下会重启. --grab 选项用于独占按钮而不再将按钮事件分发到 kernel, 从而避免重启

若无输出变化, 那么可能是按钮的触发电平在设备树中存在配置问题, 对于 ufi001c 设备, 可以使用 修复过的 boot.img 并直接刷入即可. 对于其他设备, 可以自行修改设备树并编译打包 (仅打包 boot.img 皆可). 要使用修复完成的 boot.img, 在固件正常刷入之后, 仅须覆盖刷写 boot 分区, 不需要改变其他分区

感谢 dezige131 对设备树修改与 boot.img 打包支持

接下来, 我们要配置 RNDIS 等不同 USB 接口用途, 为了方便调试, 我们可以安装 iproute2 (也就是常见发行版内的 ip 命令)

1
sudo apt install iproute2

1
sudo systemctl disable --now mobian-usb-gadget.service
2
sudo systemctl disable --now mobian-setup-usb-network.service

1
sudo chmod +x /usr/local/bin/usb-switcher

1
/usr/local/lib/usb-switcher/start.sh

1
#!/usr/bin/env bash
2

3
set -euo pipefail
4

5
/usr/local/bin/usb-switcher daemon --devnode /dev/input/event0 --led /sys/class/leds/blue\:wifi --led /sys/class/leds/red\:os --led /sys/class/leds/green\:internet --config-fs /sys/kernel/config/usb_gadget/g1 "$@"

1
sudo chmod +x /usr/local/lib/usb-switcher/start.sh

1
/etc/systemd/system/wifi-stick-usb-switcher.service

1
[Unit]
2
Description=wifi-stick-usb-switcher
3

4
[Service]
5
Type=fork
6
ExecStart=/usr/bin/bash /usr/local/lib/usb-switcher/start.sh
7

8
[Install]
9
WantedBy=multi-user.target

1
sudo systemctl daemon-reload
2
sudo systemctl enable --now wifi-stick-usb-switcher.service

1
/usr/local/bin/usb-switcher daemon --help

[可选] 配置 Fileserver#

为了将 Wifi Stick 作为一个不使用 USB 存储接口的 U 盘, 可以配置 Fileserver, 利用网路通讯传输文件

轻量的 Fileserver 可以选用 https://github.com/sigoden/dufs 或 https://github.com/spcnvdr/go-fileserver

若要使用较为完善的用户认证系统, 可以选择稍大的 https://github.com/filebrowser/filebrowser (但不支持匿名访问)

下文我们将以 dufs 为例, 配置

1. 专用的文件分享与上传文件夹, 用户与 dufs 服务
2. Caddy 反向代理, 并携带 internal TLS 以防止不受信电脑监听/中间人攻击
3. 非 80/443/8080 约定俗成端口号 以绕过部分网路防火墙

1
sudo useradd -u 3443 -m file

1
sudo mkdir -p /www/files
2
sudo chown file:file -R /www/files
3
# 保留新建文件的 Group
4
sudo chmod g+s -R /www/files
5
sudo chmod 750 -R /www/files

1
/usr/local/bin/dufs

1
/usr/local/lib/dufs/start.sh

1
#!/usr/bin/env bash
2

3
set -euo pipefail
4

5
/usr/local/bin/dufs --bind 127.0.0.1 --hidden '.*' --allow-upload --allow-search --allow-hash /www/files

1
sudo chmod +x /usr/local/lib/dufs/start.sh

1
/etc/systemd/system/dufs.service

1
[Unit]
2
Description=dufs
3

4
[Service]
5
User=file
6
Group=file
7
Type=fork
8
ExecStart=/usr/bin/bash /usr/local/lib/dufs/start.sh
9

10
[Install]
11
WantedBy=multi-user.target

1
sudo systemctl daemon-reload
2
sudo systemctl enable --now dufs.service

1
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
2
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
3
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
4
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
5
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
6
sudo apt update
7
sudo apt install caddy

1
sudo systemctl enable --now caddy.service

1
/etc/caddy/Caddyfile

1
# 80 与 3000 端口 HTTP
2
:80, :3000 {
3
    reverse_proxy 127.0.0.1:5000
4
}
5

6

7
# 443 与 3001 端口 HTTPS, 修改 `10.22.33.1` 为你的 IP
8
10.22.33.1:443, 10.22.33.1:3001 {
9
    tls internal
10

11
    reverse_proxy 127.0.0.1:5000
12
}

1
sudo systemctl reload caddy.service

连接 RNDIS 设备#

连接 Linux/Unix 设备#

对于 Linux 和 macOS 等 *nux 操作系统, 请将 Wifi Stick 插入 USB 接口, 后列出网卡及其 IP 地址

如下命令可能仅适用于现代 Linux 操作系统, macOS 请自行查找解决方法 其实是我没钱买 mac

1
ip a

应该可以看到类似如下的设备

1
6: enp0s20f0u8: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UNKNOWN group default qlen 1000
2
    link/ether 22:39:e2:ef:40:d0 brd ff:ff:ff:ff:ff:ff
3
    altname enx2239e2ef40d0

下文的 enp0s20f0u8 均指代网卡名称

激活连接: 对于 NetworkManger 用户, 可以运行如下命令, 以保证当前互联网连接不会被替换, 同时连接两(多)个以太网卡

1
export REGULAR_DEVNAME=<regular-device>
2
export WIFISTICK_DEVNAME=enp0s20f0u8
3
export WIFISTICK_CONNECTION=wifi-stick
4

5
# 在不存在时创建设备 `WIFISTICK_CONNECTION`
6
if ! nmcli connection show "$WIFISTICK_CONNECTION" >/dev/null 2>&1; then
7
    nmcli connection add type ethernet con-name "$WIFISTICK_CONNECTION" ifname "$WIFISTICK_DEVNAME"
8
fi
9

10
# 降低 `WIFISTICK_CONNECTION` 设备的优先级
11
nmcli connection modify "$WIFISTICK_CONNECTION" \
12
    ifname "$WIFISTICK_DEVNAME" \
13
    ipv4.route-metric 200 \
14
    ipv6.route-metric 200
15

16
# 设定当前互联网连接网卡设备至最高优先级
17
nmcli connection modify "$(nmcli -g GENERAL.CONNECTION device show "$REGULAR_DEVNAME")" ipv4.route-metric 0 ipv6.route-metric 0
18

19
# 启动 `WIFISTICK_CONNECTION`
20
nmcli connection up "$WIFISTICK_CONNECTION"

ipv4.route-metric / ipv6.route-metric 是 IPv4 / IPv6 流量权重, 其值越小代表 NetworkManager 更乐意将网路流量使用该连接传输

regular-device 为当前互联网连接网卡设备名, 或者也可以直接将 $(nmcli -g GENERAL.CONNECTION device show "$REGULAR_DEVNAME") 替换为实际连接名称, 如 有线连接 1

最后, 再次使用列出网卡及其 IP 地址的命令, 应该已经可以获取到 IP 地址了

1
> ip a
2

3
6: enp0s20f0u8: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1400 qdisc fq_codel state UNKNOWN group default qlen 1000
4
    link/ether 22:39:e2:ef:40:d0 brd ff:ff:ff:ff:ff:ff
5
    altname enx2239e2ef40d0
6
    inet 10.22.33.91/24 brd 10.22.33.255 scope global dynamic noprefixroute enp0s20f0u8
7
       valid_lft 3538sec preferred_lft 3538sec
8
    inet6 fe80::c29d:e98d:c3cc:6067/64 scope link noprefixroute
9
       valid_lft forever preferred_lft forever

Wifi Stick 连接 WIFI 后速率过慢#

由于 Wifi Stick 仅支持 2.4 Ghz 的 WIFI, 且功率不大, 请尝试关闭周围的蓝牙设备

Emmc 写入过慢#

尝试查看当前闪存调度器

1
cat /sys/block/mmcblk0/queue/scheduler

1
[mq-deadline] kyber none

1
echo none > /sys/block/mmcblk0/queue/scheduler

使用 dd 测试

1
dd if=/dev/zero of=./testfile bs=1M count=100 conv=fdatasync

在使用 mq-deadline 时, 写入速度为 7.9 MB/s, none 为 8.5 MB/s, kyber 为 8.2 MB/s

如果要永久应用一个调度器, 请写入 UDev 规则

1
/etc/udev/rules.d/60-mmc-scheduler.rules

写入

1
# ACTION=="add|change", KERNEL=="mmcblk0", ATTR{queue/scheduler}="<调度器>"
2
ACTION=="add|change", KERNEL=="mmcblk0", ATTR{queue/scheduler}="kyber"

清理磁盘 (emmc) 空间#

1
# 删除孤立依赖包
2
sudo apt autoremove
3

4
# 删除孤立依赖包及其配置文件
5
# sudo apt autoremove --purge
6

7
# 删除 apt 包缓存 (不包括当前版本的包)
8
sudo apt autoclean
9

10
# 删除未使用依赖
11
# 需要先安装 `deborphan`
12
# sudo apt install deborphan
13
sudo apt purge $(deborphan)
14

15
# 限制日志只保留最近 2 天的内容
16
sudo journalctl --vacuum-time=2d
17
# 限制日志占用空间不大于 100M
18
sudo journalctl --vacuum-size=100M

libconfig9 库是 USB 接口配置工具 gc 必要的, 若不小心删除可以重新安装

1
sudo apt install libconfig9

清除 Ruby 残留

1
sudo apt remove ruby ruby-minitest ruby-net-telnet ruby-power-assert ruby-test-unit ruby-xmlrpc ruby2.7-doc rubygems-integration
2
sudo rm -rf /usr/share/ri

清除不需要的语言

1
sudo apt install localepurge
2
sudo localepurge