Wiznet makers

Overview

WaterFlowKit V2는 최대 4개의 water flow sensor를 연결해 개별 배관의 유량과 누적 사용량을 측정하고, ESPHome을 통해 Home Assistant 또는 SmartHomeShop cloud로 전달하는 water monitoring device입니다. V2는 ESP32-C6를 MCU로 사용하며, Ethernet firmware에서는 WIZnet W5500을 SPI로 연결해 wired Ethernet network path를 구성합니다. 

WaterFlowKit V1은 Wi-Fi와 2개의 flow input을 지원하지만, V2는 ESP32-C6 기반으로 변경되면서 4개의 flow input과 Ethernet option을 제공합니다. SmartHomeShop 공식 문서에서도 V2의 Ethernet interface가 W5500 기반임을 명시하고 있습니다.

이 프로젝트에서 흥미로운 부분은 단순히 W5500을 추가했다는 점보다 sensor application logic과 network configuration을 ESPHome package로 분리했다는 것입니다. base.yaml에 flow measurement와 공통 기능을 두고 eth.yaml, wifi.yaml, thread.yaml에서 network layer를 선택하기 때문에 동일한 sensor logic을 서로 다른 network path에서 재사용할 수 있습니다. 

Technical Architecture

WaterFlowKit V2의 실제 configuration은 ESPHome YAML 중심으로 공개되어 있습니다. ESP32-C6는 ESP-IDF framework로 구성되며, Ethernet variant는 waterflowkit-v2/eth.yaml의 ESPHome ethernet: component에서 type: W5500을 지정합니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/base.yaml, GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/eth.yaml)

Local Ethernet path는 다음과 같이 정리할 수 있습니다.

Hall Flow Sensor
→ ESP32-C6 pulse_counter
→ W5500 SPI
→ Ethernet
→ ESPHome native API
→ Home Assistant

base.yaml에는 Flow 1~4가 pulse_counter로 구현되어 있으며 GPIO7, GPIO1, GPIO10, GPIO11을 사용합니다. 각 input은 pulse를 L/min 단위로 변환하고 누적 사용량을 total_increasing water sensor로 제공합니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/base.yaml)

Cloud firmware에서는 마지막 구간만 달라집니다.

Flow / Temperature Data
→ ESP32-C6
→ W5500
→ Ethernet
→ HTTPS REST
→ api.smarthomeshop.io

cloud.yaml은 MQTT가 아니라 ESPHome http_request를 사용하며, device registration과 data ingestion에 각각 /api/v1/devices/register, /api/v1/devices/ingest endpoint를 사용합니다. 같은 cloud layer가 Wi-Fi와 Ethernet firmware 양쪽에서 사용되도록 구성되어 있습니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/cloud.yaml)

WIZnet Role in This Project

W5500은 ESP32-C6와 SPI로 연결되는 WaterFlowKit V2의 wired network interface입니다. eth.yaml에는 clk_pin, mosi_pin, miso_pin, cs_pin뿐 아니라 interrupt_pin과 reset_pin까지 명시되어 있으며, 별도의 GPIO8 power switch를 boot 시 활성화하도록 구성합니다. 

특히 Ethernet 설정이 sensor application에서 분리되어 있다는 점이 중요합니다. waterflowkit-ethernet.yaml은 base.yaml + eth.yaml + diagnostics.yaml을 조합하고, waterflowkit-ethernet-cloud.yaml은 base.yaml + eth.yaml + cloud.yaml을 조합합니다. 따라서 flow measurement logic을 수정하지 않고 local Ethernet과 cloud-connected Ethernet product variant를 구성할 수 있습니다. 

또한 Wi-Fi와 Ethernet은 동시에 사용하는 failover 구조가 아닙니다. WaterFlowKit은 Wi-Fi, Ethernet, Wi-Fi Cloud, Ethernet Cloud firmware를 구분하며 Home Assistant의 firmware selector를 통해 해당 update manifest를 변경할 수 있습니다. SmartHomeShop 공식 network documentation도 Ethernet과 Wi-Fi를 별도 firmware variant로 설명합니다.

W5500의 Hardwired TCP/IP socket offload를 이 프로젝트에서 직접 사용한다는 근거는 현재 공개 configuration에서 확인되지 않습니다. 따라서 이 사례에서 W5500의 역할은 확인 가능한 범위인 ESPHome/ESP-IDF 환경의 SPI Ethernet interface로 보는 것이 정확합니다.

Developer Takeaways

• Network layer를 application logic에서 분리하는 ESPHome package 구조를 참고할 수 있습니다. base.yaml에는 sensor와 공통 application logic을 유지하고 Ethernet 관련 설정은 eth.yaml로 분리합니다. 같은 application을 Wi-Fi, Ethernet, Thread variant로 관리해야 하는 제품에서 유용한 패턴입니다. 
• ESP32-C6 + W5500의 실제 ESPHome SPI pin configuration을 확인할 수 있습니다. W5500은 GPIO20/18/19/21의 SPI와 GPIO12 INT, GPIO13 RESET으로 구성되고 Ethernet power control에는 GPIO8을 사용합니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/eth.yaml)
• Pulse sensor를 Home Assistant Ethernet sensor node로 구성하는 방법을 참고할 수 있습니다. 4개의 pulse_counter input에서 현재 L/min과 누적 L 값을 생성한 뒤 ESPHome API를 통해 Home Assistant로 전달하는 전체 path가 공개 YAML에 포함되어 있습니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/base.yaml)
• Local과 cloud firmware가 network interface를 공유하는 방법도 참고할 수 있습니다. Ethernet cloud variant는 W5500 network package 위에 cloud.yaml을 추가하며, HTTPS REST와 Bearer token을 이용해 raw pulse 및 environmental data를 전송합니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/cloud.yaml)
• ESP32-C6의 resource 제약을 configuration 단계에서 관리하는 사례도 확인할 수 있습니다. 프로젝트는 I2C에서 scan: false를 사용하고, 사용하지 않는 BLE 5.0 feature를 비활성화하며, cloud variant에서는 flash 사용량을 고려해 diagnostics package를 제외합니다. (GitHub: https://github.com/smarthomeshop/waterflowkit/blob/main/waterflowkit-v2/base.yaml)

Related Maker Content and Application Value

Maker Site의 ESPHome-W5500-Ethernet-on-ESP32-boards는 ESP32-C3에서 ESPHome ethernet: type: W5500을 구성하고 이후 ESP-IDF framework에서도 동작시키는 사례입니다. WaterFlowKit과 마찬가지로 ESPHome configuration에서 W5500을 직접 선언한다는 점이 유사하지만, WaterFlowKit은 이를 실제 4-channel water monitoring product의 firmware architecture에 적용한다는 차이가 있습니다. (Maker Site: https://maker.wiznet.io/Benjamin/projects/esphome-w5500-ethernet-on-esp32-boards-1/)

Satellite1 PoE SHOE는 ESP32-S3 + W5500 + ESPHome + Home Assistant라는 wired smart-home architecture를 보여줍니다. Satellite1이 voice와 environmental sensing에 초점을 맞춘다면 WaterFlowKit은 ESP32-C6에서 pulse-based water measurement와 network variant separation을 보여주므로, 두 사례를 함께 보면 W5500 Ethernet을 서로 다른 Home Assistant endpoint device에 적용하는 방법을 비교할 수 있습니다. (Maker Site: https://maker.wiznet.io/Aimee0/projects/satellite1-esphome/)

또한 W5500-EVB-Pico + ESPHome 사례는 RP2040 + W5500에서 ESPHome을 사용한다는 점에서 플랫폼 확장 방향을 보여줍니다. WaterFlowKit은 ESPHome이 기본적으로 지원하는 ESP32 계열에서 W5500을 실제 제품 configuration에 적용했다는 차이가 있어, 개발보드 수준의 Ethernet enablement에서 product-level sensor application으로 이어지는 비교 자료가 됩니다. (Maker Site: https://maker.wiznet.io/lawrence/projects/w5500-evb-pico-esphome-1/)

FAQ

Q1. WaterFlowKit V2에서 W5500은 어떤 역할을 하나요?

W5500은 ESP32-C6와 SPI로 연결되어 Ethernet network interface를 제공합니다. Local firmware에서는 이 경로를 통해 ESPHome native API로 Home Assistant와 연결하고, cloud firmware에서는 HTTPS REST traffic도 같은 Ethernet path를 사용합니다. 

Q2. Wi-Fi와 Ethernet을 동시에 사용하는 Hybrid 구조인가요?

아닙니다. 공개된 configuration에서는 Wi-Fi, Ethernet, Thread가 각각 별도의 firmware variant이며, Home Assistant의 firmware selector가 선택된 variant에 맞는 OTA manifest를 지정합니다. Ethernet과 Wi-Fi가 동시에 동작하는 network failover 구조는 현재 공개 자료에서 확인되지 않습니다. 

Q3. 이 프로젝트에서 가장 재사용하기 좋은 설계 포인트는 무엇인가요?

base.yaml의 sensor/application logic과 eth.yaml, wifi.yaml, thread.yaml의 network layer를 분리한 package architecture입니다. 이 방식은 동일한 ESPHome application을 유지하면서 wired Ethernet과 다른 network variant를 별도 제품 또는 firmware configuration으로 관리할 때 참고할 수 있습니다. 

Verified Scope and Sources

확인된 repository snapshot 기준 V2 software version은 2.14.0, main commit은 0659221(2026-08-05)이며 55 commits가 확인되었습니다. 현재 공개 자료에서 W5500의 SPI Ethernet 구성, ESP32-C6, 4-channel flow input, Home Assistant local path와 HTTPS cloud path는 확인할 수 있지만, W5500 socket offload 사용 여부, schematic/PCB/BOM, throughput·latency 등의 성능 수치는 확인되지 않습니다.

WaterFlowKit V2의 핵심 가치는 W5500을 단순히 Ethernet interface로 추가한 것보다, 실제 ESPHome 기반 제품에서 sensor application과 network layer를 분리해 wired Ethernet variant를 구성한 구현 사례라는 데 있습니다. ESP32-C6 + W5500 조합뿐 아니라, ESPHome 기반 sensor node를 Home Assistant에 유선으로 연결하거나 동일 application을 여러 network variant로 관리하려는 개발자에게 재사용 가능한 구조를 보여줍니다.