background image

P30

Overview

Modbus TCP Programmers Guide V1.02

8

© KEBA

2

Overview

Modbus TCP is a standardized communication protocol that enables data
exchange between a master (usually a computer) and several slaves (charg-
ing stations). It is part of the IEC 61158 standard. The Modbus protocol en-
ables control of the connected slaves and transmission of measurement
data from the slave to the master. The data are sent via TCP/IP.

When communicating via Modbus TCP with a KeContact Product, the follow-
ing applies:

Each participant must have a unique address, address 0 is reserved for
the broadcast. Each participant can send messages via the bus. Com-
munication is usually initiated by the master and the addressed slave
replies. Modbus TCP is intended for transmission via Ethernet, for which
TCP port 502 is reserved. The Unit ID must be set to 255.

Supported function codes are FC3 (Read) and FC6 (Write).

Starting register address count is 0. Depending on the used implementa-
tion, +1 might have to be added to adress the right register.

It is not possible to read several registers at once. The maximum read-
ing length is 2 words, as the return values for a single register are
UINT32.

The recommended timing invervals for reading registers is >0.5 sec. For
data, which does not change on a frequent basis, higher intervalls are
recommended. The recommended timing intervall for writing registers is
>5 sec, to avoid stressing of the charging station.

Frame

When sending a Modbus TCP frame, the frame is split into 6 different sec-
tions:

The TCP message starts with a transaction identifier. This is followed by the
protocol identifier (0000) and the number of the following bytes. The address
and the function field are followed by the data, which varies in size depend-
ing on the length of the message. The registers must be sent in decimal for-
mat (e.g. charging state - register 1000).

The following attributes are available:

ro ... read only

wo ... write only

Name

Length

Description

Transaction ID

2 bytes

For synch between messages of server and client

Protocol ID

2 bytes

0 for Modbus TCP

Length field

2 bytes

Number of remaining bytes in this frame

Unit ID

1 byte

Slave address (must be 255)

Function code

1 byte

FC3 (Read), FC6 (Write)

Data

[n] bytes

Data as response or commands

Summary of Contents for KeContact P30 c Series

Page 1: ...KeContact P30 Charging Station Modbus TCP Programmers Guide V 1 02 Original manual ...

Page 2: ...e to further technical developments Details presented may be subject to correction All rights reserved KEBA AG Headquarters Gewerbepark Urfahr 4041 Linz Austria 43 732 7090 0 kecontact keba com www keba com emobility For information about our subsidiaries please look at www keba com ...

Page 3: ...0 3 5 1010 Charging current phase 2 10 3 6 1012 Charging current phase 3 10 3 7 1014 Serial number 11 3 8 1016 Product type and features 11 3 9 1018 Firmware version 12 3 10 1020 Active power 12 3 11 1036 Total energy 13 3 12 1040 Voltage phase 1 13 3 13 1042 Voltage phase 2 13 3 14 1044 Voltage phase 3 13 3 15 1046 Power factor 14 3 16 1100 Max charging current 14 3 17 1110 Max supported current ...

Page 4: ...ce can be used for example by energy managers to calculate the actual current and react correspond ingly to reduce or increase the charging current The Modbus TCP interface can also be used to control limit the power consumption of connected elec tric vehicles Fig 1 1 Schematic overview example 1 1 Safety instructions This document is an extension to the supplied manuals of P30 You must comply wit...

Page 5: ...corresponding safety measures are not taken a potentially hazardous situation can occur that may result in slight bodily injury Caution means that damage to property can occur if the corresponding safety mea sures are not taken ESD This symbol reminds you of the possible consequences of touching electro statically sensitive components Information Identifies practical tips and useful information No...

Page 6: ...gram guide applies exclusively to KeContact P30 c series and to Ke Contact P30 x series It is possible that the present program guide still has printing defects or print ing errors However the information in this program guide will be checked regularly and corrections will be made in the next edition Liability claims against KEBA relating to material or immaterial damage caused by the use or non u...

Page 7: ...g Detailed protocol description of the Modbus TCP standards is not given here Further informations can be found online e g http www modbus org http www feldbusse de ModbusTCP modbustcp_protokoll shtml Manuals and additional information are available on our website www keba com emobility downloads ...

Page 8: ...It is not possible to read several registers at once The maximum read ing length is 2 words as the return values for a single register are UINT32 The recommended timing invervals for reading registers is 0 5 sec For data which does not change on a frequent basis higher intervalls are recommended The recommended timing intervall for writing registers is 5 sec to avoid stressing of the charging stat...

Page 9: ...ady for charging and waits for a reaction from the electric vehicle 3 A charging process is active 4 An error has occurred 5 The charging process is temporarily interrupted because the tempera ture is too high or the wallbox is in suspended mode 3 2 1004 Cable state This register contains the state of the charging cable Index Name Type Attr 1004 Cable State UINT32 ro Supported values 0 No cable is...

Page 10: ...ing current phase 1 This register contains the measured current value on phase 1 in mil liamperes Unit mA Index Name Type Attr 1008 Current L1 UINT32 ro Example Value 645 The charging current on phase 1 is 645 mA 0 645 A 3 5 1010 Charging current phase 2 This register contains the measured current value on phase 2 in mil liamperes Unit mA Index Name Type Attr 1010 Current L2 UINT32 ro Example Valu...

Page 11: ...016 Product type and features This register contains the type and the most important features of the charg ing station Index Name Type Attr 1016 Product UINT32 ro Supported Values Type and features Product type Cable Socket Sup ported current Device series Energy meter Autho rization e g value 3 0 4 0 1 1 KC P30 3 Socket 0 Cable 1 13 A 1 16 A 2 20 A 3 32 A 4 c series 1 x series 0 Standard energy m...

Page 12: ...irmware version Note In P30 Modbus TCP version 1 11 this register s number is 1013 This register contains the firmware version of the charging station The rep resented value is in decimal and has to be converted to hex in order to read the firmware version Index Name Type Attr 1018 Firmware UINT32 ro Example Value 50990336 converted to hex 30A0D00 which means firmware ver sion 3 10 14 0A 10 0D 14 ...

Page 13: ...e phase 1 This register contains the measured voltage value on phase 1 in volts Unit V Index Name Type Attr 1040 U1 UINT32 ro Example Value 230 The measured voltage value on phase 1 is 230 V 3 13 1042 Voltage phase 2 This register contains the measured voltage value on phase 2 in volts Unit V Index Name Type Attr 1042 U2 UINT32 ro Example Value 230 The measured voltage value on phase 2 is 230 V 3 ...

Page 14: ...ype Attr 1100 Max Current UINT32 ro Example Value 10000 The maximum charging current of the charging station is 10000 mA 10 A 3 17 1110 Max supported current Information Socket variants show value 6000 mA as long as no cable is plugged into the charging station This register contains the maximum current value that can be supported by the hardware of the charging station This value represents the m...

Page 15: ...d value is in decimal and has to be con verted to hex in order to read the UID Index Name Type Attr 1500 RFID tag UINT32 ro Example Value 3570234960 converted to hex D4CD7650 for the serial number first 4 bytes of the used RFID card 3 19 1502 Charged energy This register contains the transferred energy of the current charging session Unit Wh Index Name Type Attr 1502 E pres UINT32 ro Example Value...

Page 16: ... Installation Manual Unit mA Index Name Type Attr 5004 Curr User UINT16 wo Supported values 6000 63000 Example Value 8000 The charging current is set to 8000 mA 8 A 4 2 5010 Set energy In this register the energy transmission in 10 watt hours for the current or the next charging session can be set Once this value is reached the charg ing session is terminated Unit 10 Wh Index Name Type Attr 5010 S...

Page 17: ...me Type Attr 5012 Unlock UINT16 wo Supported values 0 unlock plug 4 4 5014 Enable Disable charging station In this register the charging station can be enabled or disabled An active charging process will be stopped Index Name Type Attr 5014 Enable user UINT16 wo Supported values 0 Disable charging station 1 Enable charging station ...

Reviews: