# ext2-ul-k10gamepad

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

## Basic Information

- **Project Name**: ext2-ul-k10gamepad
- **Description**: k10gamepad 是一个适用于 Mind+ V2 的上传模式（Arduino C）功能扩展，为 UNIHIKER K10 提供 BLE 蓝牙游戏手柄（山弯定制款）支持。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# DFRobot GamePad

`k10gamepad` 是一个适用于 Mind+ V2 的上传模式（Arduino C）功能扩展，为 UNIHIKER K10 提供 BLE 蓝牙游戏手柄支持。扩展通过手柄上的 6 位定制序列号快速连接指定手柄，读取摇杆、扳机、按键（含背键 M1/M2）数据，支持震动控制，并支持阻塞式连接与断线自动重连。

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

## 积木
![blocks](./extension/public/images/blocks.png)

## 示例程序
> 积木搭建仅供测试参考，请以实际积木效果与实现功能为准

![ex](./extension/public/images/example.png)

## 支持列表

| 主板型号 | 实时模式 | ArduinoC | MicroPython | 备注 |
| --- | :---: | :---: | :---: | --- |
|dev-DFRobot-unihikerK10||√|||

## 更新日志

### V1.4.0

- 同步 Mind+ V1 扩展 `zrz-k10gamepad-thirdex` V1.4.0，扩展更名为 DFRobot GamePad
- 移除「设置手柄设备名」积木；新增「连接 GamePad」积木（阻塞式连接，串口输出连接过程状态）
- 内置 K10Gamepad 库升级至 1.4.0（新增 `connect()`/`connected()`，支持 esp32/esp32s3 架构）
- 序列号参数生成带引号的 C 字符串，修复 K10 编译报错

### V1.3.0

- 自 Mind+ V1 扩展 `zrz-k10gamepad-thirdex` V1.3.0 转换为 Mind+ V2 扩展
- 10 个积木与 V1 保持一致：序列号初始化、设备名设置、状态更新、连接检测、摇杆/扳机/按键/十字键读取、震动控制
- 内置库：K10Gamepad 1.3.1（序列号绑定 + 异步扫描）、NimBLE-Arduino 2.5.0 裁剪版（纯客户端角色）
- 支持旧版 V1 项目自动匹配（`compatibilityId`）

## 相关链接

- [Mind+官网](https://mindplus.dfrobot.com.cn/)
- [UNIHIKER K10产品页](https://www.unihiker.com/)
- [Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

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

- compatibilityId：`zrz-k10gamepad-thirdex`
- 原作者：zrz
- 原始仓库：无