Skip to main content

​
Solar Inverter Attributes

Solar inverter attributes are writable parameters that control battery behavior, self-consumption optimization, and system configuration for photovoltaic installations.

​
Required Parameters

​
owner
string (UUID)
required
User ID that owns this solar inverter.Example: 016b78a7-0c7c-4241-a277-015c3ad3cb90Writable: No (set at device creation)

​
Device Model

​
device_model
object
The device model assigned to this inverter. Set during onboarding.Writable: No (set at device creation)

​
Optimization Control

​
is_smart_optimization_active
boolean
Flag indicating whether Podero’s smart optimization is actively controlling this inverter.Set to false to pause optimization without disconnecting the device.Example: trueWritable: Yes

​
Solar System Configuration

​
solar_power_rating_kw
float
Currently installed peak power rating of the solar system in kilowatts.Example: 10.2Writable: Yes

​
Battery Configuration

​
is_battery_connected
boolean
Flag indicating whether the inverter has a storage battery connected.Set to false for solar-only installations without battery storage.Example: trueWritable: Yes
​
battery_capacity_kwh
float
Currently installed battery capacity in kilowatt-hours.Required if is_battery_connected is true.Example: 10.0Writable: Yes

​
Battery Charge Limits

​
min_battery_charge
float
Minimum allowed battery charge level in percent.Battery will not discharge below this level, ensuring backup power availability.Example: 20Range: 0-100Writable: Yes
​
max_battery_charge
float
Maximum allowed battery charge level in percent.Useful for battery longevity or to reserve capacity for grid services.Example: 90Range: 0-100Writable: Yes

​
Usage Examples

​
Configure Solar System with Battery

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "solar_power_rating_kw": 10.2,
    "is_battery_connected": true,
    "battery_capacity_kwh": 13.5,
    "min_battery_charge": 20,
    "max_battery_charge": 100
  }'

​
Configure Solar-Only System (No Battery)

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "solar_power_rating_kw": 8.5,
    "is_battery_connected": false
  }'

​
Configure Battery Limits for Backup Reserve

# Reserve 30% battery for backup power
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "min_battery_charge": 30,
    "max_battery_charge": 90
  }'

​
Best Practices

  • Set min_battery_charge to 20-30% to ensure backup power availability
  • Set max_battery_charge to 90-95% for battery longevity
  • Adjust limits seasonally based on usage patterns
  • Keep solar_power_rating_kw updated if panels are added or removed
  • Update battery_capacity_kwh if the battery is upgraded
  • Set is_battery_connected to false for solar-only installations
  • Review configuration after system maintenance

​
Common Scenarios

# Configure newly installed 10kW system with 13.5kWh battery
update_inverter({
    'solar_power_rating_kw': 10.0,
    'is_battery_connected': True,
    'battery_capacity_kwh': 13.5,
    'min_battery_charge': 20,
    'max_battery_charge': 100,
})

# Update system after battery retrofit
update_inverter({
    'is_battery_connected': True,
    'battery_capacity_kwh': 10.0,
    'min_battery_charge': 20,
    'max_battery_charge': 90
})

# Increase backup reserve for expected power outage
update_inverter({
    'min_battery_charge': 50,  # Reserve 50% for backup
})

# After emergency passes, return to normal
update_inverter({
    'min_battery_charge': 20
})

# Summer: more production, higher max charge
update_inverter({
    'max_battery_charge': 100
})

# Winter: less production, reserve more battery
update_inverter({
    'min_battery_charge': 30
})

Solar Inverter State

Read-only state data and current readings

Setting Preferences

User workflow for configuring preferences