配置 RNDIS#

1. 修改如下脚本

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

1
/usr/sbin/mobian-usb-gadget

在 setup() 函数中, 在 # Setting Up Adbd 前添加如下命令, 便于 Windows 识别为 RNDIS 设备

1
# 复合设备是为了 ADB 也可以连接
2
echo 0xEF > $CONFIGFS/bDeviceClass
3
echo 0x02 > $CONFIGFS/bDeviceSubClass
4
echo 0x01 > $CONFIGFS/bDeviceProtocol

并在上方命令后方添加如下代码块中任意其一

• 1. 如下为 Google 的 RNDIS 设备生产商和产品 ID, 兼容性最好

  1
  echo 0x18d1 > $CONFIGFS/idVendor
  2
  echo 0x4ee4 > $CONFIGFS/idProduct
  

  2. 如下为 Microsoft 的 RNDIS 设备生产商和产品 ID, 兼容性其次

  1
  echo 0x045E > $CONFIGFS/idVendor
  2
  echo 0x0301 > $CONFIGFS/idProduct
  

  3. 如下为 Linux 的 RNDIS 设备生产商和产品 ID, 可能存在兼容性问题

  1
  echo 0x1d6b > $CONFIGFS/idVendor
  2
  echo 0x0104 > $CONFIGFS/idProduct
  

2. 编辑如下 NetworkManager 配置脚本

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

1
/usr/sbin/mobian-setup-usb-network

将下面的 IP 和网段改为你要的

1
nmcli connection add con-name USB \
2
                        ifname usb0 \
3
                        type ethernet \
4
                        ip4 10.22.33.1/24

并在 if 的最后添加如下命令设置 USB 接口 IP, 注意网段与上方配置一致

1
sleep 1
2
ip link set usb0 up
3
ip addr add 10.22.33.1/24 dev usb0 2>/dev/null

3. 禁用 NetworkManager USB 接口的配置

1
sudo mv /etc/NetworkManager/system-connections/USB.nmconnection /etc/NetworkManager/system-connections/USB.nmconnection.bak

NOTE

若 NetworkManager 配置文件禁用了对 USB 接口的管理, 会使得配置无效
请检查如下文件

1
/etc/NetworkManager/NetworkManager.conf

是否含有如下内容 (若有请删除)

1
unmanaged-devices=interface-name:usb0

4. a 连接 Windows 设备

此时将 Wifi Stick 插入 Windows 设备的 USB 接口, 应该可以在 Windows 侧看到一个驱动未安装 (代码: 28) 的 RNDIS 设备 (位于 其他设备 类别)

双击该设备, 单击 “更新驱动程序” > “浏览我的电脑以查找驱动程序” > “让我从计算机的可用驱动程序列表中选取” > 在 “常见硬件类型” 内选择 “网络适配器” > 厂商选择 “Microsoft”, 型号选择最下面的 “远程 NDIS 兼容设备” (Windows 7 操作系统厂商选择 “Microsoft Corporation”, 型号选择 “Remote NDIS Compatible Device”) > “下一页” > “是” (强制安装驱动程序)

此时, 可以看到 Windows 弹出一个新的网络连接, 也新增了一个网络适配器, 并获取到了 IP 地址

如果无法获取 IP 地址, 请尝试在 Wifi Stick 安装 Dnsmasq (不需要手动启用服务, 会由 NetworkManager 调起), 使用

1
sudo apt install dnsmasq

如此, 便配置成功了. 您可以使用 10.22.33.1:<port> 访问任意部署于 Wifi Stick 的服务了

如果在 Windows 设备上无法安装驱动程序, 或在安装驱动程序后显示该设备需要进一步安装驱动程序, 请参阅 故障排除 - 部分高版本-windows-10-操作系统无法安装-rndis-驱动并连接

4. b 连接 *nux 设备

对于 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
nmcli device connect enp0s20f0u8

上述命令会将当前的激活网卡切换为该网卡, 导致当前以太网连接中断
要同时连接两(多)个以太网卡, 请使用

1
nmcli connection add type ethernet con-name wifi-stick ifname enp0s20f0u8 ipv4.route-metric 200 && nmcli connection up wifi-stick

最后, 再次使用列出网卡及其 IP 地址的命令, 应该已经可以获取到 IP (你设置的 10.22.33.0/24) 地址了

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

[可选] 配置 Dnsmasq#

为了避免需要记忆 Wifi Stick IP, 可以修改 Dnsmasq 的配置进行 Hosts, 从而使用例如 stick.local 访问 Wifi Stick 的服务

1. 创建配置文件

1
sudo mkdir -p /etc/NetworkManager/dnsmasq.d/

后, 可以在该文件夹下写入配置. 例如, 要将 stick.local Hosts 到 10.22.33.1, 可以在

1
/etc/NetworkManager/dnsmasq.d/stick-hosts.conf

写入

1
address=/stick.lan/10.22.33.1
2
address=/stick.local/10.22.33.1
3

4
# 同时也可以指定 `stick.local` 不转发到上游 DNS 服务器
5
# local=/stick.lan/
6
# local=/stick.local/

要绑定 MAC 地址

1
dhcp-host=<mac-address>,<ip-address>,<rent>
2

3
# 例如: dhcp-host=AA:BB:CC:DD:EE:FF,10.22.33.100,8h

设置上游 DNS

1
# Google Public DNS
2
server=8.8.8.8
3

4
# ignore `/etc/resolv.conf`
5
no-resolv

部分 NetworkManager 时会使用内部的 internal DHCP/DNS 处理器, 因此需要在

1
/etc/NetworkManager/NetworkManager.conf

写入

1
[main]
2
dns=dnsmasq

方可生效 (记得重启 NetworkManager)

2. 重启 NetworkManager 上述命令须在重启 NetworkManager 后生效

1
sudo systemctl restart NetworkManager

故障排除#

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

1
[mq-deadline] kyber none

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

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

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"

网速测试#

使用 iperf3 单线程测试, 可以跑道 100 Mbps 左右

1
C:\Users\->iperf3 -c 10.22.33.1 -P 1 -R
2
Connecting to host 10.22.33.1, port 5201
3
Reverse mode, remote host 10.22.33.1 is sending
4
[  5] local 10.22.33.136 port 10873 connected to 10.22.33.1 port 5201
5
[ ID] Interval           Transfer     Bitrate
6
[  5]   0.00-1.00   sec  10.0 MBytes  83.7 Mbits/sec
7
[  5]   1.00-2.00   sec  10.9 MBytes  91.2 Mbits/sec
8
[  5]   2.00-3.00   sec  10.9 MBytes  91.2 Mbits/sec
9
[  5]   3.00-4.00   sec  10.9 MBytes  91.2 Mbits/sec
10
[  5]   4.00-5.00   sec  10.9 MBytes  91.2 Mbits/sec
11
[  5]   5.00-6.00   sec  11.0 MBytes  92.3 Mbits/sec
12
[  5]   6.00-7.00   sec  10.9 MBytes  91.2 Mbits/sec
13
[  5]   7.00-8.00   sec  10.9 MBytes  91.2 Mbits/sec
14
[  5]   8.00-9.00   sec  11.0 MBytes  92.3 Mbits/sec
15
[  5]   9.00-10.00  sec  10.8 MBytes  90.2 Mbits/sec
16
- - - - - - - - - - - - - - - - - - - - - - - - -
17
[ ID] Interval           Transfer     Bitrate         Retr
18
[  5]   0.00-10.00  sec   109 MBytes  91.1 Mbits/sec    0            sender
19
[  5]   0.00-10.00  sec   108 MBytes  90.6 Mbits/sec                  receiver
20

21
iperf Done.

BTW, 清理磁盘 (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 网桥必要的, 若不小心删除可以重新安装

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

故障排除#

1
/usr/sbin/mobian-usb-gadget

1
# 将其改为单功能网络设备类
2
echo 0x02 > $CONFIGFS/bDeviceClass
3
echo 0x00 > $CONFIGFS/bDeviceSubClass
4
echo 0x00 > $CONFIGFS/bDeviceProtocol

1
echo 0x045E > $CONFIGFS/idVendor
2
echo 0x0301 > $CONFIGFS/idProduct

1
# Setting Up Adbd
2
gc -a ffs
3
mkdir -p /dev/usb-ffs/adb
4

5
# in offical version of gc name will be ffs.x
6
mount -t functionfs adb /dev/usb-ffs/adb
7

8
# Fire Up Adbd
9
adbd -D &
10
# (hack) wait adbd setup
11
sleep 1

1
sudo systemctl restart mobian-usb-gadget.service
2
# or
3
# sudo reboot

1
sudo mv /usr/sbin/mobian-usb-gadget /usr/sbin/mobian-usb-gadget.bak
2
sudo vim /usr/sbin/mobian-usb-gadget
3
sudo chmod +x /usr/sbin/mobian-usb-gadget

1
#!/bin/sh
2

3
CONFIGFS=/sys/kernel/config/usb_gadget/g1
4

5
setup() {
6
    echo "[+] Setting up RNDIS gadget..."
7

8
    modprobe libcomposite
9

10
    # 清理旧配置
11
    if [ -d $CONFIGFS ]; then
12
        echo "" > $CONFIGFS/UDC 2>/dev/null
13
        rm -rf $CONFIGFS
14
    fi
15

16
    mkdir -p $CONFIGFS
17
    cd $CONFIGFS || exit 1
18

19
    # ===== 基本设备信息 =====
20
    echo 0x1d6b > idVendor        # Linux Foundation
21
    echo 0x0104 > idProduct       # Multifunction Gadget
22

23
    echo 0xEF > bDeviceClass
24
    echo 0x02 > bDeviceSubClass
25
    echo 0x01 > bDeviceProtocol
26

27
    mkdir -p strings/0x409
28
    echo "1234567890" > strings/0x409/serialnumber
29
    echo "Armbian" > strings/0x409/manufacturer
30
    echo "RNDIS Ethernet" > strings/0x409/product
31

32
    # ===== 配置 =====
33
    mkdir -p configs/c.1
34
    mkdir -p configs/c.1/strings/0x409
35
    echo "RNDIS" > configs/c.1/strings/0x409/configuration
36
    echo 120 > configs/c.1/MaxPower
37

38
    # ===== RNDIS =====
39
    mkdir -p functions/rndis.usb0
40

41
    # MAC 地址 (请修改)
42
    echo "02:XX:XX:XX:XX:XX" > functions/rndis.usb0/dev_addr
43
    echo "02:XX:XX:XX:XX:XX" > functions/rndis.usb0/host_addr
44
    # echo "02:AA:BB:CC:DD:01" > functions/rndis.usb0/dev_addr
45
    # echo "02:AA:BB:CC:DD:02" > functions/rndis.usb0/host_addr
46

47
    # ===== Windows 关键：OS Descriptor =====
48
    mkdir -p os_desc
49
    echo 1 > os_desc/use
50
    echo 0xcd > os_desc/b_vendor_code
51
    echo MSFT100 > os_desc/qw_sign
52

53
    mkdir -p functions/rndis.usb0/os_desc/interface.rndis
54
    echo RNDIS > functions/rndis.usb0/os_desc/interface.rndis/compatible_id
55
    echo 5162001 > functions/rndis.usb0/os_desc/interface.rndis/sub_compatible_id
56

57
    # ===== 绑定 =====
58
    ln -s functions/rndis.usb0 configs/c.1/
59
    ln -s configs/c.1 os_desc
60

61
    # ===== 启动 =====
62
    UDC=$(ls /sys/class/udc | head -n 1)
63
    echo $UDC > UDC
64

65
    echo "[+] RNDIS gadget started"
66
}
67

68
reset() {
69
    echo "[+] Removing USB gadget..."
70

71
    if [ -d $CONFIGFS ]; then
72
        echo "" > $CONFIGFS/UDC 2>/dev/null
73
        rm -rf $CONFIGFS
74
    fi
75
}
76

77
case "$1" in
78
    setup) setup ;;
79
    reset) reset ;;
80
    *) echo "Usage: $0 {setup|reset}" ;;
81
esac