通过 IDE 连接 MaixII-Dock
时间 | 负责人 | 更新内容 |
---|---|---|
2021-12-3 | Rui | 制定文档初稿 |
2021-12-7 | dls & Ray | 微调排版及审核 |
2021-12-8 | Rui | 添加 IDE 基本的使用介绍,MaixPy3 入门目录 |
2022-01-14 | dls | 配合 IDE 更新优化了用户使用体验 |
2022-01-17 | dls | 根据小徐同学的视频反馈,修订了用词和补充 SD 卡说明 |
2022-03-02 | Rui | 添加 MaixII-Dock 开箱视频,修改部分表述错误 |
2022-04-14 | Coty | 添加 main.py 会被 kill 掉的解决方法 |
2022-06-09 | dls | 重新强调了 m2dock 必须有 U 盘出现才能使用 |
2022-07-13 | dls | 更新到最新的 0.5.1 了 |
2023-02-07 | wonder | 添加版本 0.5.4 之后的镜像联网方法 |
使用 MaixPy3 IDE 连接 MaixII-Dock
产品宣传
开箱说明
使用前请仔细阅读以下内容,可以减少很多疑问
避坑要点(重要)
- 检查 USB 线和 USB 口是正常可用的,确定板子通电并插入电脑后,插入电脑驱动有提示,屏幕有背光有 画面出现,硬件接线电源无损坏。
- 准备好可以启动系统的卡,如购买已烧录好系统的内存卡,可在购买时选择预烧录套餐(没有的需要烧录系统方法)。
- 烧录或更新到最新 MaixPy3 镜像,确认
pip list
中的 maixpy3 包版本大于 0.5.0 以上。 - 安装好 MaixPy3 IDE 软件,确保大于 0.5.0 版本。
- 安装软件时会弹出驱动安装程序,请确认驱动安装完毕,连上硬件后启动系统后就会弹出虚拟 U 盘。
- 上一步操作未出现虚拟 U 盘的话, Windows 用户需要手动前往设备管理器卸载 ADB 驱动且勾选上删掉其驱动,重启电脑后才能够弹出 U 盘。
- 没有出现 U 盘的话那么电脑通过 OTG 接口是没法操作 M2Dock 的,因此务必重复上述的 5、6 直到看到 U 盘才能继续阅读下面的内容
- 确认 adb shell 终端可用(需要安装驱动),并确认 mjpg 服务存在后,就可以开始使用了。
初期准备工作
- 安装 MaixPy3 IDE 软件,它会在安装时提示用户安装驱动,安装好后会弹出 jupyter notebook 的工作区,也就是你现在看到的文档。
- 选择一条可以传输数据的 Tpye-C 数据线(如购买时附带的数据线),不可以是充电线,或者转接头,不要延长或转接数据线,插入支持输出 500ma 以上电流的 USB 口,遇到无法解决的问题可以换线换口换电脑。
- 插入带有 maixpy3 系统的 SD 卡,所烧录的系统版本大于 0.5.1 即可。
- 将 板子 与 电脑 通过 OTG 标识的 USB 口连接,确认设备通电亮起(power)电源红灯,请看下图红圈别接错 USB 线,OTG 标识的丝印在板子背面。
- 确认屏幕出现 logo 或二维码(wiki)表示系统启动并已工作,此时电脑会弹出一个 U 盘,这意味着板子的系统已经准备就绪。(在 Windows 平台初次使用需要通过步骤 5 卸载一下驱动即可弹出 U 盘)
可以通过这个虚拟 U 盘在电脑和开发板之间传输文件,但是需要注意的是设备在传输文件后,最好先在电脑上弹出 U 盘、然后复位开发板来刷新板子里面的文件系统,可以避免文件损坏、文件错误这种现象。
该 U 盘目录对应的是板子上的 linux 系统 /root/ 目录,传输文件后自己可以在板子的目录中查看到。
- 如果没有出现 U 盘,意味着驱动存在异常,则需要按下图手动卸载一下 Android ADB Interface 手机驱动(常见于 XX 手机助手)。
找到它,勾选卸载驱动即可,此时 U 盘跳出,系统准备就绪,之后遇到的问题与底层硬件没有任何关系!!!
如果 U 盘还是没有如上述步骤出现,可以重烧系统或重启设备或考虑换台电脑操作,有可能是个别系统驱动不兼容导致的,实在是解决不了,可以在 bbs.sipeed.com 汇报给 @ 管理员帮忙解决。
如何运行代码
运行前的可以检查一下运行环境是否正常。
IDE 软件启动时会附带一个 keep_adb.exe 命令行终端的程序提供给熟悉 linux 终端操作开发板的同学。
IDE 0.4.2 后 keep_adb 服务会自动调用 adb 配置映射(forward)端口(22,18811,18812)。
与板子连接的 ide 服务是否工作,判断方法可以在交互终端输入
ps | grep mjpg
查看是否存在下图红框所指示的服务。如果发现不存在 ide 服务(
python -c 'from maix import mjpg;mjpg.start();'
),可以手动运行服务,并把现象汇报到社区,目前发现该现象主要出现在 Windows 11 系统之间的差异上。
- 确认系统防火墙是否阻止了软件底层所需要 TCP 18811 18812 的端口号,主要用于运行程序和图像传输。
想知道更多,可以点此查看关于 MaixPy3 IDE 的更加详细的介绍,此处不再赘述。
选择 RPyc-Python 核心表示在板子上运行 Python 程序
将 IDE 的内核应切换成 RPyc-python
简单 juputer notebook 快捷键说明
这里介绍每个方框称为单元格,单元框左侧会有 蓝色(命令模式) 或 绿色(编辑模式) 两种颜色。
蓝色单元格
(命令模式)
绿色单元格
(编辑模式)
通用用法:
- Shift+ Enter:运行单元格,且以命令模式切换到下一个单元格
- Ctrl + Enter:运行单元格,且进入命令模式
编辑模式中:
- Esc:进入命令模式
命令模式中:
- h:打开帮助
- Enter:进入编辑模式
- x:剪切单元格
- c:复制单元格
- v:粘贴单元格
- dd:删除整个单元格
- ii:终止运行
- a:向光标所在单元格上方添加单元格
- b:向下添加
- m:使得单元格变成 markdown 状态
如何运行 Python 代码
点击选择代码块,点击上方工具中的运行,即可运行代码并输出结果,运行后会出现 * 表示程序正常运行。
如何停止刚才运行的 Python 代码
选择正在运行的代码,点击上方工具栏中的停止,即可停止运行代码,快捷键是按两下 ii 喔。
如果有其他程序正在运行的话,需要先点停止,等程序断开了后(代码块前的 * 号消失),再点运行。