🔴GHome Gate - Controlador de acceso NFC para Home Assistant.

Un controlador de acceso NFC compacto y totalmente integrado diseñado paraAsistente de hogar., impulsado porESPHome., y empaquetado dentro de una carcasa impresa en 3D personalizada.
Este dispositivo te permite activar las automatizaciones de Home Assistant simplemente tocando una etiqueta NFC en el lector externo.

Está construido para ser instalado dentro delGabinete del medidor de utilidades.y alimentado directamente desde230 VAC., lo que lo convierte en un módulo de acceso totalmente autónomo para puertas, puertas de garaje, alarmas y automatizaciones.

⭐Características

• ✔️ Lector NFC PN532 (I2C)
• ✔️ ESP8266 NodeMCU ejecutando ESPHome.
• ✔️ Potencia directa de 230 VAC → 5 VDC a través de una PSU aislada de Hi-Link.
• ✔️ Antena NFC externa + retroalimentación interna del zumbador.
• ✔️ Diseñado para la instalación de gabinetes eléctricos al aire libre.
• ✔️ Envía instantáneamente el ID de la etiqueta a Home Assistant (tag_scanned)
• ✔️ Bips personalizados, estado LED, actualizaciones OTA, encriptación API.
• ✔️ Totalmente de código abierto y personalizable.

📦Lista de materiales (BOM)

Electrónica.

Componente	Cantidad	Notas
NodeMCU v2 ESP8266	1	El microcontrolador principal ejecutando ESPHome.
Módulo RFID/NFC PN532 (versión I2C)	1	Montado dentro de la carcasa externa del lector.
Hi-Link HLK-PM01(100–240VAC → 5VDC)	1	Fuente de alimentación compacta aislada.
Buzzer pasivo (5V)	1	Conectado a través de PWM (GPIO12)
Placa prototipo (70×50 mm)	1	Para el montaje de ESP + PSU.
Antena WiFi externa.	1	Requerido debido a la protección de los gabinetes de metal.
Pinzas de cabecera + cables de puente.	varios	Cableado interno.
Inserciones roscadas de latón M3	4	Para un ensamblaje robusto de la carcasa.
Tornillos M3	4	Cierre de la cubierta.

Partes impresas en 3D.

Parte	Material	Notas
Recinto principal (Puerta GHome)	PETG / ASA	Resistente al calor, duradero.
Tapa frontal con logotipo en relieve.	PETG / ASA
Soporte para lector NFC externo.	PETG / ASA	Montaje adhesivo.
Separadores de panel internos.	PETG.

Otros.

• Tubo termocontraíble.
• Ataduras de cable.
• Padillas de silicona o de doble cara.
• Cable de doble aislamiento de 230 VAC.

⚙️Resumen del hardware.

El dispositivo está compuesto por dos módulos físicos:

1. Caja del controlador principal.

Contiene:

• NodeMCU ESP8266
• Módulo de potencia Hi-Link.
• Buzzer.
• Conexión I2C al lector NFC.
• Conector de antena WiFi.

Esta caja está instalada.dentro del gabinete del medidor., alimentado directamente por 230 VAC.

2. Pad NFC externo

Montado fuera de la puerta del gabinete.
Esto contiene la placa PN532 , colocada cerca de la superficie de plástico para una máxima fiabilidad en la detección de etiquetas.

Los dos módulos están conectados internamente a través de un pequeño cable de cinta (SDA, SCL, 5V, GND).

🔌Pinout / Cableado.

NodeMCU → PN532

PN532	NodeMCU.
SDA	GPIO4 (D2)
SCL	GPIO5 (D1)
VCC	5V
GND	GND

NodeMCU → Buzzer.

Buzzer.	NodeMCU.
Señal	GPIO12 (D6)
VCC	5V
GND	GND

Entrada de potencia.

Salida de Hi-Link.	NodeMCU.
+5V	Vin.
GND	GND

🧠Configuración de ESPHome.

A continuación se muestra el firmware utilizado en este proyecto (listo para copiar/pegar):

 

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

🏡Integración de Home Assistant.

Este módulo se integra de forma nativa con Home Assistant a través de la API de ESPHome.

Cuando se escanea una etiqueta:

Home Assistant recibe:

 

tag_scanned: id: <tag_uid>

Puedes usar esto para desencadenar:

• control de puerta
• Desbloqueo de puerta.
• Armar/desarmar la alarma.
• Detección de presencia.
• Automatizaciones personalizadas.

Retroalimentación de audio.

Puedes llamar al:

• Botón. Bip.
• Botón.test_doppio_beep

O desencadenar los servicios expuestos por la API:

• esphome.gate_beep
• esphome.test_doppio_beep

🖨️Instrucciones de impresión 3D.

Ajustes recomendados:

• Material:PETG o ASA.(resistente al calor y a las condiciones exteriores)
• Altura de la capa:0,2 mm
• Perímetros:3
• Relleno:20–30%
• Apoya:No.(Todas las partes diseñadas con geometría autoportante)
• Temperatura de la cama:75–80°C
• Hotend:235–245°C

Notas:

• Los insertos de latón deben ser prensados a calor en el cuerpo principal.
• La cubierta NFC externa no debe ser más gruesa que 2,0–2,5 mm para un mejor rendimiento de lectura.
• El orificio del conector de antena es compatible con los conectores de mamparo SMA.

🔧Instrucciones de montaje.

1. Solde el NodeMCU y Hi-Link a la placa prototipo.
2. Cable SDA/SCL/5V/GND de NodeMCU a PN532
3. Monta el PN532 en la carcasa del lector externo.
4. Instala insertos de latón en la caja impresa en 3D.
5. Enrute el cable I2C entre las dos carcasas.
6. Conecta el zumbador a GPIO12.
7. Cierre el recinto principal usando tornillos M3.
8. Monta la almohadilla externa en la puerta usando tornillos o adhesivo.
9. Instale el módulo principal dentro del gabinete del medidor eléctrico.
10. Subir el firmware de ESPHome a través de USB o OTA.
11. Añade el dispositivo a Home Assistant.

🧩Cómo funciona.

• Cuando una etiqueta NFC se acerca a la plataforma externa,
• El PN532 reconoce el UID.
• ESPHome lo envía inmediatamente a Home Assistant.
• Home Assistant desencadena la automatización configurada.
• El zumbador proporciona retroalimentación de audio.
• El LED de estado muestra la conectividad y las actualizaciones OTA.

Un sistema de acceso privado local completo con respuesta instantánea.

🛡️Notas de seguridad.

⚠️El módulo Hi-Link maneja 230 VAC.
La instalación debe hacerse con la energía.desconectado, e idealmente por alguien con experiencia.

⚠️ Siempre usa unCable de 230 V doblemente aislado..

⚠️ No exponga el recinto principal a la intemperie (manténgalo dentro del gabinete).

📜Licencia

Este proyecto se publica bajo laLicencia MIT..
Puedes reutilizar, modificar o republicar los archivos siempre que se proporcione el crédito.