2025.10.23

2025.10.23 (beta)

• fix noah/api_v4 setting_write_time_period() endpoint
  • fix swapped battery/load first
  • add "smart" work mode

2025.10.09

2025.10.09 (beta)

• (internal) init device-specific APIs on demand

2025.10.07

2025.10.07 (beta)

• decided to switch status from alpha to beta
  • all documented endpoints implemented
  • verified with real devices (MIN, NEXA)
• added missing endpoints from new API docs
  • wifi_strength() (inverter, noah, max, min, spa, sph, sph-s, wit)
  • power() (inverter, max, min, noah, spa, sph, wit)
  • setting_write_vpp_param_new() (min, spa, sph, wit)
  • setting_clear_vpp_time_period() (min, spa, sph, wit)
  • setting_write_assign_inverter() (noah)
  • setting_write_grid_charging() (noah)
  • setting_write_off_grid() (noah)
• added Noah app-API endpoints supporting token authentication
  • status() (noah/nexa)
  • battery_status() (noah/nexa)
  • settings() (noah/nexa)
  • power_chart() (noah/nexa)
  • energy_chart() (noah/nexa)
  • firmware_info() (noah/nexa)
• renamed methods
  • settings_write_vpp_now() -> setting_write_vpp_now() (min, spa, sph)
  • settings_write_vpp_schedule() -> setting_write_vpp_schedule() (min, spa, sph)
• added new attributes returned by API
  • SphsEnergyDataV4 (44 attributes added)
  • StorageDetailsV4 (3 attributes added)
  • StorageEnergyV4 (10 attributes added)
• verified all endpoints still work and pydantic models are still valid

2025.08.17

added NOAH/NEXA support

2025.07.14

• 2025.07.14 (alpha)
  • packaging & deploy to PyPi
  • removed truststore SSL certificate injection

2025.06.03 (pre-alpha)

• new example for MIN devices (e.g. NEO)
• convenience method api_for_device() for retrieving device-specific API

  from growatt_api import GrowattApi
  api = GrowattApi(token="your_token")
  # now you can get your device-specifc api by
  my_device = api.api_for_device(device_sn="your_device_sn")
  # this returns e.g. `api.min` for MIN devices
  # arguments "device_sn" does not need to be supplied anymore, so you can do e.g.
  min_details = my_device.details()
  # instead of
  min_details = api.min.details(device_sn="your_device_sn")
  print(min_details.data.model_dump_json())

2025.05.22

• 2025.05.22 (pre-alpha)
  • refactoring: moved some endpoints from/to plant/device/datalogger
  • refactoring: moved some endpoints from/to smart_meter/env_sensor/datalogger
  • common device type growatt_public_api.DeviceType
    • retrieve device type by api.device.get_device_type()
  • refactoring: integrate v4 endpoints in "normal" code (use submodule instead of device_type parameter)
  • refactoring: integrate VPP into MIN,SPA,SPH