EVlink Pro AC

Modbus
Connectivity Guide

GEX1969300–04
06/2023

www.se.com
Legal Information
The Schneider Electric brand and any trademarks of Schneider Electric SE and its
subsidiaries referred to in this guide are the property of Schneider Electric SE or its
subsidiaries. All other brands may be trademarks of their respective owners.
This guide and its content are protected under applicable copyright laws and
furnished for informational use only. No part of this guide may be reproduced or
transmitted in any form or by any means (electronic, mechanical, photocopying,
recording, or otherwise), for any purpose, without the prior written permission of
Schneider Electric.
Schneider Electric does not grant any right or license for commercial use of the guide
or its content, except for a non-exclusive and personal license to consult it on an "as
is" basis. Schneider Electric products and equipment should be installed, operated,
serviced, and maintained only by qualified personnel.
As standards, specifications, and designs change from time to time, information
contained in this guide may be subject to change without notice.
To the extent permitted by applicable law, no responsibility or liability is assumed by
Schneider Electric and its subsidiaries for any errors or omissions in the informational
content of this material or consequences arising out of or resulting from the use of the
information contained herein.

As part of a group of responsible, inclusive companies, we are updating our

communications that contain non-inclusive terminology. Until we complete this
process, however, our content may still contain standardized industry terms that may
be deemed inappropriate by our customers.
 Modbus

Table of Contents
Safety Information.......................................................................................5
About the Book ............................................................................................6
Safety Precautions......................................................................................7
Product Family ............................................................................................8
Supported Commands ...............................................................................9
EVlink Pro AC Modbus Interface ................................................................10
Registers ....................................................................................................11
Vendor Error Codes ..................................................................................15

GEX1969300–04 3
Safety Information Modbus

Safety Information
Important Information
Read these instructions carefully, and look at the equipment to become familiar
with the device before trying to install, operate, service, or maintain it. The
following special messages may appear throughout this documentation or on the
equipment to warn of potential hazards or to call attention to information that
clarifies or simplifies a procedure.

The addition of this symbol to a “Danger” or “Warning” safety label indicates that an
electrical hazard exists which will result in personal injury if the instructions are not
followed.

This is the safety alert symbol. It is used to alert you to potential personal injury
hazards. Obey all safety messages that follow this symbol to avoid possible injury or
death.

! DANGER
DANGER indicates a hazardous situation which, if not avoided, will result in death or serious
injury.

! WARNING
WARNING indicates a hazardous situation which, if not avoided, could result in death or
serious injury.

! CAUTION
CAUTION indicates a hazardous situation which, if not avoided, could result in minor or
moderate injury.

NOTICE
NOTICE is used to address practices not related to physical injury.

Please Note
Electrical equipment should be installed, operated, serviced, and maintained only
by qualified personnel. No responsibility is assumed by Schneider Electric for any
consequences arising out of the use of this material.
A qualified person is one who has skills and knowledge related to the construction
and operation of electrical equipment and its installation, and has received safety
training to recognize and avoid the hazards involved.

GEX1969300–04 5
Modbus About the Book

About the Book

Purpose of this Document
The purpose of this document is to guide you with the connectivity of
EVlink Pro AC system communicating through Modbus TCP.

Document Version History

Document Release Date Software Evolution
Reference–Revision Version

GEX1969300–04 June 2023 1.3.0 Registers between 2999 and

3222 are reserved.

Registers between 4000 and

4079 are also reserved.

If you read these registers,

value 0xFFFF is
automatically sent back.

GEX1969300–03 April 2023 1.2.1 Exception code Illegal data

address is returned when a
read request is made to an
invalid address.

GEX1969300–02 March 2023 1.2.1 All Modbus addresses from

1211 to 1213 and from 4003
to 4011 have been
incremented by 1.

GEX1969300–01 November 2022 1.1.6

GEX1969300–00 May 2022 Document creation

Terminology
Anacronym Designation

EVSE Electrical Vehicle Supply Equipment (charging station compliant

with OCPP standard)

EVCE Electrical Vehicle Charging Expert

OCPP Open Charge Point Protocol (communication protocol used

between the charging stations and a central system)

Related Documents
Document Title Document Reference– Author Release Date Link
Revision
EVlink Pro AC NNZ1940301–04 Schneider 01/2022 https://www.
Installation Guide Electric se.com/ww/
en/download/
document/
NNZ1940301/
EVP3MM NNZ26782–06 Schneider 09/2021 https://www.
Modem Electric se.com/ww/
Instruction Sheet en/download/
document/
NNZ2678201/

Open Charge 1.6 Open Charge 12/2019 https://www.

Point Protocol Alliance openchargeal-
1.6 liance.org/

www.se.com

6 GEX1969300–04
Safety Precautions Modbus

Safety Precautions

NOTICE
HAZARD OF INCORRECT USE
• This document contains general descriptions and/or general technical
specifications of the products mentioned. It cannot be used to determine the
suitability or reliability of these products for specific user applications. It is the
responsibility of each user or integrator to conduct the appropriate risk
analysis in full, assessing and testing products as regards the application in
which they will be used and the execution of this application. Neither
Schneider Electric nor any of its affiliated companies or subsidiaries can be
held responsible for incorrect use of the information contained in this
document. If you have any suggestions for improvements or correction, or
have found errors in this publication, please notify us.
• All relevant state, regional, and local safety regulations must be observed
when installing and using this product. For reasons of safety and to ensure
compliance with documented system data, only the manufacturer should
perform repairs to components. When equipment is used for applications
with technical safety requirements, follow the relevant instructions.
Failure to follow these instructions can result in equipment damage.

GEX1969300–04 7
Modbus Product Family

Product Family

Charging stations with a T2S Charging stations with an attached Charging stations with a
socket cable T2S socket and a
domestic socket

8 GEX1969300–04
Supported Commands Modbus

Supported Commands
Command
Command sequence between external system and charging station :

External system Charging station

Set command register to command number

[Command successful]
Set command number

[Command unsuccessful]

Set error code

Set command register to 0

Commands list:
• 3 = STOP_CHARGE = command that stops an ongoing charging session.
• 7 = SUSPEND_CHARGE = command that suspends an ongoing charging
session.
• 8 = RESTART_CHARGE = command that restarts a suspended charging
session.
• 9 = REBOOT = command that restarts the charging station.
• 40 = SET_AVAILABLE = command that switches charging station to available
status.
• 41 = SET_UNAVAILABLE = command that switches charging station to
unavailable status.

Lifebit
The Lifebit data allows the monitoring of the communication between external
system and charging station, it is activated as described in the following
sequence:

External system Charging station

Set Lifebit register to 1

Reset Lifebit register to 0 [Lifebit active]

[Verify that external system set

lifebit register to 1]

To deactivate the Lifebit data, the external system sets Lifebit data register to 2.
When activated, Modbus communication is considered as lost if Lifebit data is not
refreshed within configured communication timeout.

GEX1969300–04 9
Modbus Supported Commands

EVlink Pro AC Modbus Interface

EVlink Pro AC Modbus interface can be used to limit the charging power of the
charging station.
This limitation is managed as follows:
• The external system writes current setpoint at address 4004. The maximum
current setpoint sent by the charging station to the vehicle is limited by this
value. Any setpoint change is considered with max. delay of 15 seconds.
• Additionally, in case of communication loss between the charging station and
the external system, a default current limitation is applied: this limitation is set
by writing register 4005 for single phase charging, and 4006 for triphase
charging.
• The Server ID is 255.
NOTE: The detection of communication loss is managed through the Lifebit
data, page 9.

10 GEX1969300–04
Registers Modbus

Registers
NOTE: A request to read a register address that is not in the following table
triggers the Illegal data address exception code.
The table below contains the list of registers accessible to the client on base 0.

Register name Address RW/ Range Type Unit Comment

RO

evState 1 RO [0; 11] uint16 State of the vehicle S1 (EV is connected)

and S2 (load is authorized) + detected error

0: State E: 0V

1: State F: Not available (-12V)

2: State A1: Available, not ready to charge

(12V)

3: State B1: EV connected, not ready to

charge (9V)

4: State C1: Charging EV, stopping charge

requested by EVSE (6V)

5: State D1: Charging EV with ventilation

required, stopping charge requested by
EVSE (3V)

6: State A2: Available, ready to charge (12V

PWM)

7: State B2: EV connected, ready to charge

(9V PWM)

8: State C2: Charging EV (6V PWM)

9: State D2: Charging EV with ventilation

required (3V PWM)

10: State Control Pilot Wire invalid

11: State Control Pilot Wire Symetric - Fault

on the control circuit

OCPP Status 150 RO [0; 9] uint16 OCPP state of the charging station

0: Init

1: Available

2: Preparing

3: Charging

4: SuspendedEV

5: SuspendedEVSE

6: Finishing

7: Reserved

8: Unavailable

9: Faulted
evPresence 1150 RO [0; 1] uint16 Updated only when not charging

0: EV not present

1: EV present

EVSEglobal_major 1212 RO NA uint16 Global release version

EVSEglobal_minor 1213 RO NA uint16 Global release version

EVSEglobal_build 1214 RO NA uint16 Global release version

Current Phase 1 2999 RO [0; Max] float32 A Current on phase 1

Current Phase 2 3001 RO [0; Max] float32 A Current on phase 2

Current Phase 3 3003 RO [0; Max] float32 A Current on phase 3

GEX1969300–04 11
Modbus Registers

Register name Address RW/ Range Type Unit Comment

RO

Current Phase AVG 3009 RO [0; Max] float32 A Average current

Voltage Phase 1 3027 RO [0; Max] float32 V Voltage on phase 1

Voltage Phase 2 3029 RO [0; Max] float32 V Voltage on phase 2

Voltage Phase 3 3031 RO [0; Max] float32 V Voltage on phase 3

Voltage Phase AVG 3035 RO [0; Max] float32 V Average voltage

Power Active Phase 1 3053 RO [Min; Max] float32 kW Active power on phase 1

Power Active Phase 2 3055 RO [Min; Max] float32 kW Active power on phase 2

Power Active Phase 3 3057 RO [Min; Max] float32 kW Active power on phase 3

Power Active Phase TOT 3059 RO [Min; Max] float32 kW Total active power

Power Apparent TOT 3075 RO [Min; Max] float32 kVA Total apparent power

Power factor 3083 RO float32 Power factor

Frequence 3109 RO float32 Hz Frequency

Energy Active TOT 3203 RO [0; Max] int64 Wh Total active energy counter

Energy Reactive TOT 3219 RO [0; Max] int64 kVARh Total reactive energy counter

Lifebit 4000 RW {0; 1; 2} uint16 Lifebit data enables monitoring of

communication between the external
system and the charging station. Refer to
Lifebit data, page 9.

Set command 4001 RW {3; 7; 8; 9; 40; uint16 Set remote command. Refer to Set
41} command, page 9.

Command status 4002 RO uint32 Previous remote command status

Set Point 4004 RW [0 32] uint16 A Remote energy management setpoint in

Amps

99: No charge in progress

Degraded Set Point Mono 4005 RO [0 32] uint16 A Degraded setpoint applied when the
Modbus communication is lost (configured
via eSetup)

Degraded Set Point Tri 4006 RO [0 32] uint16 A Degraded setpoint applied when the
Modbus communication is lost (configured
via eSetup)

Contactor charging time 4007 RO uint32 s Current charging time (duration since
contactor closed)

Session charging time 4009 RO uint32 s Current session charging time (duration
since transaction started)

Last stop cause 4011 RO {1; 2; 3; 4; 5; uint16 Reason of last charge session ending (or
6; 7; 8; 9; 10; charge session start rejection)
11}
0: None

1: EmergencyStop

2: EVDisconnected

3: HardReset

4: Local

5: Other

6: PowerLoss

7: Reboot

8: Remote

9: SoftReset

10: UnlockCommand

11: DeAuthorized

12 GEX1969300–04
Registers Modbus

Register name Address RW/ Range Type Unit Comment

RO

Session energy 4012 RO [0; Max] uint32 Wh Consumed energy during charging session

Error group bitfield 4020 RO uint32 Currently raised error groups (one bit per
group)

Error code bitfield 4022 RO uint32 Currently raised error codes (one bit per
error)

Last event n°0 - event code 4024 RO uint16 Last event n°0 code

Last event n°0 - event start 4025 RO Seconds uint16 Last event n°0 start time
time
Last event n°0 - event end 4026 RO Seconds uint16 Last event n°0 end time
time
Last event n°1 - event code 4027 RO uint16 Last event n°1 code
Last event n°1 - event start 4028 RO Seconds uint16 Last event n°1 start time
time
Last event n°1 - event end 4029 RO Seconds uint16 Last event n°1 end time
time
Last event n°2 - event code 4030 RO uint16 Last event n°2 code

Last event n°2 - event start 4031 RO Seconds uint16 Last event n°2 start time
time
Last event n°2 - event end 4032 RO Seconds uint16 Last event n°2 end time
time
Last event n°3 - event code 4033 RO uint16 Last event n°3 code

Last event n°3 - event start 4034 RO Seconds uint16 Last event n°3 start time
time
Last event n°3 - event end 4035 RO Seconds uint16 Last event n°3 end time
time
EVSE Model 4040 RO Hex EVSE model (2 characters per register)

EVSE Model … RO Hex EVSE model (2 characters per register)

EVSE Model 4049 RO Hex EVSE model (2 characters per register)

EVSE Commercial 4060 RO Hex EVSE commercial reference (2 characters

Reference per register)

EVSE Commercial … RO Hex EVSE commercial reference (2 characters

Reference per register)

EVSE Commercial 4069 RO Hex EVSE commercial reference (2 characters

Reference per register)

All exchanged data through Modbus interface is refreshed every second.

The table below contains the list of Modbus data formats.

Format Type Description

SINT16 A 16-bit signed value in 2-1 (or big ENDIAN) format. The high-order byte is first, the low-order byte is
second.
UINT16 A 16-bit unsigned value in 2-1 (or big ENDIAN) format. The high-order byte is first, the low-order byte is
second.
SINT32 or S32-4321 A 32-bit signed value returned in two consecutive 16-bit registers. The high-order word is returned in
the first register, the low-order word in the second register. The 4 bytes are returned in 4-3-2-1 (or big
ENDIAN) format.

UINT32 or U32-4321 A 32-bit unsigned value returned in two consecutive 16-bit registers. The high-order word is returned in
the first register, the low-order word in the second. The 4 bytes are returned in 4-3-2-1 (or big ENDIAN)
format.
S32-2143 A 32-bit signed value returned in two consecutive 16-bit registers. Contrary to S32_4321, the high-
order word is returned in the second register, the high-order word in the first register.The 4 bytes are
returned in 2-1-4-3 format.
U32-2143 A 32-bit unsigned value returned in two consecutive 16-bit registers. Contrary to U32_4321, the high-
order word is returned in the second register, the low-order word in the first register. The 4 bytes are
returned in 2-1-4-3 format.

GEX1969300–04 13
Modbus Registers

Format Type Description

S32-MFP or S32-M10k-4321 A 32-bit signed value returned in two consecutive 16-bit registers. The word stored in the first 16-bit
register is multiplied by 10000 and added to the word stored in the second 16-bit register. Also known
as signed Modulo 10000.

U32-MFP or U32-M10k-4321 A 32-bit unsigned value returned in two consecutive 16-bit registers. The word stored in the first 16-bit
register is multiplied by 10000 and added to the word stored in the second 16-bit register. Also known
as unsigned Modulo 10000 or mod-10K.

S32-M10k-2143 A 32-bit signed value returned in two consecutive 16-bit registers. Contrary to S32_M10k_4321, the
word stored in the second 16-bit register is multiplied by 10000 and added to the word stored in the first
16-bit register.

U32-M10k-2143 A 32-bit unsigned value returned in two consecutive 16-bit registers. Contrary to U32_M10k_4321, the
word stored in the second 16-bit register is multiplied by 10000 and added to the word stored in the first
16-bit register.

S48-M10k-21-65 A 48-bit signed value returned in three consecutive 16-bit registers. R3*10,000^2 + R2*10,000 + R1,
where R3 is the last register and R1 is the first register. Each registers range is -9,999 to +9,999.

U48-M10k-21-65 A 48-bit unsigned value returned in three consecutive 16-bit registers. R3*10,000^2 + R2*10,000 + R1,
where R3 is the last register and R1 is the first register. Each registers range is 0 to +9,999.

S64-M10k-21-87 A 64-bit signed value returned in four consecutive 16-bit registers. R4*10,000^3 + R3*10,000^2 +
R2*10,000 + R1, where R4 is the last register and R1 is the first register. Each registers range is
-9,999 to +9,999.

U64-M10k-21-87 A 64-bit unsigned value returned in four consecutive 16-bit registers. R4*10,000^3 + R3*10,000^2 +
R2*10,000 + R1, where R4 is the last register and R1 is the first register. Each registers range is 0 to
+9,999.

S64-87-21 A 64-bit signed value returned in four consecutive 16-bit registers. The highest order word is returned
in the first register, the lowest order word in the fourth. The 8 bytes are returned in 8-7-6-5-4-3-2-1 (or
big ENDIAN) format.

U64-87-21 A 64-bit unsigned value returned in four consecutive 16-bit registers. The highest order word is
returned in the first register, the lowest order word in the fourth. The 8 bytes are returned in 8-7-6-5-4-
3-2-1 (or big ENDIAN) format.

S64-21-87 A 64-bit signed value returned in four consecutive 16-bit registers. The highest order word is returned
in the fourth register, the lowest order word in the first. The 8 bytes are returned in 2-1-4-3-6-5-8-7 (or
little ENDIAN) format.

U64-21-87 A 64-bit unsigned value returned in four consecutive 16-bit registers. The highest order word is
returned in the fourth register, the lowest order word in the first. The 8 bytes are returned in 2-1-4-3-6-
5-8-7 (or little ENDIAN) format.

S16-1-15 A 16-bit signed value. Bits 1 to 15 bits are unsigned data. If bit 16 is 0, the value is positive, if bit 16 is
1, the value is negative.

IEEEFloat or F32-4321 A 32-bit IEEE floating point value returned in two consecutive 16-bit registers. The high-order word is
returned in the first register and the low order word in the second. The 4 bytes are returned in 4-3-2-1
format.
SwappedFloat or F32-2143 A 32-bit IEEE floating point value returned in two consecutive 16-bit registers. Contrary to F32_4321,
the high-order word is returned in the second register and the low order word in the first. The 4 bytes
are returned in 2-1-4-3 format.
MaskedBool or PackedBool A 16-bit value that is interpreted according to the bit pattern described by the Mask attribute. Bits
exposed by the mask can be read or written without affecting the value of other bits. Unmasked bits
are interpreted as 0 on a read and are unaffected on a write. Undeclared bits of a mask are interpreted
as unmasked (i.e., mask="0x7F" is interpreted as 0x007F). The value that is read or written is
determined by using enumeration ordinals, described below. If used for read-only Boolean data,
enumerations are not required. If no mask is specified, all bits are relevant.

PF-Nexus A 16-bit unsigned value, range 0 to 3999, representing 3 decimal places of accuracy.

BCD (Binary Coded Decimal) A number is expressed as a sequence of decimal digits and then each decimal digit is encoded as an
8-bit binary number. For example, decimal 92 is encoded as 00001001 00000010.

The following data types can have their length specified by the Number of Registers to Request setting.

Packed BCD A number is expressed as a sequence of decimal digits and then each decimal digit is encoded as a 4-
bit binary number (nibble). For example, decimal 92 is encoded as 1001 0010.

ASCII A sequence of bytes representing the ASCII character set. Each word stores two ASCII characters.
Trailing spaces are removed.

ASCII-Reverse Same as ASCII except every second character is in the reverse order.

14 GEX1969300–04
Vendor Error Codes Modbus

Vendor Error Codes

The table below details all error codes that can be raised by the charging station.

Generic error Specific error name Error Error description OCPP code
name code

Capacity out of range 1.0 Bad configuration of the microswitch. InternalError

Charging station detects that the

Software Firmware downgrade 1.1 software version is lower than expected.
Configuration
Charging station detects that the
Software downgrade 1.2 software version is lower than expected.

Mother board issue 2.0 Issue with EVSE hardware. InternalError

Invalid physical derating configuration

OR change of physical derating
configuration during charge. Configure
Physical derating issue 2.1 InternalError
the microswitch according to the EVlink
Pro AC Installation Guide
(NNZ1940301).
Hardware
Configuration
Plug issue 6mA 2.2 6mA plug missing. InternalError

Plug issue 15118 2.3 15118 plug missing. InternalError

Front cover opened 2.4 Front cover opened. InternalError

Issue on temperature sensor Issue with the temperature sensor. Only

2.5 InternalError
for Eichrecht commercial references.
Upstream MNX tripping Trip of MNX / Contactor discordance.
3.0 OverCurrentFailure
Protection Devices

RDC_DD RDC DD (6mA) measurement RDC DD internal device reports an

4.0 InternalError
board error internal error.

6mA_Detection 6mA DC leakage detected 5.0 DC leakage value higher than 6mA. OtherError

Phase synchronization defect or input

Input voltage issue 6.0 InternalError
voltage or frequency error.
Metering
Internal metering card issue At least one metering fault has been
6.1 InternalError
detected.
Loss of communication with Modbus
Internal power meter power meter for metering (either internal
7.0 or external), for 3 consecutive InternalError
communication loss
PowerMeter unsuccessful attempts.

Verification of the dataset signature failed

Dataset issue 7.1 InternalError
or Others dataset error.
Issue with Bluetooth processor:
Bluetooth Bluetooth communication issue 8.0 communication lost or update impossible. InternalError

Badge reader Badge reader issue Loss of communication with the RFID,
9.0 ReaderFailure
NFC reader.

Communication fault with a Mode 3 / T2

EV issue: Control Pilot (CP) 10.0 EVCommunicationError
vehicle (CP (Control Pilot) error).

Cable status wrong (the value of the

EV_ISSUES Plug Presence (PP) conformity 10.1 EVCommunicationError
coding resistor “PP” is wrong).

Charging fault short-circuit on Control

EV issue: short-circuit CPW 10.2 EVCommunicationError
Pilot Wire.
Wrong handling during the plug/unplug of
Outlet Lock/Unlock cable failure 11.0 the socket, or motor blocked. ConnectorLockFailure

Contactor is not in the requested state:

Contactor Contactor discordance 12.0 welded or blocked in open position. InternalError

Three phases charging not allowed in

Phase_discordance Load three-phase compliancy 13.0 OtherError
simplified mode 3.

Overcurrent or overload charging fault

Overcurrent EV overcurrent 14.0 OverCurrentFailure
due to EV.

GEX1969300–04 15
Modbus Vendor Error Codes

Generic error Specific error name Error Error description OCPP code
name code

Battery gas leakage risk. Car asking

VENTILATION_
Ventilation not allowed 15.0 ventilation that is not compatible with our OtherError
NOT_ALLOWED
products.

Supervision communication lost between

EVCE EVCE communication loss 16.0 EV Charging Expert and the charging OtherError
station.

Communication or configuration of
OCPP Supervision (OCPP) issue 17.0 OtherError
Supervision (OCPP) issue.

The communication between the CPO

and the charging station is lost but the
OCPP CPO communication lost 17.1
Charging station is not in error. Load is
authorized when offline.

Dynamic Energy Management Communication lost with external device

18.0 for energy management (TIC). OtherError
communication loss: TIC
EM
Dynamic Energy Management Communication lost with external device
communication loss: Modbus 18.1 for energy management (Modbus meter). OtherError
meter
Temperature out of the Temperature too high or too low. Only for
Temperature 19.0 OtherError
authorized range Eichrecht commercial references.

16 GEX1969300–04
Schneider Electric
35 rue Joseph Monier
92500 Rueil Malmaison
France
+ 33 (0) 1 41 29 70 00
www.se.com

As standards, specifications, and design change from time to time,

please ask for confirmation of the information given in this publication.

© 2022 – 2023 Schneider Electric. All rights reserved.

GEX1969300–04