feat: Introduce a web interface for Deye inverter monitoring, expand Modbus data collection with new register blocks, and add supporting documentation.

This commit is contained in:
Vladyslav Doloman
2025-11-22 23:27:38 +02:00
parent e75f7222a0
commit 0b377db6c2
2 changed files with 313 additions and 271 deletions

47
app.py
View File

@@ -18,20 +18,25 @@ def get_inverter_data():
verbose=False
)
# Reading two main blocks:
# Block 1: 150 - 216 (67 registers) - Covers Voltages, Currents, Battery, PV, Control
# Block 2: 600 - 627 (28 registers) - Covers BMS Data
# Reading blocks:
# Block 1: 150 - 216 (67 registers) - Voltages, Currents, Battery, PV, Control
# Block 2: 600 - 627 (28 registers) - BMS Data
# Block 3: 245 (1 register) - Max Grid Output
# Block 4: 292 - 293 (2 registers) - Peak Shaving
# Block 5: 314 - 325 (12 registers) - Advanced Limits
block1 = inverter.read_holding_registers(register_addr=150, quantity=67)
block2 = inverter.read_holding_registers(register_addr=600, quantity=28)
block3 = inverter.read_holding_registers(register_addr=245, quantity=1)
block4 = inverter.read_holding_registers(register_addr=292, quantity=2)
block5 = inverter.read_holding_registers(register_addr=314, quantity=12)
def to_signed(val):
return val if val < 32768 else val - 65536
data = {}
# Block 1 Parsing
# Offsets relative to 150
# Block 1 Parsing (150-216)
data["input_voltage"] = round(block1[0] * 0.1, 1) # 150
data["output_voltage"] = round(block1[4] * 0.1, 1) # 154
data["load_voltage"] = round(block1[7] * 0.1, 1) # 157
@@ -45,7 +50,7 @@ def get_inverter_data():
data["batt_temp"] = round(to_signed(block1[32]) * 0.1, 1) # 182
data["batt_voltage"] = round(block1[33] * 0.01, 2) # 183
data["batt_soc"] = block1[34] # 184
data["batt_charge_status"] = block1[35] # 185 (Raw for now)
data["batt_charge_status"] = block1[35] # 185
data["pv1_power"] = block1[36] # 186
data["pv2_power"] = block1[37] # 187
@@ -59,24 +64,34 @@ def get_inverter_data():
data["max_discharge_current"] = block1[61] # 211
data["batt_charge_efficiency"] = block1[66] # 216
# Block 2 Parsing (BMS)
# Offsets relative to 600
# BMS 1 (600-613)
# Block 2 Parsing (BMS 600-627)
data["bms1_soc"] = block2[3] # 603
data["bms1_voltage"] = round(block2[6] * 0.01, 2) # 606 (Charge Voltage?) - Wait, PDF says 606 Charge Voltage.
# Let's stick to the PDF labels from extraction if possible, or generic BMS fields.
# Extracted: 606 Charge Voltage 0.01V.
# Actually commonly 600+ are BMS specific.
# Let's just map them raw or with simple scaling as per PDF.
data["bms1_charge_voltage"] = round(block2[6] * 0.01, 2) # 606
data["bms1_charge_current"] = round(block2[7] * 0.1, 1) # 607
# BMS 2 (614-627)
data["bms2_soc"] = block2[17] # 617
data["bms2_charge_voltage"] = round(block2[20] * 0.01, 2) # 620
data["bms2_charge_current"] = round(block2[21] * 0.1, 1) # 621
# Block 3 Parsing (245)
data["max_grid_output_power"] = block3[0] # 245
# Block 4 Parsing (292-293)
data["gen_peak_shaving_power"] = block4[0] # 292
data["grid_peak_shaving_power"] = block4[1] # 293
# Block 5 Parsing (314-325)
data["discharge_voltage"] = round(block5[0] * 0.01, 2) # 314
data["charge_current_limit"] = block5[1] # 315
data["discharge_current_limit"] = block5[2] # 316
data["real_time_capacity"] = block5[3] # 317
data["real_time_voltage"] = round(block5[4] * 0.01, 2) # 318
# 319 skipped
data["max_charge_current_limit"] = block5[6] # 320
data["max_discharge_current_limit"] = block5[7] # 321
# 322-324 skipped
data["lithium_battery_type"] = block5[11] # 325
inverter.disconnect()
data["status"] = "success"

View File

@@ -18,19 +18,6 @@
body {
background-color: var(--bg-color);
color: var(--text-color);
font-family: var(--font-family);
margin: 0;
padding: 20px;
text-align: center;
box-shadow: 0 4px 15px rgba(0, 0, 0, 0.3);
transition: transform 0.3s ease, box-shadow 0.3s ease;
position: relative;
overflow: hidden;
}
.card:hover {
transform: translateY(-5px);
box-shadow: 0 8px 25px rgba(0, 0, 0, 0.4);
}
.card::before {
@@ -120,7 +107,6 @@
</head>
<body>
<h1>Deye Inverter Monitor</h1>
<div class="dashboard">
@@ -281,268 +267,309 @@
</div>
</div>
<div class="status-bar">
<span class="status-indicator" id="status-dot"></span>
<span id="status-text">Connecting...</span>
<h2>Advanced Control & Limits</h2>
<div class="dashboard">
<div class="card">
<h2>Max Grid Output</h2>
<div class="value-container loading">
<span class="value" id="max-grid-output">--</span><span class="unit">W</span>
</div>
</div>
<div class="card">
<h2>Gen Peak Shaving</h2>
<div class="value-container loading">
<span class="value" id="gen-peak-shaving">--</span><span class="unit">W</span>
</div>
</div>
<div class="card">
<h2>Grid Peak Shaving</h2>
<div class="value-container loading">
<span class="value" id="grid-peak-shaving">--</span><span class="unit">W</span>
</div>
</div>
<div class="card">
<h2>Discharge Voltage</h2>
<div class="value-container loading">
<span class="value" id="discharge-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card">
<h2>Charge I Limit</h2>
<div class="value-container loading">
<span class="value" id="charge-i-limit">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Discharge I Limit</h2>
<div class="value-container loading">
<span class="value" id="discharge-i-limit">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Real Time Cap</h2>
<div class="value-container loading">
<span class="value" id="real-time-cap">--</span><span class="unit">%</span>
</div>
</div>
<div class="card">
<h2>Real Time Voltage</h2>
<div class="value-container loading">
<span class="value" id="real-time-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card">
<h2>Max Charge I Limit</h2>
<div class="value-container loading">
<span class="value" id="max-charge-i-limit">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Max Discharge I Limit</h2>
<div class="value-container loading">
<span class="value" id="max-discharge-i-limit">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Lithium Type</h2>
<div class="value-container loading">
<span class="value" id="lithium-type">--</span>
</div>
</div>
</div>
0% {
opacity: 1;
}
50% {
opacity: 0.5;
}
100% {
opacity: 1;
}
}
.loading .value {
animation: pulse 1.5s infinite;
color: #666;
}
.dashboard {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 20px;
width: 100%;
max-width: 1000px;
}
</style>
</head>
<body>
<h1>Deye Inverter Monitor</h1>
<div class="dashboard">
<div class="card" id="card-input">
<h2>Grid Voltage (Input)</h2>
<div class="value-container loading">
<span class="value" id="input-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card" id="card-output">
<h2>Output Voltage</h2>
<div class="value-container loading">
<span class="value" id="output-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card" id="card-load">
<h2>Load Voltage</h2>
<div class="value-container loading">
<span class="value" id="load-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card" id="card-grid-current">
<h2>Grid Current</h2>
<div class="value-container loading">
<span class="value" id="grid-current">--</span><span class="unit">A</span>
</div>
</div>
<div class="card" id="card-clamp-current">
<h2>Grid Clamp Current</h2>
<div class="value-container loading">
<span class="value" id="grid-clamp-current">--</span><span class="unit">A</span>
</div>
</div>
<div class="card" id="card-output-current">
<h2>Output Current</h2>
<div class="value-container loading">
<span class="value" id="output-current">--</span><span class="unit">A</span>
</div>
<div class="status-bar">
<span class="status-indicator" id="status-dot"></span>
<div class="card">
<h2>Battery SOC</h2>
<div class="value-container loading"><span class="value" id="batt-soc">--</span><span class="unit">%</span>
</div>
</div>
<h2>Battery & PV</h2>
<div class="dashboard">
<div class="card">
<h2>Battery SOC</h2>
<div class="value-container loading">
<span class="value" id="batt-soc">--</span><span class="unit">%</span>
</div>
</div>
<div class="card">
<h2>Battery Voltage</h2>
<div class="value-container loading">
<span class="value" id="batt-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card">
<h2>Battery Current</h2>
<div class="value-container loading">
<span class="value" id="batt-current">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Battery Power</h2>
<div class="value-container loading">
<span class="value" id="batt-power">--</span><span class="unit">W</span>
</div>
</div>
<div class="card">
<h2>Battery Temp</h2>
<div class="value-container loading">
<span class="value" id="batt-temp">--</span><span class="unit">°C</span>
</div>
</div>
<div class="card">
<h2>PV1 Power</h2>
<div class="value-container loading">
<span class="value" id="pv1-power">--</span><span class="unit">W</span>
</div>
</div>
<div class="card">
<h2>PV2 Power</h2>
<div class="value-container loading">
<span class="value" id="pv2-power">--</span><span class="unit">W</span>
</div>
<div class="card">
<h2>Battery Voltage</h2>
<div class="value-container loading"><span class="value" id="batt-voltage">--</span><span
class="unit">V</span></div>
</div>
<div class="card">
<h2>Battery Current</h2>
<div class="value-container loading"><span class="value" id="batt-current">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Battery Power</h2>
<div class="value-container loading"><span class="value" id="batt-power">--</span><span
class="unit">W</span></div>
</div>
<div class="card">
<h2>Battery Temp</h2>
<div class="value-container loading"><span class="value" id="batt-temp">--</span><span
class="unit">°C</span></div>
</div>
<div class="card">
<h2>PV1 Power</h2>
<div class="value-container loading"><span class="value" id="pv1-power">--</span><span class="unit">W</span>
</div>
</div>
<h2>Control Status</h2>
<div class="dashboard">
<div class="card">
<h2>Grid Relay</h2>
<div class="value-container loading">
<span class="value" id="grid-relay">--</span>
</div>
</div>
<div class="card">
<h2>Gen Relay</h2>
<div class="value-container loading">
<span class="value" id="gen-relay">--</span>
</div>
</div>
<div class="card">
<h2>Max Charge I</h2>
<div class="value-container loading">
<span class="value" id="max-charge">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>Max Discharge I</h2>
<div class="value-container loading">
<span class="value" id="max-discharge">--</span><span class="unit">A</span>
</div>
<div class="card">
<h2>PV2 Power</h2>
<div class="value-container loading"><span class="value" id="pv2-power">--</span><span class="unit">W</span>
</div>
</div>
<h2>BMS Data</h2>
<div class="dashboard">
<div class="card">
<h2>BMS1 SOC</h2>
<div class="value-container loading">
<span class="value" id="bms1-soc">--</span><span class="unit">%</span>
</div>
</div>
<div class="card">
<h2>BMS1 Voltage</h2>
<div class="value-container loading">
<span class="value" id="bms1-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card">
<h2>BMS1 Current</h2>
<div class="value-container loading">
<span class="value" id="bms1-current">--</span><span class="unit">A</span>
</div>
</div>
<div class="card">
<h2>BMS2 SOC</h2>
<div class="value-container loading">
<span class="value" id="bms2-soc">--</span><span class="unit">%</span>
</div>
</div>
<div class="card">
<h2>BMS2 Voltage</h2>
<div class="value-container loading">
<span class="value" id="bms2-voltage">--</span><span class="unit">V</span>
</div>
</div>
<div class="card">
<h2>BMS2 Current</h2>
<div class="value-container loading">
<span class="value" id="bms2-current">--</span><span class="unit">A</span>
</div>
</div>
<h2>Control Status</h2>
<div class="dashboard">
<div class="card">
<h2>Grid Relay</h2>
<div class="value-container loading"><span class="value" id="grid-relay">--</span></div>
</div>
<div class="card">
<h2>Gen Relay</h2>
<div class="value-container loading"><span class="value" id="gen-relay">--</span></div>
</div>
<div class="card">
<h2>Max Charge I</h2>
<div class="value-container loading"><span class="value" id="max-charge">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Max Discharge I</h2>
<div class="value-container loading"><span class="value" id="max-discharge">--</span><span
class="unit">A</span></div>
</div>
</div>
<h2>BMS Data</h2>
<div class="dashboard">
<div class="card">
<h2>BMS1 SOC</h2>
<div class="value-container loading"><span class="value" id="bms1-soc">--</span><span class="unit">%</span>
</div>
</div>
<div class="status-bar">
<span class="status-indicator" id="status-dot"></span>
<span id="status-text">Connecting...</span>
<div class="card">
<h2>BMS1 Voltage</h2>
<div class="value-container loading"><span class="value" id="bms1-voltage">--</span><span
class="unit">V</span></div>
</div>
<div class="card">
<h2>BMS1 Current</h2>
<div class="value-container loading"><span class="value" id="bms1-current">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>BMS2 SOC</h2>
<div class="value-container loading"><span class="value" id="bms2-soc">--</span><span class="unit">%</span>
</div>
</div>
<div class="card">
<h2>BMS2 Voltage</h2>
<div class="value-container loading"><span class="value" id="bms2-voltage">--</span><span
class="unit">V</span></div>
</div>
<div class="card">
<h2>BMS2 Current</h2>
<div class="value-container loading"><span class="value" id="bms2-current">--</span><span
class="unit">A</span></div>
</div>
</div>
<h2>Advanced Control & Limits</h2>
<div class="dashboard">
<div class="card">
<h2>Max Grid Output</h2>
<div class="value-container loading"><span class="value" id="max-grid-output">--</span><span
class="unit">W</span></div>
</div>
<div class="card">
<h2>Gen Peak Shaving</h2>
<div class="value-container loading"><span class="value" id="gen-peak-shaving">--</span><span
class="unit">W</span></div>
</div>
<div class="card">
<h2>Grid Peak Shaving</h2>
<div class="value-container loading"><span class="value" id="grid-peak-shaving">--</span><span
class="unit">W</span></div>
</div>
<div class="card">
<h2>Discharge Voltage</h2>
<div class="value-container loading"><span class="value" id="discharge-voltage">--</span><span
class="unit">V</span></div>
</div>
<div class="card">
<h2>Charge I Limit</h2>
<div class="value-container loading"><span class="value" id="charge-i-limit">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Discharge I Limit</h2>
<div class="value-container loading"><span class="value" id="discharge-i-limit">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Real Time Cap</h2>
<div class="value-container loading"><span class="value" id="real-time-cap">--</span><span
class="unit">%</span></div>
</div>
<div class="card">
<h2>Real Time Voltage</h2>
<div class="value-container loading"><span class="value" id="real-time-voltage">--</span><span
class="unit">V</span></div>
</div>
<div class="card">
<h2>Max Charge I Limit</h2>
<div class="value-container loading"><span class="value" id="max-charge-i-limit">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Max Discharge I Limit</h2>
<div class="value-container loading"><span class="value" id="max-discharge-i-limit">--</span><span
class="unit">A</span></div>
</div>
<div class="card">
<h2>Lithium Type</h2>
<div class="value-container loading"><span class="value" id="lithium-type">--</span></div>
</div>
</div>
<div class="status-bar"><span class="status-indicator" id="status-dot"></span><span
id="status-text">Connecting...</span></div>
<script>const inputVoltageEl = document.getElementById('input-voltage');
const outputVoltageEl = document.getElementById('output-voltage');
const loadVoltageEl = document.getElementById('load-voltage');
const gridCurrentEl = document.getElementById('grid-current');
const gridClampCurrentEl = document.getElementById('grid-clamp-current');
const outputCurrentEl = document.getElementById('output-current');
const statusDot = document.getElementById('status-dot');
const statusText = document.getElementById('status-text');
const valueContainers = document.querySelectorAll('.value-container');
<script>
const inputVoltageEl = document.getElementById('input-voltage');
const outputVoltageEl = document.getElementById('output-voltage');
const loadVoltageEl = document.getElementById('load-voltage');
const gridCurrentEl = document.getElementById('grid-current');
const gridClampCurrentEl = document.getElementById('grid-clamp-current');
const outputCurrentEl = document.getElementById('output-current');
const statusDot = document.getElementById('status-dot');
const statusText = document.getElementById('status-text');
const valueContainers = document.querySelectorAll('.value-container');
async function fetchData() {
try {
const response = await fetch('/api/data');
const data = await response.json();
async function fetchData() {
try {
const response = await fetch('/api/data');
const data = await response.json();
if (data.status === 'success') {
// Basic
inputVoltageEl.textContent = data.input_voltage;
outputVoltageEl.textContent = data.output_voltage;
loadVoltageEl.textContent = data.load_voltage;
gridCurrentEl.textContent = data.grid_current;
gridClampCurrentEl.textContent = data.grid_clamp_current;
outputCurrentEl.textContent = data.output_current;
if (data.status === 'success') {
inputVoltageEl.textContent = data.input_voltage;
outputVoltageEl.textContent = data.output_voltage;
loadVoltageEl.textContent = data.load_voltage;
gridCurrentEl.textContent = data.grid_current;
gridClampCurrentEl.textContent = data.grid_clamp_current;
outputCurrentEl.textContent = data.output_current;
// Battery & PV
document.getElementById('batt-soc').textContent = data.batt_soc;
document.getElementById('batt-voltage').textContent = data.batt_voltage;
document.getElementById('batt-current').textContent = data.batt_current;
document.getElementById('batt-power').textContent = data.batt_power;
document.getElementById('batt-temp').textContent = data.batt_temp;
document.getElementById('pv1-power').textContent = data.pv1_power;
document.getElementById('pv2-power').textContent = data.pv2_power;
document.getElementById('batt-soc').textContent = data.batt_soc;
document.getElementById('batt-voltage').textContent = data.batt_voltage;
document.getElementById('batt-current').textContent = data.batt_current;
document.getElementById('batt-power').textContent = data.batt_power;
document.getElementById('batt-temp').textContent = data.batt_temp;
document.getElementById('pv1-power').textContent = data.pv1_power;
document.getElementById('pv2-power').textContent = data.pv2_power;
// Control Status
document.getElementById('grid-relay').textContent = data.grid_relay_status;
document.getElementById('gen-relay').textContent = data.gen_relay_status;
document.getElementById('max-charge').textContent = data.max_charge_current;
document.getElementById('max-discharge').textContent = data.max_discharge_current;
document.getElementById('grid-relay').textContent = data.grid_relay_status;
document.getElementById('gen-relay').textContent = data.gen_relay_status;
document.getElementById('max-charge').textContent = data.max_charge_current;
document.getElementById('max-discharge').textContent = data.max_discharge_current;
// BMS Data
document.getElementById('bms1-soc').textContent = data.bms1_soc;
document.getElementById('bms1-voltage').textContent = data.bms1_charge_voltage;
document.getElementById('bms1-current').textContent = data.bms1_charge_current;
document.getElementById('bms2-soc').textContent = data.bms2_soc;
document.getElementById('bms2-voltage').textContent = data.bms2_charge_voltage;
document.getElementById('bms2-current').textContent = data.bms2_charge_current;
document.getElementById('bms1-soc').textContent = data.bms1_soc;
document.getElementById('bms1-voltage').textContent = data.bms1_charge_voltage;
document.getElementById('bms1-current').textContent = data.bms1_charge_current;
document.getElementById('bms2-soc').textContent = data.bms2_soc;
document.getElementById('bms2-voltage').textContent = data.bms2_charge_voltage;
document.getElementById('bms2-current').textContent = data.bms2_charge_current;
// Advanced Control
document.getElementById('max-grid-output').textContent = data.max_grid_output_power;
document.getElementById('gen-peak-shaving').textContent = data.gen_peak_shaving_power;
document.getElementById('grid-peak-shaving').textContent = data.grid_peak_shaving_power;
document.getElementById('discharge-voltage').textContent = data.discharge_voltage;
document.getElementById('charge-i-limit').textContent = data.charge_current_limit;
document.getElementById('discharge-i-limit').textContent = data.discharge_current_limit;
document.getElementById('real-time-cap').textContent = data.real_time_capacity;
document.getElementById('real-time-voltage').textContent = data.real_time_voltage;
document.getElementById('max-charge-i-limit').textContent = data.max_charge_current_limit;
document.getElementById('max-discharge-i-limit').textContent = data.max_discharge_current_limit;
document.getElementById('lithium-type').textContent = data.lithium_battery_type;
statusDot.className = 'status-indicator active';
statusText.textContent = 'Connected';
statusDot.className = 'status-indicator active';
statusText.textContent = 'Connected';
valueContainers.forEach(el => el.classList.remove('loading'));
} else {
throw new Error(data.message || 'Unknown error');
}
} catch (error) {
console.error('Error fetching data:', error);
statusDot.className = 'status-indicator error';
statusText.textContent = 'Error: ' + error.message;
valueContainers.forEach(el => el.classList.remove('loading'));
}
else {
throw new Error(data.message || 'Unknown error');
}
}
// Fetch immediately, then every 5 seconds
fetchData();
setInterval(fetchData, 5000);
</script>
</body>
catch (error) {
console.error('Error fetching data:', error);
statusDot.className = 'status-indicator error';
statusText.textContent = 'Error: ' + error.message;
}
}
// Fetch immediately, then every 5 seconds
fetchData();
setInterval(fetchData, 5000);
</script>
</body>
</html>