Home Assistant + WLED: xây dựng tự động hóa hiệu ứng có thể khôi phục

ĐIỂM KIỂM TRA / 01

Giao cho mỗi lớp một nhiệm vụ

WLED quản lý định thời pixel, segment và hiệu ứng trên controller. Home Assistant quản lý ngữ cảnh phòng, lịch và tự động hóa ở lớp phía trên. Đường chạy chỉ đáng tin cậy sau khi entity WLED chính xác và đường mạng được gọi đã được kiểm tra.

• Giữ giao thức pixel, ánh xạ segment và hiệu ứng ở lớp thiết bị WLED.
• Dùng Home Assistant cho ngữ cảnh và lệnh, không thay thế controller hoặc đường cấp nguồn.
• Ghi cùng nhau entity, đường tích hợp, firmware và hành vi sau khi khởi động lại.

ĐIỂM KIỂM TRA / 02

Làm cho trạng thái WLED đã biết có thể khôi phục

Lưu một preset cục bộ hoặc trạng thái hiệu ứng đã thử nghiệm trong WLED trước khi thêm tự động hóa phức tạp. Ghi segment, giới hạn độ sáng, hiệu ứng, bảng màu, mã preset nếu được hiển thị và hành vi sau khi WLED khởi động lại. Preset là trạng thái khôi phục cho một cấu hình cụ thể, không phải bằng chứng cho controller, firmware hoặc biến thể dải khác.

• Đặt tên trạng thái theo phòng và mục đích, không theo một thử nghiệm tạm thời.
• Giữ độ sáng và tốc độ hiệu ứng trong phạm vi đã đo của hệ lắp đặt.
• Xác nhận entity Home Assistant chính xác cung cấp những preset hoặc tùy chọn hiệu ứng nào.

ĐIỂM KIỂM TRA / 03

Bắt đầu với một hành động dễ dự đoán

Kích hoạt một entity, gọi một hiệu ứng hoặc preset đã biết và kiểm tra kết quả từ phiên bản Home Assistant thực tế. Ví dụ dùng một light entity và tùy chọn hiệu ứng được cung cấp; thay các giá trị bằng entity và tùy chọn đã thực sự thử. Chỉ thêm hiện diện, media và thời gian sau khi đường này ổn định.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

ĐIỂM KIỂM TRA / 04

Kiểm tra đường lỗi và khởi động lại

Kiểm tra tự động hóa khi WLED khởi động lại, Home Assistant khởi động lại, mạng tạm thời không khả dụng và controller được cấp điện lại. Quyết định đèn sẽ tắt, trở về trạng thái WLED cục bộ hay chờ lệnh Home Assistant mới. Không mô tả khôi phục là tự động trước khi quan sát kết quả với đúng controller, firmware, tích hợp và trình tự cấp nguồn.

• Tách lần khởi động lại thiết bị WLED khỏi lần khởi động lại Home Assistant trong nhật ký thử nghiệm.
• Kiểm tra entity báo trạng thái gì khi không thể truy cập controller.
• Giữ phương án khôi phục cục bộ hoặc thủ công cho bảo trì và lỗi mạng.

ĐIỂM KIỂM TRA / 05

Thêm scene và điều kiện mà không che khuất phạm vi trách nhiệm

Khi một hành động đơn lẻ đã lặp lại được, dùng scene Home Assistant hoặc điều kiện bổ sung để diễn tả mục đích của phòng. Giữ hiệu ứng WLED, phân bổ segment và giới hạn độ sáng trong bản ghi. Với nhiều segment, ghi rõ entity điều khiển từng segment và thử hành động đồng thời; bật một light entity không tự định nghĩa một show nhiều segment an toàn.

• Thêm từng điều kiện một và giữ hành động cơ bản để chẩn đoán.
• Lưu entity, hiệu ứng hoặc preset, phạm vi segment và phương án khôi phục dự kiến trong ghi chú build.
• Coi hiện diện media, lịch và dashboard là ngữ cảnh tùy chọn xung quanh đường ánh sáng đã kiểm tra.

DẠNG HỎNG

Điều thường xảy ra sai

• Tự động hóa phụ thuộc vào tên hiệu ứng hoặc preset đã thay đổi giữa các phiên bản firmware.
• Scene giả định các kênh RGBW hoặc segment mà entity đã chọn không cung cấp.
• Kỳ vọng Home Assistant thay thế định thời WLED, controller hoặc đường cấp nguồn.
• Hành động đầu tiên chạy được nhưng chưa kiểm tra riêng việc WLED khởi động lại, Home Assistant khởi động lại và mất mạng.
• Không có phương án khôi phục cục bộ hoặc thủ công được ghi lại sau khi controller khởi động lại hoặc tích hợp bị gián đoạn.

CƠ SỞ KỸ THUẬT / PHIÊN BẢN

Giữ quyết định luôn cập nhật

Hướng dẫn này được duy trì như một hồ sơ kỹ thuật có phiên bản. Hãy kiểm tra lại tài liệu giao thức hiện hành và đúng phiên bản sản phẩm trước khi dùng trong lắp đặt sản xuất.