1-开发教程简介

{
	"name": {
		"zh-cn": "OLED-12864显示屏(测试)",
		"en": "OLED-12864 screen(Test)"
	},
	"description": {
		"zh-cn": "小体积显示屏，可用于智能穿戴设备的显示器",
		"en": "I2C OLED-2864 Display Module"
	},
	"author": "DFRobot",
	"email": "MindPlus@dfrobot.com",
	"license": "MIT",
	"isTest": false,"备注":"此字段已删除，自动判断，不需要"
	"isBoard": false,
	"id": "oled12864",
	"platform": ["win", "mac", "web"],
	"version": "0.0.1","备注":"整个扩展库的版本号，缺少会报错"
	"asset": {
		"arduinoC": {
			"dir": "arduinoC/",
			"version": "0.0.1",
			"board": ["microbit", "esp32"],
			"main": "main.ts",
			"files": ["备注":"此字段自动生成，调试时不需要填写"
				"_locales/zh-cn.json","备注":"此字段自动生成，不需要"
				"_images/icon.svg","备注":"此字段自动生成，不需要"
				"libraries/oled12864/oled12864.cpp","备注":"此字段自动生成，不需要"
				"libraries/oled12864/oled12864.h","备注":"此字段自动生成，不需要"
				"libraries/oled12864/qrcode.c","备注":"此字段自动生成，不需要"
				"libraries/oled12864/qrcode.h""备注":"此字段自动生成，不需要"
			]
		}
	}
}

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


//% color="#xxxx"   整个扩展block的外观定义，通过 //% 后的描述内容定义
namespace xxxx {  

    //% 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="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 <Mylibraray.h>');
    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();')
}

/*!
 * MindPlus
 * microbit
 *
 */
#include <Mylibraray.h>

// 函数声明
String functionName(String message, int8_t error);
// 创建对象
MY_Libraray libraray;


// 主程序开始
void setup() {
    libraray.begin(A);
    libraray.callback(functionName);
    libraray.start();
}
void loop() {

}

// 事件回调函数
String functionName(String message, int8_t error) {

}

//% color="#AA278D" iconWidth=50 iconHeight=40
namespace module {
    ...
}

//% block="set the line width to [WIDTH] pixels" blockType="command"
export function setBrightness(parameter: any, block: any) {
    ...
}

//% block="标签测试" blockType="tag"
export function tagtest() {}

    //% block="---"
    export function noteSep() {}

//% block="所有输入库类型测试：原始输出：[NM] 文本型：[SS] 数字型 [SN]  布尔型：[SB] 范围型 [SR] 下拉不可拖入型：[SD] 下拉可拖入型：[SDR] "  blockType="command"
//% NM.shadow="normal"   NM.defl="obj"
//% SS.shadow="string"   SS.defl="mind+"
//% SN.shadow="number"   SN.defl="123"
//% SB.shadow="boolean"  
//% SR.shadow="range"   SR.params.min=0    SR.params.max=10    SR.defl=5
//% SD.shadow="dropdown"   SD.options="BTN"     SD.defl="BTN.B"
//% SDR.shadow="dropdownRound"   SDR.options="LINE"     SDR.defl="LINE.1"
export function myBlock(parameter: any, block: any) {

}

	//% block="设置角度 [VALUE]" blockType="command"
    //% VALUE.shadow="angle" VALUE.params.edge=1
    export function setAngle(parameter: any, block: any) {
        
    }

    //% extenralFunc
    export function getBuiltinFunc_() {
        return [
            {matrix: "0101011111111110111000100"},
            {matrix: "0000001010011100010000000"},
            {matrix: "0010001110101010010000100"},
            {matrix: "0010000100101010111000100"},
            {matrix: "0010001000111110100000100"}
        ]
    }
    //% block="设置点阵 [MT]" blockType="command"
    //% MT.shadow="matrix" MT.params.row=5 MT.params.column=5 MT.defl="0101011111111110111000100"
    //% MT.params.builtinFunc="getBuiltinFunc_" 
    export function setMatrix(parameter: any, block: any) {
        
    }

    //% 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="设置颜色2 [COLOR]" blockType="command"
    //% COLOR.shadow="colorPalette" 
    export function setColor3(parameter: any, block: any) {
        
    }

    //% block="设置颜色1 [COLOR]" blockType="command"
    //% COLOR.shadow="colorSlider" COLOR.defl="#f0f"
    export function setColor(parameter: any, block: any) {
        
    }

    //% block="show [STR] at x [X] y [Y]" blockType="command"
    //% STR.shadow="note" STR.defl=247
    //% X.shadow="range" X.params.min=0 X.params.max=127 X.defl=0
    //% Y.shadow="range" Y.params.min=0 Y.params.max=63 Y.defl=0
    export function print(parameter: any, block: any) {
        let str = parameter.STR.code
        let x = parameter.X.code
        let y = parameter.Y.code
        Generator.addInclude('oled12864', '#include <oled12864.h>');
        Generator.addObject(`myoled`, `OLED_12864`, `myoled;`);
        Generator.addSetup(`myoled.begin`, `myoled.begin();`);
        Generator.addCode(`myoled.setCursor(${x}, ${y});\n\tmyoled.print(${str});`);
    }

    //% externalFunc
    export function validateStr_(str) {
        let regx: RegExp = /^[a-z0-9]{1,8}\.[a-z0-9]{1,3}$/;
        if (!regx.test(str)) {
            return null;
        }
        return str;
    }
    //% block="show [STR] on the [LINE] line" blockType="hat"
    //% STR.shadow="string" STR.defl="hellomm" STR.params.validateFunc="validateStr_"
    //% LINE.shadow="dropdown" LINE.options="LINE" LINE.defl="LINE.1"
    export function println(parameter: any, block: any) {
        let str = parameter.STR.code
        let line = parameter.LINE.code
        Generator.addInclude('oled12864', '#include <oled12864.h>');
        Generator.addObject(`myoled`, `OLED_12864`, `myoled;`);
        Generator.addSetup(`myoled.begin`, `myoled.begin();`);
        Generator.addCode(`myoled.setCursorLine(${line});\n\tmyoled.printLinemm(${str});`);
    }

if(Generator.board === 'arduino'){//如果是arduinouno板，生成如下代码
	 Generator.addSetup("GTSerialSetup",`${ser}.begin(9600);`);
}else if(Generator.board === 'esp32'){//如果是掌控板，生成如下代码
	Generator.addSetup("GTSerialSetup",`${ser}.begin(9600,${rx}, ${tx});`);
}

    //% block="show [STR] on the [LINE] line" blockType="command"
    //% STR.shadow="string" STR.defl=hello
    //% LINE.shadow="dropdownRound" LINE.options="LINE" LINE.defl="LINE.1"
    export function println(parameter: any, block: any) {
        let str = parameter.STR.code
        let line = parameter.LINE.code
        Generator.addInclude('oled12864', '#include <oled12864.h>');
        Generator.addObject(`myoled`, `OLED_12864`, `myoled;`);
        Generator.addSetup(`myoled.begin`, `myoled.begin();`);
        Generator.addCode(`myoled.setCursorLine(${line});\n\tmyoled.printLine(${str});`);
    }

"用户库名称.函数名|block":"翻译内容[菜单项]",

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

{
    "oled12864.buttonPress|block": "当 [BUTTON] 按钮按下",
    "oled12864.qrcode|block": "在坐标x [X] y [Y] 绘制二维码[STR] 尺寸 [SIZE]",
    "oled12864.println|block": "在第 [LINE] 显示 [STR]",
    "oled12864.print|block": "在坐标x [X] y [Y] 显示 [STR]",
    "oled12864.setLineWidth|block": "设置线宽为 [WIDTH] 像素",
    "oled12864.getLineWidth|block": "获取线宽",
    "oled12864.buttonIsPressed|block": "按钮 [BUTTON] 被按下？",
	"oled12864.notTrue|block": "非 [Flag]",
    "oled12864.SIZE.1|menu": "29*29(1)",
    "oled12864.SIZE.2|menu": "58*58(2)"
}

{
	"PINX": {
		"menu":	[["P0", "0"], ["P1", "1"], ["P2", "2"]],
		"default_setBrightness_TXPIN": "1",
		"default_setBrightness_RXPIN": "2"
	},
	"MENU": {
		"menu":	[["A", "0"], ["B", "1"], ["C", "2"]],
		"default_setMenu_MENU":"2",
	}
}

#if   defined(NRF5)
//主控板选择microbit V1时编译器编译的代码
#elif defined (NRF52833)
//主控板选择microbit V2时编译器编译的代码
#elif defined (ESP_PLATFORM)
//主控板选择掌控板时编译器编译的代码
#else
//主控板为其他板时编译器编译的代码
#endif

//例：如下代码对应的myBlock积木仅当主控板为uno和micro:bit时才会显示，选择其他主控板时则不会显示

//% board="arduino,microbit"
//% block="when press [BUTTON]" blockType="hat"
//% BUTTON.shadow="dropdown" BUTTON.options="BTN" BUTTON.defl="BTN.A"
export function myBlock(parameter: any, block: any) {

}

    //% block="set color [COLOR]" blockType="command"
    //% COLOR.shadow="colorPalette" 
    export function devsetcolor(parameter: any, block: any) {
        let color=parameter.COLOR.code; //获取传进来的值

        var r = 0;
        var g = 0;
        var b = 0;
        try {
            if ( color.length == 8 ) {//分别截取RGB值然后转换为数字值
                r = parseInt(color.substring(2, 4), 16);
                g = parseInt(color.substring(4, 6), 16);
                b = parseInt(color.substring(6, 8), 16);
            }
        } catch(e) {
            return '';
        }

        Generator.addCode(`bulb.set_rgb(${r},${g},${b})`);//使用RGB颜色生成代码

    }