Keba KeContact P30 Udp Programmers Manual
Hide thumbs Also See for KeContact P30:

Advertisement

KeContact
P30
Charging station
UDP Programmers Guide V 2.01
Original manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the KeContact P30 and is the answer not in the manual?

Questions and answers

Summary of Contents for Keba KeContact P30

  • Page 1 KeContact Charging station UDP Programmers Guide V 2.01 Original manual...
  • Page 2 Specifications are subject to change due to further technical developments. Details presented may be subject to correction. All rights reserved. Gewerbepark Urfahr, 4041 Linz, Austria, Phone: +43 732 7090-0, KEBA AG Headquarters: Fax: +43 732 7309-10, keba@keba.com For information about our subsidiaries please look at www.keba.com.
  • Page 3 Added new UDP commands: UDP commands - report 1xx, currtime, setenergy - display, start, stop, unlock Some minor changes and improvements (internet links, frame style of images etc.) 2.01 10.09.2018 Requirements Firmware Version 3.9.14 UDP Programmers Guide V2.01 © KEBA...
  • Page 4 UDP Programmers Guide V2.01 © KEBA...
  • Page 5: Table Of Contents

    3.2.12 UDP command: display ..............3.2.13 UDP command: unlock ..............UDP commands with permanent effects............3.3.1 UDP command: ena ................3.3.2 UDP command: curr ................3.3.3 UDP command: failsafe ..............UDP status messages ..................UDP Programmers Guide V2.01 © KEBA...
  • Page 6 Table of contents UDP Programmers Guide V2.01 © KEBA...
  • Page 7: Introduction

    Fig. 1-1: Schematic overview (example) Safety instructions This document is an extension to the supplied manuals of P30. You must comply with all instructions and safety instructions in the supplied manuals! UDP Programmers Guide V2.01 © KEBA...
  • Page 8: Representation Of Safety Instructions

    Target group This document contains information for people with the relevant technical knowledge and programming skills in the applicable area and appropriate to the operations they are required to perform. UDP Programmers Guide V2.01 © KEBA...
  • Page 9: Requirements

    The following requirements have to be met in order to use the UDP function- ality: ● KeContact P30 c-series or x-series with firmware version 3.9.14 or higher ● The UDP interface is enabled by switching the DIP switch DSW1.3 to “ON”...
  • Page 10: Udp Interface: Guidelines

    Do not communicate with a charging station without addressing it by its IP address. Even if it seems to work fine in some cases, this practice is dan- gerous for multiple stations in the same network. This feature will be dis- continued. UDP Programmers Guide V2.01 © KEBA...
  • Page 11: Recommended Communication Buildup Scheme

    A charging station with an empty whitelist is permanently unlocked and a charging station with at least one entry in the whitelist is locked. The data shown in the following table can be acquired using the command report 2 UDP Programmers Guide V2.01 © KEBA...
  • Page 12: P30 X-Series

    Not empty charging Not empty unlocked and charging The following can be concluded for all device types listed as P30 x-series: If the field “AuthON” is set to “0”, then the authorization function is disabled. UDP Programmers Guide V2.01 © KEBA...
  • Page 13: Current Control

    The field “Curr user” is updated again but the internal timer is already running. The change in the target current is executed and the value of “Max curr” is 09:46:16 changed to the value sent by the last command. UDP Programmers Guide V2.01 © KEBA...
  • Page 14: Udp Commands

    ... UDP command ... Reply Information UDP does not support error correction functionality. Please verify the effect of the sent commands yourself. Port information: ● Send port = UDP 7090 ● Receive port = UDP 7090 UDP Programmers Guide V2.01 © KEBA...
  • Page 15: Udp Commands Intended For Regular Use

    Product name as defined by the manufac- Product String (32 chars) turer Serial String (8 chars) Serial number of the device Firmware String (32 chars) Firmware version of the device No communication module is present. COM-module Communication module is present. UDP Programmers Guide V2.01 © KEBA...
  • Page 16: Udp Command: Report 2

    Charging Error is present Charging process temporarily interrupted be- cause temperature is too high or any other voter denies. Error1 uint16 Decimal number defining the error Error2 uint16 Decimal number defining the error UDP Programmers Guide V2.01 © KEBA...
  • Page 17 0; 10 - 600 uint16 Current value in mA that will replace the set- Curr timer Possible values: ting in the “Curr user” field as soon as “Tmo 0; 6000 - 63000 CT” expires. UDP Programmers Guide V2.01 © KEBA...
  • Page 18: Udp Command: Report 3

    0.1 Wh. This value is reset at the E pres Possible values: beginning of a new charging session. 0 - 999999999 Max. value is 99999999.9 Wh (higher values will cause a counter overflow). UDP Programmers Guide V2.01 © KEBA...
  • Page 19: Udp Command: Report 1Xx (Historical Log Entries)

    This value is incremented session Session ID uint32 by session. Due to the high maximum value (over 4 billion possible IDs), the session ID can be considered unique. UDP Programmers Guide V2.01 © KEBA...
  • Page 20 (authoriza- String (20 chars) tion is set to “OFF”). Serial String (8 chars) Serial number of the device Current state of the system clock in seconds uint32 from the last startup of the device UDP Programmers Guide V2.01 © KEBA...
  • Page 21: Udp Command: Currtime

    [c]: Current setting Possible values: 0; 6000 - 63000 currtime [c] Timeout in seconds before the current will be applied. [t]: Time delay Possible values: 0; 1 - 860400 Values higher than 860400 will be discarded. UDP Programmers Guide V2.01 © KEBA...
  • Page 22 Generic confirmation message Example 1 ● Vehicle is charging. ● UDP command was sent (charging current should change to 7 currtime 7000 20 A after 20 s). ● After 20 seconds the current is changed. UDP Programmers Guide V2.01 © KEBA...
  • Page 23 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 was sent to start the charging session. currtime 7500 15 UDP Programmers Guide V2.01 © KEBA...
  • Page 24: Udp Command: Setenergy

    9 are not being replied to (reserved functions). Invalid values (e.g. let- ters) are leading to a deactivation of the relay. The correct reception can be verified using report 2 Information This command needs DSW1.2 to be set to ON. UDP Programmers Guide V2.01 © KEBA...
  • Page 25: Udp Command: Start

    [id]: RFID tag 8 byte hex string, identifier of RFID card start [id] [class] [class]: RFID class 10 byte hex string, classifier of RFID card Reply structure Field Contents Additional Description TCH-OK: done Generic confirmation message UDP Programmers Guide V2.01 © KEBA...
  • Page 26: Udp Command: Stop

    RFID tag used is the same as the one used to start the charging session. Command structure Command Parameters Additional Description stop [id] [id]: RFID tag 8 byte hex string, identifier of RFID card UDP Programmers Guide V2.01 © KEBA...
  • Page 27 Charging station and vehicle are ready to start the charging session ● RFID card has been held in front of the RFID reader and the charging session has started ● The charging session is stopped using the UDP-command and the RFID tag. stop UDP Programmers Guide V2.01 © KEBA...
  • Page 28: Udp Command: Setdatetime

    1 report 1xx Command structure Command Parameters Additional Description setdatetime [s]: seconds Unix epoch time (e.g. 1497944434) Reply structure Field Contents Additional Description TCH-OK: done Generic confirmation message Example ● Vehicle is charging. UDP Programmers Guide V2.01 © KEBA...
  • Page 29 UDP commands UDP Programmers Guide V2.01 © KEBA...
  • Page 30: Udp Command: Display

    UDP command: unlock The command unlocks the socket of the device. The charging unlock process has to be stopped first (e.g. via currtime 0 1 ena 0 Command structure Command Parameters Additional Description unlock UDP Programmers Guide V2.01 © KEBA...
  • Page 31: Udp Commands With Permanent Effects

    Authorization is set to "OFF" ● UDP command was sent before the vehicle was connected to the charging sta- ena 0 tion. ● Charging station and vehicle are ready to start the charging session. UDP Programmers Guide V2.01 © KEBA...
  • Page 32: Udp Command: Curr

    This command directly changes the value in the "Curr user" field in . All changes made by are permanent until the device is re- port 2 curr UDP Programmers Guide V2.01 © KEBA...
  • Page 33 Command Parameters Additional Description Current value in mA curr [c] [c]: Current setting Possible values: 6000 - 63000 Reply structure Field Contents Additional Description TCH-OK: done Generic confirmation message Example ● Vehicle is charging. UDP Programmers Guide V2.01 © KEBA...
  • Page 34: Udp Command: Failsafe

    : the "Enable sys" value is set to 0 and "Max curr" is equal to "Curr port 2 FS". After the function has been activated due to a timeout, you failsafe must set the values of current and the load enable again using the associ- ated commands currtime curr UDP Programmers Guide V2.01 © KEBA...
  • Page 35: Udp Status Messages

    P30 will provide the information about the following state changes: ● “State” (see “report 2”) ● “Plug” (see “report 2”) ● “Input” (see “report 2”) ● “Enable sys” (see “report 2”) ● “Max curr” (see “report 2”) ● “E pres” (see “report 3”) UDP Programmers Guide V2.01 © KEBA...

Table of Contents