Wiznet makers

Overview

hoermann-supramatic-e2-esphome은 Hörmann SupraMatic E2 차고문 오프너의 BUS/HCP1을 isolated RS-485로 ESP32-S3에 연결하고, W5500 Ethernet을 통해 Home Assistant에서 제어하는 ESPHome 프로젝트입니다. Waveshare ESP32-S3-ETH 보드와 IEEE 802.3af PoE를 사용하며, Home Assistant에는 garage-door cover, light, 상태 및 diagnostic entity를 제공합니다. 

이 프로젝트는 단순 relay로 차고문 스위치를 대신 누르는 구조가 아닙니다. ESP32-S3의 custom ESPHome component가 기존 Hörmann HCP1 accessory BUS와 직접 통신하고, W5500은 이 controller를 local Ethernet network와 Home Assistant에 연결합니다. 프로젝트는 물리적 UAP1 module이나 cloud service, 별도의 두 번째 MCU 없이 동작하는 것을 목표로 합니다. 

실제 검증 범위는 Hörmann SupraMatic E2 Series 2/HCP1-era 설치 한 대이며, open/close/stop, light, BUS 기반 상태 확인, time-based position estimation, diagnostics 및 Ethernet OTA가 테스트되었습니다. 

Technical Architecture

전체 데이터 흐름은 다음과 같이 정리할 수 있습니다.

Hörmann SupraMatic E2 BUS/HCP1
→ isolated RS-485
→ ESP32-S3
→ SPI
→ W5500
→ Ethernet
→ ESPHome native API
→ Home Assistant
→ HomeKit Bridge
→ Apple Home

Field side와 IP network side가 분리되어 있다는 점이 이 구조의 핵심입니다. Hörmann 장비와의 통신은 GPIO16/17의 UART와 isolated RS-485 adapter가 담당하고, Home Assistant 연결은 GPIO9~14에 연결된 W5500이 담당합니다. 

위치 제어도 흥미로운 구현 포인트입니다. SupraMatic E2 BUS에서 신뢰할 수 있는 연속 위치값을 직접 얻기 어렵기 때문에 프로젝트는 측정된 이동 시간과 motion curve를 이용합니다. 기본 configuration에는 open_duration: 10215ms, close_duration: 18565ms와 시작·종료 지연 및 intermediate stop model 계수가 포함되어 있습니다.

WIZnet Role in This Project

이 프로젝트에서 W5500은 Hörmann protocol을 처리하는 칩이 아니라 ESP32-S3 기반 controller의 wired IP network interface입니다. configs/supramatic-e2.yaml에는 ethernet: type: W5500이 직접 선언되어 있으며 SPI clock, MOSI/MISO, chip select뿐 아니라 interrupt와 reset pin까지 지정되어 있습니다. 

역할을 나누면 구조가 더 명확합니다.

Field side:
Hörmann HCP1/BUS → isolated RS-485 → ESP32-S3

Network side:
ESP32-S3 → SPI → W5500 → Ethernet → ESPHome / Home Assistant

첫 firmware 설치는 USB-C로 진행할 수 있으며 이후에는 supramatic-e2.local을 대상으로 Ethernet OTA update를 수행할 수 있습니다. 따라서 W5500 network path는 Home Assistant의 상태·제어 통신뿐 아니라 설치 이후 firmware maintenance에도 사용됩니다. 

이 구조는 RS-485 기반 legacy equipment와 Ethernet 기반 smart-home network를 하나의 ESP32-S3에서 연결하는 hybrid interface 사례로 볼 수 있습니다. 다만 공개 코드에서는 WIZnet ioLibrary나 W5500 native socket API를 application이 직접 사용하는 근거가 확인되지 않으므로, 이 프로젝트를 native TCP/IP socket offload 구현 사례로 해석하기보다는 ESPHome의 W5500 Ethernet interface를 활용한 application으로 보는 것이 정확합니다.

Developer Takeaways

• ESP32-S3 + W5500의 실제 ESPHome configuration을 참고할 수 있습니다. configs/supramatic-e2.yaml에는 W5500의 CLK GPIO13, MOSI GPIO11, MISO GPIO12, CS GPIO14, INT GPIO10, RESET GPIO9가 모두 정의되어 있어 SPI Ethernet hardware를 ESPHome에 연결하는 구체적인 예제가 됩니다. 
• RS-485 field interface와 Ethernet network interface를 분리하는 설계 패턴을 확인할 수 있습니다. Hörmann BUS는 19200 baud 8N1 UART와 isolated RS-485를 사용하고, IP network는 W5500을 사용합니다. UART/RS-485 기반 장비를 wired Home Assistant endpoint로 전환할 때 재사용하기 좋은 architecture입니다. 
• ESPHome custom component를 실제 proprietary/legacy protocol에 적용한 구조를 확인할 수 있습니다. components/uapbridge_esp가 BUS communication을 Home Assistant의 garage cover, light, binary sensor 등의 entity와 연결합니다. 단순 network demo보다 실제 제품 integration을 설계할 때 참고 가치가 높은 부분입니다. 
• Ethernet을 firmware maintenance path로도 활용합니다. 첫 USB flash 이후 uv run esphome upload configs/supramatic-e2.yaml --device supramatic-e2.local 방식으로 Ethernet OTA를 수행할 수 있어 고정 설치 장치의 firmware 관리 구조를 참고할 수 있습니다. 
• 실측 기반 position estimation 구현도 별도의 reference가 됩니다. 프로젝트에는 ArUco marker, phone video, HCP/BUS log를 이용한 calibration workflow와 measured motion curve가 포함되어 있습니다. 장비가 연속 위치 센서를 직접 제공하지 않을 때 상태 정보와 시간 기반 모델을 결합하는 접근을 보여줍니다. 

Related Maker Content and Application Value

WIZnet Maker Site의 esphome-haierac-ethernet은 이번 프로젝트와 가장 가까운 application architecture를 보여줍니다. Haier 에어컨과 ESP32-C3 사이에서는 UART/SmartAir2를 사용하고, Home Assistant network에는 W5500 Ethernet을 사용하는 구조입니다. 즉 legacy appliance interface → ESP32 → W5500 → Home Assistant라는 기본 패턴이 유사합니다. (Maker Site: https://maker.wiznet.io/mason/projects/esphome-haierac-ethernet/)

차이점은 field side입니다. Haier 사례는 air conditioner의 UART/SmartAir2를 처리하지만, SupraMatic E2 프로젝트는 isolated RS-485와 reverse-engineered HCP1 accessory BUS를 사용합니다. 두 프로젝트를 함께 보면 서로 다른 legacy appliance protocol을 W5500 기반 wired Home Assistant endpoint로 변환하는 공통 설계 패턴을 확인할 수 있습니다.

Satellite1 PoE SHOE도 ESP32-S3 + W5500 + ESPHome + Home Assistant라는 조합에서 비교 가치가 있습니다. 이 프로젝트는 W5500 wired Ethernet과 PoE를 Home Assistant voice/multisensor endpoint에 적용하기 때문에 hardware/network 구성은 유사하지만, SupraMatic 프로젝트는 RS-485 garage-door controller라는 점에서 application layer가 다릅니다. (Maker Site: https://maker.wiznet.io/Aimee0/projects/satellite1-esphome/)

이 사례들을 함께 보면 다음과 같은 재사용 가능한 Ethernet smart-home architecture가 나타납니다.

Legacy Device / Sensor / Field Interface
→ ESP32
→ W5500
→ Wired Ethernet
→ ESPHome
→ Home Assistant

FAQ

Q. W5500이 Hörmann HCP1 protocol을 직접 처리하나요?

아닙니다. HCP1/BUS communication은 ESP32-S3와 isolated RS-485 interface가 담당하고, W5500은 ESP32-S3를 Ethernet network와 Home Assistant에 연결합니다. 두 interface의 역할은 hardware와 configuration에서 명확하게 분리되어 있습니다. (GitHub: https://github.com/xuio/hoermann-supramatic-e2-esphome)

Q. 이 프로젝트에서 Wi-Fi 없이 Home Assistant를 사용할 수 있나요?

SupraMatic E2용 main configuration은 Waveshare ESP32-S3-ETH의 W5500 Ethernet을 사용하며 Home Assistant entity는 ESPHome native API를 통해 제공됩니다. 첫 USB flash 이후 firmware도 Ethernet을 통해 OTA update할 수 있습니다. (GitHub: https://github.com/xuio/hoermann-supramatic-e2-esphome)

Q. 다른 RS-485 장치에도 같은 구조를 적용할 수 있나요?

W5500 Ethernet configuration, ESP32-S3에서 field/network interface를 분리하는 방법, ESPHome entity 및 OTA 구조는 재사용 가능한 설계 포인트입니다. 다만 uapbridge_esp는 Hörmann HCP1/UAP1 동작에 특화되어 있으므로 다른 장비에서는 해당 장비의 protocol 처리 component가 별도로 필요합니다. (GitHub: https://github.com/xuio/hoermann-supramatic-e2-esphome)

Q. Verified Scope and Sources

2026년 8월 13일 확인한 GitHub 공개 페이지에는 repository가 3 Stars, 0 Forks, 1 open Issue, 151 Commits로 표시되어 있습니다. Repository는 public firmware Release를 제공하며 GitHub Actions가 HCP1 SupraMatic E2와 HCP2 Series 4 tester의 firmware artifact를 생성하는 구조입니다.

현재 공개 자료에서 W5500, ESP32-S3, SPI pin map, isolated RS-485, 19200 baud 8N1, HCP1/BUS, ESPHome native API, IEEE 802.3af PoE, Ethernet OTA 및 time-based position control은 확인됩니다. 반면 WIZnet native socket API/ioLibrary 직접 사용, 일반화된 network 성능 수치, 상용 제품 인증 등은 현재 공개 자료 기준으로 확인되지 않습니다.

또한 repository에는 ESP32-C6 기반 Series 4/HCP2 개발 코드가 포함되어 있지만, 공개 README는 이를 simulation/bench-development 단계로 구분합니다. 따라서 현재 실제 application reference로 가장 명확한 범위는 SupraMatic E2 Series 2/HCP1 + ESP32-S3 + W5500 구성입니다. 

이 프로젝트의 핵심 가치는 W5500을 단순 Ethernet 예제에 사용하는 데 있지 않습니다. 실제 RS-485 기반 legacy equipment를 ESP32-S3에서 처리하고, W5500을 통해 ESPHome/Home Assistant의 wired endpoint로 전환하는 완성도 높은 application architecture를 공개하고 있다는 점이 중요합니다. 구체적인 SPI/UART pin map, custom component, position calibration, PoE 및 Ethernet OTA까지 확인할 수 있어 ESP32-S3 + W5500 기반 smart-home controller를 설계하는 개발자가 참고하기 좋은 실제 구현 사례입니다.