Tôi là người Việt, tự mình duy trì dự án này. Nếu integration này giúp bạn theo dõi và tiết kiệm tiền điện, hãy mua tôi một cốc cà phê ☕ — mỗi cốc = 50,000 VND = động lực để tôi tiếp tục phát triển.
High-performance Home Assistant custom integration for Lumentree hybrid solar inverters (SUNT series). Real-time monitoring via MQTT (Modbus), historical energy statistics via HTTP API, and comprehensive battery management. Track solar PV generation, grid import/export, battery SOC, and calculate electricity cost savings in VND.
- PV Power: Solar generation (W) — PV1 + PV2
- Battery Management: Power, voltage, current, SOC (%), status (Charging/Discharging)
- Grid Power: Import/export power + status
- Load Power: Total consumption monitoring
- AC Output: Voltage, frequency, power, apparent power
- AC Input: Voltage, frequency, power
- Device: Temperature, online status, UPS mode, serial number
- Battery Cells: Individual cell voltage monitoring
- PV Generation, Battery Charge/Discharge, Grid Import, Load Consumption
- Essential Load, Total Load, Energy Saved (kWh), Cost Savings (VND)
- 288-point 5-minute series for detailed charts
- 9 metrics: PV, Charge, Discharge, Grid, Load, Essential, Total Load, Saved (kWh), Savings (VND)
- Daily arrays for month-view charts (1-31 days)
- 9 metrics with monthly arrays for year-view charts (1-12 months)
- Historical data across multiple years via disk cache
- Cumulative totals across all available years
- Auto-aggregated from yearly data
- 40-50% faster parsing with struct caching
- 3x faster API calls with concurrent requests
- 20-30% lower memory with
__slots__
💡 Người dùng báo cáo tiết kiệm 200,000-500,000 VND/tháng tiền điện nhờ theo dõi chính xác sản lượng điện mặt trời và tiêu thụ. Nếu integration này giúp ích cho bạn, ủng hộ tôi một cốc cà phê ☕
- Home Assistant: 2023.1+
- Python: 3.9+
- Dependencies: aiohttp>=3.8.0, paho-mqtt>=1.6.0, crcmod>=1.7
- Network: Internet (API + MQTT to
lesvr.suntcn.com)
- Open HACS → Integrations → Custom Repositories
- Add
https://github.com/ngoviet/lumentreeHA(Integration type) - Install Lumentree Inverter → Restart HA
- Download latest release
- Extract to
custom_components/lumentree/in your HA config - Restart Home Assistant
- Settings → Devices & Services → Add Integration
- Search Lumentree Inverter
- Enter Device ID (format:
H240909079— found on device label or Lumentree app) - Follow setup wizard
| Category | Sensors |
|---|---|
| Power | PV1, PV2, PV Total, Battery, Grid, Load, AC Output, AC Input, Total Load |
| Voltage | Battery, PV1, PV2, Grid, AC Output, AC Input |
| Current | Battery |
| Frequency | AC Output, AC Input |
| Status | Battery SOC (%), Battery Status, Grid Status, Battery Type, UPS Mode, Master/Slave |
| Info | Device Temperature, MQTT Device SN, Battery Cell Info |
| Period | Metrics | Refresh |
|---|---|---|
| Daily (7) | PV, Charge, Discharge, Grid, Load, Essential, Total Load | 5 min |
| Monthly (7) | Same + Saved (kWh) + Savings (VND) | 5 min |
| Yearly (7) | Same + monthly arrays for charting | 5 min |
| Total (7) | Lifetime cumulative sums | 5 min |
- Online Status, UPS Mode
- Restart Home Assistant
- Check logs:
custom_components.lumentreefor errors - Verify network access to
lesvr.suntcn.com:1886(MQTT) andlesvr.suntcn.com:80(HTTP)
- MQTT sensors freeze → integration auto-reconnects within 2 minutes
- Stats sensors → check if daily coordinator is updating
logger:
logs:
custom_components.lumentree: debug
Tôi là người Việt Nam 🇻🇳 — một mình xây dựng và duy trì integration này.
Dành 200+ giờ phát triển, sửa lỗi, và cập nhật để integration hoạt động ổn định.
Mục tiêu: $20/tháng — đủ để tôi có động lực tiếp tục cập nhật lâu dài.
Nếu integration này giúp bạn tiết kiệm tiền điện, hãy ủng hộ tôi:
- ☕ Buy Me A Coffee — Credit card, Apple Pay, PayPal
- 💖 GitHub Sponsors — Zero-fee recurring sponsorship
- VietQR — Quét mã chuyển khoản ngân hàng (miễn phí)
- Momo — Chuyển tiền qua ví Momo
(QR codes coming soon — đang chờ thông tin tài khoản)
See CHANGELOG.md or GitHub Releases for detailed version history.
Made with ❤️ by a Vietnamese developer — Buy me a coffee if this helps you.