简介这是一套基于语音控制的智能家居系统项目资料包面向嵌入式开发、物联网及Android应用方向的初学者或毕设学生目标是帮助理解并复现通过语音指令控制灯光、空调、窗帘等设备的完整流程。资源共2358个文件压缩包约33.89MB包含大量class、C/H源码文件、Android工程Java代码、XML界面配置、APK安装包及蓝牙通信相关文件覆盖单片机端与移动端两侧的关键实现。已有1778人学习/下载。包内资料围绕STM32等32位单片机、语音识别模块、Android上位机以及蓝牙控制展开可作为毕业设计初版程序、模块联调参考和二次开发底稿从文件结构看既有Android Studio工程、Gradle配置也有Keil/IAR等嵌入式工程文件便于对照研究单片机与App的交互逻辑。 语音控制智能家居这事儿看着玄乎拆开其实就是“耳朵大脑手脚”语音识别模块当耳朵听指令主控芯片当大脑做决策继电器或智能插座当手脚去执行。很多朋友一上来就想搞全套商业方案其实从零搭一套基础可用的系统远比想象中简单而且踩坑过程本身特别长经验。这篇我就把自己实测跑通的方案完整拆开讲从硬件选型、指令链路到排错技巧都交代清楚适合想自己动手的嵌入式爱好者、刚入坑智能家居的DIY玩家照着做基本能复现一套“喊一声就能开关灯和风扇”的家居控制系统。我把这套系统定位成“可基本实现功能”的版本意思是不追求工业级稳定性和花哨的联动场景但核心链路必须完整语音唤醒、指令识别、消息传输、设备执行、状态反馈这五个环节一个都不能少。整套东西做下来你顺手也能把MQTT协议、串口通信、继电器驱动这些嵌入式基本功练得明明白白。1. 整体方案设计与链路拆解1.1 为什么选择“语音模块主控MQTT”的架构市面上的语音控制方案大致有三种路线一是直接用离线语音识别模块比如SU-03T、LD3320本地就能完成唤醒词识别和命令词匹配不依赖网络二是走在线语音平台比如某些大厂的语音API识别率更高但需要联网还会涉及云端配置和鉴权对新手不够友好三是用Home Assistant这类开源平台配合语音助手功能最强但学习曲线陡峭。考虑到“可基本实现功能”这个定位我最终选了离线语音模块ESP32主控MQTT协议下发指令的组合。这套组合的核心优势在“解耦”。语音模块只负责“听懂”ESP32只负责“转发和决策”继电器只负责“执行”。任何一环坏掉了替换成本都极低调试的时候也能单独测每一段链路。如果你以后想升级把离线模块换成在线语音模块其他部分完全不用动。注意离线语音模块识别的命令词是需要预先烧录固件的而且每个模块的训练工具和使用方式都不一样。选型之前一定要确认你想用的那几命令词比如“打开灯”“关闭灯”“打开风扇”在你的模块上能不能顺利训练出来。1.2 数据链路完整流程整套系统跑起来之后数据流向是这样的用户说出唤醒词比如“小智小智”激活模块然后说出命令词比如“打开卧室灯”语音模块通过串口把识别结果发送给ESP32ESP32收到指令后进行关键词解析根据预设的映射关系通过MQTT协议发布消息到指定主题topic局域网内的MQTT Broker我用的是Mosquitto把消息路由给订阅了该主题的设备端ESP32同时作为订阅端收到消息后拉高或拉低GPIO引脚驱动继电器闭合或断开最终完成灯或风扇的开关动作。这条链路里每个环节都有讲究。比如命令词不要设计得太长建议控制在2到4个字太长容易识别失败MQTT主题要按功能划分比如home/bedroom/light/set方便后面扩展联动继电器控制要加延时和防抖逻辑避免上电瞬间误动作。1.3 最小系统清单如果你准备复刻这套方案硬件清单如下都是常见物料总成本控制在一百五十元以内物料型号/规格用途参考价格离线语音识别模块SU-03T或类似语音识别、串口输出30-50元主控板ESP32 DevKitC V4协议转换、指令下发25-35元继电器模块1路或2路5V低电平触发强电开关控制5-15元电源5V/2A USB电源 AMS1117降压供电10元左右烧录工具CH340 USB转TTL给语音模块烧录固件8元其他杜邦线、面包板、接线端子连接10元以内如果你手头已经有STM32F103C8T6这类单片机也可以替代ESP32但需要注意它不自带WiFi需要外接ESP8266模块才能实现MQTT通信链路会复杂一些。所以对新手来说ESP32是首选两颗核心双核240MHz、自带WiFi和蓝牙GPIO也够用省去很多麻烦。2. 关键硬件选型与接线实操2.1 语音识别模块的选型心得语音模块我先后用过LD3320和SU-03T最终推荐SU-03T。LD3320虽然名气大但它需要自己写驱动、做关键词列表管理代码量不小而且识别率受环境噪声影响明显需要调试麦克风阵列对新手不友好。SU-03T是离线方案官方提供一个网页版的配置平台你只需要在网页里选好唤醒词、添加命令词、配置串口波特率和引脚功能一键生成固件然后烧录进去就行整个流程不超过十分钟。这里有一个关键参数要注意SU-03T的UART配置。默认波特率是9600数据格式8N1但你要在配置平台上主动打开“UART外设控制”功能否则模块只通过IO口输出高低电平没法把具体识别到哪个命令词的信息传出去。我一开始就忘了这一步折腾了半天发现串口助手什么都收不到后来回平台重新生成固件才搞定。2.2 ESP32与语音模块的接线关系接线其实非常简单SU-03T的UART_TX接ESP32的UART2_RXGPIO16SU-03T的UART_RX接ESP32的UART2_TXGPIO17两边的GND必须共地否则电平参考不一致通信会乱码。这里要特别提醒ESP32的GPIO输入输出是3.3V电平SU-03T也是3.3V所以可以直接相连。如果你用的是5V的语音模块必须要加电平转换电路不然有烧引脚的风险。继电器模块我选的5V低电平触发就是IN引脚被拉低时继电器吸合悬空或高电平时断开。这种模块的优点是和ESP32连接时更安全因为ESP32上电瞬间GPIO默认是高电平继电器不会误动作。如果是高电平触发模块上电瞬间继电器会咔哒一声吸合然后才断开控制灯还好控制电机类设备会很危险。注意继电器模块和强电设备之间务必做好隔离。我用的模块自带光耦隔离但接线时依然要保证强电部分和弱电部分分开走线继电器输出端接灯或风扇时先断电操作确认无误后再上强电。安全这根弦任何时候都不能松。2.3 供电方案的选择这套系统里有三个需要供电的部件语音模块3.3V或5V、ESP325V USB供电、继电器模块5V。最简单的方式是用一个5V/2A的USB充电头给ESP32供电然后从ESP32的5V引脚取电给继电器模块再从3.3V引脚取电给语音模块。但要注意如果继电器同时吸合多路瞬时电流可能达到几百毫安再加上ESP32自身功耗和语音模块2A的余量是够的但如果你后面扩展到四路以上继电器建议单独用一个5V电源给继电器供电避免电压跌落导致ESP32重启。3. 语音固件配置与ESP32程序实现3.1 语音模块固件配置步骤先去SU-03T的官方配置平台注册并创建产品选择“通用离线识别”方案。然后按照下面几个步骤设置添加唤醒词。建议用两个字或三个字的词比如“小智小智”避免用太常见的口语词当唤醒词否则容易误唤醒。添加命令词。把你需要的指令全部列出来比如“打开灯”“关闭灯”“打开风扇”“关闭风扇”“打开所有”“关闭所有”。命令词之间不要有包含关系比如“打开”和“打开灯”同时存在识别时可能冲突。设置UART外设控制。打开串口发送功能选择“发送命令词”模式波特率选9600。这样模块识别到命令词后会把对应命令词通过串口发出来。生成固件并烧录。用CH340模块连接SU-03T的TX、RX、GND、VCC打开烧录工具选择生成的固件文件点击烧录即可。烧录过程中不要断开连接等提示成功后断电重启。烧录完成后先用串口助手波特率9600直接测试模块对着它说“小智小智”再命令词看能不能收到对应的字符串。这一步先做验证能省后面很多排查时间。3.2 ESP32端程序设计ESP32这边我用的Arduino IDE开发核心逻辑是串口读取语音模块的数据、解析命令词、通过MQTT发布消息、同时订阅MQTT消息控制继电器。下面是一个简化过的代码框架去掉了一些边界处理但核心链路完整#include WiFi.h #include PubSubClient.h const char* ssid 你的WiFi名; const char* password 你的WiFi密码; const char* mqttServer 192.168.1.100; // MQTT Broker地址 const int mqttPort 1883; const char* mqttUser ; const char* mqttPassword ; WiFiClient espClient; PubSubClient client(espClient); const int relayLightPin 26; const int relayFanPin 27; bool lightState false; bool fanState false; void setup() { Serial.begin(9600); // 与语音模块通信 Serial2.begin(9600, SERIAL_8N1, 16, 17); // UART2 接语音模块 pinMode(relayLightPin, OUTPUT); pinMode(relayFanPin, OUTPUT); digitalWrite(relayLightPin, HIGH); // 低电平触发初始断开 digitalWrite(relayFanPin, HIGH); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); } client.setServer(mqttServer, mqttPort); client.setCallback(callback); connectMQTT(); } void loop() { if (!client.connected()) { connectMQTT(); } client.loop(); handleSerialCommand(); } // 串口接收到语音模块的指令后做关键词匹配 void handleSerialCommand() { while (Serial2.available() 0) { String cmd Serial2.readStringUntil(\n); cmd.trim(); if (cmd.indexOf(打开灯) 0) { lightState true; digitalWrite(relayLightPin, LOW); client.publish(home/bedroom/light/state, ON); } else if (cmd.indexOf(关闭灯) 0) { lightState false; digitalWrite(relayLightPin, HIGH); client.publish(home/bedroom/light/state, OFF); } // 风扇、全开全关逻辑类似 } } // MQTT回调手机或面板也能控制 void callback(char* topic, byte* payload, unsigned int length) { String msg; for (int i 0; i length; i) { msg (char)payload[i]; } if (String(topic) home/bedroom/light/set) { if (msg ON) { digitalWrite(relayLightPin, LOW); } else { digitalWrite(relayLightPin, HIGH); } } } void connectMQTT() { while (!client.connected()) { if (client.connect(ESP32Client)) { client.subscribe(home/bedroom/light/set); client.subscribe(home/bedroom/fan/set); } else { delay(2000); } } }实际测试中这套代码跑起来非常稳定。需要注意两个细节串口接收语音模块数据时用readStringUntil(\n)一定要确认语音模块发送的数据是以换行符结尾的SU-03T默认的串口输出格式刚好满足MQTT发布和订阅的主题要分开/set是控制指令/state是状态反馈这样后面接Home Assistant或手机App做状态同步时语义清晰不会混乱。3.3 MQTT Broker的安装与配置MQTT Broker我用的Mosquitto装在一台闲置的树莓派上但你也可以用任何一台常开的电脑、NAS甚至另一块ESP32来跑。安装命令很简单以Ubuntu/Debian为例sudo apt update sudo apt install mosquitto mosquitto-clients sudo systemctl enable mosquitto配置文件/etc/mosquitto/mosquitto.conf里默认监听1883端口本地无需账号密码即可连接。但如果你准备把控制指令暴露到公网比如人在外面想远程控制一定要开启用户名密码认证并配置TLS加密。如果只是局域网内用默认配置就够了。测试Broker是否正常可以用两个终端窗口终端1订阅mosquitto_sub -t home/#终端2发布mosquitto_pub -t home/bedroom/light/set -m ON看到终端1收到消息说明Broker工作正常这时候再跑到ESP32上测试指令下发就顺理成章了。4. 功能验证场景与常见问题排查4.1 完整场景测试流程我搭完这套系统后按照下面几个场景做了验证你也可以照着测测试场景语音指令预期行为实测结果卧室灯开关“小智小智打开灯”卧室灯点亮MQTT状态变为ON通过延迟约1秒风扇控制“小智小智打开风扇”风扇继电器吸合风扇转动通过全开全关“小智小智打开所有”灯和风扇全部打开通过手机远程控制在MQTT面板发布ON/OFF对应设备动作通过WiFi下延迟200ms内延迟方面离线语音识别的响应速度比在线识别快很多基本是“话说出口到继电器动作”在1秒以内体感上非常跟手。如果你觉得响应慢先排查是不是ESP32主循环里client.loop()被串口读取阻塞了可以考虑把继电器操作放到定时器中断里做。4.2 语音识别不灵敏的排查思路语音模块识别不灵敏问题根源通常不在模块本身而是在供电和噪声。先检查语音模块的供电电压是否稳定SU-03T对电源纹波比较敏感如果和继电器共用一个电源继电器吸合瞬间的电压跌落会导致模块重启或者识别率骤降。我的解决办法是给语音模块单独加一颗100uF电解电容和0.1uF陶瓷电容做电源去耦效果立竿见影。另一个常见问题是环境噪声。如果你把麦克风放在空调风口、电视附近这种噪声比较大的地方离线模块的识别率会直线下降。可以尝试调整模块的“灵敏度”和“环境噪声消除”参数但这些参数往往被大家忽略。SU-03T的配置平台里有一个“麦克风灵敏度”选项环境嘈杂时适当调低反而能减少误识别。4.3 MQTT断连与重连策略ESP32运行过程中WiFi断了或者MQTT Broker重启都会导致连接断开。如果不做重连机制系统会一直显示离线语音指令自然也无法下发。我的做法是封装一个connectMQTT()函数在loop()里检查连接状态断开就尝试重连同时加入计数器和延时避免频繁重连把Broker打挂。还有一点ESP32的WiFi连接建议设置为静态IP不然路由器重新分配IP后其他设备就找不到它了。经验给ESP32设置静态IP时记得在路由器后台绑定MAC地址这样即使设备重启IP也是固定的。否则你写死在代码里的服务器地址一旦变了又得重新烧录固件非常麻烦。4.4 继电器误动作的避坑经验低电平触发的继电器在ESP32上电瞬间是安全的但如果你用的是STM32或者某些GPIO默认电平不确定的板子就要小心。另外继电器触点驱动感性负载比如风扇电机时断开瞬间会产生反向电动势可能会干扰主控甚至导致重启。我的处理方式是在继电器输出端并联一个续流二极管1N4007或者使用固态继电器模块后者没有机械触点噪音小、寿命长只是成本稍高。如果继电器吸合时有“咔哒”声但负载没反应先量一下继电器输出端是否有电压再看接线是不是把常开端和公共端接反了。继电器模块一般有NO常开、NC常闭、COM公共端三个接口控制灯或风扇应该接COM和NO而不是COM和NC。这个接反了非常隐蔽因为通电后继电器“看起来”在工作实际上就是不通。4.5 语音模块串口乱码的解决串口乱码十有八九是波特率不匹配。SU-03T默认9600但有些模块出厂设置可能是115200或者你配置固件时选成了其他波特率。还有一个容易忽视的点共地。语音模块和ESP32的GND必须接在一起否则串口电平没有参考点通信数据完全是乱的。这个问题我帮朋友排查过一次他折腾了一天最后发现就是GND没连。5. 系统扩展方向与个人经验总结这套基础版本跑通之后扩展空间非常大。我后续自己加了人体感应模块实现“人走灯灭”又接入了Home Assistant在手机App上能看到每个设备的状态还能设置定时场景。其实你只要搭好“语音识别MQTT继电器控制”这套骨架后面不管是加传感器、加摄像头、加温湿度检测都只是往MQTT协议栈里填新主题而已。最后再分享一个我踩过多次的坑语音命令词的设计一定要避开容易混淆的发音。我之前设过“打开客厅灯”和“打开餐厅灯”识别模块经常把“餐厅”听成“客厅”后来统一改成“灯一”“灯二”识别率立刻上去了。命令词越短、越拗口保留字特征越明显识别越准。这个经验在你写命令词列表的时候最好就考虑进去不然等固件烧好了才发现问题又要重新生成配置麻烦得很。这套系统我用到现在快两个月了稳定性超出预期。虽然比不上商业方案的语音助手智能但胜在链路简单、可控性强所有逻辑都在自己手里想加什么功能随时能改。如果你也一直在犹豫要不要动手搞一套我的建议是别想太多先按这套清单把物料凑齐一个周末就能看到成果。踩坑本身就是最好的学习方式。本文还有配套的精品资源点击获取
从零搭建语音控制智能家居：ESP32+MQTT+离线语音模块实战
简介这是一套基于语音控制的智能家居系统项目资料包面向嵌入式开发、物联网及Android应用方向的初学者或毕设学生目标是帮助理解并复现通过语音指令控制灯光、空调、窗帘等设备的完整流程。资源共2358个文件压缩包约33.89MB包含大量class、C/H源码文件、Android工程Java代码、XML界面配置、APK安装包及蓝牙通信相关文件覆盖单片机端与移动端两侧的关键实现。已有1778人学习/下载。包内资料围绕STM32等32位单片机、语音识别模块、Android上位机以及蓝牙控制展开可作为毕业设计初版程序、模块联调参考和二次开发底稿从文件结构看既有Android Studio工程、Gradle配置也有Keil/IAR等嵌入式工程文件便于对照研究单片机与App的交互逻辑。 语音控制智能家居这事儿看着玄乎拆开其实就是“耳朵大脑手脚”语音识别模块当耳朵听指令主控芯片当大脑做决策继电器或智能插座当手脚去执行。很多朋友一上来就想搞全套商业方案其实从零搭一套基础可用的系统远比想象中简单而且踩坑过程本身特别长经验。这篇我就把自己实测跑通的方案完整拆开讲从硬件选型、指令链路到排错技巧都交代清楚适合想自己动手的嵌入式爱好者、刚入坑智能家居的DIY玩家照着做基本能复现一套“喊一声就能开关灯和风扇”的家居控制系统。我把这套系统定位成“可基本实现功能”的版本意思是不追求工业级稳定性和花哨的联动场景但核心链路必须完整语音唤醒、指令识别、消息传输、设备执行、状态反馈这五个环节一个都不能少。整套东西做下来你顺手也能把MQTT协议、串口通信、继电器驱动这些嵌入式基本功练得明明白白。1. 整体方案设计与链路拆解1.1 为什么选择“语音模块主控MQTT”的架构市面上的语音控制方案大致有三种路线一是直接用离线语音识别模块比如SU-03T、LD3320本地就能完成唤醒词识别和命令词匹配不依赖网络二是走在线语音平台比如某些大厂的语音API识别率更高但需要联网还会涉及云端配置和鉴权对新手不够友好三是用Home Assistant这类开源平台配合语音助手功能最强但学习曲线陡峭。考虑到“可基本实现功能”这个定位我最终选了离线语音模块ESP32主控MQTT协议下发指令的组合。这套组合的核心优势在“解耦”。语音模块只负责“听懂”ESP32只负责“转发和决策”继电器只负责“执行”。任何一环坏掉了替换成本都极低调试的时候也能单独测每一段链路。如果你以后想升级把离线模块换成在线语音模块其他部分完全不用动。注意离线语音模块识别的命令词是需要预先烧录固件的而且每个模块的训练工具和使用方式都不一样。选型之前一定要确认你想用的那几命令词比如“打开灯”“关闭灯”“打开风扇”在你的模块上能不能顺利训练出来。1.2 数据链路完整流程整套系统跑起来之后数据流向是这样的用户说出唤醒词比如“小智小智”激活模块然后说出命令词比如“打开卧室灯”语音模块通过串口把识别结果发送给ESP32ESP32收到指令后进行关键词解析根据预设的映射关系通过MQTT协议发布消息到指定主题topic局域网内的MQTT Broker我用的是Mosquitto把消息路由给订阅了该主题的设备端ESP32同时作为订阅端收到消息后拉高或拉低GPIO引脚驱动继电器闭合或断开最终完成灯或风扇的开关动作。这条链路里每个环节都有讲究。比如命令词不要设计得太长建议控制在2到4个字太长容易识别失败MQTT主题要按功能划分比如home/bedroom/light/set方便后面扩展联动继电器控制要加延时和防抖逻辑避免上电瞬间误动作。1.3 最小系统清单如果你准备复刻这套方案硬件清单如下都是常见物料总成本控制在一百五十元以内物料型号/规格用途参考价格离线语音识别模块SU-03T或类似语音识别、串口输出30-50元主控板ESP32 DevKitC V4协议转换、指令下发25-35元继电器模块1路或2路5V低电平触发强电开关控制5-15元电源5V/2A USB电源 AMS1117降压供电10元左右烧录工具CH340 USB转TTL给语音模块烧录固件8元其他杜邦线、面包板、接线端子连接10元以内如果你手头已经有STM32F103C8T6这类单片机也可以替代ESP32但需要注意它不自带WiFi需要外接ESP8266模块才能实现MQTT通信链路会复杂一些。所以对新手来说ESP32是首选两颗核心双核240MHz、自带WiFi和蓝牙GPIO也够用省去很多麻烦。2. 关键硬件选型与接线实操2.1 语音识别模块的选型心得语音模块我先后用过LD3320和SU-03T最终推荐SU-03T。LD3320虽然名气大但它需要自己写驱动、做关键词列表管理代码量不小而且识别率受环境噪声影响明显需要调试麦克风阵列对新手不友好。SU-03T是离线方案官方提供一个网页版的配置平台你只需要在网页里选好唤醒词、添加命令词、配置串口波特率和引脚功能一键生成固件然后烧录进去就行整个流程不超过十分钟。这里有一个关键参数要注意SU-03T的UART配置。默认波特率是9600数据格式8N1但你要在配置平台上主动打开“UART外设控制”功能否则模块只通过IO口输出高低电平没法把具体识别到哪个命令词的信息传出去。我一开始就忘了这一步折腾了半天发现串口助手什么都收不到后来回平台重新生成固件才搞定。2.2 ESP32与语音模块的接线关系接线其实非常简单SU-03T的UART_TX接ESP32的UART2_RXGPIO16SU-03T的UART_RX接ESP32的UART2_TXGPIO17两边的GND必须共地否则电平参考不一致通信会乱码。这里要特别提醒ESP32的GPIO输入输出是3.3V电平SU-03T也是3.3V所以可以直接相连。如果你用的是5V的语音模块必须要加电平转换电路不然有烧引脚的风险。继电器模块我选的5V低电平触发就是IN引脚被拉低时继电器吸合悬空或高电平时断开。这种模块的优点是和ESP32连接时更安全因为ESP32上电瞬间GPIO默认是高电平继电器不会误动作。如果是高电平触发模块上电瞬间继电器会咔哒一声吸合然后才断开控制灯还好控制电机类设备会很危险。注意继电器模块和强电设备之间务必做好隔离。我用的模块自带光耦隔离但接线时依然要保证强电部分和弱电部分分开走线继电器输出端接灯或风扇时先断电操作确认无误后再上强电。安全这根弦任何时候都不能松。2.3 供电方案的选择这套系统里有三个需要供电的部件语音模块3.3V或5V、ESP325V USB供电、继电器模块5V。最简单的方式是用一个5V/2A的USB充电头给ESP32供电然后从ESP32的5V引脚取电给继电器模块再从3.3V引脚取电给语音模块。但要注意如果继电器同时吸合多路瞬时电流可能达到几百毫安再加上ESP32自身功耗和语音模块2A的余量是够的但如果你后面扩展到四路以上继电器建议单独用一个5V电源给继电器供电避免电压跌落导致ESP32重启。3. 语音固件配置与ESP32程序实现3.1 语音模块固件配置步骤先去SU-03T的官方配置平台注册并创建产品选择“通用离线识别”方案。然后按照下面几个步骤设置添加唤醒词。建议用两个字或三个字的词比如“小智小智”避免用太常见的口语词当唤醒词否则容易误唤醒。添加命令词。把你需要的指令全部列出来比如“打开灯”“关闭灯”“打开风扇”“关闭风扇”“打开所有”“关闭所有”。命令词之间不要有包含关系比如“打开”和“打开灯”同时存在识别时可能冲突。设置UART外设控制。打开串口发送功能选择“发送命令词”模式波特率选9600。这样模块识别到命令词后会把对应命令词通过串口发出来。生成固件并烧录。用CH340模块连接SU-03T的TX、RX、GND、VCC打开烧录工具选择生成的固件文件点击烧录即可。烧录过程中不要断开连接等提示成功后断电重启。烧录完成后先用串口助手波特率9600直接测试模块对着它说“小智小智”再命令词看能不能收到对应的字符串。这一步先做验证能省后面很多排查时间。3.2 ESP32端程序设计ESP32这边我用的Arduino IDE开发核心逻辑是串口读取语音模块的数据、解析命令词、通过MQTT发布消息、同时订阅MQTT消息控制继电器。下面是一个简化过的代码框架去掉了一些边界处理但核心链路完整#include WiFi.h #include PubSubClient.h const char* ssid 你的WiFi名; const char* password 你的WiFi密码; const char* mqttServer 192.168.1.100; // MQTT Broker地址 const int mqttPort 1883; const char* mqttUser ; const char* mqttPassword ; WiFiClient espClient; PubSubClient client(espClient); const int relayLightPin 26; const int relayFanPin 27; bool lightState false; bool fanState false; void setup() { Serial.begin(9600); // 与语音模块通信 Serial2.begin(9600, SERIAL_8N1, 16, 17); // UART2 接语音模块 pinMode(relayLightPin, OUTPUT); pinMode(relayFanPin, OUTPUT); digitalWrite(relayLightPin, HIGH); // 低电平触发初始断开 digitalWrite(relayFanPin, HIGH); WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); } client.setServer(mqttServer, mqttPort); client.setCallback(callback); connectMQTT(); } void loop() { if (!client.connected()) { connectMQTT(); } client.loop(); handleSerialCommand(); } // 串口接收到语音模块的指令后做关键词匹配 void handleSerialCommand() { while (Serial2.available() 0) { String cmd Serial2.readStringUntil(\n); cmd.trim(); if (cmd.indexOf(打开灯) 0) { lightState true; digitalWrite(relayLightPin, LOW); client.publish(home/bedroom/light/state, ON); } else if (cmd.indexOf(关闭灯) 0) { lightState false; digitalWrite(relayLightPin, HIGH); client.publish(home/bedroom/light/state, OFF); } // 风扇、全开全关逻辑类似 } } // MQTT回调手机或面板也能控制 void callback(char* topic, byte* payload, unsigned int length) { String msg; for (int i 0; i length; i) { msg (char)payload[i]; } if (String(topic) home/bedroom/light/set) { if (msg ON) { digitalWrite(relayLightPin, LOW); } else { digitalWrite(relayLightPin, HIGH); } } } void connectMQTT() { while (!client.connected()) { if (client.connect(ESP32Client)) { client.subscribe(home/bedroom/light/set); client.subscribe(home/bedroom/fan/set); } else { delay(2000); } } }实际测试中这套代码跑起来非常稳定。需要注意两个细节串口接收语音模块数据时用readStringUntil(\n)一定要确认语音模块发送的数据是以换行符结尾的SU-03T默认的串口输出格式刚好满足MQTT发布和订阅的主题要分开/set是控制指令/state是状态反馈这样后面接Home Assistant或手机App做状态同步时语义清晰不会混乱。3.3 MQTT Broker的安装与配置MQTT Broker我用的Mosquitto装在一台闲置的树莓派上但你也可以用任何一台常开的电脑、NAS甚至另一块ESP32来跑。安装命令很简单以Ubuntu/Debian为例sudo apt update sudo apt install mosquitto mosquitto-clients sudo systemctl enable mosquitto配置文件/etc/mosquitto/mosquitto.conf里默认监听1883端口本地无需账号密码即可连接。但如果你准备把控制指令暴露到公网比如人在外面想远程控制一定要开启用户名密码认证并配置TLS加密。如果只是局域网内用默认配置就够了。测试Broker是否正常可以用两个终端窗口终端1订阅mosquitto_sub -t home/#终端2发布mosquitto_pub -t home/bedroom/light/set -m ON看到终端1收到消息说明Broker工作正常这时候再跑到ESP32上测试指令下发就顺理成章了。4. 功能验证场景与常见问题排查4.1 完整场景测试流程我搭完这套系统后按照下面几个场景做了验证你也可以照着测测试场景语音指令预期行为实测结果卧室灯开关“小智小智打开灯”卧室灯点亮MQTT状态变为ON通过延迟约1秒风扇控制“小智小智打开风扇”风扇继电器吸合风扇转动通过全开全关“小智小智打开所有”灯和风扇全部打开通过手机远程控制在MQTT面板发布ON/OFF对应设备动作通过WiFi下延迟200ms内延迟方面离线语音识别的响应速度比在线识别快很多基本是“话说出口到继电器动作”在1秒以内体感上非常跟手。如果你觉得响应慢先排查是不是ESP32主循环里client.loop()被串口读取阻塞了可以考虑把继电器操作放到定时器中断里做。4.2 语音识别不灵敏的排查思路语音模块识别不灵敏问题根源通常不在模块本身而是在供电和噪声。先检查语音模块的供电电压是否稳定SU-03T对电源纹波比较敏感如果和继电器共用一个电源继电器吸合瞬间的电压跌落会导致模块重启或者识别率骤降。我的解决办法是给语音模块单独加一颗100uF电解电容和0.1uF陶瓷电容做电源去耦效果立竿见影。另一个常见问题是环境噪声。如果你把麦克风放在空调风口、电视附近这种噪声比较大的地方离线模块的识别率会直线下降。可以尝试调整模块的“灵敏度”和“环境噪声消除”参数但这些参数往往被大家忽略。SU-03T的配置平台里有一个“麦克风灵敏度”选项环境嘈杂时适当调低反而能减少误识别。4.3 MQTT断连与重连策略ESP32运行过程中WiFi断了或者MQTT Broker重启都会导致连接断开。如果不做重连机制系统会一直显示离线语音指令自然也无法下发。我的做法是封装一个connectMQTT()函数在loop()里检查连接状态断开就尝试重连同时加入计数器和延时避免频繁重连把Broker打挂。还有一点ESP32的WiFi连接建议设置为静态IP不然路由器重新分配IP后其他设备就找不到它了。经验给ESP32设置静态IP时记得在路由器后台绑定MAC地址这样即使设备重启IP也是固定的。否则你写死在代码里的服务器地址一旦变了又得重新烧录固件非常麻烦。4.4 继电器误动作的避坑经验低电平触发的继电器在ESP32上电瞬间是安全的但如果你用的是STM32或者某些GPIO默认电平不确定的板子就要小心。另外继电器触点驱动感性负载比如风扇电机时断开瞬间会产生反向电动势可能会干扰主控甚至导致重启。我的处理方式是在继电器输出端并联一个续流二极管1N4007或者使用固态继电器模块后者没有机械触点噪音小、寿命长只是成本稍高。如果继电器吸合时有“咔哒”声但负载没反应先量一下继电器输出端是否有电压再看接线是不是把常开端和公共端接反了。继电器模块一般有NO常开、NC常闭、COM公共端三个接口控制灯或风扇应该接COM和NO而不是COM和NC。这个接反了非常隐蔽因为通电后继电器“看起来”在工作实际上就是不通。4.5 语音模块串口乱码的解决串口乱码十有八九是波特率不匹配。SU-03T默认9600但有些模块出厂设置可能是115200或者你配置固件时选成了其他波特率。还有一个容易忽视的点共地。语音模块和ESP32的GND必须接在一起否则串口电平没有参考点通信数据完全是乱的。这个问题我帮朋友排查过一次他折腾了一天最后发现就是GND没连。5. 系统扩展方向与个人经验总结这套基础版本跑通之后扩展空间非常大。我后续自己加了人体感应模块实现“人走灯灭”又接入了Home Assistant在手机App上能看到每个设备的状态还能设置定时场景。其实你只要搭好“语音识别MQTT继电器控制”这套骨架后面不管是加传感器、加摄像头、加温湿度检测都只是往MQTT协议栈里填新主题而已。最后再分享一个我踩过多次的坑语音命令词的设计一定要避开容易混淆的发音。我之前设过“打开客厅灯”和“打开餐厅灯”识别模块经常把“餐厅”听成“客厅”后来统一改成“灯一”“灯二”识别率立刻上去了。命令词越短、越拗口保留字特征越明显识别越准。这个经验在你写命令词列表的时候最好就考虑进去不然等固件烧好了才发现问题又要重新生成配置麻烦得很。这套系统我用到现在快两个月了稳定性超出预期。虽然比不上商业方案的语音助手智能但胜在链路简单、可控性强所有逻辑都在自己手里想加什么功能随时能改。如果你也一直在犹豫要不要动手搞一套我的建议是别想太多先按这套清单把物料凑齐一个周末就能看到成果。踩坑本身就是最好的学习方式。本文还有配套的精品资源点击获取
审核被拒整改实录：从模板套壳到差异化过审)
