Administrator/NANOKVM-sipeed_wiki-MIRROR
1
0
Fork 0
mirror of https://github.com/sipeed/sipeed_wiki.git synced 2026-09-11 00:22:49 -05:00
Code Issues Packages Projects Releases Wiki Activity

docs: add network configuration issue in KVM FAQ

Browse Source
This commit is contained in:
Mk16kawai
2026-01-04 17:58:12 +08:00
parent 1f5d7b91d8
commit 131a94e1c1
2 changed files with 85 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

96
docs/hardware/en/kvm/NanoKVM_Pro/faq.md
View File

@@ -10,6 +10,22 @@ NanoKVM Pro will periodically update applications, and some issues may have been
The green LED serves as the power indicator for NanoKVM Pro. If a power source with insufficient capacity is connected, the green LED may blink due to voltage instability and fail to start up. Please disconnect all power connections and replace the power adapter.
## Network-related Issue
### NanoKVM-Pro ATX Unable to Configure Network via OLED Screen
In earlier versions \[1\], on the Wi-Fi variant of the ATX, long-pressing the `USR` button may cause the OLED to remain stuck on the `Starting` screen and fail to enter the Wi-Fi configuration page.
**Temporary Workarounds:**
* Connect the device via Ethernet, then log in to the Web interface and complete Wi-Fi configuration under `Settings` → `Device` → `Wi-Fi`.
* Connect the NanoKVM-ATX HID interface to a computer. On Windows, run `ipconfig` in the Command Prompt (use `ifconfig` on Linux), and locate the newly added IPv4 address in the form of `10.aaa.bbb.ccc` (for example, `10.223.155.100`). Access the NanoKVM Web interface via `10.aaa.bbb.1`, then complete Wi-Fi configuration under `Settings` → `Device` → `Wi-Fi`.
After successfully connecting to the network, it is recommended to update the application to version `>= 1.2.9` to permanently resolve this issue.
\[1\]: Affected versions: `1.1.8` ~ `1.2.8`
## Video Related Issues
### NanoKVM-Pro Cannot Display BIOS and Login Screen
@@ -31,13 +47,13 @@ For the default resolution and frame rate list, please refer to [here](https://w
When connected through video adapters or docking stations, the reported capabilities may change (e.g., reporting 4K60FPS capture support, which may cause capture failure). In such cases, adjust the display settings in the host system:
- On Windows: Go to `Settings` → `Display` → `Advanced Display Settings` → Select `NanoKVM-Pro` display → `Display Adapter Properties` → `List All Modes` → Choose the desired mode → Click Apply or OK.
* On Windows: Go to `Settings` → `Display` → `Advanced Display Settings` → Select `NanoKVM-Pro` display → `Display Adapter Properties` → `List All Modes` → Choose the desired mode → Click Apply or OK.
![](./../../../assets/NanoKVM/pro/faq/res.png)
### Blurry Image, Not Matching the Captured Resolution
- In the image above, box ③: If the desktop resolution is lower than the active signal resolution, the captured image may appear blurrier than expected. Follow the steps above to output a clear image.
* In the image above, box ③: If the desktop resolution is lower than the active signal resolution, the captured image may appear blurrier than expected. Follow the steps above to output a clear image.
## Image Burning Methods
@@ -47,20 +63,20 @@ NanoKVM Pro supports restoring or updating the system via USB image burning.
#### Preparation
- Prepare a USB data cable
- Download the latest NanoKVM Pro image file
- Prepare a burning tool (such as balenaEtcher, Rufus, or the dd command)
* Prepare a USB data cable
* Download the latest NanoKVM Pro image file
* Prepare a burning tool (such as balenaEtcher, Rufus, or the dd command)
#### Burning Steps
1. **Download the Image and Burning Tool**
- Visit the [NanoKVM Pro Release Page](https://github.com/sipeed/NanoKVM-Pro/releases/latest) to download the latest image file.
- Download and install the burning tool [balenaEtcher](https://etcher.balena.io/).
* Visit the [NanoKVM Pro Release Page](https://github.com/sipeed/NanoKVM-Pro/releases/latest) to download the latest image file.
* Download and install the burning tool [balenaEtcher](https://etcher.balena.io/).
2. **Enter Burning Mode**
- Use the USB data cable to connect the NanoKVM Pro's HID interface to your computer.
- Press and hold the User button on the NanoKVM, then power it on (or press the Reset button while powered on) until the orange LED turns off.
- The device will then enter burning mode, and the orange LED will start flashing again. Check if your computer recognizes the new disk device.
* Use the USB data cable to connect the NanoKVM Pro's HID interface to your computer.
* Press and hold the User button on the NanoKVM, then power it on (or press the Reset button while powered on) until the orange LED turns off.
* The device will then enter burning mode, and the orange LED will start flashing again. Check if your computer recognizes the new disk device.
<div style="display: flex; justify-content: center; gap: 20px; flex-wrap: wrap; align-items: flex-end;">
<div style="text-align: center; flex: 1; max-width: 400px; min-width: 300px;">
@@ -74,23 +90,24 @@ NanoKVM Pro supports restoring or updating the system via USB image burning.
</div>
3. **Burn Using balenaEtcher (Recommended)**
- Launch balenaEtcher.
- Click "Flash from file" and select the downloaded image file.
- Click "Select target" and choose the recognized NanoKVM Pro device.
- Click "Flash!" to start the burning process.
- Wait for the burning to complete and verify.
* Launch balenaEtcher.
* Click "Flash from file" and select the downloaded image file.
* Click "Select target" and choose the recognized NanoKVM Pro device.
* Click "Flash!" to start the burning process.
* Wait for the burning to complete and verify.
<div align="center">
<img src="./../../../assets/NanoKVM/pro/faq/flash.jpeg" style="width: 80%; height: auto; border-radius: 4px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);" alt="Flash">
</div>
- If prompted that the partition table cannot be found, it is normal; click continue.
* If prompted that the partition table cannot be found, it is normal; click continue.
<div align="center">
<img src="./../../../assets/NanoKVM/pro/faq/miss_part.jpeg" style="width: 70%; height: auto; border-radius: 4px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);" alt="Missing Partition">
</div>
4. **Burn Using Command Line**
```bash
# Find the device name
sudo fdisk -l
@@ -105,16 +122,16 @@ sudo sync
```
5. **Restart the Device**
- After burning is complete, safely eject the device.
- Disconnect the USB connection.
- Reconnect the power, and the device will automatically start the new system.
* After burning is complete, safely eject the device.
* Disconnect the USB connection.
* Reconnect the power, and the device will automatically start the new system.
#### Notes
- Ensure you select the correct device to avoid accidentally operating on other storage devices.
- Do not disconnect the power or remove USB connections during the burning process.
- The first startup may take a long time for initialization and configuration.
- If the orange light does not turn on or the disk device does not appear, please refer to the methods below to use AXDL for burning.
* Ensure you select the correct device to avoid accidentally operating on other storage devices.
* Do not disconnect the power or remove USB connections during the burning process.
* The first startup may take a long time for initialization and configuration.
* If the orange light does not turn on or the disk device does not appear, please refer to the methods below to use AXDL for burning.
### AXDL Burning
@@ -122,40 +139,42 @@ AXDL is an official burning tool provided by Aixin, designed for burning AXP for
#### Preparation
- Prepare a USB data cable.
- Visit the [NanoKVM Pro Release Page](https://github.com/sipeed/NanoKVM-Pro/releases) to download the latest AXP format image file.
- Download and install the AXDL tool and corresponding drivers [Download Link](https://dl.sipeed.com/shareURL/MaixIV/M4N-Dock/10_PC_Software).
* Prepare a USB data cable.
* Visit the [NanoKVM Pro Release Page](https://github.com/sipeed/NanoKVM-Pro/releases) to download the latest AXP format image file.
* Download and install the AXDL tool and corresponding drivers [Download Link](https://dl.sipeed.com/shareURL/MaixIV/M4N-Dock/10_PC_Software).
#### Burning Steps
1. **Connect the Device**
- Use the USB data cable to connect the NanoKVM Pro's HID interface to your computer.
* Use the USB data cable to connect the NanoKVM Pro's HID interface to your computer.
2. **Configure the Burning Tool**
- Open the AXDL tool.
- Select the downloaded AXP format image file.
- Click the start burning button.
* Open the AXDL tool.
* Select the downloaded AXP format image file.
* Click the start burning button.
<div align="center">
<img src="./../../../assets/NanoKVM/pro/faq/axdl.jpeg" style="width: 80%; height: auto; border-radius: 4px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);" alt="AXDL Burning Tool Interface">
</div>
3. **Enter Burning Mode and Start Burning**
- Press and hold the User button on the NanoKVM, then power it on (or press the Reset button while powered on).
- The burning process will start automatically, wait for the progress bar to complete.
- Wait until the prompt indicates that burning was successful; the entire process is complete.
* Press and hold the User button on the NanoKVM, then power it on (or press the Reset button while powered on).
* The burning process will start automatically, wait for the progress bar to complete.
* Wait until the prompt indicates that burning was successful; the entire process is complete.
### SD Card Flashing
The NanoKVM Pro Desk supports writing an image from an SD card to the internal eMMC to restore or update the system. Note: this only supports flashing an image from an SD card to the internal eMMC; the device cannot boot directly from the SD card.
#### Preparation
- Prepare an SD card with at least 8 GB capacity.
- Download the latest NanoKVM Pro SD image from the [NanoKVM Pro Releases](https://github.com/sipeed/NanoKVM-Pro/releases) page (the image is usually provided in a zip archive). Extract the archive and locate the `img` file.
- Prepare a flashing tool such as `balenaEtcher`, `Rufus`, or use the command-line `dd`.
- Prepare a USB card reader to connect the SD card.
* Prepare an SD card with at least 8 GB capacity.
* Download the latest NanoKVM Pro SD image from the [NanoKVM Pro Releases](https://github.com/sipeed/NanoKVM-Pro/releases) page (the image is usually provided in a zip archive). Extract the archive and locate the `img` file.
* Prepare a flashing tool such as `balenaEtcher`, `Rufus`, or use the command-line `dd`.
* Prepare a USB card reader to connect the SD card.
#### Flashing Steps
1. Use `balenaEtcher` or `dd` to write the `img` file to the SD card (see the "USB Burning" section above for details on writing images).
2. Insert the flashed SD card into the NanoKVM Pro's SD card slot.
3. Disconnect power from the NanoKVM Pro Desk.
@@ -175,4 +194,5 @@ Click [here](https://wiki.sipeed.com/nanokvmpro-lcd) to view the issue and repai
In the first batch of NanoKVM-Desk units, the screw in the top-left position (shown below) was found to affect WiFi connection stability due to structural design considerations. This screw hole is intentionally left empty in later assemblies.
![](./../../../assets/NanoKVM/pro/faq/screw.jpg)
![](./../../../assets/NanoKVM/pro/faq/screw.jpg)

30
docs/hardware/zh/kvm/NanoKVM_Pro/faq.md
View File

@@ -10,6 +10,22 @@ NanoKVM Pro 会不定期更新应用，一些问题可能在新的应用中已
绿色LED是 NanoKVM Pro 的电源指示，如果连接了供电能力较弱的电源，绿色LED会因电压不稳定而无法启动，请拔掉所有供电并更换电源
## 网络相关问题
### NanoKVM-Pro ATX 无法通过 OLED 屏配网
在较早的版本\[1\]中，WiFi 版本 ATX 长按 `USR` 按键 OLED 可能会停留在 `Starting` 页面无法进入配网页面。
临时解决办法：
- 通过以太网连接设备后，登录 Web 界面，在 `设置` → `设备` → `Wi-Fi` 中完成 Wi-Fi 配网。
- 将 NanoKVM-ATX 的 HID 接口连接到电脑。在 Windows 命令行执行 `ipconfig`（Linux 使用 `ifconfig`），找到新增的类似 `10.aaa.bbb.ccc` 的 IPv4 地址（例如 `10.223.155.100`）。通过 `10.aaa.bbb.1` 登录并访问 NanoKVM 的Web页面，在 `设置` → `设备` → `Wi-Fi` 中完成 Wi-Fi 配网。
在成功连接到网络后建议通过更新应用版本(>=`1.2.9`)彻底修复该问题。
\[1\]: 具体版本为: `1.1.8` ~ `1.2.8`
## 视频相关问题
### NanoKVM-Pro 无法显示BIOS和登陆界面
@@ -30,13 +46,14 @@ NanoKVM-Pro具有采集和环出视频的功能，仅采集时默认向主机汇
默认的分辨率帧率列表请参考[这里](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM_Pro/extended.html#%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9EDID)
连接视频转接器或拓展坞情况下可能会改变其内容，如汇报4K60FPS的采集能力导致无法采集，需要在主机系统设置中修改显示参数
+ Windows下一般在`设置`->`显示设置`->`高级显示设置`->选择`NanoKVM-Pro`显示器->`显示器属性`->`列出所有模式`->选择需要调整的模式->点击应用或确认
- Windows下一般在`设置`->`显示设置`->`高级显示设置`->选择`NanoKVM-Pro`显示器->`显示器属性`->`列出所有模式`->选择需要调整的模式->点击应用或确认
![](./../../../assets/NanoKVM/pro/faq/res.png)
### 画面较糊，不符合采集到的分辨率
+ 上图中3号框：若出现桌面分辨率小于有源信号分辨率，可能会出现采集画面清晰度不符合预期的情况，也可以通过上述流程输出清晰的画面
- 上图中3号框：若出现桌面分辨率小于有源信号分辨率，可能会出现采集画面清晰度不符合预期的情况，也可以通过上述流程输出清晰的画面
## 镜像烧录方法
@@ -53,10 +70,12 @@ NanoKVM Pro 支持通过 USB 烧录镜像的方式来恢复或更新系统。
#### 烧录步骤
1. **下载镜像与烧录工具**
- 访问 [NanoKVM Pro 发布页面](https://github.com/sipeed/NanoKVM-Pro/releases/latest) 下载最新镜像文件
- 下载并安装烧录工具 [balenaEtcher](https://etcher.balena.io/)
2. **进入烧录模式**
- 使用 USB 数据线连接 NanoKVM Pro 的 HID 接口到电脑
- 先按住 NanoKVM 的 User 按键，然后接通电源（或者在通电状态下按下 Reset 按键），直到橙色 LED 灯熄灭
- 这时设备会进入烧录模式，橙色灯再次开始闪烁，查看电脑是否识别到新的磁盘设备
@@ -73,6 +92,7 @@ NanoKVM Pro 支持通过 USB 烧录镜像的方式来恢复或更新系统。
</div>
3. **使用 balenaEtcher 烧录**（推荐）
- 启动 balenaEtcher
- 点击 "Flash from file" 选择下载的镜像文件
- 点击 "Select target" 选择识别到的 NanoKVM Pro 设备
@@ -90,6 +110,7 @@ NanoKVM Pro 支持通过 USB 烧录镜像的方式来恢复或更新系统。
</div>
4. **使用命令行烧录**
```bash
# 查找设备名
sudo fdisk -l
@@ -104,6 +125,7 @@ sudo sync
```
5. **重启设备**
- 烧录完成后，安全弹出设备
- 断开 USB 连接
- 重新接通电源，设备将自动启动新系统
@@ -149,12 +171,14 @@ AXDL 是爱芯官方推出的镜像烧录工具，可以烧录 AXP 格式的系
NanoKVM Pro Desk 支持通过 SD 卡将镜像写入内置 eMMC 来恢复或更新系统。注意：目前仅支持将镜像从 SD 卡烧录到内置 eMMC，设备不能直接从 SD 卡启动。
#### 准备工作
- 准备一张容量至少 8 GB 的 SD 卡。
- 下载最新的 [NanoKVM Pro SD 镜像](https://github.com/sipeed/NanoKVM-Pro/releases)（通常为 zip 压缩包），解压后取出其中的 `img` 文件。
- 准备烧录工具（如 `balenaEtcher`、`Rufus` 或使用命令行的 `dd`）。
- 准备一个 USB 读卡器以连接 SD 卡。
#### 烧录步骤
1. 使用 `balenaEtcher` 或 `dd` 将 `img` 镜像写入 SD 卡（具体写入方法参照上文“USB 烧录”部分）。
2. 将写好镜像的 SD 卡插入 NanoKVM Pro 的 SD 卡槽。
3. 断开 NanoKVM Pro Desk 的电源。
@@ -174,4 +198,4 @@ NanoKVM Pro Desk 支持通过 SD 卡将镜像写入内置 eMMC 来恢复或更
首批NanoKVM-Desk因结构设计原因，下图左上角螺丝会影响WiFi连接的稳定性，在后期组装时该孔位留空
![](./../../../assets/NanoKVM/pro/faq/screw.jpg)
![](./../../../assets/NanoKVM/pro/faq/screw.jpg)