Translate通过 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 盘出现才能使用 |
| 2022-07-13 | dalaoshu | 更新到最新的 0.5.1 了 |
使用 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 盘设备在传输大文件后可能会因为没有正常关机而丢失文件，并且需要 reboot 重启才会出现系统创建的文件。
该 U 盘目录对应的是板子上的 linux 系统 /root/ 目录，这里 main.py 是默认的开机脚本，wpa_supplicant.conf 是 WIFI 配置，最新系统支持 /root/app/main.py 文件夹优先于 main.py 脚本启动。
- 如果没有出现 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
如何运行 Python代码
点击选择代码块，点击上方工具中的运行，即可运行代码并输出结果，运行后会出现 * 表示程序正常运行。
如何停止刚才运行的 Python 代码
选择正在运行的代码，点击上方工具栏中的停止，即可停止运行代码，快捷键是按两下 ii 喔。
如果有其他程序正在运行的话，需要先点停止，等程序断开了后（代码块前的 * 号消失），再点运行。