Solis Smart Charging for Home Assistant

This integration synchronizes Solis inverter charging windows with Octopus Energy Intelligent dispatch periods in Home Assistant. It automatically adjusts your battery charging schedule to maximize the use of cheaper electricity during dispatch periods while maintaining core charging hours.

Code has been utilised from https://github.com/stevegal/solis_control for the API calls to SolisCloud performing the actual programming.

The core window processing logic is identical between both implementations, only the communication method differs.

Features

• Automatically syncs Solis inverter charging windows with Octopus Energy Intelligent dispatch periods
• Maintains protected core charging hours (23:30-05:30)
• Supports up to three charging windows (Solis limitation)
• Smart charging window management:
  • Automatically detects and merges contiguous charging blocks
  • Extends core hours when dispatch periods are adjacent
  • Handles early charging completion appropriately
  • Maintains charging windows during dispatch periods
• Robust time handling:
  • All times normalized to 30-minute slots
  • Smart handling of overnight periods and early morning dispatches
  • Timezone-aware datetime processing
  • Proper management of charging windows across midnight boundary

Prerequisites

• Home Assistant installation
• Solis inverter with battery storage
• Octopus Energy Intelligent tariff
• Octopus Energy Integration installed
• pyscript integration installed

Installation

1. Ensure you have the pyscript integration installed and configured in Home Assistant
2. Add the following to your configuration.yaml:

pyscript:
  allow_all_imports: true
  hass_is_global: true

input_text:
  solis_api_secret:
    name: Solis API Secret
    initial: !secret solis_api_secret
  solis_api_key:
    name: Solis API Key
    initial: !secret solis_api_key
  solis_username:
    name: Solis Username
    initial: !secret solis_username
  solis_password:
    name: Solis Password
    initial: !secret solis_password
  solis_plant_id:
    name: Solis Plant ID
    initial: !secret solis_plant_id

3. Add your Solis credentials to secrets.yaml:

solis_api_secret: "your_api_secret"
solis_api_key: "your_api_key"
solis_username: "your_username"
solis_password: "your_password"
solis_plant_id: "your_plant_id"

4. Copy solis_smart_charging.py to your config/pyscript directory
5. There are a couple of references in the code to the dispatch entity. Ensure you change this to match your own entities.
6. Add the automation to your automations.yaml or through the Home Assistant UI

Configuration

Automation

alias: Sync Solis Charging with Octopus Dispatch
description: ""
triggers:
  - trigger: state
    entity_id:
      - binary_sensor.octopus_energy_a_42185595_intelligent_dispatching
    attribute: planned_dispatches
conditions:
  - condition: template
    value_template: >
      {% set dispatches =
      state_attr('binary_sensor.octopus_energy_a_42185595_intelligent_dispatching',
      'planned_dispatches') %} {% if dispatches is none %}
        {% set result = false %}
      {% else %}
        {% set result = true %}
      {% endif %} {{ result }}
actions:
  - action: pyscript.solis_smart_charging
    metadata: {}
    data:
      config: |-
        {
          "secret": "{{ states('input_text.solis_api_secret') }}",
          "key_id": "{{ states('input_text.solis_api_key') }}",
          "username": "{{ states('input_text.solis_username') }}",
          "password": "{{ states('input_text.solis_password') }}",
          "plantId": "{{ states('input_text.solis_plant_id') }}",
          "dispatch_sensor": "binary_sensor.octopus_energy_a_42185595_intelligent_dispatching"
        }
mode: single

Note: The dispatching sensor will usually include your account ID, please check and edit the automation appropriately for the correct entity.

How It Works

1. The script monitors Octopus Energy Intelligent dispatch periods
2. When dispatch periods are updated:
   • Core charging hours (23:30-05:30) are protected and cannot be reduced
   • Early morning dispatches (00:00-12:00) are processed against previous day's core window
   • The script identifies contiguous charging blocks and merges them
   • Core hours are extended if dispatch periods are adjacent
   • Additional charging windows are selected based on available charge amount
   • All times are normalized to 30-minute slots
3. During charging:
   • Dispatch windows may remain but with adjusted kWh values
   • Binary sensor state indicates valid charging periods
   • Windows automatically adjust based on actual charging needs
4. The resulting charging windows are synchronized to your Solis inverter
5. The process repeats when new dispatch periods are received

Known Behaviors

1. Dispatch Windows:

   • Windows may remain after charging completion -- to be addressed.
   • System maintains window integrity during overnight transitions

2. Window Processing:

   • Early morning dispatches (before 12:00) align with previous day's core window
   • Windows are always normalized to 30-minute boundaries
   • Core window can extend but never shrink

3. Local sensors

   • Local entities are created (if they do not exist) or updated to reflect the calculated charging windows.
   • The newly calculated windows are checked against the local ones, and the API is only called if there is a change.

Obtaining Solis API Credentials

1. Log in to your Solis Cloud account
2. Navigate to Account Management
3. Under API Management, create new API credentials
4. Note down your API Key ID and Secret
5. Your Plant ID can be found in the URL when viewing your plant details

Example Dashboard View

title: Octopus Intelligent
panel: false
icon: mdi:lightning-bolt-circle
badges: []
cards: []
type: sections
sections:
  - type: grid
    cards:
      - type: custom:mushroom-template-card
        primary: Octopus Energy Dispatches
        secondary: >
          {% set dispatches =
          state_attr('binary_sensor.octopus_energy_a_42185595_intelligent_dispatching',
          'planned_dispatches') %}

          {% if dispatches | length > 0 %}
            {%- for dispatch in dispatches %}
              {{- (dispatch.start | as_local).strftime('%H:%M') }} - {{ (dispatch.end | as_local).strftime('%H:%M') }}
              {%- if not loop.last %}
          {{ '\n' }}      {%- endif %}
            {%- endfor %}
          {% else %}
            No dispatches scheduled
          {% endif %}
        icon: mdi:clock-outline
        icon_color: >-
          {% if
          is_state('binary_sensor.octopus_energy_a_42185595_intelligent_dispatching',
          'on') %}
            green
          {% else %}
            grey
          {% endif %}
        tap_action:
          action: more-info
          entity: binary_sensor.octopus_energy_a_42185595_intelligent_dispatching
        layout: vertical
        multiline_secondary: true
        card_mod:
          style: |
            ha-card {
              --ha-card-background: var(--card-background-color);
              --primary-text-color: var(--primary-color);
            }
        chip:
          type: entity
          entity: binary_sensor.octopus_energy_a_42185595_intelligent_dispatching
          icon: mdi:power
          content: >
            {{ 'Active' if
            is_state('binary_sensor.octopus_energy_a_42185595_intelligent_dispatching',
            'on') else 'Inactive' }}
      - type: custom:mushroom-template-card
        primary: Solis Charging Schedule
        secondary: >
          {% set windows = state_attr('sensor.solis_charge_schedule',
          'charging_windows') %} {% if windows | length > 0 %}
            {%- for window in windows %}
              {%- if window.chargeStartTime != "00:00" or window.chargeEndTime != "00:00" %}
                {{- window.chargeStartTime }} - {{ window.chargeEndTime }}
                {%- if not loop.last %}
          {{ '\n' }}        {%- endif %}
              {%- endif %}
            {%- endfor %}
          {% else %}
            No charging windows scheduled
          {% endif %}
        icon: mdi:battery-charging-outline
        icon_color: >-
          {% set windows = state_attr('sensor.solis_charge_schedule',
          'charging_windows') %} {% if windows | length > 0 %}
            green
          {% else %}
            grey
          {% endif %}
        tap_action:
          action: more-info
          entity: sensor.solis_charge_schedule
        layout: vertical
        multiline_secondary: true
        card_mod:
          style: |
            ha-card {
              --ha-card-background: var(--card-background-color);
              --primary-text-color: var(--primary-color);
            }
        chip:
          type: entity
          entity: sensor.solis_charge_schedule
          icon: mdi:battery-clock
          content: >
            {{ 'Updated: ' + state_attr('sensor.solis_charge_schedule',
            'last_updated') | as_datetime | as_local | as_timestamp |
            timestamp_custom('%H:%M') }}
      - type: vertical-stack
        cards:
          - type: custom:mushroom-number-card
            entity: number.octopus_energy_a_42185595_intelligent_charge_target
            icon: mdi:battery-charging
            name: EV Charge Target
            display_mode: buttons
            fill_container: true
            layout: vertical
            card_mod:
              style: |
                ha-card {
                  --ha-card-background: var(--card-background-color);
                  --primary-text-color: var(--primary-color);
                }
          - type: custom:mushroom-entity-card
            entity: time.octopus_energy_a_42185595_intelligent_target_time
            icon: mdi:clock-outline
            name: Target Charge Time
            tap_action:
              action: more-info
            layout: vertical
            primary_info: name
            secondary_info: state
            card_mod:
              style: |
                ha-card {
                  --ha-card-background: var(--card-background-color);
                  --primary-text-color: var(--primary-color);
                }
    column_span: 2


## Version History

### v3.0x
- Complete rewrite of window handling
- Enhanced logic around midnight window crossover
- Better logging and reporting

### v2.0x
- Enhanced overnight charging behavior
- Improved early morning dispatch processing
- Better handling of timezone-aware operations
- More robust window merging logic

### v1.0x
- Initial release

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License - see the LICENSE file for details.