5.3 Type-C 闪连失败

典型现象

桌面客户端 添加设备 选择 "Type-C 闪连" 后：

• 状态卡在"等待 USB 网卡"
• 状态卡在"IP 配置失败"
• 闪连成功但 SSH 无法连接 192.168.128.10

快速判断

打开系统的 USB / 网络设备列表：

• Windows：设备管理器 → 网络适配器
• macOS：系统信息 → USB

根据看到的内容判断：

观察到	原因
完全没有 USB 网卡	数据线问题（90% 是这个），换一根数据线
网卡出现但显示"未连接"	板端未启动 RNDIS，或镜像不是 RDK 官方镜像
网卡已连接但 SSH 失败	PC 侧 IP 未配对，应为 192.168.128.100/24

排查清单

1. 网卡未列出

   Type-C 数据线中很多只能充电不传数据。更换为 USB 3.0、5A、全功能的数据线。断电板端后重新拔插，点击 Studio 内的 刷新。

2. 板端镜像

   Type-C 闪连依赖 RDK 官方镜像出厂预配置的 192.168.128.10/24 固定 IP。第三方镜像需要自行启用 RNDIS：

   sudo systemctl enable usb0-static --now

3. PC 侧 IP

   桌面客户端会自动请求管理员权限给 USB 网卡配置 192.168.128.100/24。UAC 弹窗点"是"或输入 sudo 密码。如果错过了权限请求，重启 Studio 并重新选择"Type-C 闪连"。

4. 网卡显示"未连接"

   板端可能还在启动，等待 30 秒后点击 刷新 按钮。

根本原因

Type-C 闪连基于 USB CDC RNDIS / NCM 协议模拟以太网。完整链路：

PC USB driver → USB cable (数据模式) → 板端 USB device controller
  → RNDIS gadget → kernel netif (usb0) → sshd

任何一段断开都会失败。按优先级怀疑：

1. 数据线（最常见，换线解决）
2. 板端镜像缺失 RNDIS 配置（换官方镜像）
3. PC 防火墙拦截（少见）

永久解决

• 准备一根贴有"调试专用"标签的全功能数据线
• 给桌面客户端授予"永久允许修改网络配置"权限
• 团队大量使用时，让运维统一使用 RDK 官方镜像