USB KVM 常见问题
SuperKVM USB KVM FAQ：无画面排查、免驱说明、U 盘/SD、OTA、权限、环出与客户端兼容性。
USB KVM 常见问题 开篇结论：多数「看不到画面」问题来自线序、HDMI 未插紧或 Host 端摄像头/串口未识别；设备两端新增 USB 设备一般为免驱。下文按场景给出可执行排查步骤，并与 /hardware/usb 互补。 1. 笔记本连接 KVM 设备后, 浏览器无法看到远程桌面？ 排查步骤： 重新检查和插拔线材, 按照先 host 后 target 的顺序操作, 先插 host usb 线, 再插 target usb 线和 hdmi input, hdmi 线一定要插紧, 否则就看不到远程桌面 观察 LED, 根据 LED 状态 初步判断问题 确认 Host 主机端的 camera 和 uart 硬件驱动是否成功（LOOP 和 USB 以及 Pro 版本的 VID PID 以及设备名称有微小差异, 需要自己甄别, 特别是自己修改过 vid pid 的情况）: 苹果系统：左上角苹果 logo 》关于本机 》更多信息 》系统报告 》USB windows: 我的电脑 》管理 》设备管理器 linux(ubuntu): a. 确认摄像头：sudo apt install guvcview, 然后点击 guvcview, 确认设备列表中是否有 usb video 相关设备 b. 确认串口： ls la /dev/ttyACM0 , 如果存在设备, 则说明 usb 转串口硬件驱动设备正常 c. 确认 usb camera： ls la /dev/video , 一般是 video0 和 video1 设备, 默认我们使用 video0 d. 如果是 ubuntu 之类的系统, 当前用户要加入 video 和 dialout 组, sudo usermod a G dialout $USER 否则无法访问摄像头和串口设备；更改组后需要重启登录才能生效；如果还是不行, 就要升级驱动： apt install linux firmware e. 其他可能的尝试： 如果硬件是正常的, 还是无法显示桌面, 则排查软件： 关闭 chrome（优选 chrome 浏览器）, 重新开启 检查后台是否有异常的 chrome 进程, 如果有则手动退出 如果有提示权限问题, 请按照提示开启摄像头和串口访问权限 2. usb 设备连接 host 主机后, 主机识别到的是什么设备？ usb hub, usb 摄像头, CDC 串口, usb 读卡器（可选） 3. usb kvm 设备连接 target 目标机后, 目标机识别到的是什么设备？ usb hub, 键盘, 鼠标, usb 读卡器（可选） 4. 使用 usb kvm 设备, 电脑端需要安装什么驱动？ 接入 kvm 设备后, 目前 Host 主机端和 Target 目标机端新增的设备都是免驱的, 所以不需要安装驱动, 插上即可使用 5. sd 怎么用？ 如果不需要装系统和中转资料, 可以不用插 sd 卡 kvm 硬件上实现了 sd 读卡器, sd 插入后会被识别成 u 盘, 速度是 usb2.0, target 端和 host 都是 2.0 的读取速度, 即使 loop 版本是 3.0 的 usb 接口和 hub, 因为读卡器芯片是 2.0 的, 所以 3.0 的 host 读取 sd 的速度也是 usb2.0 的速度 6. sd 怎么装系统？ 需要先把 sd 放入 usb 读卡器, 用 U 盘启动盘制作软件比如 ventoy, 制作成 usb 启动盘, 然后把需要安装 iso 放进启动盘就可以, 系统会识别成 usb 启动盘, 注意安装系统时, 要正确切换 u 盘方向 7. loop 设备可以用在 switch 上吗？ 可以 8. loop 设备可以不接环出显示器吗？ 可以 9. 目前网页客户端可以实现粘贴中文, 图片和传文件吗？ 不可以, 目前只可以单向从 host 向 target 粘贴英文, 需要等待实现双向粘贴板特性后才可以 10. 可以修改 kvm 所产生的 usb hub 的 vid pid 吗？ 不可以 11. loop 版本环出的分辨率如何控制？ 最大支持 4k@60hz, 具体要看主机输出的最大能力, 环出跟随输入信号 12. 目前都有哪些客户端类型？ 已经在跟进的有浏览器 web 端, windows 版, mac 端, 在规划的有 ios, 安卓 app 13. 为什么需要插入 target 机器的 hdmi 后, host 端才能识别到 usb 摄像头？ 因为目前采集卡芯片是由 hdmi 供电的, 这样设计的目的是为了减小 host 端的 usb 供电电流要求, 提高 usb 电源稳定性, 保护端口, 对于一些旧电脑, usb 供电能力不足, 避免 usb 异常死机, 但是这个机制随时可能会调整, 目前硬件版本是 1 暂时是这样 14. 设备长时间工作, 表面温度最高能达到多少度？ 大概 40 45 摄氏度左右 15. 设备连接时的推荐连接次序？ host usb host HDMI target HDMI target usb 16. 目前有哪些按键无法起作用？ scrcpy, menu, 这些按键会被主机优先拦截, 暂时 web 客户端无法捕捉传递 17. ota 失败后怎么办？ 可以反复升级, 偶尔失败没关系, 系统是双分区, 升级失败不影响 18. 浏览器怎么选？ 优先推荐 chrome, 因为 chrome 对串口的支持最好 19. 可以支持手机和平板作为 host 控制其他机器吗？ host 端是有机会支持手机和平板 app 的, 需要等待蓝牙配件和 app 客户端 20. kvm 可以控制安卓和 ios 手机和 ipad 平板吗？ 目前测试部分安卓可以支持, ios 和 ipad 暂时没有支持计划, 需要客户自己测试研究, 未来有时间了再给出官方确认 21. kvm 如何作为采集卡使用？ 配合 OBS 客户端就可以实现采集卡的功能 22. 浏览器权限需要开启哪些权限？ 只需要画面：摄像头 画面和声音：摄像头, 声音, mic, 为什么要开启 mic 权限, 这个是 chrome 的限制, 底层没有区分是 UAC 还是 MIC 作为音频设备, 所以必须开启 mic 权限, 才能正常操作音频设备, 播放声音 23. kvm 目前可以获取 target 机器的声音吗？ 可以, 需要开启和设置：1）声音和 mic 权限；2）target 端的播放源；3）host 端的音频输入源 target 端的设置 mac host 端的音频源设置 windows host 端的音频源设置 24. 鼠标相对坐标模式为什么感觉卡顿？ 因为 hid 相对模式的坐标范围每次只能允许 127 127 的范围, 这就导致鼠标移动过快时, 变成无效坐标, 实际的回报率下降, 用户就感觉到卡顿 25. TF 卡对应的 U 盘的读写速度是多少？ usb2.0 的标准读写速率 26. 鼠标相对坐标模式既然卡顿, 那么保留其有什么用？ 如果 target 是移动设备比如手机 平板时, 或者你想操控 target pc 的副屏时, 就必须用相对坐标模式 27. 是否可以开发票？ 可以, 默认普通电子发票, 明细如实填写 28. windows web 离线版点击 exe, 无法运行？ 需要运行 bat 文件而不是 exe 29. 未来是否可以支持：1） 平板手机做 host. 2） 平板手机做 target. 3）使用 2.4G 无线和 target 相连？ 可以, 需要等后继的开发
Canonical: https://wiki.superkvm.com/guide/usb-faq · Marketing: https://www.superkvm.com · GitHub: https://github.com/superkvm