Use a single USB-C cable to transfer data between RaspberryPi 4B and iPad 仅仅使用一根USB-C to C的数据线来连接树莓派和iPad等设备,方便在外出等网络不方便的地方连接使用 可以使用和Wi-Fi连接时的全部功能,包括但不限于:80端口网站,22端口SSH等其他任何服务
ECM/NCM的支持在Linux/(类)Unix比较好,可以做到即插即用的水平。在Android/HarmonyOS/Windows上需要对应的驱动(待完成) RNDIS在Android与Windows支持较好,可以参阅这篇文章完成配置(未验证)
- 由于个人开发,没有足够的测试设备,可能会遇到不可预知的问题,烦请在Issue提出。
- 方法来源:https://www.yuque.com/docs/share/37a2beac-f1db-4437-b5b8-117164af4dab?#
- GitHub初来乍到,如果有什么意见或者建议,感谢提出!
功能实现演示:
https://www.bilibili.com/video/BV1GF411v7R6/
- 成本为零,适用面广:
(削除) 无论是USB3.0还是USB2.0的USB-C皆可;iPad(USB-C接口)、笔记本电、甚至安卓手机\平板,都适用 (削除ここまで)当前遇到了一些问题,目前仅支持Apple的带有USB-C的设备(iPad、Mac),在连接安卓、鸿蒙、Windows设备时,无法自动识别并完成配置,我们仍然在寻找解决办法,也欢迎各位在GitHub讨论。 - 操作简单,可靠性高:每一次连接无需任何额外操作,连接即可;外出无需为手机热点无法连接而束手无策。
- 功能全面:可以实现本地局域网的全部功能,无论是SSH终端还是VNC桌面,抑或是本地网页,都可以访问。
- 「副作用」小:树莓派可以在有线连接的基础上使用Wi-Fi上网,不冲突。
- 树莓派4B
- 带有USB-C的iPad(iPad Pro 2018、2020、2021;iPad Air 4)或~~~其他带有USB-C的电脑、手机、安卓/鸿蒙平板~~~
已经测试且能够成功访问:
iPad Air 4(USB3.0);MacBook Pro 2021(Thunderbolt4/USB4)(我自己没有足够的设备完成测试,欢迎大家测试后在Issue放出结果)
建议使用手动配置,自动配置可能会遇到无法分配IP的问题
git clone https://github.com/TANG617/RaspberryPi-One-Wire.git
cd RaspberryPi-One-Wire
chmod +x ./raspi_usb_c.sh
sudo ./raspi_usb_c.sh- 在
/boot/config.txt末尾写入dtoverlay=dwc2。 - 在
/boot/cmdline.txt末尾写入modules-load=dwc2。 - 在
/etc/modules末尾写入libcomposite。 - 在
/etc/dhcpcd.conf末尾写入denyinterfaces usb0。 - 安装dnsmasq,
sudo apt-get install dnsmasq。 - 创建
/etc/dnsmasq.d/usb,并写入
interface=usb0 dhcp-range=10.55.0.2,10.55.0.6,255.255.255.248,1h dhcp-option=3 leasefile-ro
- 创建
/etc/network/interfaces.d/usb0,并写入
auto usb0 allow-hotplug usb0 iface usb0 inet static address 10.55.0.1 netmask 255.255.255.248
- 创建
/root/usb.sh,并写入
#!/bin/bash cd /sys/kernel/config/usb_gadget/ mkdir -p pi4 cd pi4 echo 0x1d6b > idVendor # Linux Foundation echo 0x0104 > idProduct # Multifunction Composite Gadget echo 0x0100 > bcdDevice # v1.0.0 echo 0x0200 > bcdUSB # USB2 echo 0xEF > bDeviceClass echo 0x02 > bDeviceSubClass echo 0x01 > bDeviceProtocol mkdir -p strings/0x409 echo "fedcba9876543211" > strings/0x409/serialnumber echo "Ben Hardill" > strings/0x409/manufacturer echo "PI4 USB Device" > strings/0x409/product mkdir -p configs/c.1/strings/0x409 echo "Config 1: ECM network" > configs/c.1/strings/0x409/configuration echo 250 > configs/c.1/MaxPower # Add functions here # see gadget configurations below # End functions mkdir -p functions/ecm.usb0 HOST="00:dc:c8:f7:75:14" # "HostPC" SELF="00:dd:dc:eb:6d:a1" # "BadUSB" echo $HOST > functions/ecm.usb0/host_addr echo $SELF > functions/ecm.usb0/dev_addr ln -s functions/ecm.usb0 configs/c.1/ udevadm settle -t 5 || : ls /sys/class/udc > UDC ifup usb0 service dnsmasq restart
- 将
/root/usb.sh设置为可执行,chmod +x /root/usb.sh。 - 在
/etc/rc.local文件的exit 0之前添加/root/usb.sh。 - 重新启动树莓派