硬件编程 · 车库门远程状态卡片 · 2026-07-03

需求洞察

目标用户：拥有独立车库的住户，常因匆忙出门或夜间忘记关闭车库门而担心财物安全，尤其是内有自行车、工具、车辆等贵重物品的家庭。

真实痛点：

1. 传统遥控器无法远程确认门是否关好，人已离家几公里才犯嘀咕。
2. 开关门历史无任何记录，出现异常开门（如盗抢）毫无察觉。
3. 市面智能车库门控制器价格数百元，改装门槛高。
4. 小区、别墅车库无网线，电池供电设备需极低功耗才能长久运行。

为什么值得做：

只需在原有车库门上粘贴磁铁 + 门框固定磁簧开关，即可将“门状态”变成一种可订阅的数字消息。ESP8266 成本极低，结合 MQTT 可以无缝融入现有智能家居系统。低功耗设计让两节 18650 电池续航超过一年，真正实现免布线、免运维的家庭安防小改造。

方案设计

感知层

采用常闭型磁簧开关（门关 = 磁铁靠近 = 开关导通，门开 = 开关断开）。开关一端接地，另一端接 ESP8266 的 GPIO2，启用内部上拉。

• 门关闭：GPIO2 读到低电平。
• 门打开：GPIO2 变高，同时触发上升沿中断，唤醒处于 Light‑Sleep 的 ESP8266。

控制层

ESP8266 负责状态判断、联网、MQTT 上报与休眠控制。关键策略：

• 上电初始化 WiFi 与 MQTT 连接，上报开机状态。
• 检测到 GPIO2 电平变化后，更新时间戳与状态，进行去抖。
• 发布 MQTT 消息 garage/door（payload：CLOSED 或 OPEN）。
• 完成后立即调用 wifi_set_sleep_type(LIGHT_SLEEP_T) 和 gpio_pin_wakeup_enable 进入休眠，待下一次门状态变化唤醒。
• LED 通过 GPIO0 指示：上报成功快闪一次，休眠时熄灭。

执行层

本地仅板载 LED，用于调试与状态提示。所有执行动作由云端或家庭中心完成（如通过 HomeAssistant 推送通知、联动警报器、自动关闭车库门等），本设备专注“状态卡片”职能。

日志/联网层

通过 MQTT 接入私有或公共 broker，可搭配 Node‑RED、HomeAssistant 记录开关门日志、绘制时间线图表。利用 QoS 1 保证消息送达，若意外断网，ESP8266 会在唤醒后重新联网上报，确保不丢失重要事件。

物料清单

总物料成本仅 17.62 元，预留充足空间满足 25 元目标。如需批量贴片，成本还可更低。

接线与结构

• 磁簧开关：一端接 GPIO2，另一端接 GND。GPIO2 内部启用上拉（pinMode(2, INPUT_PULLUP)），门关时开关闭合，GPIO2 为低；门开时断开，GPIO2 被内部上拉至高电平。同时利用该引脚的外部中断功能作为唤醒源。
• LED：正极串 220Ω 电阻接 GPIO0，负极接 GND。输出低电平时 LED 点亮。休眠时 GPIO0 置高，LED 熄灭，最大限度节省功耗。
• 电源：18650 正极 → 开关 → AMS1117 输入，AMS1117 输出 3.3V 接 ESP‑01S 的 VCC 与 CH_PD 使能；电池负极与模块 GND 共地。充电时可取出电池单独充电，或另接 TP4056 模块（成本允许时加装）。
• 微调理由：给定接线已天然支持低功耗中断唤醒，无需改动。实测上升沿唤醒稳定且去抖简单。

结构建议：磁簧开关用热熔胶固定于门框内侧，对应位置在门上粘贴磁铁。主控板与电池放入小塑料盒挂在附近墙面，避免雨水淋溅。

核心代码

（Arduino sketch，基于 ESP8266 Non‑OS SDK 风格，适用于 PlatformIO 或 Arduino IDE）

#include <ESP8266WiFi.h>
#include <PubSubClient.h>

const char* ssid = "你的WiFi";
const char* password = "你的密码";
const char* mqtt_server = "你的MQTT服务器IP";
const int mqtt_port = 1883;
const char* mqtt_user = "用户名";
const char* mqtt_pass = "密码";
const char* topic = "garage/door";

WiFiClient espClient;

#define DOOR_PIN 2   // GPIO2
#define LED_PIN  0   // GPIO0

volatile bool doorChanged = false;
bool doorIsOpen = false;       // 当前门状态，true=开
unsigned long lastDebounce = 0;

void ICACHE_RAM_ATTR handleDoorInterrupt() {
  // 在中断里尽量简单，只设置标志
  doorChanged = true;
}

void reconnectMQTT() {
  while (!client.connected()) {
    if (client.connect("GarageSensor", mqtt_user, mqtt_pass)) {
      // 连接成功可 pulish 保留消息等
    } else {
      delay(500);
    }
  }
}

void reportState(bool state) {
  String payload = state ? "OPEN" : "CLOSED";
  if (client.publish(topic, payload.c_str(), true)) {
    digitalWrite(LED_PIN, LOW);
    delay(80);
    digitalWrite(LED_PIN, HIGH);
  }
  Serial.print("Published: ");
  Serial.println(payload);
}

void setup() {
  pinMode(LED_PIN, OUTPUT);
  digitalWrite(LED_PIN, HIGH);  // 熄灭

  Serial.begin(115200);
  WiFi.begin(ssid, password);
  unsigned long start = millis();
  while (WiFi.status() != WL_CONNECTED && millis() - start < 10000) {
    delay(100);
  }

  // 上报初始状态
  doorIsOpen = (digitalRead(DOOR_PIN) == HIGH);
  if (WiFi.status() == WL_CONNECTED) {
    reconnectMQTT();
    reportState(doorIsOpen);
  }
}

void loop() {
  // 处理中断标志
  if (doorChanged) {
    // 去抖
    if (millis() - lastDebounce > 50) {
      bool current = (digitalRead(DOOR_PIN) == HIGH);
      if (current != doorIsOpen) {
        doorIsOpen = current;
        if (WiFi.status() != WL_CONNECTED) {
          WiFi.reconnect();
          reconnectMQTT();
        }
        if (client.connected()) {
          reportState(doorIsOpen);
        }
      }
      lastDebounce = millis();
    }
    doorChanged = false;
  }

  // 进入 Light-Sleep，等待 GPIO2 上升沿唤醒
  delay(10);  // 确保设置生效
  wifi_force_sleep_start();
  delay(1000); // 实际上会被中断立即唤醒，此处仅为占位

  // 唤醒后恢复
  wifi_force_sleep_wake();
}