# ext2-ul-yfrobotespone

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

## Basic Information

- **Project Name**: ext2-ul-yfrobotespone
- **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-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# ESPONEV3

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

`ESPONEV3` 是一个适用于 Mind+ V2 上传模式的执行器扩展。
该扩展支持双电机和单电机驱动、方向运动控制、读取按键状态和电池电压、OLED 显示（初始化、显示文字、清屏、设置字体）以及数字/PWM 引脚输入输出等功能，可用于 ESPONEV3 主控板的电机小车控制与人机交互等应用场景。

支持以下产品 / 型号：

- ESPONEV3 主控板（支持电机驱动、按键、电池电压读取、OLED 显示）

## 积木

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

|类型|积木功能|
|---|---|
|命令|设置电机 M1、M2 的速度|
|命令|设置单个电机的速度|
|命令|以指定速度前进、后退、左转、右转|
|命令|停止指定电机|
|布尔|读取按键 A/B 的状态|
|数值|读取电池电压（单位 V）|
|命令|OLED 128*64 初始化（I2C）|
|命令|OLED 128*64 在指定坐标显示文字|
|命令|OLED 128*64 显示（刷新屏幕）|
|命令|OLED 128*64 清屏|
|命令|OLED 128*64 设置中文字体|
|命令|设置数字引脚输出高/低电平|
|命令|设置 PWM 引脚输出值|
|布尔|读取数字引脚|
|数值|读取模拟引脚的值|

## 示例程序

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

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

1. 使用“OLED 128*64 初始化（I2C）”积木初始化屏幕，再用“OLED 128*64 显示文字”积木在指定坐标写入内容，并用“OLED 128*64 显示”积木刷新显示。
2. 使用“电机 M1 M2”积木分别设置两个电机的速度，或使用“以速度前进/后退/左转/右转”积木控制小车运动，需要停止时使用“电机停止”积木。
3. 在循环中使用“读按键状态”积木检测按键 A/B，使用“读取电池电压（单位V）”积木读取电池电压，并用“读取数字引脚”“读取模拟引脚”积木获取外接模块的输入。

## 支持列表

|主板型号|实时模式|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|||||

## 更新日志

### V3.0.4

- 扩展库迁移

## 开发指南

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

## V1 原始库来源

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

- compatibilityId：`yfrobot-yfrobot_espone-thirdex`
- 原作者：yfrobot
- 原始仓库：https://gitee.com/yfrobot/ext-yfrobot-espone