Add NanoKVM Pro Doc

docs/hardware/zh/kvm/NanoKVM_Pro/atx_start.md

@@ -0,0 +1,92 @@
+---
+title: ATX 上手指南
+keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool, PCIe
+update:
+  - date: 2025-8-26
+    version: v0.1
+    author: BuGu
+    content:
+      - Release docs
+---
+
+## 开箱
+
+### NanoKVM-ATX 开箱清单
+![](./../../../assets/NanoKVM/pro/start/unbox1.png)
+
+![](./../../../assets/NanoKVM/pro/start/unbox2.png)
+
+NanoKVM-ATX包含：
++ NanoKVM-ATX 主机配全高PCIe挡板+OLED *1；
++ HDMI 线缆 150cm *1；
++ HDMI 线缆 50cm *1；
++ USB TypeA to TypeC 100cm *2；
++ 4Pin 机箱内USB线 40cm *1；
++ ATX-9Pin 一分二开机线 30+30cm *1；
++ 小十字螺丝刀 *1；
++ 天线 *1（仅WiFi版）；
+
+## 接口定义
+
+![](./../../../assets/NanoKVM/pro/start/Desk-Interface.png)
+
+## 接线
+
+1. 连接电源，NanoKVM-Pro 对电源要求略高，部分主板的USB接口无法提供充足的电流，为保证 NanoKVM-Pro 正常工作，强烈建议外接5V1A及其以上的电源（实际运行功耗约3W）；
+
+![](./../../../assets/NanoKVM/pro/start/01_Power.png)
+
+2. 连接USB-HID接口：
+    + ATX版本：可以采用机箱内接线/外部C口接线两种方式
+
+![](./../../../assets/NanoKVM/pro/start/02_USB.png)
+
+> 首批ATX版本用户若选择机箱内接线的方式，为防止主板9PinUSB供电不足导致的NanoKVM异常，建议剪断红色线头（仅由外部供电）再使用！
+
+![](./../../../assets/NanoKVM/pro/start/03_USB.png)
+
+![](./../../../assets/NanoKVM/pro/start/04_USB.png)
+
+3. 使用网线连接路由器/交换机和NanoKVM-Pro，如果没有有线网络，可以跳过此步，开机后配置Wi-Fi使用（需要购买带有WiFi的版本）
+
+![](./../../../assets/NanoKVM/pro/start/05_ETH.png)
+
+4. 连接HDMI-IN，如果主板仅有一个视频接口且有外接屏幕的需求，请将HDMI-OUT连接至你的显示屏；
+
+![](./../../../assets/NanoKVM/pro/start/06_HDMI.png)
+
+> 注意 NanoKVM-Pro 采集最大支持4K30FPS，内置的HDMI一分二会主动读取外接屏幕的分辨率和帧率，并向主机提供屏幕和采集端公共的模式列表，
+>   如果你连接了一个4K60FPS的显示屏，电脑会识别为一个最高支持4K30的屏幕（被采集端限制，可以关闭采集，让4K60直出显示器）
+>   如果你连接了一个1080P的显示屏，电脑会识别为一个最高1080P的屏幕（被环出显示器限制）
+5. （非必须）连接ATX电源控制接口
+
+![](./../../../assets/NanoKVM/pro/start/07_ATX.png)
+
+
+## 内网访问
+
+### 连接网络
+
+1. 如果采用有线连接，上电后KVM将会获取一个由路由器DHCP分配的IP地址，可以跳过此步骤
+2. WiFi连接
+    + ATX版本可以通过OLED实现配网，步骤如下
+        1. 连接NanoKVM-ATX的AP：长按USR按钮，KVM会释放一个WiFi信号（AP），OLED上显示此IP的信息，可以扫描二维码快速连接
+        2. 登陆网页填写要连接的WiFi帐号密码：连接WiFi后OLED显示网页链接，可以手动输入网址或扫描二维码快速跳转到网页配网
+3. 如果有需要也可以通过USB-NCM网络连接
+
+### 访问页面
+
+1. ATX版本：连接网络后OLED上显示本地IP地址（E IP是有线网络获取的IP；W IP是wifi网络获取的IP，默认自动切换显示）；
+2. 同一内网环境下使用一台主机在浏览器（建议使用Chrome）上输入IP地址访问页面；
+![](./../../../assets/NanoKVM/pro/start/SSL.png)
+> 出现此警告是正常现象，NanoKVM-Pro开启了https来增强安全性，并使用自签名ssl证书
+3. 初始默认帐号`admin`，密码`admin`可以登陆至系统内部，强烈建议您立即修改帐号密码；
+4. 检查图像/键鼠/开关机按钮是否正常工作
+
+![](./../../../assets/NanoKVM/pro/start/nanokvm4K.png)
+
+
+## 远程连接
+
+1. NanoKVM-Pro 默认安装了 Tailescale 应用，可以在网页设置中登陆你的 Tailscale 帐号。所有登陆 Tailscale 的设备会自动拉入同一虚拟的内网环境中，并给每一台设备分配`100.xxx.xxx.xxx`的IP，可以通过分配给 NanoKVM Pro 的 IP 远程访问并控制你的主机
+2. 其他异地组网工具：NanoKVM-Pro 基于Ubuntu，可以通过`apt`安装应用，如zerotier，请按照官网提示安装相关应用

docs/hardware/zh/kvm/NanoKVM_Pro/desk_start.md

@@ -0,0 +1,3 @@
+# NanoKVM-Desk 上手指南
+
+敬请期待

docs/hardware/zh/kvm/NanoKVM_Pro/extended.md

@@ -0,0 +1,90 @@
+---
+title: 扩展应用
+keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool, PCIe
+update:
+  - date: 2025-8-26
+    version: v0.1
+    author: 
+    content:
+      - Release docs
+---
+
+## 切换至PiKVM
+
+NanoKVM Pro除运行 NanoKVM 框架外还适配了PiKVM软件框架。您可以根据需求切换使用
+
+### 切换至PiKVM
+
+NanoKVM Pro 出厂默认使用 NanoKVM 框架，可以在`设置`->`关于`->`切换设备`
+
+![](./../../../assets/NanoKVM/pro/extended/SwitchtoPiKVM.png)
+
+点击后系统将自动重启，并启动为PiKVM框架。此过程约30s，如果长时间不自动切换，请手动刷新网页。
+
+![](./../../../assets/NanoKVM/pro/extended/PiKVMLogin.png)
+
+PiKVM框架下默认帐号密码也是`admin`，`admin`，但两个平台下使用各自的帐号与密码，并不统一，强烈建议登陆后修改。
+
+![](./../../../assets/NanoKVM/pro/extended/PiKVM-Setting.png)
+
+> PiKVM框架下部分功能需要借助网页终端实现：如WiFi配网、Tailscale配置
+> NanoKVM更新时，PiKVM框架将同步更新
+
+### 切换至NanoKVM
+
+从PiKVM系统切换回NanoKVM同样简单，只需在`Options`->`Switch to NanoKVM`点击`Switch Now`即可
+
+![](./../../../assets/NanoKVM/pro/extended/SwitchtoNanoKVM.png)
+
+点击后系统将自动重启，并启动为PiKVM框架。此过程约30s，如果长时间不自动切换，请手动刷新网页
+
+## SSH
+
+NanoKVM Pro为确保安全性，出厂默认SSH处于关闭状态，若需要SSH服务或预览新版本时可以通过`设置`->`设备`打开SSH选项
+
+出厂默认帐号`root`，密码`sipeed`，若在NanoKVM框架下修改网页帐号密码，SSH密码会被同步修改。
+
+## 更新
+
+NanoKVM Pro 会不定时推送新版本的应用，包含新功能和bug修复，您可以在`设置`->`检查更新`中更新应用版本。
+
+![](./../../../assets/NanoKVM/pro/extended/Update.png)
+
+点击下载后会自动下载新应用的安装包，包含`kvmcomm_x.x.x_arm64.deb`、`nanokvmpro_x.x.x_arm64.deb`、`pikvm_x.x.x_arm64.deb`
++ `kvmcomm_x.x.x_arm64.deb` 负责驱动 NanoKVM 和 PiKVM 框架中共用的硬件；
++ `nanokvmpro_x.x.x_arm64.deb` NanoKVM 应用软件
++ `pikvm_x.x.x_arm64.deb` PiKVM 应用软件
+
+打开预览更新功能将会获取到最新的实验版应用，通常包含更新的功能，但稳定性有待验证，建议下载预览更新前先打开SSH功能
+
+您也可以下载特定的版本，并手动安装
+
+```shell
+# 以下载 1.0.10 版本为例
+# 下载文件
+curl -L -o nanokvm_pro_1.0.10.tar.gz https://cdn.sipeed.com/nanokvm/pro/kvmcomm_1.0.10_arm64.deb
+curl -L -o nanokvm_pro_1.0.10.tar.gz https://cdn.sipeed.com/nanokvm/pro/nanokvmpro_1.0.10_arm64.deb
+curl -L -o nanokvm_pro_1.0.10.tar.gz https://cdn.sipeed.com/nanokvm/pro/pikvm_1.0.10_arm64.deb
+
+sudo apt install ./*1.0.10*
+```
+
+## 如何使用串口
+
+NanoKVM Pro 提供两组可用串口 UART1/UART2（ATX版本受限挡板规范尺寸没有引出，仅保留内部焊盘）
+
++ 外接其他串口终端设备
+```shell
+# 网页终端使用 UART1 以 115200 波特率打开串口，使用Ctrl+A+Q退出
+picocom -b 115200 /dev/ttyS1
+# 网页终端使用 UART2 以 115200 波特率打开串口，使用Ctrl+A+Q退出
+# picocom -b 115200 /dev/ttyS2
+```
++ 仅发送串口指令
+```shell
+# 设置ttyS1为115200波特率
+stty -F /dev/ttyS1 115200
+
+# 发送十六进制数据 0x11, 0x22, 0x33
+echo -n -e '\x11\x22\x33' > /dev/ttyS1
+```

docs/hardware/zh/kvm/NanoKVM_Pro/faq.md

@@ -0,0 +1,9 @@
+# 常见问题
+
+## 更新解决问题
+
+NanoKVM Pro 会不定期更新应用，一些问题可能在新的应用中已经解决，所以请首先尝试更新应用
+
+## 绿色LED闪烁
+
+绿色LED是 NanoKVM Pro 的电源指示，如果连接了供电能力较弱的电源，绿色LED会因电压不稳定而无法启动，请拔掉所有供电并更换电源

docs/hardware/zh/kvm/NanoKVM_Pro/introduction.md

@@ -0,0 +1,90 @@
+---
+title: 简介
+keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool, PCIe
+update:
+  - date: 2025-8-25
+    version: v0.1
+    author: BuGu
+    content:
+      - Release docs
+---
+
+## 简介
+
+NanoKVM Pro 是 NanoKVM 的延续，作为 IP-KVM 产品继承了 NanoKVM 系列的极致体积和强大扩展性，在性能上有了质的飞跃，更加适合远程办公场景。
+
+为满足不同用户的需求，NanoKVM Pro 提供两种形态：NanoKVM-Desk 与 NanoKVM-ATX：
+
+![](./../../../assets/NanoKVM/pro/introduce/combine.png)
+
+NanoKVM-Desk 意为桌面版NanoKVM Pro，主体采用阳极氧化的磨砂金属外壳，前面板使用1.47寸触摸屏显示KVM核心信息，并且可以方便设置硬件功能，或作为mini副屏使用，搭配左侧无极旋钮获得更有质感的使用体验。
+
+NanoKVM-ATX 是NanoKVM Pro的机箱内版本，标配半高/全高挡板可安装在机箱内部，由于可以内置的USB线缆[3]和电源控制接口更方便主机用户安装。通过外部连接HDMI接口、网线和USB即可实现远程控制。
+
+NanoKVM Pro 采用AX630作为主控核心，采用 ARM 1.2G 双核 A53 CPU；外置 1GB LPDDR4 内存为远程桌面连接提供强有力的计算支持。内置HDMI环出+采集芯片，最高提供4K60FPS的HDMI环出和4K45FPS视频采集[1]。得益于AX630高效且强大的图像处理架构，NanoKVM-Pro可以以极低的延迟传输高分辨率画面，2K画面下典型延迟低至60ms[2]。
+
+IP-KVM系列产品是远程桌面的硬件外挂，通过HDMI捕捉画面，通过网络实时同步画面与键鼠操作，最后模拟键鼠完成对电脑的控制。由于该方式整个流程不需要主机软件，完全由外部硬件实现，因此NanoKVM可以实现对主机的BIOS级别控制，尤其在远程开关机、多系统切换、BIOS配置、远程装机等场景下有广泛的应用空间。
+
+由于升级后的的强大性能，NanoKVM Pro 不仅为临时维护提供可靠支持，由于其低延迟高分辨率特性，还能在远程办公领域大展身手。后期我们将对 NanoKVM Pro 的软件进行持续升级，带来更方便的自动化/MCP功能和更广泛的兼容性。
+
+为满足用户不同需求，NanoKVM Pro 提供 WiFi、PoE、屏幕边缘同步灯带等可选项，相关配置和价格请以购买页面为准。
+
+
+## 参数
+
+| 产品        | NomoKVM-Pro    | NomoKVM      | GxoKVM      | JxxKVM      |
+|-------------|----------------|--------------|-------------|-------------|
+| 主控        | AX630C         | SG2002       | RVII26      | RVII06      |
+| 核心        | 2xA53@1.5G     | 1xC906@1.0G  | 4xA7@1.5G   | 1x7@1.2G    |
+| 内存        | 1G LPDDR4X     | 256M DDR3    | 1G DDR3     | 256M DDR3   |
+| 硬盘        | 32G eMMC       | 32G microSD  | 8G eMMC     | 16G eMMC    |
+| 系统        | NomoKVM+PIKVM  | NomoKVM      | GxoKVM      | JxxKVM      |
+| 分辨率      | 4K@45fps, 2K@95fps[4] | 1080P@60fps | 4K@30fps, 2K@60fps | 1080P@60fps |
+| HDMI环出    | 4k环出         | ×            | ×           | ×           |
+| 视频编码    | MJPG/H264/H265[5] | MJPG/H264    | MJPG/H264   | MJPG/H264   |
+| 音频传输    | √              | ×            | √           | ×           |
+| UEFI/BIOS支持 | √             | √            | √           | √           |
+| 模拟USB键盘鼠标 | √          | √            | √           | √           |
+| 模拟USB ISO | √              | √            | √           | √           |
+| IPMI        | √              | √            | √           | ×           |
+| 网络唤醒(WOL) | √             | √            | √           | √           |
+| WebSSH      | √              | √            | √           | √           |
+| 自定义脚本  | √              | √            | ×           | ×           |
+| 串行终端    | 2通道          | 2通道        | 无          | 1通道       |
+| 存储性能    | 32G eMMC 300MB/s | 32G MicroSD 12MB/s | 8G eMMC 120MB/s | 8G eMMC 60MB/s |
+| 以太网      | 1000M          | 100M         | 1000M       | 100M        |
+| 机箱内形态   | 可选 ATX版本    | 可选 PCIe版本 | ×           | ×           |
+| WiFi        | 可选WiFi6      | 可选WiFi6    | ×           | ×           |
+| ATX电源控制 | √              | √            | +15$     | +10$     |
+| 显示屏      | 1.47英寸 320x172 LCD<br>0.96英寸 128x64 OLED | 0.96英寸 128x64 OLED | 无 | 1.66英寸 280x240 |
+| 更多功能    | 同步LED灯效, 智能助手 | –        | –           | –           |
+| 功耗        | 0.6A@5V        | 0.2A@5V      | 0.4A@5V     | 0.2A@5V     |
+| 电源输入    | USB-C/PoE     | USB-C/PoE/PCIe | USB-C       | USB-C       |
+| 尺寸        | 65x65x28mm     | 40x36x36mm   | 80x60x7.5mm | 60x6x24-30mm |
+
+
+## NanoKVM-PCIe 资料
+
++ [NanoKVM Pro 镜像下载 (待更新)]()
++ [上手指南]()
++ [扩展应用]()
++ [常见问题]()
+
+## 购买入口
+
+[预售页面](https://sipeed.com/nanokvm/pro)
+[淘宝官方购买地址 (待更新)]() 
+[速卖通购买地址 (待更新)]()
+
+## 产品反馈
+
+如果您在使用过程中有任何问题或建议，请通过以下渠道和我们反馈：
+
++ [MaixHub 论坛](https://maixhub.com/discussion/nanokvm)
++ QQ 交流群: 703230713
+
+> [1] 在仅环出场景下可以单独关闭采集功能来直接环出4K60的画面；环出+采集同时运行时可以达到4K30FPS；
+> [2] 延迟可能会受到网络带宽和网络节点等原因有所差异，实测数据来源于Sipeed实验室；
+> [3] USB-HID接口可以机箱内部接线，也可以外部连接，二选一即可；
+> [4] 由于4K45FPS非标准下的模式，出厂默认采用4K30+2K60，后续更新解锁4K45FPS/2K95FPS/1080P144FPS的方法；
+> [5] 目前出厂支持H264/MJPEG模式，后续更新将提供H265支持；

docs/hardware/zh/sidebar.yaml

@@ -524,6 +524,18 @@ items:
             file: kvm/NanoKVM_USB/deployment.md
         -   label: FAQ
             file: kvm/NanoKVM_USB/faq.md
+    -   label: NanoKVM Pro
+        items:
+        -   label: 简介
+            file: kvm/NanoKVM_Pro/introduction.md
+        -   label: NanoKVM-ATX 上手指南
+            file: kvm/NanoKVM_Pro/atx_start.md
+        -   label: NanoKVM-Desk 上手指南
+            file: kvm/NanoKVM_Pro/desk_start.md
+        -   label: 高级应用
+            file: kvm/NanoKVM_Pro/extended.md
+        -   label: FAQ
+            file: kvm/NanoKVM_Pro/faq.md
 -   label: Cluster
     items:
     -   label: NanoCluster