ESPHome ESP8266 장치에 물리적으로 연결하기 사용자 가이드

ESPHome 기반 장치를 Control4에 통합하세요. ESPHome은 ESP8266 및 ESP32와 같은 일반적인 마이크로컨트롤러를 간단한 YAML 구성을 통해 스마트 홈 장치로 변환하는 오픈 소스 시스템입니다. ESPHome 장치는 다음을 사용하여 설정, 모니터링 및 제어할 수 있습니다. web 브라우저, Home Assistant 또는 기타 호환 플랫폼에서 사용할 수 있습니다. 이 드라이버를 사용하면 Control4 시스템에서 직접 ESPHome 장치를 원활하게 모니터링하고 제어할 수 있습니다.

시스템 요구 사항

컨트롤4 OS 3.3+

특징

클라우드 서비스가 필요 없는 로컬 네트워크 통신
장치에서 노출된 모든 지원 엔터티의 실시간 업데이트
장치 암호화 키를 사용하여 암호화된 연결을 지원합니다.
변수 프로그래밍 지원

호환성

확인 된 장치
이 드라이버는 일반적으로 모든 ESPHome 장치에서 작동하지만, 다음 장치에서도 광범위하게 테스트되었습니다.

라트그도 – 구성 안내서

위에 나열된 제품에 이 드라이버를 사용해 보고, 제대로 작동한다면 알려주세요!

지원되는 ESPHome 엔터티

설치 프로그램 설정

ESPHome 장치당 하나의 드라이버 인스턴스만 필요합니다. 동일한 장치에 이 드라이버의 여러 인스턴스를 연결하면 예상치 못한 동작이 발생할 수 있습니다. 하지만 이 드라이버의 여러 인스턴스를 서로 다른 ESPHome 장치에 연결할 수 있습니다.

DriverCentral 클라우드 설정
이미 가지고 있다면 DriverCentral 클라우드 드라이버 프로젝트에 드라이버가 설치되어 있으면 드라이버 설치를 계속할 수 있습니다.

이 드라이버는 DriverCentral Cloud 드라이버를 사용하여 라이선스 및 자동 업데이트를 관리합니다. DriverCentral을 처음 사용하는 경우 해당 드라이버를 참조하세요. 클라우드 드라이버 문서 설정을 위해.

드라이버 설치

드라이버 설치 및 설정은 대부분의 다른 IP 기반 드라이버와 비슷합니다. 편의를 위해 기본 단계를 간략하게 설명했습니다.

최신 버전을 다운로드하세요 control4-esphome.zip ~에서 드라이버센트럴.
추출 및 설치 esphome.c4z, esphome_light.c4z, 그리고 esphome_lock.c4z 운전자.
"검색" 탭을 사용하여 "ESPHome" 드라이버를 찾아 프로젝트에 추가합니다.

"시스템 설계" 탭에서 새로 추가된 드라이버를 선택하세요. 클라우드 상태가 라이선스 상태를 반영하는 것을 확인할 수 있습니다. 라이선스를 구매한 경우 "라이선스 활성화됨"으로 표시되고, 그렇지 않은 경우 "평가판 실행 중"과 남은 평가 기간이 표시됩니다.
"시스템 설계" 탭에서 "DriverCentral Cloud" 드라이버를 선택하고 "드라이버 확인" 작업을 수행하여 라이선스 상태를 새로 고칠 수 있습니다.

구성 장치 설정 연결 정보와 함께.
잠시 후 드라이버 상태가 "연결됨"으로 표시됩니다. 드라이버 연결에 실패하면 로그 모드 속성을 "인쇄"로 설정하고 IP 주소 필드를 재설정하여 다시 연결하세요. 그런 다음 Lua 출력 창에서 자세한 정보를 확인하세요.
연결되면 드라이버는 지원되는 각 엔터티 유형에 대한 변수와 연결을 자동으로 생성합니다.

조명 및/또는 잠금 장치를 제어하려면 "검색" 탭을 사용하여 "ESPHome 조명" 및/또는 "ESPHome 잠금 장치" 드라이버를 찾으세요. 프로젝트에 노출된 조명 또는 잠금 장치 엔티티마다 드라이버 인스턴스를 하나씩 추가하세요. "연결" 탭에서 "ESPHome" 드라이버를 선택하고 조명 또는 잠금 장치 엔티티를 새로 추가된 드라이버에 바인딩하세요.

드라이버 설정

드라이버 속성

클라우드 설정

클라우드 상태
DriverCentral 클라우드 라이선스 상태를 표시합니다.
자동 업데이트
DriverCentral 클라우드 자동 업데이트를 켜거나 끕니다.

드라이버 설정

드라이버 상태(읽기 전용)
드라이버의 현재 상태를 표시합니다.

드라이버 버전(읽기 전용)
드라이버의 현재 버전을 표시합니다.
로그 수준 [ 치명적 | 오류 | 경고 | 정보 | 디버그 | 추적 | Ultra ] 로깅 수준을 설정합니다. 기본값은 다음과 같습니다. 정보.

로그 모드 [끄기 | 인쇄 | 로그 | 인쇄 및 로그] 로깅 모드를 설정합니다. 기본값은 다음과 같습니다. 끄다.

장치 설정

IP 주소
장치 IP 주소를 설정합니다(예: 192.168.1.30). 도메인 이름은 컨트롤러가 접근 가능한 IP 주소로 확인할 수 있는 한 허용됩니다. HTTPS는 지원되지 않습니다.

메모: IP 주소를 사용하는 경우 고정 IP를 할당하거나 DHCP 예약을 만들어 IP 주소가 변경되지 않도록 해야 합니다.

포트
장치 포트를 설정합니다. ESPHome 장치의 기본 포트는 다음과 같습니다. 6053.

인증 모드 [ 없음 | 비밀번호 | 암호화 키 ]
ESPHome 장치에 연결하기 위한 인증 방법을 선택합니다.

없음: 인증이 필요하지 않습니다.

비밀번호: 인증을 위해 비밀번호를 사용하세요(아래 참조).

암호화 키: 안전한 통신을 위해 암호화 키를 사용하세요(아래 참조).

비밀번호
인증 모드가 비밀번호로 설정된 경우에만 표시됩니다. 기기 비밀번호를 설정합니다. 이 비밀번호는 ESPHome 기기에 설정된 비밀번호와 일치해야 합니다.

암호화 키
인증 모드가 암호화 키로 설정된 경우에만 표시됩니다. 보안 통신을 위한 기기 암호화 키를 설정합니다. 이 키는 ESPHome 기기에 구성된 암호화 키와 일치해야 합니다.

장치 정보

이름(읽기 전용)
연결된 ESPHome 장치의 이름을 표시합니다.

모델(읽기 전용)
연결된 ESPHome 장치의 모델을 표시합니다.
제조업체(읽기 전용)
연결된 ESPHome 장치의 제조업체를 표시합니다.

MAC 주소(읽기 전용)
연결된 ESPHome 장치의 MAC 주소를 표시합니다.
펌웨어 버전(읽기 전용)
연결된 ESPHome 장치의 펌웨어 버전을 표시합니다.

운전자 행동

연결 및 변수 재설정

경고: 이렇게 하면 모든 연결 바인딩이 재설정되고 변수와 관련된 모든 프로그래밍이 삭제됩니다.

드라이버 연결 및 변수를 재설정합니다. 연결된 ESPHome 장치를 변경하거나 오래된 연결 또는 변수가 있는 경우 유용합니다.

ratgdo 구성 가이드

이 가이드에서는 Control4 Composer Pro의 릴레이를 통해 차고 문을 제어하기 위해 ratgdo 장치와 함께 작동하도록 ESPHome 드라이버를 구성하는 방법에 대한 지침을 제공합니다.

릴레이 컨트롤러 드라이버 추가
Composer Pro에서 Control4 프로젝트에 원하는 릴레이 컨트롤러 드라이버를 추가합니다.

릴레이 컨트롤러 속성
ratgdo 장치는 ESPHome에서 "Cover" 엔티티를 노출하는데, 이는 Control4의 릴레이 컨트롤러 기능에 매핑됩니다.

릴레이 수
ratgdo 장치는 다중 릴레이 구성을 사용하여 차고 문을 제어합니다. Composer Pro에서 릴레이 설정을 다음과 같이 구성해야 합니다.

2개의 릴레이(열림/닫힘) 또는 3개의 릴레이(열림/닫힘/중지)로 설정
- ratgdo 장치는 차고 문을 열고 닫는 데 별도의 명령을 사용합니다.
- ratgdo 펌웨어가 "stop" 명령을 지원하는 경우, 정지 기능을 활성화하기 위해 릴레이 3개를 구성하세요. 확실하지 않은 경우, Composer Pro에서 ratgdo 연결을 확인하여 "Stop Door" 릴레이를 사용할 수 있는지 확인하세요.

릴레이 구성

설정하다 맥박
- ratgdo는 벽 버튼을 누르는 것과 유사하게 차고 문 오프너를 작동시키기 위해 순간적인 펄스를 사용합니다.

펄스 시간

모든 릴레이 펄스 시간을 다음과 같이 설정합니다. 500 (기본)
- 이것은 릴레이가 활성화되는 기간입니다.

인버트 릴레이

모든 반전 릴레이 속성을 다음으로 설정하세요. 아니요 (기본)

Debounce에 문의하세요

모든 연락처 디바운스 시간을 다음과 같이 설정합니다. 250 (기본)
- 이는 차고 문 상태 센서의 잘못된 펄럭임을 방지하는 데 도움이 됩니다.

연락처 반전

모든 반전 연락처 속성을 다음으로 설정하세요. 아니요 (기본)

Examp르 프로퍼티
참고로, 여기에 예가 있습니다.ampComposer Pro의 릴레이 컨트롤러 속성:

릴레이 컨트롤러 연결

릴레이

열려 있는: ratgdo의 "Open Door" 릴레이에 연결하세요
닫다: ratgdo의 "문 닫기" 릴레이에 연결하세요
중지: 가능한 경우 ratgdo의 "Stop Door" 릴레이에 연결하세요.

접촉 센서

폐쇄된 연락처: ratgdo의 "문 닫힘" 연락처에 연결하세요
열린 연락처: ratgdo의 "Door Open" 연락처에 연결하세요

Examp르 커넥션
참고로, 여기에 예가 있습니다.ampComposer Pro에서 연결이 어떻게 보여야 하는지에 대한 설명:

프로그램 작성
Control4에서 프로그래밍을 생성하여 다음을 수행할 수 있습니다.

이벤트에 따라 차고 문을 열거나 닫습니다.
차고 문 상태 모니터링
차고 문 상태 변경에 대한 알림 설정
터치스크린과 리모컨에 사용자 정의 버튼 만들기

Example: 아직 열려 있는 알림 만들기

릴레이 컨트롤러 드라이버의 "Still Open Time" 속성 사용:

"Still Open Time"을 원하는 기간(예: 10분)으로 설정합니다.
"Still Open" 이벤트가 발생할 때 트리거되는 프로그래밍 규칙을 만듭니다.
알림을 보내거나 다른 작업을 수행하기 위한 작업을 추가합니다.

추가 엔터티
ratgdo 장치, 펌웨어 및 해당 기능에 따라 ESPHome 드라이버에서 노출되는 추가 엔터티가 있을 수 있습니다. 이는 추가 연결 또는 드라이버 변수의 형태로 제공될 수 있습니다.

특정 엔터티에 대한 자세한 내용은 ratgdo 문서를 참조하세요. https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

개발자 정보
저작권 © 2025 Finite Labs LLC
본 문서에 포함된 모든 정보는 Finite Labs LLC 및 해당 공급업체(있는 경우)의 자산이며, 앞으로도 계속 소유합니다. 본 문서에 포함된 지적 및 기술적 개념은 Finite Labs LLC의 독점 재산입니다.
Finite Labs LLC와 그 공급업체는 미국 및 해외 특허, 특허 출원 중일 수 있으며, 영업비밀 또는 저작권법의 보호를 받습니다. Finite Labs LLC의 사전 서면 허가 없이는 본 정보의 배포 또는 복제는 엄격히 금지됩니다. 최신 정보는 다음 웹사이트를 참조하십시오. https://drivercentral.io/platforms/control4-drivers/utility/esphome

지원하다
이 드라이버를 Control4 또는 ESPHome과 통합하는 데 질문이나 문제가 있는 경우 다음 주소로 문의해 주십시오. driver-support@finitelabs.com 또는 +1로 전화/문자 주세요 949-371-5805.

변경 로그

v20250715 – 2025년 07월 14일

결정된: 연결 시 엔티티가 검색되지 않는 버그가 수정되었습니다.

v20250714 – 2025년 07월 14일

추가됨: 장치 암호화를 사용하여 암호화된 연결에 대한 지원이 추가되었습니다.

v20250619 – 2025년 06월 19일

추가됨 : ratgdo 관련 문서 추가

v20250606 – 2025년 06월 06일

추가됨 :최초 출시

자주 묻는 질문

이 드라이버와 호환되는 장치는 무엇입니까?

이 드라이버는 모든 ESPHome 기기와 호환되며, ratgdo 기기에서 광범위한 테스트를 거쳤습니다. 다른 기기에서 사용해 보시고 제대로 작동하시면, 확인을 위해 저희에게 알려주세요.

문서 / 리소스

ESPHome ESP8266 장치에 물리적으로 연결 [PDF 파일] 사용자 가이드
ESP8266, ESP32, ESP8266 장치에 물리적으로 연결, ESP8266, 장치에 물리적으로 연결, 장치에 연결, 장치에, 장치에 연결

참고문헌

사용자 설명서

ESPHome ESP8266 장치에 물리적으로 연결

명세서

위에view