mPython软件使用指南

①软件界面

一、软件界面的介绍

1.模式切换

硬件编程

Python3.6

Jupyter

python3.6模式细节补充（一般不使用该模式，此处可跳过）

Python3.6模式的界面

左侧指令分类栏

Python3.6模式的图形化指令分类分为： Python语法基础相关指令（循环、逻辑、数学、文本、变量） 高级指令（函数、列表、元组、集合、字典、引脚） 扩展指令

扩展功能介绍：点击“扩展”将会出现“添加”按钮，点击添加会出现以下界面 因为AI扩展都需要使用库文件，所以首次使用时需要点击“安装”。

安装完成后再点击“加载”，可以在左侧指令分类栏查看，如图所示：

Python库管理

点击打开Python库管理，可以选择推荐库或者PIP安装

推荐库可以直接选择软件所提供的库文件进行安装

也可以选择pip安装

推荐库或pip安装都可以自主选择安装源，默认为阿里云镜像安装源

终端

选择终端可直接再控制台中输入代码，并显示内容，多用于调试代码和测试，如图所示：

 

调试控制台

调试控制台可显示运行代码后反馈的信息，打印反馈信息，如图所示：

 

重启内核

如果发生卡死可以点击重启内核

 

界面显示模式

提供左右显示或者上下显示

2.文件

2.文件

新建文件

点击“文件”菜单栏“新建文件”

新建文件将会清除编程区内所有模块，点击“确定”

 

打开本地

点击“文件”菜单栏“打开本地”

选择mxml、xml结尾或者py结尾的文件，点击“打开”

加载对应的图形化代码

 

保存本地

点击“文件”菜单栏“保存本地”

选择保存mxml或者py文件（图形化的mxml模式与代码的py模式，需要注意的是，保存成图形化模式时可以将指令转换为代码，但保存成代码模式无法转换为图形化。）

点击保存

 

保存代码库

点击“文件”菜单栏“保存代码库”

保存代码库需要先登录用户，关于用户登录请查看“注册/登录”

跳转到： 注册/登录 — mPython 帮助文档 0.5.4 文档

用户登录后，输入将保存的代码库名称，点击确定，即可保存成功

代码库保存成功后点击查看，即可查看保存的代码库

 

掌控板文件

点击“掌控板文件”可查看掌控板内的文件

加载掌控板文件

掌控板内文件目录结构

点击“图形”按钮可回到图形化界面

3.教程

软件介绍

点击“教程”菜单栏“软件介绍”，即可查看软件使用的操作视频

帮助文档

点击“教程”菜单栏“帮助文档”，查看详细专业版说明文档。

在线论坛

点击“教程”菜单栏“在线论坛”，跳转到： 掌控板,创客教育,STEAM,编程教育

精品课程

点击“教程”菜单栏“精品课程”，即可查看海量的教学课程

点击选择查看其中的详细教程

教程的详细说明，点击加载程序即可加载相对应的代码

4.普通/教学切换

5.登录账号 点击右上角登录按钮 如已注册账号，直接输入用户名密码进行登录。 如未注册过账号，点击“注册”按钮进行注册 填写相关信息完成注册。   6.寻求帮助 用户登录后点击用户名称=>“寻求帮助”，可看到他人的求助信息，点击可查看详细说明 也可以在输入框搜索问题，选择问题查看 7.代码库 代码库中可以看到自己保存的代码库也可以看到其他用户分享的代码 点击加载程序即可在编程区域看到相应的代码   8.文件命名 可以给当前程序文件命名 9.代码模式 点击“代码”按钮即可进入代码编辑模式，点击“图形”按钮即可回到图形模式 在代码模式中点击左侧图标进入文件管理界面，可看到电脑文件及掌控板文件，电脑文件可以导入到掌控板里面，掌控板文件也可以导出到电脑 加载掌控板文件 加载完成，界面如下：   文件管理 代码模式中提供管理掌控板内文件的功能，可进行文件导入、导出、删除功能 导入：点击“导入”按钮选择电脑上的文件导入进掌控板，可选择多个文件一起导入 导出：点击掌控板文件中的复选框选择需要导出的文件，点击“导出”按钮 删除：点击掌控板文件中的复选框选择需要删除的文件，点击“删除”按钮，弹出提示是否删除文件 对话框，点击“确定”即可删除文件 电脑文件右键功能：选中文件点击右键可看到如下功能在编辑区打开 上传到板、上传并立即运行、删除文件、打开文件位置、刷新目录、新建文件、新建目录、重命名 掌控板文件右键功能：选中文件点击右键可看到如下功能运行程序、导出文件、浏览文件、删除文件、重命名 在空白区域点击右键，则出现：重新加载、刷新目录、新建文件、新建目录   代码编写 在编辑区输入代码，如果输入的代码是Python的关键字或者是掌控板库函数 将会有自动补全提示，代码编写好了之后，点击运行按钮即可看到效果 右侧五个小按钮的功能从上到下分别是：查找代码、退回编译前的上一步、退回编译后的下一步、代码放大、代码缩小 10.白天/夜间模式 在“设置”里面选择“开/关”即可看到对应效果 白天模式 夜间模式 11.高级设置 语言设置 点击高级设置后弹出对话框，即可看到第一个选项——语言设置。支持3种语言切换，简体中文、繁体中文、英语。   更换主控 点击高级设置后弹出对话框，即可看到第二个选项——更换主控，选择需要更换的主控即可 检查更新 点击高级设置后弹出对话框，即可看到第三个选项——检查更新。 已是最新版本界面： 发现新版本界面：点击安装即可完成更新 初始化库 点击高级设置后弹出对话框，即可看到第四个选项——初始化库。可恢复原始资源库 二、脚本区 图形化指令分类分为： 掌控板相关的指令（输入、显示、音乐、RGB灯、Wi-Fi、广播） Python编程基础语法模块（循环、逻辑、数学、文本、变量） Python编程高级语法模块（函数、列表、元组、集合、字典、引脚、微信小程序） 扩展模块 扩展功能介绍：点击“扩展”将会出现“添加”按钮，点击添加 出现如下界面，扩展分类“硬件扩展”，“应用扩展” 硬件扩展包含一些通用传感器以及tello无人机、yeelight灯等 应用扩展包含onenet物联网、科大讯飞语音接口、心知天气等 加载一个扩展 即可在左侧指令分类栏中看到加载的扩展分类 还可以自己定制专属积木 详细使用请看教程链接： 号外号外，模块开发工具来啦 - 掌控板,创客教育,STEAM,编程教育 代码库 可以直接找到自己保存程序 三、编程区 在指令积木块点击右键 复制、添加注释、折叠块、禁用块、删除块、帮助功能 在空白区域单击右键将会出现：撤销、重做、整理块、折叠块、展开块、删除块功能 右侧三个小按钮的功能从上到下分别是：将图形化指令居中并重置为默认大小、将图形化指令形状增大、将图形化指令形状减小 图形化指令形状增大 图形化指令形状减小 垃圾桶功能 将不用的图形化指令可以拖入垃圾桶内 点击垃圾桶可以看到垃圾桶内的代码

四、仿真探究区

仿真 编写好代码之后可以不用硬件，直接在右侧仿真舞台中点击播放图标，看到相应的仿真效果 如图所示，点击播放后按下A键和B键呈现对应的效果 刷新仿真 全屏模式 点击打开全屏模式 再点一次缩小 中断 程序运行的过程中可以点击“中断”使其终止运行 重置 点击重置重新开始运行板载文件 五、控制台  ②硬件编程使用 一、掌控板连接到电脑 具体操作方法见： 部分win7 64位系统安装驱动出现异常情况或失败的问题及解决方法 - 掌控板,创客教育,STEAM,编程教育 点击设备连接区域，可看到已连接设备的端口号，点击连接端口号即可连上， 点击断开连接则会断开软件与设备的连接，打开软件默认会选择第一个端口号连上， 只有连接上掌控板后mPython才能对掌控板进行烧录固件及刷入代码等操作。

二、固件下载

掌控板固件发布的链接为： 固件发布 — mPython掌控 2.2.2 文档

如果烧录固件失败（或超过30秒仍然一直在恢复），请先尝试关闭杀毒软件，拔开数据线再连接，连接端口，或者选择信任esptool。

三、程序的刷入与运行

运行

代码写好后点击“运行”按钮即可看到对应的效果

刷入 代码写好后点击“刷入”按钮即可看到对应的效果，代码将会刷入到掌控板设备里面 “运行”的代码脱机后即失效，“刷入”的代码脱机后再次连接电源仍有效