SMA Solar

    The SMA Solar integration will poll a SMA (US) solar inverter, energy meter or battery inverter and present the values as sensors in Home Assistant.

    配置

    此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

    Installation details

    When Home Assistant discovers a new SMA device, or when you manually add one, the following form is presented:

    • Host: the hostname or IP address (if discovered via DHCP, this field will not be displayed as it's known via discovery)
    • Use SSL certificate
    • Verify SSL certificate
    • Group: choose either user or installer (default: user). Ask your installer if you’re unsure which to use
    • Password: use your password or ask your installer the default password that has been set up

    Supported Devices

    Not all inverters, energy meters and batteries from SMA are supported.

    The integration uses the device's web interface (called webconnect). Before you start, make sure you are able to connect to the solar inverter from your favorite web browser. Devices with the ennexos operating system (like the Tripower X series) and all Energy Meters (SMA Energy Meter and SMA Sunny Home Manager) are not supported.

    Sensors

    The SMA WebConnect module supports a wide variety of sensors, but not all of these have been mapped in the pysma library. Currently available sensors can be found below. Feel free to submit additional sensors to be added as standard sensors to the pysma library.

    Solar Inverter

    nameUnitDescription
    statusStatus of the device
    pv_powerWCurrent power provided to the AC side by all the solar panels
    pv_power_aWCurrent power generated on the DC side by the solar panels (A side)
    pv_power_bWCurrent power generated on the DC side by the solar panels (B side)
    pv_voltage_aVCurrent voltage generated by the solar panels (A side)
    pv_voltage_bVCurrent voltage generated by the solar panels (B side)
    pv_current_aACurrent amperage generated by the solar panels (A side)
    pv_current_bACurrent amperage generated by the solar panels (B side)
    grid_powerWPower supplied to the grid by the inverter. grid_power = power_l1 + power_l2 + power_l3
    frequencyHzGrid frequency
    current_l1ACurrent for phase 1
    current_l2ACurrent for phase 2
    current_l3ACurrent for phase 3
    voltage_l1VVoltage for phase 1
    voltage_l2VVoltage for phase 2
    voltage_l3VVoltage for phase 3
    power_l1WPower for phase 1
    power_l2WPower for phase 2
    power_l3WPower for phase 3
    total_yieldkWhTotal energy yield from a solar installation
    daily_yieldWhThe solar plant's yield for today
    pv_gen_meterkWhTotal kWh generated to date

    Optimizers via Inverter

    nameUnitDescription
    optimizer_power_xWPower supplied by optimizer X
    optimizer_current_xACurrent supplied by optimizer X
    optimizer_voltage_xVVoltage supplied by optimizer X
    optimizer_temp_xCTemperature of optimizer X

    Energy Meter via Inverter

    nameUnitDescription
    metering_power_suppliedWPower supplied
    metering_power_absorbedWPower absorbed
    metering_frequencyHzGrid frequency
    metering_total_yieldkWhTotal energy supplied to the grid
    metering_total_absorbedkWhTotal energy from the grid
    metering_current_l1ACurrent for phase 1
    metering_current_l2ACurrent for phase 2
    metering_current_l3ACurrent for phase 3
    metering_voltage_l1VVoltage for phase 1
    metering_voltage_l2VVoltage for phase 2
    metering_voltage_l3VVoltage for phase 3
    metering_active_power_l1WActive Power for phase 1
    metering_active_power_l2WActive Power for phase 2
    metering_active_power_l3WActive Power for phase 3
    metering_active_power_consumed_l1WActive Power Consumed for phase 1
    metering_active_power_consumed_l2WActive Power Consumed for phase 2
    metering_active_power_consumed_l3WActive Power Consumed for phase 3

    Energy Meter

    nameUnitDescription
    statusStatus of the device
    grid_powerWPower supplied to the grid. grid_power = power_l1 + power_l2 + power_l3
    frequencyHzGrid frequency.
    current_l1ACurrent for phase 1
    current_l2ACurrent for phase 2
    current_l3ACurrent for phase 3
    voltage_l1VVoltage for phase 1
    voltage_l2VVoltage for phase 2
    voltage_l3VVoltage for phase 3
    power_l1WPower for phase 1
    power_l2WPower for phase 2
    power_l3WPower for phase 3

    Battery Inverter

    nameUnitDescription
    operating_status_generalGeneral operating status
    inverter_conditionInverter Condition
    inverter_system_initInverter System Init
    grid_connection_statusGrid connection status
    grid_relay_statusGrid relay status
    insulation_residual_currentmAInsulation residual current
    current_l1ACurrent for phase 1
    current_l2ACurrent for phase 2
    current_l3ACurrent for phase 3
    current_totalATotal Current.
    voltage_l1VVoltage for phase 1
    voltage_l2VVoltage for phase 2
    voltage_l3VVoltage for phase 3
    grid_reactive_powervarTotal Reactive Power
    grid_reactive_power_l1varReactive Power for phase 1
    grid_reactive_power_l2varReactive Power for phase 2
    grid_reactive_power_l3varReactive Power for phase 3
    grid_apparent_powerVATotal Apparent Power
    grid_apparent_power_l1VAApparent Power for phase 1
    grid_apparent_power_l2VAApparent Power for phase 2
    grid_apparent_power_l3VAApparent Power for phase 3
    grid_power_factorGrid Power factor
    grid_power_factor_excitationGrid Power factor excitation
    battery_soc_total%Total battery state of charge
    battery_soc_a%State of charge battery A
    battery_soc_b%State of charge battery B
    battery_soc_c%State of charge battery C
    battery_voltage_aVVoltage battery A
    battery_voltage_bVVoltage battery B
    battery_voltage_cVVoltage battery C
    battery_current_aACurrent battery A
    battery_current_bACurrent battery B
    battery_current_cACurrent battery C
    battery_temp_aCTemperature battery A
    battery_temp_bCTemperature battery B
    battery_temp_cCTemperature battery C
    battery_status_operating_modeBattery status operating mode
    battery_capacity_total%Total battery capacity
    battery_capacity_a%Capacity battery A
    battery_capacity_b%Capacity battery B
    battery_capacity_c%Capacity battery C
    battery_charging_voltage_aVCharging voltage battery A
    battery_charging_voltage_bVCharging voltage battery B
    battery_charging_voltage_cVCharging voltage battery C
    battery_power_charge_totalWTotal charging power
    battery_power_charge_aWCharging power battery A
    battery_power_charge_bWCharging power battery B
    battery_power_charge_cWCharging power battery C
    battery_charge_totalkWhTotal charge
    battery_charge_akWhCharge battery A
    battery_charge_bkWhCharge battery B
    battery_charge_ckWhCharge battery C
    battery_power_discharge_totalWTotal discharging power
    battery_power_discharge_aWDisharging power battery A
    battery_power_discharge_bWDisharging power battery B
    battery_power_discharge_cWDisharging power battery C
    battery_discharge_totalkWhTotal discharge
    battery_discharge_akWhDischarge battery A
    battery_discharge_bkWhDischarge battery A
    battery_discharge_ckWhDischarge battery A
    inverter_power_limitWPower limit of the Inverter