Fetch real-time solar inverter data from SolaX Developer Platform.

Retrieves the latest readings including power output, energy yields, battery status, and grid import/export data from the SolaX Developer Platform API. All power values are in Watts (W), energy in kWh, voltage in Volts (V), current in Amps (A), and temperature in Celsius (°C).

Args: device_sn: Serial number of the inverter to query (the device SN, not WiFi dongle SN). If omitted, defaults to SOLAX_DEVICE_SN environment variable.

Returns: A structured dictionary with decoded status values and grouped data fields: - device: inverter identifiers (SN, registration number, timestamps) - status: inverter operating status (code + human-readable description) - pv: list of active PV strings with voltage/current/power - mppt: MPPT tracker data (individual trackers + total power) - ac: AC output phases, total power, reactive power, power factor, grid frequency - energy: daily/total yield and AC output - meter1: grid power and energy (import/export) - meter2: secondary meter data (import/export) - battery: battery voltage/current/power/soc/status (None if no battery) - eps: emergency power supply data (3-phase voltage/current/power) - temperature: inverter temperature - misc: line-to-line voltages

Raises: ToolError: if credentials are invalid, the device is not found, or the API fails.

Set inverter battery to Self Use Mode with configurable charging thresholds.

Self Use Mode is ideal for automated control based on conditions like weather. You can set minimum SOC (don't discharge below), maximum charge SOC (don't charge above), and optionally configure time-based charge/discharge periods (e.g., charge during peak solar, discharge during high-rate periods).

Example automation scenarios:

• Reduce charging threshold on cloudy days to preserve grid import reserves

• Increase charging threshold on clear days to maximize solar self-consumption

• Prevent overnight charging from grid during expensive peak hours

Args: device_sn: Serial number of the inverter. If omitted, uses SOLAX_DEVICE_SN. min_soc: Minimum SOC (%), range [10, 100]. Battery won't discharge below this. Default: 10%. charge_upper_soc: Maximum charging SOC (%), range [10, 100]. Battery won't charge above this. Default: 100%. charge_from_grid_enable: Allow charging from grid (0=no, 1=yes). Default: 1 (enabled). charge_start_time_period1: Optional start time for charging period 1 (HH:MM format, e.g., "06:00"). charge_end_time_period1: Optional end time for charging period 1 (HH:MM format, e.g., "18:00"). discharge_start_time_period1: Optional start time for discharge period 1 (HH:MM format). discharge_end_time_period1: Optional end time for discharge period 1 (HH:MM format). enable_time_period2: Enable second time period (0=disabled, 1=enabled). Default: 0. charge_start_time_period2: Optional start time for charging period 2 (HH:MM format). charge_end_time_period2: Optional end time for charging period 2 (HH:MM format). discharge_start_time_period2: Optional start time for discharge period 2 (HH:MM format). discharge_end_time_period2: Optional end time for discharge period 2 (HH:MM format).

Returns: API response confirming the command was sent to the inverter.

Raises: ToolError: if the inverter is offline, credentials are invalid, or the API fails.