1. 项目概述与核心思路最近在整理工作室的旧项目时翻出了一个之前和朋友们一起捣鼓的“智能篮球计分系统”。这个项目的初衷很简单我们几个都喜欢在车库门口投投篮但每次计分要么靠脑子记要么用手机App总觉得少了点“仪式感”而且数据也无法和具体的人绑定。于是我们就想能不能自己动手做一个能自动计分、记录玩家数据还有点酷炫灯光反馈的智能篮筐这个项目的核心就是一个典型的物联网IoT应用场景。它需要完成几个关键任务感知检测球是否进筐、识别玩家、处理计算分数、管理游戏时间、联网数据上传、远程访问和反馈屏幕显示、灯光与声音提示。为了实现这些功能我们选择了“树莓派 ESP32”的双核架构。树莓派作为“大脑”负责运行Web服务器、数据库和复杂的业务逻辑ESP32作为“神经末梢”负责实时采集传感器数据。这种主从分工的架构既发挥了树莓派强大的计算和网络能力又利用了ESP32在实时控制和低功耗传感器接口上的优势。整个系统的工作流程可以这样理解玩家先用RFID卡在篮筐底座旁的读卡器上“刷卡签到”系统便知道是谁在玩。投篮时安装在篮筐上的红外对射传感器会检测到篮球穿过篮网触发一次有效得分。ESP32会立刻将这个“进球”信号通过Wi-Fi发送给树莓派。树莓派上的Python程序负责累加该玩家的分数同时管理游戏倒计时。时间结束后树莓派会命令ESP32点亮环绕篮板的LED灯带并响起蜂鸣器宣告游戏结束。玩家和观众可以通过连接树莓派热点的手机网页实时查看得分排行榜和历史记录。这个项目非常适合对嵌入式开发、物联网和Python编程感兴趣的爱好者。它涉及了硬件接线、传感器原理、网络通信HTTP/MQTT、Web开发Flask等多个层面的知识是一个综合性很强的练手项目。接下来我将从设计思路、硬件选型、代码实现到调试心得毫无保留地分享整个构建过程。2. 系统架构设计与硬件选型解析2.1 为什么选择“树莓派 ESP32”双核架构在项目初期我们评估过几种方案。第一种是全部由树莓派完成但树莓派的GPIO口虽然多实时性却不如微控制器且传感器分散布线会很麻烦。第二种是全部由ESP32完成但ESP32运行数据库和复杂的Web服务比较吃力且需要外接显示屏等外设接口可能不够用。最终选择双核架构是基于清晰的职责分离考量树莓派主控中心角色系统服务器与数据中枢。优势运行完整的Linux系统轻松部署Python环境、Flask Web框架和SQLite数据库。它提供了稳定的Wi-Fi热点并处理所有HTTP请求如接收得分、提供网页数据。承担任务用户身份管理、游戏逻辑计时、计分、数据持久化、提供Web管理界面。ESP32传感与控制节点角色前端数据采集与终端执行器驱动。优势具有丰富的数字/模拟IO和硬件中断功能对传感器信号的响应速度极快微秒级。集成了Wi-Fi和蓝牙便于与树莓派通信。功耗相对较低。承担任务实时读取红外传感器、RFID读卡器、心率传感器的信号根据树莓派的指令控制LED灯带和蜂鸣器。两者之间通过局域网的Wi-Fi进行通信我们选择了HTTP POST/GET这种简单直接的协议。树莓派作为服务器开放API接口ESP32作为客户端上报数据和接收指令。这种架构扩展性很好未来如果想增加更多篮筐或传感器节点只需配置新的ESP32即可。2.2 核心硬件组件清单与功能说明以下是项目中用到的所有关键硬件及其作用我会解释为什么选它以及关键的连接注意事项。组件型号/说明在项目中的角色选型理由与注意事项主控制器1树莓派 4B (2GB/4GB)系统大脑运行Web服务与数据库性能足够社区支持强大GPIO和USB口丰富。注意务必配备优质5V/3A电源供电不稳是许多奇怪问题的根源。主控制器2ESP32开发板 (如ESP32 DevKitC)传感器数据采集与灯光/声音控制双核处理器Wi-Fi性能好支持硬件中断价格低廉。身份识别RFID读卡器模块 (RC522)读取玩家RFID卡/标签的UID性价比高SPI接口通信稳定。注意需要3.3V供电与ESP32电平匹配。进球检测红外对射传感器 (槽型光电开关)检测篮球是否穿过篮网非接触式响应速度快。关键必须选用对射式发射与接收分离而非反射式。我们将其安装在篮筐内侧篮球落下时会瞬间阻断光束。生理监测脉搏/心率传感器 (KY-039)可选监测玩家运动心率模拟输出通过ADC读取。用于增加数据维度评估运动强度。环境感知温度传感器 (DS18B20)监测设备工作环境温度单总线协议仅需一根数据线多个传感器可并联。防止设备过热。视觉反馈WS2812B RGB LED灯带 (60珠/米)游戏结束时提供炫彩灯光效果单线串行控制一颗IC控制一颗灯珠颜色编程灵活。注意功率较大需外接5V电源数据线接ESP32 GPIO。听觉反馈有源蜂鸣器游戏开始、结束、进球提示音驱动简单低电平触发。区别于无源蜂鸣器需要频率驱动。信息显示16x2 LCD字符液晶屏 (I2C接口)显示树莓派IP地址、简易状态I2C接口仅需2根数据线节省GPIO。方便玩家连接Wi-Fi。供电系统5V/10A开关电源、降压模块为树莓派、ESP32、灯带等供电灯带全亮时电流巨大必须计算总功耗并留有余量。使用降压模块如LM2596为ESP32等提供3.3V。注意电源设计是硬件项目的“生死线”。我们的系统功耗大致如下树莓派约3AESP32约0.5ALED灯带全白最亮时可达6A以上。因此我们选用了一个5V/10A的工业开关电源作为总电源。树莓派直接由其供电同时电源输出接一个大功率的DC-DC降压模块将电压降至5V和3.3V分别给灯带和ESP32等模块供电。绝对禁止从树莓派的GPIO口取电驱动灯带或电机等大电流设备这极易烧毁树莓派。2.3 机械结构与外壳设计要点原项目的木制盒子方案很有创意但考虑到防水和耐用性我们使用了3D打印和亚克力板结合的方式。控制盒我们设计了一个3D打印的壳体内部有卡槽固定树莓派和ESP32开发板。前面板开孔固定LCD屏、RFID读卡器、蜂鸣器和温度传感器探头。盒子侧面装有船型开关和电源接口。所有连接处使用了**电子硅胶RTV硅橡胶**进行密封和固定这种胶弹性好耐高低温且绝缘非常适合原型制作。篮筐传感器安装这是最具挑战的部分。红外对射传感器的发射器和接收器需要精确地面对面安装在篮筐内侧边缘确保篮球无论从哪个方向入网都会阻断光束。我们使用了小型支架和扎带进行固定并用热熔胶和硅胶做了防水和缓冲处理。传感器线缆沿着篮球架支柱向下用缠绕管收纳最终接入控制盒。LED灯带安装将WS2812B灯带环绕粘贴在篮板背面。切记在灯带和篮板之间贴一层白色反光胶带或使用乳白色漫射罩这样光线会更均匀柔和不会刺眼。灯带的电源线5V和GND需要足够粗建议18AWG以上以减少压降。3. 核心电路连接与传感器调试3.1 ESP32与传感器的接线详解ESP32负责连接所有前端传感器和执行器。接线时务必先断开电源遵循“先信号后电源”的原则。ESP32 GPIO引脚连接组件说明注意事项GPIO 23 (MOSI)RC522 (SI/MOSI)SPI主出从入SPI通信引脚也可用其他SPI接口引脚。GPIO 19 (MISO)RC522 (SO/MISO)SPI主入从出GPIO 18 (SCK)RC522 (SCK)SPI时钟GPIO 5RC522 (SDA/SS)SPI片选每个SPI设备需独占一个片选引脚。GPIO 4红外传感器 (OUT)数字输入配置为INPUT_PULLUP使用中断触发。GPIO 32心率传感器 (AO)模拟输入连接ESP32的ADC1通道GPIO 32-39。GPIO 21 (SDA)LCD屏 (I2C SDA)I2C数据I2C通信需接上拉电阻通常模块已集成。GPIO 22 (SCL)LCD屏 (I2C SCL)I2C时钟GPIO 2WS2812B灯带 (DI)数据输入驱动灯带注意电平匹配5V灯带接3.3V数据线一般也可行。GPIO 15有源蜂鸣器 (I/O)数字输出低电平触发串联一个220Ω电阻保护IO口。GPIO 17DS18B20 (DQ)单总线数据需要接一个4.7kΩ上拉电阻到3.3V。3.3V所有模块的VCC电源正极确保所有模块均为3.3V逻辑电平。GND所有模块的GND电源地线共地至关重要所有GND必须连接在一起。实操心得GPIO分配策略。ESP32的GPIO并非全部平等。有些引脚在启动时有特殊状态如GPIO 12会影响启动模式有些只支持输入。我们的策略是通信协议SPI, I2C使用其默认或灵活引脚中断传感器使用支持中断的通用引脚输出设备灯带、蜂鸣器使用任意输出引脚。务必在代码初始化前查阅你所使用的ESP32开发板的引脚定义图。3.2 传感器单独测试与代码验证在组装整个系统前务必对每个传感器进行单独测试。这能帮你快速定位是硬件问题还是软件问题。红外传感器测试# 这是一个简单的Arduino IDE环境下的测试代码ESP32 const int beamPin 4; // 连接传感器OUT脚 void setup() { Serial.begin(115200); pinMode(beamPin, INPUT_PULLUP); // 启用内部上拉常态为高电平 } void loop() { int beamState digitalRead(beamPin); if (beamState LOW) { // 光束被阻断输出低电平 Serial.println(Goal Detected!); delay(500); // 防抖延时 } delay(10); }用手在传感器间划过串口监视器应打印“Goal Detected!”。调试重点确认传感器供电正常LED灯亮发射器和接收器对准以及信号线连接正确。有时环境光过强会干扰可以加上遮光罩。RFID读卡器测试 使用常用的MFRC522库。测试时将卡靠近读卡器串口应能打印出卡的UID如0xDE 0xAD 0xBE 0xEF。注意读卡距离通常在5cm以内且卡片类型需兼容Mifare Classic 1K。WS2812B灯带测试 使用Adafruit_NeoPixel库。先只接几颗灯珠测试避免短路烧毁全部。测试代码让灯珠依次显示红、绿、蓝色。常见问题数据线接错、电源功率不足导致颜色异常或闪烁。心率传感器测试 KY-039输出的是模拟量数值会随心跳波动。将手指稳定按在传感器上通过串口绘图器观察波形应能看到规律的脉冲峰。注意这个传感器精度一般且对按压力度和位置敏感适合做定性而非定量分析。4. 软件系统构建树莓派服务端4.1 环境配置与Web服务搭建树莓派上我们运行的是Raspberry Pi OS Lite无桌面版通过SSH进行远程操作。# 1. 更新系统并安装必要软件 sudo apt update sudo apt upgrade -y sudo apt install python3-pip python3-venv git -y # 2. 创建项目目录并设置虚拟环境 mkdir ~/smart_basketball cd ~/smart_basketball python3 -m venv venv source venv/bin/activate # 3. 安装Python依赖库 pip install flask flask-sqlalchemy flask-cors requests # Flask: Web框架 # Flask-SQLAlchemy: 数据库ORM # Flask-CORS: 处理跨域请求方便网页调试 # requests: 用于将来可能的扩展如调用外部API4.2 数据库设计与Flask API开发我们使用SQLite数据库轻便且无需额外服务。核心数据表有两个Player玩家和GameRecord游戏记录。# app.py 核心代码结构 from flask import Flask, request, jsonify, render_template from flask_sqlalchemy import SQLAlchemy from datetime import datetime app Flask(__name__) app.config[SQLALCHEMY_DATABASE_URI] sqlite:///scores.db app.config[SQLALCHEMY_TRACK_MODIFICATIONS] False db SQLAlchemy(app) # 定义数据模型 class Player(db.Model): id db.Column(db.Integer, primary_keyTrue) card_uid db.Column(db.String(20), uniqueTrue, nullableFalse) # RFID卡UID name db.Column(db.String(80), nullableFalse) created_at db.Column(db.DateTime, defaultdatetime.utcnow) records db.relationship(GameRecord, backrefplayer, lazyTrue) class GameRecord(db.Model): id db.Column(db.Integer, primary_keyTrue) player_id db.Column(db.Integer, db.ForeignKey(player.id), nullableFalse) score db.Column(db.Integer, default0) game_duration db.Column(db.Integer) # 游戏时长单位秒 heart_rate_avg db.Column(db.Float) # 平均心率 temperature db.Column(db.Float) # 环境温度 played_at db.Column(db.DateTime, defaultdatetime.utcnow) # 创建数据库表首次运行 with app.app_context(): db.create_all() # 核心API端点 app.route(/api/goal, methods[POST]) def add_goal(): ESP32上报进球 data request.json card_uid data.get(card_uid) # 1. 根据card_uid找到或创建玩家 player Player.query.filter_by(card_uidcard_uid).first() if not player: player Player(card_uidcard_uid, namefPlayer_{card_uid[-4:]}) db.session.add(player) db.session.commit() # 2. 找到该玩家今天未结束的游戏记录或创建新的 today datetime.utcnow().date() record GameRecord.query.filter( GameRecord.player_id player.id, db.func.date(GameRecord.played_at) today, GameRecord.game_duration.is_(None) # 未结束的游戏 ).first() if not record: record GameRecord(player_idplayer.id, score0) db.session.add(record) # 3. 分数加一 record.score 1 db.session.commit() return jsonify({success: True, player_name: player.name, current_score: record.score}) app.route(/api/game_end, methods[POST]) def end_game(): 游戏结束更新记录 data request.json card_uid data.get(card_uid) duration data.get(duration) avg_hr data.get(avg_heart_rate) temp data.get(temperature) # ... 逻辑类似找到对应记录并更新时长、心率、温度字段 return jsonify({success: True}) app.route(/api/leaderboard, methods[GET]) def get_leaderboard(): 获取今日排行榜 today datetime.utcnow().date() records db.session.query(Player.name, GameRecord.score).\ join(GameRecord).\ filter(db.func.date(GameRecord.played_at) today).\ order_by(GameRecord.score.desc()).limit(10).all() return jsonify([{name: r[0], score: r[1]} for r in records]) app.route(/) def index(): 提供简单的网页查看排行榜 return render_template(index.html) # 需要创建简单的HTML页面 if __name__ __main__: # 获取本机IP方便ESP32和手机连接 import socket hostname socket.gethostname() local_ip socket.gethostbyname(hostname) print(fServer starting on http://{local_ip}:5000) app.run(host0.0.0.0, port5000, debugTrue)注意事项并发与数据一致性。这个简易Flask服务器使用默认的单线程开发服务器不适合高并发。在实际使用中如果多人快速连续投篮/api/goal接口可能会因数据库会话冲突而出错。生产环境建议1) 使用gunicorn或uWSGI部署Flask2) 对/api/goal接口的数据库操作加锁或使用更原子的SQL语句如UPDATE ... SET score score 13) 或者让ESP32本地缓存进球数每隔几秒批量上报一次减少请求频率。4.3 树莓派网络配置与开机自启为了让手机能方便地连接我们将树莓派设置为Wi-Fi热点并让Flask服务开机自启。配置树莓派为热点使用hostapd和dnsmasqsudo apt install hostapd dnsmasq -y sudo systemctl stop hostapd dnsmasq # 配置静态IP和DHCP (编辑 /etc/dhcpcd.conf) # 配置 hostapd (编辑 /etc/hostapd/hostapd.conf) # 配置 dnsmasq (编辑 /etc/dnsmasq.conf) # ...具体配置步骤较长网上有大量教程 sudo systemctl unmask hostapd sudo systemctl enable hostapd dnsmasq sudo reboot重启后用手机搜索Wi-Fi应该能看到树莓派的热点如SmartBasketball。设置Flask应用为系统服务 创建服务文件/etc/systemd/system/smart-basketball.service[Unit] DescriptionSmart Basketball Score Server Afternetwork.target [Service] Userpi WorkingDirectory/home/pi/smart_basketball EnvironmentPATH/home/pi/smart_basketball/venv/bin ExecStart/home/pi/smart_basketball/venv/bin/python /home/pi/smart_basketball/app.py Restartalways RestartSec10 [Install] WantedBymulti-user.target然后启用服务sudo systemctl daemon-reload sudo systemctl enable smart-basketball.service sudo systemctl start smart-basketball.service # 查看状态和日志 sudo systemctl status smart-basketball.service sudo journalctl -u smart-basketball.service -f这样树莓派开机后就会自动运行我们的计分服务器。5. 软件系统构建ESP32客户端5.1 Arduino框架下的多任务处理ESP32的代码我们使用Arduino IDE进行开发它封装了FreeRTOS方便我们实现多任务。主要任务包括主循环任务处理通信和逻辑、传感器中断服务响应进球、RFID读取任务、灯光控制任务。// 主要全局变量和定义 #include WiFi.h #include HTTPClient.h #include MFRC522.h #include Wire.h #include LiquidCrystal_I2C.h #include Adafruit_NeoPixel.h #include OneWire.h #include DallasTemperature.h // 网络配置 const char* ssid SmartBasketball; // 树莓派热点名 const char* password yourpassword; const char* serverURL http://192.168.4.1:5000/api/goal; // 树莓派热点网关通常是.1 // 引脚定义 #define SS_PIN 5 #define RST_PIN 0 // 可根据需要连接 #define BEAM_PIN 4 #define HEART_RATE_PIN 32 #define LED_PIN 2 #define BUZZER_PIN 15 #define ONE_WIRE_BUS 17 // 对象初始化 MFRC522 rfid(SS_PIN, RST_PIN); LiquidCrystal_I2C lcd(0x27, 16, 2); // I2C地址可能是0x3F需扫描确认 Adafruit_NeoPixel strip Adafruit_NeoPixel(60, LED_PIN, NEO_GRB NEO_KHZ800); OneWire oneWire(ONE_WIRE_BUS); DallasTemperature tempSensor(oneWire); // 全局状态变量 volatile bool goalDetected false; // 中断中修改用volatile String currentCardUID ; unsigned long gameStartTime 0; const long GAME_DURATION 120000; // 游戏时长2分钟单位毫秒 // 中断服务函数必须简单快速 void IRAM_ATTR onGoal() { goalDetected true; } void setup() { Serial.begin(115200); // 初始化各模块 SPI.begin(); rfid.PCD_Init(); lcd.init(); lcd.backlight(); strip.begin(); strip.show(); // 初始化灯带全灭 tempSensor.begin(); pinMode(BUZZER_PIN, OUTPUT); digitalWrite(BUZZER_PIN, HIGH); // 有源蜂鸣器高电平关闭 // 配置红外传感器中断下降沿触发从HIGH到LOW pinMode(BEAM_PIN, INPUT_PULLUP); attachInterrupt(digitalPinToInterrupt(BEAM_PIN), onGoal, FALLING); // 连接Wi-Fi WiFi.begin(ssid, password); lcd.print(Connecting...); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } lcd.clear(); lcd.print(Connected!); lcd.setCursor(0,1); lcd.print(WiFi.localIP()); // 显示ESP32的IP非必须 delay(2000); lcd.clear(); lcd.print(Scan Card to Start); // 初始化游戏状态 gameStartTime 0; } void loop() { // 任务1: 处理RFID刷卡 handleRFID(); // 任务2: 处理进球检测 if (goalDetected) { goalDetected false; // 清除标志 handleGoalScored(); } // 任务3: 检查游戏是否超时 checkGameTimeout(); // 任务4: 可选读取并发送心率、温度数据 // 可以放在定时器中避免阻塞主循环 delay(10); // 短暂延时释放CPU控制权 }5.2 关键功能函数实现处理RFID刷卡void handleRFID() { // 检查是否有新卡片 if (!rfid.PICC_IsNewCardPresent() || !rfid.PICC_ReadCardSerial()) { return; } // 读取卡片的UID并转换为16进制字符串 String uidString ; for (byte i 0; i rfid.uid.size; i) { uidString String(rfid.uid.uidByte[i], HEX); } uidString.toUpperCase(); Serial.print(Card UID: ); Serial.println(uidString); currentCardUID uidString; lcd.clear(); lcd.print(Player: ); lcd.print(uidString.substring(0, 4)); // 显示后4位 lcd.setCursor(0,1); lcd.print(Game Start!); // 蜂鸣器提示 digitalWrite(BUZZER_PIN, LOW); delay(100); digitalWrite(BUZZER_PIN, HIGH); // 记录游戏开始时间 gameStartTime millis(); // 停止读卡避免重复读取 rfid.PICC_HaltA(); rfid.PCD_StopCrypto1(); }处理进球并上报服务器void handleGoalScored() { if (currentCardUID || gameStartTime 0) { // 未刷卡或游戏未开始进球无效 Serial.println(Goal ignored. No active player.); return; } // 本地蜂鸣器短促提示 digitalWrite(BUZZER_PIN, LOW); delay(50); digitalWrite(BUZZER_PIN, HIGH); // 准备JSON数据 String jsonPayload {\card_uid\:\ currentCardUID \}; // 发送HTTP POST请求到树莓派 if (WiFi.status() WL_CONNECTED) { HTTPClient http; http.begin(serverURL); http.addHeader(Content-Type, application/json); int httpResponseCode http.POST(jsonPayload); if (httpResponseCode 0) { String response http.getString(); Serial.println(Goal posted. Response: response); // 可以解析响应在LCD上显示当前分数 } else { Serial.print(Error on sending POST: ); Serial.println(httpResponseCode); // 网络错误处理可以本地缓存进球稍后重试 } http.end(); } else { Serial.println(WiFi Disconnected); } }游戏超时与灯光效果void checkGameTimeout() { if (gameStartTime 0) return; // 游戏未开始 unsigned long currentTime millis(); if (currentTime - gameStartTime GAME_DURATION) { // 游戏结束 lcd.clear(); lcd.print(Times Up!); triggerGameEndEffect(); // 发送游戏结束信号到服务器附带平均心率、温度等数据 sendGameEndData(); // 重置状态 currentCardUID ; gameStartTime 0; lcd.setCursor(0,1); lcd.print(Scan Card Again); } } void triggerGameEndEffect() { // 蜂鸣器长鸣 digitalWrite(BUZZER_PIN, LOW); // LED灯带炫彩效果 for(int i0; istrip.numPixels(); i) { strip.setPixelColor(i, strip.Color(random(150,255), random(150,255), random(150,255))); strip.show(); delay(30); } delay(1000); digitalWrite(BUZZER_PIN, HIGH); // 关闭蜂鸣器 // 灯带呼吸效果渐灭 for(int j255; j0; j--) { for(int i0; istrip.numPixels(); i) { strip.setPixelColor(i, strip.Color(j, j/2, 0)); // 暖黄色渐灭 } strip.show(); delay(10); } }6. 系统集成、调试与问题排查6.1 上电启动与联调步骤当所有硬件连接完毕代码分别烧录到树莓派和ESP32后按照以下顺序启动和调试先启动树莓派上电后等待1-2分钟确保系统完全启动。通过SSH登录检查Flask服务是否正常运行 (sudo systemctl status smart-basketball.service)。用ifconfig命令查看树莓派在热点模式下的IP地址通常是192.168.4.1。再启动ESP32给ESP32上电。观察串口监视器输出应该能看到连接Wi-Fi热点的过程并最终显示“Connected”。LCD屏上应显示“Scan Card to Start”。功能测试RFID刷卡用卡片靠近读卡器ESP32串口应打印UIDLCD显示玩家标识蜂鸣器短响一声。进球检测用手快速划过篮筐下的红外传感器ESP32串口应打印“Goal posted”及相关HTTP响应。同时树莓派服务器终端应该能看到对应的POST请求日志。网页访问用手机连接树莓派的热点在浏览器输入http://192.168.4.1:5000应该能看到简单的排行榜页面。游戏结束等待2分钟或修改代码缩短测试时间观察LED灯带和蜂鸣器是否按预设效果触发。6.2 常见问题与解决方案速查表在开发和调试过程中我们遇到了不少“坑”以下是典型问题及解决方法问题现象可能原因排查步骤与解决方案ESP32无法连接Wi-Fi1. SSID/密码错误2. 树莓派热点未启动3. ESP32 Wi-Fi模块故障1. 检查代码中的ssid和password。2. 用手机确认热点存在。3. 尝试用ESP32连接其他已知Wi-Fi测试硬件。红外传感器一直触发或无触发1. 光束未对准2. 环境光干扰3. 接线错误OUT脚接错4. 上拉电阻未启用1. 调整发射器和接收器位置确保对准。2. 加装遮光套管或调整传感器灵敏度如果可调。3. 用万用表测量光束未阻断时OUT脚应为高电平3.3V阻断时为低电平0V。4. 代码中确认引脚模式为INPUT_PULLUP。LED灯带部分不亮或颜色错乱1. 电源功率不足2. 数据线接触不良3. 灯珠损坏链式反应4. 数据信号电平问题1.最常见原因测量5V电源电压满载时不应低于4.8V。加大电源或减少同时点亮的灯珠数。2. 检查焊接点或接线端子。3. 从第一个不亮的灯珠前剪断单独测试后半段。4. 在ESP32数据线和灯带DI之间串联一个100-330Ω电阻或使用电平转换模块。RFID读卡无反应1. 卡片类型不支持2. 读卡距离太远3. SPI引脚冲突4. 库不兼容1. 确认使用Mifare Classic卡片。2. 卡片紧贴读卡器天线区域。3. 检查ESP32的HSPI/VSPI默认引脚避免与其他设备冲突。4. 尝试使用不同的MFRC522库版本。树莓派服务器收不到进球请求1. ESP32请求URL错误2. 树莓派防火墙阻止端口3. Flask服务未监听0.0.0.04. 跨域问题CORS1. 在ESP32代码中打印完整的请求URL在电脑浏览器中手动访问测试。2. 树莓派上运行sudo ufw allow 5000开放端口。3. 确保app.run(host0.0.0.0)。4. 已安装flask-cors并初始化CORS(app)。多玩家同时玩数据混乱1. 服务器端未处理并发请求2. RFID识别延迟导致串号1. 如前所述改进服务器端代码使用数据库锁或原子操作。2. 在ESP32端刷卡后设置一个“冷却时间”如3秒在此期间忽略其他卡片防止误读。系统运行一段时间后死机1. 电源过热或功率不足2. 内存泄漏软件问题3. 看门狗未复位1. 触摸电源和主要芯片温度加强散热或更换更大功率电源。2. 检查代码确保HTTPClient等对象及时end()和释放。3. 在ESP32的loop()中避免长时间阻塞或使用yield()、delay()释放控制权。6.3 性能优化与扩展思路这个基础版本已经可以稳定运行。如果你想进一步提升可以考虑通信协议优化将HTTP替换为MQTT。MQTT是轻量级的发布/订阅协议更适合物联网设备。树莓派运行Mosquitto作为MQTT代理ESP32订阅和发布主题。这能显著降低延迟减少网络开销并更容易实现多设备扩展。数据可视化升级使用更强大的Web框架如Vue.js Chart.js替换简单的Flask模板构建一个实时刷新的数据仪表盘显示每位玩家的分数变化曲线、历史战绩对比等。增加传感器与功能声音模块增加MP3解码模块播放自定义的进球音效和倒计时语音。摄像头模块连接树莓派摄像头在进球时抓拍精彩瞬间并保存到游戏记录中。无线投篮手柄用另一个ESP32制作无线手柄上面有按钮可以开始/停止游戏、请求暂停等。结构加固与防水使用防水盒、灌封胶对所有电子部分进行彻底防水处理以便在户外长期使用。这个项目从构思到实现最大的收获不是做出了一个能计分的篮筐而是完整地走通了一个物联网产品的原型开发流程从需求分析、架构设计、硬件选型、电路焊接、代码编写、软硬联调到最后的问题排查。每一个环节都可能会遇到意想不到的问题而解决问题的过程正是能力提升最快的时候。希望这份超详细的“流水账”能给你带来启发祝你也能做出属于自己的智能运动装备。
基于树莓派与ESP32的智能篮球计分系统：物联网项目实战
发布时间：2026/6/2 16:44:09
1. 项目概述与核心思路最近在整理工作室的旧项目时翻出了一个之前和朋友们一起捣鼓的“智能篮球计分系统”。这个项目的初衷很简单我们几个都喜欢在车库门口投投篮但每次计分要么靠脑子记要么用手机App总觉得少了点“仪式感”而且数据也无法和具体的人绑定。于是我们就想能不能自己动手做一个能自动计分、记录玩家数据还有点酷炫灯光反馈的智能篮筐这个项目的核心就是一个典型的物联网IoT应用场景。它需要完成几个关键任务感知检测球是否进筐、识别玩家、处理计算分数、管理游戏时间、联网数据上传、远程访问和反馈屏幕显示、灯光与声音提示。为了实现这些功能我们选择了“树莓派 ESP32”的双核架构。树莓派作为“大脑”负责运行Web服务器、数据库和复杂的业务逻辑ESP32作为“神经末梢”负责实时采集传感器数据。这种主从分工的架构既发挥了树莓派强大的计算和网络能力又利用了ESP32在实时控制和低功耗传感器接口上的优势。整个系统的工作流程可以这样理解玩家先用RFID卡在篮筐底座旁的读卡器上“刷卡签到”系统便知道是谁在玩。投篮时安装在篮筐上的红外对射传感器会检测到篮球穿过篮网触发一次有效得分。ESP32会立刻将这个“进球”信号通过Wi-Fi发送给树莓派。树莓派上的Python程序负责累加该玩家的分数同时管理游戏倒计时。时间结束后树莓派会命令ESP32点亮环绕篮板的LED灯带并响起蜂鸣器宣告游戏结束。玩家和观众可以通过连接树莓派热点的手机网页实时查看得分排行榜和历史记录。这个项目非常适合对嵌入式开发、物联网和Python编程感兴趣的爱好者。它涉及了硬件接线、传感器原理、网络通信HTTP/MQTT、Web开发Flask等多个层面的知识是一个综合性很强的练手项目。接下来我将从设计思路、硬件选型、代码实现到调试心得毫无保留地分享整个构建过程。2. 系统架构设计与硬件选型解析2.1 为什么选择“树莓派 ESP32”双核架构在项目初期我们评估过几种方案。第一种是全部由树莓派完成但树莓派的GPIO口虽然多实时性却不如微控制器且传感器分散布线会很麻烦。第二种是全部由ESP32完成但ESP32运行数据库和复杂的Web服务比较吃力且需要外接显示屏等外设接口可能不够用。最终选择双核架构是基于清晰的职责分离考量树莓派主控中心角色系统服务器与数据中枢。优势运行完整的Linux系统轻松部署Python环境、Flask Web框架和SQLite数据库。它提供了稳定的Wi-Fi热点并处理所有HTTP请求如接收得分、提供网页数据。承担任务用户身份管理、游戏逻辑计时、计分、数据持久化、提供Web管理界面。ESP32传感与控制节点角色前端数据采集与终端执行器驱动。优势具有丰富的数字/模拟IO和硬件中断功能对传感器信号的响应速度极快微秒级。集成了Wi-Fi和蓝牙便于与树莓派通信。功耗相对较低。承担任务实时读取红外传感器、RFID读卡器、心率传感器的信号根据树莓派的指令控制LED灯带和蜂鸣器。两者之间通过局域网的Wi-Fi进行通信我们选择了HTTP POST/GET这种简单直接的协议。树莓派作为服务器开放API接口ESP32作为客户端上报数据和接收指令。这种架构扩展性很好未来如果想增加更多篮筐或传感器节点只需配置新的ESP32即可。2.2 核心硬件组件清单与功能说明以下是项目中用到的所有关键硬件及其作用我会解释为什么选它以及关键的连接注意事项。组件型号/说明在项目中的角色选型理由与注意事项主控制器1树莓派 4B (2GB/4GB)系统大脑运行Web服务与数据库性能足够社区支持强大GPIO和USB口丰富。注意务必配备优质5V/3A电源供电不稳是许多奇怪问题的根源。主控制器2ESP32开发板 (如ESP32 DevKitC)传感器数据采集与灯光/声音控制双核处理器Wi-Fi性能好支持硬件中断价格低廉。身份识别RFID读卡器模块 (RC522)读取玩家RFID卡/标签的UID性价比高SPI接口通信稳定。注意需要3.3V供电与ESP32电平匹配。进球检测红外对射传感器 (槽型光电开关)检测篮球是否穿过篮网非接触式响应速度快。关键必须选用对射式发射与接收分离而非反射式。我们将其安装在篮筐内侧篮球落下时会瞬间阻断光束。生理监测脉搏/心率传感器 (KY-039)可选监测玩家运动心率模拟输出通过ADC读取。用于增加数据维度评估运动强度。环境感知温度传感器 (DS18B20)监测设备工作环境温度单总线协议仅需一根数据线多个传感器可并联。防止设备过热。视觉反馈WS2812B RGB LED灯带 (60珠/米)游戏结束时提供炫彩灯光效果单线串行控制一颗IC控制一颗灯珠颜色编程灵活。注意功率较大需外接5V电源数据线接ESP32 GPIO。听觉反馈有源蜂鸣器游戏开始、结束、进球提示音驱动简单低电平触发。区别于无源蜂鸣器需要频率驱动。信息显示16x2 LCD字符液晶屏 (I2C接口)显示树莓派IP地址、简易状态I2C接口仅需2根数据线节省GPIO。方便玩家连接Wi-Fi。供电系统5V/10A开关电源、降压模块为树莓派、ESP32、灯带等供电灯带全亮时电流巨大必须计算总功耗并留有余量。使用降压模块如LM2596为ESP32等提供3.3V。注意电源设计是硬件项目的“生死线”。我们的系统功耗大致如下树莓派约3AESP32约0.5ALED灯带全白最亮时可达6A以上。因此我们选用了一个5V/10A的工业开关电源作为总电源。树莓派直接由其供电同时电源输出接一个大功率的DC-DC降压模块将电压降至5V和3.3V分别给灯带和ESP32等模块供电。绝对禁止从树莓派的GPIO口取电驱动灯带或电机等大电流设备这极易烧毁树莓派。2.3 机械结构与外壳设计要点原项目的木制盒子方案很有创意但考虑到防水和耐用性我们使用了3D打印和亚克力板结合的方式。控制盒我们设计了一个3D打印的壳体内部有卡槽固定树莓派和ESP32开发板。前面板开孔固定LCD屏、RFID读卡器、蜂鸣器和温度传感器探头。盒子侧面装有船型开关和电源接口。所有连接处使用了**电子硅胶RTV硅橡胶**进行密封和固定这种胶弹性好耐高低温且绝缘非常适合原型制作。篮筐传感器安装这是最具挑战的部分。红外对射传感器的发射器和接收器需要精确地面对面安装在篮筐内侧边缘确保篮球无论从哪个方向入网都会阻断光束。我们使用了小型支架和扎带进行固定并用热熔胶和硅胶做了防水和缓冲处理。传感器线缆沿着篮球架支柱向下用缠绕管收纳最终接入控制盒。LED灯带安装将WS2812B灯带环绕粘贴在篮板背面。切记在灯带和篮板之间贴一层白色反光胶带或使用乳白色漫射罩这样光线会更均匀柔和不会刺眼。灯带的电源线5V和GND需要足够粗建议18AWG以上以减少压降。3. 核心电路连接与传感器调试3.1 ESP32与传感器的接线详解ESP32负责连接所有前端传感器和执行器。接线时务必先断开电源遵循“先信号后电源”的原则。ESP32 GPIO引脚连接组件说明注意事项GPIO 23 (MOSI)RC522 (SI/MOSI)SPI主出从入SPI通信引脚也可用其他SPI接口引脚。GPIO 19 (MISO)RC522 (SO/MISO)SPI主入从出GPIO 18 (SCK)RC522 (SCK)SPI时钟GPIO 5RC522 (SDA/SS)SPI片选每个SPI设备需独占一个片选引脚。GPIO 4红外传感器 (OUT)数字输入配置为INPUT_PULLUP使用中断触发。GPIO 32心率传感器 (AO)模拟输入连接ESP32的ADC1通道GPIO 32-39。GPIO 21 (SDA)LCD屏 (I2C SDA)I2C数据I2C通信需接上拉电阻通常模块已集成。GPIO 22 (SCL)LCD屏 (I2C SCL)I2C时钟GPIO 2WS2812B灯带 (DI)数据输入驱动灯带注意电平匹配5V灯带接3.3V数据线一般也可行。GPIO 15有源蜂鸣器 (I/O)数字输出低电平触发串联一个220Ω电阻保护IO口。GPIO 17DS18B20 (DQ)单总线数据需要接一个4.7kΩ上拉电阻到3.3V。3.3V所有模块的VCC电源正极确保所有模块均为3.3V逻辑电平。GND所有模块的GND电源地线共地至关重要所有GND必须连接在一起。实操心得GPIO分配策略。ESP32的GPIO并非全部平等。有些引脚在启动时有特殊状态如GPIO 12会影响启动模式有些只支持输入。我们的策略是通信协议SPI, I2C使用其默认或灵活引脚中断传感器使用支持中断的通用引脚输出设备灯带、蜂鸣器使用任意输出引脚。务必在代码初始化前查阅你所使用的ESP32开发板的引脚定义图。3.2 传感器单独测试与代码验证在组装整个系统前务必对每个传感器进行单独测试。这能帮你快速定位是硬件问题还是软件问题。红外传感器测试# 这是一个简单的Arduino IDE环境下的测试代码ESP32 const int beamPin 4; // 连接传感器OUT脚 void setup() { Serial.begin(115200); pinMode(beamPin, INPUT_PULLUP); // 启用内部上拉常态为高电平 } void loop() { int beamState digitalRead(beamPin); if (beamState LOW) { // 光束被阻断输出低电平 Serial.println(Goal Detected!); delay(500); // 防抖延时 } delay(10); }用手在传感器间划过串口监视器应打印“Goal Detected!”。调试重点确认传感器供电正常LED灯亮发射器和接收器对准以及信号线连接正确。有时环境光过强会干扰可以加上遮光罩。RFID读卡器测试 使用常用的MFRC522库。测试时将卡靠近读卡器串口应能打印出卡的UID如0xDE 0xAD 0xBE 0xEF。注意读卡距离通常在5cm以内且卡片类型需兼容Mifare Classic 1K。WS2812B灯带测试 使用Adafruit_NeoPixel库。先只接几颗灯珠测试避免短路烧毁全部。测试代码让灯珠依次显示红、绿、蓝色。常见问题数据线接错、电源功率不足导致颜色异常或闪烁。心率传感器测试 KY-039输出的是模拟量数值会随心跳波动。将手指稳定按在传感器上通过串口绘图器观察波形应能看到规律的脉冲峰。注意这个传感器精度一般且对按压力度和位置敏感适合做定性而非定量分析。4. 软件系统构建树莓派服务端4.1 环境配置与Web服务搭建树莓派上我们运行的是Raspberry Pi OS Lite无桌面版通过SSH进行远程操作。# 1. 更新系统并安装必要软件 sudo apt update sudo apt upgrade -y sudo apt install python3-pip python3-venv git -y # 2. 创建项目目录并设置虚拟环境 mkdir ~/smart_basketball cd ~/smart_basketball python3 -m venv venv source venv/bin/activate # 3. 安装Python依赖库 pip install flask flask-sqlalchemy flask-cors requests # Flask: Web框架 # Flask-SQLAlchemy: 数据库ORM # Flask-CORS: 处理跨域请求方便网页调试 # requests: 用于将来可能的扩展如调用外部API4.2 数据库设计与Flask API开发我们使用SQLite数据库轻便且无需额外服务。核心数据表有两个Player玩家和GameRecord游戏记录。# app.py 核心代码结构 from flask import Flask, request, jsonify, render_template from flask_sqlalchemy import SQLAlchemy from datetime import datetime app Flask(__name__) app.config[SQLALCHEMY_DATABASE_URI] sqlite:///scores.db app.config[SQLALCHEMY_TRACK_MODIFICATIONS] False db SQLAlchemy(app) # 定义数据模型 class Player(db.Model): id db.Column(db.Integer, primary_keyTrue) card_uid db.Column(db.String(20), uniqueTrue, nullableFalse) # RFID卡UID name db.Column(db.String(80), nullableFalse) created_at db.Column(db.DateTime, defaultdatetime.utcnow) records db.relationship(GameRecord, backrefplayer, lazyTrue) class GameRecord(db.Model): id db.Column(db.Integer, primary_keyTrue) player_id db.Column(db.Integer, db.ForeignKey(player.id), nullableFalse) score db.Column(db.Integer, default0) game_duration db.Column(db.Integer) # 游戏时长单位秒 heart_rate_avg db.Column(db.Float) # 平均心率 temperature db.Column(db.Float) # 环境温度 played_at db.Column(db.DateTime, defaultdatetime.utcnow) # 创建数据库表首次运行 with app.app_context(): db.create_all() # 核心API端点 app.route(/api/goal, methods[POST]) def add_goal(): ESP32上报进球 data request.json card_uid data.get(card_uid) # 1. 根据card_uid找到或创建玩家 player Player.query.filter_by(card_uidcard_uid).first() if not player: player Player(card_uidcard_uid, namefPlayer_{card_uid[-4:]}) db.session.add(player) db.session.commit() # 2. 找到该玩家今天未结束的游戏记录或创建新的 today datetime.utcnow().date() record GameRecord.query.filter( GameRecord.player_id player.id, db.func.date(GameRecord.played_at) today, GameRecord.game_duration.is_(None) # 未结束的游戏 ).first() if not record: record GameRecord(player_idplayer.id, score0) db.session.add(record) # 3. 分数加一 record.score 1 db.session.commit() return jsonify({success: True, player_name: player.name, current_score: record.score}) app.route(/api/game_end, methods[POST]) def end_game(): 游戏结束更新记录 data request.json card_uid data.get(card_uid) duration data.get(duration) avg_hr data.get(avg_heart_rate) temp data.get(temperature) # ... 逻辑类似找到对应记录并更新时长、心率、温度字段 return jsonify({success: True}) app.route(/api/leaderboard, methods[GET]) def get_leaderboard(): 获取今日排行榜 today datetime.utcnow().date() records db.session.query(Player.name, GameRecord.score).\ join(GameRecord).\ filter(db.func.date(GameRecord.played_at) today).\ order_by(GameRecord.score.desc()).limit(10).all() return jsonify([{name: r[0], score: r[1]} for r in records]) app.route(/) def index(): 提供简单的网页查看排行榜 return render_template(index.html) # 需要创建简单的HTML页面 if __name__ __main__: # 获取本机IP方便ESP32和手机连接 import socket hostname socket.gethostname() local_ip socket.gethostbyname(hostname) print(fServer starting on http://{local_ip}:5000) app.run(host0.0.0.0, port5000, debugTrue)注意事项并发与数据一致性。这个简易Flask服务器使用默认的单线程开发服务器不适合高并发。在实际使用中如果多人快速连续投篮/api/goal接口可能会因数据库会话冲突而出错。生产环境建议1) 使用gunicorn或uWSGI部署Flask2) 对/api/goal接口的数据库操作加锁或使用更原子的SQL语句如UPDATE ... SET score score 13) 或者让ESP32本地缓存进球数每隔几秒批量上报一次减少请求频率。4.3 树莓派网络配置与开机自启为了让手机能方便地连接我们将树莓派设置为Wi-Fi热点并让Flask服务开机自启。配置树莓派为热点使用hostapd和dnsmasqsudo apt install hostapd dnsmasq -y sudo systemctl stop hostapd dnsmasq # 配置静态IP和DHCP (编辑 /etc/dhcpcd.conf) # 配置 hostapd (编辑 /etc/hostapd/hostapd.conf) # 配置 dnsmasq (编辑 /etc/dnsmasq.conf) # ...具体配置步骤较长网上有大量教程 sudo systemctl unmask hostapd sudo systemctl enable hostapd dnsmasq sudo reboot重启后用手机搜索Wi-Fi应该能看到树莓派的热点如SmartBasketball。设置Flask应用为系统服务 创建服务文件/etc/systemd/system/smart-basketball.service[Unit] DescriptionSmart Basketball Score Server Afternetwork.target [Service] Userpi WorkingDirectory/home/pi/smart_basketball EnvironmentPATH/home/pi/smart_basketball/venv/bin ExecStart/home/pi/smart_basketball/venv/bin/python /home/pi/smart_basketball/app.py Restartalways RestartSec10 [Install] WantedBymulti-user.target然后启用服务sudo systemctl daemon-reload sudo systemctl enable smart-basketball.service sudo systemctl start smart-basketball.service # 查看状态和日志 sudo systemctl status smart-basketball.service sudo journalctl -u smart-basketball.service -f这样树莓派开机后就会自动运行我们的计分服务器。5. 软件系统构建ESP32客户端5.1 Arduino框架下的多任务处理ESP32的代码我们使用Arduino IDE进行开发它封装了FreeRTOS方便我们实现多任务。主要任务包括主循环任务处理通信和逻辑、传感器中断服务响应进球、RFID读取任务、灯光控制任务。// 主要全局变量和定义 #include WiFi.h #include HTTPClient.h #include MFRC522.h #include Wire.h #include LiquidCrystal_I2C.h #include Adafruit_NeoPixel.h #include OneWire.h #include DallasTemperature.h // 网络配置 const char* ssid SmartBasketball; // 树莓派热点名 const char* password yourpassword; const char* serverURL http://192.168.4.1:5000/api/goal; // 树莓派热点网关通常是.1 // 引脚定义 #define SS_PIN 5 #define RST_PIN 0 // 可根据需要连接 #define BEAM_PIN 4 #define HEART_RATE_PIN 32 #define LED_PIN 2 #define BUZZER_PIN 15 #define ONE_WIRE_BUS 17 // 对象初始化 MFRC522 rfid(SS_PIN, RST_PIN); LiquidCrystal_I2C lcd(0x27, 16, 2); // I2C地址可能是0x3F需扫描确认 Adafruit_NeoPixel strip Adafruit_NeoPixel(60, LED_PIN, NEO_GRB NEO_KHZ800); OneWire oneWire(ONE_WIRE_BUS); DallasTemperature tempSensor(oneWire); // 全局状态变量 volatile bool goalDetected false; // 中断中修改用volatile String currentCardUID ; unsigned long gameStartTime 0; const long GAME_DURATION 120000; // 游戏时长2分钟单位毫秒 // 中断服务函数必须简单快速 void IRAM_ATTR onGoal() { goalDetected true; } void setup() { Serial.begin(115200); // 初始化各模块 SPI.begin(); rfid.PCD_Init(); lcd.init(); lcd.backlight(); strip.begin(); strip.show(); // 初始化灯带全灭 tempSensor.begin(); pinMode(BUZZER_PIN, OUTPUT); digitalWrite(BUZZER_PIN, HIGH); // 有源蜂鸣器高电平关闭 // 配置红外传感器中断下降沿触发从HIGH到LOW pinMode(BEAM_PIN, INPUT_PULLUP); attachInterrupt(digitalPinToInterrupt(BEAM_PIN), onGoal, FALLING); // 连接Wi-Fi WiFi.begin(ssid, password); lcd.print(Connecting...); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } lcd.clear(); lcd.print(Connected!); lcd.setCursor(0,1); lcd.print(WiFi.localIP()); // 显示ESP32的IP非必须 delay(2000); lcd.clear(); lcd.print(Scan Card to Start); // 初始化游戏状态 gameStartTime 0; } void loop() { // 任务1: 处理RFID刷卡 handleRFID(); // 任务2: 处理进球检测 if (goalDetected) { goalDetected false; // 清除标志 handleGoalScored(); } // 任务3: 检查游戏是否超时 checkGameTimeout(); // 任务4: 可选读取并发送心率、温度数据 // 可以放在定时器中避免阻塞主循环 delay(10); // 短暂延时释放CPU控制权 }5.2 关键功能函数实现处理RFID刷卡void handleRFID() { // 检查是否有新卡片 if (!rfid.PICC_IsNewCardPresent() || !rfid.PICC_ReadCardSerial()) { return; } // 读取卡片的UID并转换为16进制字符串 String uidString ; for (byte i 0; i rfid.uid.size; i) { uidString String(rfid.uid.uidByte[i], HEX); } uidString.toUpperCase(); Serial.print(Card UID: ); Serial.println(uidString); currentCardUID uidString; lcd.clear(); lcd.print(Player: ); lcd.print(uidString.substring(0, 4)); // 显示后4位 lcd.setCursor(0,1); lcd.print(Game Start!); // 蜂鸣器提示 digitalWrite(BUZZER_PIN, LOW); delay(100); digitalWrite(BUZZER_PIN, HIGH); // 记录游戏开始时间 gameStartTime millis(); // 停止读卡避免重复读取 rfid.PICC_HaltA(); rfid.PCD_StopCrypto1(); }处理进球并上报服务器void handleGoalScored() { if (currentCardUID || gameStartTime 0) { // 未刷卡或游戏未开始进球无效 Serial.println(Goal ignored. No active player.); return; } // 本地蜂鸣器短促提示 digitalWrite(BUZZER_PIN, LOW); delay(50); digitalWrite(BUZZER_PIN, HIGH); // 准备JSON数据 String jsonPayload {\card_uid\:\ currentCardUID \}; // 发送HTTP POST请求到树莓派 if (WiFi.status() WL_CONNECTED) { HTTPClient http; http.begin(serverURL); http.addHeader(Content-Type, application/json); int httpResponseCode http.POST(jsonPayload); if (httpResponseCode 0) { String response http.getString(); Serial.println(Goal posted. Response: response); // 可以解析响应在LCD上显示当前分数 } else { Serial.print(Error on sending POST: ); Serial.println(httpResponseCode); // 网络错误处理可以本地缓存进球稍后重试 } http.end(); } else { Serial.println(WiFi Disconnected); } }游戏超时与灯光效果void checkGameTimeout() { if (gameStartTime 0) return; // 游戏未开始 unsigned long currentTime millis(); if (currentTime - gameStartTime GAME_DURATION) { // 游戏结束 lcd.clear(); lcd.print(Times Up!); triggerGameEndEffect(); // 发送游戏结束信号到服务器附带平均心率、温度等数据 sendGameEndData(); // 重置状态 currentCardUID ; gameStartTime 0; lcd.setCursor(0,1); lcd.print(Scan Card Again); } } void triggerGameEndEffect() { // 蜂鸣器长鸣 digitalWrite(BUZZER_PIN, LOW); // LED灯带炫彩效果 for(int i0; istrip.numPixels(); i) { strip.setPixelColor(i, strip.Color(random(150,255), random(150,255), random(150,255))); strip.show(); delay(30); } delay(1000); digitalWrite(BUZZER_PIN, HIGH); // 关闭蜂鸣器 // 灯带呼吸效果渐灭 for(int j255; j0; j--) { for(int i0; istrip.numPixels(); i) { strip.setPixelColor(i, strip.Color(j, j/2, 0)); // 暖黄色渐灭 } strip.show(); delay(10); } }6. 系统集成、调试与问题排查6.1 上电启动与联调步骤当所有硬件连接完毕代码分别烧录到树莓派和ESP32后按照以下顺序启动和调试先启动树莓派上电后等待1-2分钟确保系统完全启动。通过SSH登录检查Flask服务是否正常运行 (sudo systemctl status smart-basketball.service)。用ifconfig命令查看树莓派在热点模式下的IP地址通常是192.168.4.1。再启动ESP32给ESP32上电。观察串口监视器输出应该能看到连接Wi-Fi热点的过程并最终显示“Connected”。LCD屏上应显示“Scan Card to Start”。功能测试RFID刷卡用卡片靠近读卡器ESP32串口应打印UIDLCD显示玩家标识蜂鸣器短响一声。进球检测用手快速划过篮筐下的红外传感器ESP32串口应打印“Goal posted”及相关HTTP响应。同时树莓派服务器终端应该能看到对应的POST请求日志。网页访问用手机连接树莓派的热点在浏览器输入http://192.168.4.1:5000应该能看到简单的排行榜页面。游戏结束等待2分钟或修改代码缩短测试时间观察LED灯带和蜂鸣器是否按预设效果触发。6.2 常见问题与解决方案速查表在开发和调试过程中我们遇到了不少“坑”以下是典型问题及解决方法问题现象可能原因排查步骤与解决方案ESP32无法连接Wi-Fi1. SSID/密码错误2. 树莓派热点未启动3. ESP32 Wi-Fi模块故障1. 检查代码中的ssid和password。2. 用手机确认热点存在。3. 尝试用ESP32连接其他已知Wi-Fi测试硬件。红外传感器一直触发或无触发1. 光束未对准2. 环境光干扰3. 接线错误OUT脚接错4. 上拉电阻未启用1. 调整发射器和接收器位置确保对准。2. 加装遮光套管或调整传感器灵敏度如果可调。3. 用万用表测量光束未阻断时OUT脚应为高电平3.3V阻断时为低电平0V。4. 代码中确认引脚模式为INPUT_PULLUP。LED灯带部分不亮或颜色错乱1. 电源功率不足2. 数据线接触不良3. 灯珠损坏链式反应4. 数据信号电平问题1.最常见原因测量5V电源电压满载时不应低于4.8V。加大电源或减少同时点亮的灯珠数。2. 检查焊接点或接线端子。3. 从第一个不亮的灯珠前剪断单独测试后半段。4. 在ESP32数据线和灯带DI之间串联一个100-330Ω电阻或使用电平转换模块。RFID读卡无反应1. 卡片类型不支持2. 读卡距离太远3. SPI引脚冲突4. 库不兼容1. 确认使用Mifare Classic卡片。2. 卡片紧贴读卡器天线区域。3. 检查ESP32的HSPI/VSPI默认引脚避免与其他设备冲突。4. 尝试使用不同的MFRC522库版本。树莓派服务器收不到进球请求1. ESP32请求URL错误2. 树莓派防火墙阻止端口3. Flask服务未监听0.0.0.04. 跨域问题CORS1. 在ESP32代码中打印完整的请求URL在电脑浏览器中手动访问测试。2. 树莓派上运行sudo ufw allow 5000开放端口。3. 确保app.run(host0.0.0.0)。4. 已安装flask-cors并初始化CORS(app)。多玩家同时玩数据混乱1. 服务器端未处理并发请求2. RFID识别延迟导致串号1. 如前所述改进服务器端代码使用数据库锁或原子操作。2. 在ESP32端刷卡后设置一个“冷却时间”如3秒在此期间忽略其他卡片防止误读。系统运行一段时间后死机1. 电源过热或功率不足2. 内存泄漏软件问题3. 看门狗未复位1. 触摸电源和主要芯片温度加强散热或更换更大功率电源。2. 检查代码确保HTTPClient等对象及时end()和释放。3. 在ESP32的loop()中避免长时间阻塞或使用yield()、delay()释放控制权。6.3 性能优化与扩展思路这个基础版本已经可以稳定运行。如果你想进一步提升可以考虑通信协议优化将HTTP替换为MQTT。MQTT是轻量级的发布/订阅协议更适合物联网设备。树莓派运行Mosquitto作为MQTT代理ESP32订阅和发布主题。这能显著降低延迟减少网络开销并更容易实现多设备扩展。数据可视化升级使用更强大的Web框架如Vue.js Chart.js替换简单的Flask模板构建一个实时刷新的数据仪表盘显示每位玩家的分数变化曲线、历史战绩对比等。增加传感器与功能声音模块增加MP3解码模块播放自定义的进球音效和倒计时语音。摄像头模块连接树莓派摄像头在进球时抓拍精彩瞬间并保存到游戏记录中。无线投篮手柄用另一个ESP32制作无线手柄上面有按钮可以开始/停止游戏、请求暂停等。结构加固与防水使用防水盒、灌封胶对所有电子部分进行彻底防水处理以便在户外长期使用。这个项目从构思到实现最大的收获不是做出了一个能计分的篮筐而是完整地走通了一个物联网产品的原型开发流程从需求分析、架构设计、硬件选型、电路焊接、代码编写、软硬联调到最后的问题排查。每一个环节都可能会遇到意想不到的问题而解决问题的过程正是能力提升最快的时候。希望这份超详细的“流水账”能给你带来启发祝你也能做出属于自己的智能运动装备。
