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

Chỉ cần một phiên bản trình điều khiển duy nhất cho mỗi thiết bị ESPHome.
Nhiều trường hợp của 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 bất ngờ. Tuy nhiên, bạn có thể có nhiều trường hợp
của trình điều khiển này được kết nối với các thiết bị ESPHome khác nhau.

Thiết lập đám mây DriverCentral

Nếu bạn đã cài đặt trình điều khiển DriverCentral Cloud trong
dự án của bạn, bạn có thể tiến hành Cài đặt trình điều khiển.

Trình điều khiển này dựa vào 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 Cloud Driver của họ
để thiết lập nó.

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

Tải xuống control4-esphome.zip mới nhất từ
DriverCentral.

Giải nén và cài đặt esphome.c4z, esphome_light.c4z và
Trình điều khiển esphome_lock.c4z.
Sử dụng tab Tìm kiếm để tìm trình điều khiển ESPHome và thêm nó 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. Kiểm tra
Trạng thái đám mây để biết thông tin về giấy phép.
Làm mới trạng thái giấy phép bằng cách chọn DriverCentral Cloud
trình điều khiển 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 kết nối
thông tin.
Chờ cho đến khi Trạng thái trình điều khiển hiển thị là Đã kết nối.

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

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

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

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

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

H: Làm thế nào tôi có thể theo dõi và điều khiển các thiết bị ESPHome?

A: Bạn có thể theo dõi và điều khiển các thiết bị ESPHome thông qua web
trình duyệt, Home Assistant hoặc các nền tảng tương thích khác sau
tích hợp chúng vào Control4 bằng trình điều khiển này.

“`

View Fullscreen

Quaview
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.
Mục lục
Yêu cầu hệ thống Tính năng Khả năng tương thích
Thiết bị đã xác minh được hỗ trợ ESPHome Entities Trình cài đặt Thiết lập DriverCentral Cloud Cài đặt Trình điều khiển 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 Cài đặt trình điều khiển Cài đặt thiết bị Thông tin thiết bị
Hướng dẫn cấu hình hành động của trình điều khiển
Hướng dẫn cấu hình ratgdo Thông tin dành cho nhà phát triển Hỗ trợ Nhật ký thay đổi

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ợ do thiết bị tiếp xúc 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ợ

Loại thực thể Bảng điều khiển báo động API Tiếng ồn Cảm biến nhị phân Bluetooth Proxy Nút Điều hòa Che Ngày giờ Ngày giờ Camera Sự kiện Quạt Đèn Khóa Trình phát đa phương tiện Số Chọn Cảm biến Còi báo động Công tắc Văn bản Văn bản Cập nhật cảm biến Van Trợ lý giọng nói

Được hỗ trợ

Thiết lập trình cài đặt
Chỉ cần một phiên bản trình điều khiển duy nhất cho mỗi thiết bị ESPHome. Nhiều phiên bản của trình điều khiển này
Trình điều khiển đượ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ài đặt trình điều khiển DriverCentral Cloud trong dự án của mình, 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 Trình điều khiển Cloud của họ để thiết lập.
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.
1. Tải xuống control4-esphome.zip mới nhất từ DriverCentral.
2. Giải nén và cài đặt trình điều khiển esphome.c4z, esphome_light.c4z và esphome_lock.c4z.
3. 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.
Ü Mỗi thiết bị ESPHome cần có một phiên bản trình điều khiển duy nhất.

4. 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 Thử nghiệm và thời gian dùng thử còn lại.
5. 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”.
6. Cấu hình Cài đặt Thiết bị với thông tin kết nối. 7. 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 hoạt động
kết nối, đặ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 đó, kiểm tra cửa sổ đầu ra lua để biết thêm thông tin. 8. 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ợ. 9. Để đ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 "Đèn ESPHome" và/hoặc "Khóa ESPHome". 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 đá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 ghi nhật ký [ Nghiêm trọng | 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 sử dụng 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ợ.
Nếu bạn đang sử dụng địa chỉ IP, bạn nên đảm bảo rằng nó sẽ không thay đổi bằng cách gán một địa chỉ tĩnh
IP hoặc tạo đặt chỗ DHCP. Cổng Thiết lập cổng thiết bị. Cổng mặc định cho 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: Không yêu cầu 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 để liên lạc 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. Đặt 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. Kiểu máy (chỉ đọc) Hiển thị kiểu máy 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 chương trình cơ sở 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
Điều này sẽ thiết lập lại tất cả các ràng buộc kết nối và xóa bất kỳ chương trình nào liên quan đến
biến số.
Đặ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 chương trình cơ sở ratgdo của bạn hỗ trợ lệnh "dừng", hãy cấu hình cho 3 rơ-le để bậ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 Pulse ratgdo sử dụng xung tức thời để kích hoạt bộ mở cửa nhà để xe, tương tự như khi 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 phản hồi tiếp điểm 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 “Mở cửa” của ratgdo Đóng: Kết nối với rơ le “Đóng cửa” của ratgdo Dừng: Kết nối với rơ le “Dừng cửa” của ratgdo, nếu có
Cảm biến tiếp xúc
Tiếp điểm đóng: Kết nối với tiếp điểm "Cửa đóng" của ratgdo Tiếp điểm mở: Kết nối với tiếp điểm "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 nhà để xe dựa trên các sự kiện Theo dõi trạng thái cửa nhà để xe Thiết lập thông báo về những thay đổi trạng thái cửa nhà để xe 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: 1. Đặt "Thời gian vẫn mở" theo khoảng thời gian mong muốn (ví dụ: 10 phút) 2. Tạo quy tắc lập trình kích hoạt khi sự kiện "Vẫn mở" phát sinh 3. 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 (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, và có thể được bảo hộ bởi các Bằng sáng chế Hoa Kỳ và Nước ngoài, các 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 thông tin này hoặc sao chép tài liệu này trừ khi có sự cho phép trước bằng văn bản từ 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 theo địa chỉ 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 khóa 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

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

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

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

Thông số kỹ thuật

Hướng dẫn sử dụng sản phẩm

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