Update NanoKVM-Doc

2026-09-11 00:22:49 -05:00 · 2025-04-18 19:15:52 +08:00
parent 5a6009e92d ce59b74ec4
commit ca07d777e1
3 changed files with 108 additions and 3 deletions
--- a/docs/hardware/en/kvm/NanoKVM/development.md
+++ b/docs/hardware/en/kvm/NanoKVM/development.md
@@ -245,6 +245,55 @@ Example: Move down by 1 unit
 echo -ne \\x00\\x00\\x00\\x00\\x00\\x01 > /dev/hidg2
 ```

+## IO
+
+The ATX power control function is implemented through IO and the external KVM-B. The corresponding relationship between IO and functions is as follows:
+Alpha version definition (including early NanoKVM-Cube)
+
+| Function      | Linux GPIO Number |
+|---------------|-------------------|
+| PWR LED Input | 504               |
+| PWR KEY Output| 503               |
+| RST KEY Output| 507               |
+    
+Beta version definition (including later NanoKVM-Cube and all NanoKVM-PCIe)
+
+| Function      | Linux GPIO Number |
+|---------------|-------------------|
+| PWR LED Input | 504               |
+| PWR KEY Output| 503               |
+| RST KEY Output| 505               |
+
+ Read LED status (using Beta as an example)
+    ```shell
+    cat /sys/class/gpio/gpio504/value
+    # 0 -> LED on
+    # 1 -> LED off
+    ```
+ Operate power button (using Beta as an example)
+    ```shell
+    # Press down
+    echo 1 > /sys/class/gpio/gpio503/value
+
+    # Wait for 1 second
+    sleep 1
+
+    # Release
+    echo 0 > /sys/class/gpio/gpio503/value
+    ```
+ Operate reset button (using Beta as an example)
+    ```shell
+    # Press down
+    echo 1 > /sys/class/gpio/gpio505/value
+
+    # Wait for 1 second
+    sleep 1
+
+    # Release
+    echo 0 > /sys/class/gpio/gpio505/value
+    ```
+ For other IO: Please refer to [LicheeRV Nano GPIO](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/5_peripheral.html#LicheeRV-Nano%E5%BC%95%E8%84%9A%E5%9B%BE%26amp%3BLinux-GPIO%E7%BC%96%E5%8F%B7%EF%BC%9A) for development.
+
 ## Precautions

 - Users should not place their own built programs in the `/kvmapp` directory, as any updates will reset all contents within the folder.
--- a/docs/hardware/zh/kvm/NanoKVM/development.md
+++ b/docs/hardware/zh/kvm/NanoKVM/development.md
@@ -157,6 +157,56 @@ NanoKVM除实现KVM功能外还开放了一些数据,用于用户的二次开发
                ```shell
                echo -ne \\x00\\x00\\x00\\x00\\x00\\x01 > /dev/hidg2
                ```
+
+## IO
+
+ATX电源控制功能借助IO和外置的KVM-B实现，IO和功能对应关系如下
+Alpha 版定义（包含早期NanoKVM-Cube）
+
+| 功能 | Linux GPIO编号 |
+|----------|----------|
+| PWR LED 输入 | 504 |
+| PWR KEY 输出 | 503 |
+| RST KEY 输出 | 507 |
+
+Beta 版定义（包含后期NanoKVM-Cube和全部的NanoKVM-PCIe）
+
+| 功能 | Linux GPIO编号 |
+|----------|----------|
+| PWR LED 输入 | 504 |
+| PWR KEY 输出 | 503 |
+| RST KEY 输出 | 505 |
+
+    + 读取LED状态 (以Beta为例)
+        ```shell
+        cat /sys/class/gpio/gpio504/value
+        # 0 -> LED亮
+        # 1 -> LED咩
+        ```
+    + 操作电源按钮 (以Beta为例)
+        ```shell
+        # 按下
+        echo 1 > /sys/class/gpio/gpio503/value
+
+        # 等待1s
+        sleep 1
+
+        # 抬起
+        echo 0 > /sys/class/gpio/gpio503/value
+        ```
+    + 操作重启按钮 (以Beta为例)
+        ```shell
+        # 按下
+        echo 1 > /sys/class/gpio/gpio505/value
+
+        # 等待1s
+        sleep 1
+
+        # 抬起
+        echo 0 > /sys/class/gpio/gpio505/value
+        ```
+ 其他IO：请参考 [LicheeRV Nano GPIO](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/5_peripheral.html#LicheeRV-Nano%E5%BC%95%E8%84%9A%E5%9B%BE%26amp%3BLinux-GPIO%E7%BC%96%E5%8F%B7%EF%BC%9A) 开发
+
 ## 注意事项

 + 用户自己构建的程序请不要放在/kvmapp下,每次更新将会重置文件夹内所有内容
--- a/docs/hardware/zh/kvm/NanoKVM_USB/faq.md
+++ b/docs/hardware/zh/kvm/NanoKVM_USB/faq.md
@@ -3,7 +3,7 @@ title: F&Q
 keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
 ---

-## 异常修复
+## 串口/键鼠问题

 ### Linux打开网页后无 ttyUSBx 串口设备

@@ -24,6 +24,8 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
 + Chrome浏览器可能没有检测到该串口，请刷新网页或重启 Chrome
 + Chrome权限可能不足，请打开相应权限

+## 视频问题
+
 ### DP-HDMI转接器

 + 部分无源DP转HDMI转换器内部电路仅做电平转换，对NanoKVM-USB兼容性较差，表现为视频信号从无到有（比如从睡眠唤醒时）NanoKVM-USB仍显示然黑屏，需要手动拔插HDMI。
@@ -37,9 +39,11 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool
 + NanoKVM-USB在未连接环出显示屏前使用自身的EDID（显示器识别数据），连接环出显示器后切换为环出显示器的EDID。
 + 由于EDID中包含显示器厂家以及颜色信息，插入环出显示器前后Target系统设置中可能显示为不同的分辨率列表，USB采集的画面颜色可能在插入前后有所差异

-### 其他
+## 音频问题

-+ 若上述方法不能解决异常，请在论坛,GitHub或QQ群说明您购买的型号和遇到的问题，我们会耐心解答
+### 音频不连续
+
+ NanoKVM-USB 在USB2.0模式下可能会因带宽不够的原因出现音频传输不连续的问题，请尽量使用USB3.0连接NanoKVM-USB和Host

 ## 已知问题

@@ -49,6 +53,8 @@ keywords: NanoKVM-USB, Lichee, PiKVM, RISCV, tool

 ## 反馈方式

+ 若上述方法不能解决异常，请在论坛,GitHub或QQ群说明您购买的型号和遇到的问题，我们会耐心解答
+
 - [Github issues](https://github.com/sipeed/NanoKVM)
 - [MaixHub 论坛](https://maixhub.com/discussion/nanokvm)
 - QQ 交流群: 703230713