Mind+第三方用户库的实现

2024-02-25 00:10

本文主要是介绍Mind+第三方用户库的实现,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言
我们在使用Mind+时,有很多传感器都没用官方库,常常因为没有官方库而无法使用Mind+进行作品制作,但是从V1.6.2版本开始开放用户自定义库功能,我们可以根据自己的需要编写或移植现有的arduino库,自己设计图形模块(block)的外观及形状,自己设计对应生成的代码。
官方参考链接:https://mindplus.dfrobot.com.cn/ext-api

以下是指纹识别传感器AS608第三方库的制作

**

1. 选择模板或自己建立用户库文件结构

**
下载完官方提供的Arduino用户库模板后会得到一个.zip文件。解压后把总文件夹名字改为自己的项目名称(注:不要用中文和特殊符号),并删除其中的.mpext文件。
如图下:
在这里插入图片描述
在这里插入图片描述

2、修改config.json配置文件

{"name": {"zh-cn": "指纹识别传感器 AS608","en": "Fingerprint Sensor"},"description": {"zh-cn": "可以读取指纹识别传感器中已存储的指纹。","en": "Support fingerprint search mode."},"author": "XXX","email": "XXX@gmail.com","license": "MIT","isBoard": false,"id": "fingerprint","platform": ["win", "mac", "web"],
"version": "0.1.0","asset": {"arduinoC": {"dir": "arduinoC/","board": ["arduino",  "esp32","microbit"],"main": "main.ts"}}
}

详细说明:

name: 名称。模块显示在扩展库中的标题名称。
description: 描述。模块显示在扩展库中的描述。
author: 作者名。请使用英文字母表示。
email: 邮箱。当版本更新需要修改用户库或用户反馈,将通过邮件通知开发者(预留功能)
license: 许可证类型。参考链接
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后缀文件,名称自定义,需要在对应路径下
注:若模板中有isTest字段和files字段,则把该两字段部分代码删除。因为从Mind+ 1.6.2RC2.0版本开始删除此两字段。
————————————————
版权声明:本文为CSDN博主「念芯」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/weixin_45616775/article/details/116571064

3、编写main.ts描述文件

通过//%后面的内容可以定义图形块(block)外观(积木),即//% 后面的内容确定了block的外观以及输入值的绑定;
通过function定义block对应的生成代码以及位置,即export fuction中通过Generator确定不同的代码生成的位置和内容。

enum BAUDRATE {//% block="57600"57600,//% block="9600"9600,//% block="115200"115200
}enum ACT {//% block="verifyPassword"verifyPassword,//% block="getImage"getImage,//% block="createModel"createModel,//% block="getModel"getModel,//% block="emptyDatabase"emptyDatabase,//% block="fingerFastSearch"fingerFastSearch,//% block="getTemplateCount"getTemplateCount,//% block="fingerID"fingerID,//% block="confidence"confidence,//% block="templateCount"templateCount
}//% color="#fc4040" iconWidth=40 iconHeight=40
namespace fingerprint {//% block="fingerprint sensor initliallize pin [SSER] RX [SSRXD] TX [SSTXD] baudrate [BAUDRATE] blockType="command"//% SSER.shadow="dropdown" SSER.options="SSER"//% SSTXD.shadow="dropdown" SSTXD.options="SSTXD"//% SSRXD.shadow="dropdown" SSRXD.options="SSRXD"//% BAUDRATE.shadow="dropdown" BAUDRATE.options="BAUDRATE"export function beginSoftSerial(parameter: any, block: any) {let tx = parameter.SSTXD.code;let rx = parameter.SSRXD.code;let sser = "finger" + parameter.SSER.code;let baudrate = parameter.BAUDRATE.code;// let password = parameter.PASSWORD.code;Generator.addInclude("includeFingerprint","#include <Adafruit_Fingerprint.h>");Generator.addInclude("includesoftSerial", "#include <SoftwareSerial.h>");Generator.addObject("softSerialObject","SoftwareSerial",`${sser}(${rx}, ${tx});`);Generator.addObject("FingerObject","Adafruit_Fingerprint",`finger = Adafruit_Fingerprint(&${sser});`);Generator.addSetup("FingerSoftSerialSetup", `finger.begin(${baudrate});`);}//% block="fingerprint sensor initliallize pin [SER] RX [RXD] TX [TXD] baudrate [BAUDRATE]" blockType="command"//% SER.shadow="dropdown" SER.options="SER"//% RXD.shadow="dropdown" RXD.options="RXD"//% TXD.shadow="dropdown" TXD.options="TXD"//% BAUDRATE.shadow="dropdown" BAUDRATE.options="BAUDRATE"export function beginSerial(parameter: any, block: any) {let ser = parameter.SER.code;let rx = parameter.RXD.code;let tx = parameter.TXD.code;let baudrate = parameter.BAUDRATE.code;Generator.addInclude("includeFingerprint","#include <Adafruit_Fingerprint.h>");Generator.addObject("FingerObject","Adafruit_Fingerprint",`finger = Adafruit_Fingerprint(&${ser});`);if (Generator.board === "arduino") {Generator.addSetup("FingerSerialSetup", `finger.begin(${baudrate});`);} else if (Generator.board === "arduinonano") {Generator.addSetup("FingerSerialSetup", `finger.begin(${baudrate});`);} else if (Generator.board === "leonardo") {Generator.addSetup("FingerSerialSetup", `finger.begin(${baudrate});`);} else if (Generator.board === "mega2560") {Generator.addSetup("FingerSerialSetup", `finger.begin(${baudrate});`);} else if (Generator.board === "arduinounor3") {Generator.addSetup("FingerSerialSetup", `finger.begin(${baudrate});`);} else if (Generator.board === "microbit") {Generator.addSetup("FingerSerialSetup",`finger.begin(${baudrate}, ${rx}, ${tx});`);} else if (Generator.board === "esp32") {Generator.addSetup("FingerSerialSetup",`finger.begin(${baudrate}, ${rx}, ${tx});`);}}//% block="finger getFinger success?" blockType="boolean"export function getFingerSuccess() {Generator.addCode("(finger.getImage() == FINGERPRINT_OK) && (finger.image2Tz() == FINGERPRINT_OK) && (finger.fingerFastSearch() == FINGERPRINT_OK)");}//% block="fingerID" blockType="reporter"export function fingerID() {Generator.addCode("finger.fingerID");}// //% block="finger getImage success?" blockType="boolean"// export function getImageSuccess() {//   Generator.addCode("finger.getImage() == FINGERPRINT_OK");// }// //% block="finger image2Tz success?" blockType="boolean"// export function image2TzSuccess() {//   Generator.addCode("finger.image2Tz() == FINGERPRINT_OK");// }// //% block="finger fingerFastSearch success?" blockType="boolean"// export function fingerFastSearchSuccess() {//   Generator.addCode("finger.fingerFastSearch() == FINGERPRINT_OK");// }
}

4、编辑资源文件

1、libraries文件夹

此文件放置生成代码需要调用的arduino库文件,如果不需要库文件,需要将libraries文件夹删除。即如果有arduino库(.h和.cpp文件)时,需要放到此文件夹中;如果不需要库文件,则把此文件夹删除。

此处需要用到指纹模块的库,请到文章底部下载。

2、_images文件夹

此文件夹放置扩展库界面图片及block上显示的图标文件等文件。
在这里插入图片描述

放入两张必备的图片:
featured.png:扩展库界面图片,名称不可修改,600*372分辨率的png图片。
icon.svg:block上显示的图标文件,名称不可修改,svg格式矢量图,内容尽量精简,推荐白色icon。可从 阿里巴巴矢量图标库iconfont 等现成的图标库下载。
————————————————
版权声明:本文为CSDN博主「念芯」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/weixin_45616775/article/details/116571064

3、_locales文件夹

此文件夹放置.json翻译文件(注意文件的命名,可以查看官方的规则)。根据文件名对应不同的语言,若没有对应语言的翻译文件则以main.ts中block描述代码中的内容直接显示。

4、_menus文件夹

此文件夹放置各种不同板子对应的下拉菜单内容,例如引脚编号的下拉,默认放置了所有主控器的常见引脚,可以直接在main.ts中调用。
在这里插入图片描述

5、加载库

通过本地加载config.json文件可以更新库并预览效果

打开Mind+软件,切换到上传模式,打开扩展,选择主控板为Arduno uno,然后在用户库里导入本地用户库并查看效果。
在这里插入图片描述
实验效果:
在这里插入图片描述
在这里插入图片描述
代码下载链接:https://gitee.com/sum888/mind-third-party-user-library.git

这篇关于Mind+第三方用户库的实现的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/743832

相关文章

基于 HTML5 Canvas 实现图片旋转与下载功能(完整代码展示)

《基于HTML5Canvas实现图片旋转与下载功能(完整代码展示)》本文将深入剖析一段基于HTML5Canvas的代码,该代码实现了图片的旋转(90度和180度)以及旋转后图片的下载... 目录一、引言二、html 结构分析三、css 样式分析四、JavaScript 功能实现一、引言在 Web 开发中,

SpringBoot中使用Flux实现流式返回的方法小结

《SpringBoot中使用Flux实现流式返回的方法小结》文章介绍流式返回(StreamingResponse)在SpringBoot中通过Flux实现,优势包括提升用户体验、降低内存消耗、支持长连... 目录背景流式返回的核心概念与优势1. 提升用户体验2. 降低内存消耗3. 支持长连接与实时通信在Sp

Conda虚拟环境的复制和迁移的四种方法实现

《Conda虚拟环境的复制和迁移的四种方法实现》本文主要介绍了Conda虚拟环境的复制和迁移的四种方法实现,包括requirements.txt,environment.yml,conda-pack,... 目录在本机复制Conda虚拟环境相同操作系统之间复制环境方法一:requirements.txt方法

Spring Boot 实现 IP 限流的原理、实践与利弊解析

《SpringBoot实现IP限流的原理、实践与利弊解析》在SpringBoot中实现IP限流是一种简单而有效的方式来保障系统的稳定性和可用性,本文给大家介绍SpringBoot实现IP限... 目录一、引言二、IP 限流原理2.1 令牌桶算法2.2 漏桶算法三、使用场景3.1 防止恶意攻击3.2 控制资源

springboot下载接口限速功能实现

《springboot下载接口限速功能实现》通过Redis统计并发数动态调整每个用户带宽,核心逻辑为每秒读取并发送限定数据量,防止单用户占用过多资源,确保整体下载均衡且高效,本文给大家介绍spring... 目录 一、整体目标 二、涉及的主要类/方法✅ 三、核心流程图解(简化) 四、关键代码详解1️⃣ 设置

Nginx 配置跨域的实现及常见问题解决

《Nginx配置跨域的实现及常见问题解决》本文主要介绍了Nginx配置跨域的实现及常见问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来... 目录1. 跨域1.1 同源策略1.2 跨域资源共享(CORS)2. Nginx 配置跨域的场景2.1

Python中提取文件名扩展名的多种方法实现

《Python中提取文件名扩展名的多种方法实现》在Python编程中,经常会遇到需要从文件名中提取扩展名的场景,Python提供了多种方法来实现这一功能,不同方法适用于不同的场景和需求,包括os.pa... 目录技术背景实现步骤方法一:使用os.path.splitext方法二:使用pathlib模块方法三

CSS实现元素撑满剩余空间的五种方法

《CSS实现元素撑满剩余空间的五种方法》在日常开发中,我们经常需要让某个元素占据容器的剩余空间,本文将介绍5种不同的方法来实现这个需求,并分析各种方法的优缺点,感兴趣的朋友一起看看吧... css实现元素撑满剩余空间的5种方法 在日常开发中,我们经常需要让某个元素占据容器的剩余空间。这是一个常见的布局需求

HTML5 getUserMedia API网页录音实现指南示例小结

《HTML5getUserMediaAPI网页录音实现指南示例小结》本教程将指导你如何利用这一API,结合WebAudioAPI,实现网页录音功能,从获取音频流到处理和保存录音,整个过程将逐步... 目录1. html5 getUserMedia API简介1.1 API概念与历史1.2 功能与优势1.3

Java实现删除文件中的指定内容

《Java实现删除文件中的指定内容》在日常开发中,经常需要对文本文件进行批量处理,其中,删除文件中指定内容是最常见的需求之一,下面我们就来看看如何使用java实现删除文件中的指定内容吧... 目录1. 项目背景详细介绍2. 项目需求详细介绍2.1 功能需求2.2 非功能需求3. 相关技术详细介绍3.1 Ja