OCPP Plugin

The OCPP plugin allows you to use Jeedom as an OCPP (Open Charge Point Protocol) central system. It enables you to monitor one or more electric vehicle charging stations that are compatible with this protocol.

Setup

Terminal Configuration

For the plugin to be able to communicate with the gateway, it is essential to configure it correctly. This configuration step varies by model and manufacturer, but the expected outcome is:

Plugin Configuration

Like any Jeedom plugin, the OCPP plugin must be enabled after installation. Then, once the dependencies have been installed, the daemon can be started.

Within minutes of the daemon starting up, properly configured charging stations connect to the Jeedom central system. The corresponding devices are created automatically.

INFORMATION

Communication is established by default on port 9000. This port can be changed in the event of a conflict; the terminal’s configuration must be adjusted accordingly.

Device Setup

Permissions

By default, any newly created terminal does not allow any charges (transactions): the permission group is set to Deny All.

The Permissions Group drop-down menu allows you to authorize all transactions (Authorize All) or to select a group of permissions.

IMPORTANT

In Allow All mode, any username presented to the terminal is accepted. The Start Load command then displays the list of Jeedom users, or only the specified username if the Startup upon connection is enabled.

Startup upon connection

In Allow All mode, the Start on Connection option automatically starts charging as soon as a vehicle is plugged in, without requiring a badge or any action in Jeedom.

A user ID (maximum 20 characters) must be entered. It is used for all charging sessions at the charging station, whether they start upon connection or via the Start Charging command, which then only displays this user ID. All transactions at the charging station are thus linked to the same user ID.

After stopping the charge using the Stop Charge command, the charge will not resume until the vehicle is unplugged. It can be restarted manually using the Start Charge command.

Adding unknown badges

When a permission group is selected, the Add Unknown Badges option adds to this group Any unknown badge presented at the terminal is assigned the default status of Invalid.

Terminal settings

The Settings tab provides access to all of the hub’s configuration settings. Some settings can be modified, while others cannot. They are divided into two main categories: those specific to the OCPP protocol and those specific to the manufacturer.

INFORMATION

To display the read-only fields, click the eye icon. Click the crossed-out eye icon to hide them again.

Each device can therefore be configured directly from the Jeedom interface by clicking the Save Settings to Device button. A window listing all the changes made will then appear; select the settings to apply, then click Save to send them to the device.

IMPORTANT

Any changes to the gateway’s configuration settings should be made with full knowledge of the implications, as an error could lead to malfunctions.

Permission Groups

Click the Permissions button to display the permission group management window. Click Add Group to add a new group, or select an existing group to edit it.

Add permissions

For each group, you can add permissions manually or upload/export the permissions file in CSV format. Unknown badges presented at a terminal can also be added automatically.

To add a permissions group, simply click the Add Group button and enter the group name.

INFORMATION

Double-click a group’s name to rename it.

An authorization consists of:

Click the Save Permissions button to save the permission groups.

Transactions

Transaction data (charges) specific to each context (all, by device, by authorization) can be accessed via the Transactions button:

INFORMATION

Regardless of the list of requested transactions (all, by terminal, or by user), they are updated in real time upon creation or closure.

Commands

Terminal

Connector(s)

Measurements

Meter readings are automatically generated by the plugin based on the terminal’s settings: MeterValuesSampledData (periodic readings during a load) and MeterValuesAlignedData (readings at fixed intervals, set by ClockAlignedDataInterval).

Each measurement received generates an info/numeric command, which is logged by default, with the appropriate unit (Wh, W, A, V, Hz, °C, %, RPM). If the terminal provides values per phase, the commands are suffixed with L1, L2, or L3.

Examples of measures

Nous utilisons des cookies pour vous garantir la meilleure expérience sur notre site web. Si vous continuez à utiliser ce site, nous supposerons que vous en êtes satisfait.