Update NanoKVM docs: add EDID and password reset info.

This commit is contained in:
BuGu
2026-05-12 18:36:35 +08:00
committed by GitHub
6 changed files with 59 additions and 5 deletions

View File

@@ -15,7 +15,7 @@ keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
### About Password
1. After updating to version 2.1.5, if you haven't set a web password before, you will be prompted to change the password upon logging in. When you change the password, the backend `root` password will also be synchronized to the web password. If you have already changed the web password before, the backend `root` password will not be changed automatically. You can modify it using `passwd` in the terminal or click "Reset Password" in the web settings.
2. If the application version is greater than 2.1.5 and you forget the password, you can press the `BOOT` button on the device for more than 10 seconds (the BOOT button for the NanoKVM-Cube is located next to the USB-HID interface, while the PCIe version can be found on the panel. Older versions of the NanoKVM Full may not have a hole in the corresponding location and require disassembly).
2. If the application version is greater than 2.1.5 and you forget the password, you can press the `BOOT` button on the device for more than 10 seconds (the BOOT button for the NanoKVM-Cube is located next to the USB-HID interface, while the PCIe version can be found on the panel. Older versions of the NanoKVM Full may not have a hole in the corresponding location and require disassembly). For detailed instructions, please refer to [Reset Password](https://wiki.sipeed.com/hardware/en/kvm/NanoKVM/reset.html).
3. If holding down the button does not reset the password, it may be because the application version is less than 2.1.5. Please refer to [here](https://wiki.sipeed.com/hardware/en/kvm/NanoKVM/system/flashing.html) to reflash the image. Note that reflashing the image will erase all configuration information.
### HID Keyboard and Mouse Not Working

View File

@@ -0,0 +1,24 @@
---
title: How to Reset Password for NanoKVM
keywords: NanoKVM, Remote desktop, RISCV, tool
---
> Document Scope
> Applicable to NanoKVM Cube/Lite/PCIe series
> Password reset feature is available in APP version 2.1.5 and above
## When to Reset Password
Use the password reset function when you forget the login password for the web management interface and cannot retrieve it through other means.
## How to Reset Password
With the device powered on, press and hold the `BOOT` button (next to the USB-HID interface for Cube version, on the panel for PCIe version) for **more than 10 seconds**. The device will automatically reset the password.
## Default Password After Reset
After password reset, the default credentials for the web management interface are:
- **Username**: `admin`
- **Password**: `admin`
> **Note**: Resetting the password only affects the web management interface login password, not the SSH login password. If you need to modify the SSH password, use the `passwd` command after logging in.

View File

@@ -48,10 +48,12 @@ When the host has multiple displays, it generally prioritizes the built-in scree
DP adapters come in two types: passive and active. Passive DP adapters are low-cost but may pose compatibility risks, manifesting as resolution lists not matching EDID, host wake-up failing to activate the screen, etc. Using the reset HDMI function can wake up the screen.
### Missing Resolution List, Inconsistent with EDID
### Missing Resolution List, Inconsistent with Configured EDID
The resolution list in the host display settings is determined by the host, EDID, (potentially existing) loop-out screen, and video adapter collectively. You can switch between different EDIDs on the web page to achieve the most reasonable compatibility.
> **Note**: In the hardware design of NanoKVM-Pro, HDMI first passes through a splitter chip before entering the HDMI capture chip. Due to chip limitations, writing is only possible to the capture chip. When a loop-out display is connected, the splitter chip automatically combines two EDIDs (the EDID of the capture chip and the EDID of the loop-out display). This process cannot be controlled by the main control chip, which is why the actual EDID used may differ from the configured EDID.
### HDMI Icon Lit on NanoKVM Screen but No Video Displayed in Web Interface
NanoKVM-Pro supports video capture and loop-out functions. When only capturing video, it reports a maximum resolution of 4K30FPS to the host by default. When a loop-out display is connected, it reports a common resolution list.

View File

@@ -14,7 +14,7 @@ keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
### 关于密码
1. 更新至 2.1.5 版本应用后,若之前没有设置过网页密码,登录后会提示修改密码,修改密码时,后台的`root`密码也会同步修改成网页密码,若之前已经修改过网页密码,后台`root`密码不会主动修改,请在终端使用`passwd`或网页设置中点击重置密码以修改;
2. 应用版本大于 2.1.5 时,若忘记密码,可以按下机身`BOOT`按键10s以上NanoKVM-Cube的BOOT按键位于USB-HID接口右边PCIe版本BOOT按键可在面板上找到较老版本的NanoKVM Full可能没有在对应位置开孔需要拆机操作
2. 应用版本大于 2.1.5 时,若忘记密码,可以按下机身`BOOT`按键10s以上NanoKVM-Cube的BOOT按键位于USB-HID接口右边PCIe版本BOOT按键可在面板上找到较老版本的NanoKVM Full可能没有在对应位置开孔需要拆机操作,详细操作指引请参考[重置密码](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/reset.html)
3. 若长按无法重置密码,可能是应用版本小于 2.1.5 ,参考[这里](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/flashing.html)重新烧录镜像,注意,重烧镜像后会丢失所有配置信息。
### HID键鼠不工作

View File

@@ -0,0 +1,26 @@
---
title: NanoKVM 如何重置密码
keywords: NanoKVM, Remote desktop, RISCV, tool
---
> 文档适用范围
> 适用于NanoKVM Cube/Lite/PCIe系列
> 重置密码的功能在APP版本2.1.5版本及以上
## 何时需要重置密码
当您忘记网页管理界面的登录密码,且无法通过其他方式找回时,可以使用重置密码功能。
## 如何重置密码
在设备开机状态下,长按设备上的 `BOOT` 按键Cube 版本在 USB-HID 接口旁边PCIe 版本在面板上)持续 **10 秒以上**,设备将自动重置密码。
## 重置后的默认密码
密码重置后,网页管理界面的默认账号密码为:
- **用户名**: `admin`
- **密码**: `admin`
> **注意**:重置密码仅影响网页管理界面的登录密码,不会影响 SSH 登录密码。如果需要修改 SSH 密码,请登录后使用 `passwd` 命令进行修改。

View File

@@ -50,9 +50,11 @@ NanoKVM Pro 会不定期更新应用,一些问题可能在新的应用中已
DP转接器有被动和主动两种被动DP转接器价格低廉但可能存在兼容性风险表现为分辨率列表与EDID不一致主机唤醒无法启动屏幕等使用重置HDMI功能可唤醒屏幕
### 分辨率列表缺失和EDID不符
### 分辨率列表缺失,和设置EDID不符
主机显示设置中的分辨率列表由主机、EDID和可能存在的环出屏幕、视频转接器共同决定可以在网页切换不同的EDID来实现最合理的兼容性
主机显示设置中的分辨率列表由主机、EDID和可能存在的环出屏幕、视频转接器共同决定可以在网页切换不同的EDID来实现最合理的兼容性
> **注**NanoKVM-Pro 在硬件设计上HDMI 先经过一分二芯片,再进入 HDMI 采集芯片。但受限于芯片功能,只能对采集芯片进行写入。当连接环出显示器时,一分二芯片将自动组合两个 EDID采集芯片的 EDID 和环出显示器的 EDID此过程无法由主控芯片干预所以会出现实际使用的 EDID 与设置的 EDID 不同的现象。
### NanoKVM 小屏幕上HDMI图表亮起但无法在网页中看到画面