# ext2-ul-lzboardkit

**Repository Path**: mind-plus/ext2-ul-lzboardkit

## Basic Information

- **Project Name**: ext2-ul-lzboardkit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# 乐造套件库

![cover](extension/public/cover.png)

`乐造套件库` 是一个适用于 Mind+ V2 上传模式的传感器与执行器扩展。
该扩展支持控制有源蜂鸣器、风扇、三色灯、交通灯、步进电机、直流电机等执行器，读取按键、寻迹、旋转编码器、矩阵键盘等传感器数据，以及语音播放器和 MP3 模块播放控制等功能，可用于乐造套件教学、互动装置制作等应用场景。

支持以下产品 / 型号：

- 乐造套件模块（有源蜂鸣器、风扇、3 按键模块、数字传感器、旋转编码器、寻迹模块、语音播放器、三色灯、交通灯、步进电机、直流电机、3X4 矩阵键盘、MP3 模块等）

## 积木

扩展提供的主要积木如下：

|类型|积木功能|
|---|---|
|命令|控制有源蜂鸣器打开或关闭|
|命令|控制风扇模块并设定转速值|
|命令|初始化旋转编码器（ENA、ENB、SW 引脚），设置旋转编码器位置值|
|数值|获取旋转编码器位置值|
|布尔|旋转编码器按键被按下？|
|布尔|3 按键模块的红、绿、蓝按键被按下？|
|布尔|U 型光电传感器、避障传感器、人体红外传感器、碰撞开关等检测到物体/人|
|命令|初始化单路寻迹模块|
|布尔|单路寻迹模块检测到白线或黑线|
|命令|初始化三路寻迹（左、中、右引脚）|
|布尔|三路寻迹左、中、右方向检测到白线或黑线|
|命令|语音播放器播放指定语音、按功能播放或连码播放|
|命令|初始化三色灯（红、绿、蓝引脚），控制三色灯各灯开关|
|命令|初始化交通灯（红、黄、绿引脚），控制交通灯各灯开关|
|命令|初始化步进电机（引脚、每转步数、转速），控制步进电机移动指定步数|
|命令|控制直流电机（设置方向引脚、速度引脚、运动方向和速度）|
|命令|初始化 3X4 矩阵键盘（行、列引脚）|
|数值|获取 3X4 矩阵键盘值|
|命令|初始化 MP3 模块（TX、RX 引脚），控制播放、暂停、上一曲、下一曲，设置音量、循环模式和均衡器|

## 示例程序

以下为扩展的基础使用示例：

> 注意：以下步骤仅根据现有积木定义和生成代码整理，尚未经过真实硬件测试，仅供参考，不代表已验证可用。

1. 使用相应初始化积木设置要使用模块的引脚，如“三色灯初始化”“旋转编码器初始化”“MP3模块初始化”等。
2. 使用命令积木控制执行器，如开关蜂鸣器、设置风扇转速、点亮三色灯、驱动步进电机或直流电机、播放语音等。
3. 使用数值和布尔积木读取传感器状态，如判断按键是否被按下、获取旋转编码器位置值、读取寻迹和矩阵键盘结果，并进行判断输出。

## 支持列表

|主板型号|实时模式|ArduinoC|MicroPython|备注|
|---|:---:|:---:|:---:|---|
|dev-DFRobot-microbitV2|||||
|dev-DFRobot-arduinoLeonardo|||||
|dev-DFRobot-arduinoUno||✓||上传模式|
|dev-DFRobot-arduinoNano|||||
|dev-DFRobot-handpyEsp32|||||
|dev-DFRobot-arduinoMega2560|||||
|dev-DFRobot-firebeetleEsp32|||||
|dev-DFRobot-firebeetleEsp32E|||||
|dev-DFRobot-unihikerK10|||||

## 更新日志

### V0.0.2

- 扩展库迁移

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`乐造-lzboardkit-thirdex`
- 原作者：乐造
- 原始仓库：无