Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dan-r/homeassistant-ohme

Unofficial Home Assistant integration for interacting with Ohme EV chargers (EVSE) 🚗⚡️
https://github.com/dan-r/homeassistant-ohme

electric-vehicle hacs-integration home-assistant octopus-energy

Last synced: 12 days ago
JSON representation

Unofficial Home Assistant integration for interacting with Ohme EV chargers (EVSE) 🚗⚡️

Awesome Lists containing this project

README 

        
# Ohme EV Charger for Home Assistant



An unofficial integration for interacting with Ohme EV Chargers. I have no affiliation with Ohme besides owning one of their EV chargers.



This integration does not currently support accounts with multiple chargers.



If you find any bugs or would like to request a feature, please open an issue.



## Tested Hardware

This integration has been tested with the following hardware:

* Ohme Home Pro [v1.32]

* Ohme Home [v1.32]

* Ohme Go [v1.32]

* Ohme ePod [v2.12]



## External Software

The 'Charge Slot Active' binary sensor mimics the `planned_dispatches` and `completed_dispatches` attributes from the [Octopus Energy](https://github.com/BottlecapDave/HomeAssistant-OctopusEnergy) integration, so should support external software which reads this such as [predbat](https://springfall2008.github.io/batpred/devices/#ohme).



## Installation



### HACS

This is the recommended installation method.

1. Search for and install the Ohme addon from HACS

2. Restart Home Assistant



### Manual

1. Download the [latest release](https://github.com/dan-r/HomeAssistant-Ohme/releases)

2. Copy the contents of `custom_components` into the `/custom_components` directory of your Home Assistant installation

3. Restart Home Assistant



## Setup

From the Home Assistant Integrations page, search for and add the Ohme integration.



### Social Logins

If you created your Ohme account through an Apple, Facebook or Google account, you will need to set a password to use this integration.



Visit the [password reset](https://api.ohme.io/fleet/index.html#/authentication/forgotten-password) page and enter the email address associated with your social account. You can then use this new password to log into the integration.



## Entities

This integration exposes the following entities:



* Binary Sensors

    * Car Connected - On when a car is plugged in

    * Car Charging - On when a car is connected and drawing power

    * Pending Approval - On when a car is connected and waiting for approval

    * Charge Slot Active - On when a charge slot is in progress according to the Ohme-generated charge plan

    * Charger Online - On if charger is online and connected to the internet

* Sensors (Session specific) - **Only available during a charge session**

    * Power Draw (Watts) - Power draw of connected car

    * Current Draw (Amps) - Current draw of connected car

    * Voltage (Volts) - Voltage reading

    * Charge Slots - A comma separated list of assigned charge slots 

    * Next Charge Slot Start - The next time your car will start charging according to the Ohme-generated charge plan

    * Next Charge Slot End - The next time your car will stop charging according to the Ohme-generated charge plan

* Sensors (Other)

    * CT Reading (Amps) - Reading from attached CT clamp

    * Energy Usage (kWh) - Energy used in the current/last session. *This is supported by the energy dashboard.*

    * Accumulative Energy Usage (kWh) - Deprecated - Total energy used by the charger (If enabled in options)

    * Battery State of Charge (%) - If your car is API connected this is read from the car, if not it is how much charge Ohme thinks it has added

* Switches (Settings) - **Only options available to your charger model will show**

    * Lock Buttons - Locks buttons on charger

    * Require Approval - Require approval to start a charge

    * Sleep When Inactive - Charger screen & lights will automatically turn off

    * Solar Boost

* Switches (Charge state) - **These are only functional when a car is connected**

    * Max Charge - Forces the connected car to charge regardless of set schedule

    * Pause Charge - Pauses an ongoing charge

    * Enable Price Cap - Whether price cap is applied. _Due to changes by Ohme, this will not show for Intelligent Octopus users._

* Inputs - **If in a charge session, these change the active charge. If disconnected, they change your first schedule.**

    * Number

        * Target Percentage - Change the target battery percentage

        * Preconditioning - Change pre-conditioning time. 0 is off

        * Price Cap - Maximum charge price. _Due to changes by Ohme, this will not show for Intelligent Octopus users._

    * Time

        * Target Time - Change the target time

* Buttons

    * Approve Charge - Approves a charge when 'Pending Approval' is on



## Options

Some options can be set from the 'Configure' menu in Home Assistant:

* Never update an ongoing session - Override the default behaviour of the target time, percentage and preconditioning inputs and only ever update the schedule, not the current session. This was added as changing the current session can cause issues for customers on Intelligent Octopus Go.

* Don't collapse charge slots - By default, adjacent slots are merged into one. This option shows every slot, as shown in the Ohme app.

* Enable accumulative energy usage sensor - Enable the sensor showing an all-time incrementing energy usage counter. This causes issues with some accounts. 



## Coordinators

Updates are made to entity states by polling the Ohme API. This is handled by 'coordinators' defined to Home Assistant, which refresh at a set interval or when externally triggered.



The coordinators are listed with their refresh intervals below. Relevant coordinators are also refreshed when using switches and buttons.



* OhmeChargeSessionsCoordinator (30s refresh)

    * Binary Sensors: Car connected, car charging, pending approval and charge slot active

    * Buttons: Approve Charge

    * Sensors: Power, current, voltage, session energy usage, charge slots, and next slot (start & end)

    * Switches: Max charge, pause charge

    * Inputs: Target time, target percentage and preconditioning (If car connected)

* OhmeAccountInfoCoordinator (1m refresh)

    * Switches: Lock buttons, require approval,  sleep when inactive and enable price cap

    * Inputs: Price cap

* OhmeAdvancedSettingsCoordinator (1m refresh)

    * Sensors: CT reading sensor

    * Binary Sensors: Charger online

* OhmeStatisticsCoordinator (30m refresh)

    * Sensors: Accumulative energy usage

* OhmeChargeSchedulesCoordinator (10m refresh)

    * Inputs: Target time, target percentage and preconditioning (If car disconnected)