set_battery_self_use_mode
Set inverter battery to Self Use Mode with configurable minimum and maximum SOC and optional time-based charge/discharge periods to optimize energy use based on solar availability.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| min_soc | No | ||
| device_sn | No | ||
| charge_upper_soc | No | ||
| enable_time_period2 | No | ||
| charge_end_time_period1 | No | ||
| charge_end_time_period2 | No | ||
| charge_from_grid_enable | No | ||
| charge_start_time_period1 | No | ||
| charge_start_time_period2 | No | ||
| discharge_end_time_period1 | No | ||
| discharge_end_time_period2 | No | ||
| discharge_start_time_period1 | No | ||
| discharge_start_time_period2 | No |