installation
- If you have not yet installed HACS, go get it at https://hacs.xyz and walk through the installation and configuration.
- In Home Assistant, select HACS / Integrations / + Explore & add repositories.
- Search for 'OCPP' and install the repository.
- In Home Assistant, select Configuration / Integrations / Add Integration.
- Search for 'OCPP' and add the integration.
- The default host address '0.0.0.0' will listen to all interfaces on your home assistant server.
- The default port number is 9000 but can be changed for your needs.
If you are using Let’s Encrypt, Duck DNS or other add-on that enables secure HTTPS for your Home Assistant instance, you can get a secure WSS connection for OCPP. To use a secure connection:
- Enable the option Secure connection
- Provide the pathways to your HA's SSL certificate and key files. These are typically located in the /config or /ssl folder, and typically named fullchain.pem and privkey.pem respectively.
- If you provide incorrect pathways, the integration will fail to setup with no clear indication of why.
If you do not use HTTPS for your Home Assistant instance:
- Disable the option Secure connection
- Path to SSL certificate/key will be ignored.
- Most chargers only support a subset of all possible measurands. This depends most on the Feature profiles that are supported by the charger.
- The integration will autodetect the supported measurands when the charger connects. This can be disabled for chargers that do not support autodetection.
- On the OCPP integration, click on devices to navigate to your Charge Point device.
- At the bottom of the Entities panel, click on 'Add to Lovelace' to add the entities to your dashboard.
- An entity will have the value 'Unavailable' until the charger successfully connects.
- An entity will have the value 'Unknown' until its value has been read from the charger.
- Configure your charger to use the OCPP websocket of your Central System (e.g. ws://homeassistant.local:9000). This is charger specific, so consult your manual.
- Some chargers require the protocol section 'ws://' to be removed, or require the url to end with a '/'.
- If you have configured Secure connection in previous step, you should use 'wss://'
- Some chargers require the url to be specified as an IP address, i.e. '192.168.178.1:9000'
- You may need to reboot your charger before the changes become effective.
- Use the charge control switch to start the charging process.
