使用 MaixPy3 IDE 连接 MaixII-Dock

使用前请仔细阅读以下内容，可以减少很多疑问

避坑要点（重要）

1. 检查 USB 线和 USB 口是正常可用的，确定板子通电并插入电脑后，驱动有提示，屏幕有背光，硬件无损坏。
2. 准备好可以启动系统的卡，如购买已烧录好系统的内存卡，可在购买时选择预烧录套餐（没有的同学需要自行烧录）。
3. 烧录或更新到最新 MaixPy3 镜像，确认 pip list 中的 maixpy3 包版本大于 0.4.0 以上。
4. 安装好 MaixPy3 IDE 软件，确保大于 0.4.0 版本。
5. 安装软件时会弹出驱动安装程序，请确认好驱动安装，连上硬件后启动系统后就会弹出虚拟 U 盘。
6. 确认 adb shell 终端程序、相关服务存在后，就可以直接运行 IDE 软件自带的历程了。

初期准备工作

1. 安装 MaixPy3 IDE 软件，它会在安装时提示用户安装驱动，安装好后会弹出 jupyter notebook 的工作区，也就是你现在看到的文档。

1. 选择一条可以传输数据的 Tpye-C 数据线（如购买时附带的数据线），不可以是充电线，或者转接头，不要延长或转接数据线。

1. 插入带有 maixpy3 系统的 SD 卡。

1. 将 板子 与 电脑 通过 OTG USB 口连接，确认设备通电亮起（power）电源红灯，请看下图红圈别接错。

1. 确认屏幕出现 logo 和二维码（wiki）表示系统启动并已工作，此时电脑会弹出一个 U 盘，这意味着板子的系统已经准备就绪。（在 Windows 平台初次使用需要通过步骤 5 卸载一下驱动即可弹出 U 盘）

不用理会或修复，出问题重试就行，虚拟 U 盘设备在传输大文件后可能会因为没有正常关机而丢失文件。

该 U 盘目录对应的是板子上的 linux 系统 /root/ 目录，这里 main.py 是默认的开机脚本，wpa_supplicant.conf 是 WIFI 配置。

1. 如果没有出现 U 盘，则需要按下图手动卸载一下 Android ADB Interface 手机驱动（常见于 XX 手机助手）。

找到它，勾选卸载驱动即可，此时 U 盘跳出，系统准备就绪，之后遇到的问题与底层硬件没有任何关系！！！

如果 U 盘还是没有如上述步骤出现，可以重烧系统或重启设备或考虑换台电脑操作，有可能是个别系统驱动不兼容导致的，实在是解决不了，可以在 bbs.sipeed.com 汇报给 @ 管理员帮忙解决。

如何运行代码

运行前的可以检查一下运行环境是否正常。

最新 0.4.0 软件启动时会附带一个 keep_adb.exe 命令行终端的程序提供给熟悉 linux 终端操作开发板的同学。

• 与板子连接的 adb 服务是否工作，判断方法可以在交互终端输入 ps | grep mjpg 查看是否存在下图红框所指示的服务。

• 确认系统防火墙是否阻止了软件底层所需要 TCP 18811 18812 的端口号，主要用于运行程序和图像传输。

想知道更多，可以点此查看关于 MaixPy3 IDE 的更加详细的介绍，此处不再赘述。

如何运行 Python代码

点击选择代码块，点击上方工具中的运行，即可运行代码并输出结果，运行后会出现 * 表示程序正常运行。

如何停止刚才运行的 Python 代码

选择正在运行的代码，点击上方工具栏中的停止，即可停止运行代码，快捷键是按两下 ii 喔。

如果有其他程序正在运行的话，需要先点停止，等程序断开了后（代码块前的 * 号消失），再点运行。