Hướng dẫn sử dụng ESPHome ESP8266 kết nối vật lý với thiết bị của bạn

Tích hợp các thiết bị dựa trên ESPHome vào Control4. ESPHome là một hệ thống mã nguồn mở giúp chuyển đổi các bộ vi điều khiển thông thường, như ESP8266 và ESP32, thành các thiết bị nhà thông minh thông qua cấu hình YAML đơn giản. Các thiết bị ESPHome có thể được thiết lập, giám sát và điều khiển bằng web Trình duyệt, Home Assistant hoặc các nền tảng tương thích khác. Trình điều khiển này cho phép giám sát và điều khiển liền mạch các thiết bị ESPHome trực tiếp từ hệ thống Control4 của bạn.

Yêu cầu hệ thống

Hệ điều hành Control4 3.3+

Đặc trưng

Giao tiếp mạng cục bộ không yêu cầu dịch vụ đám mây
Cập nhật theo thời gian thực từ tất cả các thực thể được hỗ trợ bởi thiết bị
Hỗ trợ kết nối được mã hóa bằng khóa mã hóa thiết bị
Hỗ trợ lập trình biến

Khả năng tương thích

Các thiết bị đã được xác minh
Trình điều khiển này nhìn chung sẽ hoạt động với mọi thiết bị ESPHome, nhưng chúng tôi đã thử nghiệm rộng rãi với các thiết bị sau:

ratgdo – Hướng dẫn cấu hình

Nếu bạn thử trình điều khiển này trên sản phẩm được liệt kê ở trên và nó hoạt động, hãy cho chúng tôi biết!

Các thực thể ESPHome được hỗ trợ

Thiết lập trình cài đặt

Mỗi thiết bị ESPHome chỉ cần một phiên bản trình điều khiển duy nhất. Nhiều phiên bản trình điều khiển này được kết nối với cùng một thiết bị sẽ có hành vi không mong muốn. Tuy nhiên, bạn có thể kết nối nhiều phiên bản trình điều khiển này với các thiết bị ESPHome khác nhau.

Thiết lập đám mây DriverCentral
Nếu bạn đã có Trình điều khiển đám mây DriverCentral được cài đặt trong dự án của bạn, bạn có thể tiếp tục Cài đặt trình điều khiển.

Trình điều khiển này dựa trên trình điều khiển DriverCentral Cloud để quản lý cấp phép và cập nhật tự động. Nếu bạn mới sử dụng DriverCentral, bạn có thể tham khảo Tài liệu về Cloud Driver để thiết lập nó.

Cài đặt trình điều khiển

Việc cài đặt và thiết lập trình điều khiển tương tự như hầu hết các trình điều khiển dựa trên IP khác. Dưới đây là tóm tắt các bước cơ bản để bạn tham khảo.

Tải xuống phiên bản mới nhất control4-esphome.zip từ DriverCentral.
Giải nén và cài đặt esphome.c4z, esphome_light.c4z, Và esphome_lock.c4z tài xế.
Sử dụng tab “Tìm kiếm” để tìm trình điều khiển “ESPHome” và thêm vào dự án của bạn.

Chọn trình điều khiển mới được thêm vào trong tab "Thiết kế Hệ thống". Bạn sẽ thấy Trạng thái Đám mây phản ánh trạng thái giấy phép. Nếu bạn đã mua giấy phép, nó sẽ hiển thị "Giấy phép đã được kích hoạt", nếu không sẽ hiển thị "Đang chạy bản dùng thử" và thời gian dùng thử còn lại.
Bạn có thể làm mới trạng thái giấy phép bằng cách chọn trình điều khiển “DriverCentral Cloud” trong tab “Thiết kế hệ thống” và thực hiện hành động “Kiểm tra trình điều khiển”.

Cấu hình Cài đặt thiết bị với thông tin kết nối.
Sau vài phút, Trạng thái Trình điều khiển sẽ hiển thị "Đã kết nối". Nếu trình điều khiển không kết nối được, hãy đặt thuộc tính Chế độ Nhật ký thành "In" và đặt lại trường Địa chỉ IP để kết nối lại. Sau đó, hãy kiểm tra cửa sổ đầu ra Lua để biết thêm thông tin.
Sau khi kết nối, trình điều khiển sẽ tự động tạo các biến và kết nối cho từng loại thực thể được hỗ trợ.

Để điều khiển đèn và/hoặc khóa, hãy sử dụng tab "Tìm kiếm" để tìm trình điều khiển "ESPHome Light" và/hoặc "ESPHome Lock". Thêm một phiên bản trình điều khiển cho mỗi thực thể đèn hoặc khóa được hiển thị trong dự án của bạn. Trong tab "Kết nối", chọn trình điều khiển "ESPHome" và liên kết các thực thể đèn hoặc khóa với các trình điều khiển mới được thêm vào.

Thiết lập trình điều khiển

Thuộc tính trình điều khiển

Cài đặt đám mây

Trạng thái đám mây
Hiển thị trạng thái giấy phép đám mây DriverCentral.
Cập nhật tự động
Bật/tắt tính năng cập nhật tự động trên nền tảng đám mây DriverCentral.

Cài đặt trình điều khiển

Trạng thái trình điều khiển (chỉ đọc)
Hiển thị trạng thái hiện tại của trình điều khiển.

Phiên bản trình điều khiển (chỉ đọc)
Hiển thị phiên bản hiện tại của trình điều khiển.
Mức độ nhật ký [Tử vong | Lỗi | Cảnh báo | Thông tin | Gỡ lỗi | Theo dõi | Cực kỳ] Đặt mức ghi nhật ký. Mặc định là Thông tin.

Chế độ ghi nhật ký [ Tắt | In | Ghi nhật ký | In và ghi nhật ký ] Đặt chế độ ghi nhật ký. Mặc định là Tắt.

Cài đặt thiết bị

Địa chỉ IP
Đặt địa chỉ IP của thiết bị (ví dụ: 192.168.1.30). Tên miền được phép miễn là bộ điều khiển có thể phân giải chúng thành địa chỉ IP có thể truy cập được. HTTPS không được hỗ trợ.

Ghi chú: Nếu bạn đang sử dụng địa chỉ IP, bạn phải đảm bảo địa chỉ đó không thay đổi bằng cách chỉ định IP tĩnh hoặc tạo lệnh đặt trước DHCP.

Cảng
Thiết lập cổng thiết bị. Cổng mặc định cho các thiết bị ESPHome là 6053.

Chế độ xác thực [ Không có | Mật khẩu | Khóa mã hóa ]
Chọn phương thức xác thực để kết nối với thiết bị ESPHome.

Không có: Không cần xác thực.

Mật khẩu: Sử dụng mật khẩu để xác thực (xem bên dưới).

Khóa mã hóa: Sử dụng khóa mã hóa để giao tiếp an toàn (xem bên dưới).

Mật khẩu
Chỉ hiển thị nếu Chế độ Xác thực được đặt thành Mật khẩu. Đặt mật khẩu thiết bị. Mật khẩu này phải khớp với mật khẩu được cấu hình trên thiết bị ESPHome.

Khóa mã hóa
Chỉ hiển thị nếu Chế độ Xác thực được đặt thành Khóa Mã hóa. Thiết lập khóa mã hóa thiết bị để giao tiếp an toàn. Khóa này phải khớp với khóa mã hóa được cấu hình trên thiết bị ESPHome.

Thông tin thiết bị

Tên (chỉ đọc)
Hiển thị tên của thiết bị ESPHome được kết nối.

Mô hình (chỉ đọc)
Hiển thị model của thiết bị ESPHome được kết nối.
Nhà sản xuất (chỉ đọc)
Hiển thị nhà sản xuất của thiết bị ESPHome được kết nối.

Địa chỉ MAC (chỉ đọc)
Hiển thị địa chỉ MAC của thiết bị ESPHome được kết nối.
Phiên bản chương trình cơ sở (chỉ đọc)
Hiển thị phiên bản phần mềm của thiết bị ESPHome được kết nối.

Hành động của người lái xe

Đặt lại kết nối và biến

Cảnh báo: Thao tác này sẽ thiết lập lại mọi ràng buộc kết nối và xóa mọi chương trình liên quan đến các biến.

Đặt lại kết nối và biến trình điều khiển. Điều này hữu ích nếu bạn thay đổi thiết bị ESPHome được kết nối hoặc có các kết nối hoặc biến cũ.

Hướng dẫn cấu hình ratgdo

Hướng dẫn này cung cấp hướng dẫn cấu hình trình điều khiển ESPHome để hoạt động với các thiết bị ratgdo để điều khiển cửa gara thông qua rơ le trong Control4 Composer Pro.

Thêm trình điều khiển bộ điều khiển rơle
Thêm trình điều khiển bộ điều khiển rơ le mong muốn vào dự án Control4 của bạn trong Composer Pro.

Thuộc tính bộ điều khiển rơle
Thiết bị ratgdo hiển thị thực thể “Cover” trong ESPHome, thực thể này ánh xạ tới chức năng bộ điều khiển rơle trong Control4.

Số lượng rơ le
Thiết bị ratgdo sử dụng cấu hình đa rơle để điều khiển cửa gara. Trong Composer Pro, bạn nên cấu hình cài đặt rơle như sau:

Đặt thành 2 Rơ le (Mở/Đóng) hoặc 3 Rơ le (Mở/Đóng/Dừng)
- Thiết bị ratgdo sử dụng các lệnh riêng biệt để mở và đóng cửa nhà để xe
- Nếu firmware ratgdo của bạn hỗ trợ lệnh "dừng", hãy cấu hình 3 rơ-le để kích hoạt chức năng dừng. Nếu không chắc chắn, bạn có thể kiểm tra các kết nối ratgdo trong Composer Pro để xem rơ-le "Dừng cửa" có khả dụng hay không.

Cấu hình chuyển tiếp

Đặt thành Xung
- ratgdo sử dụng các xung tức thời để kích hoạt bộ mở cửa nhà để xe, tương tự như việc nhấn nút trên tường

Thời gian xung

Đặt tất cả thời gian xung rơle thành 500 (mặc định)
- Đây là khoảng thời gian rơle sẽ được kích hoạt

Rơ le đảo ngược

Đặt tất cả các thuộc tính rơle đảo ngược thành KHÔNG (mặc định)

Liên hệ Debounce

Đặt tất cả thời gian gỡ lỗi liên lạc thành 250 (mặc định)
- Điều này giúp ngăn chặn hiện tượng rung lắc sai của cảm biến trạng thái cửa nhà để xe

Đảo ngược liên hệ

Đặt tất cả các thuộc tính liên hệ đảo ngược thành KHÔNG (mặc định)

Example Properties
Để tham khảo, đây là một ví dụampcác thuộc tính của bộ điều khiển rơle trong Composer Pro:

Kết nối bộ điều khiển rơle

Rơ le

Mở: Kết nối với rơ le “Cửa mở” của ratgdo
Đóng: Kết nối với rơle “Đóng cửa” của ratgdo
Stop: Kết nối với rơ le “Stop Door” của ratgdo, nếu có

Cảm biến tiếp xúc

Liên hệ đóng: Kết nối với liên hệ “Cửa đóng” của ratgdo
Liên hệ đã mở: Kết nối với liên hệ “Cửa mở” của ratgdo

Example Kết nối
Để tham khảo, đây là một ví dụampvề cách các kết nối sẽ trông như thế nào trong Composer Pro:

Lập trình
Bạn có thể tạo chương trình trong Control4 để:

Mở/đóng cửa gara dựa trên sự kiện
Theo dõi tình trạng cửa gara
Thiết lập thông báo về những thay đổi trạng thái cửa gara
Tạo các nút tùy chỉnh trên màn hình cảm ứng và điều khiển từ xa

Example: Tạo cảnh báo vẫn mở

Sử dụng thuộc tính “Thời gian vẫn mở” từ trình điều khiển bộ điều khiển rơle:

Đặt “Thời gian vẫn mở” theo thời lượng mong muốn của bạn (ví dụ: 10 phút)
Tạo quy tắc lập trình kích hoạt khi sự kiện "Vẫn mở" được kích hoạt
Thêm hành động để gửi thông báo hoặc thực hiện các tác vụ khác

Các thực thể bổ sung
Tùy thuộc vào thiết bị ratgdo, chương trình cơ sở và khả năng của nó, có thể có các thực thể bổ sung được trình điều khiển ESPHome hiển thị. Chúng có thể là các kết nối bổ sung hoặc biến trình điều khiển.

Vui lòng tham khảo tài liệu của ratgdo để biết thêm thông tin về các thực thể cụ thể: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Thông tin nhà phát triển
Bản quyền © 2025 Finite Labs LLC
Mọi thông tin trong tài liệu này là và vẫn là tài sản của Finite Labs LLC và các nhà cung cấp của công ty, nếu có. Các khái niệm trí tuệ và kỹ thuật trong tài liệu này thuộc sở hữu của
Finite Labs LLC và các nhà cung cấp của công ty có thể được bảo hộ bởi Bằng sáng chế Hoa Kỳ và Nước ngoài, bằng sáng chế đang được xử lý, và được bảo vệ bởi luật bí mật thương mại hoặc bản quyền. Nghiêm cấm phổ biến hoặc sao chép thông tin này trừ khi có sự cho phép trước bằng văn bản của Finite Labs LLC. Để biết thông tin mới nhất, vui lòng truy cập https://drivercentral.io/platforms/control4-drivers/utility/esphome

Ủng hộ
Nếu bạn có bất kỳ câu hỏi hoặc vấn đề nào khi tích hợp trình điều khiển này với Control4 hoặc ESPHome, bạn có thể liên hệ với chúng tôi tại driver-support@finitelabs.com hoặc gọi/nhắn tin cho chúng tôi theo số +1 949-371-5805.

Nhật ký thay đổi

v20250715 – 14-07-2025

Đã sửa: Đã sửa lỗi khiến các thực thể không được phát hiện khi kết nối

v20250714 – 14-07-2025

Đã thêm: Đã thêm hỗ trợ cho các kết nối được mã hóa bằng cách sử dụng mã hóa thiết bị

v20250619 – 19-06-2025

Đã thêm : Đã thêm tài liệu cụ thể về ratgdo

v20250606 – 06-06-2025

Đã thêm :Bản phát hành đầu tiên

Câu hỏi thường gặp

Thiết bị nào tương thích với trình điều khiển này?

Trình điều khiển này tương thích với mọi thiết bị ESPHome, đã được kiểm tra kỹ lưỡng trên các thiết bị ratgdo. Nếu bạn thử trên bất kỳ thiết bị nào khác và thấy hoạt động, vui lòng thông báo cho chúng tôi để xác minh.

Tài liệu / Tài nguyên

ESPHome ESP8266 Kết nối vật lý với thiết bị của bạn [tập tin pdf] Hướng dẫn sử dụng
ESP8266, ESP32, ESP8266 Kết nối vật lý với thiết bị của bạn, ESP8266, Kết nối vật lý với thiết bị của bạn, Kết nối với thiết bị của bạn, với thiết bị của bạn, Thiết bị của bạn

Tài liệu tham khảo

Hướng dẫn sử dụng

ESPHome ESP8266 Kết nối vật lý với thiết bị của bạn

Thông số kỹ thuật

Quaview