ESPHome ESP8266 實體連接到您的裝置使用者指南

超過view
將基於 ESPHome 的裝置整合到 Control4。 ESPHome 是一個開源系統，可以透過簡單的 YAML 配置將常見的微控制器（例如 ESP8266 和 ESP32）轉換為智慧家庭設備。 ESPHome 設備可以透過 web 瀏覽器、Home Assistant 或其他相容平台。此驅動程式可讓您直接從 Control4 系統無縫監控和控制 ESPHome 裝置。
指數
系統需求功能相容性
已驗證裝置支援 ESPHome 實體安裝程式設定 DriverCentral 雲端設定驅動程式安裝驅動程式設定
驅動程式屬性雲端設定驅動程式設定設備設定設備訊息
驅動程式操作配置指南
ratgdo 設定指南開發人員資訊支援變更日誌

系統需求
Control4 作業系統 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 Light」和/或「ESPHome Lock」驅動程式。為專案中每個暴露的燈光或鎖實體新增一個驅動程式實例。在「連接」標籤中，選擇「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 配置指南
本指南提供了有關配置 ESPHome 驅動程式以與 ratgdo 設備配合使用以透過 Control4 Composer Pro 中的繼電器控制車庫門的說明。
添加繼電器控制器驅動程式
將所需的繼電器控制器驅動程式新增至 Composer Pro 中的 Control4 專案。
繼電器控制器屬性
ratgdo 裝置在 ESPHome 中公開了一個「Cover」實體，該實體會對應到 Control4 中的繼電器控制器功能。
繼電器數量
ratgdo 設備使用多繼電器配置來控制車庫門。在 Composer Pro 中，您應該如下設定繼電器設定：

設定為 2 個繼電器（開啟/關閉）或 3 個繼電器（開啟/關閉/停止）。 ratgdo 設備使用單獨的命令來打開和關閉車庫門。如果您的 ratgdo 韌體支援「停止」命令，請設定 3 個繼電器以啟用停止功能。如果您不確定，可以查看 Composer Pro 中的 ratgdo 連接，看看「停止門」繼電器是否可用。
繼電器配置
設定為脈衝 ratgdo 使用瞬時脈衝來觸發車庫門開啟器，類似於按下牆壁按鈕
脈衝時間
將所有繼電器脈衝時間設為 500（預設值）這是繼電器啟動的持續時間
反轉繼電器
將所有反轉繼電器屬性設為否（預設）
接觸式防手震
將所有接觸去抖時間設定為 250（預設值），這有助於防止車庫門狀態感測器誤拍
反轉接觸
將所有反轉接觸屬性設為否（預設）
Example 屬性
作為參考，這裡有一個例子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 雲端設定

驅動安裝

驅動程式設定

常問問題

Q：哪些裝置與該驅動程式相容？

Q：如何監控和控制 ESPHome 設備？

文件/資源

參考

發表評論

取消回覆