Gesytec eShark HD-PLC LON EVK User manual

This manual refers to the eShark HD-PLC LON EVK
Gesytec GmbH
Pascalstr. 6
52076 Aachen, Germany
Tel. + (49) 24 08 / 9 44-0
Fax + (49) 24 08 / 94 4-100
email: [email protected]
www.gesytec.com
Doc. ID: HD-PLC/UserDoc/eShark_HD-PLC_LON_manual_en_V0201.docx,
Version v2.1, 09/23/2020
eShark
HD-PLC LON
EVK
User Manual

eShark HD-PLC LON EVK
i
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
This Manual …
...describes set-up of and working with the eShark HD-PLC LON EVK. This
manual does not go into details related to theoretical backgrounds of the related
technologies. Please inquire the corresponding literature for further information.
More information about HD-PLC can be found on the website www.hd-plc.org.
Backgrounds about LONWORKS® can be found on the website www.eche-
lon.com.
HD-PLC is a well-established standard to distribute Ethernet and RS485 using
power line cabling or others like twisted pair, coax and more. It is based on IEEE
1901 standard, extended by ITU G.9905 for multi hopping.
ISO/IEC 14908-8 defines the LON protocol using HD-PLC and makes this type
of LON communication open and vendor independent.
Because there is need to download and install a couple of software to start
with the EVK, please reserve at least 4 hours to run through this very first
step.
MegaChips is a provider for HD-PLC compliant silicon. Gesytec provides since
a long time a full LON compliant software stack. Bothe technologies combined
make a new hardware and software solution for LON, independent of other tech-
nology providers.

eShark HD-PLC LON EVK
ii
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
Contents
About HD-PLC LON EVK...............................................................................................4
1.1 Content of the EVK ...............................................................................................4
1.2 Hardware................................................................................................................4
1.3 Software provided..................................................................................................7
1.4 3rd party software needed.......................................................................................8
1.5 PC requirements.....................................................................................................8
1.6 Important Notes .....................................................................................................9
Basics.................................................................................................................................10
2.1 HD-PLC...............................................................................................................10
2.2 LON .....................................................................................................................11
2.3 HD-PLC LON......................................................................................................11
2.4 IP addressing........................................................................................................11
Install Software and Settings ..........................................................................................13
3.1 IP address for the PC............................................................................................13
3.2 STM32CubeIDE..................................................................................................13
3.3 7ST-LINK/V2......................................................................................................13
3.4 Easylon IP Interface+...........................................................................................13
3.5 Easylon HD-PLC gateway software....................................................................17
3.6 Easylon OPC Server M........................................................................................17
3.7 EPOS XIF Editor code generator.........................................................................18
3.8 Easylon Analyzer.................................................................................................18
3.9 Gesyline Manager................................................................................................18
3.10 Echelon IzoT CT..................................................................................................18
3.10.1 Microsoft Visio 2016...........................................................................................18
3.10.2 Echelon IzoT CT..................................................................................................18
Overview...........................................................................................................................19
Setup the hardware..........................................................................................................20
5.1 First steps.............................................................................................................20
5.1.1 Easylon HD-PLC Bridge .....................................................................................20
5.1.2 eShark Box...........................................................................................................20
5.1.3 Gesyline Manager................................................................................................21
5.1.4 HD-PLC LON Master Setting .............................................................................23

eShark HD-PLC LON EVK
iii
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
5.1.5 EasyCheck............................................................................................................24
5.2 Setup for development.........................................................................................26
5.2.1 Breakout board.....................................................................................................26
5.2.2 Debugger..............................................................................................................27
5.2.3 USB terminal connection.....................................................................................27
5.2.4 Check with preloaded application........................................................................28
Developing a LON application........................................................................................29
6.1 Software Structure ...............................................................................................30
6.2 Structure of the LON application on the STM32F091 ........................................31
6.2.1 Header files..........................................................................................................31
6.2.2 Source Code.........................................................................................................31
6.3 Using the XIF editor ............................................................................................32
6.3.1 Define network interface......................................................................................32
6.3.2 Generate ANSI-C application frame work ..........................................................34
6.4 Drop in custom code............................................................................................35
6.4.1 Remarks ...............................................................................................................36
6.5 Download.............................................................................................................36
6.6 Commission in IzoT CT.......................................................................................36
EPOS API for STM32 .....................................................................................................45
7.1 Diagnostics...........................................................................................................45
Hardware details..............................................................................................................46
8.1 Peripherals............................................................................................................46
8.2 STM32CubeIDE..................................................................................................47
8.3 STM32F091 pin out.............................................................................................48

eShark HD-PLC LON EVK
4
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
About HD-PLC LON EVK
1.1 Content of the EVK
The LON HD-PLC evaluation kit comes with all the necessary hard- and soft-
ware to make your first steps in developing LON applications for HD-PLC.
1.2 Hardware
To allow development of HD-PLC LON applications, the EVK consists of this
hardware:
•2 eShark boxes
These boxes are connected to main power. They contain the HD-PLC
CPU, running the LON protocol stack, and the STM32F091CB CPU,
running the end users application.
Both boxes are preloaded with an application, driving all the peripherals
being available on the breakout boards.
Additionally power cables for EU and US are provided.

eShark HD-PLC LON EVK
5
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
•2 breakout boards
The breakout board allows testing own hardware. It is connected using a
ribbon cable with the eShark box. A breakout board additionally adapts
to the ST-LINK/V2 debugger. Furthermore, the diagnostics UART of the
eShark is available with a FTDI UART/USB bridge.

eShark HD-PLC LON EVK
6
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
•1 ST-Link/V2 USB debugger module
This is the debugger to be used for the end user application, running on
the STM32F01CB CPU.
•Easylon HD-PLC Bridge device
To implement a simple solution for the HD-PLC master device an off the
shelf HD-PLC Ethernet converter is used..

eShark HD-PLC LON EVK
7
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
1.3 Software provided
Together with the eShark HD-PLC LON EVK you receive credentials to access
the FTP area for the EVK at https://ftp.gesytec.de/pub/Gesyline/eShark
Here you will get:
•Source code of the demo application
The boxes come with a preloaded application, operating all I/Os of the
breakout boards.
•Easylon IP Interface
All Easylon drivers for a single hardware interface implement multiple
Windows driver instances in MIP and VNI mode for a single interface.
The HD-PLC LON EVK makes use of the Easylon IP driver to give mul-
tiple PC applications access to the HD-PL CLON network simultane-
ously. The kit includes a USB dongle to have a unique neuron IDs for the
PC.
•Easylon HD-PLC gateway software for Windows
Because the eShark box allows connecting the HD-PLC using Ethernet,
the simplest LON connection is making a software bridge from the HD-
PLC LON protocol to a standard Windows LON driver.
•Easylon OPC Server
For easy monitoring a license of the Easylon OPC Server M is provided.
This software comes “as is” and is not intended to be used in productive
environments. Furthermore it is necessary to run the XIF Editor code
generator.
•Gesytec XIF Editor Code generator
Using the XIF Editor code generator allows defining a XIF and creating
an ANSI-C application framework from the defined LON network tem-
plate.
•Easylon Analyzer setup
A license for the Easylon analyzer is provided with the EVK. This soft-
ware comes “as is”.

eShark HD-PLC LON EVK
8
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
•Gesyline Manager
Using this software allows updating the firmware of the BlueChip and
other diagnostics of the HD-PCL network.
1.4 3rd party software needed
For full working with the EVK, some 3rd party software is necessary:
•STM32CubeIDE
The STM32CubeIDE is the preferred solution to define the peripheral pin
definition of the STM32F091CB. It is also designated ANSI-C IDE for
the STM32F091CB application CPU of the eShark box. You can get it
here:
https://www.st.com/en/development-tools/stm32cubeide.html
Please download the standalone version
•Echelon IzoT Commissioning Tool (CT)
Previously known as LonMaker the IzoT CT is necessary to create con-
nections between two devices. Izot CT needs to be purchased from Eche-
lon directly or resellers. A limited demo version can be downloaded from
the Echelon website but needs to have a Microsoft Visio 2016 installed
additionally.
•UART Terminal application
To pick up the diagnostic output of the STM32F091CB available on
UART4, the breakout board provides a FTDI UART/USB bridge. A Ter-
minal application is required e.g. TeraTerm.
https://osdn.net/projects/ttssh2/releases/
1.5 PC requirements
All software is running on Windows operating system from Windows 7 to Win-
dows 10. The PC should have
•64 GByte free disk space
•8 Gbyte RAM
•A second Ethernet interface is recommended

eShark HD-PLC LON EVK
9
HD-PLC/UserDoceShark_HD-PLC_LON_manual_en_V0201.docx
1.6 Important Notes
The designated use of the eShark HD-PLC LON EVK is evaluating the HD-PLC
LON technology and preparing own hardware solutions. It must be used in safe
laboratory environments only.
Due to the powerline technology, the eShark HD-PLC LON is connected to
main power. It must be used only by users, having an appropriate education.
Main power can cause severe harm.
The eShark PLC LON EVK is not designed to run in end users applications. It
is for development and lab usage only. Especially take care on the high voltage
connection. Don’t open the enclosure, when it is under operation.