基于ESP8266的智能PIR报警器DIY：从传感器原理到物联网安防实战-开发者社区

1. 项目概述：一个能“思考”的智能安防哨兵

在家庭安防领域，红外感应报警器早已不是什么新鲜玩意儿。但市面上大多数产品要么功能单一，要么需要复杂的布线和昂贵的云服务订阅。作为一个喜欢动手折腾的硬件爱好者，我一直在寻找一个方案：它应该足够智能，能区分误报和真实威胁；它应该足够独立，不依赖任何第三方平台，数据完全掌握在自己手里；它还应该足够灵活，能通过多种方式通知我，无论是深夜的邮件还是紧急时刻的短信。

这就是我动手打造这个“基于ESP的PIR报警器”的初衷。它的核心很简单：一个ESP8266或ESP32开发板，搭配一个被动红外（PIR）传感器，构成系统的“眼睛”和“大脑”。当PIR传感器检测到指定区域内的移动时，ESP芯片会立刻行动起来，通过Wi-Fi网络，向我指定的邮箱发送警报邮件，甚至可以通过短信网关（我选择了Nexmo，现在叫Vonage）直接发送短信到手机。这听起来像是智能家居的入门项目，但我在其中倾注了大量实战细节，让它从一个简单的“触发-通知”装置，变成了一个拥有十行活动日志、支持多种工作模式、并能通过网页远程管理的可靠安防节点。

这个项目非常适合那些对物联网（IoT）和家庭自动化感兴趣的DIYer，无论你是想守护车库、后院、还是某个重要的房间，它都能提供一个高性价比、高可控性的解决方案。接下来，我将从设计思路到代码细节，从硬件连接到避坑指南，完整地分享我的构建过程。

2. 整体系统设计与核心思路拆解

2.1 为什么选择ESP8266/ESP32作为核心？

在项目启动时，主控芯片的选择至关重要。我放弃了传统的Arduino Uno+以太网盾的方案，也绕开了需要额外编程的树莓派，最终锁定了ESP系列芯片，主要是基于以下几点考量：

成本与性能的完美平衡：一片ESP8266（如NodeMCU或Wemos D1 mini）的价格仅相当于一杯咖啡，但它内置了完整的Wi-Fi堆栈和TCP/IP协议栈。这意味着我不需要任何额外的网络模块，就能让设备轻松接入家庭局域网。ESP32则提供了更强大的双核处理能力和蓝牙功能，为未来升级留足了空间。对于这个报警器项目，ESP8266的性能已经绰绰有余。

强大的社区与生态支持：ESP系列拥有极其庞大的开源社区，无论是Arduino IDE还是PlatformIO，对其支持都非常完善。有大量经过验证的库可以直接使用，例如用于网络服务的ESP8266WebServer或AsyncWebServer，用于NTP对时的NTPClient，以及用于邮件发送的ESP_Mail_Client。这能让我将精力集中在应用逻辑，而非底层驱动上。

低功耗潜力（针对ESP32）：虽然本项目主要接市电，但ESP32深厚的低功耗模式为电池供电的无线传感器版本提供了可能，这是传统方案难以企及的。

2.2 感知层：PIR传感器的工作原理与选型要点

被动红外传感器是本项目的“眼睛”。它并不发射任何能量，而是检测物体（如人、动物）发出的红外辐射变化。传感器前端的菲涅尔透镜将探测区域分割成多个明暗交替的敏感区，当热源（人体）在探测区内移动，导致红外辐射在传感器上产生变化，便会触发信号。

在选型和使用时，有几个关键点决定了系统的可靠性：

灵敏度与延时调节：大多数模块（如HC-SR501）有两个旋钮。一个是灵敏度（Sensitivity），调节探测距离（通常3-7米）；另一个是延时时间（Time Delay），即触发后输出高电平的持续时间。我将延时时间调得较短（如2-3秒），以避免单次移动产生持续不断的警报。灵敏度则根据安装环境调整，避免因远处无关动静（如窗外树枝摇晃）而误报。

触发模式选择：有些模块支持“可重复触发”和“不可重复触发”模式。在“不可重复触发”模式下，在输出高电平的延时时间内，任何新的移动都不会被响应。这非常适合报警场景，可以防止一次入侵事件触发数十封邮件，造成“狼来了”的效应。我强烈建议将跳线帽设置在“不可重复触发”模式。

安装位置的艺术：PIR传感器应避免正对热源（如暖气、空调出风口）、阳光直射的窗户或通风口。最佳安装高度在2-2.5米，倾斜向下探测。它的探测模式是锥形的，要清楚其覆盖范围，避免盲区。

2.3 通知策略：邮件与短信的双重保障

单一的通知通道是不可靠的。网络可能拥堵，邮件可能被归入垃圾箱。因此，我设计了邮件为主、短信为辅的双重通知机制。

邮件通知（SMTP协议）：我使用ESP芯片直接连接公共邮件服务商的SMTP服务器（如QQ邮箱、163邮箱或Gmail的SMTP服务）。这需要你在代码中配置发件邮箱的地址、密码（或授权码）、SMTP服务器地址和端口。邮件内容可以包含丰富的文本信息，如触发时间、设备ID等。它的优点是免费（在一定额度内）、信息量大，但实时性相对较差。

短信通知（Nexmo/Vonage API）：为了获得近乎实时的警报，我集成了Nexmo（现为Vonage）的短信API。当PIR被触发时，ESP会向Nexmo的API发送一个HTTP POST请求，Nexmo则会将该短信转发到我的手机。虽然这是付费服务（但费用极低，一条短信几分钱），但在关键时刻，手机短信的送达率和即时性远超邮件。在代码中，你需要保存好API Key和API Secret。

重要提示（安全）：无论是邮箱密码（授权码）还是API密钥，都属于敏感信息。绝对不要将它们硬编码在源代码中并上传到公开的代码仓库。正确做法是使用#define在头文件中定义，并在上传前确保该头文件已被.gitignore忽略，或者使用ESP的“文件系统”在首次配置时写入，运行时从SPIFFS中读取。

2.4 模式管理与用户交互：让设备更“听话”

一个只有单一功能的报警器是笨拙的。我通过一个干簧管（磁控开关）和一颗RGB LED，赋予了它三种清晰的工作模式，并通过内置的Web服务器提供了远程管理界面。

硬件模式切换（干簧管）：我在设备外壳上安装了一个干簧管，配合一块小磁铁。用磁铁靠近或远离，可以触发干簧管通断。我在代码中将其设置为模式切换开关。例如：

磁铁远离（常开）：正常布防模式。PIR触发即发送警报。
磁铁靠近（闭合）：静音模式。PIR触发后，仅在内部记录日志，不发送任何邮件或短信，RGB LED也保持熄灭。适合你在家时使用，避免误报打扰。
通过Web界面切换：可以设置一个“测试模式”，在此模式下，PIR触发后仅点亮LED，不发送通知，用于安装后的调试。

状态指示（RGB LED）：一颗LED通过不同颜色清晰传达状态：

蓝色慢闪：设备启动中，正在连接Wi-Fi。
蓝色常亮：Wi-Fi连接成功，系统正常运行于布防模式。
绿色常亮：处于静音模式。
红色闪烁：PIR传感器被触发，正在发送警报。
黄色常亮：Web服务器正在处理配置请求。

内置Web服务器：这是项目的“控制中心”。通过手机或电脑浏览器访问设备的IP地址，可以看到一个简洁的网页。上面展示了当前模式、活动日志，并提供了配置接口，可以修改：

Wi-Fi SSID和密码（用于更换网络）。
发件邮箱和SMTP信息。
Nexmo API密钥和接收短信的手机号。
时区设置和NTP服务器地址。所有配置在修改后会立即保存到ESP的EEPROM中，即使断电也不会丢失。

十行活动日志：我在ESP的RAM中维护了一个小的环形缓冲区，用于存储最近十次事件（如“系统启动”、“PIR触发”、“模式切换”、“配置更新”等）。这个日志不仅可以在Web页面上查看，在排查问题时（比如为什么没收到警报？）也极其有用，我可以直接看到设备是否确实检测到了移动。

3. 核心模块电路连接与硬件搭建

3.1 所需材料清单

在开始焊接之前，请准备好以下所有部件。我建议选择质量可靠的模块，尤其是PIR传感器，劣质品误报率会很高。

组件	型号/规格	数量	备注
主控板	ESP8266 NodeMCU 或 Wemos D1 mini	1	核心处理与通信单元
PIR传感器	HC-SR501	1	人体移动检测
RGB LED	共阳极或共阴极	1	状态指示，需确认类型
干簧管	常开型	1	磁控模式切换开关
磁铁	小型钕磁铁	1	与干簧管配合使用
电阻	220Ω	3	用于RGB LED限流
电阻	10kΩ	1	用于干簧管上拉（若需要）
面包板/PCB	-	1	用于原型搭建
杜邦线	公对公、公对母	若干	连接各模块
电源	5V/1A USB适配器	1	为整个系统供电

3.2 电路连接详解与原理图

正确的连接是稳定运行的基础。以下连接以共阴极RGB LED和ESP8266 NodeMCU为例。如果你的LED是共阳极，电路需要调整（LED正极接VCC，RGB引脚通过电阻接ESP，输出低电平点亮）。

1. PIR传感器连接：

VCC-> NodeMCU的3.3V引脚。注意：虽然HC-SR501标称5V工作电压，但许多模块的3.3V也能稳定驱动。如果发现不稳定，可接5V引脚，但信号线OUT必须接在NodeMCU的数字引脚上，其IO口可耐受5V输入。
GND-> NodeMCU的GND。
OUT-> NodeMCU的D5(GPIO14)。你可以选择其他任何数字引脚，只需在代码中相应修改。

2. 共阴极RGB LED连接：

共阴极（最长引脚）-> NodeMCU的GND。
R（红色引脚）-> 串联一个220Ω电阻 -> NodeMCU的D6(GPIO12)。
G（绿色引脚）-> 串联一个220Ω电阻 -> NodeMCU的D7(GPIO13)。
B（蓝色引脚）-> 串联一个220Ω电阻 -> NodeMCU的D8(GPIO15)。

3. 干簧管连接：干簧管有两根引脚，无极性。我将其一端连接到NodeMCU的D1(GPIO5)，另一端连接到GND。并在GPIO5和3.3V之间连接一个10kΩ的上拉电阻。这样，当磁铁远离（干簧管断开）时，GPIO5通过上拉电阻读到高电平（1）；当磁铁靠近（干簧管闭合）时，GPIO5被短接到GND，读到低电平（0）。通过检测这个电平变化来切换模式。

连接注意事项：
电源：确保所有模块的GND连接到一起，共地是电路正常工作的前提。
GPIO15 (D8) 的特殊性：ESP8266的GPIO15在启动时需要为低电平，否则可能无法正常启动。我们用它驱动LED没问题，但切忌在启动时通过上拉电阻将其拉高。
引脚分配规划：避免使用一些有特殊功能的引脚，如GPIO0（通常与Flash模式相关）、GPIO2（内部上拉，常用于板载LED）。我选择的D1, D5, D6, D7, D8都是相对“安全”的通用IO。

3.3 外壳设计与安装心得

硬件不能一直裸露在面包板上。一个合适的外壳不仅能保护电路，还能优化PIR的探测性能。

材料选择：我使用了一个尺寸合适的塑料防水盒（例如IP65等级）。在盒子上开孔：

正面：为PIR传感器的菲涅尔透镜开一个圆形孔。确保孔洞光滑，不要遮挡透镜的扇形区域。
侧面：为干簧管开一个小孔，使其能感受到外部磁铁的靠近与远离。
侧面或背面：为RGB LED开一个小孔，让光线能透出。可以用热熔胶固定LED。
背面：开孔用于USB电源线穿入，并设计壁挂孔。

安装定位：

将PIR传感器用热熔胶或螺丝固定在外壳内部，确保其透镜正对开孔。
将整个电路板用铜柱或塑料柱固定在外壳底板上，防止晃动。
干簧管用胶水固定在侧壁开孔内侧。
最后，将外壳安装在需要监控区域的墙角或高处，调整角度，使其覆盖入口或通道。安装后，务必通过Web界面进入“测试模式”，亲自走动测试其探测范围是否符合预期。

4. 软件代码实现与核心逻辑剖析

硬件是躯体，软件是灵魂。下面我将分模块解析核心代码逻辑。完整代码较长，这里重点讲解关键部分和配置。

4.1 开发环境与库依赖

我使用PlatformIO进行开发，它比Arduino IDE的库管理更清晰。你也可以使用Arduino IDE。需要在项目中包含以下库（在PlatformIO的platformio.ini中声明，或在Arduino IDE的库管理中安装）：

[env:nodemcuv2] platform = espressif8266 board = nodemcuv2 framework = arduino monitor_speed = 115200 lib_deps = ESP8266WiFi ESP8266WebServer NTPClient ESP_Mail_Client ArduinoJson

ESP8266WebServer：用于创建内置Web服务器。
NTPClient：用于从网络时间服务器获取当前时间。
ESP_Mail_Client：功能最强大的ESP邮件发送库，支持SSL。
ArduinoJson：用于解析和生成Web服务器交互的JSON数据，以及保存配置到EEPROM。

4.2 全局配置与引脚定义

首先，创建一个config.h头文件来存放所有敏感信息和可配置参数。切记将此文件加入.gitignore。

// config.h - 警告：此文件包含敏感信息，切勿上传至公开仓库！ #ifndef CONFIG_H #define CONFIG_H // WiFi 配置 const char* WIFI_SSID = "Your_WiFi_SSID"; const char* WIFI_PASSWORD = "Your_WiFi_Password"; // 邮箱配置 (以QQ邮箱为例) #define SMTP_HOST "smtp.qq.com" #define SMTP_PORT 465 // SSL端口 const char* EMAIL_SENDER = "your_email@qq.com"; const char* EMAIL_SENDER_PASSWORD = "你的授权码"; // 不是邮箱密码！ const char* EMAIL_RECIPIENT = "alert_recipient@example.com"; // Nexmo (Vonage) SMS 配置 const char* NEXMO_API_KEY = "your_api_key"; const char* NEXMO_API_SECRET = "your_api_secret"; const char* NEXMO_TO_NUMBER = "8613800138000"; // 国际格式，中国号码前+86 const char* NEXMO_FROM_NUMBER = "YourVonageVirtualNumber"; // 你在Vonage购买/申请的发信号码 // 设备标识 const char* DEVICE_NAME = "LivingRoom_Alarm"; // 引脚定义 #define PIR_PIN D5 #define REED_PIN D1 #define LED_R D6 #define LED_G D7 #define LED_B D8 #endif

在主程序文件中，引入配置并定义其他全局变量。

#include <Arduino.h> #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <NTPClient.h> #include <WiFiUdp.h> #include <ESP_Mail_Client.h> #include <ArduinoJson.h> #include <EEPROM.h> #include "config.h" // 模式枚举 enum SystemMode { ARMED, SILENT, TEST }; SystemMode currentMode = ARMED; // Web服务器 ESP8266WebServer server(80); // NTP客户端 WiFiUDP ntpUDP; NTPClient timeClient(ntpUDP, "pool.ntp.org", 8*3600, 60000); // 东八区 // 邮件客户端 SMTPSession smtp; // 活动日志 String activityLog[10]; int logIndex = 0; // 其他状态变量 bool pirState = false; bool lastPirState = false; unsigned long lastTriggerTime = 0; const unsigned long DEBOUNCE_DELAY = 2000; // 防抖延时2秒

4.3 核心功能函数实现

1. 日志记录函数这是一个简单的环形缓冲区实现，用于记录最近10条活动。

void addToLog(String entry) { // 获取当前时间 timeClient.update(); String timestamp = timeClient.getFormattedTime(); entry = "[" + timestamp + "] " + entry; // 存入数组 activityLog[logIndex] = entry; logIndex = (logIndex + 1) % 10; // 环形递增 // 串口输出，便于调试 Serial.println(entry); }

2. 邮件发送函数使用ESP_Mail_Client库发送邮件。注意，QQ邮箱等需要开启SMTP服务并获取授权码。

void sendEmailAlert() { addToLog("PIR Triggered - Attempting to send email."); // 配置会话参数 ESP_Mail_Session session; session.server.host_name = SMTP_HOST; session.server.port = SMTP_PORT; session.login.email = EMAIL_SENDER; session.login.password = EMAIL_SENDER_PASSWORD; session.login.user_domain = ""; // 准备邮件 SMTP_Message message; message.sender.name = DEVICE_NAME; message.sender.email = EMAIL_SENDER; message.subject = "ALERT: Motion Detected!"; message.addRecipient("Owner", EMAIL_RECIPIENT); // 构建HTML邮件正文 timeClient.update(); String htmlMsg = "<div style=\"color: #ff0000;\"><h2>🚨 Motion Alert!</h2>"; htmlMsg += "<p><strong>Device:</strong> " + String(DEVICE_NAME) + "</p>"; htmlMsg += "<p><strong>Time:</strong> " + timeClient.getFormattedTime() + "</p>"; htmlMsg += "<p>Potential motion detected in the monitored area.</p></div>"; message.html.content = htmlMsg.c_str(); message.html.charSet = "utf-8"; message.text.charSet = "utf-8"; message.priority = esp_mail_smtp_priority::esp_mail_smtp_priority_high; // 连接并发送 if (!smtp.connect(&session)){ addToLog("Email connection failed."); return; } if (!MailClient.sendMail(&smtp, &message)) { addToLog("Email sending failed."); } else { addToLog("Email sent successfully."); } }

3. 短信发送函数通过HTTP POST请求调用Nexmo API。

void sendSMSAlert() { addToLog("PIR Triggered - Attempting to send SMS."); WiFiClient client; const char* host = "rest.nexmo.com"; const int httpPort = 443; // HTTPS // 构建请求体 String url = "/sms/json"; String messageText = "ALERT from " + String(DEVICE_NAME) + ": Motion detected!"; String postData = "api_key=" + String(NEXMO_API_KEY) + "&api_secret=" + String(NEXMO_API_SECRET) + "&to=" + String(NEXMO_TO_NUMBER) + "&from=" + String(NEXMO_FROM_NUMBER) + "&text=" + messageText; if (client.connect(host, httpPort)) { client.println("POST " + url + " HTTP/1.1"); client.println("Host: " + String(host)); client.println("Content-Type: application/x-www-form-urlencoded"); client.println("Connection: close"); client.print("Content-Length: "); client.println(postData.length()); client.println(); client.println(postData); // 等待响应（简单处理） delay(500); while(client.available()){ String line = client.readStringUntil('\r'); // 可在此解析响应，判断是否成功 } client.stop(); addToLog("SMS request sent."); } else { addToLog("Failed to connect to Nexmo API."); } }

4. LED状态控制函数根据当前模式设置RGB LED颜色。

void updateLED() { // 先关闭所有颜色 digitalWrite(LED_R, HIGH); // 对于共阴极LED，HIGH是熄灭 digitalWrite(LED_G, HIGH); digitalWrite(LED_B, HIGH); switch(currentMode) { case ARMED: digitalWrite(LED_B, LOW); // 蓝色常亮 break; case SILENT: digitalWrite(LED_G, LOW); // 绿色常亮 break; case TEST: // 测试模式可以设为紫色或其他颜色 digitalWrite(LED_R, LOW); digitalWrite(LED_B, LOW); break; } }

4.4 Web服务器与配置页面

Web服务器提供状态查看和配置修改功能。这里展示几个关键端点。

void setupWebServer() { // 提供根页面，显示状态和日志 server.on("/", HTTP_GET, [](){ String html = "<html><head><title>" + String(DEVICE_NAME) + "</title></head><body>"; html += "<h1>ESP PIR Alarm - " + String(DEVICE_NAME) + "</h1>"; html += "<p><strong>Mode:</strong> "; switch(currentMode) { case ARMED: html += "ARMED (Blue)"; break; case SILENT: html += "SILENT (Green)"; break; case TEST: html += "TEST (Purple)"; break; } html += "</p>"; html += "<h3>Activity Log (Latest 10):</h3><ul>"; for(int i = 0; i < 10; i++){ int idx = (logIndex + i) % 10; if(activityLog[idx].length() > 0){ html += "<li>" + activityLog[idx] + "</li>"; } } html += "</ul>"; html += "<p><a href='/config'>Configuration</a></p>"; html += "</body></html>"; server.send(200, "text/html", html); }); // 提供配置页面（GET请求） server.on("/config", HTTP_GET, [](){ String html = "<html><body><h1>Configuration</h1>"; html += "<form action='/save' method='POST'>"; html += "WiFi SSID: <input type='text' name='ssid' value='" + String(WIFI_SSID) + "'><br>"; html += "WiFi Password: <input type='password' name='pass'><br>"; // ... 其他配置项 html += "<input type='submit' value='Save'>"; html += "</form></body></html>"; server.send(200, "text/html", html); }); // 处理配置保存（POST请求） server.on("/save", HTTP_POST, [](){ if(server.hasArg("ssid")) { // 读取参数，保存到EEPROM String newSSID = server.arg("ssid"); // ... 保存逻辑 addToLog("Configuration updated via Web."); server.send(200, "text/plain", "Settings saved. Device will restart."); delay(1000); ESP.restart(); // 重启以应用新WiFi设置 } else { server.send(400, "text/plain", "Bad Request"); } }); server.begin(); addToLog("Web server started."); }

4.5 主循环逻辑

主循环负责检测PIR状态和干簧管状态，并根据模式执行相应动作。

void loop() { server.handleClient(); // 处理Web客户端请求 timeClient.update(); // 更新NTP时间 // 1. 检测干簧管状态以切换模式 bool reedState = digitalRead(REED_PIN); // 上拉电阻，断开为HIGH，闭合为LOW static SystemMode lastMode = currentMode; if(reedState == LOW && currentMode != SILENT) { currentMode = SILENT; addToLog("Mode switched to SILENT (Reed closed)."); } else if(reedState == HIGH && currentMode != ARMED) { currentMode = ARMED; addToLog("Mode switched to ARMED (Reed open)."); } if(currentMode != lastMode) { updateLED(); lastMode = currentMode; } // 2. 读取PIR传感器状态（带软件防抖） pirState = digitalRead(PIR_PIN); if(pirState == HIGH && lastPirState == LOW) { // 检测到上升沿（从无移动到有移动） unsigned long currentTime = millis(); if(currentTime - lastTriggerTime > DEBOUNCE_DELAY) { lastTriggerTime = currentTime; addToLog("PIR Trigger Detected."); // 根据模式采取行动 switch(currentMode) { case ARMED: setLEDColor(255, 0, 0); // 红色闪烁 sendEmailAlert(); sendSMSAlert(); delay(500); updateLED(); // 恢复模式颜色 break; case SILENT: // 静音模式，只记录日志，不通知，LED不变 break; case TEST: // 测试模式，仅闪烁LED setLEDColor(255, 255, 0); // 黄色 delay(300); updateLED(); break; } } } lastPirState = pirState; delay(50); // 短暂延时，降低CPU占用 }

5. 调试、部署与实战避坑指南

代码写完、硬件连好，只是成功了一半。接下来的调试和部署才是真正考验人的地方。我把自己踩过的坑和总结的技巧都记录在这里。

5.1 上电调试与常见问题排查

第一步：串口监视器是你的眼睛打开Arduino IDE或PlatformIO的串口监视器，设置波特率为115200。观察启动日志，这是诊断一切问题的起点。

常见启动问题与解决：

问题现象	可能原因	排查步骤与解决方案
不断重启，打印一堆乱码	电源不稳定或电流不足	使用质量好的5V/1A以上电源适配器，避免使用电脑USB口（尤其连接多个模块时）。检查所有接线是否牢固。
连接Wi-Fi失败	SSID/密码错误、信号弱	1. 检查`config.h`中的SSID和密码（注意大小写）。 2. 将设备靠近路由器测试。 3. 在代码中增加`WiFi.setSleepMode(WIFI_NONE_SLEEP);`，防止Wi-Fi休眠。
编译错误，提示库找不到	库未正确安装或版本冲突	在PlatformIO中检查`lib_deps`；在Arduino IDE中通过库管理器重新安装。确保库版本与ESP8266/Arduino核心版本兼容。
PIR传感器一直输出高电平	灵敏度太高、延时太长、安装环境有干扰	1. 调整传感器上的灵敏度旋钮逆时针调低。 2. 调整延时旋钮逆时针调短。 3. 移开热源（如灯泡、电器）、避免气流直吹。
邮件发送失败	SMTP配置错误、网络问题、授权码错误	1.最重要：使用授权码而非邮箱密码（QQ/163邮箱需在设置中开启SMTP并生成授权码）。 2. 确认SMTP服务器地址和端口（SSL常用465，TLS常用587）。 3. 尝试关闭防火墙或更换网络。
短信发送失败	API密钥错误、账户余额不足、号码格式不对	1. 登录Vonage后台检查API Key/Secret是否正确。 2. 确保账户有余额。 3. 接收号码格式必须是国际格式（如`8613800138000`）。

第二步：功能逐项测试

模式切换：用磁铁靠近/远离干簧管，观察RGB LED颜色是否在蓝（布防）、绿（静音）之间正确切换，串口日志是否有相应记录。
PIR触发测试：在布防模式下，在传感器前挥手。观察LED是否快速闪烁红色，串口是否打印“PIR Trigger Detected”和邮件发送日志。
Web界面测试：在手机或电脑浏览器输入设备的IP地址（串口日志会打印）。检查状态页是否正常显示，活动日志是否更新。尝试访问/config页面。

5.2 提升稳定性的高级技巧

经过基础调试后，这些技巧能让你的报警器更可靠：

1. Wi-Fi连接健壮性处理家庭Wi-Fi偶尔会断连。必须在代码中加入重连机制。

void checkWiFiConnection() { if (WiFi.status() != WL_CONNECTED) { Serial.print("WiFi disconnected. Attempting to reconnect..."); WiFi.disconnect(); WiFi.begin(WIFI_SSID, WIFI_PASSWORD); unsigned long startTime = millis(); while (WiFi.status() != WL_CONNECTED && millis() - startTime < 10000) { delay(500); Serial.print("."); } if (WiFi.status() == WL_CONNECTED) { Serial.println("Reconnected!"); addToLog("Wi-Fi reconnected."); } else { Serial.println("Failed to reconnect."); } } } // 在主循环中定期调用此函数，例如每30秒一次。

2. 看门狗定时器（WatchDog Timer）防止程序跑飞导致设备“死机”。ESP8266有软件看门狗和硬件看门狗。

#include <Ticker.h> Ticker watchdogTicker; void feedWatchdog() { ESP.wdtFeed(); // 喂狗 } void setup() { // ... 其他初始化 ESP.wdtEnable(5000); // 启用硬件看门狗，超时5秒 watchdogTicker.attach(3, feedWatchdog); // 每3秒喂一次狗 }

3. EEPROM存储与磨损均衡频繁保存配置会损坏EEPROM。不要每次循环都写。只在配置变更时写入，并且可以考虑在RAM中缓存配置，或使用更高级的Preferences库（针对ESP32）或LittleFS/SPIFFS文件系统。

4. PIR误报过滤算法除了硬件调整，还可以加入软件滤波。例如，要求PIR信号在短时间内被连续检测到多次才认定为有效触发，这可以过滤掉飞虫等小物体引起的瞬时变化。

const int REQUIRED_TRIGGER_COUNT = 2; // 连续触发次数 const int DEBOUNCE_WINDOW_MS = 100; // 时间窗口 int triggerCount = 0; unsigned long lastPirReadTime = 0; // 在主循环中 if (pirState == HIGH) { if (millis() - lastPirReadTime < DEBOUNCE_WINDOW_MS) { triggerCount++; } else { triggerCount = 1; } lastPirReadTime = millis(); if (triggerCount >= REQUIRED_TRIGGER_COUNT) { // 确认触发 triggerCount = 0; // ... 执行警报逻辑 } }

5.3 项目扩展与优化思路

这个基础框架有巨大的扩展潜力：

多传感器融合：增加一个毫米波雷达传感器（如LD2410）。PIR对静止的人无效，而雷达可以。将两者数据融合，可以极大降低误报（如宠物触发）和漏报。
电池供电与低功耗：使用ESP32的深度睡眠模式。PIR传感器唤醒ESP32，发送警报后再次休眠。配合大容量锂电池和太阳能板，可以实现完全无线的户外部署。
集成到智能家居平台：通过MQTT协议，将报警状态发布到Home Assistant或OpenHAB。这样可以在智能家居仪表盘上显示状态，并联动其他设备，如触发时自动打开灯光、录制摄像头画面。
本地语音警报：增加一个小型功放模块和喇叭，当触发时播放录制好的警告音“警告，发现移动！”，这对吓阻入侵者可能更直接有效。
拍照取证：连接一个ESP32-CAM模块，在触发时抓拍一张照片，并连同邮件一起发送，提供视觉证据。

构建这个ESP PIR报警器的过程，远不止是连接几个模块和复制代码。它涉及了对无线通信、传感器特性、网络协议和安全边界的综合思考。最大的收获不是做出了一个能报警的盒子，而是掌握了如何让一个物联网设备在真实、不可靠的网络环境中稳定、可靠、安全地运行。从电源滤波到信号防抖，从密钥管理到异常处理，每一个细节都关乎最终产品的可用性。希望这份详尽的分享，能帮助你少走弯路，成功打造出守护你重要空间的智能哨兵。