# ext2-ul-marxmakepbl

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

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-12
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# Marxmake PBL

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

`marxmakepbl` 是一个适用于 Mind+ V2 上传模式的扩展（PBL是为普及STEAM创客教育、人工智能教育、编程教育研发的开源人工智能硬件。）。
该扩展共提供 52 个积木，支持的主板范围见下方“支持列表”。

## 支持的产品 / 型号

- Marxmake PBL（config 中未提供 SKU）

## 积木

| 类型 | 积木功能 |
|---|---|
| 数值 | [A] 按位与 [B] |
| 数值 | [A] 按位或 [B] |
| 数值 | [A] 按位异或 [B] |
| 数值 | 按位非 [A] |
| 数值 | [A] 右移 [B] |
| 数值 | [A] 左移 [B] |
| 命令 | 跳出当前循环 |
| 命令 | 跳出本次循环 |
| 命令 | 计时器 [TIMER_NAME] 初始化 |
| 数值 | 获取计时器 [TIMER_NAME] 的值（毫秒） |
| 命令 | 计时器 [TIMER_NAME] 清零 |
| 布尔 | 按键 端口 [GENERAL_PORT] 是否按下？ |
| 布尔 | 槽型光耦 端口 [GENERAL_PORT] 是否检测到物体？ |
| 布尔 | 人体热释 端口 [GENERAL_PORT] 是否检测到人？ |
| 布尔 | 1路触摸 端口 [GENERAL_PORT] 是否按下？ |
| 布尔 | 4路触摸 端口 [GENERAL_PORT] 第 [TOUCH_CHANNEL] 路 是否按下？ |
| 数值 | 获取超声波 端口 [GENERAL_PORT] 的值（cm） |
| 数值 | 获取滑动电阻 端口 [SPECIFIC_PORT] 的值 |
| 数值 | 获取土壤湿度 端口 [SPECIFIC_PORT] 的值 |
| 数值 | 获取光照强度 端口 [SPECIFIC_PORT] 的值 |
| 数值 | 获取声音 端口 [SPECIFIC_PORT] 的值 |
| 数值 | 获取红外接收 端口 [GENERAL_PORT] 的值 |
| 数值 | 获取光电 端口 [SPECIFIC_PORT] 的值 |
| 数值 | 获取温湿度 端口 [GENERAL_PORT] [TEMPERATURE_HUMIDITY] 的值 |
| 命令 | 振动马达 端口 [SPECIFIC_PORT] 功率 [VIBRATION_INTENSITY] |
| 命令 | 直流电机 端口 [SPECIFIC_PORT] 功率 [DCMOTOR_SPEED] |
| 命令 | 舵机 端口 [GENERAL_PORT] 旋转角度 [ROTATION_ANGLE] |
| 数值 | 获取舵机 端口 [GENERAL_PORT] 的旋转角度 |
| 命令 | 每分钟 [BEATS] 节拍 |
| 命令 | 蜂鸣器 端口 [SPECIFIC_PORT] 播放音符 [NOTES] |
| 命令 | 蜂鸣器 端口 [SPECIFIC_PORT] 播放音符 [NOTES] 节拍 [BEAT_NUMBER] |
| 命令 | 蜂鸣器 端口 [SPECIFIC_PORT] 停止 |
| 命令 | 蜂鸣器 端口 [SPECIFIC_PORT] 休止节拍 [BEAT_NUMBER] |
| 数值 | 红 [RED] 绿 [GREEN] 蓝 [BLUE] |
| 命令 | 彩灯 [COLORFUL_LED_NAME] 端口 [GENERAL_PORT] 灯数 [LED_NUMBERS] 初始化 |
| 命令 | 彩灯 [COLORFUL_LED_NAME] 颜色 [LED_COLOR] |
| 命令 | 彩灯 [COLORFUL_LED_NAME] 灯号 [LED_ORDER] 颜色 [LED_COLOR] |
| 命令 | 4位数码管 [FOUR_DIGITAL_TUBE_NAME] 端口 [GENERAL_PORT] 初始化 |
| 命令 | 4位数码管 [FOUR_DIGITAL_TUBE_NAME] 显示数字 [DISPLAY_NUMBER] |
| 命令 | 4位数码管 [FOUR_DIGITAL_TUBE_NAME] 第 [DOT_ORDER] 个 小数点 [DOT_OPERATION] |
| 命令 | 4位数码管 [FOUR_DIGITAL_TUBE_NAME] 清屏 |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 端口 [GENERAL_PORT] 初始化 |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 旋转 [ROTATION_ANGLE] |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] X轴 [AXIS_X] Y轴 [AXIS_Y] 单点设为 [OPERATION] |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 起点X [X0] Y [Y0] 终点X [X1] Y [Y1] 直线设为 [OPERATION] |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 滚动显示文字 [TEXT] 延时 [DELAY] |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 显示图案 [IMAGE] |
| 命令 | 点阵屏 [MATRIX_SCREEN_NAME] 清屏 |
| 命令 | OLED屏 [OLED_SCREEN_NAME] 端口 [GENERAL_PORT] 初始化 |
| 命令 | OLED屏 [OLED_SCREEN_NAME] 第 [ROW] 行 显示文字 [TEXT] |
| 命令 | OLED屏 [OLED_SCREEN_NAME] X [AXIS_X] Y [AXIS_Y]*16 显示文字 [TEXT] |
| 命令 | OLED屏 [OLED_SCREEN_NAME] 清屏 |

## 示例程序

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

1. 在 Mind+ V2 扩展库中加载本扩展，切换到上传模式并连接主控板。
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.3

- 扩展库迁移

## 开发指南

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

## V1 原始库来源

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

- compatibilityId：`chen-marxmake_pbl-thirdex`
- 原作者：chen
- 原始仓库：无