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

위에view
ESPHome 기반 장치를 Control4에 통합하세요. ESPHome은 ESP8266 및 ESP32와 같은 일반적인 마이크로컨트롤러를 간단한 YAML 구성을 통해 스마트 홈 장치로 변환하는 오픈 소스 시스템입니다. ESPHome 장치는 다음을 사용하여 설정, 모니터링 및 제어할 수 있습니다. web 브라우저, Home Assistant 또는 기타 호환 플랫폼에서 사용할 수 있습니다. 이 드라이버를 사용하면 Control4 시스템에서 직접 ESPHome 장치를 원활하게 모니터링하고 제어할 수 있습니다.
색인
시스템 요구 사항 기능 호환성
검증된 장치 지원 ESPHome Entities 설치 프로그램 설정 DriverCentral Cloud 설정 드라이버 설치 드라이버 설정
드라이버 속성 클라우드 설정 드라이버 설정 장치 설정 장치 정보
드라이버 작업 구성 가이드
ratgdo 구성 가이드 개발자 정보 지원 변경 로그

시스템 요구 사항
컨트롤4 OS 3.3+
특징
클라우드 서비스가 필요 없는 로컬 네트워크 통신 장치에서 노출된 모든 지원 엔터티의 실시간 업데이트 장치 암호화 키를 사용하여 암호화된 연결 지원 가변 프로그래밍 지원
호환성
확인 된 장치
이 드라이버는 일반적으로 모든 ESPHome 장치에서 작동하지만, 다음 장치에서도 광범위하게 테스트되었습니다.
ratgdo – 구성 가이드 위에 나열된 제품에서 이 드라이버를 시도해 보고 작동한다면 알려주세요!

지원되는 ESPHome 엔터티

엔티티 유형 알람 제어판 API 노이즈 바이너리 센서 블루투스 프록시 버튼 기후 커버 날짜/시간 날짜 시간 카메라 이벤트 팬 조명 잠금 미디어 플레이어 번호 센서 선택 사이렌 스위치 텍스트 텍스트 센서 업데이트 밸브 음성 지원

지원됨

설치 프로그램 설정
ESPHome 장치당 하나의 드라이버 인스턴스만 필요합니다. 이 인스턴스는 여러 개입니다.
동일한 장치에 연결된 드라이버는 예상치 못한 동작을 일으킬 수 있습니다. 하지만 이 드라이버의 여러 인스턴스를 서로 다른 ESPHome 장치에 연결할 수 있습니다.
DriverCentral 클라우드 설정
프로젝트에 이미 DriverCentral Cloud 드라이버가 설치되어 있는 경우 드라이버 설치를 계속 진행할 수 있습니다.
이 드라이버는 DriverCentral Cloud 드라이버를 사용하여 라이선스 및 자동 업데이트를 관리합니다. DriverCentral을 처음 사용하는 경우, 설정 방법은 해당 Cloud Driver 설명서를 참조하세요.
드라이버 설치
드라이버 설치 및 설정은 대부분의 다른 IP 기반 드라이버와 비슷합니다. 편의를 위해 기본 단계를 간략하게 설명했습니다.
1. DriverCentral에서 최신 control4-esphome.zip을 다운로드합니다.
2. esphome.c4z, esphome_light.c4z, esphome_lock.c4z 드라이버를 추출하여 설치합니다.
3. "검색" 탭을 사용하여 "ESPHome" 드라이버를 찾아 프로젝트에 추가합니다.
Ü ESPHome 장치당 단일 드라이버 인스턴스가 필요합니다.

4. "시스템 설계" 탭에서 새로 추가된 드라이버를 선택합니다. 클라우드 상태가 라이선스 상태를 반영하는 것을 확인할 수 있습니다. 라이선스를 구매한 경우 라이선스 활성화됨으로 표시되고, 그렇지 않은 경우 평가판 실행 중이며 남은 평가 기간이 표시됩니다.
5. "시스템 설계" 탭에서 "DriverCentral Cloud" 드라이버를 선택하고 "드라이버 확인" 작업을 수행하여 라이선스 상태를 새로 고칠 수 있습니다.
6. 연결 정보를 사용하여 장치 설정을 구성합니다. 7. 잠시 후 드라이버 상태가 연결됨으로 표시됩니다. 드라이버가 연결되지 않으면
연결하고, 로그 모드 속성을 인쇄로 설정하고 IP 주소 필드를 재설정하여 다시 연결합니다. 그런 다음 lua 출력 창에서 자세한 정보를 확인합니다. 8. 연결되면 드라이버는 지원되는 각 엔터티 유형에 대한 변수와 연결을 자동으로 생성합니다. 9. 조명 및/또는 잠금 장치를 제어하려면 "검색" 탭을 사용하여 "ESPHome 조명" 및/또는 "ESPHome 잠금" 드라이버를 찾습니다. 프로젝트에 노출된 각 조명 또는 잠금 장치 엔터티에 대해 드라이버 인스턴스를 하나씩 추가합니다. "연결" 탭에서 "ESPHome" 드라이버를 선택하고 조명 또는 잠금 장치 엔터티를 새로 추가된 드라이버에 바인딩합니다.
드라이버 설정
드라이버 속성
클라우드 설정
클라우드 상태: DriverCentral 클라우드 라이선스 상태를 표시합니다. 자동 업데이트: DriverCentral 클라우드 자동 업데이트를 켜거나 끕니다.
드라이버 설정
드라이버 상태(읽기 전용)

드라이버의 현재 상태를 표시합니다.
드라이버 버전(읽기 전용) 드라이버의 현재 버전을 표시합니다.
로그 수준 [ 치명적 | 오류 | 경고 | 정보 | 디버그 | 추적 | 매우 높음 ] 로깅 수준을 설정합니다. 기본값은 정보입니다.
로그 모드 [ 끄기 | 인쇄 | 로그 | 인쇄 및 로그 ] 로깅 모드를 설정합니다. 기본값은 끄기입니다.
장치 설정
IP 주소: 장치 IP 주소(예: 192.168.1.30)를 설정합니다. 도메인 이름은 컨트롤러에서 접근 가능한 IP 주소로 확인 가능한 경우 허용됩니다. HTTPS는 지원되지 않습니다.
IP 주소를 사용하는 경우 고정 IP 주소를 지정하여 변경되지 않도록 해야 합니다.
IP 또는 DHCP 예약 생성. 포트: 장치 포트를 설정합니다. 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 펌웨어가 "정지" 명령을 지원하는 경우, 정지 기능을 활성화하려면 릴레이 3개를 구성하십시오. 확실하지 않은 경우 Composer Pro에서 ratgdo 연결을 확인하여 "문 정지" 릴레이를 사용할 수 있는지 확인할 수 있습니다.
릴레이 구성
펄스로 설정된 ratgdo는 벽 버튼을 누르는 것과 유사하게 차고 문 오프너를 작동시키기 위해 순간적인 펄스를 사용합니다.
펄스 시간
모든 릴레이 펄스 시간을 500(기본값)으로 설정합니다. 이것은 릴레이가 활성화되는 기간입니다.
인버트 릴레이
모든 반전 릴레이 속성을 아니요(기본값)로 설정합니다.
Debounce에 문의하세요
모든 접촉 디바운스 시간을 250(기본값)으로 설정합니다. 이렇게 하면 차고 문 상태 센서의 잘못된 펄럭임을 방지하는 데 도움이 됩니다.
연락처 반전
모든 반전 연락처 속성을 아니요(기본값)로 설정합니다.
Examp르 프로퍼티
참고로, 여기에 예가 있습니다.ampComposer Pro의 릴레이 컨트롤러 속성:

릴레이 컨트롤러 연결
릴레이
열기: ratgdo의 "문 열기" 릴레이에 연결 닫기: ratgdo의 "문 닫기" 릴레이에 연결 중지: 사용 가능한 경우 ratgdo의 "문 중지" 릴레이에 연결
접촉 센서
닫힌 연락처: ratgdo의 "문 닫힘" 연락처에 연결 열린 연락처: ratgdo의 "문 열림" 연락처에 연결
Examp르 커넥션

참고로, 여기에 예가 있습니다.ampComposer Pro에서 연결이 어떻게 보여야 하는지에 대한 설명:
프로그램 작성
Control4에서 다음을 위한 프로그래밍을 생성할 수 있습니다. 이벤트에 따라 차고 문 열기/닫기 차고 문 상태 모니터링 차고 문 상태 변경에 대한 알림 설정 터치스크린 및 리모컨에 사용자 정의 버튼 생성
Example: "아직 열려 있음" 알림 만들기
릴레이 컨트롤러 드라이버의 "Still Open Time" 속성 사용: 1. "Still Open Time"을 원하는 기간(예: 10분)으로 설정합니다. 2. "Still Open" 이벤트가 발생할 때 트리거되는 프로그래밍 규칙을 만듭니다. 3. 알림을 보내거나 다른 작업을 수행하는 작업을 추가합니다.
추가 엔터티
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의 사전 서면 허가 없이는 본 정보의 배포 또는 복제는 엄격히 금지됩니다. 최신 정보는 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 ESP8266 장치에 물리적으로 연결 [PDF 파일] 사용자 가이드
ESP8266, ESP32, ESP8266 장치에 물리적으로 연결, ESP8266, 장치에 물리적으로 연결, 장치에 연결, 장치에, 장치에 연결

참고문헌

사용자 설명서

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

ESP8266이 장치에 물리적으로 연결됨

명세서

제품 사용 지침

설치 프로그램 설정

DriverCentral 클라우드 설정

드라이버 설치

드라이버 설정

자주 묻는 질문

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

질문: ESPHome 장치를 모니터링하고 제어하려면 어떻게 해야 하나요?

문서 / 리소스

참고문헌

댓글을 남겨주세요

답변 취소