From e4ea9aebe3b25646247e82f2184a10e330c2d0f5 Mon Sep 17 00:00:00 2001 From: BuGu <62454025+Z2Z-GuGu@users.noreply.github.com> Date: Fri, 16 Jan 2026 10:55:49 +0800 Subject: [PATCH] Update NanoKVM-USB doc --- docs/hardware/en/kvm/NanoKVM_USB/faq.md | 29 +++++++++++++++++++------ docs/hardware/zh/kvm/NanoKVM_USB/faq.md | 13 +++++++++++ 2 files changed, 35 insertions(+), 7 deletions(-) diff --git a/docs/hardware/en/kvm/NanoKVM_USB/faq.md b/docs/hardware/en/kvm/NanoKVM_USB/faq.md index 9a266a58..ec4a1123 100644 --- a/docs/hardware/en/kvm/NanoKVM_USB/faq.md +++ b/docs/hardware/en/kvm/NanoKVM_USB/faq.md @@ -40,12 +40,6 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool > **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. -+ At 2K resolution, the video quality may decrease due to the chip's encoding capability. Please switch to 1080P. -+ If the target device is connected to a Windows host, go to System Settings > Display Settings > Advanced Display Settings, and change to 1080P60 in the "List all modes" section. Also, check if the "Desktop Resolution" and "Active Signal Resolution" are consistent. - ### Unable to Open NanoKVM-USB Corresponding Serial Device After Opening Web Page + This may be due to other programs occupying the serial port. Please ensure it is not in use before trying again. @@ -53,6 +47,27 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool + The Chrome browser may not have detected the serial port. Please refresh the webpage or restart Chrome. + Chrome may lack sufficient permissions. Please grant the necessary permissions. +## Video Issues + +### Color Abnormalities in Loop-Out/Capture on Some Host BIOS + ++ Early firmware versions of the NanoKVM-USB may cause the loop-out image to appear reddish and the captured image to appear greenish on certain BIOS. This issue can be resolved by flashing a new firmware. Please download the flashing tool and firmware first: [Firmware Download Link](https://dl.sipeed.com/fileList/KVM/NanoKVM_USB/MS2131_LIB_V2_0_27_Demo_GPIO0_PlugDetect_20251205_replaced_E158EDID.bin), [Flashing Tool Download Link](https://dl.sipeed.com/fileList/KVM/NanoKVM_USB/MS_USB3_0_UpgradeTool_V1_3_2.exe) + ++ Flashing Steps: +1. Open the flashing tool and select the downloaded firmware file. +2. Connect the USB-C port on the NanoKVM-USB host side to your computer. +3. Wait for the tool to detect the device, then click "Start Flashing" and wait for the process to complete. + +> **Do not disconnect the NanoKVM-USB during the flashing process, as this may brick the device.** +> The flashing tool only supports Windows. +> Currently, flashing is not supported for the NanoKVM-USB (4K) version. + +### 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. ++ At 2K resolution, the video quality may decrease due to the chip's encoding capability. Please switch to 1080P. ++ If the target device is connected to a Windows host, go to System Settings > Display Settings > Advanced Display Settings, and change to 1080P60 in the "List all modes" section. Also, check if the "Desktop Resolution" and "Active Signal Resolution" are consistent. + ### DP-HDMI Adapter + Some passive DP to HDMI converters only perform level conversion in their internal circuitry, resulting in poor compatibility with NanoKVM-USB. This manifests as the video signal not appearing when waking from sleep; the NanoKVM-USB still shows a black screen, requiring manual unplugging and replugging of the HDMI cable. @@ -66,7 +81,7 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool + The NanoKVM-USB uses its own EDID (Extended Display Identification Data) before connecting to the loop-out display. After connecting to the loop-out display, it switches to the EDID of the loop-out display. + Since the EDID contains information about the display manufacturer and color settings, the resolution list in the Target system settings may appear different before and after connecting the loop-out display. Additionally, the color of the video captured via USB may vary before and after the connection. -### Other +## Other + If the above methods do not resolve the issue, please describe your purchased model and the encountered problem on the forum, GitHub, or QQ group, and we will respond patiently. diff --git a/docs/hardware/zh/kvm/NanoKVM_USB/faq.md b/docs/hardware/zh/kvm/NanoKVM_USB/faq.md index 5349d106..9c368b97 100644 --- a/docs/hardware/zh/kvm/NanoKVM_USB/faq.md +++ b/docs/hardware/zh/kvm/NanoKVM_USB/faq.md @@ -49,6 +49,19 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool ## 视频问题 +### 部分主机BIOS下环出/采集颜色异常 + ++ NanoKVM-USB早期固件可能在部分BIOS下环出颜色偏红，采集颜色偏绿，可以通过烧录新固件解决，请先下载烧录软件和固件： [固件下载链接](https://dl.sipeed.com/fileList/KVM/NanoKVM_USB/MS2131_LIB_V2_0_27_Demo_GPIO0_PlugDetect_20251205_replaced_E158EDID.bin)、[烧录软件下载链接](https://dl.sipeed.com/fileList/KVM/NanoKVM_USB/MS_USB3_0_UpgradeTool_V1_3_2.exe) + ++ 烧录步骤： + 1. 打开软件，选择下载的固件 + 2. 将NanoKVM-USB Host端的USB-C插入电脑 + 3. 等待软件连接，点击开始烧录，等待完成 + +> **请勿在烧录过程中拔出NanoKVM-USB，有变砖风险** +> 烧录软件仅支持Windows +> 目前不支持NanoKVM-USB(4K)版本的烧录 + ### 视频画质差 + 首先检查是否使用了 USB2.0 的线缆/HOST接口，当分辨率较大时 USB2.0 不足以提供充足的传输带宽，会被动降低画质，建议选用 USB3.0的线缆