EdgeOS Desktop 桌面系统使用指南
| 项目 | 说明 |
|---|---|
| 适用对象 | DshanPI-CanMV_V3 用户、演示人员和应用集成工程师 |
| 文档基线 | EdgeOS Desktop v0.7.5 |
| 更新日期 | 2026-08-22 |
| 显示分辨率 | 640 × 480 |
系统固件位于配套资料的 03_开发系统固件/02_RT-Smart定制GUI固件 目录。烧录方法请参阅更新 EMMC 系统。
桌面源码地址:https://github.com/dshanpi/EdgeOS_Desktop.git
视觉AI交换协议VAXP示例程序:https://github.com/dshanpi/vaxp-host-sdk
完整系统SDK获取地址:资料包中的 10_SDK/01_基于RT-Smart的MicroPython系统
1. 系统概览
DshanPI EdgeOS Desktop 是运行在 DshanPI-CanMV_V3 上的横屏触控桌面。它将相机、离线 AI 推理、云平台模型部署、网络摄像机、UART/VAXP 调试、相册、画板、系统设置和安全 OTA 集成到同一个入口中。
系统提供以下两种使用模式:
| 模式 | 使用方式 | 适用场景 |
|---|---|---|
| AI 桌面模式 | 通过触摸屏直接运行相机和本地 AI 应用 | 产品演示、算法体验、外设联调和嵌入式部署 |
| MicroPython 开发模式 | 运行预加载的 MicroPython,配合 CanMV IDE 或串口进行 Python 开发 | 脚本调试、快速验证和二次开发 |
AI 桌面与 MicroPython 会使用相同的显示、摄像头、VB 内存和 OSD 资源,因此同一时间只能运行一种模式。
1.1 模式切换方式
当前固件支持在上电时通过按键选择运行模式。启动判断位于 RT-Smart BSP 层,不依赖桌面是否已经运行。
| 按键 | GPIO | 启动行为 | 是否修改默认模式 |
|---|---|---|---|
| KEY2 | GPIO18 | 本次启动临时进入 MicroPython 开发模式 | 否 |
| KEY3 | GPIO29 | 上电时持续按住约 2 秒,在 AI 与 MicroPython 之间切换 | 是 |
按键位置以开发板 PCB 上的 KEY2、KEY3 丝印为准。不同硬件版本的布局可能不同,请勿仅依赖“左上角”等方位描述。

1.2 使用 KEY2 临时进入 MicroPython
- 将开发板完全断电。
- 按住
KEY2。 - 保持按下并重新上电。
- 等待系统进入 MicroPython/CanMV 开发环境后松开按键。
KEY2 只影响本次启动,不会改写 /data/boot_mode.conf:
- 如果保存的默认模式为 AI,不按 KEY2 再次启动时会自动恢复 AI 桌面。
- 如果默认模式已通过 KEY3 切换为 MicroPython,下次仍会进入 MicroPython。
KEY2 是临时救援入口,适合在 AI 桌面无法启动、需要连接 CanMV IDE,或只想临时运行 Python 脚本时使用。
1.3 使用 KEY3 永久切换默认模式
- 将开发板完全断电。
- 按住
KEY3。 - 保持按下并重新上电,连续按住约 2 秒。
- 系统会在
AI与MicroPython Developer之间切换并保存默认模式。 - 本次启动立即进入切换后的模式,后续正常上电也会保持该模式。
- 如需切回,再次执行 KEY3 上电长按操作。
KEY3 在 2 秒前松开不会切换模式。默认模式保存在:
/data/boot_mode.conf
配置文件不存在或内容无效时,系统默认进入 AI 桌面。如果 KEY2 与 KEY3 同时按下,KEY2 优先:本次进入 MicroPython,且不会切换已保存的默认模式。
1.4 进入 MicroPython 后
在电脑端打开 CanMV IDE,选择开发板对应的连接端口并连接 REPL,然后打开或新建 .py 文件运行。离开前请先停止正在运行的 Python 脚本。
- 通过 KEY2 临时进入且默认模式为 AI:正常重启且不按键即可返回桌面。
- 保存的默认模式为 MicroPython:按住 KEY3 上电约 2 秒,将默认模式切回 AI。
当前固件仅支持上电期间的按键切换。系统运行过程中通过长按 KEY3 自动重启并切换模式,仍属于后续扩展能力。
2. 首次使用
2.1 上电前检查
- 确认显示屏、触摸屏和摄像头排线连接牢固。
- 如需使用网络功能,请安装受支持的 Wi-Fi 模块并准备可用的无线网络。
- 如需使用 UART 或 VAXP,请确认对端使用 3.3 V TTL 电平并连接公共地线。
- 使用稳定电源供电。录像、OTA 或模型加载期间请勿突然断电。
2.2 桌面快速上手
- 确认默认模式为 AI,正常上电且不按启动模式按键,等待桌面和状态栏出现。
- 上下滑动应用区域,浏览全部应用。
- 点按应用图标进入应用。
- 应用左上角通常提供返回按钮;点按后会释放相机、显示或串口资源并返回桌面。
- 首次使用建议依次完成
设置 → 语言、设置 → 日期与时间、设置 → Wi-Fi和设置 → 默认摄像头。
启动原生 AI 应用时,桌面会暂时停止并显示加载遮罩。模型加载完成后进入实时画面;退出应用时桌面重新启动,并恢复离开前的滚动位置。这是正常的资源交接过程。