diff --git a/docs/peripheral/bluetooth_gamepad/main.md b/docs/peripheral/bluetooth_gamepad/main.md index c0fe78f..fa89023 100644 --- a/docs/peripheral/bluetooth_gamepad/main.md +++ b/docs/peripheral/bluetooth_gamepad/main.md @@ -1,219 +1,5 @@ # 蓝牙手柄V2.0 -## 一、实物图 +蓝牙手柄使用说明请参考新的文档中心： -![1722406687857](pictures/1722406687857.png) - -## 二、介绍 - -此款手柄是使用经典蓝牙与ESP32芯片系列进行直连控制，用户在开发板受控端的代码中输入手柄背部的蓝牙配对码连接使用，不会与其他手柄或者开发板串扰。使用方法简单方便，相对于上一个版本手柄，省去了读取ESP32蓝牙MAC地址再配置到手柄的这一繁琐的过程。 - -![1722406763110](pictures/1722406763110.png) - -## 三、规格参数 - -- 电池容量：400mA - -- 充电：5V0.5A、5V1A、5V2A - -- 震动反馈：无 - -- 蓝牙连接距离：约10M - -- 蓝牙标准：仅支持传统经典蓝牙，不支持低功耗蓝牙 (Bluetooth LE) - -- 支持的芯片系列： - -| 芯片系列 | 是否支持 | -| --- | --- | -| ESP32系列 | 是 | -| ESP32-P系列 | 否 | -| ESP32-S系列 | 否 | -| ESP32-C系列 | 否 | -| ESP32-H系列 | 否 | -| ESP8266系列 | 否 | - -**请前往乐鑫官网（链接：）确认你的开发板或者模组对应的芯片系列，此款手柄不能用于ESP32芯片系列以外的芯片。** - - ![1722406833331](pictures/1722406833331.png) - -## 四、使用步骤 - -- 第一次使用前请插在电脑的USB端口或者5V输出的电源适配器上充会儿电，约5分钟即可，避免在使用过程中因亏电而出现莫名其妙的现象。 - -### 4.1 Arduino IDE - -#### 4.1.1 安装库 - -先下载安装库`PS3 Controller Host`，这是Arduino官方库，使用Arduino IDE搜索并安装 PS3 Controller Host，该库的相关介绍可以参考官网： - -![1722406955164](pictures/1.png) - -![1722407010791](pictures/2.png) - -#### 4.1.2 输入蓝牙配对码并运行示例代码 - -将ESP32主板与电脑连接，主板型号选择ESP32-WROOM-DA Module，如下图： - -![1722407455098](pictures/5.png) - -Arduino IDE打开`PS3 Controller Host`的**连接**，示例代码：**Arduino IDE -> 文件 -> 示例 -> PS3 Controller Host -> Ps3Connect** - -![1722407140583](pictures/3.png) - -将手柄背部的`蓝牙配对码`输入到代码中运行，例如手柄蓝牙配对码为`02:00:01:23:45:67` - -在示例代码中，找到`setup`函数中的代码`Ps3.begin("01:02:03:04:05:06");`，将其修改为`Ps3.begin("02:00:01:23:45:67");`，注意！每个手柄的配对码都不同！！！ - -![1722407278246](pictures/4.png) - -保存后编译烧录到ESP32，烧录完成按下板子复位键进行复位，运行成功后串口（示例代码中设置的串口波特率为115200）会有如下打印： - -![1722409802804](pictures/6.png) - -#### 4.1.3 配对连接 - -1. 将PS3手柄与电脑或者电源适配器断开连接，不要插任何数据线或者充电线！ - -2. 将ESP32主板下载好程序并保持与电脑连接，打开IDE的串口监视器，保持波特率为115200 - -3. 长按手柄一下中间的`单圆键`，手柄的**4个指示灯**会同时**快闪**，这时手柄会自动查询连接ESP32，如果是第一次连接可能要再按一下ESP32的复位键，或多次，不同的主板可能反应速度不一样 - -4. 连接到ESP32后，ESP32串口会循环打印Connected，这样就代表连接成功，如下所示： - - ![1722410151767](pictures/7.png) - -5. 连接成功后4个指示灯会一直闪烁，断线后约10秒会自动关机 - -#### 4.1.4 按键测试 - -手柄按键摇杆等测试，请自行运行和学习`PS3 Controller Host`的测试代码 - -![1722410724619](pictures/8.png) - -- 测试手柄右边4个按键的测试代码：**Arduino IDE -> 文件 -> 示例 -> PS3 Controller Host -> Ps3Data** - -- 测试手柄所有按键的测试代码：**Arduino IDE -> 文件 -> 示例 -> PS3 Controller Host -> Ps3Demo** - -- **注意**，运行这些测试代码，都需要将手柄背部的`蓝牙配对码`输入到`setup`函数中`Ps3.begin("xx:xx:xx:xx:xx:xx")`函数中，如`Ps3.begin("02:00:01:23:45:67");` - -### 4.2 Mixly - -#### 4.2.1 安装库 - -打开mixly，选择Arduino ESP32 为主板模式，将ESP32主板与电脑连接。 - -![1722411639756](pictures/9.png) - -点击软件左上角设置——管理库，添加Emakefun传感器库。 - -![1722411726600](pictures/10.png) - -![1722411752201](pictures/11.png) - -安装后，在EmakefunSensors—通信模块 类别中可找到PS3相关编程指令。 - -![1722411873696](pictures/12.png) - -#### 4.2.2 输入蓝牙配对码并运行示例代码 - -点击此处链接查看[mixly示例程序下载](./ps3按键测试.zip) - -参照示例编写程序或使用示例程序，注意输入手柄背面的蓝牙配对码，每个手柄在出厂时已设置不同的配对码。 - -![1722412044330](pictures/13.png) - -#### 4.2.3 配对连接 - -1. 将PS3手柄与电脑或者电源适配器断开连接，不要插任何数据线或者充电线！ -2. 将ESP32主板下载好程序并保持与电脑连接，打开串口监视器，保持波特率为115200 -3. 长按手柄一下中间的`单圆键`，手柄的**4个指示灯**会同时**快闪**，这时手柄会自动查询连接ESP32，如果是第一次连接可能要再按一下ESP32的复位键，或多次，不同的主板可能反应速度不一样 -4. 连接到ESP32后，ESP32串口会循环打印Connected，这样就代表连接成功，如下所示： - -![1722412332453](pictures/14.png) - -#### 4.2.4 按键测试 - -点击点击此处链接查看[mixly示例程序下载](./ps3按键测试.zip) - -经测试，所有按键在按下时反馈数字1，未按下为0； - -![1722413004733](pictures/15.png) - -左右摇杆值为-128-127之间，中间值为0; - -![1722412948170](pictures/16.png) - -### 4.3 Mind+ - -#### 4.3.1 安装库 - -点击点击此处链接查看[Mind+示例程序和库文件下载](./mind+库和示例程序.zip) - -打开Mind+，选择FireBeetle ESP32-E 为主板模式，将ESP32主板与电脑连接。 - -![1722416107267](pictures/23.png) - -右上角点击“用户库”，然后点击导入用户库。 - -![1722416204699](pictures/27.png) - -找到下载的库文件，打开。 - -![1722416285205](pictures/24.png) - -打开成功后出现如下界面。 - -![1722416328917](pictures/25.png) - -![1722416364603](pictures/26.png) - -库文件安装成功后，返回编程主界面，在“用户库”中可找到PS3相关编程指令。 - -![1722415675555](pictures/21.png) - -#### 4.3.2 输入蓝牙配对码并运行示例代码 - -参照示例编写程序或使用示例程序，注意输入手柄背面的蓝牙配对码，每个手柄在出厂时已设置不同的配对码。 - -![1722415249614](pictures/17.png) - -#### 4.3.3 配对连接 - -1. 将PS3手柄与电脑或者电源适配器断开连接，不要插任何数据线或者充电线！ - -2. 将ESP32主板下载好程序并保持与电脑连接，打开串口监视器，保持波特率为115200 - -3. 长按手柄一下中间的`单圆键`，手柄的**4个指示灯**会同时**快闪**，这时手柄会自动查询连接ESP32，如果是第一次连接可能要再按一下ESP32的复位键，或多次，不同的主板可能反应速度不一样 - -4. 连接到ESP32后，ESP32串口会循环打印Connected，这样就代表连接成功，如下所示： - -![1722415319461](pictures/18.png) - -#### 4.3.4 按键测试 - -经测试，所有按键在按下时反馈数字1，未按下为0； - -![1722415548468](pictures/19.png) - -左右摇杆值为-128-127之间，中间值为0; - -![1722415593047](pictures/20.png) - -## 充电说明 - -- 手柄充电请使用电脑的USB端口充电或者标准的5V0.5A、5V1A或5V2A电源适配器，**不支持任何快充充电器** - -- 充电指示：1-4号灯或者1和4号灯慢闪 - -- 满电指示：1-4号灯全部常亮或者全部熄灭、1和4号灯常亮 - -## 注意事项 - -- 这款手柄只支持与**ESP32**芯片系列连接，无法支持与其他设备连接，如电脑手机等。该手柄**非**市面普通PS游戏手柄，**请勿作他用**。 - -## FAQ - -如果要使用手柄的按键或摇杆进行操控，例如控制小车等，可将接收到的值进行判断，然后进行操作，例如： - -![1722416017103](pictures/22.png) +[PS3蓝牙手柄](https://emakefun.github.io/emakefun-docsify/#/zh-cn/peripheral/bluetooth_gamepad_ps3/bluetooth_gamepad_ps3)