mysolenso.services.micro.find - Micro Find

Service for retrieving detailed information about a single microinverter.

This module provides MySolensoMicroFind, which wraps the micro_find Solenso endpoint. A valid microinverter ID must be set via set_micro() before data is fetched. The ID is validated against the list returned by MySolensoDTUSelectAll.

class mysolenso.services.micro.find.MySolensoMicroFind(parent)

Bases: object

Retrieve the full detail record for a single microinverter.

Call set_micro() with a valid microinverter ID to trigger the API request and populate the cached data.

Parameters:

parent (MySolenso) – The parent client object that holds the authentication context and the active station reference.

Raises:

MySolensoException – If no active station is set on the parent at construction time.

set_station(id)

Switch the active station context (does not refresh data).

Parameters:

id (int) – ID of the target station. Must exist in the account’s station list.

Raises:

MySolensoException – If the requested station ID is not found.

Return type:

None

set_micro(id, refresh=True)

Select the microinverter to query and optionally fetch its data.

The microinverter ID is validated against the list returned by list_micros().

Parameters:

• id (int) – Internal numeric ID of the microinverter to query.

• refresh (bool) – When True (default), immediately fetches the microinverter detail record from the API.

Raises:

MySolensoException – If the requested microinverter ID is not found.

Return type:

None

micro_find_refresh()

Force a fresh fetch of the microinverter detail record from the API.

Return type:

None

property all_data: dict

Raw API response for the microinverter find endpoint.

Returns:

Full microinverter record including serial number, firmware versions, hardware model, port configuration, parent DTU reference, and connection/warning status. Example:

{
    "sn": "A900016B5",
    "warn_data": {"warn": False, "connect": True},
    "id": 9988950,
    "sid": 9999999,
    "station_name": "DOE JOHN",
    "dev_type": 3,
    "tz_name": "UTC+01",
    "vc": "2L2",
    "init_soft_ver": "V01.00.04",
    "init_hard_no": "Sol-H1000H",
    "init_hard_ver": "H00.04.00",
    "dtu_id": 1238090,
    "dtu_sn": "D0900999H",
    "rule": {"port": 2, "phase": 1, "series": 7, ...},
    ...
}

Return type:

dict