Enphase Ensemble

Enphase ensemble [1] provides information on installed battery storage and how it is used for optional EV charging or power provision.

Enphase Enpower data

The Enphase Enpower [2] connects the home to grid power, the Encharge storage system, and solar PV. Information on it can be obtained from the EnvoyEnpower.

The Envoy class provides the methods Go_Off_Grid and Go_On_Grid to control the grid connection.

        status = await envoy.go_off_grid()
        if status["mains_admin_state"] != "open":
            #error clogoing off grid



        status = await envoy.go_off_grid()
        if status["mains_admin_state"] != "closed":
            #error clogoing off grid

Open_dry_contact and close_dry_contact allows to to control the dry contacts.

        status = await envoy.close_dry_contact(id)
        print(f"{envoy.data.dry_contact_status[id].status}")


        status = await envoy.open_dry_contact(id)
        print(f"{envoy.data.dry_contact_status[id].status}")

Dry Contact information is available in the EnvoyData.dry_contact_status and Envoy.dry_contact_settings.

Envoy.update_dry_contact can be used to update settings, use with care and only if fully aware of impact!

        new_setting: dict[str, Any] = {}
        new_setting['id'] = id
        new_setting['load_name'] = load_name

        status = await envoy.update_dry_contact(new_setting)
        print (status)

Enphase AC Battery (ACB) data

Both ACB aggregate and per-device battery data are exposed:

Aggregate ACB power and SOC are available in EnvoyData.acb_power, modeled by EnvoyACBPower.
Combined Encharge + ACB SOC/capacity is available in EnvoyData.battery_aggregate, modeled by EnvoyBatteryAggregate.
Per-device ACB data is available in EnvoyData.acb_inventory, keyed by serial number and modeled by EnvoyACB.
The number of ACB batteries reported in production storage can be read from Envoy.acb_count.

Per-device ACB fields include state and sensor values such as sleep_enabled, sleep_state, sleep_min_soc, sleep_max_soc, percent_full, charge_status, communicating, operating, producing, last_report_watts, max_report_watts, and last_report_date.

print(f"ACB count: {envoy.acb_count}")

if envoy.data.acb_inventory:
    for serial, acb in envoy.data.acb_inventory.items():
        print(serial, acb.sleep_state, acb.percent_full, acb.last_report_watts)

ACB sleep control is available with Envoy.set_acb_sleep and Envoy.clear_acb_sleep.

When using sleep_min_soc and sleep_max_soc, the battery will charge or discharge to reach the configured target boundary before entering sleep mode. For example, if current SOC is above sleep_max_soc, it will discharge down to that level, and if SOC is below sleep_min_soc, it will charge up to that level.

ACB per-device telemetry from /inventory is relatively slow-moving on some systems (observed around 10-15 minutes). This is generally fine for metadata and control-state tracking, but fields like sleep_enabled, percent_full, and charge_status may lag by one reporting interval.

await envoy.set_acb_sleep(
        [
                {
                        "serial_num": "122000000001",
                        "sleep_min_soc": 10,
                        "sleep_max_soc": 20,
                }
        ]
)

await envoy.clear_acb_sleep(["122000000001"])

Both ACB control methods require ACB support on the gateway and validate inputs before sending requests.

Envoy Encharge data

The Enphase Encharge controls battery charge and discharge. Information on it can be obtained from EnvoyEncharge for individual batteries, EnvoyEnchargePower and EnvoyEnchargeAggregate for all batteries aggregated.

The Envoy class provides the methods Envoy.enable_charge_from_grid, Envoy.disable_charge_from_grid, Envoy.set_storage_mode and set_reserve_soc.

        status = await envoy.enable_charge_from_grid(id)
        print(f"{envoy.data.tariff.storage_settings.charge_from_grid}")
        print (status)


        status = await envoy.disable_charge_from_grid(id)
        print(f"{envoy.data.dry_contact_status[id].status}")
        print (status)


        status = await envoy.set_storage_mode(mode: EnvoyStorageMode)
        print(f"{envoy.data.tariff.data.tariff.storage_settings.mode}")
        print (status)

On firmware where optimized schedules are supported, passing disable_optimized_schedules=True to set_storage_mode will also set opt_schedules to False. When opt_schedules is True, writes to storage_settings.mode are accepted by the gateway and return HTTP 200, but are silently ignored by the battery controller.

Note that the Enlighten cloud service may overwrite a locally-set mode within one to two minutes by pushing its own tariff configuration to the gateway. See Known Issues for details.

        status = await envoy.set_reserve_soc(value: int)
        print(f"{envoy.data.tariff.storage_settings.reserved_soc}")
        print (status)

IQ Metered Collar data

The Enphase IQ Meter Collar is a meter socket adapter with an integrated microgrid interconnection device (MID) and current sensors for energy consumption metering. The CT sensors in the collar provide the net-consumption data.

The MID status is available in the EnvoyCollar data object.

C6 Combiner data

The C6 Combiner status is available in the EnvoyC6CC data object.