OCPP – Activation and Setup Guide

1. Overview

1.1 What is OCPP?

The Open Charging Point Protocol (OCPP) is the industry standard and open protocol allowing open EV chargers and Charging Station Management Systems (CSMS) communication.

Wallbox offers its own CSMS (Charging Station Management Systems),Wallbox Portal, that allows you to monitor your chargers, manage users’ access and monetise them. But if you already use your own CSMS, you can connect your chargers to it using OCPP.

Wallbox is using OCPP 1.6j.

1.2 Acronyms and Conventions

Various acronyms are used throughout this guide. You can refer to this table as you read.

AcronymModel
OCPP Open Charge Point Protocol
CSMSCharging Station Management System
CPCharging Point – the physical system where an EV can be charged
CPOCharging Point Operator – person or team managing a set of CPs using a CSMS
VPNVirtual Private Network
EVElectric Vehicle

1.3 Additional information

For more information on OCPP, you can refer to the official website of the protocol: https://www.openchargealliance.org/

2. Compatibility

2.1 Compatible Wallbox chargers

All Wallbox chargers are now OCPP enabled. If you own an older Wallbox charger model and are unsure of its compatibility, contact Wallbox Customer Service for more specific information.

2.1 Compatible Wallbox EMS

The OCPP-enabled Wallbox chargers are all compatible with all our EMS (Energy Management Systems): Solar Charging, Dynamic Load Management, Static Load Management, and V2H. For detailed information on these features, please refer to their respective guides.

Additionally, the Wallbox chargers are designed to work seamlessly with EMS based on OCPP Smart Charging. When utilizing both Wallbox’s EMS features and OCPP Smart Charging simultaneously, the charging session limits will adhere to the most restrictive settings to ensure optimal performance.

3. OCPP Activation

3.1 Before starting

To connect your Wallbox CPs to your CSMS using OCPP, you must set up an Internet connection and the chargers OCPP parameters using the Wallbox app or Portal.

Please note Wallbox is NOT responsible for any unexpected performance in the CSMS if it has failed to pass the Factory Acceptance Test between CPs and CSMS successfully. If the Factory Acceptance Test fails, please reach [email protected] or your regular Sales Representative.

3.2 OCPP setup

3.2.1 Wallbox account setup

  1. Download the Wallbox app on the PlayStore or the AppStore. Or go to https://my.wallbox.com/.
  2. You must create one if you do not yet own a Wallbox account. You can follow the instructions in this article to create one using the app or this article to create one using the Portal.
  3. Once your account is created, add your charger to your account by following the steps in this article (if you are using the app) or this article (if you are using the Portal).

3.2.2 Charger Internet Connection Setup

To connect your charger to your CSMS, you first need to connect it to the Internet. Depending on your charger’s model, you can connect it using either:

  • Ethernet plug in your Ethernet connector, and the Internet connection will start automatically.
  • Wi-Fi follow this article to connect your charger using the Wi-Fi.
  • Mobile Connectivity (using a 3G/4G dongle) – follow this article to connect a Commander 2 using a 3G/4G dongle and this article for a Copper SB.
Using OCPP with a VPN

If your network uses a VPN connection, you shall allow charger connection to Wallbox Cloud by opening:

  • Domains: *.wall-box.com
  • Ports: 443 and 80
  • Access: Outbound

3.2.3 OCPP Setup and Activation

Once your charger is added to your Wallbox account and connected to the Internet, you can configure the OCPP using either:

  • The Wallbox app (jump to the “OCPP Setup with the Wallbox app” section)
  • The Wallbox portal (jump to the “OCPP Setup with the Wallbox portal” section)
With the Wallbox app

To configure an OCPP connection between your charger and your CSMS using the Wallbox app, follow these steps:

  1. Log in to the app and select your charger.
  2. Wait until the charger is connected to the Cloud (Internet).
  3. Tap the Settings cogwheel in the top right corner.
  4. Tap OCPP and switch on “Enable OCPP”.
  5. In the URL field, indicate your CSMS endpoint.
  6. In the Charge Point Identity field, enter your charge point ID.
  7. Enter your password in the Password field if there is one configured.
  8. Accept the Terms & Conditions, and click Save.

The charger will automatically restart, and the new OCPP configuration will be applied. An OCPP icon will display on your charger app overview screen.

If the OCPP setting is not displaying, your charger is incompatible with the feature. Contact Wallbox Customer Service to check its compatibility.

With the Wallbox portal

To configure an OCPP connection between your charger and your CSMS using the Wallbox Portal, follow these steps:

  1. Log in to the Portal and click Chargers in the left menu.
  2. Select the required charger and ensure it’s connected to the Internet (the WiFi signal icon should display next to its name).
  3. On the charger overview, click Settings and go to Connectivity.
  4. Enable the “OCPP WebSocket connection” switch.
  5. In the URL field, indicate your CSMS endpoint.
  6. In the Charge Point Identity field, enter your charge point ID.
  7. Enter your password in the Password field if there is one configured.
  8. Accept the Terms & Conditions, and click Save.

The charger will automatically restart, and the new OCPP configuration will be applied. An OCPP icon will display on your charger Portal overview screen.

If the OCPP setting is not displaying, your charger is incompatible with the feature. Contact Wallbox Customer Service to check its compatibility.

3.4 OCPP connection status

Once you have completed the pairing process between the charger and your CSMS, an OCPP icon will appear on your charger’s main screen on the Wallbox app and Portal. You will be able to see the OCPP icon on the main screen of your charger on the Wallbox app and Portal.

The icon’s colour depends on the charger’s connection status to the CSMS. Find below the different icons’ colours that can be displayed and their meaning:

OCPP_blue_connected
The charger is correctly connected to the CSMS.
The charger can not establish a connection with the CSMS.
The OCPP is activated, and the charger is connecting to the CSMS

3.5 Charger Features’ Use & Availability

Once a Wallbox charger is connected to a CSMS using OCPP, some actions & features must be performed through the newly connected CSMS. In contrast, others will still be available and performable using the Wallbox app & Portal. Below is the exact list of actions & features that must be performed using your CSMS or the Wallbox ones.

Features & actions that must be performed only through the newly connected CSMS:

  • Charger statistics monitoring
  • Charger settings management
  • Scheduled charging sessions Set Up
  • Users access management

Features & actions that must be performed only through the Wallbox app & Portal:

The features below will NOT be available if the network connection is in a VPN. But the following essential features will still be available if connecting the charger via Bluetooth to the Wallbox app:

– Charger software update
– Restart
– Restore

  • Offline management (charger connected through Bluetooth)
  • Charger Software Update
  • Restart (charger reboot)
  • Restore (to factory settings)
  • MID Meter Set Up
  • EMS Set Up (Static Load Management, Dynamic Static Load Management, Power Boost, Solar Charging)
  • TN/TT Ground System Set Up
  • Current Limit Set Up

Wallbox EMS (Energy Management System) are NOT compatible with OCPP. They only operate when used with the Wallbox app & Portal.

To avoid errors and problems with scheduled charging sessions, use only your CSMS to schedule charging sessions.

It is also important to note the charger “Auto-lock” and “Pause/Resume a charge” features will not be available for the chargers connected to another CSMS.

3.6 Using a charger connected via OCPP

Apart from the features available through your CSMS or Wallbox CSMS described in the previous section, the chargers will continue to follow the same behaviour as described in the guides available on the Wallbox Support website.

To better understand the different status of your charger according to the colour indicated by their status LED, you can refer to their guide below:

Unlocking a charger

When your charger is connected via OCPP to your CSMS, users will be able to unlock the charger by:

  • Using an RFID card
  • Introducing a PIN code (Commander 2 only)
AuthEnabled in CSMS

When the CPO has set the AuthEnabled to TRUE in the CSMS, the charger is unlocked and will not need authorization through an RFID card or PIN.
By connecting the EV gun, the charger will start charging according to the car’s demand.
When the AuthEnabled is set to TRUE, the charger status LED will remain Yellow.

4. Troubleshooting

OCPP connection status remains in “Connecting”

Check network connection status and OCPP parameters setup.

I can not start a new charge.

Check OCPP connection status, RFID authorization and Charge Point availability with your Charge Point Operator.

I can not unlock the charger with the RFID card.


Check the RFID code. When OCPP is active, RFID UID is read as little-endian, hexadecimal, with no separators.

Updated on 25/06/2024

Was this article helpful?