內容 隱藏
1 ESPHome ESP8266 實體連接到您的設備
2 規格
3 超過view
4 系統需求
5 特徵
6 相容性
7 支援的 ESPHome 實體
8 安裝程式設定
9 驅動安裝
10 驅動程式設定
11 設備設定
12 ratgdo 配置指南
13 Example：建立仍然打開的警報
14 常問問題
15 文件/資源
15.1 參考

ESPHome標誌

ESPHome ESP8266 實體連接到您的設備

ESPHome-ESP8266-實體連接到您的裝置產品

規格

  • 系統需求： Control4 作業系統 3.3+

超過view

將基於 ESPHome 的裝置整合到 Control4。 ESPHome 是一個開源系統，可以透過簡單的 YAML 配置將常見的微控制器（例如 ESP8266 和 ESP32）轉換為智慧家庭設備。 ESPHome 設備可以透過 web 瀏覽器、Home Assistant 或其他相容平台。此驅動程式可讓您直接從 Control4 系統無縫監控和控制 ESPHome 裝置。

系統需求

  • Control4 作業系統 3.3+

特徵

  • 無需雲端服務的本地網路通信
  • 來自裝置公開的所有受支援實體的即時更新
  • 支援使用裝置加密金鑰的加密連接
  • 變數程式設計支持

相容性

經過驗證的設備
此驅動程式通常適用於任何 ESPHome 設備，但我們已使用以下設備進行了廣泛測試：

如果您在上面列出的產品上嘗試此驅動程式並且它有效，請告訴我們！

支援的 ESPHome 實體

ESPHome-ESP8266-實體連接到您的裝置-（1） ESPHome-ESP8266-實體連接到您的裝置-（2）

安裝程式設定

每個 ESPHome 設備只需要一個驅動程式實例。如果此驅動程式的多個實例連接到同一設備，則會出現意外行為。但是，您可以將此驅動程式的多個實例連接到不同的 ESPHome 裝置。

DriverCentral 雲端設定
如果您已經擁有 DriverCentral 雲端驅動程式 安裝在您的專案中，您可以繼續驅動程式安裝。

此驅動程式依賴 DriverCentral Cloud 驅動程式來管理許可證和自動更新。如果您是 DriverCentral 的新用戶，可以參考他們的 Cloud Driver 文檔 用於設定它。

驅動安裝

驅動程式的安裝和設定與大多數其他基於 IP 的驅動程式類似。以下概述了基本步驟，方便您參考。

  1. 下載最新的 control4-esphome.zip 從 駕駛中心.
  2. 提取並安裝 esphome.c4z, esphome_light.c4z， 和 esphome_lock.c4z 司機。
  3. 使用「搜尋」標籤找到「ESPHome」驅動程式並將其新增至您的專案中。ESPHome-ESP8266-實體連接到您的裝置-（3）
  4. 在“系統設計”標籤中選擇新新增的驅動程式。您會注意到雲端狀態反映了許可證狀態。如果您已購買許可證，它將顯示“許可證已啟動”，否則將顯示“試用中”以及剩餘試用時長。
  5. 您可以透過在「系統設計」標籤中選擇「DriverCentral Cloud」驅動程式並執行「檢查驅動程式」操作來刷新許可證狀態。ESPHome-ESP8266-實體連接到您的裝置-（4）
  6. 配置 設備設定 以及連接資訊。
  7. 片刻之後，驅動程式狀態將顯示「已連線」。如果驅動程式連線失敗，請將“日誌模式”屬性設為“列印”，並重新設定“IP 位址”欄位以重新連線。然後，查看 Lua 輸出視窗以獲取更多資訊。
  8. 一旦連接，驅動程式將自動為每個支援的實體類型建立變數和連接。
  9. 若要控制燈光和/或鎖，請使用「搜尋」標籤尋找「ESPHome Light」和/或「ESPHome Lock」驅動程式。為專案中的每個暴露的燈光或鎖實體新增一個驅動程式實例。在「連接」標籤中，選擇「ESPHome」驅動程序，並將燈光或鎖定實體綁定到新新增的驅動程式。

驅動程式設定

驅動程式屬性

雲設置

  • 雲狀態
    顯示 DriverCentral 雲端許可證狀態。
  • 自動更新
    開啟/關閉 DriverCentral 雲端自動更新。

驅動程序設置

  • 駕駛員狀態（唯讀）
    顯示驅動程式的目前狀態。
  • 驅動程式版本（唯讀）
    顯示驅動程式的目前版本。
  • 日誌等級 [ 嚴重 | 錯誤 | 警告 | 資訊 | 偵錯 | 追蹤 | 超嚴重 ] 設定日誌記錄等級。預設為 資訊.
  • 日誌模式 [ 關閉 | 列印 | 日誌 | 列印與日誌 ] 設定日誌記錄模式。預設為 離開.

設備設定

IP位址
設定設備 IP 位址（例如 192.168.1.30）。允許使用域名，只要它們可以被控制器解析為可存取的 IP 位址即可。不支援 HTTPS。

筆記： 如果您使用 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 專案。

ESPHome-ESP8266-實體連接到您的裝置-（5）

繼電器控制器屬性
ratgdo 裝置在 ESPHome 中公開了一個「Cover」實體，該實體會對應到 Control4 中的繼電器控制器功能。

繼電器數量
ratgdo 設備使用多繼電器配置來控制車庫門。在 Composer Pro 中，您應該如下設定繼電器設定：

  • 設定為 2 個繼電器（開啟/關閉）或 3 個繼電器（開啟/關閉/停止）
    • ratgdo 設備使用單獨的命令來打開和關閉車庫門
    • 如果您的 ratgdo 韌體支援「stop」指令，請設定 3 個繼電器以啟用停止功能。如果您不確定，可以查看 Composer Pro 中的 ratgdo 連接，看看「Stop Door」繼電器是否可用。

繼電器配置

  • 設定為 脈衝
    • ratgdo 使用瞬時脈衝來觸發車庫門開啟器，類似於按下牆上的按鈕

脈衝時間

  • 將所有繼電器脈衝時間設定為 500 (預設)
    • 這是繼電器啟動的持續時間

反轉繼電器

  • 將所有反轉繼電器屬性設為 不 (預設)

接觸式防手震

  • 將所有接觸去抖時間設定為 250 (預設)
    • 這有助於防止車庫門狀態感應器的誤動作

反轉接觸

  • 將所有反轉接觸屬性設為 不 (預設)

Example 屬性
作為參考，這裡有一個例子ampComposer Pro 中的繼電器控制器屬性檔：

ESPHome-ESP8266-實體連接到您的裝置-（6） ESPHome-ESP8266-實體連接到您的裝置-（7）

繼電器控制器連接

繼電器

  • 打開： 連接到 ratgdo 的「開門」繼電器
  • 關閉： 連接到 ratgdo 的「關門」繼電器
  • 停止： 連接到 ratgdo 的「停止門」繼電器（如果可用）

接觸式傳感器

  • 已關閉聯絡方式： 連接到 ratgdo 的「門關閉」觸點
  • 已開通聯絡方式： 連接到 ratgdo 的「開門」觸點

Examp文件連接
作為參考，這裡有一個例子ampComposer Pro 中的連接範例如下：

ESPHome-ESP8266-實體連接到您的裝置-（8）

程式設計
您可以在 Control4 中建立程式設計來：

  • 根據事件打開/關閉車庫門
  • 監控車庫門狀態
  • 設定車庫門狀態變更通知
  • 在觸控​​螢幕和遙控器上建立自訂按鈕

Example：建立仍然打開的警報

使用繼電器控制器驅動程式的「靜止開啟時間」屬性：

  1. 將「仍開放時間」設定為您想要的持續時間（例如 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 及其供應商可能受美國及外國專利、正在申請的專利保護，並受商業機密或版權法保護。未經 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、實體連接到您的裝置、連接到您的裝置、到您的裝置、您的設備

參考

發表評論

您的電子郵件地址不會被公開。 必填欄位已標記 *