1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
import growattServer
import json
import requests
"""
Example script fetching key power and today+total energy metrics from a Growatt MID-30KTL3-XH (TLX) + APX battery hybrid system
using the V1 API with token-based authentication.
"""
# Get the API token from user input or environment variable
# api_token = os.environ.get("GROWATT_API_TOKEN") or input("Enter your Growatt API token: ")
# test token from official API docs https://www.showdoc.com.cn/262556420217021/1494053950115877
api_token = "6eb6f069523055a339d71e5b1f6c88cc" # gitleaks:allow
try:
# Initialize the API with token
api = growattServer.OpenApiV1(token=api_token)
# Get plant list using V1 API
plants = api.plant_list()
plant_id = plants['plants'][0]['plant_id']
# Get devices in plant
devices = api.device_list(plant_id)
# Iterate over all devices
energy_data = None
for device in devices['devices']:
if device['type'] == 7: # (MIN/TLX)
inverter_sn = device['device_sn']
# Get energy data
energy_data = api.min_energy(device_sn=inverter_sn)
with open('energy_data.json', 'w') as f:
json.dump(energy_data, f, indent=4, sort_keys=True)
# energy data does not contain epvToday for some reason, so we need to calculate it
epv_today = energy_data["epv1Today"] + energy_data["epv2Today"]
solar_production = f'{float(epv_today):.1f}/{float(energy_data["epvTotal"]):.1f}'
solar_production_pv1 = f'{float(energy_data["epv1Today"]):.1f}/{float(energy_data["epv1Total"]):.1f}'
solar_production_pv2 = f'{float(energy_data["epv2Today"]):.1f}/{float(energy_data["epv2Total"]):.1f}'
energy_output = f'{float(energy_data["eacToday"]):.1f}/{float(energy_data["eacTotal"]):.1f}'
system_production = f'{float(energy_data["esystemToday"]):.1f}/{float(energy_data["esystemTotal"]):.1f}'
battery_charged = f'{float(energy_data["echargeToday"]):.1f}/{float(energy_data["echargeTotal"]):.1f}'
battery_grid_charge = f'{float(energy_data["eacChargeToday"]):.1f}/{float(energy_data["eacChargeTotal"]):.1f}'
battery_discharged = f'{float(energy_data["edischargeToday"]):.1f}/{float(energy_data["edischargeTotal"]):.1f}'
exported_to_grid = f'{float(energy_data["etoGridToday"]):.1f}/{float(energy_data["etoGridTotal"]):.1f}'
imported_from_grid = f'{float(energy_data["etoUserToday"]):.1f}/{float(energy_data["etoUserTotal"]):.1f}'
load_consumption = f'{float(energy_data["elocalLoadToday"]):.1f}/{float(energy_data["elocalLoadTotal"]):.1f}'
self_consumption = f'{float(energy_data["eselfToday"]):.1f}/{float(energy_data["eselfTotal"]):.1f}'
battery_charged = f'{float(energy_data["echargeToday"]):.1f}/{float(energy_data["echargeTotal"]):.1f}'
# Output the dashboard
print("\nGeneration overview Today/Total(kWh)")
print(f'Solar production {solar_production:>22}')
print(f' Solar production, PV1 {solar_production_pv1:>22}')
print(f' Solar production, PV2 {solar_production_pv2:>22}')
print(f'Energy Output {energy_output:>22}')
print(f'System production {system_production:>22}')
print(f'Self consumption {self_consumption:>22}')
print(f'Load consumption {load_consumption:>22}')
print(f'Battery Charged {battery_charged:>22}')
print(f' Charged from grid {battery_grid_charge:>22}')
print(f'Battery Discharged {battery_discharged:>22}')
print(f'Import from grid {imported_from_grid:>22}')
print(f'Export to grid {exported_to_grid:>22}')
print("\nPower overview (Watts)")
print(f'AC Power {float(energy_data["pac"]):>22.1f}')
print(f'Self power {float(energy_data["pself"]):>22.1f}')
print(
f'Export power {float(energy_data["pacToGridTotal"]):>22.1f}')
print(
f'Import power {float(energy_data["pacToUserTotal"]):>22.1f}')
print(
f'Local load power {float(energy_data["pacToLocalLoad"]):>22.1f}')
print(f'PV power {float(energy_data["ppv"]):>22.1f}')
print(f'PV #1 power {float(energy_data["ppv1"]):>22.1f}')
print(f'PV #2 power {float(energy_data["ppv2"]):>22.1f}')
print(
f'Battery charge power {float(energy_data["bdc1ChargePower"]):>22.1f}')
print(
f'Battery discharge power {float(energy_data["bdc1DischargePower"]):>22.1f}')
print(f'Battery SOC {int(energy_data["bdc1Soc"]):>21}%')
except growattServer.GrowattV1ApiError as e:
print(f"API Error: {e} (Code: {e.error_code}, Message: {e.error_msg})")
except growattServer.GrowattParameterError as e:
print(f"Parameter Error: {e}")
except requests.exceptions.RequestException as e:
print(f"Network Error: {e}")
except Exception as e:
print(f"Unexpected error: {e}")
|
