Keba KeContact P30, Udp Programmers Manual

Page 1: ...KeContact P30 Charging station UDP Programmers Guide V 2 01 Original manual...

Page 2: ...subject to change due to further technical developments Details presented may be subject to correction All rights reserved KEBA AG Headquarters Gewerbepark Urfahr 4041 Linz Austria Phone 43 732 7090 0...

Page 3: ...ements Changed chapter Supported UDP commands Added chapter UDP command failsafe Changed chapter UDP command re port Changed chapter UDP commands Added new UDP commands report 1xx currtime setenergy d...

Page 4: ...P30 UDP Programmers Guide V2 01 4 KEBA...

Page 5: ...x series 12 2 5 Current control 13 3 UDP commands 14 3 1 General information 14 3 2 UDP commands intended for regular use 15 3 2 1 UDP command i 15 3 2 2 UDP command report 1 15 3 2 3 UDP command rep...

Page 6: ...P30 Table of contents UDP Programmers Guide V2 01 6 KEBA...

Page 7: ...tation or to control the charging station with a UDP client PC software or smartphone app Using UDP the charging station can be integrated into a smart home which allows for example the current power...

Page 8: ...s 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...

Page 9: ...tallation man ual A PC or smartphone for sending the UDP commands This also requires a suitable UDP client software or UDP app The charging station has to be connected via LAN cable or WLAN to the sam...

Page 10: ...between the scheduled repetitions of any UPD command is defined as follows t_COM_pause 5 s The minimum waiting time after sending a disable command e g ena 0 is defined as follows t_DIS_pause 2 s 2 2...

Page 11: ...he complete device data and all acquirable information is available to the application 2 4 RFID authorization The following section provides information regarding the RFID authorization function as we...

Page 12: ...iFi components The RFID authorization can be deactivated even though the whitelist of the charging station is not empty P30 x series will behave like P30 c series after a restart until the COM mod ule...

Page 13: ...and curr The request to stop charging via currtime 0 1 will not be delayed and executed as soon as possible When a command either currtime or curr sets a new value for Curr user the device prepares t...

Page 14: ...directly addressed com mands In a group of several charging stations direct addressing must be used because otherwise all charging stations would react The commands are sent to the charging station as...

Page 15: ...e done by using i Command structure Command Parameters Additional Description i Reply structure Field Contents Additional Description Firmware String 32 chars Firmware version of the device 3 2 2 UDP...

Page 16: ...of the device 3 2 3 UDP command report 2 Command structure Command Parameters Additional Description report 2 Reply structure Field Contents Additional Description ID 2 ID of the report State 0 Start...

Page 17: ...uint16 Possible values 0 6000 32000 Current value in mA offered to the vehicle via control pilot signalization Signal type PWM Max curr uint16 Possible values 100 533 1000 Duty cycle of the control p...

Page 18: ...seconds from the last startup of the device 3 2 4 UDP command report 3 Command structure Command Parameters Additional Description report 3 Reply structure Field Contents Additional Description ID 3 I...

Page 19: ...ing sessions report 100 shows the latest charging ses sion After a reboot the report will deliver all zero values If a new session is started by plugging in the vehicle a new Session ID is created in...

Page 20: ...sion started YYYY MM DD hh mm ss 000 string 23 chars If the device cannot access an NTP time server this field will contain the same data as started s or set with setdatetime ended YYYY MM DD hh mm ss...

Page 21: ...h the command report 2 currtime 0 1 This command issues a charging stop similar to ena 0 The charging station will display a blue main LED bar Charging will be refused until the setting is overwritten...

Page 22: ...Reply structure Field Contents Additional Description TCH OK done Generic confirmation message Example 1 Vehicle is charging UDP command currtime 7000 20 was sent charging current should change to 7...

Page 23: ...s Guide V2 01 23 KEBA Example 2 Cable is plugged into charging station and vehicle furthermore the cable is locked Charging is not allowed due to UDP command ena 0 UDP command currtime 7500 15 was sen...

Page 24: ...lue defined by setenergy is smaller than the energy transferred dur ing the last charging session One variant of the setenergy command must be highlighted setenergy 0 A previously set energy limit is...

Page 25: ...be used to authorize a charging session if the au thorization function is activated The effect is the same as holding an RFID card in front of the RFID reader The command needs a valid RFID tag from...

Page 26: ...ize a charging session if the au thorization function is activated The effect is the same as holding an RFID card in front of the RFID reader during a running charging session The deauthorization will...

Page 27: ...CH OK done Generic confirmation message Example Authorization is set to ON Charging station and vehicle are ready to start the charging session RFID card has been held in front of the RFID reader and...

Page 28: ...ished between how trustworthy the time stamp is Strong synced time time was synced within 4320 minutes 3 days via NTP time was synced within 4320 minutes 3 days via OCPP time was synced within 4320 mi...

Page 29: ...P30 UDP commands UDP Programmers Guide V2 01 29 KEBA...

Page 30: ...ocessed internal MID meter ing relevant information may overrule this max Defines the duration in seconds how long the text is displayed if no additional display com mand follows tk Token for internal...

Page 31: ...ng ena 0 the device will be disabled until it is rebooted or ena 1 or currtime are used The execution of ena 0 will take approximately 1 second If ena 0 is used then no other command should be sent fo...

Page 32: ...KEBA 3 3 2 UDP command curr The command curr can be used to control the target charging current at any time This command directly changes the value in the Curr user field in re port 2 All changes mad...

Page 33: ...eral it is not recommended to use the curr command since the current can be easily controlled via the non permanent currtime If the charging current of the charging station needs to be lowered permane...

Page 34: ...et up the device in such a way that electrical overload can be avoided The hardware switches DIP switches allow to configure a limit for the maximum charging current that cannot be in creased by UDP c...

Page 35: ...arted 1 The failsafe function is active and saves the settings into the EEPROM The failsafe function will still be active after a reboot Reply structure Field Contents Additional Description TCH OK do...