安装 IDE

  • 修改与2022年七月七日

下载站链接:下载 MaixPy3 IDE
百度网盘下载链接:链接:点我

为什么要使用 IDE ?

在没有 IDE 的时候,我们是这样编程的;这是每一只远古程序猿都必备的开发技能。

上述命令行的编程方式是上世纪 80 年代流行的开发方式,建议在有一定的 linux 基础后再来使用会比较好。
但 2022 现代 IDE 工具的重点应该是传达出 Python 代码所运行的结果或效果。

如果你是一名开发者,你要如何教会初学者使用你的代码?像你一样使用命令行敲出来看实际的效果吗?

  • 对初学者来说,这一定是一场灾难,所以我们需要 IDE 来结束这一场悲剧。

那么 MaixPy3 IDE 是什么?

它是一套基于 jupyter 实现的 Python3 集成开发环境,意在帮助用户通过电脑编写 Python 代码或阅读运行他人提供的 jupyter notebook 文档后,接上硬件后点击【▶ 运行】可以实时呈现如下效果图。

example

为了方便新入门的同学进行学习,在 Jupyter 文档中你可以单步执行代码,保留输出的结果,还能将屏幕显示的内容展示出来。

软件具备的特点如下:

  • 通过 TCP/IP 连接开发板,支持在本机运行 Python 代码,实时反馈开发板的运行结果或图片
  • 通过 jupyter notebook 文档可以保存每一次的运行结果,方便知识的传播
  • 继承 ipython 实现 Python 语法的高亮和补全功能(可以按 tab 进行补全或提示)

如何安装 MaixPy3 IDE ?

软件安装方法和注意事项要严格看本文说明(大佬鼠宣)

MaixPy3 IDE 的构成主要如下:

  • 一个在后台运行的托盘程序。
  • 一个 jupyter 服务程序。

用户使用与排查流程主要如下:

  • 确认所用的系统平台,确定安装方法
  • 确认所用的开发硬件,查看对应的系统配置方法
  • 确认系统防火墙没有阻止 TCP 的 18811 和 18812 端口,不清楚就关闭网络防火墙或安全软件
  • 确认硬件的 MaixPy3 的 Python 包和电脑上的 IDE 版本为 0.4.0 以上
  • 确认 所用硬件的 连接和配置方法,确认没有被杀毒程序给阻止且已经授予程序权限
  • 若是仍然出现问题,将上述流程打包起来反馈给社区并@管理员解决

关于 Windows 平台的安装方法

在文章开头处下载即可。

注意事项:

  • 只支持 Windows7 或 Windows10 32 位以上的系统
  • 需要内核为Chromium的浏览器,比如 Microsoft Edge 或 Chrome。
  • Windows11 测试样本极少,需要慎重选用

可以看下面的视频来看具体操作:

补充说明:

  • 安装完 IDE 后务必安装弹出窗口的驱动
  • 记得像视频中一样卸载掉对应的 ADB 驱动

若下载站下载很慢,可以在文章开头处获取百度云链接

2022年1月15日 收到用户的反馈点

曾经有自己手动配置过环境的同学,需要在删除你系统的 C:\Users\(改成你电脑的用户名)\AppData\Roaming\jupyter\kernels\rpyc 防止调用核心时调用了过去的旧核心导致错误发生。

关于 Mac 和 linux 其他平台的安装方法

如果你不喜欢提供的 pyinstaller 打包的版本,可以自行配置 python 、jupyter 、ikernel 等基础环境,自行 pip 手动安装和配置环境。
但是需要你具备一定的 python 基础,请阅读 rpyc_ikernel 完成安装即可,手动安装脚本的方法如下:

pip install rpyc_ikernel
python -m rpyc_ikernel.install

此时执行 jupyter notebook 或 lab 即可。

MaixPy3 IDE 界面介绍

下面介绍一下软件的工作区域和环境。

程序主界面介绍

IDE_2

  1. 为文件选择区,点击即可进入 Jupyter 文档中
  2. 为文件上传,是将文件上传到 MaixPy3 IDE 的工作区当中,并不是将文件上传到开发板中
  3. 为新建文件或者是文件夹
  4. 退出 MaixPy3 IDE。直接关闭浏览器的话 MaixPy3 IDE 是还会在后台中运行的

新建文件

MaixPy3 IDE (jupyter) 新建文件(上图中的2)的时候,可以选择多个 Python 执行核心。

IDE_2

  1. 选择 Python3 的话此时里面的相关代码是运行在本机上的。
  2. 选择 RPyc-python,此时相关代码运行在板子上

jupyter notebook 文档界面

  1. 单元格工具栏,可以对单元格进行复制、粘贴、运行、停止等操作
  2. 当前单元格的属性,可以切换单元格属性为 代码 或者 markdown
  3. 显示当前文档运行代码属性单元格时所使用的内核
  4. 蓝色边框表示单元格处于命令模式。绿色边框表示单元格为编辑模式
Jupyter 用法简介 与 vim 类似,jupyer 有命令模式和编辑模式
  • 通用:
      Shift+ Enter :运行单元格,且以命令模式切换到下一个单元格
      Ctrl + Enter :运行单元格,且进入命令模式
  • 编辑模式中:
      Esc :进入命令模式
  • 命令模式中:
      h :打开帮助
      Enter :进入编辑模式
      x :剪切单元格
      c :复制单元格
      v :粘贴单元格
      dd :删除整个单元格
      ii :终止运行
  • 借助于 notebook 文档,你可以看到编辑者的文本描述、代码和相关运行结果,非常适合新人边看边学

    编辑者文本描述
    文本描述

    相关代码实例,直接点击运行就可以看到
    实例代码

    图片展示结果,直接点击运行可以复现
    运行结果

    这也是 jupyter 的魅力之一吧,有兴趣的话也可以直接分享 ipynb 文件 来向他人展示你的代码


    注意 MaixPy3 IDE 的 jupyter notebook 的服务是运行在主机上的,因此所有相关文件和工作区都是在本机上的

    [附录]遇到问题应该如何解决?

    为了降低初学者的搭建和上手时间,我们做了大量的努力,但仍然无法完全解决每个人因环境差异而可能导致的不同问题,这里对 IDE 的工作原理做一些解释,它实际上就是打包的 (python + jupyter notebook + rpycikernel ).exe 帮你省了安装配置的时间。


    IDE 连接原理

    这里我们以典型硬件 V83X 和 R329 的为例。

    因为 V83X 因为支持 usb adb forward 功能,可以通过转发 TCP/IP 地址进行 IP 映射的端口绑定;而 R329 只能通过 TCP/IP 地址进行连接。但从设计上来说 IDE 只支持 TCP/IP 地址的连接方法,所以要确保 TCP 的远程调用端口 18811 和 18812 图传端口没有被防火墙阻止,那么如何确认呢?

    最起码的就是互相 ping 对方的 IP 确保该 IP 下的通路可行。如果 IP 确定是可以连通的,则我们需要确定远程调用的服务是否存在。

    通常里面需要一个 rpyc + mjpg 的服务去维持远程调用,如果是 V83X 则会自动经过 adb shell 完成调用 实现在 github 这里;如果是 R329 则需要手动启动该服务,或配置成开机自动启动,从而避免下次手动启动。

    如果遇到 IDE 链接失败,就先使用板子所运行的 linux 系统中的 ps 命令检查维持 IDE 链接的 Python 程序(python3 -c from maix import mjpg;mjpg.start();)是否存在(如 S 表示正在运行)。可以参考下图中的命令

    若是通道+服务均正常,那 IDE 就一定可以连上,还需要注意的就是 IDE 默认连接的 IP 地址是 localhost;如果你本机的网卡环境比较混乱,可能你需要在 IDE 里手动指定一下 IP 才能确保正确连接上,如:$connect("192.168.0.23")

    下图为 IDE 通过无线网在 Maixsense 上运行代码的结果,同样也适用于在 V831 上。只是说明一下可以指定 IP 然后通过无线运行(需要确定板子上已经有python3 -c from maix import mjpg;mjpg.start();在运行,没有的话可以手动执行一下 python3 -c "from maix import mjpg;mjpg.start();"

    结语

    MaixPy3 IDE 依赖于 jupyterrpyc_ikernelMaixPy3 开源仓库实现,目的是为了让新用户更直观地运行代码,感兴趣的可以自行了解。

    其实所谓的 IDE 就是 jupyter 的打包版本,知道了工作机制后,还不赶紧用起来?