基于ESP32宾馆房间内自动售货机

第1章 系统的总体架构本系统采用客户端-服务器-设备端三层架构各层之间通过WebSocket协议进行实时双向通信确保指令的低延迟传输。采用B/SBrowser/Server架构与物联网技术相结合的设计方案。软件系统主要由四部分组成基于ESP32的下位机控制程序、基于Node.js的WebSocket公网中继服务、基于Python Flask的业务逻辑与支付监控后台、以及基于HTML5/Bootstrap的用户交互前端。1.1 设备层 (ESP32)负责硬件控制包括连接本地Wi-Fi通过WebSocket连接至公网中继服务器并接收来自云端的开锁指令以驱动相应电磁锁。1.2 服务层 (云服务器)1.2.1 Web前端提供商品展示与选择的用户界面负责发起支付订单。1.2.2 后端服务 (Flask)生成支付订单链接并启动图像识别线程监控支付结果。1.2.3 消息中继服务器 (Node.js)作为系统的“消息总线”负责转发后端服务向ESP32发送的出货指令。1.3 支付层使用第三方支付平台易支付通过图像识别技术自动化确认支付状态。第2章 嵌入式终端控制程序设计ESP322.1 主控单元选用ESP32-WROOM-32模组作为核心控制器。其集成Wi-Fi功能功耗低性能足以处理网络通信与GPIO控制任务。下位机主要负责网络连接维护、指令解析及电磁锁驱动。代码基于Arduino框架开发利用WiFi.h库处理网络连接WebSocketsClient库实现长连接ArduinoJson库进行数据解析。2.2 开锁原理系统通过电磁锁控制货道门。在代码中定义了锁控引脚数组 lockPins[] {2, 4, 5, 18, 19}对应五个商品货道。控制逻辑简洁高效void unlockProduct(int productId) {int pin lockPins[productId - 1]; // 映射商品ID到物理引脚digitalWrite(pin, HIGH); // 激活电磁锁假设高电平触发delay(unlockDelay); // 保持激活状态3秒确保商品掉落digitalWrite(pin, LOW); // 关闭电磁锁}此设计通过商品ID与GPIO引脚的映射关系实现了软件对硬件的灵活配置。2.3 网络连接与自动重连机制为了保证无人售货机在无人值守环境下的高可用性程序中设计了双重守护机制WiFi守护在主循环loop()中调用reconnectWiFi()函数实时检测WiFi.status()。一旦检测到连接断开立即挂起当前任务并尝试重新连接指定SSID直至连接恢复。WebSocket心跳保活通过webSocket.enableHeartbeat(3000, 2000, 1)配置心跳包每3秒向服务器发送Ping帧。若2秒内未收到Pong响应或连接意外断开WStype_DISCONNECTED将触发自动重连逻辑重连间隔被优化为2秒以减少掉线时间。2.4 指令解析与硬件驱动当收到服务器推送的文本消息WStype_TEXT时系统调用parseLockMessage函数反序列化将JSON字符串解析为对象。安全校验首先校验type字段是否为release_product防止误操作。执行动作提取product_id经有效性校验1至numLocks后通过unlockProduct函数驱动对应GPIO。电磁锁控制采用非阻塞延时或同步延时逻辑将对应引脚拉高ACTIVE_LEVEL持续3000msunlockDelay后拉低完成开锁动作。第3章 公网通信与指令中继NodeJS由于ESP32通常部署在NAT网络下无法直接被公网访问因此在云服务器IP: 149.104.21.241搭建Node.js WebSocket中继服务端口8080。该服务充当“消息路由”的角色核心逻辑如下3.1 链路映射维护backendClient和esp32Client两个全局对象分别存储后台与设备的连接句柄。ESP32连接后发送 register:esp32后端服务发送 register:backend。中继服务器据此区分客户端身份并维护两个独立的WebSocket连接句柄。3.2 定向转发当收到来自backendClient的消息时服务判断ESP32是否在线。若在线且消息类型为release_product则将指令原样转发给esp32Client。3.3 异常处理监听close和error事件在任意一端断开时及时清空对应的连接句柄及时释放资源并在控制台打印日志避免内存泄漏和误发指令。第4章 前端在线网页前端采用HTML5结合Bootstrap 5框架实现了响应式布局更适配手机的布局页面4.1 动态交互商品列表通过Card组件展示点击商品自动高亮并更新底部支付栏状态。JS脚本实时维护selectedProduct对象记录用户选择的ID、名称和价格。4.2 双向通信4.2.1 HTTP请求点击“立即支付”后通过fetch API向后端发送POST请求携带productValueID编号与productPrice商品价格。4.2.2 WebSocket监听页面加载时初始化Socket.IO连接监听payment_success事件。一旦收到后端通知页面即时弹出“支付成功”提示并自动更新UI状态极大地提升了用户体验。第5章 订单生成与支付监控系统后端后台核心业务运行在Python Flask框架上采用了RPA机器人流程自动化技术解决第三方支付接口的对接难题。5.1 自动化订单生成5.1.1 图像识别定位利用locateOnScreen函数基于预存的UI截图如pic1.png~pic5.png定位支付软件窗口坐标。5.1.2 参数输入自动获取并输入前端传递的商品价格productPrice实现了价格与货道的解耦。5.1.3 支付平台链接转发生成订单并自动转发链接最终将支付URL返回给前端。 为防止并发冲突该过程由threading.Lock()互斥锁保护确保同一时间只能处理一个订单请求。5.2 异步支付状态监测为了不阻塞API响应支付检测在独立线程中运行check_payment_async5.2.1 视觉轮询由于常规的api获取订单是否完成支付存在安全漏洞采用api加视觉双重认证的方式确保订单是通过正常手段完成的支付而非利用漏洞绕过支付后端持续识屏幕并匹配“支付成功”图标paid_success。5.2.2 超时控制设置50秒超时阈值避免长时间占用订单消耗资源若在规定时间内检测到支付成功则调用notify_esp32_via_relay函数进行中继发送。5.2.3 指令下发该函数建立与8080端口的中继连接发送包含product_id的出货指令完成“支付-出货”闭环。一旦检测到支付成功后端通过WebSocket向公网中继服务器发送一个标准化的JSON指令{type: release_product,product_id: 1, 订单编号order_url: http://... 生成的订单链接}第6章 通信协议与消息流为了实现云端服务器与内网设备ESP32及前端页面的实时交互系统定义了一套基于WebSocket的通信协议。采用JSON格式在服务层与中继之间传递结构化数据而在中继与ESP32之间则传递纯文本或JSON指令确保了协议的灵活性与可扩展性。6.1 注册机制客户端连接中继服务器后需立即发送身份标识。中继服务器据此区分客户端身份并维护两个独立的WebSocket连接句柄。6.2 消息路由只将来自 backendClient 且类型为 release_product 的指令转发给 esp32Client起到了消息过滤和路由的安全作用。6.3 指令格式控制指令采用JSON格式传输确保数据结构清晰且易于扩展。{type: release_product,product_id: 1,order_url: http://...}实际操作1.使用ESP32-s3作为主控芯片2.因电磁锁解锁电压最低一档为5V而ESP32只能输出3.3V采用TB6612做继电器使用因为有四个电磁锁对应TB6612的AIN1AIN2BIN1BIN23.使用ESP32连接WIFI名称为宾馆密码为12345678的WiFi发布一个网页同时从外网拉取商品图片和支付宝二维码4.采用CDN直链获取图片因不便于调用wechat和支付宝API采用更简单的二维码支付即通过支付宝收钱功能给每个价格都截图标号程序中用算法实现精准调用截图5.附件前端代码.html附件后端代码.py附件云服务器中继代码.js附件ESP32代码.cpp需要完整代码联系hjz0060810