当前位置： 首页 > news >正文

立创EDA趣味项目：基于ESP32-CAM与SPI屏的电子木鱼，实现蓝牙广播触发苹果手机弹窗

news 2026/3/27 6:40:36

立创EDA趣味项目：基于ESP32-CAM与SPI屏的电子木鱼，实现蓝牙广播触发苹果手机弹窗

最近在立创EDA上看到一个特别有意思的项目——电子木鱼。它可不是一个简单的桌面摆件，而是用ESP32-CAM做主控，配上一块SPI彩色屏，每次你按下按键“敲”一下木鱼，它就能向周围发送特殊的蓝牙广播，让附近的苹果手机弹出通知。想象一下，隔空给朋友“敲木鱼”的恶作剧效果，是不是很有趣？

这个项目完美结合了硬件交互（按键、彩屏动画）和无线通信（蓝牙广播），非常适合想学习ESP32蓝牙应用、或者想做个有趣物联网小装置的嵌入式爱好者。今天，我就带你从零开始，手把手复现这个项目，咱们不光要让木鱼“敲”起来，还要弄明白它背后的原理。

1. 项目核心：硬件与功能解析

在动手写代码之前，咱们得先搞清楚这个电子木鱼到底是怎么工作的，以及我们需要准备哪些硬件。

1.1 硬件清单与核心原理

这个项目的核心硬件就三样：

  1. 主控芯片：ESP32-CAM。它不仅仅是ESP32，还集成了摄像头功能（本项目虽未用到摄像头，但板子资源丰富）。最重要的是，它内置了蓝牙和Wi-Fi，是我们实现蓝牙广播功能的关键。
  2. 显示设备：SPI接口的彩色显示屏。用来显示木鱼的图案、动画以及敲击次数等信息。SPI接口通信简单，占用引脚少，非常适合这种需要动态刷新的场景。
  3. 输入设备：按键。用于模拟“敲击”木鱼的动作，是用户与设备交互的入口。

那么，它是如何让苹果手机弹窗的呢？这里用到了一个苹果设备特有的功能：蓝牙广播包解析。ESP32-CAM的蓝牙模块可以扮演一个“广播者”的角色，持续向外发送特定的数据包。苹果手机的iOS系统在后台会扫描这些广播包。当我们按照苹果定义的特定格式（例如iBeacon、AirTag等使用的格式）来组织广播数据时，iOS识别到后，就可能根据场景在锁屏界面或通知中心弹出提示。我们这个项目，就是模拟了这种广播包，从而“欺骗”手机弹出通知。

1.2 系统工作流程

整个系统的工作流程可以概括为以下几步：

  1. 初始化：系统上电，初始化SPI屏幕（显示开机画面）、初始化蓝牙（准备广播）、初始化按键（等待输入）。
  2. 待机显示：彩色屏幕上显示一个静态的、或者有简单动画的木鱼图像。
  3. 用户交互：用户按下按键。
  4. 视觉反馈：屏幕立刻播放一个“敲击”木鱼的动画（比如木鱼震动、光效、或显示“功德+1”），给予用户即时反馈。
  5. 无线触发：与此同时，ESP32-CAM的蓝牙模块开始发送一组预先配置好的、能让苹果手机识别的蓝牙广播包。
  6. 手机响应：附近的苹果手机接收到这组广播包，系统识别后，在通知界面弹出提示（效果类似于“检测到未知配件”或“AirTag”提醒）。
  7. 循环：一次敲击动作完成，系统回到待机显示状态，等待下一次按键。

2. 硬件连接与工程搭建

理解了原理，咱们就来动手连接硬件。ESP32-CAM的引脚比较多，连接时需要特别注意。

2.1 ESP32-CAM与SPI屏的引脚连接

ESP32-CAM模块的引脚是排针形式，我们需要根据SPI屏的接口定义进行连接。这里以一款常见的1.3寸SPI彩屏（驱动芯片为ST7789）为例。

ESP32-CAM 引脚SPI 屏幕引脚功能说明
GPIO 14SCL / CLKSPI时钟信号线
GPIO 15SDA / MOSISPI主设备输出、从设备输入数据线
GPIO 13RES / RST屏幕复位引脚（低电平复位）
GPIO 12DC / RS数据/命令选择引脚（高电平数据，低电平命令）
GPIO 2CS / CS片选引脚（低电平选中该设备）
3.3VVCC电源正极（务必接3.3V！）
GNDGND电源地

注意：一定要将屏幕的VCC连接到ESP32-CAM的3.3V引脚，而不是5V，否则可能会烧毁屏幕。

2.2 按键的连接

按键的连接就简单多了，我们使用一个轻触开关即可。

  • 按键的一端连接到ESP32-CAM的某个GPIO（例如GPIO 4）。
  • 按键的另一端连接到GND。
  • 在ESP32-CAM的GPIO 4和3.3V之间，还需要连接一个上拉电阻（约10kΩ）。这样，当按键未按下时，GPIO 4通过电阻被拉高到3.3V（读取为高电平）；当按键按下时，GPIO 4直接连接到GND（读取为低电平）。很多ESP32开发板内部已启用上拉电阻，在代码中配置即可。

2.3 在立创EDA或Arduino IDE中建立项目

软件层面，我们使用Arduino IDE进行开发，因为它对ESP32和蓝牙库的支持非常友好。

  1. 安装ESP32开发板支持：打开Arduino IDE，进入“文件 -> 首选项”，在“附加开发板管理器网址”中添加：https://espressif.github.io/arduino-esp32/package_esp32_index.json。然后进入“工具 -> 开发板 -> 开发板管理器”，搜索“esp32”，安装“Espressif Systems”的ESP32平台。
  2. 选择开发板：安装完成后，在“工具 -> 开发板”中选择“ESP32 Wrover Module”。对于ESP32-CAM，需要额外设置：Tools -> Partition Scheme选择 “Huge APP (3MB No OTA/1MB SPIFFS)”，Flash Size选择 “4MB (32Mb)”。
  3. 安装库文件：我们需要两个库：
    • TFT_eSPI：用于驱动SPI屏幕。可以通过“项目 -> 加载库 -> 管理库”搜索安装。
    • BLE：ESP32的蓝牙库已包含在开发板支持包中，无需额外安装。

3. 核心代码实现与讲解

接下来是重头戏，我们分模块编写代码。我会把关键代码和解释一起放出来。

3.1 驱动SPI屏幕显示木鱼

首先，我们要让屏幕亮起来，显示木鱼图片或图形。这里使用TFT_eSPI库，它功能强大且效率高。

#include <TFT_eSPI.h> // 包含TFT_eSPI库 TFT_eSPI tft = TFT_eSPI(); // 创建显示屏对象 // 定义与屏幕连接的引脚（需要与TFT_eSPI库的User_Setup.h文件配置一致） // 通常需要在库的配置文件中修改，这里假设你已正确配置 // #define TFT_CS 2 // 对应GPIO2 // #define TFT_DC 12 // 对应GPIO12 // #define TFT_RST 13 // 对应GPIO13 void setup() { Serial.begin(115200); // 初始化屏幕 tft.init(); tft.setRotation(1); // 根据屏幕实际方向调整旋转角度（0-3） tft.fillScreen(TFT_BLACK); // 清屏为黑色 // 绘制一个简单的木鱼（这里用矩形和圆形代替） drawWoodenFish(); } void loop() { // 主循环，后续加入按键检测 } void drawWoodenFish() { // 绘制木鱼身体（棕色矩形） tft.fillRoundRect(50, 70, 140, 60, 10, TFT_BROWN); // 绘制木鱼头部（红色圆形） tft.fillCircle(120, 60, 30, TFT_RED); // 显示文字 tft.setTextColor(TFT_WHITE); tft.setTextSize(2); tft.setCursor(80, 150); tft.println("Electronic"); tft.setCursor(90, 170); tft.println("Wooden Fish"); }

3.2 按键检测与敲击动画

然后，我们添加按键检测功能，并在按下时播放一个简单的动画。

// 定义按键引脚 #define BUTTON_PIN 4 int lastButtonState = HIGH; // 存储按键上一次的状态（内部上拉，初始为高） int buttonState; unsigned long lastDebounceTime = 0; // 上次抖动时间 unsigned long debounceDelay = 50; // 消抖延时（毫秒） void setup() { // ... 之前的屏幕初始化代码 ... pinMode(BUTTON_PIN, INPUT_PULLUP); // 将按键引脚设置为输入上拉模式 } void loop() { // 读取按键状态 int reading = digitalRead(BUTTON_PIN); // 消抖处理：如果状态改变，记录时间 if (reading != lastButtonState) { lastDebounceTime = millis(); } // 如果状态稳定时间超过消抖延时 if ((millis() - lastDebounceTime) > debounceDelay) { // 如果稳定后的状态与当前记录的状态不同 if (reading != buttonState) { buttonState = reading; // 如果状态变为低电平（按键按下） if (buttonState == LOW) { onFishKnocked(); // 调用敲击木鱼的处理函数 } } } lastButtonState = reading; } void onFishKnocked() { Serial.println("Knocked!"); // 1. 播放敲击动画（例如屏幕闪烁或木鱼变色） tft.fillScreen(TFT_YELLOW); delay(80); drawWoodenFish(); // 恢复木鱼画面 delay(80); // 2. 触发蓝牙广播（下一节实现） startBLEBroadcast(); }

3.3 实现蓝牙广播（触发手机弹窗的关键）

这是最核心的部分。我们将使用ESP32的BLE库来发送广播。为了让苹果手机弹窗，我们需要构造一个特定的广播数据帧。这里我们模拟一个iBeacon的广播格式，这是苹果支持的一种协议。

#include <BLEDevice.h> #include <BLEUtils.h> #include <BLEBeacon.h> // 可能需要单独下载或使用BLEAdvertising中的方法 BLEAdvertising *pAdvertising; // BLE广告对象 void startBLEBroadcast() { Serial.println("Starting BLE Broadcast to trigger iPhone pop-up..."); // 初始化BLE设备，设备名可以任意 BLEDevice::init("ESP32_WoodenFish"); // 获取广播对象 pAdvertising = BLEDevice::getAdvertising(); // 构造一个iBeacon数据包 BLEBeacon myBeacon; // 设置iBeacon的UUID（这是一个16字节的标识符，可以自定义，但格式要正确） // 例如：使用一个固定的UUID，这里用示例值 uint8_t beaconUUID[16] = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x10}; myBeacon.setProximityUUID(BLEUUID(beaconUUID, 16, false)); myBeacon.setMajor(100); // Major值 myBeacon.setMinor(1); // Minor值 myBeacon.setSignalPower(0xC5); // 校准的RSSI值（在1米处的信号强度） // 将iBeacon数据设置为广播数据 BLEAdvertisementData advertisementData; advertisementData.setFlags(0x06); // 通用可发现模式，不支持经典蓝牙 advertisementData.setManufacturerData(myBeacon.getData()); // 关键！放入iBeacon制造商数据 pAdvertising->setAdvertisementData(advertisementData); // 开始广播（持续一段时间，比如3秒） pAdvertising->start(); Serial.println("Advertising started..."); delay(3000); // 广播持续3秒 pAdvertising->stop(); Serial.println("Advertising stopped."); // 释放BLE资源，以便下次按键能重新初始化（重要！） BLEDevice::deinit(true); }

代码关键点解释：

  • BLEBeacon类帮助我们轻松构造符合苹果iBeacon格式的数据包。
  • setProximityUUID、setMajor、setMinor这些值共同定义了一个唯一的“信标”。苹果手机扫描到这些特定格式的数据，就可能弹出“附近有AirTag或Find My网络配件跟随您”之类的通知（具体提示因iOS版本和设置而异）。
  • 广播只持续3秒就停止，是为了省电，并且防止持续广播干扰其他设备。
  • 每次广播后调用BLEDevice::deinit(true)是为了彻底释放蓝牙堆栈，确保下次按键时能重新成功初始化并广播。这是一个实践中的小技巧，能提高稳定性。

4. 项目整合与调试心得

将以上三个部分的代码整合到一个.ino文件中，上传到ESP32-CAM。连接好硬件后，你就可以按下按键，看到屏幕动画，并尝试用苹果手机靠近了。

调试过程中可能会遇到的坑和技巧：

  1. 屏幕不亮：首先检查电源是否接在3.3V，然后检查TFT_eSPI库中的User_Setup.h文件，确保里面的引脚定义与你实际的硬件连接完全一致。这是最常见的问题。
  2. 蓝牙广播不成功：
    • 确保代码中包含了正确的头文件，并且BLE库可用。
    • 在手机上下载一个“BLE扫描器”App（如nRF Connect），查看是否能扫描到名为“ESP32_WoodenFish”的设备，以及它的广播数据中是否包含“Manufacturer Data”且长度为0x1A（26字节）。如果能扫到，说明广播本身是成功的。
  3. 苹果手机不弹窗：
    • 这是预期行为之一。苹果对于弹窗有严格的限制和触发逻辑，并非所有iBeacon格式广播都会立即弹窗。它可能与系统版本、手机设置（如“查找”网络开关）、手机状态（锁屏/亮屏）以及广播信号的强度、时长有关。
    • 项目的核心乐趣在于实现了蓝牙广播的机制。成功让BLE扫描器看到设备，就意味着你的ESP32已经具备了“隔空交互”的硬件能力。弹窗是苹果系统层的响应，我们无法100%控制。
  4. 功耗考虑：本项目为演示，未做深度睡眠优化。实际如果想做成电池供电的便携设备，需要在非操作时让ESP32进入深度睡眠模式，仅靠按键中断唤醒，这将大大延长续航。

这个电子木鱼项目虽然简单，但它串联起了嵌入式开发的几个关键环节：外设驱动（屏幕）、人机交互（按键）、无线通信（蓝牙）。希望你在复现的过程中，不仅能收获一个有趣的小玩具，更能理解这些技术如何协同工作。试试看，给你的朋友一个“惊喜”吧！

http://www.jsqmd.com/news/460396/

相关文章：

  • 蓝牙Mesh协议v1.1升级指南：DFU远程升级与BLOB传输在工业传感器网络中的应用
  • NCMDump开源工具：让NCM格式音乐自由转换的技术民主化实践
  • 【开源实战】用RP2040与PulseView打造你的首款桌面级逻辑分析仪
  • EyouCMS反序列化漏洞实战：从漏洞挖掘到RCE利用
  • Python实战：用NumPy手搓MSE损失函数（附梯度下降可视化）
  • ESP32芯片与模组包装规范：丝印解码、载带参数与MSL 3湿敏管控
  • LeagueAkari：让英雄联盟体验更流畅的自动化辅助工具
  • WVP-PRO流媒体服务：无人观看场景下的智能资源回收策略
  • SeqGPT长文本生成：突破上下文限制的解决方案
  • Qt Model/View实战：5分钟搞定一个可编辑的表格视图（附完整代码）
  • ESP32管脚复用与电源域设计：IO_MUX与GPIO Matrix工程指南
  • 在JavaScript / HTML中，获取指定元素的父元素
  • 树莓派3B+上利用Docker容器化部署EMQX消息引擎实战指南
  • 开箱即用！春联生成模型-中文-base：Web界面直接输入关键词生成春联
  • 立创Foundation V3S超迷你核心板：6层板设计与双面焊接实战解析
  • 避坑指南：华视电子Web开发包从IE迁移到Chrome的全过程（附2022版SDK下载）
  • fft npainting lama图片修复系统快速部署：新手也能轻松使用
  • DAMO-YOLO问题解决：启动失败、识别不准、数据导出全攻略
  • 深入解析SENT协议在汽车电子中的关键作用
  • Youtu-Parsing解决OCR痛点：精准识别手写体、印章和复杂表格
  • AI读脸术轻量级方案：适合边缘设备的年龄性别识别工具
  • ESP32-C61模组深度解析：Wi-Fi 6+BLE双模硬件架构与工程落地
  • 百度网盘开源解析工具：突破下载限制的高效链接解析方案
  • 【技术解析】DNBSEQ双Barcode设计与Index Hopping免疫机制探秘
  • 工业自动化新玩法：用汇川ITP+Autoshop搭建低成本仿真实验室（含完整工程文件）
  • MFC程序语言切换避坑指南：为什么你的ini配置文件不生效？
  • ChatGLM3-6B Streamlit极速体验效果展示：100轮对话无卡顿实测报告
  • LoRA训练助手惊艳效果：自动补全‘未提及但关键’的训练维度（如hand position）
  • 基于立创GD32E230开发板与AMG8833模块的低成本红外热成像仪DIY全攻略
  • ofa_image-caption生产环境应用：低延迟图像描述服务嵌入内部知识库