HOME ASSISTANT · MODBUS TCP CỤC BỘ
Tích hợp đồng hồ đo năng lượng Modbus TCP cho Home Assistant
Modbus TCP là một trong những cách nhanh nhất để kết nối đồng hồ đo năng lượng với Home Assistant. Nó hoạt động qua mạng cục bộ, không phụ thuộc vào kết nối internet và phù hợp cho giám sát công suất theo thời gian thực, tự động hóa phần năng lượng mặt trời dư thừa, điều khiển tải và Bảng điều khiển Năng lượng của Home Assistant.
Tất cả đồng hồ đo năng lượng IAMMETER hiện hành đều hỗ trợ Modbus TCP. Chọn một trong ba tuyến tích hợp Home Assistant, tùy theo kiểu đồng hồ và giao diện bạn muốn sử dụng:
- Tích hợp IAMMETER HACS Modbus — cấu hình qua giao diện người dùng, thực thể được tạo tự động và khoảng thời gian quét có thể cấu hình.
- Tích hợp Modbus tích hợp sẵn trong Home Assistant — cấu hình YAML với khả năng kiểm soát trực tiếp các thanh ghi và cảm biến.
- Tích hợp tùy chỉnh SunSpec — cấu hình qua giao diện người dùng, phát hiện kiểu đồng hồ chuẩn và tự động tạo các thực thể đo lường trên các kiểu máy được hỗ trợ.
Cả IAMMETER HACS Modbus và tích hợp tùy chỉnh SunSpec tương thích đều cung cấp thiết lập qua giao diện người dùng mà không cần YAML riêng cho từng cảm biến. Sử dụng tích hợp Modbus tích hợp sẵn khi bạn muốn tự định nghĩa thanh ghi và cảm biến. Tính khả dụng của SunSpec tuân theo phạm vi kiểu máy trong hướng dẫn chính thức của IAMMETER bên dưới.
Khám phá hướng dẫn này
So sánh ba tuyến tích hợp Modbus TCP
Cả ba tuyến đều đọc đồng hồ qua Modbus TCP. IAMMETER HACS và YAML tích hợp sẵn sử dụng bản đồ thanh ghi IAMMETER; tích hợp SunSpec phát hiện và đọc các kiểu đồng hồ SunSpec chuẩn.
| Tính năng | IAMMETER HACS Modbus | Modbus tích hợp sẵn của Home Assistant | Tích hợp tùy chỉnh SunSpec |
|---|---|---|---|
| Cấu hình phía HA | Giao diện người dùng | YAML | Giao diện người dùng sau khi cài đặt tích hợp tùy chỉnh tương thích |
| Cấu hình thanh ghi | Được tạo bởi tích hợp | Được định nghĩa thủ công | Được phát hiện từ các kiểu đồng hồ SunSpec chuẩn |
| Khoảng thời gian quét | Có thể cấu hình; mặc định 3 giây | Có thể cấu hình cho từng cảm biến | Được cấu hình trong tích hợp đã chọn |
| Siêu dữ liệu Bảng điều khiển Năng lượng | Được bao gồm cho các thực thể năng lượng được hỗ trợ | Phải được cấu hình trong YAML | Được cung cấp bởi ứng dụng khách tương thích; xác minh đơn vị và siêu dữ liệu |
| Phát hiện tự động/hỗ trợ | Thiết lập có hỗ trợ SSDP | Không | Phát hiện kiểu máy sau khi kết nối; không giống với tự động phát hiện qua LAN |
| Hoạt động cục bộ | Có | Có | Có |
| Có thể tiếp tục sử dụng IAMMETER Cloud | Có | Có | Có |
| Phù hợp nhất cho | Hầu hết người dùng Home Assistant | Người dùng nâng cao và thanh ghi tùy chỉnh | Người dùng ưa thích các kiểu SunSpec chuẩn và thiết lập qua giao diện người dùng |
Chọn IAMMETER HACS Modbus để có các thực thể dành riêng cho IAMMETER được tạo sẵn. Chọn tích hợp tùy chỉnh SunSpec cho tuyến kiểu đồng hồ chuẩn dựa trên giao diện người dùng trên các kiểu máy được hỗ trợ. Chọn Modbus YAML tích hợp sẵn cho danh sách thanh ghi tùy chỉnh, quy ước đặt tên thực thể, quy tắc chia tỷ lệ hoặc khoảng thời gian thăm dò cho từng cảm biến.
Để so sánh thăm dò HTTP có thể điều chỉnh, MQTT và các lựa chọn tích hợp khác, hãy xem tổng quan tích hợp đồng hồ đo năng lượng cho Home Assistant.
Không cần YAML riêng cho từng cảm biến: cả IAMMETER HACS Modbus và tuyến tích hợp tùy chỉnh SunSpec đều có thể cung cấp thiết lập qua giao diện người dùng. Tùy chọn SunSpec yêu cầu cài đặt một tích hợp tùy chỉnh tương thích; đây không phải là công tắc gốc bên trong tích hợp Modbus chung tích hợp sẵn của HA.
DÙNG THỬ TRƯỚC KHI MUA
Kiểm tra Modbus TCP mà không cần đồng hồ vật lý
Sử dụng trình mô phỏng công khai để kết nối Home Assistant, kiểm tra số đọc của cảm biến và thử bảng điều khiển hoặc điều kiện tự động hóa trước khi mua hoặc lắp đặt đồng hồ.
Làm theo hướng dẫn tích hợp Modbus cho Home Assistant →
Mở trình mô phỏng WEM2067 →Trước khi bạn bắt đầu
Bạn cần:
- một đồng hồ đo năng lượng IAMMETER được kết nối với cùng LAN với Home Assistant;
- địa chỉ IP cục bộ của đồng hồ;
- cổng TCP
502có thể truy cập giữa Home Assistant và đồng hồ; - firmware hiện tại được hỗ trợ cho đồng hồ từ Cập nhật firmware IAMMETER;
- HACS đã được cài đặt nếu bạn chọn tích hợp IAMMETER HACS.
Bạn nên đặt trước địa chỉ IP của đồng hồ trong bộ định tuyến. Địa chỉ DHCP thay đổi là lý do phổ biến khiến một tích hợp Modbus đang hoạt động trở nên không khả dụng sau này.
Phương pháp 1: Cấu hình IAMMETER Modbus qua HACS
Tích hợp IAMMETER HACS Modbus được thiết kế cho người dùng muốn có dữ liệu cục bộ nhanh chóng mà không cần tự định nghĩa từng thanh ghi trong YAML.
Bước 1: Cài đặt tích hợp
- Mở HACS trong Home Assistant.
- Tìm kiếm IamMeter Modbus.
- Cài đặt bản phát hành mới nhất.
- Khởi động lại Home Assistant nếu được nhắc.
Thông tin dự án và bản phát hành:
Sử dụng bản phát hành tích hợp được cập nhật. Khoảng thời gian thăm dò đã cấu hình được áp dụng khi đồng hồ trực tuyến; tích hợp giảm các lần thử kết nối lặp lại khi đồng hồ ngoại tuyến.
Bước 2: Thêm đồng hồ trong Home Assistant
- Đi tới Cài đặt → Thiết bị & dịch vụ.
- Chọn Thêm tích hợp.
- Tìm kiếm IamMeter Modbus.
- Nhập địa chỉ IP của đồng hồ và cổng Modbus TCP.
- Chọn kiểu đồng hồ hoặc cấu hình pha phù hợp.
- Đặt khoảng thời gian quét hoặc giữ giá trị mặc định là 3 giây.
- Gửi biểu mẫu và xác nhận rằng thiết bị và các thực thể đã được tạo.
Tích hợp tạo số lượng thực thể khác nhau cho đồng hồ một pha, hai kênh và ba pha. Danh sách thực thể ngắn hơn không có nghĩa là kiểu một pha có hỗ trợ Home Assistant hạn chế.
Bước 3: Kiểm tra các thực thể
Mở thiết bị IAMMETER trong Cài đặt → Thiết bị & dịch vụ. Tùy thuộc vào kiểu máy, các thực thể khả dụng có thể bao gồm:
- điện áp;
- dòng điện;
- công suất tác dụng;
- hệ số công suất;
- năng lượng nhập;
- năng lượng xuất;
- công suất phản kháng hoặc năng lượng phản kháng khi được đồng hồ và bộ thanh ghi áp dụng cung cấp.
Các thực thể năng lượng nhập và xuất sử dụng kWh và bao gồm siêu dữ liệu năng lượng Home Assistant mà Bảng điều khiển Năng lượng yêu cầu.
Bước 4: Chọn khoảng thời gian quét phù hợp
Khoảng thời gian quét mặc định là 3 giây. Đây là điểm khởi đầu thực tế cho bảng điều khiển trực tiếp và tự động hóa dựa trên công suất.
Điểm khởi đầu được đề xuất:
| Ứng dụng | Khoảng thời gian quét được đề xuất |
|---|---|
| Điều khiển rơ-le hoặc năng lượng mặt trời dư thừa theo thời gian thực | 1–5 giây |
| Bảng điều khiển công suất trực tiếp | 3–10 giây |
| Giám sát năng lượng chung | 10–30 giây |
Cài đặt một giây là một yêu cầu thăm dò, không phải bảo đảm rằng mọi bảng điều khiển Home Assistant sẽ làm mới rõ ràng mỗi giây một lần. Độ trễ mạng, số lượng thanh ghi, tải trình ghi và hành vi làm mới giao diện người dùng cũng ảnh hưởng đến kết quả.
Tránh thăm dò quá mức không cần thiết. Đối với hầu hết tự động hóa, cập nhật ổn định 2–5 giây hữu ích hơn khoảng thời gian ngắn nhất có thể.
Phương pháp 2: Sử dụng tích hợp Modbus tích hợp sẵn của Home Assistant
Home Assistant bao gồm tích hợp Modbus chuẩn. Phương pháp này hoàn toàn cục bộ và không yêu cầu HACS, nhưng kết nối và cảm biến được định nghĩa trong YAML.
Ví dụ sau đọc điện áp và công suất tác dụng từ đồng hồ một pha:
modbus:
- name: iammeter_hub
type: tcp
host: 192.168.1.6
port: 502
sensors:
- name: IAMMETER Voltage
slave: 1
address: 0
input_type: holding
data_type: uint16
scale: 0.01
precision: 1
unit_of_measurement: V
device_class: voltage
state_class: measurement
scan_interval: 5
- name: IAMMETER Active Power
slave: 1
address: 2
input_type: holding
data_type: int32
unit_of_measurement: W
device_class: power
state_class: measurement
scan_interval: 5
Thay 192.168.1.6 bằng địa chỉ IP thực tế của đồng hồ. Kiểm tra bản đồ thanh ghi áp dụng trước khi thêm cảm biến:
Các thanh ghi Modbus IAMMETER phổ biến
Các địa chỉ sau minh họa các khối pha tiêu chuẩn được các đồng hồ IAMMETER phổ biến sử dụng. Luôn sử dụng tài liệu thanh ghi hiện tại làm tham chiếu có thẩm quyền.
| Phép đo | Pha A / một pha | Pha B | Pha C | Kiểu dữ liệu |
|---|---|---|---|---|
| Điện áp | 0 | 10 | 20 | uint16 |
| Dòng điện | 1 | 11 | 21 | uint16 |
| Công suất tác dụng | 2 | 12 | 22 | int32 |
| Năng lượng nhập | 4 | 14 | 24 | uint32 |
| Năng lượng xuất | 6 | 16 | 26 | uint32 |
Sử dụng tỷ lệ, độ chính xác và thứ tự từ đã được ghi trong tài liệu cho từng thanh ghi. Không suy ra tỷ lệ năng lượng từ ví dụ điện áp.
Sau khi chỉnh sửa YAML:
- chạy kiểm tra cấu hình của Home Assistant;
- khởi động lại Home Assistant;
- mở Công cụ dành cho nhà phát triển → Trạng thái;
- xác nhận rằng các thực thể mới có giá trị và đơn vị hợp lý.
MỘT TÙY CHỌN KHÁC DỰA TRÊN GIAO DIỆN NGƯỜI DÙNG
Phương pháp 3: Sử dụng SunSpec qua Modbus TCP mà không cần YAML cảm biến
Các đồng hồ IAMMETER được hỗ trợ cung cấp các kiểu đồng hồ SunSpec chuẩn song song với bản đồ thanh ghi Modbus hiện có. Một tích hợp SunSpec tương thích cho Home Assistant có thể phát hiện các kiểu đó và tạo cảm biến thông qua cấu hình giao diện người dùng, vì vậy bạn không cần định nghĩa mọi thanh ghi trong YAML.
Đọc hướng dẫn hỗ trợ và tích hợp SunSpec Modbus/TCP của IAMMETER chính thức để biết các ánh xạ kiểu máy, phép đo và giới hạn được hỗ trợ.
Cấu hình tích hợp SunSpec tương thích
- Cài đặt một tích hợp tùy chỉnh SunSpec tương thích cho Home Assistant, chẳng hạn như SunSpec cho Home Assistant, theo hướng dẫn cài đặt của nó.
- Trong Cài đặt → Thiết bị & dịch vụ, thêm tích hợp SunSpec đã cài đặt và chọn tùy chọn kết nối Modbus TCP của nó.
- Nhập địa chỉ IP LAN của đồng hồ vật lý, cổng TCP
502và Unit ID phù hợp. Nếu ứng dụng khách yêu cầu địa chỉ bắt đầu phát hiện, hãy dùng40000theo quy ước bắt đầu từ 0 được IAMMETER ghi trong tài liệu. - Để tích hợp phát hiện các kiểu đồng hồ Common và kiểu số nguyên được hỗ trợ. Chọn các phép đo và khoảng thời gian thăm dò phù hợp, sau đó xác minh giá trị và đơn vị năng lượng.
- Giữ tính năng ghi bị tắt: bản đồ SunSpec của IAMMETER chỉ đọc.
Kiểm tra phạm vi hỗ trợ đã công bố
Hướng dẫn chính thức liệt kê WEM3080, WEM2067, WEM3050T, WEM3080T, WEM3046T và WEM3063T với ánh xạ kiểu đồng hồ số nguyên. Xác thực vật lý được báo cáo của hướng dẫn bao gồm WEM3080T; các kiểu máy khác được liệt kê vẫn cần kiểm thử thiết bị.
Hướng dẫn chưa tuyên bố tính khả dụng của Model 204 cho WEM3080TD và WEM3046TE vẫn chưa có xác minh nhận diện kiểu máy chuyên dụng. Hãy sử dụng phạm vi đã được ghi trong tài liệu đó thay vì giả định mọi kiểu máy đều có hỗ trợ SunSpec giống hệt nhau.
Năng lượng SunSpec sử dụng Wh với các hệ số tỷ lệ, khác với các thực thể kWh trong các ví dụ dành riêng cho IAMMETER. Xác nhận rằng tích hợp xử lý đúng các đơn vị và trường không khả dụng.
Chọn tích hợp, không phải một công tắc YAML ẩn. Hỗ trợ SunSpec không biến tích hợp Modbus YAML chung tích hợp sẵn của Home Assistant thành thiết lập qua giao diện người dùng. Cài đặt một tích hợp SunSpec tương thích cho tuyến đó. IAMMETER HACS Modbus đã cung cấp một tùy chọn riêng không cần YAML cảm biến bằng cách sử dụng thanh ghi IAMMETER. Triển khai SunSpec không được chứng nhận SunSpec và phải kiểm tra khả năng tương thích của ứng dụng khách.
Tải firmware hiện tại được hỗ trợ từ Cập nhật firmware IAMMETER. Giữ một tích hợp thăm dò đang hoạt động cho mỗi đồng hồ khi so sánh các phương pháp.
Thêm năng lượng nhập và xuất vào Bảng điều khiển Năng lượng
Bảng điều khiển Năng lượng của Home Assistant cần các thực thể năng lượng tích lũy, không phải công suất tức thời.
Đối với cảm biến năng lượng Modbus được cấu hình thủ công, hãy bao gồm siêu dữ liệu phù hợp:
unit_of_measurement: kWh
device_class: energy
state_class: total_increasing
Sau đó đi tới Cài đặt → Bảng điều khiển → Năng lượng và chọn thực thể năng lượng nhập làm mức tiêu thụ từ lưới và thực thể năng lượng xuất làm điện trả về lưới.
Không chọn thực thể công suất tác dụng đo bằng watt cho trường năng lượng của Bảng điều khiển Năng lượng. Công suất hiển thị tốc độ hiện tại; kWh nhập/xuất ghi lại năng lượng tích lũy.
Các kiểu IAMMETER được hỗ trợ
Tất cả đồng hồ đo năng lượng IAMMETER hiện hành đều hỗ trợ cả HACS Modbus và tích hợp Modbus tích hợp sẵn của Home Assistant.
| Kiểu máy | Cấu hình đồng hồ | Ghi chú cho Home Assistant |
|---|---|---|
| WEM3080 | Một pha | Bộ thực thể một pha |
| WEM2067 | Hai kênh cho ứng dụng một pha | Hai kênh đo |
| WEM3080T | Ba pha | Các nhóm ba pha/thực thể |
| WEM3050T | Ba pha hoặc tách pha | Ba kênh đo |
| WEM3080TD | Ba pha/ba dây và đấu dây đặc biệt | Diễn giải các thực thể theo chế độ đấu dây |
| WEM3046T / WEM3046TE | Đầu vào CT 5 A bên ngoài | Áp dụng tỷ số CT bên ngoài |
WEM3046T và WEM3046TE đo đầu ra thứ cấp 5 A của một máy biến dòng bên ngoài. Để có được dòng điện, công suất và năng lượng thực tế phía sơ cấp, phải áp dụng đúng tỷ số CT. Đây là đặc điểm của hệ thống đo CT 5 A, không phải giới hạn tương thích của Home Assistant hay Modbus.
Modbus và IAMMETER Cloud có thể hoạt động cùng lúc không?
Có. Home Assistant đọc Modbus TCP cục bộ trong khi đồng hồ có thể tiếp tục tải lên IAMMETER Cloud. Bạn không cần chuyển đồng hồ sang chế độ tải lên MQTT để sử dụng Modbus.
Điều này mang lại cho bạn hai chế độ xem bổ sung:
- dữ liệu cục bộ nhanh và tự động hóa trong Home Assistant;
- báo cáo dài hạn, phân tích chi phí điện, phân tích năng lượng mặt trời và truy cập từ xa trong IAMMETER Cloud.
Tránh nhiều ứng dụng khách Modbus tần số cao
Sử dụng một ứng dụng khách thăm dò Modbus TCP đang hoạt động cho mỗi đồng hồ làm mô hình triển khai an toàn. Không cấu hình Home Assistant, Node-RED, PLC và một bộ ghi khác để thăm dò cùng một đồng hồ một cách độc lập ở tần số cao.
Nếu nhiều hệ thống cần cùng các phép đo trực tiếp, hãy để một hệ thống đọc Modbus và phân phối lại dữ liệu, hoặc sử dụng kiến trúc MQTT trong đó nhiều bên tiêu thụ đăng ký với một broker.
Khắc phục sự cố
Home Assistant không thể kết nối tới cổng 502
- Xác nhận rằng Home Assistant và đồng hồ ở trên cùng một mạng có thể truy cập được.
- Xác minh địa chỉ IP của đồng hồ và đặt trước nó trong bộ định tuyến.
- Kiểm tra rằng cổng TCP
502không bị tường lửa hoặc quy tắc VLAN chặn. - Đảm bảo rằng một ứng dụng khách Modbus khác không giữ hoặc liên tục mở lại kết nối.
Các thực thể không khả dụng hoặc giá trị không thay đổi
- Xác nhận kiểu đồng hồ/pha đã chọn trong tích hợp HACS.
- Với YAML, xác minh ID slave, địa chỉ thanh ghi, kiểu dữ liệu, tỷ lệ và thứ tự từ.
- Tạm thời tăng khoảng thời gian quét để loại trừ việc thăm dò quá mức.
- Sử dụng tùy chọn Cấu hình lại của tích hợp để cập nhật địa chỉ hoặc cổng đồng hồ đã thay đổi, sau đó xác nhận rằng việc đọc tiếp tục.
Giá trị cao hoặc thấp một cách không hợp lý
- Kiểm tra tỷ lệ thanh ghi và kiểu dữ liệu.
- Đối với WEM3046T/WEM3046TE, xác minh tỷ số CT bên ngoài.
- Xác nhận rằng thực thể tương ứng với pha hoặc kênh đo mong đợi.
Các thực thể năng lượng không xuất hiện trong Bảng điều khiển Năng lượng
- Sử dụng năng lượng nhập/xuất tích lũy tính bằng kWh.
- Xác nhận
device_class: energy. - Xác nhận
state_class: total_increasing. - Không sử dụng thực thể công suất tính bằng watt.
Xây dựng tự động hóa với dữ liệu công suất theo thời gian thực
Khi các thực thể Modbus hoạt động, Home Assistant có thể sử dụng công suất tác dụng hoặc công suất xuất lên lưới để điều khiển các thiết bị khác. Ví dụ bao gồm:
- điều khiển rơ-le từ dữ liệu công suất Modbus theo thời gian thực;
- sạc xe điện khi lượng điện mặt trời xuất lên lưới vượt ngưỡng;
- đun nước bằng phần năng lượng mặt trời dư thừa sẵn có;
- thông báo cho người dùng khi nhu cầu điện trong nhà vượt giới hạn;
- giảm tải có thể điều khiển trước khi nhập điện giờ cao điểm đắt tiền.
Trước tiên hãy thiết lập các số đọc đáng tin cậy. Chỉ thêm logic điều khiển sau khi kiểm tra quy ước dấu, đơn vị, khoảng thời gian cập nhật và hành vi khi đồng hồ trở nên không khả dụng.
Các hướng dẫn Home Assistant liên quan
Lịch sử cập nhật
- Đã thêm hướng dẫn kiểm tra Modbus bằng trình mô phỏng công khai và lối vào trực tiếp cho trình mô phỏng.
- Đã thêm tuyến tích hợp SunSpec qua giao diện người dùng, cùng phạm vi hỗ trợ chính thức của IAMMETER và các tài liệu tham chiếu cấu hình.
- Đã làm mới hướng dẫn về thăm dò và kết nối, đồng thời thiết kế lại hướng dẫn cho máy tính để bàn và thiết bị di động.
- Đã trình bày IAMMETER HACS, YAML tích hợp sẵn và tích hợp tùy chỉnh SunSpec như ba lựa chọn Modbus TCP song song.