2.3.1 通过 Type-C 接入（RDK X5）

适用范围

Type-C 接入是 RDK X5 上最快的设备接入方式：一根 Type-C 数据线即可让 PC 与板端互通，无需路由器，无需手动配置 IP。该方式仅支持 RDK X5；其他板型请使用 SSH 接入 或 串口接入。

底层基于 USB CDC RNDIS 协议：板端的 USB Device Controller 将自身模拟为以太网卡，PC 端识别后会出现一张虚拟 USB 网卡，PC 与板端通过该网卡通信，效果等同于两台设备通过网线直连。

前置条件

项目	要求
板型	RDK X5（含 4G / 8G 内存版本）
数据线	全功能 Type-C 数据线（具备数据传输能力，常见手机充电线仅支持充电不能传数据）
板端镜像	RDK 官方镜像或保留 RNDIS 配置的自定义镜像
Studio 客户端	桌面客户端（已登录）
PC 操作系统权限	管理员（首次接入时需要为虚拟网卡配置 IP）

操作步骤

第 1 步：物理连接

使用全功能 Type-C 数据线连接 PC 与 RDK X5 的 Type-C 接口。板端启动后约 5~10 秒内 PC 应能识别到 USB 虚拟网卡。

如果 PC 未出现 USB 网卡，最常见原因是数据线仅支持充电（无数据传输能力）。建议为开发场景准备一根贴有"调试专用"标签的全功能数据线。

第 2 步：在 Studio 中选择 Type-C 接入

打开 RDK Studio 桌面客户端，点击顶部 添加设备，在弹窗中选择 Type-C 闪连。Studio 会扫描 PC 上的 USB 网卡，已识别到的网卡通常显示为 RNDIS 或 Ethernet adapter (USB)。

如果列表中存在多张网卡，Studio 会高亮推荐的匹配项。选中该项后进入下一步。

第 3 步：自动配置 IP

确认目标网卡后，桌面客户端会自动为该 USB 虚拟网卡配置静态 IP 192.168.128.100/24。该操作需要管理员权限：

• Windows：弹出 UAC 对话框，点击 是 即可
• macOS：弹出 sudo 提权对话框，输入用户密码
• Linux：弹出 polkit 提权对话框

完成 IP 配置后，Studio 进入下一步。

第 4 步：自动建立 SSH 连接

Studio 使用以下默认凭据建立 SSH 会话：

字段	默认值
板端 IP	192.168.128.10（出厂预设，固定）
用户名	root
密码	root

连接成功后，板端会出现在顶栏的"当前设备"下拉框中，并自动激活为当前操作的目标设备。同时 Studio 后台会执行设备探测，识别板的型号、镜像版本、CPU/RAM 等信息。

IP 地址规则

Type-C 接入场景下使用固定的子网 192.168.128.0/24：

端	IP 地址
PC 侧（USB 虚拟网卡）	192.168.128.100/24
板端（usb0 接口）	192.168.128.10/24

请勿修改这两个地址。AI Dock 中的故障诊断与自动修复模板均依赖这一约定。

拔插后的处理

拔出 Type-C 数据线后再次插入时，PC 通常会重新枚举 USB 虚拟网卡，IP 配置会自动恢复。在 Studio 中点击 刷新 按钮可重新触发设备扫描。

如果重新插入后 IP 未自动恢复（部分操作系统的网卡管理策略不同），重复第 3 步即可。

常见问题

现象	可能原因	解决方法
PC 未出现 USB 网卡	数据线仅支持充电	更换全功能数据线
USB 网卡显示"未连接"	板端未启动 RNDIS 或镜像非官方	等待板端启动完成；确认镜像版本
USB 网卡已连接但 SSH 失败	PC 侧 IP 未配对	重启 Studio，确认 IP 配置弹窗已批准
桌面客户端未弹出权限请求	客户端未以管理员身份运行	关闭 Studio，右键以管理员身份重新启动

完整的故障排查清单见 5.3 Type-C 闪连失败。

后续操作

完成 Type-C 接入后，建议为板端配置 WiFi（2.4 配置网络），以便在拔出数据线、需要远程操作时仍可通过无线网络访问。