Mind+软件用户扩展库详细教程 | 您所在的位置:网站首页 › mind的所有意思 › Mind+软件用户扩展库详细教程 |
快速开发上手视频
点击查看完整版:Mind+自定义用户库视频教程 1-开发教程简介 MindPlus-用户库扩展-开发者文档Mind+是一款拥有自主知识产权的国产青少年编程软件,支持Arduino、micro:bit、掌控板等各种开源硬件,兼容Scratch3.0,支持AI与IoT功能,只需要拖动图形化程序块即可完成编程,还可以使用Python/C/C++等高级编程语言,让大家轻松体验创造的乐趣。 Mind+支持三大主流开源硬件平台(Arduino,micro:bit,掌控板esp32),均可以使用基于arduino C的库,因此只需要编写一个arduino的库即可达到三平台兼容。 Mind+已经支持几十种常用的扩展小模块库,为方便更多用户的使用,从V1.6.2版本开始开放用户自定义库功能,你可以根据自己的需要编写或移植现有的arduino库,自己设计图形模块(block)的外观及形状,自己设计对应生成的代码。 支持通过网络加载Github的用户库或直接本地加载(config.json或.mpext文件)。 提示:尽管用户库增加非常简单,但依然建议有一定代码基础的用户进行操作,若有需要增加的模块而不懂代码,依然可以给官方反馈需要增加的模块。 使用用户库请先升级Mind+到V1.6.2 RC2.0及以上版本。 样例库: https://gitee.com/dfrobot/ext-oled12864.git
详细说明: name: 名称。模块显示在扩展库中的标题名称。 description: 描述。模块显示在扩展库中的描述。 author: 作者名。请使用英文字母表示。 email: 邮箱。当版本更新需要修改用户库或用户反馈,将通过邮件通知开发者(预留功能) license: 许可证类型。参考链接 isTest: 调试模式。True打开测试模式:每次编译都会重新构建静态文件(用于调试);False关闭测试模式:只会在第一次编译才会构建静态文件。建议开发者在调试过程中设置为True,在导出发布时设置为False。 注:从1.6.2RC2.0开始删除此字段,根据加载库方法自动判断模式(从本地解压导入config.json为调试模式则有调试标志及刷新按钮,以zip或从网络加载为非调试模式则无标志及按钮)。 isBoard: 主控。当前扩展是否为主控(预留功能,统一为false) id: 模块区分号。同一作者的不同模块需要设置不同的id,建议使用英文和数字符号命名。 platform: 支持平台。有三个选项:"win", "mac", "web",分别表示Mind的windows桌面版,mac桌面版,网页版,当前仅支持win。 asset: 各模式配置。当前仅支持上传模式的arduino C模式。 dir: 指定模式路径。/不能遗漏,例如:"dir": "arduinoC/",不建议修改。 version: 版本信息。三个数字,从小到大,例如:"0.0.1",建议每次发布都增加一位小数,依次从小到大增加(版本控制功能预留)。 board: 指定支持的主控,主控对应字段见下文“主控列表”。请确认测试通过后添加对应支持主控。若当前主控板不支持或模式不支持,则用户库右上角会显示“不可用” main: block描述文件的文件名。需要是ts后缀文件,名称自定义,需要在对应路径下,例如:main.ts。 files: 包含所需文件的路径,以便加载。 注:从1.6.2RC2.0开始删除此字段,编译和导出库时自动添加相关文件。 主控列表 主控 类型 名称 UNO 主控 arduino Nano 主控 arduinonano Leonardo 主控 leonardo Micro:Bit 主控 microbit 掌控 主控 esp32 Mega2560 主控 mega2560 Vortex 套件 vortex Romeo 套件 romeo UNOR3 套件 arduinounor3 Max:Bot 套件 maxbot 麦昆 套件 maqueen Max 套件 max RoboMaster TT 主控 telloesp32 FireBeetle ESP32 主控 firebeetleesp32 FireBeetle ESP32-E 主控 firebeetleesp32e Maixduino 主控 maixduino注:主控对应的board名可选择对应主控,然后加载一个任意扩展,则会提示无法加载的时候显示当前主板对应的名称,如下图可知"FireBeetle ESP8266"对应的board名为"esp8266" main.ts中的代码如下: //% block="when press [BUTTON]" blockType="hat" //% BUTTON.shadow="dropdown" BUTTON.options="BTN" BUTTON.defl="BTN.A" export function myBlock(parameter: any, block: any) { let button = parameter.BUTTON.code; Generator.addInclude('Mylibraray', '#include '); Generator.addObject(`libraray`, `MY_Libraray`, `libraray;`); Generator.addEvent("functionName", "String", "functionName", "String message, int8_t error", true); Generator.addSetup("libraray.begin", `libraray.begin(${button});`); Generator.addSetup(`libraray.callback`, `libraray.callback(functionName);`); Generator.addCode('libraray.start();') } //% 后面的内容确定了block的外观以及输入值的绑定。 export fuction中通过Generator确定不同的代码生成的位置和内容。效果: 生成的block:描述命令必须包含在//%描述符后。 命令 含义 作用位置 可选参数 color 设置颜色 namespace及block 24位真彩色 iconWidth icon图标宽度 namespace 默认40 iconHeight icon图标高度 namespace 默认40 board 指定当前图形块支持的主控,当选择的主控不在此参数后面则当前积木隐藏不显示 多个用逗号隔开 block arduino、leonardo、microbit、esp32等(参考3.1节主控列表中的参数) block block描述 block 自定义 例如:xxx[A]xxx blockType block类型 block hat:帽子形 command:方形 reporter:圆形 boolean:菱形 shadow 输入框类型 输入框 string:文本 dropdown:下拉不可拖入 dropdownRound:下拉可拖入 boolean:布尔 range:范围 number:数字 defl 设置默认值 输入框 自定义 params.min 设置最小值 range型输入框 自定义 params.max 设置最大值 range型输入框 自定义 options 指定下拉菜单内容 菜单型输入框 自定义 描述内容限制 block的描述中有些是必选的,有些是可选的参数描述,详情参考下表:● 表示必需有此参数⭕ 表示此参数为可选\ 表示此无需此参数 参数字段 namespace命名空间 block积木定义 string文本输入框 number数字输入框 range数字范围输入框 boolean布尔输入框 dropdown下拉菜单 dropdownRound可拖入下拉菜单 normal原始输出无类型 color ⭕ \ \ \ \ \ \ \ \ iconWidth ⭕ \ \ \ \ \ \ \ \ iconHeight ⭕ \ \ \ \ \ \ \ \ block \ ● \ \ \ \ \ \ \ blockType \ ⭕ \ \ \ \ \ \ \ shadow \ \ ● ● ● ● ● ● ● defl \ \ ⭕ ⭕ ⭕ ⭕ ⭕ ⭕ ⭕ params.min \ \ \ \ ⭕ \ \ \ \ params.max \ \ \ \ ⭕ \ \ \ \ options \ \ \ \ \ \ ● ● \ block \ ⭕ \ \ \ \ \ \ \ namespace命名空间在namespace前面的描述词可以指定整个用户库的颜色和icon信息,所有的block定义都需要在namespace大括号中。 //% color="#AA278D" iconWidth=50 iconHeight=40 namespace module { ... }创建一个TypeScript命名空间,所有的图形块都写在里面,还可以设置模块的整体颜色以及icon的尺寸,对于图形风格设置应该包含在//%描述符中。所有的风格设置不是必须的,如果没有设置这些参数,系统将会按照默认的风格展示,//%所包含的内容可以写在一行或多行。 color: 设置图形块颜色,RGB24位真彩。 iconWidth: 设置icon显示宽度。 iconHeight: 设置icon显示高度,icon要求svg格式,图片应该放在_images文件夹根目录。通过blockType关键词可以设置block的整体外观。 //% block="set the line width to [WIDTH] pixels" blockType="command" export function setBrightness(parameter: any, block: any) { ... }定义一个方形的图形块,//%所包含的内容可以写在一行或多行。 block: 一个图形块的完整描述,也是这个图形块的默认显示语言,[]所包含的内容为输入框的名称。 blockType: 设置外观形状,可选参数有hat,command,boolean,reporter block外观 blockType值 外观1.8.0 RC3.0及以上版本新增功能 block="标签文字内容" blockType="tag" ,blockType为tag,block内容为显示的文字 函数名不能跟其他函数重名,函数内容留空即可。 //% block="标签测试" blockType="tag" export function tagtest() {}
注:色盘控件传入16进制颜色值,如需拆分成RGB三个10进制值,可查看本文最后常见问题中的方法。 //% externalFunc export function getColorsFunc_() { return [ "#fff", "#f00", "#0f0", "#00f", "#ff0", "#0ff", "#f0f", "#000" ] } //% block="设置颜色2 [COLOR]" blockType="command" //% COLOR.shadow="colorPalette" COLOR.params.column=5 //% COLOR.params.colorsFunc="getColorsFunc_" export function setColor2(parameter: any, block: any) { }
控件固定,可以设置默认值。 //% block="设置颜色1 [COLOR]" blockType="command" //% COLOR.shadow="colorSlider" COLOR.defl="#f0f" export function setColor(parameter: any, block: any) { }
Generator是提供生成代码的工具,它被内置在mindplus解释器中,通过Generator.来调用以控制生成代码的规范。 Generator.addInclude(id, code, cover)在全局区添加include. id: 标识符, code: 代码 cover: 是否覆盖具有相同id的代码, 默认值为False(仅第一条block生成代码,如需要生成多条代码可查看常见问题中的案例)。此参数可以实现多个block之间的联动,例如串口输出没有使用初始化block会默认生成波特率9600的代码,当使用了初始化波特率为115200时block会生成波特率115200的代码.例如: main.ts:Generator.addInclude("includeMylibraray", "#include ", True); arduino.ino:#include " Generator.addDefine(code1, code2)注意:172RC2.0以下版本不支持。 添加#define代码。 code1: 宏名 code2: 字符串例如: main.ts:Generator.addDefine("ledPin", "3"); arduino.ino:#define ledPin 3 Generator.addObject(id, type, code, cover)在全局区添加对象 id: 标识符 type: class名称 code: 对象名称 cover: 是否覆盖具有相同id的代码, 默认值为false例如: main.ts代码:Generator.addObject(`libraray`, `MY_Libraray`, `libraray;`); arduino.ino代码:MY_Libraray ibraray; Generator.addSetup(id, code, cover)在setup中添加代码。特别注意:使用此函数生成的代码只会生成在setup中,并会生成在其他语句前,且无法生成在函数或其他事件程序中,若非必须,请使用addCode生成代码 id: 标识符 code: 代码 cover: 是否覆盖具有相同id的代码, 默认值为false Generator.addCode(code)在setup或者loop中添加代码,没有返回值的代码添加(一般为方形,帽子形)。 code: 代码。 Generator.addCode([code, level])在setup或者loop中添加代码,有返回值的代码添加(一般为圆形,菱形)。 code:需要注册的代码。 level:运算符优先级,为代码添加括号。建议默认设置为Generator.ORDER_UNARY_POSTFIX。 例如:Generator.addCode(["libraray.read()", Generator.ORDER_UNARY_POSTFIX]); Generator.addEvent(id, type, nam, args, cover)全局区定义一个回调函数 id: 标识符 type: 返回值类型,遵从C++语言规范。 name: 函数名,遵从C++语言规范。 args: 函数参数,遵从C++语言规范。 cover: 是否覆盖具有相同id的代码, 默认值为false 例如:Generator.addEvent("addEvent", "void", "function", "int x,int y"); 运算符优先级 命令 级别 适用范围 Generator.ORDER_UNARY_POSTFIX 1 expr++ expr-- () [] . Generator.ORDER_UNARY_PREFIX 2 -expr !expr ~expr ++expr --expr Generator.ORDER_MULTIPLICATIVE 3 * / % ~/ Generator.ORDER_ADDITIVE 4 + - Generator.ORDER_SHIFT 5 > Generator.ORDER_RELATIONAL 6 >= > |
CopyRight 2018-2019 实验室设备网 版权所有 |