config.py

# -----------------------------------------------------------------------------
# Predbat Home Battery System
# Copyright Trefor Southwell 2026 - All Rights Reserved
# This application maybe used for personal use only and not for commercial use
# -----------------------------------------------------------------------------
# fmt off
# pylint: disable=consider-using-f-string
# pylint: disable=line-too-long
# pylint: disable=attribute-defined-outside-init


"""Configuration item definitions for all PredBat settings.

Defines CONFIG_ITEMS - the master list of all user-configurable settings
including their types (switch, input_number, select), defaults, ranges,
units, icons, conditional visibility rules, and dependencies. Covers
battery parameters, rate thresholds, car charging, metrics, notifications,
and calculation options.
"""

from predbat import THIS_VERSION
from const import OPTIONS_TIME, PREDBAT_MODE_OPTIONS, PREDBAT_MODE_CONTROL_CHARGEDISCHARGE

# Predbat update options
PREDBAT_UPDATE_OPTIONS = [f"{THIS_VERSION} Loading..."]
PREDBAT_SAVE_RESTORE = ["save current", "restore default"]

# Configuration options inside HA
CONFIG_ITEMS = [
    {
        "name": "version",
        "friendly_name": "Predbat Core Update",
        "type": "update",
        "title": "Predbat",
        "installed_version": THIS_VERSION,
        "release_url": f"https://github.com/springfall2008/batpred/releases/tag/{THIS_VERSION}",
        "entity_picture": "https://user-images.githubusercontent.com/48591903/249456079-e98a0720-d2cf-4b71-94ab-97fe09b3cee1.png",
        "restore": False,
        "default": False,
    },
    {
        "name": "expert_mode",
        "friendly_name": "Expert Mode",
        "type": "switch",
        "default": False,
    },
    {
        "name": "performance_tweaks",
        "friendly_name": "Performance Tweaks",
        "type": "switch",
        "default": False,
    },
    {
        "name": "active",
        "friendly_name": "Predbat Active",
        "type": "switch",
        "default": False,
        "restore": False,
    },
    {
        "name": "compare_active",
        "friendly_name": "Predbat Compare Active",
        "type": "switch",
        "default": False,
        "restore": False,
    },
    {
        "name": "pv_metric10_weight",
        "friendly_name": "Metric 10 Weight",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.15,
    },
    {
        "name": "pv_scaling",
        "friendly_name": "PV Scaling",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.0,
    },
    {
        "name": "load_scaling",
        "friendly_name": "Load Scaling",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.05,
    },
    {
        "name": "load_scaling10",
        "friendly_name": "Load Scaling PV10%",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.1,
    },
    {
        "name": "charge_scaling10",
        "friendly_name": "Charge Scaling PV10%",
        "type": "input_number",
        "min": 0.1,
        "max": 1.0,
        "step": 0.1,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.8,
        "enable": "expert_mode",
    },
    {
        "name": "pv_metric90_weight",
        "friendly_name": "Metric 90 Weight",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.15,
        "enable": "expert_mode",
    },
    {
        "name": "load_scaling90",
        "friendly_name": "Load Scaling PV90%",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.7,
        "enable": "expert_mode",
    },
    {
        "name": "load_scaling_saving",
        "friendly_name": "Load Scaling for saving sessions",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.1,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.0,
    },
    {
        "name": "load_scaling_free",
        "friendly_name": "Load Scaling for free sessions",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.1,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.2,
    },
    {
        "name": "battery_rate_max_scaling",
        "friendly_name": "Battery rate max scaling charge",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.0,
    },
    {
        "name": "battery_rate_max_scaling_discharge",
        "friendly_name": "Battery rate max scaling discharge",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.05,
    },
    {
        "name": "battery_loss",
        "friendly_name": "Battery loss charge ",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:call-split",
        "default": 0.03,
    },
    {
        "name": "battery_loss_discharge",
        "friendly_name": "Battery loss discharge",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:call-split",
        "default": 0.03,
    },
    {
        "name": "inverter_loss",
        "friendly_name": "Inverter Loss",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:call-split",
        "default": 0.04,
    },
    {
        "name": "inverter_hybrid",
        "friendly_name": "Inverter Hybrid",
        "type": "switch",
        "default": True,
    },
    {
        "name": "inverter_soc_reset",
        "friendly_name": "Inverter SoC Reset",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
    },
    {
        "name": "inverter_set_charge_before",
        "friendly_name": "Inverter Set charge window before start",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
    },
    {
        "name": "battery_capacity_nominal",
        "friendly_name": "Use the Battery Capacity Nominal size",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
    },
    {
        "name": "car_charging_energy_scale",
        "friendly_name": "Car charging energy scale",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 1.0,
    },
    {
        "name": "car_charging_threshold",
        "friendly_name": "Car charging threshold",
        "type": "input_number",
        "min": 4,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 6.0,
    },
    {
        "name": "car_charging_rate",
        "friendly_name": "Car charging rate (Car 0)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "car_charging_rate_1",
        "friendly_name": "Car charging rate (Car 1)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 1",
    },
    {
        "name": "car_charging_rate_2",
        "friendly_name": "Car charging rate (Car 2)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 2",
    },
    {
        "name": "car_charging_rate_3",
        "friendly_name": "Car charging rate (Car 3)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 3",
    },
    {
        "name": "car_charging_rate_4",
        "friendly_name": "Car charging rate (Car 4)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 4",
    },
    {
        "name": "car_charging_rate_5",
        "friendly_name": "Car charging rate (Car 5)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 5",
    },
    {
        "name": "car_charging_rate_6",
        "friendly_name": "Car charging rate (Car 6)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 6",
    },
    {
        "name": "car_charging_rate_7",
        "friendly_name": "Car charging rate (Car 7)",
        "type": "input_number",
        "min": 0.1,
        "max": 24,
        "step": 0.10,
        "unit": "kW",
        "icon": "mdi:ev-station",
        "default": 7.4,
        "enable": "num_cars",
        "enable_condition": "num_cars > 7",
    },
    {
        "name": "car_charging_loss",
        "friendly_name": "Car charging loss",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:call-split",
        "default": 0.08,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "best_soc_min",
        "friendly_name": "Best SoC Min",
        "type": "input_number",
        "min": 0,
        "max": 100.0,
        "step": 0.10,
        "unit": "kWh",
        "icon": "mdi:battery-50",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "best_soc_max",
        "friendly_name": "Best SoC Max",
        "type": "input_number",
        "min": 0,
        "max": 100.0,
        "step": 0.10,
        "unit": "kWh",
        "icon": "mdi:battery-50",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "best_soc_keep",
        "friendly_name": "Best SoC Keep",
        "type": "input_number",
        "min": 0,
        "max": 100.0,
        "step": 0.10,
        "unit": "kWh",
        "icon": "mdi:battery-50",
        "default": 0.0,
    },
    {
        "name": "best_soc_keep_weight",
        "friendly_name": "Best SoC Keep Weighting",
        "type": "input_number",
        "min": 0.1,
        "max": 5,
        "step": 0.10,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.5,
        "enable": "expert_mode",
    },
    {
        "name": "metric_min_improvement_plan",
        "friendly_name": "Metric Min Improvement Plan",
        "type": "input_number",
        "min": -50,
        "max": 250.0,
        "step": 1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 2.0,
    },
    {
        "name": "metric_min_improvement",
        "friendly_name": "Metric Min Improvement Charge",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "metric_min_improvement_export",
        "oldname": "metric_min_improvement_discharge",
        "friendly_name": "Metric Min Improvement Export",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.1,
    },
    {
        "name": "metric_min_improvement_swap",
        "friendly_name": "Metric Min Improvement Swap",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": -0.25,
    },
    {
        "name": "metric_min_improvement_export_freeze",
        "friendly_name": "Metric Min Improvement Export Freeze",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.1,
    },
    {
        "name": "metric_battery_cycle",
        "friendly_name": "Metric Battery Cycle Cost",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0,
    },
    {
        "name": "metric_battery_value_scaling",
        "friendly_name": "Metric Battery Value Scaling",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "enable": "expert_mode",
        "default": 1.0,
    },
    {
        "name": "metric_battery_value_export_scaling",
        "friendly_name": "Metric Battery Value Scaling when export is worthless",
        "type": "input_number",
        "min": 0,
        "max": 1.0,
        "step": 0.01,
        "unit": "*",
        "icon": "mdi:multiplication",
        "enable": "expert_mode",
        "default": 0.8,
    },
    {
        "name": "metric_future_rate_offset_import",
        "friendly_name": "Metric Future Rate Offset Import",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "metric_future_rate_offset_export",
        "friendly_name": "Metric Future Rate Offset Export",
        "type": "input_number",
        "min": -50,
        "max": 50.0,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "metric_inday_adjust_damping",
        "friendly_name": "In-day adjustment damping factor",
        "type": "input_number",
        "min": 0.5,
        "max": 2.0,
        "step": 0.05,
        "unit": "*",
        "icon": "mdi:call-split",
        "enable": "expert_mode",
        "default": 0.95,
    },
    {
        "name": "metric_cloud_enable",
        "friendly_name": "Enable Cloud Model",
        "type": "switch",
        "default": True,
        "enable": "expert_mode",
    },
    {
        "name": "metric_load_divergence_enable",
        "friendly_name": "Enable Load Divergence Model",
        "type": "switch",
        "default": True,
        "enable": "expert_mode",
    },
    {
        "name": "metric_pv_calibration_enable",
        "friendly_name": "Enable use of Calibrated PV data",
        "type": "switch",
        "default": True,
        "enable": "expert_mode",
    },
    {
        "name": "metric_dynamic_load_adjust",
        "friendly_name": "Dynamic Load Adjust",
        "type": "switch",
        "default": False,
    },
    {
        "name": "metric_self_sufficiency",
        "friendly_name": "Metric Self Sufficiency",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.5,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "set_reserve_min",
        "friendly_name": "Set Reserve Min (Inverter 1)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "default": 4,
        "reset_inverter": True,
    },
    {
        "name": "set_reserve_min_1",
        "friendly_name": "Set Reserve Min (Inverter 2)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "default": 4,
        "reset_inverter": True,
        "enable": "num_inverters",
        "enable_condition": "num_inverters > 1",
    },
    {
        "name": "set_reserve_min_2",
        "friendly_name": "Set Reserve Min (Inverter 3)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "default": 4,
        "reset_inverter": True,
        "enable": "num_inverters",
        "enable_condition": "num_inverters > 2",
    },
    {
        "name": "set_reserve_min_3",
        "friendly_name": "Set Reserve Min (Inverter 4)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "default": 4,
        "reset_inverter": True,
        "enable": "num_inverters",
        "enable_condition": "num_inverters > 3",
    },
    {
        "name": "rate_low_threshold",
        "friendly_name": "Rate Low Threshold",
        "type": "input_number",
        "min": 0.00,
        "max": 2.00,
        "step": 0.05,
        "unit": "*",
        "icon": "mdi:multiplication",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "rate_high_threshold",
        "friendly_name": "Rate High Threshold",
        "type": "input_number",
        "min": 0.00,
        "max": 2.00,
        "step": 0.05,
        "unit": "*",
        "icon": "mdi:multiplication",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "combine_rate_threshold",
        "friendly_name": "Combine Rate Threshold",
        "type": "input_number",
        "min": 0,
        "max": 1000,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:table-merge-cells",
        "enable": "expert_mode",
        "default": 0.0,
    },
    {
        "name": "car_charging_hold",
        "friendly_name": "Car charging hold (remove car charging energy from load data)",
        "type": "switch",
        "default": True,
    },
    {
        "name": "car_energy_reported_load",
        "friendly_name": "Car energy is reported in load data (inside CT clamp)",
        "type": "switch",
        "default": True,
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "car_charging_manual_soc",
        "friendly_name": "Car charging manual SOC (Car 0)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "car_charging_manual_soc_kwh",
        "friendly_name": "Car manual SOC kWh (Car 0)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_1",
        "friendly_name": "Car charging manual SOC (Car 1)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 1",
    },
    {
        "name": "car_charging_manual_soc_kwh_1",
        "friendly_name": "Car manual SOC kWh (Car 1)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_1",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_2",
        "friendly_name": "Car charging manual SOC (Car 2)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 2",
    },
    {
        "name": "car_charging_manual_soc_kwh_2",
        "friendly_name": "Car manual SOC kWh (Car 2)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_2",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_3",
        "friendly_name": "Car charging manual SOC (Car 3)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 3",
    },
    {
        "name": "car_charging_manual_soc_kwh_3",
        "friendly_name": "Car manual SOC kWh (Car 3)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_3",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_4",
        "friendly_name": "Car charging manual SOC (Car 4)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 4",
    },
    {
        "name": "car_charging_manual_soc_kwh_4",
        "friendly_name": "Car manual SOC kWh (Car 4)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_4",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_5",
        "friendly_name": "Car charging manual SOC (Car 5)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 5",
    },
    {
        "name": "car_charging_manual_soc_kwh_5",
        "friendly_name": "Car manual SOC kWh (Car 5)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_5",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_6",
        "friendly_name": "Car charging manual SOC (Car 6)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 6",
    },
    {
        "name": "car_charging_manual_soc_kwh_6",
        "friendly_name": "Car manual SOC kWh (Car 6)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_6",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "car_charging_manual_soc_7",
        "friendly_name": "Car charging manual SOC (Car 7)",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 7",
    },
    {
        "name": "car_charging_manual_soc_kwh_7",
        "friendly_name": "Car manual SOC kWh (Car 7)",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 0.01,
        "unit": "kWh",
        "icon": "mdi:ev-station",
        "enable": "car_charging_manual_soc_7",
        "default": 0.0,
        "restore": False,
    },
    {
        "name": "octopus_intelligent_charging",
        "friendly_name": "Octopus Intelligent Charging",
        "type": "switch",
        "default": True,
    },
    {
        "name": "octopus_saving_auto_join",
        "friendly_name": "Octopus Saving Session Auto Join",
        "type": "switch",
        "default": True,
    },
    {
        "name": "octopus_saving_auto_join_lead_hours",
        "friendly_name": "Octopus Saving Session Auto Join Lead Time",
        "type": "input_number",
        "min": 0,
        "max": 12,
        "step": 1,
        "unit": "hours",
        "icon": "mdi:clock-end",
        "enable": "octopus_saving_auto_join",
        "default": 0,
    },
    {
        "name": "octopus_intelligent_ignore_unplugged",
        "friendly_name": "Ignore Intelligent slots when car is unplugged",
        "type": "switch",
        "default": False,
        "enable": "expert_mode",
    },
    {
        "name": "octopus_intelligent_consider_full",
        "friendly_name": "Consider car full as part of Intelligent plan",
        "type": "switch",
        "default": False,
        "enable": "expert_mode",
    },
    {
        "name": "octopus_intelligent_trust_slots",
        "friendly_name": "Trust Intelligent slots before the car is seen charging",
        "type": "switch",
        "default": True,
        "enable": "expert_mode",
    },
    {
        "name": "car_charging_plan_smart",
        "friendly_name": "Car Charging Plan Smart",
        "type": "switch",
        "default": False,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "car_charging_plan_max_price",
        "friendly_name": "Car Charging Plan max price",
        "type": "input_number",
        "min": -1000,
        "max": 1000,
        "step": 1,
        "unit": "p",
        "icon": "mdi:ev-station",
        "default": 0,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "car_charging_from_battery",
        "friendly_name": "Allow car to charge from battery",
        "type": "switch",
        "default": False,
        "reset_inverter": True,
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "calculate_export_oncharge",
        "oldname": "calculate_discharge_oncharge",
        "friendly_name": "Calculate Export within charge slots",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
    },
    {
        "name": "calculate_export_on_pv",
        "friendly_name": "Calculate export slots during solar production",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
    },
    {
        "name": "calculate_second_pass",
        "friendly_name": "Calculate full second pass (slower)",
        "type": "switch",
        "enable": "performance_tweaks",
        "default": True,
    },
    {
        "name": "calculate_pv90_plan",
        "friendly_name": "Calculate PV90 upside plan",
        "type": "switch",
        "enable": "performance_tweaks",
        "default": True,
    },
    {
        "name": "calculate_import_low_export",
        "friendly_name": "Calculate import slots on low export rate slots first",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
        "oldname": "calculate_secondary_order_slots",
    },
    {
        "name": "calculate_export_high_import",
        "friendly_name": "Calculate export slots on high import rate slots first",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
    },
    {
        "name": "calculate_inday_adjustment",
        "friendly_name": "Calculate in-day adjustment",
        "type": "switch",
        "default": True,
    },
    {
        "name": "calculate_plan_every",
        "friendly_name": "Calculate plan every N minutes",
        "type": "input_number",
        "min": 5,
        "max": 60,
        "step": 5,
        "unit": "minutes",
        "icon": "mdi:clock-end",
        "enable": "expert_mode",
        "default": 10,
    },
    {
        "name": "combine_charge_slots",
        "friendly_name": "Combine Charge Slots",
        "type": "switch",
        "default": False,
    },
    {
        "name": "combine_export_slots",
        "oldname": "combine_discharge_slots",
        "friendly_name": "Combine Export Slots",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
    },
    {
        "name": "set_status_notify",
        "friendly_name": "Set Status Notify",
        "type": "switch",
        "default": True,
    },
    {
        "name": "set_inverter_notify",
        "friendly_name": "Set Inverter Notify",
        "type": "switch",
        "default": False,
    },
    {
        "name": "set_event_notify",
        "friendly_name": "Set Event Notify",
        "type": "switch",
        "default": True,
    },
    {
        "name": "set_system_notify",
        "friendly_name": "Set System Notify",
        "type": "switch",
        "default": True,
    },
    {
        "name": "set_charge_freeze",
        "friendly_name": "Set Charge Freeze",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
        "reset_inverter": True,
    },
    {
        "name": "set_charge_freeze_only",
        "friendly_name": "Set Charge Freeze Only",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
        "reset_inverter": True,
    },
    {
        "name": "set_charge_low_power",
        "friendly_name": "Set Charge Low Power Mode",
        "type": "switch",
        "default": False,
        "reset_inverter": True,
    },
    {
        "name": "set_export_low_power",
        "friendly_name": "Set Export Low Power Mode",
        "type": "switch",
        "default": False,
        "reset_inverter": True,
    },
    {
        "name": "charge_low_power_margin",
        "friendly_name": "Low power mode margin",
        "type": "input_number",
        "min": 0,
        "max": 60,
        "step": 5,
        "unit": "minutes",
        "icon": "mdi:seatbelt",
        "enable": "set_charge_low_power",
        "default": 10,
    },
    {
        "name": "low_power_pv_threshold_w",
        "friendly_name": "Low power mode PV threshold",
        "type": "input_number",
        "min": 0,
        "max": 2000,
        "step": 10,
        "unit": "W",
        "icon": "mdi:weather-sunny",
        "default": 150,
    },
    {
        "name": "set_charge_low_power_solar_full_rate",
        "friendly_name": "Low power mode full rate in solar",
        "type": "switch",
        "icon": "mdi:solar-power",
        "enable": "set_charge_low_power",
        "default": True,
    },
    {
        "name": "set_reserve_enable",
        "friendly_name": "Set Reserve Enable",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
        "reset_inverter": True,
    },
    {
        "name": "set_export_freeze",
        "oldname": "set_discharge_freeze",
        "friendly_name": "Set Export Freeze",
        "type": "switch",
        "default": True,
        "reset_inverter": True,
    },
    {
        "name": "set_export_freeze_only",
        "oldname": "set_discharge_freeze_only",
        "friendly_name": "Set Export Freeze Only",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
        "reset_inverter": True,
    },
    {
        "name": "set_discharge_during_charge",
        "friendly_name": "Set discharge During Charge",
        "type": "switch",
        "default": True,
    },
    {
        "name": "set_freeze_export_during_demand",
        "friendly_name": "Set Freeze Export during Demand",
        "type": "switch",
        "enable": "expert_mode",
        "default": False,
        "reset_inverter": True,
    },
    {
        "name": "export_more_solar",
        "friendly_name": "Export more solar",
        "type": "switch",
        "default": False,
    },
    {
        "name": "export_more_solar_threshold",
        "friendly_name": "Export more solar threshold",
        "type": "input_number",
        "min": 0,
        "max": 1000,
        "step": 0.1,
        "unit": "p",
        "icon": "mdi:currency-usd",
        "enable": "expert_mode",
        "default": 1.0,
    },
    {
        "name": "set_read_only",
        "friendly_name": "Read Only mode",
        "type": "switch",
        "default": False,
        "reset_inverter_force": True,
    },
    {
        "name": "chat_confirm_writes",
        "friendly_name": "Chat confirm before changing settings",
        "type": "switch",
        "default": True,
    },
    {
        "name": "chat_web_search",
        "friendly_name": "Chat web search (costs per request)",
        "type": "switch",
        "default": False,
    },
    {
        "name": "ai_ha_state_enable",
        "friendly_name": "AI: allow reading Home Assistant state",
        "type": "switch",
        "default": True,
    },
    {
        "name": "balance_inverters_enable",
        "friendly_name": "Balance Inverters Enable (Beta)",
        "type": "switch",
        "default": False,
    },
    {
        "name": "balance_inverters_charge",
        "friendly_name": "Balance Inverters for charging",
        "type": "switch",
        "enable": "balance_inverters_enable",
        "default": False,
    },
    {
        "name": "balance_inverters_discharge",
        "friendly_name": "Balance Inverters for discharge",
        "type": "switch",
        "enable": "balance_inverters_enable",
        "default": False,
    },
    {
        "name": "balance_inverters_crosscharge",
        "friendly_name": "Balance Inverters for cross-charging",
        "type": "switch",
        "enable": "balance_inverters_enable",
        "default": True,
    },
    {
        "name": "balance_inverters_threshold_charge",
        "friendly_name": "Balance Inverters threshold charge",
        "type": "input_number",
        "min": 1,
        "max": 20,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "enable": "balance_inverters_enable",
        "default": 1.0,
    },
    {
        "name": "balance_inverters_threshold_discharge",
        "friendly_name": "Balance Inverters threshold discharge",
        "type": "input_number",
        "min": 1,
        "max": 20,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "enable": "balance_inverters_enable",
        "default": 1.0,
    },
    {
        "name": "debug_enable",
        "friendly_name": "Debug Enable",
        "type": "switch",
        "icon": "mdi:bug-outline",
        "default": False,
    },
    {
        "name": "debug_history_enable",
        "friendly_name": "Debug history rolling capture enable",
        "type": "switch",
        "icon": "mdi:history",
        "default": True,
    },
    {
        "name": "debug_history_count",
        "friendly_name": "Debug history snapshot count",
        "type": "input_number",
        "min": 1,
        # The maximum only bounds what a user can opt into, the default below is what almost every
        # install actually runs. It was raised from 50 to 500 for #5070: intermittent optimiser
        # behaviour often needs a week or two of history to audit, and at the 1-hour minimum
        # interval 50 snapshots only reached back about two days. 500 covers 14 days hourly (336)
        # with headroom. Snapshots are full debug dumps, roughly 2MB-5MB each dependent on system
        # configuration, so the top of this range is around 2.5GB on disk - see the storage warning
        # in docs/customisation.md.
        "max": 500,
        "step": 1,
        "unit": "snapshots",
        "icon": "mdi:history",
        "default": 15,
    },
    {
        "name": "debug_history_interval",
        "friendly_name": "Debug history snapshot interval",
        "type": "input_number",
        "min": 1,
        "max": 24,
        "step": 1,
        "unit": "hours",
        "icon": "mdi:clock-outline",
        "default": 3,
    },
    {
        "name": "debug_history_force_capture",
        "friendly_name": "Debug history force capture now",
        "type": "switch",
        "icon": "mdi:camera",
        "default": False,
    },
    {
        "name": "car_charging_plan_time",
        "friendly_name": "Car charging planned ready time",
        "type": "select",
        "options": OPTIONS_TIME,
        "icon": "mdi:clock-end",
        "default": "07:00:00",
        "enable": "num_cars",
        "enable_condition": "num_cars > 0",
    },
    {
        "name": "mode",
        "friendly_name": "Predbat mode",
        "type": "select",
        "options": PREDBAT_MODE_OPTIONS,
        "icon": "mdi:state-machine",
        "default": PREDBAT_MODE_OPTIONS[PREDBAT_MODE_CONTROL_CHARGEDISCHARGE],
        "reset_inverter_force": True,
    },
    {
        "name": "update",
        "friendly_name": "Predbat update",
        "type": "select",
        "options": PREDBAT_UPDATE_OPTIONS,
        "icon": "mdi:state-machine",
        "default": None,
        "restore": False,
        "save": False,
    },
    {
        "name": "manual_charge",
        "friendly_name": "Manual force charge",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual": True,
    },
    {
        "name": "manual_export",
        "friendly_name": "Manual force export",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual": True,
    },
    {
        "name": "manual_demand",
        "friendly_name": "Manual force demand",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual": True,
    },
    {
        "name": "manual_import_rates",
        "friendly_name": "Manual import rates",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual_rate": True,
    },
    {
        "name": "manual_export_rates",
        "friendly_name": "Manual export rates",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual_rate": True,
    },
    {
        "name": "manual_load_adjust",
        "friendly_name": "Manual load adjustment",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual_rate": True,
    },
    {
        "name": "manual_import_value",
        "friendly_name": "Manual import value",
        "type": "input_number",
        "min": -50,
        "max": 1000,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "default": 0,
    },
    {
        "name": "manual_export_value",
        "friendly_name": "Manual export value",
        "type": "input_number",
        "min": -50,
        "max": 1000,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "default": 0,
    },
    {
        "name": "manual_load_value",
        "friendly_name": "Manual load adjustment value",
        "type": "input_number",
        "min": -10,
        "max": 10,
        "step": 0.1,
        "unit": "kWh",
        "icon": "mdi:currency-usd",
        "default": 0.5,
    },
    {
        "name": "manual_soc",
        "friendly_name": "Manual SOC target",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:battery-charging",
        "default": "off",
        "restore": False,
        "manual_rate": True,
    },
    {
        "name": "manual_soc_value",
        "friendly_name": "Manual SOC target value",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:battery-charging-100",
        "default": 100,
    },
    {
        "name": "manual_soc_max",
        "friendly_name": "Manual SOC maximum target",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:battery-arrow-down",
        "default": "off",
        "restore": False,
        "manual_rate": True,
    },
    {
        "name": "manual_soc_max_value",
        "friendly_name": "Manual SOC maximum target value",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:battery-arrow-down-outline",
        "default": 0,
    },
    {
        "name": "manual_api",
        "friendly_name": "Manual API controls",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "api": True,
    },
    {
        "name": "manual_freeze_charge",
        "friendly_name": "Manual force charge freeze",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual": True,
    },
    {
        "name": "manual_freeze_export",
        "friendly_name": "Manual force export freeze",
        "type": "select",
        "options": ["off"],
        "icon": "mdi:state-machine",
        "default": "off",
        "restore": False,
        "manual": True,
    },
    {
        "name": "saverestore",
        "friendly_name": "Save/restore settings",
        "type": "select",
        "options": PREDBAT_SAVE_RESTORE,
        "icon": "mdi:state-machine",
        "default": "",
        "restore": False,
        "save": False,
    },
    {
        "name": "auto_update",
        "friendly_name": "Predbat automatic update enable",
        "type": "switch",
        "default": False,
    },
    {
        "name": "load_filter_modal",
        "friendly_name": "Apply modal filter historical load",
        "type": "switch",
        "enable": "expert_mode",
        "default": True,
    },
    {
        "name": "iboost_enable",
        "friendly_name": "iBoost enable",
        "type": "switch",
        "default": False,
    },
    {
        "name": "carbon_enable",
        "friendly_name": "Carbon enable",
        "type": "switch",
        "default": False,
    },
    {
        "name": "carbon_metric",
        "friendly_name": "Carbon Metric",
        "type": "input_number",
        "min": 0,
        "max": 500,
        "step": 1,
        "unit": "p/kg",
        "icon": "mdi:molecule-co2",
        "default": 0,
        "enable": "carbon_enable",
    },
    {
        "name": "iboost_solar",
        "friendly_name": "iBoost on solar power",
        "type": "switch",
        "default": True,
        "enable": "iboost_enable",
    },
    {
        "name": "iboost_solar_excess",
        "friendly_name": "iBoost solar only runs when exporting excess",
        "type": "switch",
        "default": False,
        "enable": "iboost_enable",
    },
    {
        "name": "iboost_gas",
        "friendly_name": "iBoost when import electricity cheaper than gas",
        "type": "switch",
        "default": False,
        "enable": "iboost_enable",
    },
    {
        "name": "iboost_gas_export",
        "friendly_name": "iBoost when export electricity cheaper than gas",
        "type": "switch",
        "default": False,
        "enable": "iboost_enable",
    },
    {
        "name": "iboost_charging",
        "friendly_name": "iBoost when battery charging",
        "type": "switch",
        "default": False,
        "enable": "iboost_enable",
    },
    {
        "name": "iboost_rate_threshold",
        "friendly_name": "iBoost max import boost price",
        "type": "input_number",
        "min": -10,
        "max": 1000,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "iboost_enable",
        "default": 100,
    },
    {
        "name": "iboost_rate_threshold_export",
        "friendly_name": "iBoost max export boost price",
        "type": "input_number",
        "min": -10,
        "max": 1000,
        "step": 0.1,
        "unit": "p/kWh",
        "icon": "mdi:currency-usd",
        "enable": "iboost_enable",
        "default": 100,
    },
    {
        "name": "iboost_smart",
        "friendly_name": "iBoost when import rates are lowest to hit target energy",
        "type": "switch",
        "enable": "iboost_enable",
        "default": False,
    },
    {
        "name": "iboost_smart_min_length",
        "friendly_name": "iBoost smart min length",
        "type": "input_number",
        "min": 30,
        "max": 120,
        "step": 30,
        "unit": "minutes",
        "icon": "mdi:currency-usd",
        "enable": "iboost_enable",
        "default": 30,
    },
    {
        "name": "iboost_on_export",
        "oldname": "iboost_on_export",
        "friendly_name": "iBoost is allowed when battery is force exporting",
        "type": "switch",
        "enable": "iboost_enable",
        "default": False,
    },
    {
        "name": "iboost_prevent_discharge",
        "friendly_name": "When iBoost is active prevent battery discharge",
        "type": "switch",
        "enable": "iboost_enable",
        "default": False,
    },
    {
        "name": "iboost_gas_scale",
        "friendly_name": "iBoost gas price scaling",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.1,
        "unit": "*",
        "icon": "mdi:multiplication",
        "enable": "iboost_enable",
        "default": 1.0,
    },
    {
        "name": "iboost_max_energy",
        "friendly_name": "iBoost max energy",
        "type": "input_number",
        "min": 0,
        "max": 30,
        "step": 0.1,
        "unit": "kWh",
        "enable": "iboost_enable",
        "default": 3.0,
    },
    {
        "name": "iboost_today",
        "friendly_name": "iBoost today",
        "type": "input_number",
        "min": 0,
        "max": 30,
        "step": 0.1,
        "unit": "kWh",
        "enable": "iboost_enable",
        "default": 0.0,
    },
    {
        "name": "iboost_max_power",
        "friendly_name": "iBoost max power",
        "type": "input_number",
        "min": 0,
        "max": 5000,
        "step": 100,
        "unit": "W",
        "enable": "iboost_enable",
        "default": 2400,
    },
    {
        "name": "iboost_min_power",
        "friendly_name": "iBoost min power",
        "type": "input_number",
        "min": 0,
        "max": 5000,
        "step": 100,
        "unit": "W",
        "enable": "iboost_enable",
        "default": 500,
    },
    {
        "name": "iboost_min_soc",
        "friendly_name": "iBoost min soc",
        "type": "input_number",
        "min": 0,
        "max": 100,
        "step": 1,
        "unit": "%",
        "icon": "mdi:percent",
        "enable": "iboost_enable",
        "default": 0.0,
    },
    {
        "name": "iboost_value_scaling",
        "friendly_name": "iBoost value scaling",
        "type": "input_number",
        "min": 0,
        "max": 2.0,
        "step": 0.05,
        "unit": "*",
        "enable": "iboost_enable",
        "icon": "mdi:multiplication",
        "default": 0.75,
    },
    {
        "name": "iboost_energy_subtract",
        "friendly_name": "Subtract iBoost energy from load predictions",
        "type": "switch",
        "enable": "iboost_enable",
        "default": True,
    },
    {
        "name": "holiday_days_left",
        "friendly_name": "Holiday days left",
        "type": "input_number",
        "min": 0,
        "max": 28,
        "step": 1,
        "unit": "days",
        "icon": "mdi:clock-end",
        "default": 0,
        "restore": False,
    },
    {
        "name": "holiday_load_scaling",
        "friendly_name": "Holiday load scaling",
        "type": "input_number",
        "min": 0.1,
        "max": 1.0,
        "step": 0.05,
        "unit": "*",
        "icon": "mdi:multiplication",
        "default": 0.7,
    },
    {
        "name": "forecast_plan_hours",
        "friendly_name": "Plan forecast hours",
        "type": "input_number",
        "min": 8,
        "max": 96,
        "step": 1,
        "unit": "hours",
        "icon": "mdi:clock-end",
        "enable": "expert_mode",
        "default": 24,
    },
    {
        "name": "plan_debug",
        "friendly_name": "HTML Plan Debug",
        "type": "switch",
        "default": False,
        "enable": "expert_mode",
    },
    {
        "name": "predheat_enable",
        "friendly_name": "Enable PredHeat",
        "type": "switch",
        "default": False,
    },
    {
        "name": "next_volume_temp",
        "friendly_name": "Volume Temperature Next",
        "type": "input_number",
        "min": -20,
        "max": 40,
        "step": 0.1,
        "unit": "°C",
        "default": 20,
        "enable": "predheat_enable",
    },
    {
        "name": "inverter_limit_override",
        "friendly_name": "Inverter Limit Override",
        "type": "input_number",
        "min": 0,
        "max": 50000,
        "step": 1000,
        "unit": "W",
        "default": 0,
    },
]

# These settings can be overridden by the API
CONFIG_API_OVERRIDE = {
    "inverter_limit": True,
    "export_limit": True,
    "inverter_battery_rate_min": True,
    "inverter_reserve_max": True,
    "battery_rate_max": True,
    "car_charging_soc": True,
    "car_charging_limit": True,
    "car_charging_battery_size": True,
    "days_previous": True,
    "days_previous_weight": True,
    "battery_scaling": True,
    "forecast_hours": True,
    "import_export_scaling": True,
    "inverter_limit_charge": True,
    "inverter_limit_charge_dc": True,
    "inverter_limit_discharge": True,
    "rates_import_override": True,
    "rates_export_override": True,
}

"""
GE Inverters are the default but not all inverters have the same parameters so this constant
maps the parameters that are different between brands.

The approach is to attempt to mimic the GE model with dummy entities in HA so that predbat GE
code can be used with minimal modification.
"""
INVERTER_DEF = {
    "GE": {
        "name": "GivEnergy",
        "has_rest_api": True,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": False,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": True,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "kWh",
        "num_load_entities": 1,
        "has_ge_inverter_mode": True,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%H:%M:%S",
        "write_and_poll_sleep": 10,
        "has_time_window": True,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "GEC": {
        "name": "GivEnergy Cloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": True,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "kWh",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": True,
        "time_button_press": False,
        "clock_time_format": "%H:%M:%S",
        "write_and_poll_sleep": 10,
        "has_time_window": True,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "GEE": {
        "name": "GivEnergy EMC",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "kWh",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%H:%M:%S",
        "write_and_poll_sleep": 10,
        "has_time_window": True,
        "support_charge_freeze": True,
        "support_discharge_freeze": False,
        "has_idle_time": True,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "GS": {
        "name": "Ginlong Solis",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "current",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "H M",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 2,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": True,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "GS_fb00": {
        "name": "Ginlong Solis (FB00)",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "current",
        "charge_control_immediate": True,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "H M",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 2,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": True,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "SE": {
        "name": "SolarEdge",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SX4": {
        "name": "Solax Gen4 (Modbus Power Control)",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SF": {
        "name": "Sofar HYD",
        "has_rest_api": False,
        "has_mqtt_api": True,
        "output_charge_control": "none",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SFMB": {
        "name": "Sofar HYD",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "none",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "HU": {
        "name": "Huawei Solar",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": True,
        "target_soc_used_for_discharge": True,
    },
    "SK": {
        "name": "Sunsynk",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "current",
        "charge_control_immediate": False,
        "current_dp": 0,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": True,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 5,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SA": {
        "name": "Solar Assistant",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "none",
        "charge_control_immediate": False,
        "current_dp": 0,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%dT%H:%M:%S",
        "write_and_poll_sleep": 10,
        "has_time_window": False,
        "support_charge_freeze": False,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "SIG": {
        "name": "Sigenergy Sigenstor",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": True,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 4,
        "has_time_window": False,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "FoxESS": {
        "name": "FoxESS",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": False,
        "has_discharge_enable_time": False,
        "has_target_soc": False,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "S",
        "charge_time_entity_is_option": False,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # "Feed-in first"/freeze export mode does not hold SoC flat on FoxESS - PV above the
        # export limit still charges the battery instead of being clipped (#4207). That's now
        # correctly modelled (prediction.py's freeze branch, gated on support_feedin_first)
        # rather than treated as a reason to disable freeze outright, so support_discharge_freeze
        # can stay True - see FoxCloud's entry below for the same hardware via a different
        # connection method.
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "FoxCloud": {
        "name": "FoxCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # See FoxESS's entry above - same hardware, correctly modelled rather than disabled (#4207).
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "TESLA": {
        "name": "Tesla Powerwall",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "none",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        "support_discharge_freeze": False,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "EnphaseCloud": {
        "name": "EnphaseCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "none",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "DeyeCloud": {
        "name": "DeyeCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # Freeze Export selects SELLING_FIRST (deye.py) - the same Deye firmware behaviour the
        # Sunsynk cloud drives through the same registers, so PV goes to load, then grid, then
        # the battery.
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SunsynkCloud": {
        "name": "SunsynkCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # Freeze Export selects Selling First with the per-slot sell flag on (sunsynk.py), which
        # runs PV -> load -> grid ahead of the battery. Confirmed on live hardware that the
        # alternative (Limited to Home) fills the battery first, which is why the mode is changed.
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "AlphaESSCloud": {
        "name": "AlphaESSCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        # The periodic path carries a real chargePower setpoint. On the legacy path a
        # non-zero rate just means "unrestricted"; a rate of ZERO is meaningful on both
        # paths and is how Predbat signals freeze (see the component's payload builder).
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        # There is no pause endpoint, so Predbat expresses freeze via the rate entities.
        "has_timed_pause": False,
        # Anything other than HH:MM:SS makes inverter.py replace the published select
        # entities with its own dummies and the window never reaches the component. The
        # API wants HH:mm; the conversion happens at the payload boundary.
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": True,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        # Wrap-around behaviour is undocumented for timeChaf1/timeChae1, so Predbat splits
        # the window and period 2 carries the remainder.
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SolaxCloud": {
        "name": "SolaxCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # Freeze Export selects SolaX's "feedin" work mode (solax.py), which exports the surplus
        # ahead of charging the battery rather than just disabling the charge.
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SolisCloud": {
        "name": "SolisCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        # Freeze Export drops the charge current to 0A, which the SolisCloud component turns into
        # "Feed-in priority" storage mode (solis.py, "Decide if Solar charges the battery or
        # exports") - PV serves load, then exports, and only what the grid cannot take charges.
        "support_feedin_first": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": False,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": True,
    },
    "SIGCLOUD": {
        "name": "SigEnergyCloud",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": False,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "has_ge_eco_toggle": False,
        "time_button_press": False,
        "clock_time_format": "%Y-%m-%d %H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": False,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
    "GWMQTT": {
        "name": "ESP32 Gateway MQTT",
        "has_rest_api": False,
        "has_mqtt_api": False,
        "output_charge_control": "power",
        "charge_control_immediate": False,
        "has_charge_enable_time": True,
        "has_discharge_enable_time": True,
        "has_target_soc": True,
        "has_reserve_soc": True,
        "has_timed_pause": False,
        "charge_time_format": "HH:MM:SS",
        "charge_time_entity_is_option": True,
        "soc_units": "%",
        "num_load_entities": 1,
        "has_ge_inverter_mode": False,
        "time_button_press": False,
        "clock_time_format": "%H:%M:%S",
        "write_and_poll_sleep": 2,
        "has_time_window": True,
        "support_charge_freeze": True,
        "support_discharge_freeze": True,
        "has_idle_time": False,
        "can_span_midnight": True,
        "charge_discharge_with_rate": False,
        "target_soc_used_for_discharge": False,
    },
}

# Control modes for Solax inverters
SOLAX_SOLIS_MODES = {
    "Selfuse - No Grid Charging": 1,
    "Timed Charge/Discharge - No Grid Charging": 3,
    "Backup/Reserve - No Grid Charging": 17,
    "Selfuse": 33,
    "Timed Charge/Discharge": 35,
    "Off-Grid Mode": 37,
    "Battery Awaken": 41,
    "Battery Awaken + Timed Charge/Discharge": 43,
    "Backup/Reserve - No Timed Charge/Discharge": 49,
    "Backup/Reserve": 51,
    "Feed-in priority - No Grid Charging": 64,
    "Feed-in priority - No Timed Charge/Discharge": 96,
    "Feed-in priority": 98,
}
# New modes are from 2024.03.2 controlled with solax_modbus_new in apps.yaml
SOLAX_SOLIS_MODES_NEW = {
    "Self-Use - No Grid Charging": 1,
    "Timed Charge/Discharge - No Grid Charging": 3,
    "Backup/Reserve - No Grid Charging": 17,
    "Self-Use - No Timed Charge/Discharge": 33,
    "Self-Use": 35,
    "Off-Grid Mode": 37,
    "Battery Awaken": 41,
    "Battery Awaken + Timed Charge/Discharge": 43,
    "Backup/Reserve - No Timed Charge/Discharge": 49,
    "Backup/Reserve": 51,
    "Feed-in priority - No Grid Charging": 64,
    "Feed-in priority - No Timed Charge/Discharge": 96,
    "Feed-in priority": 98,
}

# Apps.yaml validation schema
APPS_SCHEMA = {
    "currency_symbols": {"type": "string|string_list"},
    "db_enable": {"type": "boolean"},
    "db_days": {"type": "integer"},
    "db_mirror_ha": {"type": "boolean"},
    "db_primary": {"type": "boolean"},
    "threads": {"type": "string|integer", "allowed": ["auto", 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20]},
    "prediction_kernel_enable": {"type": "boolean"},
    "log_count": {"type": "integer", "min": 2, "max": 100},
    "ha_url": {"type": "string", "empty": False},
    "ha_key": {"type": "string", "empty": False},
    "load_filter_threshold": {"type": "integer"},
    "web_port": {"type": "integer"},
    # The chat agent's LLM endpoint. Named chat_api_* rather than openrouter_* because the
    # endpoint no longer has to be OpenRouter: any OpenAI-compatible API works, including a local
    # Ollama. The openrouter_* names are still accepted so an existing apps.yaml keeps working.
    # A block of named LLM endpoints, so more than one can be configured at once and chosen from
    # the Chat tab. Each entry is {type?, url?, api_key?} keyed by a name of the user's choosing:
    #   chat:
    #     openrouter: {api_key: !secret openrouter_key}
    #     ollama:     {url: 'http://localhost:11434/v1'}
    # The flat chat_api_* and openrouter_* keys below still work and are read as a single unnamed
    # provider when no block is present.
    # Everything the chat agent is configured with lives in one block, rather than a dozen
    # chat_-prefixed keys scattered through the file. Providers sit under their own sub-key so a
    # provider named "model" cannot collide with the model setting:
    #
    #   chat:
    #     providers:
    #       openrouter: {api_key: !secret openrouter_key}
    #       ollama:     {url: 'http://localhost:11434/v1'}
    #     model: openai/gpt-4o-mini
    #     turn_timeout: 1800
    #
    # Validated as a dict here; ChatAgent applies the per-setting defaults and ignores anything it
    # does not recognise. The switches that control chat at runtime (chat_confirm_writes and
    # friends) are CONFIG_ITEMS entities, not apps.yaml, and are unaffected.
    "chat": {"type": "dict"},
    "load_today": {"type": "sensor|sensor_list", "sensor_type": "float", "required": True},
    "import_today": {
        "type": "sensor|sensor_list",
        "sensor_type": "float",
    },
    "export_today": {
        "type": "sensor|sensor_list",
        "sensor_type": "float",
    },
    "pv_today": {
        "type": "sensor|sensor_list",
        "sensor_type": "float",
    },
    "load_forecast_only": {"type": "boolean"},
    "load_forecast": {
        "type": "sensor_list",
        "sensor_type": "dict|list",
    },
    "ge_cloud_data": {"type": "boolean"},
    "ge_cloud_serial": {"type": "string", "empty": False},
    "ge_cloud_key": {"type": "string", "empty": False},
    "ge_cloud_direct": {"type": "boolean"},
    "ge_cloud_automatic": {"type": "boolean"},
    "ge_cloud_load_today_ignore": {"type": "boolean"},
    "ge_cloud_automatic_evc": {"type": "boolean"},
    "ge_cloud_evc_control": {"type": "boolean"},
    "ge_cloud_automatic_shared_ct": {"type": "boolean"},
    "ge_cloud_automatic_split_ct": {"type": "boolean"},
    "ge_cloud_automatic_split_pv": {"type": "boolean"},
    "num_inverters": {"type": "integer", "zero": False},
    "validate_config_retries": {"type": "integer", "zero": True},
    "validate_config_retry_minutes": {"type": "integer", "zero": True},
    "givtcp_rest": {"type": "string_list", "entries": "num_inverters"},
    "givtcp_automatic": {"type": "boolean"},
    "charge_rate": {"type": "sensor_list", "sensor_type": "float", "modify": True, "entries": "num_inverters"},
    "discharge_rate": {"type": "sensor_list", "sensor_type": "float", "modify": True, "entries": "num_inverters"},
    "battery_power": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "pv_power": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "load_power": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "soc_kw": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "soc_max": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "reserve": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "inverter_mode": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "inverter_time": {"type": "sensor_list", "sensor_type": "string", "entries": "num_inverters"},
    "inverter_type": {"type": "string_list", "entries": "num_inverters"},
    "charge_start_time": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "charge_end_time": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "charge_limit": {"type": "sensor_list", "sensor_type": "float", "modify": True, "entries": "num_inverters"},
    "scheduled_charge_enable": {"type": "sensor_list", "sensor_type": "boolean", "modify": True, "entries": "num_inverters"},
    "scheduled_discharge_enable": {"type": "sensor_list", "sensor_type": "boolean", "modify": True, "entries": "num_inverters"},
    "discharge_start_time": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "discharge_end_time": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "battery_temperature": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    # Optional. When the entity reports the battery is being calibrated, Predbat disables itself for
    # that inverter - a calibration cycle deliberately drives the battery outside its normal SoC
    # range, so any plan made during one is wrong. Absent (the default) means "never calibrating".
    "battery_calibration": {"type": "sensor_list", "sensor_type": "none|string", "entries": "num_inverters"},
    "pause_mode": {"type": "sensor_list", "sensor_type": "string", "modify": True, "entries": "num_inverters"},
    "pause_start_time": {"type": "sensor_list", "sensor_type": "none|string", "modify": True, "entries": "num_inverters"},
    "pause_end_time": {"type": "sensor_list", "sensor_type": "none|string", "modify": True, "entries": "num_inverters"},
    "inverter_limit": {"type": "sensor_list", "sensor_type": "float", "modify": False, "zero": False, "entries": "num_inverters"},
    "inverter_can_charge_during_export": {"type": "boolean"},
    "inverter_freeze_export_discharge_rate": {"type": "float", "zero": True},
    "pv_ac_limit": {"type": "float", "zero": True},
    "inverter_limit_charge": {"type": "sensor_list", "sensor_type": "integer", "modify": False, "zero": False, "entries": "num_inverters"},
    "inverter_limit_charge_dc": {"type": "sensor_list", "sensor_type": "integer", "modify": False, "zero": False, "entries": "num_inverters"},
    "inverter_limit_discharge": {"type": "sensor_list", "sensor_type": "integer", "modify": False, "zero": False, "entries": "num_inverters"},
    "inverter_limit_export": {"type": "sensor_list", "sensor_type": "integer", "modify": False, "zero": False, "entries": "num_inverters"},
    "inverter_limit_override": {"type": "sensor_list", "sensor_type": "integer", "modify": False, "zero": False, "entries": "num_inverters"},
    "battery_rate_max": {"type": "sensor_list", "sensor_type": "float", "modify": False, "zero": False, "entries": "num_inverters"},
    "export_limit": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters"},
    "inverter_battery_rate_min": {"type": "integer", "zero": False, "entries": "num_inverters"},
    "inverter_reserve_max": {"type": "integer", "zero": False, "entries": "num_inverters"},
    "battery_charge_power_curve": {"type": "int_float_dict", "or_auto": True},
    "battery_discharge_power_curve": {"type": "int_float_dict", "or_auto": True},
    "battery_charge_power_curve_default": {"type": "int_float_dict"},
    "battery_discharge_power_curve_default": {"type": "int_float_dict"},
    "clock_skew": {"type": "integer"},
    "predbat_repository": {"type": "string", "empty": True},
    "solcast_api_key": {"type": "string", "empty": False},
    "solcast_host": {"type": "string", "empty": False},
    "solcast_poll_hours": {"type": "float", "zero": False},
    "solcast_sites": {"type": "string_list"},
    "pv_forecast_today": {"type": "sensor", "sensor_type": "float"},
    # DC array size in kWp, capping how far the p90 cloud model may extrapolate above the forecast.
    # Auto-detected from the forecast_solar / open_meteo_forecast arrays; set here only for sources
    # that declare no array size, such as Solcast and the HA integrations.
    "pv_array_kwp": {"type": "float"},
    "pv_forecast_tomorrow": {"type": "sensor", "sensor_type": "float"},
    "pv_forecast_d3": {"type": "sensor", "sensor_type": "float"},
    "pv_forecast_d4": {"type": "sensor", "sensor_type": "float"},
    "car_charging_energy": {"type": "sensor", "sensor_type": "float", "transient_ok": True},
    "car_charging_power": {"type": "sensor|sensor_list", "sensor_type": "float", "transient_ok": True},
    "num_cars": {"type": "integer", "zero": True},
    "car_charging_planned": {"type": "sensor|sensor_list", "sensor_type": "string|boolean", "entries": "num_cars"},
    "car_charging_planned_response": {"type": "string_list"},
    "car_charging_now": {"type": "sensor|sensor_list", "sensor_type": "string|boolean", "entries": "num_cars"},
    "car_charging_now_response": {"type": "string_list"},
    "car_charging_battery_size": {"type": "sensor", "zero": False, "sensor_type": "float", "entries": "num_cars"},
    "car_charging_soc": {"type": "sensor", "sensor_type": "float", "entries": "num_cars"},
    "car_charging_limit": {"type": "sensor", "sensor_type": "float", "entries": "num_cars"},
    "car_charging_exclusive": {"type": "boolean_list", "entries": "num_cars"},
    "carbon_intensity": {"type": "sensor", "sensor_type": "string"},
    "carbon_postcode": {"type": "string", "empty": False},
    "carbon_automatic": {"type": "boolean"},
    "axle_api_key": {"type": "string", "empty": False},
    "axle_pence_per_kwh": {"type": "float"},
    "axle_automatic": {"type": "boolean"},
    "axle_control": {"type": "boolean"},
    "sigenergy_app_key": {"type": "string", "empty": False},
    "sigenergy_app_secret": {"type": "string", "empty": False},
    "sigenergy_base_url": {"type": "string", "empty": False},
    "sigenergy_mqtt_host": {"type": "string", "empty": False},
    "sigenergy_system_id": {"type": "string|string_list", "empty": False},
    "sigenergy_automatic": {"type": "boolean"},
    "sigenergy_enable_controls": {"type": "boolean"},
    "sigenergy_ca_pem": {"type": "string", "empty": False},
    "sigenergy_client_pem": {"type": "string", "empty": False},
    "sigenergy_client_key": {"type": "string", "empty": False},
    "solis_api_key": {"type": "string", "empty": False},
    "solis_api_secret": {"type": "string", "empty": False},
    "solis_inverter_sn": {"type": "string|string_list", "empty": False},
    "solis_automatic": {"type": "boolean"},
    "solis_base_url": {"type": "string", "empty": False},
    "solis_control_enable": {"type": "boolean"},
    "solis_cloud_pv_load_ignore": {"type": "boolean"},
    "solis_nominal_voltage": {"type": "float"},
    "solis_auth_method": {"type": "string", "empty": False},
    "solis_access_token": {"type": "string", "empty": False},
    "solis_token_expires_at": {"type": "string", "empty": False},
    "solis_token_hash": {"type": "string", "empty": False},
    "myenergi_auth_method": {"type": "string", "empty": False},
    "myenergi_hub_serial": {"type": "string", "empty": False},
    "myenergi_api_key": {"type": "string", "empty": False},
    "myenergi_key": {"type": "string", "empty": False},
    "myenergi_token_expires_at": {"type": "string", "empty": False},
    "myenergi_token_hash": {"type": "string", "empty": False},
    "myenergi_automatic": {"type": "boolean"},
    "myenergi_automatic_zappi": {"type": "boolean"},
    "myenergi_automatic_eddi": {"type": "boolean"},
    "myenergi_enable_controls": {"type": "boolean"},
    "myenergi_poll_seconds": {"type": "integer", "zero": False},
    "myenergi_zappi_control": {"type": "boolean"},
    "fox_key": {"type": "string", "empty": False},
    "fox_automatic": {"type": "boolean"},
    "fox_automatic_ignore_pv": {"type": "boolean"},
    "fox_inverter_sn": {"type": "string|string_list", "empty": False},
    "fox_auth_method": {"type": "string", "empty": False},
    "fox_token_expires_at": {"type": "string", "empty": False},
    "fox_token_hash": {"type": "string", "empty": False},
    "deye_key": {"type": "string", "empty": False},
    "deye_app_id": {"type": "string", "empty": False},
    "deye_app_secret": {"type": "string", "empty": False},
    "deye_username": {"type": "string", "empty": False},
    "deye_password": {"type": "string", "empty": False},
    "deye_data_center": {"type": "string", "empty": False},
    "deye_company_id": {"type": "string", "empty": False},
    "deye_auth_method": {"type": "string", "empty": False},
    "deye_token_expires_at": {"type": "string", "empty": False},
    "deye_token_hash": {"type": "string", "empty": False},
    "deye_inverter_sn": {"type": "string|string_list", "empty": False},
    "deye_automatic": {"type": "boolean"},
    "deye_automatic_ignore_pv": {"type": "boolean"},
    "deye_battery_nominal_voltage": {"type": "float"},
    "sunsynk_username": {"type": "string", "empty": False},
    "sunsynk_password": {"type": "string", "empty": False},
    "sunsynk_key": {"type": "string", "empty": False},
    "sunsynk_region": {"type": "string", "empty": False},
    "sunsynk_auth_method": {"type": "string", "empty": False},
    "sunsynk_token_expires_at": {"type": "string", "empty": False},
    "sunsynk_token_hash": {"type": "string", "empty": False},
    "sunsynk_inverter_sn": {"type": "string|string_list", "empty": False},
    "sunsynk_automatic": {"type": "boolean"},
    "sunsynk_automatic_ignore_pv": {"type": "boolean"},
    "sunsynk_control_enable": {"type": "boolean"},
    "sunsynk_battery_nominal_voltage": {"type": "float"},
    "alphaess_app_id": {"type": "string", "empty": False},
    "alphaess_app_secret": {"type": "string", "empty": False},
    "alphaess_inverter_sn": {"type": "string|string_list", "empty": False},
    "alphaess_automatic": {"type": "boolean"},
    "alphaess_automatic_ignore_pv": {"type": "boolean"},
    "alphaess_control_enable": {"type": "boolean"},
    "alphaess_battery_rate_max": {"type": "float"},
    "alphaess_api_delay": {"type": "float"},
    "alphaess_min_write_interval": {"type": "integer"},
    "teslemetry_key": {"type": "string", "empty": False},
    "teslemetry_site_id": {"type": "string|string_list"},
    "teslemetry_base_url": {"type": "string", "empty": False},
    "teslemetry_automatic": {"type": "boolean"},
    "teslemetry_tbc_control": {"type": "boolean"},
    "teslemetry_auth_method": {"type": "string", "empty": False},
    "teslemetry_token_expires_at": {"type": "string", "empty": False},
    "teslemetry_token_hash": {"type": "string", "empty": False},
    "enphase_username": {"type": "string", "empty": False},
    "enphase_password": {"type": "string", "empty": False},
    "enphase_site_id": {"type": "string", "empty": False},
    "enphase_automatic": {"type": "boolean"},
    "enphase_automatic_ignore_pv": {"type": "boolean"},
    "octopus_intelligent_slot": {"type": "sensor|sensor_list", "sensor_type": "boolean|action", "entries": "num_cars", "optional_entries": True},
    "octopus_ready_time": {"type": "sensor|sensor_list", "sensor_type": "string", "entries": "num_cars", "optional_entries": True},
    "octopus_charge_limit": {"type": "sensor|sensor_list", "sensor_type": "float", "entries": "num_cars", "optional_entries": True},
    "octopus_slot_low_rate": {"type": "boolean"},
    "octopus_slot_max": {"type": "integer"},
    "octopus_saving_session_octopoints_per_penny": {"type": "integer"},
    "octopus_saving_session_min_octopoints_per_kwh": {"type": "float"},
    "octopus_saving_session_rate": {"type": "float"},
    "octopus_free_url": {"type": "string", "empty": False},
    "octopus_night_times": {"type": "dict_list"},
    "metric_octopus_import": {"type": "sensor", "sensor_type": "float"},
    "metric_octopus_export": {"type": "sensor", "sensor_type": "float"},
    "octopus_api_key": {"type": "string", "empty": False},
    "octopus_api_account": {"type": "string", "empty": False},
    "rates_import": {"type": "dict_list"},
    "rates_export": {"type": "dict_list"},
    "alerts": {"type": "dict"},
    "rates_import_octopus_url": {"type": "string", "empty": False},
    "rates_export_octopus_url": {"type": "string", "empty": False},
    "rates_import_override": {"type": "dict_list"},
    "rates_export_override": {"type": "dict_list"},
    "days_previous": {"type": "integer_list"},
    "days_previous_weight": {"type": "float_list"},
    "days_previous_auto": {"type": "boolean"},
    "forecast_hours": {"type": "integer"},
    "notify_devices": {"type": "string_list"},
    "battery_scaling": {"type": "sensor_list", "sensor_type": "float", "entries": "num_inverters", "modify": False},
    "battery_scaling_auto": {"type": "boolean"},
    "import_export_scaling": {"type": "float"},
    "export_triggers": {"type": "dict_list"},
    "iboost_energy_today": {"type": "sensor", "sensor_type": "float"},
    "metric_octopus_gas": {"type": "sensor", "sensor_type": "float"},
    "rates_gas": {"type": "dict_list"},
    "futurerate_url": {"type": "string", "empty": False},
    "futurerate_adjust_import": {"type": "boolean"},
    "futurerate_adjust_export": {"type": "boolean"},
    "futurerate_adjust_auto": {"type": "boolean"},
    "futurerate_peak_start": {"type": "string", "empty": False},
    "futurerate_peak_end": {"type": "string", "empty": False},
    "octopus_region": {"type": "string", "empty": False},
    "compare_list": {"type": "dict_list"},
    "watch_list": {"type": "string_list"},
    "charge_start_service": {"type": "dict_list|string"},
    "charge_stop_service": {"type": "dict_list|string"},
    "discharge_start_service": {"type": "dict_list|string"},
    "discharge_stop_service": {"type": "dict_list|string"},
    "charge_freeze_service": {"type": "dict_list|string"},
    "discharge_freeze_service": {"type": "dict_list|string"},
    "device_id": {"type": "string", "empty": False},
    "predheat": {"type": "dict"},
    "forecast_solar": {"type": "dict_list"},
    "forecast_solar_max_age": {"type": "float"},
    "forecast_solar_open_meteo_backup": {"type": "boolean"},
    "forecast_solar_open_meteo_first": {"type": "boolean"},
    "open_meteo_forecast": {"type": "dict_list"},
    "open_meteo_forecast_max_age": {"type": "float"},
    "enable_coarse_fine_levels": {"type": "boolean"},
    "load_power_fill_enable": {"type": "boolean"},
    "load_ml_enable": {"type": "boolean"},
    "gateway_device_id": {"type": "string", "empty": False},
    "gateway_mqtt_host": {"type": "string", "empty": False},
    "gateway_mqtt_port": {"type": "integer", "zero": False},
    "gateway_mqtt_token": {"type": "string", "empty": False},
    # User-maintained log/debug redaction denylist (GH#4770): literal strings to mask wherever a
    # value appears in predbat.log or a debug dump, for anything Predbat cannot recognise as a
    # credential from its own config - an MPAN or account number surfaced by a third-party HA
    # integration's entity state/attributes, say, which Predbat has no schema for and so cannot
    # infer is sensitive. `!secret` references resolve here the same as anywhere else in
    # apps.yaml, so the values themselves need not be written out in the clear either. Each
    # redacted occurrence is masked generically as <redact_strings> - use redact_strings_labelled
    # for a name of your own choosing back in the log.
    "redact_strings": {"type": "string_list"},
    # Labelled form of redact_strings: a name -> value mapping, so a masked occurrence reads as
    # <your_label> instead of the generic <redact_strings>, the same way a built-in credential is
    # labelled by its own apps.yaml key name - e.g. "my_landlords_mpan: '1234567890123'" redacts
    # as <my_landlords_mpan> rather than every entry collapsing into one indistinguishable label.
    "redact_strings_labelled": {"type": "dict", "scalar_value_dict": True},
}