Tài liệu

Đọc và điều khiển Trình quản lý sạc cFos qua Modbus

Ngoài HTTP và MQTT, Trình quản lý sạc cFos còn cung cấp API Modbus. Điều này được mô phỏng theo SunSpec. Trong cấu hình Trình quản lý sạc, bạn có thể chỉ định tham số cổng TCP hoặc cổng COM cũng như ID Modbus trong "Cài đặt địa chỉ SunSpec. Điều này có nghĩa là Trình quản lý sạc cFos lắng nghe cổng TCP hoặc cổng COM theo các tham số đã chỉ định và theo ID Modbus và ID Modbus + 1. Các giá trị, tham số, cờ và biến của Trình quản lý sạc chung có sẵn trong ID Modbus. Các thiết bị (hộp treo tường và đồng hồ đo) được thiết lập trong Trình quản lý sạc có thể được truy vấn theo ID + 1. Là một chức năng Modbus, bạn có thể sử dụng 3 và Sử dụng 4 để đọc và 6 và 16 để viết . Chú ý: Trên Raspberry, các cổng TCP dưới 1024 được dành riêng cho các chương trình có quyền quản trị viên. Do đó, tốt hơn nên chọn số cổng cao hơn, ví dụ: 1502.

Đặc tả SunSpec Modbus nêu rõ rằng phạm vi địa chỉ Modbus bắt đầu bằng mã định danh "SunS" và sau đó chứa cái gọi là các mô hình SunSpec. Mỗi mô hình có một số khóa mô hình ở offset 0 và độ dài của các thanh ghi còn lại thuộc mô hình ở offset 1. Các giá trị của mô hình sau đó sẽ theo sau từ offset 2. Quan trọng: Bạn nên quét dải địa chỉ SunSpec và luôn vượt quá độ dài ở offset 1. Đừng giả sử độ dài cố định hoặc địa chỉ thanh ghi cố định, vì rất có thể chúng ta sẽ thêm các giá trị bổ sung vào mô hình theo thời gian. Model 1 (Common) luôn đi đầu với thông tin chi tiết về nhà sản xuất, số phiên bản, v.v. Vui lòng tải xuống thông số kỹ thuật SunSpec Modbus từ SunSpec Alliance để biết thông tin chi tiết. Dải địa chỉ SunSpec cho Trình quản lý sạc cFos bắt đầu bằng địa chỉ 40000.

Trình quản lý sạc cFos ban đầu hiển thị các giá trị sau trong ID Modbus theo mô hình phổ biến là mô hình 213 (đồng hồ ba pha, phao):
Tham chiếu lưới
Tổng số người tiêu dùng
Tổng sản lượng
thặng dư PV
Nguồn điện Wallbox đã sử dụng
Hiệu suất hộp treo tường có sẵn
Hiệu suất lỗi

Sau đó, làm theo mô hình "tùy chỉnh" 60000 với các tham số cài đặt của Trình quản lý sạc cFos: Theo kiểu máy và chiều dài, hiện tại có 8 giá trị nổi: tổng dòng tối đa, dự trữ, thấu chi, tổng dòng điện tối đa của hộp treo tường tính bằng mA trên mỗi pha, độ lệch pha tối đa (tính bằng mA), quản lý tải hoạt động (1 = hoạt động, 0 = không hoạt động), nghiêng bao gồm cả người tiêu dùng (1 = hoạt động, 0 = không hoạt động), tổng dòng điện tối đa tính bằng phần trăm. Đây là các thông số Trình quản lý sạc chung cũng có thể được đặt trong giao diện người dùng. Các thay đổi đối với các giá trị này sẽ được lưu (với độ trễ tối đa là 150 giây). Tỷ lệ phần trăm của tổng dòng điện có thể được sử dụng để điều chỉnh linh hoạt công suất sạc, ví dụ như theo yêu cầu của nhà điều hành mạng.

Tiếp theo là mô hình “tùy chỉnh” 60001. 32 thanh ghi (16 bit) tuân theo mô hình và độ dài. Chúng có thể chứa các giá trị 0 và 1 và đọc hoặc ghi tối đa 32 cờ Trình quản lý sạc. Sau đó, trạng thái của các cờ này có thể được truy vấn trong các công thức sử dụng CM._flag1 đến CM._flag32 và được sử dụng để tính toán.

Sau đó làm theo mô hình "tùy chỉnh" 60002. Các biến quản lý tính phí có thể có theo mô hình và độ dài. Có 22 thanh ghi có sẵn cho mỗi biến. 20 thanh ghi đầu tiên là chuỗi Modbus cho tên biến (tên quá dài sẽ bị cắt bớt). 2 thanh ghi sau chứa giá trị float hiện tại của biến. Khi bạn viết giá trị thực của biến Trình quản lý sạc, bạn xóa mọi công thức hiện có và đặt biến thành giá trị cố định.

Đồng hồ đo và hộp treo tường được thiết lập trong Trình quản lý sạc được hiển thị như sau trong Modbus ID + 1. Giống như SunSpec Model 113, hộp treo tường được mở rộng để bao gồm hai thanh ghi 16 bit. Offset 62 hiển thị trạng thái của hộp treo tường (1=đang chờ, 2=đã cắm điện, 3=đang sạc, 4=đang sạc có thông gió, 5=lỗi) và offset 63 hiển thị ID thiết bị. 1 = E1, 2 = E2, v.v. Bộ đếm được biểu diễn bằng mô hình 213 được mở rộng bằng 2 thanh ghi 16 bit. Tại offset 126 là vai trò của bộ đếm (0=hiển thị, 1=tiêu thụ, 2=sản xuất, 3=cung cấp lưới điện, 4=Tiêu thụ ô tô điện, 5=lưu trữ tại nhà, 6=lưu trữ mọi thứ), tại offset 127 là ID thiết bị (-1 cho M1, -2 cho M2, v.v.). Nếu bộ đếm là bộ nhớ (vai trò 5 hoặc 6), model 213 được theo sau bởi model 124, được mở rộng bằng thanh ghi 16 bit. ID thiết bị lại ở offset 26. Để các thiết bị được hiển thị dưới Modbus ID + 1, bạn phải kích hoạt “Xuất bản thông tin thiết bị qua Modbus” trong cài đặt thiết bị.

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

Danh sách các giá trị cho model 213:
Bù đắp 0: 213
Bù đắp 1: Chiều dài
Bù 2: Tổng dòng điện L1-L3 (A)
Bù đắp 4: L1 hiện tại (A)
Bù đắp 6: L2 hiện tại (A)
Bù đắp 8: L3 hiện tại (A)
Độ lệch 10: Điện áp (V)
Bù 12: Điện áp L1 (V)
Bù 14: Điện áp L2 (V)
Bù 16: Điện áp L3 (V)
Bù đắp 26: 50Hz
Bù đắp 28: Sức mạnh (W)
Offset 30: Công suất L1 (W)
Bù 32: Công suất L2 (W)
Bù 34: Công suất L3 (W)
Độ lệch 36: Công suất biểu kiến (VA)
Độ lệch 38: Công suất biểu kiến L1 (VA)
Độ lệch 40: Công suất biểu kiến L2 (VA)
Độ lệch 42: Công suất biểu kiến L3 (VA)
Độ lệch 44: Công suất phản kháng (VAr)
Offset 60: Xuất, công suất tác dụng (Wh)
Offset 68: Nhập khẩu, công suất tác dụng (Wh)
Offset 126: Vai trò (có Modbus ID + 1)
Offset 127: ID thiết bị (đối với Modbus ID + 1)

Danh sách các giá trị cho model 113:
Bù đắp 0: 113
Bù đắp 1: Chiều dài
Bù 2: Tổng dòng điện L1-L3 (A)
Bù đắp 4: L1 hiện tại (A)
Bù đắp 6: L2 hiện tại (A)
Bù đắp 8: L3 hiện tại (A)
Bù 16: Điện áp L1 (V)
Bù 18: Điện áp L2 (V)
Bù 20: Điện áp L3 (V)
Bù đắp 22: Sức mạnh (W)
Bù 24: 50Hz
Độ lệch 26: Công suất biểu kiến (VA)
Offset 32: Nhập khẩu, công suất tác dụng (Wh)
Offset 62: Trạng thái (có Modbus ID + 1)
Offset 63: ID thiết bị (đối với Modbus ID + 1)

Danh sách các giá trị cho model 124:
Bù đắp 0: 124
Bù đắp 1: Chiều dài
Bù 2: Công suất sạc/xả tối đa (W)
Độ lệch 3: Phần trăm giới hạn nguồn sạc hiện tại
Độ lệch 4: Phần trăm giới hạn công suất phóng điện hiện tại
Bù trừ 8: Trạng thái tính phí theo phần trăm
Offset 18: Hệ số tỷ lệ cho offset 2
Offset 19: Hệ số tỷ lệ cho offset 3 và 4
Offset 26: ID thiết bị (đối với Modbus ID + 1)

Danh sách các giá trị cho model 60000:
Tất cả các giá trị trong float, quyền truy cập đọc/ghi, khiến flash được cập nhật, tức là không thay đổi thường xuyên để tránh hư hỏng.
Bù đắp 0: 60000 (unt16, chỉ đọc)
Độ lệch 1: Độ dài (uint16, chỉ đọc)
Độ lệch 2: Tổng dòng điện tối đa (mA)
Bù đắp 4: Dự trữ năng lượng (mA)
Bù trừ 6: Thấu chi (mA)
Bù 8: Tổng dòng điện tối đa của hộp treo tường (mA)
Độ lệch 10: Độ lệch pha tối đa (mA)
Bù đắp 12: 1 = quản lý tải đang hoạt động, 0 = không hoạt động
Bù đắp 14: 1 = Thêm mức tiêu thụ nhà vào sự mất cân bằng, 0 = không hoạt động
Độ lệch 16: Phần trăm của tổng dòng điện tối đa, không được lưu, có thể thay đổi thường xuyên.

Danh sách các giá trị cho model 60001:
Tất cả các giá trị 0 hoặc 1, int16, truy cập đọc/ghi, không được lưu, có thể thay đổi thường xuyên.
Bù đắp 0: 60001 (uint16, chỉ đọc)
Độ lệch 1: Độ dài (uint16, chỉ đọc)
Bù đắp 2: CM._flag1
...
Bù đắp 33: CM._flag32

Danh sách các giá trị cho model 60002:
Tất cả các giá trị float, quyền truy cập đọc/ghi, không được lưu, có thể thay đổi thường xuyên. Bù đắp 0: 60002 (uint16, chỉ đọc)
Độ lệch 1: Độ dài (uint16, chỉ đọc)
Offset 2..22: Tên Biến quản lý sạc 1
Phần bù 23..24: Biến quản lý tính phí giá trị 1
Offset 25..45: Tên Biến quản lý sạc 2
Phần bù 46..47: Biến quản lý tính phí giá trị 2
...