Update NanoKVM Docs

This commit is contained in:
BuGu
2025-08-28 18:21:42 +08:00
committed by GitHub
12 changed files with 54 additions and 4 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.4 MiB

View File

@@ -68,6 +68,12 @@ The STA LED indicates the operating status of the NanoKVM. When functioning prop
> If `VIDevFPS` is not 0 and `VIFPS` is 0, it indicates that NanoKVM is not correctly configured for HDMI parameters. The Cube can replug the HDMI to auto-detect, while PCIe can click `Reset HDMI` under `Video` to auto-detect.
> Check if `VIInImgWidth` and `VIInImgHeight` match the actual HDMI resolution. If they are different, it means NanoKVM did not auto-detect the correct HDMI parameters. Manually configure the resolution parameters as described in point 4.
### No Display After Host Wakes from Sleep
1. Check if you are using a cheap DP to HDMI (passive adapter). These types of adapters lack a proper wake mechanism and cannot notify the NanoKVM that the display has been restored.
2. For PCIe versions, you can click the "Reset HDMI" button to forcefully retrieve the display.
3. The Cube/Lite versions lack a reset function; please switch to an active DP adapter.
### Serious screen delay in internal network environment
1. Try replacing the switch or power supply

View File

@@ -17,6 +17,12 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
+ 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`.
### 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.

View File

@@ -66,6 +66,12 @@ keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
> 若 `VIDevFPS` 非0 、`VIFPS` 为0 则认为NanoKVM没有正确配置HDMI参数Cube可以重新插拔HDMI重新自动获取PCIe可点击`视频`下`重置HDMI`自动获取
> 查看 `VIInImgWidth` 和 `VIInImgHeight`与实际HDMI分辨率是否一致若不同则认为NanoKVM没有自动获取到正确的HDMI参数按照第4点手动配置分辨率参数
### 主机休眠唤醒后无画面
1. 检查是否使用廉价的DP转HDMI无源转换头这类转换接口没有完善的唤醒机制无法通知 NanoKVM 画面已经恢复
2. PCIe 版本可以点击重置HDMI按钮来强制重新获取画面
3. Cube/Lite版本缺少重置功能请更换有源DP转换接头
### 内网环境下画面延迟异常严重
1. 尝试更换交换机或电源

View File

@@ -18,7 +18,7 @@ update:
- Full 版本自带一张 32G 的 SD 卡,需要拆开外壳将其取出;
- Lite 版本需要自己准备一张 8G 以上的 SD 卡。
1. 前往 [Github](https://github.com/sipeed/NanoKVM/releases) 下载最新版本镜像。
1. 前往 [Github](https://github.com/sipeed/NanoKVM/releases/latest) 下载最新版本镜像。
1. 安装烧录软件,推荐使用 [Etcher](https://etcher.balena.io)。

View File

@@ -28,7 +28,7 @@ NanoKVM-ATX包含
## 接口定义
![](./../../../assets/NanoKVM/pro/start/Desk-Interface.png)
![](./../../../assets/NanoKVM/pro/start/ATX-Interface.jpg)
## 接线

View File

@@ -88,3 +88,23 @@ stty -F /dev/ttyS1 115200
# 发送十六进制数据 0x11, 0x22, 0x33
echo -n -e '\x11\x22\x33' > /dev/ttyS1
```
## 如何修改EDID
EDID扩展显示识别数据是显示设备向主机提供的一组数据包括设备信息、分辨率帧率列表、颜色特性、音频能力等。主机接受到 EDID 后按需调整显示器的设置
NanoKVM Pro 支持修改虚拟显示屏暴露的EDID您可以克隆显示器的EDID或编写自己的EDID来达到特殊的屏幕比例、刷新率或颜色特征
> 修改EDID后可能存在无法正常显示的风险请谨慎修改。如果出现异常请恢复默认EDID
写入方式:
```shell
# 1. 准备edid文件一般大小是256Bytescp 到系统中
ls -l /root/customize.bin
# -rw-r--r-- 1 1000 1000 256 Aug 19 14:44 /root/customize.bin
# 2. 写入EDID
cat /root/customize.bin > /proc/lt6911_info/edid
# 3. 恢复默认EDID
cat /kvmcomm/edid/e18.bin > /proc/lt6911_info/edid
```

View File

@@ -23,7 +23,7 @@ NanoKVM Pro 支持通过 USB 烧录镜像的方式来恢复或更新系统。
#### 烧录步骤
1. **下载镜像与烧录工具**
- 访问 [NanoKVM Pro 发布页面](https://github.com/sipeed/NanoKVM-Pro/releases) 下载最新镜像文件
- 访问 [NanoKVM Pro 发布页面](https://github.com/sipeed/NanoKVM-Pro/releases/latest) 下载最新镜像文件
- 下载并安装烧录工具 [balenaEtcher](https://etcher.balena.io/)
2. **进入烧录模式**

View File

@@ -65,7 +65,7 @@ IP-KVM系列产品是远程桌面的硬件外挂通过HDMI捕捉画面
## NanoKVM-PCIe 资料
+ [NanoKVM Pro 镜像下载 (待更新)]()
+ [NanoKVM Pro 镜像下载 (待更新)](https://github.com/sipeed/NanoKVM-Pro/releases/latest)
+ [ATX上手指南](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM_Pro/atx_start.html)
+ [高级应用](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM_Pro/extended.html)
+ [常见问题](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM_Pro/faq.html)
@@ -80,6 +80,7 @@ IP-KVM系列产品是远程桌面的硬件外挂通过HDMI捕捉画面
如果您在使用过程中有任何问题或建议,请通过以下渠道和我们反馈:
+ [Github issues](https://github.com/sipeed/NanoKVM-Pro/issues)
+ [MaixHub 论坛](https://maixhub.com/discussion/nanokvm)
+ QQ 交流群: 703230713

View File

@@ -0,0 +1,3 @@
# 屏幕色彩扩展灯带
敬请期待

View File

@@ -26,6 +26,12 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
## 视频问题
### 视频画质差
+ 首先检查是否使用了 USB2.0 的线缆/HOST接口当分辨率较大时 USB2.0 不足以提供充足的传输带宽,会被动降低画质,建议选用 USB3.0的线缆
+ 2K分辨率下首先于芯片编码能力画质会下降请切换为1080P使用
+ 如果 Target 连接的是 Windws主机请前往系统设置-显示设置-高级显示设置-列出所有模式中更改为 1080P60并检查`桌面分辨率``活动信号分辨率是否一致`
### DP-HDMI转接器
+ 部分无源DP转HDMI转换器内部电路仅做电平转换对NanoKVM-USB兼容性较差表现为视频信号从无到有比如从睡眠唤醒时NanoKVM-USB仍显示然黑屏需要手动拔插HDMI。

View File

@@ -534,6 +534,8 @@ items:
file: kvm/NanoKVM_Pro/desk_start.md
- label: 高级应用
file: kvm/NanoKVM_Pro/extended.md
- label: 屏幕色彩扩展灯带
file: kvm/NanoKVM_Pro/ws2812.md
- label: FAQ
file: kvm/NanoKVM_Pro/faq.md
- label: Cluster