update nanokvm usb faq

2026-09-11 00:22:49 -05:00 · 2026-01-04 11:28:23 +08:00
parent 47febec6e9
commit 8b13d00da9
2 changed files with 41 additions and 5 deletions
--- a/docs/hardware/en/kvm/NanoKVM_USB/faq.md
+++ b/docs/hardware/en/kvm/NanoKVM_USB/faq.md
@@ -9,14 +9,32 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool

 + This may be due to a missing serial driver. Please reinstall the CH34x driver using the following steps:

-1. Download the driver from the WCH official website (download link: [https://www.wch.cn/download/CH341SER_LINUX_ZIP.html](https://www.wch.cn/download/CH341SER_LINUX_ZIP.html)), extract it, and navigate to the `driver` directory.
-2. Run `uname -r` to check your operating system's release version. Find the corresponding version in (this link)[https://elixir.bootlin.com/linux/v6.2/source/drivers/usb/serial/ch341.c] and copy the content into `ch341.c`.
+1. Download the driver from the WCH official website ([download link](https://www.wch.cn/downloads/CH341SER_LINUX_ZIP.html)), extract it, and navigate to the `driver` directory.
+2. Run `uname -r` to check your operating system's release version. Find the corresponding version in ([this link](https://elixir.bootlin.com/linux/v6.2/source/drivers/usb/serial/ch341.c)) and copy the content into `ch341.c`.
 3. Execute the `make` command to compile the driver.
 4. Run `sudo make load` to install the driver.
 5. Replace the old driver: `cp ch341.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko`.

 + Some Linux distributions come with `brltty`, a Braille display tool that occupies the `/dev/ttyUSB0` serial port, causing the webpage to be unable to detect it. If you are not using `brltty`, it is recommended to uninstall it with `sudo apt remove brltty`.

+### No USB Serial (COMx) Device After Opening Web Page on Windows
+
+ This may be caused by a missing serial driver. Please reinstall the CH34x driver as follows:
+
+    - Download the driver from the WCH official website ([download link](https://www.wch.cn/downloads/CH341SER_EXE.html)), then double-click the installer to run it.
+
+### NanoKVM-USB Device Driver Not Installed on Windows Controlled End
+
+ This may be caused by the USB composite device not being recognized correctly. Please reinstall the driver as follows:
+    - Open `Device Manager` → `Other devices`
+    - Find `NanoKVM-USB` → Right-click `Properties` → `Driver` → `Update Driver`
+    - Select `Browse my computer for drivers` → `Let me pick from a list of available drivers on my computer`
+    - Double-click `Show all devices`
+    - In `Standard USB Host Controller` / `Standard system devices`, find `USB Composite Device` and double-click to install
+    <br>
+
+    > **Note**: The driver location may vary depending on the Windows version. Please search patiently.
+
 ### Poor Video Quality

 + First, check if you're using a USB 2.0 cable/HOST interface. When the resolution is high, USB 2.0 may not provide sufficient bandwidth, which can lower the video quality. It is recommended to use a USB 3.0 cable.
--- a/docs/hardware/zh/kvm/NanoKVM_USB/faq.md
+++ b/docs/hardware/zh/kvm/NanoKVM_USB/faq.md
@@ -9,14 +9,32 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool

 + 可能缺少串口驱动导致,请按照以下方法重新安装CH34x驱动:

-1. 在WCH官网下载驱动(下载地址)[https://www.wch.cn/download/CH341SER_LINUX_ZIP.html]，解压后进入driver目录
-2. 执行`uname -r`查看操作系统发行版本，在(此处)[https://elixir.bootlin.com/linux/v6.2/source/drivers/usb/serial/ch341.c]找到对应的版本，将内容复制到`ch341.c`中
+1. 在WCH官网下载驱动([下载地址](https://www.wch.cn/downloads/CH341SER_LINUX_ZIP.html))，解压后进入driver目录
+2. 执行`uname -r`查看操作系统发行版本，在([此处](https://elixir.bootlin.com/linux/v6.2/source/drivers/usb/serial/ch341.c))找到对应的版本，将内容复制到`ch341.c`中
 3. 执行`make`命令编译驱动
 4. 执行`sudo make load`命令安装驱动
 5. 替换旧驱动:`cp ch341.ko /lib/modlues/$(uname -r)/kernel/drivers/usb/serial/ch341.ko`

 + 部分linux发行版内置了`brltty`,这是一款盲文阅读工具，但会占用/dev/ttyUSB0串口，导致网页检测不到，在确认不使用`brltty`后建议将其卸载`sudo apt remove brltty`

+### Windows 打开网页后无 USB Serial (COMx) 串口设备
+
+ 可能缺少串口驱动导致,请按照以下方法重新安装CH34x驱动:
+
+    - 在WCH官网下载驱动([下载地址](https://www.wch.cn/downloads/CH341SER_EXE.html))，下载后双击运行安装程序
+
+### Windows 被控端出现 NanoKVM-USB 设备驱动程序未被安装
+
+ 可能是 USB 复合设备未被正确识别导致，请按照以下方法重新安装驱动:
+    - 打开 `设备管理器` → `其他设备`
+    - 找到 `NanoKVM-USB` → 右键 `属性` → `驱动程序` → `更新驱动程序`
+    - 选择 `浏览我的电脑以查找驱动程序` → `让我从计算机上的可用驱动程序列表中选取`
+    - 双击 `显示所有设备`
+    - 在 `Standard USB Host Controller` / `标准 USB 主控制器` / `Standard system devices` / `标准系统设备` 中找到 `USB 复合设备 (USB Composite Device)` → 双击安装
+    <br>
+
+    > **注意**：不同版本 Windows 驱动位置可能有所差异，请耐心查找。
+
 ### 打开网页后 NanoKVM-USB 对应串口设备无法打开

 + 可能是部分程序占用该串口，请确认无占用后再试
@@ -29,7 +47,7 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
 ### 视频画质差

 + 首先检查是否使用了 USB2.0 的线缆/HOST接口，当分辨率较大时 USB2.0 不足以提供充足的传输带宽，会被动降低画质，建议选用 USB3.0的线缆
-+ 2K分辨率下首先于芯片编码能力，画质会下降，请切换为1080P使用
+ 2K分辨率下受限于芯片编码能力，画质会下降，请切换为1080P使用
 + 如果 Target 连接的是 Windws主机，请前往系统设置-显示设置-高级显示设置-列出所有模式中更改为 1080P60，并检查`桌面分辨率`和`活动信号分辨率是否一致`

 ### DP-HDMI转接器