---
title: "eBUS Adapter Shield v5"
url: "https://maker.wiznet.io/gunn/projects/ebus-adapter-shield-v5/"
markdown_url: "https://maker.wiznet.io/gunn/projects/ebus-adapter-shield-v5/md"
type: "UCC: User Created Content"
author: "gunn"
author_url: "https://maker.wiznet.io/gunn/"
original_url: "https://adapter.ebusd.eu/v5/ideas.html"
published: "2026-03-06"
language: "en"
hardware: ["WIZnet W5500"]
likes: 0
views: 459
comments: 0
source: "WIZnet Makers (https://maker.wiznet.io/)"
---

# eBUS Adapter Shield v5

> eBUS Adapter Shield v5

Original source: https://adapter.ebusd.eu/v5/ideas.html

## Components

- **WIZnet W5500** x 1 ([docs](https://docs.wiznet.io/Product/Chip/Ethernet/W5500))

WIZnet parts: W5500 ([Datasheet](https://docs.wiznet.io/Product/Chip/Ethernet/W5500/datasheet?utm_source=maker&utm_medium=project&utm_campaign=w5500), [product hub](https://maker.wiznet.io/products/w5500/))

## Article

In a nutshell, this project is about "connection devices and software that allow data from a heating system (eBUS) to be read and controlled from a computer or smart home network."

Here's a summary of the main features:

1. Hardware
Heater Connection: An adapter for connecting to a boiler or heating system using the eBUS protocol.

Various Installation Options: 3D printer case drawings (Thingiverse, Printables) and an industrial Hutschienengehäuse (DIN rail) case installation guide are provided.

Network Expansion: Adding an Ethernet (USR-ES1, W5500 module) enables wired network connection.

2. Software and Features (Firmware)
Sensor Support: Connect a temperature sensor (DS18B20) to monitor real-time temperatures via the UI or API (http://<address>/api/v1/pin).

MQTT Integration: Supports MQTT, a smart home standard, to transmit adapter status, signal strength, power consumption, and other information to external systems.

Development Status: Output pin control and display functionality are currently under development.

3. Technical Features
easi> and micro-ebusd: Dedicated firmware and protocols are used to drive and communicate with the adapter.

Self-diagnosis: Includes hardware monitoring functions, such as measuring the device's own 5V power consumption.

===

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919398%2Epng)

이 문서는 eBUS 어댑터 쉴드 v5에 대한 설명으로, eBUS를 지원하는 난방, 환기 또는 태양열 시스템과의 통신을 가능하게 합니다.

이 문서는 “eBUS Adapter Shield v5”라는 하드웨어 프로젝트의 개요 페이지.
시스템(eBUS)을 네트워크로 연결해서 데이터를 읽고 제어하려는 장치입니다.

eBUS 난방 시스템과 통신하는 하드웨어 어댑터입니다.

eBUS : 유럽 난방기(보일러, 히트펌프 등)에서 사용하는 통신 버스
예: Vaillant 같은 난방 시스템

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919181%2Epng)

RISC 아키텍처 기반의 ESP32-C3를 사용함

이 장치는: ➡️ 난방 시스템(eBUS) ↔ 네트워크/컴퓨터를 연결해주는 인터페이스(어댑터) 입니다.

한 마디로 요약하자면, 이 프로젝트는 "난방 시스템(eBUS 방식)의 데이터를 컴퓨터나 스마트홈 네트워크에서 읽고 제어할 수 있게 해주는 연결 장치와 소프트웨어"에 관한 것입니다.

주요 내용을 요약해 드립니다.

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919296%2Epng)

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919320%2Epng)

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919146%2Epng)

1. 하드웨어 관련 (Hardware)
난방기 연결: eBUS 프로토콜을 사용하는 보일러나 난방 시스템에 연결하는 어댑터입니다.

다양한 설치 옵션: 3D 프린터용 케이스 도면(Thingiverse, Printables)과 산업용 Hutschienengehäuse(DIN 레일) 케이스 설치 가이드를 제공합니다.

네트워크 확장: Ethernet(USR-ES1, W5500 모듈)을 추가하여 유선 네트워크 연결이 가능합니다.

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919453%2Epng)

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919438%2Epng)

2. 소프트웨어 및 기능 (Firmware)
센서 지원: 온도 센서(DS18B20)를 연결하여 UI나 API(http://<주소>/api/v1/pin)를 통해 실시간 온도를 확인할 수 있습니다.

MQTT 연동: 스마트홈 표준 통신 방식인 MQTT를 지원하여 어댑터 상태, 신호 강도, 전력 소비량 등을 외부 시스템으로 전송합니다.

개발 현황: 현재 출력 핀 제어(Output Pins)나 디스플레이 기능 등은 향후 업데이트 과제로 남아 있습니다.

![](https://maker.wiznet.io/upload/ckeditor5/373871904%5F1772919500%2Epng)

- [펌웨어](https://adapter.ebusd.eu/v5/firmware) 에 특별히 개발된 드라이버 덕분에 시간 지연이 최소화

- eBUS에서 전력 소모 없이 신호를 완벽하게 전기적으로 절연

- 호스트의 ebusd에 대한 유연하고 구성 가능한 연결:
  - 온보드 PCB 안테나를 통한 [Wi-Fi 직접 연결](https://adapter.ebusd.eu/v5/#wifi)
  - 통합 JTAG/시리얼 인터페이스를 통한 [USB 시리얼 통신](https://adapter.ebusd.eu/v5/#usb)
  - GPIO/ttyAMA0을 통한 [라즈베리 파이](https://adapter.ebusd.eu/v5/#rpi)
  - 추가 모듈 USR-ES1 또는 기타 W5500 모듈을 사용한 [이더넷](https://adapter.ebusd.eu/v5/#ethernet)

### 네트워크/데이터 연결

USB, Wi-Fi 및 Raspberry Pi를 통한 연결은 항상 가능합니다. [이더넷](https://adapter.ebusd.eu/v5/#ethernet) 연결을 위해서는 W5500 모듈이 추가로 필요합니다.![](https://maker.wiznet.io/upload/ckeditor5/587678445%5F1772993155%2Epng)

3. 기술적 특징
easi> 및 micro-ebusd: 어댑터를 구동하고 통신하기 위한 전용 펌웨어와 프로토콜을 사용합니다.

자가 진단: 장치 자체의 5V 전력 소비량을 측정하는 등 하드웨어 모니터링 기능이 포함되어 있습니다.

## eBUS 어댑터 실드 인터페이스("easi>")

![](https://maker.wiznet.io/upload/ckeditor5/801486143%5F1773060923%2Epng)

[Q&A]

Q) ebusd 가 뭐하는 프로그램이야?

A) **eBUS 난방 시스템과 통신하기 위한 데몬(daemon) 프로그램**입니다.
즉, **보일러나 난방 시스템의 eBUS 데이터를 읽고 제어할 수 있게 해주는 소프트웨어**입니다.

쉽게 말하면: **eBUS 하드웨어 ↔ 서버/스마트홈 시스템 사이에서 통신을 처리하는 프로그램**

Q) thingiverse 가 뭐야?

A) Thingiverse는 3D 프린팅 커뮤니티의 대표적인 디자인 파일 공유 플랫폼입니다.

Q) DS18B20 가 뭐야?

A) DS18B20은 Dallas Semiconductor(현 Maxim Integrated) 에서 만든 대표적인 디지털 온도 센서입니다.

![](https://maker.wiznet.io/upload/ckeditor5/801486143%5F1773060078%2Epng)

---

Source: https://maker.wiznet.io/gunn/projects/ebus-adapter-shield-v5/