玩家社区
← 返回用户指南

Troubleshooting

疑难杂症 · 常见问题排查

连接异常、驱动失败、固件问题等快速排查

分类一：网络连接问题

问题：Ping 不通设备 IP

适用产品：8K全协议 / 高配版 / 1K网口

现象：副机 Ping 192.168.2.188 超时或请求失败

原因：IP 末位与设备屏幕冲突、网卡驱动未装完，或网线/接口接触不良

解决步骤

  1. 确认网口已接副机，设备屏幕显示 IP（如 192.168.2.188）
  2. 在副机网络设置中修改 IP 为同网段不同末位（例：192.168.2.123）
  3. 网段前缀不可更改，仅可修改最后一位
  4. 使用 Ping 小工具或命令行测试通信
Ping 测试成功截图

注意

若 Ping 仍失败，请重新插拔网线与 USB 供电后再试。

相关链接：1K网口教程 · 工具下载

问题：KM Net 软件显示连接失败

适用产品：8K全协议 / 高配版 / 1K网口

现象：软件内填写 IP / PORT / UUID 后仍无法连接

原因：驱动未就绪、IP 配置错误或设备未进入正常工作状态

解决步骤

  1. 先完成网卡驱动安装，确认出现「网络连接测试」成功界面
  2. 按设备屏幕显示填写 IP、端口与 UUID，注意不要有多余空格
  3. 断开全部线缆等待 10 秒后重新连接，再尝试连接
  4. 仍失败请重启副机后重试
网络连接测试

相关链接：8K 网络教程 · 高配版教程

分类二：串口与驱动问题

问题：CH343 串口驱动装不上

适用产品：1K串口 / 8K串口协议

现象：设备管理器无 COM 口，或驱动安装报错

原因：系统残留旧驱动、USB 口供电不足或线材仅充电不传数据

解决步骤

  1. 更换主板直连 USB 口（避免 HUB 或前置面板）
  2. 卸载设备管理器中带叹号的旧 COM 设备后重新安装 CH343 驱动
  3. 换用包装内附赠数据线
  4. 安装完成后在设备管理器中确认 COM 口号

注意

串口版需先完成透传/接线教程中的前置步骤，再排查驱动。

相关链接：1K串口教程 · 工具下载

问题：MAKCU / Ferrum 连接失败

适用产品：8K全协议 / 1K串口（串口协议）

现象：软件内无法连接开发板

原因：串口驱动未安装，或未切换至与软件匹配的命令协议

解决步骤

  1. 打开设备管理器 →「端口（COM 和 LPT）」，确认是否出现 CH340 或 CH343 串口设备
  2. 若无 COM 口，请先安装 CH340 / CH343 驱动（可参考上方「CH343 驱动装不上」）
  3. 若 COM 口已正常识别，进入「开发板配置」页面，将「命令协议」切换为与所用软件一致（MAKCU 或 Ferrum）
  4. 协议切换后立即生效并持久化，无需重启；返回软件重新连接即可

注意

MAKCU 为默认协议，兼容大多数上位机；若软件要求 Ferrum API（如 km.version() 返回 kmbox: Ferrum），需切换为 Ferrum 模式。

相关链接：开发板配置 · 8K 教程 · 1K串口教程

问题：鼠标透传失败 / 移动无反应

适用产品：8K全协议 / 1K网口（透传固件）

现象：主机端鼠标无移动，或软件无法建立底层通信

原因：透传步骤未完成、等待时间不足或中途操作了鼠标

解决步骤

  1. 按教程完成「鼠标身份透传」或「设备身份复制」全流程
  2. 等待期间（约 10 秒）请勿移动或点击鼠标
  3. 透传完成后保持鼠标连接，再接入副机侧协议
  4. 更换鼠标后需重新执行一遍透传流程

相关链接：8K 教程 · 1K网口教程

分类三：固件与设备异常

问题：固件更新后设备无反应

适用产品：全系列

现象：烧录完成后屏幕不亮、无法识别或反复重启

原因：固件型号选错、烧录中断或 USB 供电不稳

解决步骤

  1. 确认所选固件与硬件型号完全一致
  2. 烧录过程中勿拔线，使用稳定 USB 口重新烧录
  3. 参考固件烧录指南中的「恢复 / 重刷」章节
  4. 仍无法恢复请联系官方社群协助

警告

自行刷写非对应型号固件可能导致设备无法启动，请务必核对版本。

进阶：烧录前检查清单（点击展开）
  • 确认电脑已安装对应烧录工具与驱动
  • 确认设备进入烧录模式（按教程按住/短接指定引脚）
  • 关闭可能占用串口的其他软件
  • 建议使用包装内数据线，避免过长劣质线

相关链接：固件烧录指南 · 官方社群