Gửi dữ liệu năng lượng từ Home Assistant lên Cloud | IAMMETER-Link

Gửi dữ liệu năng lượng từ Home Assistant lên Cloud bằng IAMMETER-Link

Nếu một biến tần, công tơ điện, hệ thống pin hoặc thiết bị năng lượng khác đã cung cấp các entity cảm biến trong Home Assistant, IAMMETER-Link có thể tải những giá trị đó lên một IAMMETER Virtual Meter để hiển thị trên dashboard cloud, truy cập từ xa và phân tích năng lượng.

Điều này biến Home Assistant thành một cầu nối tương thích:

Thiết bị năng lượng → entity trong Home Assistant → IAMMETER-Link → Virtual Meter → IAMMETER Cloud

Thiết bị nguồn không cần phải là công tơ IAMMETER. Nó có thể là bất kỳ thiết bị nào mà Home Assistant đã tích hợp, miễn là các entity của nó cung cấp số đo năng lượng hợp lệ và đúng tỷ lệ quy đổi.

IAMMETER-Link hữu ích khi bạn muốn kết hợp khả năng tương thích thiết bị rộng rãi của Home Assistant với các dịch vụ giám sát năng lượng và điện mặt trời của IAMMETER Cloud.

IAMMETER-Link làm được gì — và không làm gì

IAMMETER-Link đọc các entity được chọn từ Home Assistant và tải giá trị hiện tại của chúng lên một IAMMETER Virtual Meter.

Nó có thể ánh xạ các giá trị như:

• điện áp tính bằng V;
• dòng điện tính bằng A;
• công suất tác dụng tính bằng W;
• điện năng nhập (import) tính bằng kWh;
• điện năng phát (export) tính bằng kWh;
• mức sạc của pin (state of charge) khi mô hình dữ liệu được cấu hình hỗ trợ.

Nó không:

• đọc trực tiếp một công tơ phần cứng IAMMETER qua HTTP, Modbus hay MQTT;
• tạo ra các số đo năng lượng còn thiếu từ một entity công suất không liên quan;
• biến IAMMETER Cloud thành một dịch vụ hoàn toàn cục bộ (local);
• thay thế tích hợp Home Assistant gốc dành cho thiết bị nguồn.

Để đưa một công tơ phần cứng IAMMETER vào Home Assistant, hãy dùng hướng dẫn tích hợp công tơ năng lượng Home Assistant. IAMMETER-Link truyền dữ liệu theo chiều ngược lại.

Khi nào giám sát năng lượng qua cloud bằng Home Assistant là hữu ích

Biến tần của bên thứ ba đã có trong Home Assistant

Nhiều biến tần đã cung cấp công suất phát và điện năng tích lũy thông qua một tích hợp Home Assistant. IAMMETER-Link có thể ánh xạ các entity đó vào một Virtual Meter để dữ liệu biến tần có thể được xem trong IAMMETER Cloud mà không cần thêm một công tơ vật lý thứ hai chỉ để truyền dữ liệu.

Dữ liệu lưới điện và biến tần đến từ các tích hợp khác nhau

Ví dụ:

• một công tơ IAMMETER giám sát việc nhập/phát lên lưới;
• một tích hợp biến tần của bên thứ ba cung cấp sản lượng PV trong Home Assistant;
• IAMMETER-Link tải các entity của biến tần lên dưới dạng một Virtual Meter;
• IAMMETER Cloud hiển thị dữ liệu phía lưới và phía biến tần trong quy trình giám sát điện mặt trời.

Điều này đặc biệt hữu ích khi một nền tảng không giao tiếp gốc với mọi thương hiệu biến tần.

Cần truy cập từ xa hoặc nhiều địa điểm

Home Assistant có thể vẫn là trung tâm tích hợp cục bộ tại mỗi điểm lắp đặt, trong khi các số đo năng lượng được chọn sẽ được gửi lên IAMMETER Cloud để hiển thị dashboard từ xa và phân tích dài hạn.

Cấu trúc địa điểm và Virtual Meter cụ thể nên được lên kế hoạch trước khi triển khai. Không ánh xạ nhiều hệ thống độc lập vào cùng một số sê-ri Virtual Meter.

Yêu cầu

Trước khi cài đặt, hãy xác nhận bạn có:

• một bản cài đặt Home Assistant đang hoạt động;
• các entity nguồn ổn định cho những số đo cần thiết;
• quyền truy cập internet từ Home Assistant tới IAMMETER Cloud;
• một tài khoản IAMMETER Cloud;
• một số sê-ri IAMMETER Virtual Meter;
• HACS, trừ khi bạn chọn cài đặt custom component thủ công.

Kho lưu trữ IAMMETER-Link:

• Kho GitHub
• Bản phát hành hiện tại v1.1.1

Bản phát hành v1.1.1 bao gồm logic tải lên được tối ưu hóa và xử lý mức sạc pin.

Khoảng thời gian tải lên: Basic và Pro

Khoảng thời gian tải lên phụ thuộc vào gói dịch vụ IAMMETER Cloud:

IAMMETER-Link được thiết kế cho việc báo cáo lên cloud và giám sát từ xa, không dành cho các vòng điều khiển ở mức giây. Hãy giữ các tự động hóa nhanh bên trong Home Assistant bằng các entity cục bộ gốc.

Ví dụ:

• dùng một entity công suất Modbus hoặc MQTT cục bộ cho tự động hóa 2–5 giây;
• dùng IAMMETER-Link cho các cập nhật Cloud mỗi một hoặc năm phút và cho phân tích.

Bước 1: Cài đặt IAMMETER-Link

Cài đặt bằng HACS

1. Đảm bảo HACS đã được cài đặt.
2. Thêm https://github.com/lewei50/ha_iammeter_link như một Integration trong custom repositories của HACS nếu nó chưa có sẵn.
3. Tìm và cài đặt IAMMETER-Link.
4. Khởi động lại Home Assistant khi được yêu cầu.

Thêm tích hợp

Truy cập:

Settings → Devices & services → Add integration

Tìm IAMMETER-Link và bắt đầu Config Flow.

Bước 2: Đăng nhập và chọn Virtual Meter

Nhập thông tin tài khoản IAMMETER Cloud của bạn trong quá trình thiết lập. Nếu bạn chưa có tài khoản, hãy làm theo tùy chọn đăng ký mà luồng cấu hình cung cấp.

Nếu tài khoản đã có một Virtual Meter khả dụng, hãy chọn số sê-ri của nó. Nếu không, hãy yêu cầu hoặc tạo Virtual Meter phù hợp thông qua quy trình có sẵn trên IAMMETER Cloud.

Hãy coi số sê-ri Virtual Meter là danh tính đích cho luồng dữ liệu này. Tránh cấu hình nhiều client tải lên để ghi các hệ thống khác nhau vào cùng một Virtual Meter.

Bước 3: Chọn một pha hoặc ba pha

Chọn cấu trúc phù hợp với dữ liệu nguồn:

• Single Phase cho một nhóm điện áp, dòng điện, công suất, Import kWh và Export kWh;
• Three Phase cho các ánh xạ entity riêng biệt theo pha A, B và C.

Với dữ liệu ba pha, hãy xác định cẩn thận vai trò và ánh xạ của từng pha. IAMMETER Cloud dùng cấu trúc này khi hiển thị và phân tích các giá trị đã tải lên.

Đừng chọn ba pha chỉ vì có nhiều cảm biến trong Home Assistant. Các entity phải đại diện cho đúng các pha điện hoặc kênh đo tương ứng.

Bước 4: Ánh xạ các entity của Home Assistant

IAMMETER-Link ánh xạ ID entity của Home Assistant vào các trường của Virtual Meter.

Ánh xạ một pha

Ánh xạ ba pha

Ánh xạ các trường tương tự một cách riêng biệt cho pha A, B và C.

Một trường không dùng có thể được đặt là 0. Tuy nhiên, nếu một trường được ánh xạ tới một entity và entity đó không thể đọc đúng khi chạy, quá trình tải lên có thể dừng lại. Chỉ ánh xạ những entity đã được xác minh là ổn định.

Xác minh mọi entity trước khi ánh xạ

Mở Developer tools → States trong Home Assistant và xác minh:

1. entity tồn tại;
2. trạng thái của nó là số;
3. đơn vị đo là đúng;
4. giá trị có dấu như mong đợi;
5. nó vẫn khả dụng sau khi khởi động lại Home Assistant;
6. điện năng tích lũy không hành xử như công suất tức thời.

Công suất phải tính bằng watt

Nếu nguồn báo cáo bằng kW, hãy tạo một cảm biến quy đổi phù hợp hoặc dùng một entity đã được chia tỷ lệ đúng trước khi ánh xạ. Không gán nhãn một giá trị kW là W mà không nhân với 1.000.

Điện năng phải là kWh tích lũy

Các trường Import và Export thông thường nên dùng entity kWh tích lũy. Một cảm biến điện năng theo ngày, tự đặt lại vào nửa đêm, có ngữ nghĩa khác với tổng điện năng trọn đời và có thể làm sai lệch phân tích trên Cloud nếu bị coi là tổng điện năng.

Xác nhận chiều import/export

Các tích hợp khác nhau dùng những thuật ngữ như import, consumption, feed-in, return, export, bought hoặc sold. Hãy xác nhận mỗi entity đại diện cho chiều nào trước khi ánh xạ nó.

Không tự tạo ra các số đo không có sẵn

Nếu một tích hợp biến tần cung cấp sản lượng PV nhưng không có nhập/phát lên lưới, hãy ánh xạ các trường sản lượng có sẵn vào đúng vai trò của Virtual Meter. Đừng dùng lại cùng một entity công suất cho cả công suất phát điện và công suất lưới chỉ để lấp đầy mọi trường.

Bước 5: Kiểm tra dữ liệu đã tải lên trong IAMMETER Cloud

Sau khi hoàn tất cấu hình, hãy chờ hết khoảng thời gian tải lên tương ứng của gói Basic hoặc Pro, rồi mở IAMMETER Cloud.

Kiểm tra:

• Virtual Meter đang online;
• điện áp, dòng điện và công suất có độ lớn hợp lý;
• Import và Export không bị đảo ngược;
• các pha A/B/C xuất hiện theo đúng thứ tự mong đợi;
• điện năng tích lũy tăng đúng cách;
• dấu thời gian tiếp tục được cập nhật;
• biểu đồ điện mặt trời hoặc phụ tải khớp với lịch sử Home Assistant của nguồn.

Hãy so sánh một vài mốc thời gian giữa Home Assistant và IAMMETER Cloud trước khi tin vào các báo cáo.

Ví dụ giám sát điện mặt trời

Giả sử một hệ thống lắp đặt có:

• một công tơ ba pha IAMMETER đo phía lưới;
• một biến tần ba pha đã được tích hợp vào Home Assistant;
• không có kết nối dữ liệu trực tiếp được hỗ trợ giữa biến tần đó và IAMMETER Cloud.

IAMMETER-Link có thể gửi các entity công suất và điện năng của biến tần trong Home Assistant tới một Virtual Meter ba pha. IAMMETER Cloud sau đó có thể dùng:

• công tơ vật lý cho tương tác với lưới;
• Virtual Meter cho sản lượng của biến tần;
• cả hai nguồn dữ liệu trong chế độ xem giám sát điện mặt trời tổng thể.

Xem giải pháp giám sát điện mặt trời của IAMMETER và giám sát điện mặt trời với Home Assistant để biết các trường hợp sử dụng liên quan.

Xử lý sự cố

Không có dữ liệu xuất hiện sau khi thiết lập

• Xác nhận Home Assistant có quyền truy cập internet.
• Kiểm tra tài khoản IAMMETER Cloud và số sê-ri Virtual Meter.
• Chờ hết khoảng thời gian tải lên đầy đủ của gói Basic hoặc Pro.
• Kiểm tra log của Home Assistant để tìm lỗi IAMMETER-Link.
• Xác nhận mọi entity được ánh xạ đều tồn tại và trả về giá trị dạng số.

Quá trình tải lên dừng lại sau khi đã hoạt động bình thường

• Tìm một entity được ánh xạ đã trở thành unknown hoặc unavailable.
• Kiểm tra xem một bản cập nhật tích hợp có đổi tên ID entity không.
• Xác nhận một template sensor vẫn trả về một con số.
• Xem lại các lỗi xác thực và lỗi mạng.
• Cập nhật lên bản phát hành IAMMETER-Link mới nhất.

Giá trị lớn hơn hoặc nhỏ hơn 1.000 lần

• Kiểm tra W so với kW.
• Kiểm tra kWh so với Wh.
• Kiểm tra mọi chuyển đổi template đã áp dụng trong Home Assistant.
• Xác nhận tỷ số CT bên ngoài trong hệ thống đo của nguồn.

Import và Export bị đảo ngược

• Xác minh quy ước đặt tên của tích hợp nguồn.
• So sánh giá trị khi địa điểm đang rõ ràng nhập từ lưới hoặc phát lên lưới.
• Sửa ánh xạ entity thay vì bù trừ trong báo cáo Cloud.

Biểu đồ ba pha trông sai

• Xác nhận ánh xạ A/B/C và vai trò của các pha.
• Xác minh mỗi entity thuộc đúng pha dự định.
• Không trộn lẫn tổng công suất với các trường riêng theo pha.

Điều khiển cục bộ và báo cáo lên Cloud nên tách biệt

IAMMETER-Link phụ thuộc vào Home Assistant, quyền truy cập internet và IAMMETER Cloud. Nó không nên là đường phản hồi cho các tự động hóa quan trọng về an toàn hoặc ở mức giây.

Dùng các entity cục bộ của Home Assistant cho:

• điều khiển relay;
• chuyển mạch theo điện mặt trời dư;
• quyết định sạc xe điện;
• các cảnh báo cần phản hồi tức thời.

Dùng IAMMETER-Link và IAMMETER Cloud cho:

• khả năng quan sát từ xa;
• dashboard dài hạn;
• phân tích chi phí điện và năng lượng;
• kết hợp các nguồn năng lượng được chọn;
• đánh giá vận hành nhiều địa điểm.

Hướng dẫn liên quan

• Kho GitHub IAMMETER-Link
• IAMMETER-Link v1.1.1
• IAMMETER Virtual Meter
• IAMMETER Cloud
• So sánh các tích hợp công tơ năng lượng Home Assistant
• Ma trận tích hợp Home Assistant

Cập nhật: 22 tháng 7, 2026.