English | Tiếng Việt
Bộ tích hợp tùy chỉnh Home Assistant cho các thiết bị SmartSolar, cung cấp giám sát thời gian thực cho hệ thống pin mặt trời, trạng thái pin và sản lượng năng lượng.
⚠️ THÔNG BÁO QUAN TRỌNGĐây KHÔNG PHẢI là bộ tích hợp chính thức từ đội ngũ SmartSolar. Đây là bộ tích hợp do cộng đồng phát triển, tuân theo các tiêu chuẩn và thực tiễn tốt nhất của Home Assistant.
Tại sao cần bộ tích hợp này? Tài liệu chính thức của SmartSolar yêu cầu:
- Chỉnh sửa YAML thủ công trong
configuration.yaml- Quản lý và làm mới token thủ công
- Cấu hình template sensor phức tạp
- Không có cấu hình dựa trên giao diện
- Cập nhật thủ công khi thông tin đăng nhập thay đổi
Bộ tích hợp này được tạo ra để cung cấp trải nghiệm thân thiện hơn với người dùng, tuân theo các mẫu tích hợp hiện đại của Home Assistant với cấu hình dựa trên giao diện, quản lý token tự động và dễ dàng cấu hình lại.
-
🔌 2 chế độ tích hợp:
- Chế độ thiết bị đơn: Giám sát từng thiết bị riêng lẻ
- Chế độ dự án: Giám sát nhiều thiết bị với số liệu tổng hợp
-
📊 Giám sát toàn diện:
- Công suất phát điện thời gian thực
- Điện áp và dòng điện của tấm pin mặt trời
- Điện áp và dòng điện của pin lưu trữ
- Nhiệt độ thiết bị
- Sản lượng năng lượng tạo ra
-
🌐 Hỗ trợ đa ngôn ngữ:
- Tiếng Anh
- Tiếng Việt
-
⚙️ Cấu hình dễ dàng:
- Luồng cấu hình dựa trên giao diện
- Có thể chỉnh sửa cài đặt sau khi thiết lập
- Quản lý token tự động
-
🔄 Cập nhật tự động:
- Khoảng thời gian polling 30 giây
- Làm mới token tự động
- Xử lý lỗi và khôi phục
- Mở HACS → Overflow menu (ba chấm ở góc trên bên phải) → Custom repositories
- Thêm repository URL
https://github.com/sonnt45/ha-smart-solar, loại Integration - Tìm Smart Solar và tải về
- Khởi động lại Home Assistant
- Tải xuống phiên bản mới nhất từ [trang releases][releases]
- Giải nén thư mục
smartsolarvào thư mụccustom_componentscủa Home Assistant - Khởi động lại Home Assistant
Trước khi cấu hình bộ tích hợp, bạn cần:
-
Thông tin đăng nhập tài khoản SmartSolar:
- Tên đăng nhập
- Mật khẩu
-
Chipset ID:
- Đăng nhập vào SmartSolar
- Tới trang Quản lý Thiết bị
- Ghi lại Chipset ID của (các) thiết bị muốn tích hợp
- Vào Cài đặt → Thiết bị & Dịch vụ → Thêm bộ tích hợp
- Tìm kiếm Smart Solar và làm theo hướng dẫn
Mỗi thiết bị cung cấp các cảm biến sau:
| Cảm biến | Mô tả | Đơn vị |
|---|---|---|
| PV Power | Công suất phát điện hiện tại | W |
| PV Voltage | Điện áp tấm pin mặt trời | V |
| PV Current | Dòng điện tấm pin mặt trời | A |
| Battery Voltage | Điện áp pin lưu trữ | V |
| Battery Current | Dòng điện pin lưu trữ | A |
| Temperature | Nhiệt độ thiết bị | °C |
| Today Energy | Năng lượng phát ra hôm nay | kWh |
| Total Energy | Tổng năng lượng phát ra | kWh |
Trong chế độ dự án, bạn nhận được:
- Cảm biến tổng hợp: Số liệu tổng hợp trên tất cả các thiết bị
- Cảm biến thiết bị riêng lẻ: Cảm biến riêng cho từng thiết bị trong dự án
Tất cả cảm biến hỗ trợ:
- Dữ liệu lịch sử
- Thống kê
- Tích hợp bảng điều khiển năng lượng
- Kích hoạt tự động hóa
Bộ tích hợp này sử dụng SmartSolar API:
- Base URL:
https://api.smartsolar.io.vn - Xác thực: Bearer token (được quản lý tự động)
- Khoảng thời gian cập nhật: 30 giây
- Login:
/Auth/Login - Device Status:
/Device/Status(Chế độ thiết bị đơn) - Synthesis Metrics:
/Metric/SynthesisMetrics(Chế độ dự án)
Inverter hòa lưới cho hệ thống tấm pin mặt trời
Bộ điều khiển sạc năng lượng mặt trời cho hệ thống pin
- Kiểm tra xem bạn có thể đăng nhập vào SmartSolar được không
- Đảm bảo rằng bạn đã nhập đúng tên đăng nhập và mật khẩu
- Thử xóa và thêm lại bộ tích hợp
- Đảm bảo rằng thiết bị đang trực tuyến trong Quản lý Thiết bị
- Đảm bảo rằng Chipset ID là chính xác và đã được thêm vào tài khoản của bạn
- Kiểm tra Home Assistant log để tìm lỗi
- Kiểm tra kết nối internet của bạn
- Kiểm tra cài đặt tường lửa
- Đảm bảo rằng SmartSolar API có thể truy cập được
Bật debug log bằng cách thêm vào configuration.yaml:
logger:
default: info
logs:
custom_components.smartsolar: debugĐể thêm cảm biến SmartSolar vào Bảng điều khiển Năng lượng:
- Vào Cài đặt → Bảng điều khiển → Năng lượng
- Nhấp Thêm tiêu thụ hoặc Thêm sản xuất năng lượng mặt trời
- Chọn cảm biến SmartSolar phù hợp:
- Sử dụng Today Energy để theo dõi hàng ngày
- Sử dụng Total Energy để theo dõi tích lũy
automation:
- alias: "Cảnh báo pin SmartSolar yếu"
trigger:
- platform: numeric_state
entity_id: sensor.smartsolar_bat_voltage
below: 11.5
action:
- service: notify.mobile_app
data:
message: "Điện áp pin thấp: {{ states('sensor.smartsolar_bat_voltage') }}V"automation:
- alias: "Báo cáo sản lượng hàng ngày SmartSolar"
trigger:
- platform: time
at: "23:59:00"
action:
- service: notify.mobile_app
data:
message: "Sản lượng năng lượng mặt trời hôm nay: {{ states('sensor.smartsolar_today_kwh') }} kWh"Dự án này được cấp phép theo Giấy phép MIT.
- Hỗ trợ chế độ thiết bị đơn và dự án
- 8 loại cảm biến để giám sát toàn diện
- Bản dịch tiếng Anh và tiếng Việt
- Cấu hình dựa trên giao diện với luồng tùy chọn
- Quản lý và làm mới token tự động
Bộ tích hợp này không liên kết, được xác nhận hoặc được hỗ trợ bởi SmartSolar. Đây là một dự án cộng đồng độc lập.
Để được hỗ trợ và tài liệu chính thức, vui lòng tham khảo:
- Website chính thức SmartSolar: https://smartsolar.io.vn
- Hướng dẫn tích hợp chính thức: https://smartsolar.io.vn/Post/View/huong-dan-tich-hop-cac-thiet-bi-smartsolar-vao-he-thong-home-assistant-hass-1740221104
Sử dụng bộ tích hợp này với rủi ro của riêng bạn. Tác giả không chịu trách nhiệm về bất kỳ vấn đề nào có thể phát sinh từ việc sử dụng nó.