Translate通过 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 喔。
如果有其他程序正在运行的话，需要先点停止，等程序断开了后（代码块前的 * 号消失），再点运行。