使用 MaixPy3 IDE 连接 MaixII-Dock
时间 | 负责人 | 更新内容 |
---|---|---|
2021-12-3 | Rui | 制定文档初稿 |
2021-12-7 | 大老鼠 & Ray | 微调排版及审核 |
2021-12-8 | Rui | 添加 IDE 基本的使用介绍,MaixPy3 入门目录 |
2022-01-14 | dalaoshu | 配合 IDE 更新优化了用户使用体验 |
2022-01-17 | dalaoshu | 根据小徐同学的视频反馈,修订了用词和补充 SD 卡说明 |
2022-03-02 | Rui | 添加 MaixII-Dock 开箱视频,修改部分表述错误 |
2022-04-14 | Coty | 添加 main.py 会被 kill 掉的解决方法 |
2022-06-09 | dalaoshu | 重新强调了 m2dock 必须有 U 盘出现才能使用 |
产品宣传
开箱说明
使用前请仔细阅读以下内容,可以减少很多疑问
避坑要点(重要)
- 准备好可以启动系统的卡,如购买已烧录好系统的内存卡,可在购买时选择预烧录套餐(没有的同学需要自行烧录)。
- 烧录或更新到最新 MaixPy3 镜像,确认
pip list
中的 maixpy3 包版本大于 0.4.9 以上。 - 检查 USB 线和 USB 口是正常可用的,确定板子通电并插入电脑后,驱动有提示,屏幕有背光,硬件无损坏。
- 安装好 MaixPy3 IDE 软件,确保版本大于 0.4.0 ,安装的时候会提示你安装驱动。
- 确认安装软件时会弹出驱动安装程序,成功安装相关 adb 驱动后,连上硬件后在电脑中就会显示一个虚拟 U 盘,没有 U 盘出现不要继续,重启或重来直到 U 盘出现了再继续操作。
- 确认 adb 终端程序和相关服务存在后,就可以直接运行 IDE 软件自带的例程了。
- 将代码写进 main.py 后,给 MAIXii-Dock 上电,会自动执行 main.py 的代码。如果想继续执行 main.py 的话,那么此时不要开启 jupyter 的 RPyc-Python ,否则会将 main.py 给 kill 掉。 如果自己的 main.py 不能成功执行,首先先检查是否开启了 maixpy3_notebook,如若开启那么将其停用,然后重新上电即可。
停用操作如下:
准备工作
安装 MaixPy3 IDE 软件,它会在安装时提示用户安装驱动,安装好后会自动调用本机的浏览器弹出 jupyter notebook 的工作区,也就是你现在看到的文档,没有弹出可以点右下角托盘查看 IP 后手动进入。
使用一条可以传输数据的 Tpye-C 数据线(如购买时附带的线)。 不可以是充电线,或者转接头,尽量不要使用延长线或转接数据线。
插入烧录过 maixpy3 系统的 SD 卡。
将 板子 与 电脑 通过 OTG USB 口连接,确认设备通电亮起(power)电源红灯,请看下图红圈别接错。
确认板子屏幕出现 logo 和二维码(wiki)表示系统启动并已工作,此时电脑会弹出一个 U盘 盘符 ,这意味着板子的系统已经准备就绪。没有出现虚拟U盘的选项的话直接查看下一步
电脑若弹出U盘虽坏或者需要修复的话,不用理会,可修也可以不修。 虚拟 U 盘设备在传输较大文件可能会因为没有完整写入后因其他原因断开连接而丢失文件。
虚拟U盘里的默认内容
该 U盘 目录对应的板子运行 linux 系统的 /root/ 目录;这里 main.py 是默认执行的开机脚本,wpa_supplicant.conf 是 WIFI 配置信息。
如果没有出现 U盘 盘符(没有 U 盘出现等于 ADB 驱动有问题,这是连不上 IDE 的),则需要按下图手动卸载一下 Android ADB Interface 手机驱动(常见于 XX 手机助手)。或者检查一下电脑有没有其他应用占用了 adb 端口。又或者可以尝试其他 USB 接口。
找到它,勾选卸载驱动即可,此时 U 盘跳出,系统准备就绪,没有出现就去重装驱动和卸载。
如果 U 盘还是没有如上述步骤出现,可以尝试换个口,重烧烧录系统后重启设备或考虑换台电脑操作。这可能是个别系统驱动不兼容导致的,有问题的话可以在 bbs.sipeed.com 发帖给 @ 管理员帮忙解决。
再三强调!!!板子必须满足开机 logo 、二维码画面或摄像头、发出 usb 驱动声音、安装 adb 驱动、电脑弹出 U 盘才能使用 IDE 开发,否则必定连接出错!!!
开始代码
运行前的可以检查一下运行环境是否正常,下述描述只与 Windows 平台有关,其他平台不需要。
- IDE 0.4.0 软件启动时会附带一个 keep_adb.exe 命令行终端的程序提供给熟悉 linux 终端操作开发板的同学。 如果板子连接到电脑后没有成功弹出 U盘 盘符,那么命令行终端会一直提示没有发现设备。 这时应该重新上面的准备工作确定弹出 U盘 盘符再接着下一步。
- IDE 0.4.2 后 keep_adb 服务会自动调用 adb 配置映射(forward)端口(22,18811,18812)。
IDE 的内核切换成 Rpyc-python
可以在交互终端(即那个adb终端)输入
ps | grep mjpg
查看是否存在下图红框所指示的服务,存在的话说明板子连接的 ide 服务运行如果发现不存在 IDE 服务,可以在交互终端手动执行
python -c 'from maix import mjpg;mjpg.start();'
来启动服务,并把现象汇报到社区,目前发现该现象主要出现在 Windows 10 系统之间的差异上。- 确认系统防火墙是否阻止了软件底层所需要 TCP 18811 18812 的端口号,主要用于运行程序和图像传输。
想知道更多,可以点此查看关于 MaixPy3 IDE 的更加详细的介绍,此处不再赘述。
如何运行 Python 代码
点击选择代码块,点击上方工具中的运行,即可运行代码并输出结果,运行后会出现 * 表示程序正常运行。
如何停止刚才运行的 Python 代码
选择正在运行的代码,点击上方工具栏中的停止,即可停止运行代码,快捷键是按两下 i 喔。
如果有其他程序正在运行的话,需要先点停止,等程序断开了后(代码块前的 * 号消失),再点运行。