E-Kit User Manual - ABB - EN
E-Kit User Manual - ABB - EN
N° 1SDH002203A1002
E-kit
User Manual
ABB | E-kit
6 - Commissioning of E-kit......................................................... 17
Power-up............................................................................ 17
Firmware upgrade .............................................................. 17
1 - General information
Intended recipients This document is intended for system integrators.
of this document A system integrator is an experienced person who is perfectly familiar with how to physically and functionally
connect different systems (hardware devices and/or software applications) and who works in compliance
with the laws in force.
Purpose of the manual The purpose of this manual is to guide the user step by step through the E-kit commissioning operations.
The manual includes general information, with details on cyber security, a brief description of the product,
instructions on how to connect the hardware, instructions on how to configure and use E-kit.
Cyber security disclaimer E-kit is designed to be connected and to communicate information and data via a network interface, which
must be connected to a secure network.
Solely the user is responsible for continuously providing and guaranteeing a secure connection between
the E-kit product and the network and establishing and maintaining appropriate measures (for example:
installation of firewalls, application of authentication measures, data encryption, installation of antivirus
programs, etc.). The user must protect the E-kit product, the network, his/her system and his/her interfaces
from all types of security breach, unauthorized access, interference, intrusion, loss and/or theft of data or
information. ABB and its affiliates are not liable for damages and/or losses related to such security breaches,
unauthorized accesses, interference, intrusion, loss and/or theft of data or information.
Protocol Port
ABB netConfig UDP 24576
Online access with driver 3S UDP BlkDrvUdp (with scan) UDP 1740
Online access with driver 3S TCP/IP BlkDrvTcp (no scan) TCP 11740
Modbus TCP Server TCP 502
Web Server TCP 80/443
FTP Server TCP 21
Rules for secure use The Modbus protocol does not provide encryption, authentication or integrity checking of the transmitted
data.
In addition, the web server uses an http protocol that transmits data in cleartext and which could therefore
be liable to interception by unauthorized persons. For these reasons, communication via E-kit and the control
system is not totally secure.
To protect E-kit and make sure that it functions as expected, it must be connected to a reliable network, that
is, with restricted access and monitored. In addition, access to E-kit must be limited to persons authorized
to make changes to the configuration.
If communication between E-kit and a device is interrupted, the web interface of E-kit activates an alarm to
warn of the fault.
How to retrieve your credentials If you lose of forget the password, send an e-mail to [email protected] to reset and
choose a new password.
2 - Overview of E-kit
How E-kit works E-kit is an ABB Electrification solution developed from the ABB Motion AC500 product which provides an
application layer enabling ABB devices and third-party devices to be integrated.
Using E-kit, a device can be integrated by setting a model allowing E-kit to interpret incoming data from
that device correctly. Model creation starts from a generic template, which includes the main measurements
managed by a family of devices (such as circuit-breakers, meters, relays, analog inputs/outputs, etc.).
For security reasons, E-kit does not face the Internet directly but, via integration of an
Electrification Gateway (ELGW), users can view the data of devices integrated by E-kit in the
ABB Ability Energy Manager Cloud solution promoted by ABB Electrification.
E-kit enables several devices to be integrated by means of the Modbus RTU and Modbus TCP/IP protocols.
E-kit integrates up to 45 devices:
up to 15 devices connected via the Modbus RS-485 serial network (Modbus RTU protocol - COM 1 port)
up to 30 devices connected via the Ethernet network (Modbus TCP/IP protocol - Eth1 and Eth2 ports)
Devices with the same interface communicate in a sequential mode, devices with different interfaces
communicate in parallel; up to 8 interfaces for Modbus TCP devices and only 1 for Modbus RTU devices.
A diagram of the architecture of the system is given below.
Templates supported by E-kit E-kit allows different families of devices to be integrated. A dedicated template is available for each family with
the main measurements managed by the devices of the family.
Available templates and models The list of templates could be extended in future. you can find the complete list of templates with also ready-
to-use models available for ABB devices here.
Structure of E-kit E-kit consists of a CPU with a COM1 serial port, two Ethernet ports (used as a switch for Ethernet
connection). An SD card is also supplied with E-kit.
E-kit has an integrated web server presenting a web interface for the purpose of configuring and
displaying all the states of the devices connected.
Access to the web interface The web interface can be accessed in the following ways:
• via the browser, by entering the IP address set during the configuration process in the address bar (see
Setting of static IP address (recommended).
• via Ekip Connect 3 software (see Integration with Ekip Connect 3).
SD card functions The SD card provided in E-kit enables the following functions to be performed:
• Update the software of E-kit
• Backup the configuration created
• Update the catalog of templates and models supported by E-kit
3 - Power supply
Introduction E-kit must be supplied at 24 V D.C. E-kit connects to the power supply by means of a removable 5-pin
terminal box. Thanks to replication of pins L+/M, E-kit can, for example, supply external sensors (up to 8 A
max with 1.5 mm2 conductors).
Alerts
WARNING!
Risk of damaging CPU and base of terminals!
Exceeding the maximum voltage value could cause irreparable damage to the system.
The system could be destroyed.
WARNING!
Risk of faulty operation!
To ensure reliable and correct operation, the supply voltage must increase from 0 to 24 V within
2.5 s maximum.
WARNING!
Risk of damage to base of terminal and power supply!
Short-circuits could damage the base of the terminal and power supply.
Make sure that the four L+ and M terminals (two of each) have not been connected in the wrong
way (e.g. +/- the power supplier is connected to both L+/L+ or both M/M terminals).
WARNING!
Risk of damage to base of terminal!
A high current could damage the terminal and base of the terminal.
Make sure that the current which flows through the removable terminals is never higher than 8 A
(with 1.5 mm of conductor).
WARNING!
Connector unused!
Make sure that the terminal box is always plugged into the terminals, even when there are no
cables connected.
Connection ports A Modbus RS-485 network connects a Master device to one or more Slave devices.
Each device has a communication port with two terminals, conventionally called A and B. The communication
cable is connected in these two terminals so that all the devices taking part in the communication are
connected in parallel.
All “A” terminals must be connected to each other and all “B” terminals must be connected to each other,
respectively.
Note: Certain ABB devices, such as electrical metering instruments B21, B23, B24, are an exception. For
this reason, terminal M+ will now be indicated as the positive terminal while terminal M- will be indicated as
the negative terminal.
If connections “A” and “B” of a device are inverted, besides making them incapable of communicating, the
entire communication system may not function due to the incorrect direct current (bias) voltage values on the
terminals of the badly connected device.
To prevent errors when several devices are connected, it is advisable to use cables of the same color for
all connections to the A terminals and cables of the same color for all connections to the B terminals of the
different devices (e.g. white for A/M+ and red for B/M-). This makes it much easier to identify cabling errors.
Connection among devices The Modbus RS 485 network is of the “daisy-chain” type (also called in-out) where all the devices in the
network are connected in serial mode. Connection among devices is direct, without ever crossing the cables.
Examples of incorrect connections are illustrated in the next figure
The first setup below is the correct one. Cabling examples are given in the figure below.
Maximum distance and The main cable can be up to 700 m in length. This distance does not include branches (which, however, must
maximum number of devices be short). Up to 15 devices (besides E-kit) can be connected to a main cable.
Type of cable required Shielded twisted pair cable is required. ABB specifies Belden 3105A cables, but other types with equivalent
characteristics can be used.
Twisted pair cable is formed by two insulated conductors twisted together. This improves the level of immunity
to electromagnetic disturbances. The cable forms a series of consecutive coils, each pointing in the opposite
direction to the next. If there were a magnetic field in the vicinity, it would pass through each pair of coils in
opposite directions and its effect would consequently be very much reduced. Theoretically, the effect on each
coil is exactly opposite to that on the next, thus the resulting effect is annulled.
The shielding can be “braided” (formed by a woven lattice of conductor wires) or the “foil” type (formed by a
sheet of metal wound around the conductors): the two types are equivalent.
Termination resistor To avoid signal reflection, a 120 Ohm termination resistor must be fitted to each end of the main cable.
Installation of termination resistors can only be omitted if the main cable is less than 50 m in length.
Note: there is no internal termination resistance in ABB SACE new Emax, X1 air and Tmax molded-case
devices and in the majority of ABB devices.
Pull-up and pull-down resistors Two resistors, equal to 470 Ω, are integrated into connector COM1 of E-kit. They maintain a high level
defined in the Modbus network, even when data exchange is not taking place. To activate them, just connect
terminals 1 to 2 and 3 to 4 as shown in the diagram below.
1. Positive terminator
2. Modbus M+
3. Modbus M-
4. Negative terminator
1. E-kit Master at the end of the bus line, pull-ups and pull-downs activated, bus termination with 120
Ω resistors
2. Slave in the serial line.
3. Slave at the end of the serial line, termination with 120 Ω resistors
There is no need for a termination resistor if the Master device is in the serial line. However, the pull-up and
pull-down resistors must be activated (see next diagram).
Communication parameters All of the devices in the same Modbus network must have the same communication parameters. The values
of each parameter are given below:
• data transmission speed, known as baud rate: 9600 bps;
• data bits (number of bits): 8;
• parity bits: Even;
• stop bits: 1;
• address of each slave
E-kit Master will only be able to acquire data when the parameters of all the devices have been set correctly.
Baud Rate Disclaimer The baud rate of E-kit is: 9600 baud/s.
Sampling time is about 26 seconds using the Modbus RTU protocol and connecting up to 15 devices.
For this reason, it is inadvisable to acquire data at higher frequency.
Description of terminal box The connector for Ethernet communication is the RJ45 type. Pin allocation is given in the next table:
Type of cable required Use braided twisted pair cables (TP cables) of at least category 3 (IEA / TIA 568-A-5 Cat3) or class C
(according to the European standards) for 10 MBit/s (10Base-T) Ethernet.
Braided twisted pair cables (TP cables) of category 5 (cat5) or class D or higher should be used for 100 Mbit/s
(fast) (100Base-TX) Ethernet.
Maximum distance The maximum length of a trunk, i.e. the maximum distance between two network components, is limited to
between devices 80 m due to the electrical properties of the cable.
13 | © 2022 ABB | - 1SDH002203A1002 Ethernet communication interface (ports ETH1 and ETH2)
ABB | E-kit
Setting of static The IP address of E-kit is configured by means of the keypad. The IP address is expressed on the display in
IP address (recommended) form A1.A2.A3.A4, the subnetwork in form N1.N2.N3.N4 and the network gateway in form G1.G2.G3.G4.
An example is given below:
IP 192.168.0.113 → A1=192, A2=168, A3=0, A4=113
subnetwork 255.255.255.0 → N1=255, N2=255, N3=255, N4=0
gateway 192.168.0.1 → G1=192, G2=168, G3=0, G4=1
The parameter indicator will start to flash Use the arrow keys to
change the value.
Press CFG to edit the first parameter. Use the arrow keys to
change the value.
Repeat these steps to configure parameters A3, A4, N1, N2, N3,
N4, G1, G2, G3, G4.
14 | © 2022 ABB | - 1SDH002203A1002 Ethernet communication interface (ports ETH1 and ETH2)
ABB | E-kit
The word DHCP will start to flash. Press CFG to confirm the setting.
Configuration of To access E-kit via a PC, this latter must have a compatible network address. If the E-kit address is
PC Ethernet network 192.168.0.113, then the PC can be assigned address 192.168.0.114.
The procedure for configuring the IP address of a PC with Windows 10 Operating System is given below.
1. Right-click on the Start icon at the bottom left and select Settings.
15 | © 2022 ABB | - 1SDH002203A1002 Ethernet communication interface (ports ETH1 and ETH2)
ABB | E-kit
3. Select Ethernet from the window on the left of the menu and click on Change Adapter Option.
16 | © 2022 ABB | - 1SDH002203A1002 Ethernet communication interface (ports ETH1 and ETH2)
ABB | E-kit
6. Make sure that the Use the following IP address item has been selected and fill out the parameters
as follows:
• IP address: 192.168.0.114
• Subnet mask: 255.255.255.0
• Default Gateway: gateway address, if present.
6 - Commissioning of E-kit
Power-up E-kit powers up automatically when correctly supplied. After power-up, the word E-Kit will appear on the
display.
From this moment onwards, all the information acquired by the devices will be accessible via Modbus RTU
and TCP.
Firmware upgrade New firmware can be obtained if the following situation occurs:
• Faulty operation of web interface
Send an email to the Support Center ([email protected]). The Support Center will provide
help and guide you through the E-kit firmware upgrade.
Usage session Several sessions of E-kit can be active at the same time. This means that up to 15 browser tabs can be
opened, but all with the same user level.
For example, if the open session is in the Admin user mode, then a simultaneous session cannot be opened
in the Guest user mode, and vice versa.
Access to the web interface To access the E-kit integrated web server, open the browser (tested on Google Chrome web browser) and
type the IP address set during the configuration process into the address bar (see Setting of static IP address
(recommended)).
The footer on the left provides the option to restart E-kit using button and to save any changes made to
the settings of the devices using button / (function only available for Admin users).
The save button turns red if there are changes that have not been saved . The new changes will be lost
if the session is closed without saving.
The software version and E-kit status are displayed in the status bar on the right. The dot alongside the
version flashes alternately in the grey and yellow colors in the absence of faults, otherwise it remains fixed
on the same color.
The current user is displayed in the right header. Click on the Login button to change the user.
The area on the left displays the menu and enables the devices to be viewed in the list at center screen while
the focus, i.e. the detail of the device selected in the list, is shown in the right-hand part of the page.
The button at the bottom of the menu allows the Admin user to access the database for model
management.
1. Click on Login in the homepage header, enter the Admin user password (“Admin” by default) and click
on Login.
Enter of the Admin user password accesses the system with administrator rights and opens the window
below.
2. To change the password, enter the new password in Password and click on Change password. After
this operation, the words “Password changed” will appear under the button.
1. Click on button to save the changes made to the system configuration: a window will open with a
request for confirmation before saving.
2. Click on Save to save the changes locally: the icon in the button becomes . Click on Cancel to
cancel saving.
Copy configuration You can copy the configuration of an E-kit into another E-kit using the SD card.
to another E-kit
1. Save the configuration of the first E-kit in the SD card ( > Save > Backup to SD).
2. Remove the SD from the first E-kit.
3. Insert the SD into the other E-kit and click on to reboot it. A window will appear asking for
confirmation before rebooting. Click on OK.
Configuration of a device Individual devices can be configured in the Admin user mode. Click on the icon at the top of the menu to
access the required section. The first ten devices are displayed. Use arrows < and > to browse through the
pages of the up to 45 available devices.
Each device comprises the following parts, indicated in the figure below:
1. Index of device, i.e. the order in which the devices were inserted;
2. Name of device;
3. Template of device;
4. Communication status (red: not connected, green: connected, white: not used);
Click on the Configuration button at the bottom of the focus. This will access the window below, where you
can configure the selected device in the following way:
Use arrows < and > to browse among the pages of the channels available in the Channels section.
There are three types of channels available:
• User: information that can be edited by the user, not acquired by the device;
• Modbus: information acquired by the device;
• Constant: information defined in the model, not acquired by the device.
• Logic: values processed by logic defined in E-kit. Not used at the present time.
The rectangle containing the word valid illustrated in the next figure shows whether the corresponding
Modbus value has been acquired correctly:
• Green: acquisition correct
• Grey: acquisition not correct
To change a value in the User type channel, click on the corresponding value. This will access a window
where the required value can be entered. Click on Update to change the value, otherwise click on Cancel
to quit without performing actions.
Select the template and click on New From Template to create a model from a template. Select the model
and click on New from selected to create a model from an existing model.
The configuration window of the new model shown in the Figure below is accessed in both cases. The Edit
Model window is divided into two parts: the following fields are displayed in the left part:
1. Template;
2. Vendor: automatically set as “User” for a new model;
3. Name: editable field with the name of the new device;
4. Swap Bytes select Yes if the bytes are swapped;
5. Endianess: selectable big and little endian fields.
6. Address Base: select the Base Address type of the device whose model you want to create.
The required channels can be selected in the right part and configured by browsing among the pages using
arrows < and > .
The following is an example of parameters displayed with Target = Constant. The Constant Value
parameter, with which a constant value can be assigned to the data item, is added in this case.
Click on Save to save the changes to the model. The word Saved appears alongside the button to notify that
saving has taken place. After this, press Close to close the window.
Available information and actions An example screen shot is illustrated in the figure below:
Selection of an individual device opens the corresponding focus where the name of the device, the variables
and configured states can be viewed. The index, the type of device, interface, template, model, status and
refresh time are given in the Info section. The available channels appear in the Channels section along with
the values read by the device, if used and connected. You can browse among the pages of the available
devices and among the pages of the channels of the selected device using arrows < and >.
E-kit with Ekip Connect 3 Ekip Connect 3 allows you to communicate with E-kit and access its web interface.
Requirements Download Ekip Connect here to integrate E-kit using the Ekip Connect desktop solution.
Consult the manual for further information about Ekip Connect and how to install it.
Procedure
1. Access the Connection to devices area in the homepage of Ekip Connect and click on link to connect
a device in the manual mode
If the procedure has been performed correctly, the web interface of E-kit will open in Ekip Connect.
11 - Technical specifications
Dimensions The dimensions of E-kit are given below in millimeters. The dimensions in inches are between brackets.