Mind+:第三方Arduino用户库实现——RFID-RC522模块读操作

Mind+ 专栏收录该内容
12 篇文章 0 订阅

前言

官方参考

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及以上版本。

本博客实现的是Mind+上传模式的第三方Arduino用户库。利用Arduino UNO+RFID-RC522模块读S50卡的UID并从串口输出。

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

想要建立自己的用户库可以选择官方提供的模板库(Arduino用户库模板、microPython用户库模板、实时模式用户库模板),在此基础上修改为自己需要的用户库;也可以自己按以下用户库文件结构从零构建属于自己的用户库(推荐使用模板库,不必重复造轮子)。

用户库文件结构:
│— newExtensions      // 项目名称
    │— config.json    // 本用户库的配置文件
    │— LICENSE.TXT    // 许可证说明
    │— README.md      // 文档说明
    │— arduinoC       // arduino模式用户库根目录
       │— main.ts     // 图形块描述文件
       │— libraries   // arduino库文件,列出本扩展库所有需要引用的.c或.h或.cpp文件;若没有则把此文件夹内容删除清空
          │— qrcode.h
          │— ...
       │— _images           // 图片文件
          │— featured.png   // MindPlus扩展库展示图片(600x372像素)
          │— icon.svg       // MindPlus中图形块上的图标文件
          │— ...
       │— _locales          // 翻译文件,支持多国语言
          │— zh-cn.json
          │— en.json
          │— ...
       │— _menus            // 下拉菜单参数,每个板子可以独立设置
          │— leonardo.json
          │— uno.json
          │— nano.json
          │— mega2560.json
          │— microbit.json
          │— mpython.json
          │— ...

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

我的RFID-RC522用户库文件结构如下:

2、修改config.json配置文件

修改config.json配置文件,配置扩展库信息。config.json配置文件的内容如下:

{
  "name": {
    "zh-cn": "RFID-RC522模块",
    "en": "RFID-RC522 Module"
  },
  "description": {
    "zh-cn": "简单的读取S50复旦卡UID并从串口输出的RFID-RC522模块",
    "en": "Simple read S50 fudan UID and from the serial port output of RFID card - RC522 module"
  },
  "author": "RZC",
  "email": "rl0403y@163.com",
  "license": "MIT",
  "isBoard": false,
  "id": "MFRC522",
  "platform": ["win","mac","web"],
  "version": "0.0.1",
  "asset": {
    "arduinoC": {
      "dir": "arduinoC/",
      "version": "0.0.1",
      "board": [
        "esp32",
        "arduino"
      ],
      "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版本开始删除此两字段。

3、编写main.ts描述文件

main.ts描述文件在arduinoC文件夹下。

文件内容结构:

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

enum xxxx {
   //% 引脚描述内容定义,需要翻译的菜单项需要定义到menu文件中
   //% 引脚生成代码定义
}

//% color="#xxxx"   整个扩展block的外观定义,通过 //% 后的描述内容定义
namespace xxxx {  //namespace后的xxxx与config.json配置文件中的ID号相同
    //% block="xxx [xxx]" blockType="xxx" 第一个block的外观定义描述内容  
    //% block其他描述内容 
    export function xxxx(parameter: any, block: any) {  //单个block的生成代码定义,通过函数描述生成代码的位置及内容
        //生成的代码位置及内容描述
    }

    //% block="xxx [xxx]" blockType="xxx" 第二个block的外观定义描述内容 
    //% block其他描述内容 
    export function xxxx(parameter: any, block: any) {
       //生成的代码位置及内容描述
    }

    //% block="xxx [xxx]" blockType="xxx" 第N个block的外观定义描述内容
    //% block其他描述内容 
    export function xxxx(parameter: any, block: any) {
       //生成的代码位置及内容描述
    }

}

block外观定义;Generator代码定义;parameter传入参数等语法详情可以查看官方的文件说明

详细步骤:

1)首先我们设计一下积木块
根据我们自己设想的功能,设计符合预期功能积木块。这里初期只设计了读取卡号的基础功能,有2个积木:

  • RFID-RC522模块初始化SS(10)引脚和RST(9)引脚的积木;
  • 检测当前S50复旦卡的卡号的积木。

2)实现

main.ts描述文件的代码内容如下:

enum LINE {
    //% block="1"
    1,
    //% block="2"
    2,
    //% block="3"
    3,
    //% block="4"
    4,
    //% block="5"
    5,
    //% block="6"
    6,
    //% block="7"
    7,
    //% block="8"
    8,
    //% block="9"
    9,
    //% block="10"
    10,
    //% block="11"
    11,
    //% block="12"
    12,
    //% block="13"
    13
}

//% color="#33CCFF" iconWidth=50 iconHeight=40
namespace MFRC522 {
    //% block="RFID-RC522模块初始化,SDA引脚[SS] RST引脚[RST]" blockType="command"
    //% SS.shadow="dropdown" SS.options="LINE" SS.defl="LINE.10"
    //% RST.shadow="dropdown" RST.options="LINE" RST.defl="LINE.9"
    export function MFRC522Init(parameter: any, block: any) {
        let ss = parameter.SS.code;
        let rst = parameter.RST.code;
        Generator.addInclude("MFRC522_1","#include <SPI.h>");
        Generator.addInclude("MFRC522_2","#include <MFRC522.h>");
        Generator.addObject("MFRC522_3","MFRC522",`rfid(${ss},${rst});`);
        Generator.addObject("MFRC522_4","MFRC522::MIFARE_Key",`key;`);
        Generator.addObject("MFRC522_5","byte",`nuidPICC[4];`);
        //Generator.addSetup("MFRC522_6",`Serial.begin(9600); `);
        Generator.addSetup("MFRC522_6",`SPI.begin(); `);
        Generator.addSetup("MFRC522_7",`rfid.PCD_Init(); `);
        Generator.addSetup("MFRC522_8",`for (byte i = 0; i < 6; i++) {
            key.keyByte[i] = 0xFF;
        }`);
    }

    //% block="检测新卡号" blockType="command"
    export function MFRC522xk(parameter: any, block: any) {
        Generator.addCode(`if(!rfid.PICC_IsNewCardPresent())
        return;`);
        Generator.addCode(`if(!rfid.PICC_ReadCardSerial())
        return;`);
        Generator.addCode(`for (byte i = 0; i < 4; i++) {
            nuidPICC[i] = rfid.uid.uidByte[i];
        }`); 
        Generator.addCode(`for (byte i = 0; i < 4; i++) {
            Serial.print(nuidPICC[i] < 0x10 ? "0" : "");
            Serial.println(nuidPICC[i], DEC);
          }`);
        Generator.addCode(`rfid.PICC_HaltA();`);
        Generator.addCode(`rfid.PCD_StopCrypto1();`);
        Generator.addCode(`Serial.println();`);
    }
    
}

代码说明:

积木颜色如果需要修改可以用取色板工具取色后修改;
namespace名字修改为与config.json配置文件中的ID相同;
修改block字段设置积木文字和下拉菜单,blocktype设置积木形状;
shadow配置下拉菜单,配置menu文件,如果需要翻译可以修改_locales文件夹下的zh-cn.json文件;
配置block函数内容。

4、编辑资源文件

根据main.ts描述文件的需要编辑资源文件。打开arduinoC文件夹可以看见其下有4个子文件夹,如下图所示:


1)libraries文件夹

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

这里要使用到RFID-RC522的库,把GitHub上的资源下载下来,并把整个的Arduino库文件(.zip文件)放在此文件夹下并解压。

libraries文件夹的内容如下:


2)_images文件夹

此文件夹放置扩展库界面图片及block上显示的图标文件等文件。

_images文件夹的内容如下:


说明:

  • 要删除_images中的原来所有文件;
  • 放入两张必备的图片:
  1. featured.png:扩展库界面图片,名称不可修改,600*372分辨率的png图片。
  2. icon.svg:block上显示的图标文件,名称不可修改,svg格式矢量图,内容尽量精简,推荐白色icon。可从 阿里巴巴矢量图标库iconfont 等现成的图标库下载。
  • 辅助说明图片文件:blocks.png为积木图片;example.png为积木代码文件。

3)_locales文件夹

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

_locales文件夹的内容如下(本用户库并没有翻译文件,此处只为展示用):

zh-cn.json文件内容如下:

说明:
①在block及menu都可以定义。
②json格式:

每一行格式为:"用户库名称.函数名|block":"翻译内容[菜单项]",

菜单项则为:"用户库名称.菜单名.菜单项|menu":"翻译内容",

4)_menus文件夹

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

_menus文件夹的内容如下:

  • 每个主控板一个json文件,文件名以板子命名,不可修改,格式为json格式。注:在官方示例中有所有板子主要引脚文件,可直接取用。
  • menu字段对应菜单项:[“下拉block中显示的内容”,“生成代码获得的内容”]。
  • default_函数名_下拉字段名称 可以设置默认下拉引脚。

5、测试

通过本地加载config.json文件可以更新库并预览效果,并测试硬件功能。

1)打开Mind+软件,切换到上传模式,打开扩展,选择主控板为Arduno uno,然后在用户库里导入本地用户库并查看效果。


2)测试硬件功能
①点击刷新按钮会更新积木;
②拖动积木编写程序,查看生成代码正确与否;

③连接硬件主控板上传测试。

接线:
Arduino Uno ----- RFID-RC522
     10 ------------ SDA
     13 -------------SCK
     11 ------------ MOSI
     12 ------------ MISO
   –null– ---------- IRQ (IRQ是中断才用到的此处没有用到可以不接)
     GND ----------- GND
     9 ------------- RST
     3.3V ---------- 3.3V

输出代码至Arduino开发板:

在这里插入图片描述

读取到的是十进制卡号(在Arduino IDE串口查看时是每次一个卡号一行,但在Mind+上只能一个个读取,四个数连起来才是一个卡号):

在这里插入图片描述
6、导出分享

步骤:
1)右键扩展库导出用户库为.mpext文件
测试完成之后,在扩展库上右键选择导出,稍等即可导出完成。此时查看库文件目录下有一个.mpext文件,此文件直接加载即可,此时没有调试模式的标志。


2)编写README.md文件
以markdown格式编辑本扩展库的教程。

3)分享
推荐分享到Mind+社区,有以下两种方法:

本地加载:直接分享给其他用户加载.mpext文件。
网络加载:将.mpext文件(文件名不要修改否则会出错)导出到与config.json同级目录下,通过git将整个文件夹上传到github或者gitee(码云) (gith教程),将git链接分享给其他用户加载。
本RFID-RC522模块用户库的链接在此

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

打赏
文章很值,打赏犒劳作者一下
相关推荐
DirectX修复工具(DirectX Repair)是一款系统级工具软件,简便易用。本程序为绿色版,无需安装,可直接运行。 本程序的主要功能是检测当前系统的DirectX状态,如果发现异常则进行修复。程序主要针对0xc000007b问题设计,可以完美修复该问题。本程序中包含了最新版的DirectX redist(Jun2010),并且全部DX文件都有Microsoft的数字签名,安全放心。 本程序为了应对一般电脑用户的使用,采用了易用的一键式设计,只要点击主界面上的“检测并修复”按钮,程序就会自动完成校验、检测、下载、修复以及注册的全部功能,无需用户的介入,大大降低了使用难度。在常规修复过程中,程序还会自动检测DirectX加速状态,在异常时给予用户相应提示。 本程序适用于多个操作系统,如Windows XP(需先安装.NET 2.0,详情请参阅“致Windows XP用户.txt”文件)、Windows Vista、Windows 7、Windows 8、Windows 8.1、Windows 8.1 Update、Windows 10,同时兼容32位操作系统和64位操作系统。本程序会根据系统的不同,自动调整任务模式,无需用户进行设置。 本程序的V4.0版分为标准版、增强版以及在线修复版。所有版本都支持修复DirectX的功能,而增强版则额外支持修复c++的功能。在线修复版功能与标准版相同,但其所需的数据包需要在修复时自动下载。各个版本之间,主程序完全相同,只是其配套使用的数据包不同。因此,标准版和在线修复版可以通过补全扩展包的形式成为增强版。本程序自V3.5版起,自带扩展功能。只要在主界面的“工具”菜单下打开“选项”对话框,找到“扩展”标签,点击其中的“开始扩展”按钮即可。扩展过程需要Internet连接,扩展成功后新的数据包可自动生效。扩展用时根据网络速度不同而不同,最快仅需数秒,最慢需要数分钟,烦请耐心等待。如扩展失败,可点击“扩展”界面左上角小锁图标切换为加密连接,即可很大程度上避免因防火墙或其他原因导致的连接失败。 本程序自V2.0版起采用全新的底层程序架构,使用了异步多线程编程技术,使得检测、下载、修复单独进行,互不干扰,快速如飞。新程序更改了自我校验方式,因此使用新版本的程序时不会再出现自我校验失败的错误;但并非取消自我校验,因此程序安全性与之前版本相同,并未降低。 程序有更新系统c++功能。由于绝大多数软件运行时需要c++的支持,并且c++的异常也会导致0xc000007b错误,因此程序在检测修复的同时,也会根据需要更新系统中的c++组件。自V3.2版本开始使用了全新的c++扩展包,可以大幅提高工业软件修复成功的概率。修复c++的功能仅限于增强版,标准版及在线修复版在系统c++异常时(非丢失时)会提示用户使用增强版进行修复。除常规修复外,新版程序还支持C++强力修复功能。当常规修复无效时,可以到本程序的选项界面内开启强力修复功能,可大幅提高修复成功率。请注意,请仅在常规修复无效时再使用此功能。 程序有两种窗口样式。正常模式即默认样式,适合绝大多数用户使用。另有一种简约模式,此时窗口将只显示最基本的内容,修复会自动进行,修复完成10秒钟后会自动退出。该窗口样式可以使修复工作变得更加简单快速,同时方便其他软件、游戏将本程序内嵌,即可进行无需人工参与的快速修复。开启简约模式的方法是:打开程序所在目录下的“Settings.ini”文件(如果没有可以自己创建),将其中的“FormStyle”一项的值改为“Simple”并保存即可。 新版程序支持命令行运行模式。在命令行中调用本程序,可以在路径后直接添加命令进行相应的设置。常见的命令有7类,分别是设置语言的命令、设置窗口模式的命令,设置安全级别的命令、开启强力修复的命令、设置c++修复模式的命令、控制Direct加速的命令、显示版权信息的命令。具体命令名称可以通过“/help”或“/?”进行查询。 程序有高级筛选功能,开启该功能后用户可以自主选择要修复的文件,避免了其他不必要的修复工作。同时,也支持通过文件进行辅助筛选,只要在程序目录下建立“Filter.dat”文件,其中的每一行写一个需要修复文件的序号即可。该功能仅针对高级用户使用,并且必须在正常窗口模式下才有效(简约模式时无效)。 本程序有自动记录日志功能,可以记录每一次检测修复结果,方便在出现问题时,及时分析和查找原因,以便找到解决办法。 程序的“选项”对话框中包含了7项高级功能。点击"常规”选项卡可以调整程序的基本运行情况,包括日志记录、安全级别控制、调试模式开启等。只有开启调试模式后才能在C
本套餐将包括两个重磅性的课程与一个赠送学习的课程,分别为SpringBoot实战视频教程与RabbitMQ实战教程跟SSM整合开发之poi导入导出Excel。目的是为了让各位小伙伴可以从零基础一步一个脚印学习微服务项目的开发,特别是SpringBoot项目的开发,之后会进入第二个课程:RabbitMQ的实战,即消息中间件在实际项目或者系统中各种业务模块的实战并解决一些常见的典型的问题!核心的知识点分别包括 一、SpringBoot实战历程课程 (1)SpringBoot实战应用场景的介绍与代码实战 (2)发送邮件服务、上传下载文件服务、Poi导入导出Excel (3)单模块与多模块项目构建、项目部署打包、日志、多环境配置、lombok、validator以及mybatis整合实战跟多数据源实战 (4)Redis缓存中间件的实战与缓存雪崩跟缓存穿透等问题的解决实战 (5)RabbitMQ消息中间件在业务模块异步解耦、通信、消息确认机制以及并发量配置等的实战 二、RabbitMQ实战教程课程 (1)RabbitMQ的官网权威技术手册拜,认识并理解各大专有名词,如队列,交换机,路由,死信队列,消息确认机制等等 (2)RabbitMQ在业务服务模块之间的异步解耦通信实战,如异步记录日志与发送邮件等 (3)商城系统抢单高并发情况下RabbitMQ的限流作用与代码实战 (4)消息确认机制与并发量配置并用来实战商城用户下单 (5)死信队列深入讲解与DLX,DLK,TTL等概念的讲解并用来实战 “支付系统用户下单后支付超时而失效其下单记录”实战 详情,各位小伙伴可以查看两个课程的目录。相信学完该套餐相关课程后,你的实战能力将大大提升!涨薪将不再遥遥无期! 最后,赠送的SSM整合开发之POI导入导出Excel目的是为了让各位小伙伴也可以学习Spring+SpringMVC+Mybatis整合开发的项目,让大家一对比SpringBoot与SPring的项目开发流程以及复杂程度!!! 相信学完之后,你会对SpringBoot爱不释手!!
©️2020 CSDN 皮肤主题: 终极编程指南 设计师:CSDN官方博客 返回首页

打赏

漠宸离若

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值