Skip to content
forked from lbbrhzn/ocpp

Home Assistant integration for electric vehicle chargers that support the Open Charge Point Protocol (OCPP).

License

Notifications You must be signed in to change notification settings

jaeyongjaykim/ocpp

 
 

Repository files navigation

OCPP

This is a Home Assistant integration for Electric Vehicle chargers that support the Open Charge Point Protocol.

Installation

1. Install HACS

  • If you have not yet installed HACS, go get it at https://hacs.xyz/ and walk through the installation and configuration.

2. Install the OCPP Repository

  • In Home Assistant, select HACS / Integrations / + Explore & add repositories.

image

  • Search for 'OCPP' and install the repository.

3. Add the OCPP Integration

  • In Home Assistant, select Configuration / Integrations / Add Integration.

image

  • Search for 'OCPP' and add the integration.

image

4. Configure the Central System

  • The default host address '0.0.0.0' will listen to all interfaces on your home assistant server.

image

  • Select which measurands you would like to become available as sensor entities.

image

5. Add the entities to your Dashboard

  • On the OCPP integration, click on devices to navigate to your Charge Point device.

image

  • At the bottom of the Entities panel, click on 'Add to Lovelace' to add the entities to your dashboard.

image

6. Configure your Charger

  • Configure your charger to use the OCPP websocket of your Central System (e.g. ws:https://homeassistant.local:9000). This is charger specific, so consult your manual.

image

  • You may need to reboot your charger before the changes become effective.

7. Start Charging

  • Use the switches to unlock the charger and start the charging process.

image

Supported devices

All OCPP 1.6j compatible devices should be supported, but not every device offers the same level of functionality. So far, we've tried:

Devices with known issues

  • EVBox Elvi appears to require a secure connection, which we do not support (yet).

Debugging

To enable debug logging for this integration and related libraries you can control this in your Home Assistant configuration.yaml file. Example:

logger:
  default: info
  logs:
    custom_components.ocpp: critical
    websocket: debug

After a restart detailed log entries will appear in /config/home-assistant.log.

Support

If you need help, check out our forum or submit an issue.

Development

It is recommended to use Visual Studio Code, and run home assistant in a devcontainer. See https://hacs.xyz/docs/developer/devcontainer

💡 Tip: If you like this project consider buying me a cocktail 🍹:

Buy Me A Coffee

About

Home Assistant integration for electric vehicle chargers that support the Open Charge Point Protocol (OCPP).

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%