Update NanoKVM-PCIe Doc

This commit is contained in:
BuGu
2024-12-06 18:42:01 +08:00
parent e242f16f0b
commit 83b649b4ab
11 changed files with 250 additions and 10 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 141 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1022 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 198 KiB

View File

@@ -5,27 +5,43 @@ keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
## 异常修复
+ 无法获取IP地址
### 无法获取IP地址
1. Lite用户首先检查有无插卡, Lite 版本默认不带卡出货,需用户自备TF卡,按照[此处](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/flashing.html)的说明烧卡后重试;
2. 检查网络交换机是否支持100M, 部分新交换机不支持100M的连接, 请更换交换机后重试
3. 尝试更换电源, 部分电源可能导致 NanoKVM 获取不到IP, 或影响网速
+ 登录浏览器界面后,无画面
### 登录浏览器界面后,无画面
1. 确保HDMI有输出信号, 重新拔插HDMI线缆
2. 进入网页终端,执行 `/etc/init.d/S95nanokvm restart` 重启服务。
3. 如果上述方式无法恢复正常,点击界面上的检查更新,更新应用
4. 早期内测版 Full NanoKVM 使用普通排线连接 HDMI 采集板,可能因接触不良导致检测不到 HDMI 信号,可按下图所示拆解,并重新连接排线
![](./../../../assets/NanoKVM/guide/Old_fix.png)
+ OLED上正常显示信息但无法打开网页
### OLED上正常显示信息但无法打开网页
1. 参考[这里](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html#%E8%8E%B7%E5%8F%96-IP)连接开发板
2. 输入指令`rm /etc/kvm/server.yaml`
3. 执行 `reboot` 重启系统
+ 早期内测版 Full NanoKVM ATX小板连接主机RESET引脚, 重启NanoKVM时主机可能被重启, 请断开RESET跳线
+ 早期内测版 Full NanoKVM 存在电流倒灌问题: 主机关机且USB无电源输出, 当连接辅助供电电源时电流会倒灌入主机
### BIOS 不识别HID键鼠
+ 部分主板BIOS要求HID键鼠设备带有BIOS标识,NanoKVM可在/boot下创建BIOS来启用该功能,
1. 执行`touch /boot/BIOS && restart`
### 关于内存
+ NanoKVM 总内存(RAM)空间为256MB, 其中视频图像处理使用一块专用的ion内存区域, 在用户空间查看内存会小于256MB
+ 固件版本号小于 1.3.0 的镜像仅为用户空间保留 128MB 的内存, 1.3.0以及之后的所有镜像, 内存大小扩展到158MB, 有利于Tailscale长时间运行, 请有需要的用户根据[这里](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/flashing.html)的步骤更新镜像
### 主机异常重启
+ 早期内测版 Full NanoKVM ATX小板连接主机RESET引脚, 重启NanoKVM时主机可能被重启, 请断开RESET跳线
### 电流倒灌
+ 早期内测版 Full NanoKVM 存在电流倒灌问题: 主机关机且USB无电源输出, 当连接辅助供电电源时电流会倒灌入主机
1. 首先建议设置主机关机后USB保持供电
2. Full版用户: 按下图位置使用电烙铁断开5V电阻或排针短接处, 仅使用辅助供电口供电
![](./../../../assets/NanoKVM/guide/fix2.png)
+ 尝试断电重启解决未知问题
+ 更新过程中如果出现断网等异常情况,可能导致更新失败,若旧应用也无法启动时,请参照以下解决方法:
### 尝试断电重启解决未知问题
### 更新过程中如果出现断网等异常情况,可能导致更新失败,若旧应用也无法启动时,请参照以下解决方法:
1. 参考[这里](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html#%E8%8E%B7%E5%8F%96-IP)连接开发板
2. 执行 `rm -r /kvmapp && cp -r /root/old/ / && mv /old/kvmapp`
3. 执行 `reboot` 重启系统
@@ -34,7 +50,8 @@ keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
1. 下载[update-nanokvm.py.zip](https://github.com/user-attachments/files/16939944/update-nanokvm.py.zip)并解压
2. 执行: `python update-nanokvm.py`
3. 等待更新完成
+ 若上述方法不能解决异常,请在论坛,GitHub或QQ群提出您的问题我们会耐心解答
### 若上述方法不能解决异常,请在论坛,GitHub或QQ群提出您的问题我们会耐心解答
## 反馈方式

View File

@@ -36,6 +36,6 @@ Full 版 NanoKVM 上包含 KVM-A/B 板,早期内测版和正式版存在硬件
NanoKVM 镜像基于 [LicheeRV Nano SDK](https://github.com/sipeed/LicheeRV-Nano-Build) ,使用 Buildroot 构建
镜像修改 Todo
## 镜像修改
## PiKVM 即将支持,敬请期待
Todo

View File

@@ -0,0 +1,86 @@
---
title: 简介
keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool, PCIe
update:
- date: 2024-12-5
version: v0.1
author: BuGu
content:
- Release docs
---
## 简介
![](./../../../assets/NanoKVM/introduce/NanoKVM-PCIe.png)
NanoKVM-PCIe 是 NanoKVM 的新形态, 自带 PCIe 挡板, 可以固定在机箱内部, 为台式机用户提供更好的体验。
NanoKVM-PCIe 在 NanoKVM-Cube的基础上添加可选的 WiFi, PoE功能(选配);自带 PCIe 插槽,可以从主板 PCIe 插槽取电;此外, 有线连接(ETH)也更加稳定, 符合更专业的需求。
NanoKVM 系列产品包含一个 HDMI 输入接口,可以被电脑识别为显示器,捕捉电脑画面;一个 USB2.0 接口连接电脑主机可被识别为键盘鼠标触摸板等HID设备同时使用TF卡多余存储空间挂载为一个U盘设备全系标配一个百兆网口用于视频和控制信号等的网络传输。PCIe版 NanoKVM 标配一个0.49英寸OLED, 实时显示各种状态信息, WiFi配网等各种信息。
为满足用户不同需求NanoKVM-PCIe 提供 WiFi 和 PoE 两个可选配模块, 购买时可自由搭配
## 使用场景
![](./../../../assets/NanoKVM/introduce/web_ui.gif)
+ 服务器管理:用于实时监控服务器,获取服务器运行状态,并对其加以控制;
+ 远程桌面、开关机NanoKVM 摆脱主机必须联网和系统软件的限制,作为主机外置硬件,直接提供远程控制的功能;
+ 远程装机NanoKVM模拟U盘设备可挂载装机镜像安装系统也可进入BIOS对电脑设置
+ 远程串口Full内测版未引出至接口NanoKVM引出两组串口可配合IPMI使用或连接其他开发板使用网页串口终端交互此外用户可自行拓展更多配件
+ 双电脑协同操作
## 参数
| 产品 | NanoKVM (PCIe) | NanoKVM (Full) | PiKVM V4 |
| --- | --- | --- | --- |
| 计算单元 | SG2002(RISCV) | LicheeRV Nano(RISCV) | CM4 (ARM) |
| 分辨率 | 1080P @ 60fps | 1080P @ 60fps | 1080P @ 60fps |
| 视频编码 | MJPEG, H264 | MJPEG, H264 | MJPEG, H264 |
| 视频延迟 | 90230ms | 90230ms | 100230ms |
| UEFI/BIOS | ✓ | ✓ | ✓ |
| 模拟USB键鼠 | ✓ | ✓ | ✓ |
| 模拟USB存储 | ✓ | ✓ | ✓ |
| IPMI | ✓ | ✓ | ✓ |
| Wake-on-LAN | ✓ | ✓ | ✓ |
| Tailscale | ✓ | ✓ | ✓ |
| WebSSH | ✓ | ✓ | ✓ |
| 自定义脚本 | ✓ | ✓ | - |
| ETH | 100M/10M | 100M/10M | 1000M/100M/10M |
| PoE | 选配 | 仅外部连接 | 1000M/100M/10M |
| WiFi | 选配 | - | ✓ |
| ATX电源控制 | 可直连机箱内9Pin电源针脚 | USB接口IO控制板 | RJ45接口IO控制板 |
| OLED显示 | 64*32 0.49" white | 128x64 0.96" white | 128x32 0.91" white |
| 串口终端 | 2路 | 2路 | - |
| Micro SD卡 | 有,开机即用 | 有,开机即用 | 有 |
| 功耗 | 0.2A@5V | 0.2A@5V | Peak 2.6A@5V |
| 电源输入 | 多种供电模式 | PC USB即可供电 <br> 也支持额外辅助供电 | 需要DC 5V 3A供电 |
| 散热 | 静音无风扇 | 静音无风扇 | 需要风扇主动散热 |
| 尺寸 | 66*57*18mm(不含挡板) | 40x36x36mm | 120x68x44mm |
## NanoKVM-PCIe 资料
NanoKVM 与 Sipeed [LicheeRV Nano](https://wiki.sipeed.com/hardware/zh/lichee/RV_Nano/1_intro.html) 使用相同SOC希望二次开发的小伙伴可在[这里](http://cn.dl.sipeed.com/shareURL/LICHEE/LicheeRV_Nano)查看更多资料
> NanoKVM 镜像在LicheeRV Nano SDK 和 MaixCDK 基础上构建,可以兼容使用 LicheeRV Nano 的资料反之LicheeRV Nano 或其他 SG2002 产品无法使用KVM软件。如果您想在 NanoKVM 上构建 HDMI 输入相关应用,请与我们联系,以获得技术支持。
NanoKVM-Cube 和 NanoKVM-PCIe 共用同一套镜像和应用, 自动适配不同的硬件版本
+ [NanoKVM 镜像下载](https://github.com/sipeed/NanoKVM/releases)
## 购买入口
[淘宝官方购买地址]() (待更新)
[速卖通购买地址]()(待更新)
[预售页面](https://sipeed.com/nanokvm/pcie)
## 产品反馈
如果您在使用过程中有任何问题或建议,请通过以下渠道和我们反馈:
+ [Github issues](https://github.com/sipeed/NanoKVM)
+ [MaixHub 论坛](https://maixhub.com/discussion/nanokvm)
+ QQ 交流群: 703230713

View File

@@ -0,0 +1,107 @@
---
title: 快速上手
keywords: NanoKVM, Remote desktop, Lichee, PiKVM, RISCV, tool
update:
- date: 2024-12-5
version: v0.1
author: BuGu
content:
- Release docs
---
## 开箱
![](./../../../assets/NanoKVM/unbox/PCIe_unbox.jpg)
NanoKVM-PCIe 包装内包含主机, 半高 PCIe 挡板, 两条 USBA-C线缆, 一条 HDMI 线缆, 一根天线, 16P 公对母排线, 4P 母对母排线和一把小螺丝刀
主机上包含杜邦跳线(2+4P), SMA 天线座
注: 上图是 NanoKVM-PCIe 带WiFi 带PoE 版本,不带 WiFi 版本会少一根天线, 挡板上少 SMA 天线座
## 接口介绍
俯视图:
![](./../../../assets/NanoKVM/unbox/PCIe-Interface1.png)
侧视图:
![](./../../../assets/NanoKVM/unbox/PCIe-Interface2.png)
机箱内部接口:
![](./../../../assets/NanoKVM/unbox/PCIe-Pin.jpg)
## 供电
+ NanoKVM-PCIe 有多种供电选择: USB HID直接供电, USB PWR IN辅助供电, PCIe 插槽取电, PoE 供电(选配) 请任选一种即可, 同时存在多路供电不会干扰 NanoKVM-PCIe 的运行
+ 如果需要USB HID直接供电,则需要在BIOS中设置主板关机 USB 常供电,否则会影响远程开机功能
+ NanoKVM-PCIe USB-PWR-IN CC 接口下拉5.1K电阻,可使用正规 PD 充电头供电。部分劣质PD电源存在烧坏 NanoKVM-PCIe 的风险。
## 接线
+ NanoKVM-PCIe 在接线上与 Cube 类似, 请在主机关机且断电的情况下安装 NanoKVM-PCIe
+ 使用一条 USB C to A 数据线连接远程主机和 NanoKVM 的 PC USB 接口(位于 HDMI 接口下方)
+ 使用附赠的 HDMI 线缆连接远程主机和 NanoKVM 的 HDMI 接口
![](./../../../assets/NanoKVM/unbox/hdmi.png)
+ 使用网线连接 路由器/交换机 与 NanoKVM
## 更新
### 更新镜像
> **Lite 版本需要准备 TF 卡并且烧录镜像后才能开始使用!**
Full 版本出厂时已经烧录了镜像,可以跳过此步骤。
镜像会不定期更新。建议更新到最新版本镜像,以获取更好的使用体验。
具体操作方式请参考 [烧录镜像](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/flashing.html)。
### 更新应用
新的应用往往带来更多功能或修复某些重要漏洞,建议您将 NanoKVM 应用更新到最新版本,具体操作方式请参考 [更新应用](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html)。
## 基础操作
### 如何获取IP地址
Full版NanoKVM自带OLED显示屏联网之后会在显示屏第一行显示IP地址
![](./../../../assets/NanoKVM/unbox/oled.jpg)
Lite版用户请参考[获取IP](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html#%E8%8E%B7%E5%8F%96-IP)
### 查看远程桌面
浏览器直接输入获取的IP进入登录页面默认账号密码为admin、admin登录后建议**先检查更新**(设置 -> 检查更新),详细步骤可参考 [更新应用](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/system/updating.html)。
Lite版用户或Full用户重新烧卡登录后页面上无远程画面请先升级应用后刷新网页即可开始使用
注: 建议使用Chrome浏览器其他浏览器可能出现无法显示画面或无法操作键鼠等兼容性问题
![](./../../../assets/NanoKVM/unbox/frist_update.png)
### 修改账号密码
**为保障您的信息安全,请在测试功能正常后修改账号密码**
![](./../../../assets/NanoKVM/unbox/unbox_9.png)
### ATX电源控制
Full 版套餐内包含了 NanoKVM-A/B 板,用于控制和查看主机开关机状态。
+ 顶板上的 5V LED蓝色指示 NanoKVM 的供电情况;
+ PWR LED绿色为主机的电源指示
+ POWER按键作用同主机的电源按键可以控制主机的开关机
+ RESET按键用主机的重启按键开机状态下按下RESET将强制重启主机
+ 网页端也可以查看并控制,参考[用户指南](https://wiki.sipeed.com/hardware/zh/kvm/NanoKVM/user_guide.html)

View File

@@ -438,6 +438,36 @@ items:
file: kvm/NanoKVM/system/configuration.md
- label: FAQ
file: kvm/NanoKVM/faq.md
- label: NanoKVM PCIe
items:
- label: 简介
file: kvm/NanoKVM/introduction.md
- label: 快速上手
file: kvm/NanoKVM/quick_start.md
- label: 用户指南
file: kvm/NanoKVM/user_guide.md
- label: 二次开发
file: kvm/NanoKVM/development.md
- label: 网络
items:
- label: Tailscale
file: kvm/NanoKVM/network/tailscale.md
- label: frp
file: kvm/NanoKVM/network/frp.md
- label: 静态 IP
file: kvm/NanoKVM/network/static_ip.md
- label: 系统
items:
- label: 系统介绍
file: kvm/NanoKVM/system/introduction.md
- label: 烧录镜像
file: kvm/NanoKVM/system/flashing.md
- label: 更新应用
file: kvm/NanoKVM/system/updating.md
- label: 配置文件
file: kvm/NanoKVM/system/configuration.md
- label: FAQ
file: kvm/NanoKVM/faq.md
# - label: Maix Audio
# items:
# - label: MA USB 16