RISE V2G

Getting Started

!! PLEASE USE THE UPDATED RISE V2G SOURCE AND GETTING STARTED GUIDE ON GITHUB: https://github.com/V2GClarity/RISE-V2G !!

!! THE PROJECT'S LICENSE HAS CHANGED FROM EPL TO MIT AND WILL, THEREFORE, NOT BE UPDATED ON THE ECLIPSE SITE ANYMORE!!

As the ISO/IEC 15118 defines a client-/server-based protocol, you can use RISE V2G's code to test the client representing the electric vehicle communication controller (EVCC) against the server representing a supply equipment communication controller (SECC, aka a charging station) or just use either client or server against your counterpart implementation. Start the EVCC instance by running StartEVCC.java in the main package of the org.eclipse.risev2g.evcc project. The SECC instance can be started by running StartSECC.java in the main package of the org.eclipse.risev2g.secc project.

The server must be started before the client tries to connect to the server running in the same network. The third of the three provided projects, namely org.eclipse.risev2g.shared, is a required project on the build path of both the EVCC and the SECC side as it holds common classes and libraries used by both entities.

Note that this project relies on a Java 8 runtime environment. Import the project's code as an existing Maven project in e.g. Eclipse. If you are using Kepler (Eclipse IDE), a feature patch needs to be installed for Java 1.8 support.

Maven Quickstart (not necessarily needed if you import maven project in Eclipse)

Prerequisite

1. JDK 8 is installed
2. git is installed
3. Maven is installed
4. Eclipse is recommended (Lunar works perfect with Java 8 and Maven)

Open the terminal/command line tool and check out the source into a folder of your choice:

git clone https://github.com/eclipse/risev2g.git

cd risev2g

maven package

Maven will create two packages for SECC and EVCC in the formats zip, tar.bz2 & tar.gz. The files can be found in the folders

1. risev2g/RISE-V2G-EVCC/target/evcc-1.0.0-SNAPSHOT.[format] and
2. risev2g/RISE-V2G-SECC/target/secc-1.0.0-SNAPSHOT.[format]

To run SECC and EVCC unpack both packages:

unzip RISE-V2G-EVCC/target/evcc-1.0.0-SNAPSHOT.zip -d RISE-V2G-EVCC/target/

unzip RISE-V2G-SECC/target/secc-1.0.0-SNAPSHOT.zip -d RISE-V2G-SECC/target/

Start the SECC first:

cd RISE-V2G-SECC/target/secc-1.0.0-SNAPSHOT

java -jar secc-1.0.0-SNAPSHOT.jar

Start the EVCC (in another terminal session):

cd RISE-V2G-EVCC/target/evcc-1.0.0-SNAPSHOT

java -jar evcc-1.0.0-SNAPSHOT.jar

Once EVCC starts, both libraries start communicating to each other. If you see no errors and just log and debug output you are done.

Import maven project in Eclipse

If you have Eclipse with a proper maven plugin you can choose the following option in Eclipse:

File > Import > Existing Maven Projects > Next

Then choose the risev2g folder (where the project is checked out) as the root directory. A parent pom.xml and three sub projects should be shown and all four items are activated by default. Just press 'Finish'.

If you encounter any Java errors it's always a good idea to try the maven build via

Select parent > right mouse click > Maven > Update Project... > Ok

If the errors don't disappear try to create a new workspace and reimport again. Because old Eclipse versions will create some Eclipse workspace files that could break the build. Somtimes Eclipse gets confused about the correct JDK version.

Configuring the Setup - Properties Files

Both the EVCC and the SECC have a properties file called EVCCConfig.properties and SECCConfig.properties respectively, residing in the root of each project. Take a look at these files to set the needed properties before starting the client and server instance. You can e.g. set the network interface on which the messages are to be exchanged, decide whether the EVCC wants to use TCP or TLS on the transport layer, and other parameters which are explained.

Using TLS And Certificates for XML Signatures

If the EVCC wants to communicate with the SECC via the secure TLS protocol (see setting in EVCCConfig.properties), then you need certain certificates and keys in order to make this communication work. The ISO/IEC 15118 protocol defines a set of certificates and cryptographic parameters which shall apply in case of a secure communciation. To make things as easy for you as possible, you will find a generateCertificates.sh Shell script in the 'RISE-V2G-Certfiicates' folder (not part of the three projects, but residing on the same level) which automatically generates all necessary certificates, private and public keys as well as Java keystores in the respective folders for you.

You should have OpenSSL 1.0.2 (or above) installed to comply with all security requirements imposed by ISO/IEC 15118. For example, OpenSSL 0.9.8 does not come with SHA-2 for SHA-256 signature algorithms. All OpenSSL commands listed in the generateCertificates.sh file are explained for a better understanding. If you are on a Windows machine, just rename the file ending from .sh to .bat.

Hint: If you run the genereateCertificates.sh script, make sure that the keystores folder which holds already generated Java keystores (.jks file ending) is empty.

After you executed the generateCertificates.sh script, you need to do the following:

1. Copy the files evccKeystore.jks and evccTruststore.jks from the keystores folder into the root of the org.eclipse.risev2g.evcc project (on the same level as EVCCConfig.properties).
2. Copy the files seccKeystore.jks and seccTruststore.jks from the keystores folder, the files moCertChain.p12 and cpsCertChain.p12 from the certs folder and the file moSubCA2.pkcs8.der from the privateKeys folder into the root of the org.eclipse.risev2g.secc project (on the same level as SECCConfig.properties).

Now you are ready to go.

Hint: If you already have the Java keystore files in the respective project roots but the TLS communication fails, you might need to generated the certificates and thus keystores again because of an expired contract certificate due to the limited validity period set in generateCertificates.sh file.

Communication Sessions and Interfaces

All session parameters and state information is hold in V2GCommunicationSessionEVCC.java (for the client) and V2GCommunicationSessionSECC.java (for the server) respectively.

There are several interfaces available through which an actual EVCC or SECC instance can be realised:

1. An interface for the information exchange between the EVCC and the internal communication bus of the EV (e.g. CAN) in order to request the relevant charging parameters from the EV as well as to communicate e.g. charging profiles to the EV (see package evController)
2. An interface for the information exchange between the SECC and the internal controller of the EVSE (Electric Vehicle Supply Equipment = charging station) in order to request status information (e.g. about the RDC and smart meter values) or open/close the contactors (see package evseController)
3. An interface for the communication with a backend (e.g. for further communication via e.g. the Open Charge Point Protocol (OCPP)) to request a charging profile for the respective EV (see package backend)

Each interface has a Dummy implementation for testing purposes. You can configure which interface implementation to use in the constructors of the aforementioned V2GCommunicationSessionEVCC.java and V2GCommunicationSessionSECC.java files.

EXI Codec

The default codec for the enconding and decoding of EXI (Efficient XML Interchange) messages is EXIficient library (see package exiCodec in the org.eclipse.risev2g.shared project). You could as well use the OpenEXI library if you change the codec setting in the constructor of the MessageHandler.java file (see package messageHandling of org.eclipse.risev2g.shared).

Logging

Extensive logging through log4j is available and can be adjusted from debugging level to error level with the respective log4j2.xml file.