🔴GHome 门禁系统——家居助手专用 NFC 门禁控制器

一种紧凑型、完全集成的NFC门禁控制器，专为 设计而开发。家庭助手，由 提供技术支持ESPHome，并被封装在一个定制的3D打印外壳内。
通过在外部读卡器上轻触 NFC 标签，即可触发 Home Assistant 的自动化操作。

它是专为安装在室内设计的，适用于多种场景，如家庭、办公室、商店等。公用事业计量表箱并直接由 供电。230伏交流电，这使得它成为一套完全自主的门禁系统，可用于控制门、闸、警报器和自动化设备。

⭐特色功能

• ✔️ PN532 NFC 读卡器(I2C 接口)
• ✔️ ESP8266 NodeMCU运行ESPHome系统
• ✔️ 通过 Hi-Link 隔离电源，将 230 VAC 直流电转换为 5 VDC 直流电供电。
• ✔️ 外置 NFC 天线 + 内置蜂鸣器反馈功能
• ✔️ 专为户外电气柜安装设计
• ✔️ 立即将标签ID发送至Home Assistant(tag_scanned)
• ✔️ 自定义提示音、LED状态指示、OTA升级、API加密功能
• ✔️ 完全开源且可定制

📦物料清单(BOM)

电子产品

组件	数量	笔记
NodeMCU v2 ESP8266	1	运行ESPHome的主微控制器
PN532 RFID/NFC模块(I2C版本)	1	安装在外置读卡器外壳内部
海信 Hi-Link HLK-PM01(100–240伏交流电转换为5伏直流电)	1	紧凑型隔离电源
被动式蜂鸣器(5V)	1	通过PWM(GPIO12)进行连接
原型板(70×50毫米)	1	用于ESP和PSU的安装固定
外置 WiFi 天线	1	由于金属机柜具有屏蔽作用，因此需要进行此项操作。
引脚排针 + 跳线	各种各样的	内部布线
M3黄铜螺纹嵌件	4	用于坚固的外壳组装
M3螺丝	4	盖子固定装置

3D打印零件

部分	材料	笔记
主入口(GHome门)	聚对苯二甲酸乙二醇酯	耐高温且经久耐用
带有浮雕标志的封面	聚对苯二甲酸乙二醇酯
外置 NFC 读卡器安装座	聚对苯二甲酸乙二醇酯	粘贴安装
内部面板间隔件	聚对苯二甲酸乙二醇酯

其他

• 热缩管
• 扎带
• 硅胶垫或双面垫片
• 230伏交流双绝缘电缆

⚙️硬件概述

该设备由两个物理模块组成：

1. 主控制器箱

包含以下成分：

• NodeMCU ESP8266
• 海立克电源模块
• 蜂鸣器
• 将I2C连接至NFC读卡器
• WiFi 天线连接器

这个盒子已经安装好了电表箱内部，由 230 VAC 直接供电。

2.外置NFC读卡器

安装在橱柜门外侧。
其中包含PN532控制板，安装位置紧邻塑料表面，以确保标签识别的准确性和可靠性达到最佳水平。

两个模块通过一根小型排线(SDA、SCL、5V、GND)进行内部连接。

🔌引脚排列 / 线路连接

NodeMCU → PN532

PN532	NodeMCU
圣地亚哥动物园	GPIO4(D2)
SCL	GPIO5(D1)
虚拟信用卡	5V
绿色新政	绿色新政

NodeMCU → 蜂鸣器

蜂鸣器	NodeMCU
信号	GPIO12(D6)
虚拟信用卡	5V
绿色新政	绿色新政

电源输入

海信	NodeMCU
+5V	文
绿色新政	绿色新政

🧠ESPHome 配置指南

以下是本项目中使用的固件(可直接复制粘贴使用)：

 

https://github.com/RazorCopter/home-assistant/blob/dev/Stack_esphome

🏡家庭助手集成功能

该模块通过 ESPHome API 与 Home Assistant 实现原生集成。

扫描标签时：

家庭助手接收到的信息包括：

 

扫描标签：id: <标签uid>

你可以用这个来触发：

• 门控机制
• 解锁车门
• 警报系统的布防/撤防操作
• 存在检测
• 定制自动化功能

音频反馈

您可以致电：

• 按钮。哔哔声
• 按钮.测试双声警报声

或者触发 API 公开的服务：

• esphome.gate_beep
• esphome.test_doppio_beep

🖨️3D 打印指导说明

推荐设置：

• 材质：聚对苯二甲酸乙二醇酯(耐高温且耐户外环境)
• 层厚度：0.2毫米
• 周长：3
• 填充部分：20%至30%
• 支持者：不要(所有部件均采用自支撑几何结构设计)
• 床铺温度：75–80摄氏度
• 加热床：235–245摄氏度

注意事项：

• 黄铜嵌件应通过热压工艺嵌入主体部件中。
• 若想获得最佳读取性能，外置 NFC 保护套的厚度不应超过 2.0 - 2.5 毫米。
• 天线连接器孔支持 SMA 壁挂式连接器。

🔧组装说明书

1. 将 NodeMCU 和 Hi-Link 焊接到原型板上
2. 将 NodeMCU 的 SDA/SCL/5V/GND 引脚连接至 PN532 模块。
3. 将PN532模块安装到外置读卡器的外壳中。
4. 将黄铜嵌件安装到 3D 打印的外壳中
5. 将I2C电缆布线至两个外壳之间
6. 将蜂鸣器连接到 GPIO12 接口。
7. 使用 M3 螺丝将主外壳封闭起来
8. 使用螺丝或胶水将外部垫片安装在门上
9. 将主模块安装在电表箱内。
10. 通过 USB 或 OTA 方式上传 ESPHome 固件
11. 将设备添加到 Home Assistant 平台中

🧩它的工作原理

• 当NFC标签靠近外部感应板时，
• PN532芯片能够识别用户识别码
• ESPHome 会立即将其发送至 Home Assistant 平台。
• 家庭助手会触发已配置的自动化操作。
• 蜂鸣器会提供音频反馈
• 状态指示灯用于显示设备连接状态和 OTA 更新提示。

一个功能齐全、本地化且私密的访问系统，可实现即时响应。

🛡️安全提示

⚠️海立链接
安装工作必须在通电的情况下进行。断开连接了，最好是由有经验的人来做。

⚠️ 一定要使用一个双绝缘230伏电缆。

⚠️ 请勿将主机箱暴露于恶劣天气环境中(务必保持其置于机柜内)。

📜许可证

该项目是在以下许可下发布的：MIT 许可证。
只要注明出处，你就可以重复使用、修改或重新发布这些文件。