ESPHome 입문 가이드 - 로컬 스마트홈 기기를 만드는 가장 쉬운 방법

ESPHome이란 무엇인가?

ESPHome은 ESP32나 ESP8266 같은 마이크로컨트롤러를 이용해 나만의 스마트홈 기기를 쉽게 만들 수 있도록 도와주는 시스템입니다.

​

핵심 개념은 아주 단순합니다.

복잡한 코딩 대신 설정 파일(YAML)만 작성하면 자동으로 펌웨어를 만들어줍니다.

즉, ESPHome은 일종의 스마트 기기 생성기(Smart Device Generator)라고 볼 수 있습니다.

​

ESPHome의 공식 사이트

https://esphome.io/

ESPHome

ESPHome의 배경 (왜 등장했을까?)

기존 스마트홈 기기들은 대부분 다음과 같은 문제를 가지고 있습니다.

• 제조사 클라우드에 의존 (서버 장애 시 기기 작동 불가)
• 개인정보 및 데이터 외부 전송
• 구독형 서비스 비용
• 커스터마이징 어려움

이 문제를 해결하기 위해 등장한 것이 ESPHome과 Home Assistant입니다.

​

Home Assistant란?

Home Assistant는 다양한 스마트 기기들을 하나로 통합하고 자동화를 구성할 수 있는 오픈소스 스마트홈 플랫폼입니다.

​

ESPHome으로 만든 기기들을 Home Assistant에 연결하면, 앱이나 웹에서 상태를 확인하고 자동화를 설정할 수 있습니다.

​

Home Assistant 공식 사이트

https://www.home-assistant.io/

ESPHome은 특히 Home Assistant와 함께 사용할 때 진가를 발휘합니다.

​

ESPHome을 사용하는 이유

1. 개인정보 보호 (Privacy)
2. 모든 데이터가 로컬 네트워크 안에서만 동작합니다. 외부 서버로 전송되지 않습니다.
3. 높은 안정성 (Reliability)
4. 인터넷이 끊겨도, 제조사 서버가 다운되어도 기기는 계속 정상 작동합니다.
5. 낮은 비용 (Cost)
6. 시중 제품 대비 훨씬 저렴하고, 구독료가 없으며, 원하는 기능만 구현할 수 있습니다.

​

준비물 및 초기 설정

필요한 하드웨어

• ESP32 또는 ESP8266 보드

​

하드웨어 구성 팁

브레드보드를 사용할 수도 있지만 ESP32는 폭이 넓어서 불편할 수 있습니다.

​

해결 방법

• 프로토타입 보드 사용
• 확장 핀 헤더 사용

​

전원 안전 주의

절대 두 개의 전원을 동시에 연결하지 마세요.

예: USB + 외부 전원 → 위험

외부 전원을 사용할 경우 USB 연결 전에 반드시 분리해야 합니다.

​

Home Assistant에 ESPHome 설치

1. Add-on Store 접속
2. ESPHome 설치
3. 아래 옵션 활성화 추천

• Start on boot
• Show in sidebar

​

최초 펌웨어 설치 (First Flash)

처음에는 반드시 USB로 연결해야 합니다.

이유: 기기에 아직 Wi-Fi 연결 기능이 없기 때문입니다.

​

SSL 문제 (중요)

브라우저에서 Web Serial을 사용하려면 HTTPS(SSL)가 필요합니다.

해결 방법

• ESPHome Web Installer 사용
• 또는 Manual Download 방식 사용

​

Manual Download 방법

1. ESPHome 대시보드에서 노드 생성
2. Install → Manual Download 선택
3. .BIN 파일 생성
4. ESPHome Web Tool로 USB 업로드

​

이후 업데이트

최초 설치 이후에는 OTA(무선 업데이트)가 가능합니다.

즉, 이후부터는 USB 연결이 필요 없습니다.

​

설정 파일 (YAML)

ESPHome은 YAML 파일로 모든 동작을 정의합니다.

코드 작성이 필요 없고 대부분 복사해서 사용할 수 있습니다.

​

기본 설정

• 디바이스 이름
• 보드 종류
• Wi-Fi 정보

secrets.yaml 사용

비밀번호 같은 민감 정보는 별도 파일에 저장합니다.

​

장점

• 보안 강화
• 설정 공유 가능

​

프레임워크 선택

• ESP-IDF (기본, 최신)
• Arduino (호환성 좋음)

특정 라이브러리가 필요하면 Arduino를 사용하는 것이 좋습니다.

​

센서 및 출력 추가

ESPHome의 강력한 기능은 다양한 센서를 쉽게 추가할 수 있다는 점입니다.

​

주요 예제

움직임 센서 (PIR)

• binary_sensor로 정의
• 필터
• delayed_on (오동작 방지)
• delayed_off (조명 유지)

​

온습도 센서 (AHT20)

• I2C 사용
• ESP32 기본 핀
• SDA: 21
• SCL: 22

​

거리 센서 (HC-SR04)

• Trigger / Echo 핀 사용
• 거리 값을 meter 단위로 반환

​

조도 센서 (BH1750)

• I2C 센서
• 여러 센서와 핀 공유 가능

​

터치 센서 (TTP223)

• 정전식 입력
• 버튼처럼 사용 가능

​

LED (WS2812B)

• 색상 / 밝기 제어 가능
• light 컴포넌트로 정의

​

로컬 자동화 (핵심 기능)

ESPHome의 진짜 강력함은 칩 내부에서 자동화를 실행하는 것입니다.

​

장점

• 빠름 (서버를 거치지 않음)
• 안정적 (Wi-Fi가 끊겨도 동작)

​

예제

터치 센서를 누르면 LED ON/OFF 토글

on_click:

• light.toggle: my_led

​

유지보수 (디바이스 삭제 방법)

ESPHome에서 기기를 삭제할 때는 순서를 반드시 지켜야 합니다.

올바른 삭제 순서

1. Home Assistant에서 Integration 삭제
2. Home Assistant 재시작
3. ESPHome에서 노드 삭제

​

이유

이 순서를 지키지 않으면

고아 엔티티(orphan entity)가 발생하고 이상한 연결 문제가 생길 수 있습니다.

​

마무리

ESPHome은 단순한 IoT 도구가 아니라 내가 원하는 스마트홈 시스템을 직접 만드는 도구입니다.

​

특히

클라우드 의존 없이

빠르고 안정적으로

저렴하게

스마트홈을 구축하고 싶다면 ESPHome은 매우 강력한 선택입니다.