Custom integration điều khiển thiết bị Rạng Đông Smart tương thích Tuya trong Home Assistant. Bản này ưu tiên kết nối LAN nội bộ, không cần Android root, ADB, Frida, import APK hoặc Tuya IoT Cloud project.
- Mở HACS → Integrations. Điền link repo https://github.com/trankhanhduy2929-beep/rangdong-homeassistant
- Tìm
Rạng Đông Smarthoặc thêm repository này bằng Custom repositories. - Chọn loại Integration, cài đặt và restart Home Assistant.
- Vào Settings → Devices & services → Add integration.
- Chọn Rạng Đông Smart.
- Nhập License Key nếu được yêu cầu.
- Chờ dò LAN, chọn thiết bị rồi nhập local key. IP và Device ID được điền tự động.
Khi được yêu cầu, mở website license từ màn hình cấu hình. Tạo tài khoản bằng email + mật khẩu, nhận trial 1 ngày hoặc mua gói 1 tháng/vĩnh viễn rồi nhập key.
Một key dùng cho một custom integration và một add-on trên cùng Home Assistant. Khi license hết hạn, custom khóa điều khiển và các entity chuyển sang không khả dụng; không xóa thiết bị, cấu hình hay local key. Gia hạn trên website để tiếp tục. Khi gia hạn cùng key, custom tự kiểm tra lại; nếu nhận key mới, nhập trong Settings → Devices & services → Rạng Đông Smart → Configure.
Custom xác minh lại với server tối đa mỗi 5 phút. Khi đến lượt xác minh mà không có kết nối, điều khiển tạm khóa; không cần mua lại vì sự cố mạng. Thời hạn license vẫn được kiểm tra trước từng lệnh, không cộng thêm thời gian dùng sau khi hết hạn. Khóa/thu hồi từ admin có độ trễ tối đa 5 phút khi có mạng. Việc khóa không tự tắt điện thiết bị và không thu hồi local key đã sao chép. Trial chỉ nhận một lần cho mỗi tài khoản và installation; đổi email không tạo thêm lượt dùng thử trên cùng Home Assistant.
- LAN nội bộ: dò IP, Device ID, Product ID và tên nếu thiết bị có cung cấp; chọn thiết bị rồi chỉ nhập local key. Custom tự thử giao thức phù hợp.
- Nếu add-on đã gửi thông tin qua bridge, tên tài khoản của thiết bị được dùng để dễ chọn. Tên/loại sản phẩm không phát qua LAN thì không thể bảo đảm nhận diện; Product ID được hiển thị, không đoán thành model hoặc loại thiết bị.
- Khi không dò thấy, vẫn có mục nhập IP, Device ID và key thủ công. Thiết bị Tuya khác cũng có thể xuất hiện trong danh sách, cần chọn đúng thiết bị.
- Có thể lấy các thông tin này từ add-on Key Helper rồi nhập vào custom integration.
- Sau khi thêm thiết bị, đổi tên và khu vực trong Home Assistant như bình thường.
- Đảm bảo Home Assistant và thiết bị cùng mạng LAN, không bị client isolation.
Integration hỗ trợ các entity và dịch vụ tương thích với thiết bị Rạng Đông đã được nhận diện. Tính năng thực tế phụ thuộc model, firmware và chức năng thiết bị.
- Không tìm thấy thiết bị: kiểm tra IP, VLAN, firewall và mạng LAN.
- Sai local key: lấy lại key từ Key Helper, kiểm tra đúng Device ID.
- License lỗi: kiểm tra key trên website và installation Home Assistant.
- Không cần quét QR hoặc đăng nhập cloud trong custom integration.
Không nhập mật khẩu tài khoản Rạng Đông vào website license. Không chia sẻ local key hoặc License Key.