manualshive.com logo in svg

Gesytec eShark HD-PLC LON EVK, User Manual, Page: 22 / 49

Share
Download
Gesytec eShark HD-PLC LON EVK User Manual Download Page 22

                      eShark HD-PLC LON EVK 

 

 

 

21 

HD

-P

LC/

Us

erDo

ce

S

h

ark

_

HD

-P

LC_

LON_

m

an

u

al

_

en

_

V

0

2

0

1

.d

o

cx

 

 

5.1.3 

Gesyline Manager 

Start the Gesyline Manager.  

Note: The Gesyline Manager MUST be launched with administrators’ 
rights! 

 

Live LED 

Service Pin Push Button 

Service LED 

Lon Stack Error 

Summary of Contents for eShark HD-PLC LON EVK

Page 1: ...VK Gesytec GmbH Pascalstr 6 52076 Aachen Germany Tel 49 24 08 9 44 0 Fax 49 24 08 94 4 100 email info gesytec de 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 ...

Page 2: ...rd 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 res...

Page 3: ...nstall 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 ...

Page 4: ...pplication 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 ...

Page 5: ...ations 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 Add...

Page 6: ...cx 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 ...

Page 7: ...01 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 ...

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

Page 9: ...oad 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 diag...

Page 10: ...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 en...

Page 11: ... T G 9905 IP Support IPv4 IPv6 IETF There are some special terms with HD PLC which will be used in this documen tation Master This is a dedicated device managing the routes between the individual HD PLC devices Especially in case of a Multi Hop network the master device permanently checks the connections and calculates the most effi cient routes between the devices Usually an HD PLC device offers ...

Page 12: ...ron chip to build a LON PC interface Nowadays it stands more for a LON interface on LON layer 5 So a MIP interface already address ing and transaction handling VNI VNI stands for Virtual Network Interface A VNI allows accessing a LON network on layer so all LON messages can be received and sent It is the most flexible solution and offering best performance Echelon s IzoT is using a VNI interface t...

Page 13: ...eShark HD PLC LON EVK 12 HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx The IP address of the eShark Boxes can be set using the Gesyline Manager ...

Page 14: ...ommunication with the HD PLC system to have a clean environment 3 2 STM32CubeIDE After downloading the software just execute the setup according to the setup guidelines Please check after installing that the SMT32F0 package is installed by calling Help Manage Embedded Software Packages menu Usually an STM32F0 is al ready installed and can be maybe already updated 3 3 7ST LINK V2 Just connect the S...

Page 15: ...og The setup for the Easylon Interface drivers installs a management tool named Easylon Interface Management Center short EIMC to control the drivers Now connect the USB dongle to the PC Please start the EIMC and check if the configuration tree looks like the next pic ture the Easy852 0 network interface present the Easy 852 Service with one ...

Page 16: ...852 0 interface and change the number of VNI and MIP inter faces to 4 Please note All the time if there are entries in bold in the properties pane you need to press the disk symbol to make the changes become active In a next step please change the names of the instances below Easy852 0 to the shown names Take care sometimes a blank is added as first character of the Adapter Name please delete that...

Page 17: ... like the Easylon Analyzer OPC Server EasyCheck or 3rd party application Each hook can only be used by a single application e g the Easylon Analyzer and the Easylon OPC Server can t share an interface at the same time Please track which MIP hook is used for which application You may rename MIP0 MIP3 according to your favor to realize an easy differentiation of use Finally run EasyCheck from the st...

Page 18: ...ooks of the Easylon driver and the Easylon driver makes the LON messages available on all other driver hooks That s the reason why one of the hooks was renamed to HDPLC to make the setup easy Just start the hdplc exe found in HDPLC EasylonDriver with this command line hdplc d HDPLC L 192 168 0 1 Most likely Windows will ask now to enable the application working through the firewall 3 6 Easylon OPC...

Page 19: ...tarted without any installation Please copy the content of the directory together with the c xtf and h xtf files to a directory of your favour 3 8 Easylon Analyzer The Easylon Analyzer needs to be connected to one of the MIP0 MIP3 inter faces You find a license for the Easylon Analyzer on the license sheet provided with the EVK The setup is located in HDPLC EasylonAnalyzer 3 9 Gesyline Manager The...

Page 20: ...HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx Overview The drawing shows the full setup of the EVK In the next chapter you will guided step by step through doing the physical connections and how to verify a proper setup ...

Page 21: ... power cable to the eShark box Verify the position of the M T switch it must be set to M Connect the master HD PLC device to the PC with an Ether net cable You may use an Ethernet switch 5 1 2 eShark Box Connect a power cable to the eShark boxes Check the position of the M T switch It must be set to terminal Now connect all devices to main power After a short time the yellow PLC LED on the master ...

Page 22: ...PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx 5 1 3 Gesyline Manager Start the Gesyline Manager Note The Gesyline Manager MUST be launched with administrators rights Live LED Service Pin Push Button Service LED Lon Stack Error ...

Page 23: ...l_en_V0201 docx Verify the IP address setup by selecting the Connection setup dialog Verify the PLC Device IP address and the Host PC IP address Now close the dialog and press the Update button on the left side The software now scans the HD PLC network for devices ...

Page 24: ...ices and press Firmware update button Then reboot If you want to change a device setting you need to uncheck the Read only flag in the dialog Setting 5 1 4 HD PLC LON Master Setting The Easylon HD PLC Bridge firmware name EPOS_XCA that is the HD PLC Master provides the HD PLC LON Master functionality It receives unicast mes sages from other eShark boxes terminals collects them according to the agg...

Page 25: ... Master s MAC address for each eShark terminal Note The master s IP address MUST be unique Change the IP address of the terminals to another value for example 192 168 0 248 5 1 5 EasyCheck Please check that hdplc exe is running as described above We will do now the first HD PLC LON communication test using EasyCheck the service utility for the Easylon Interfaces Pressing the button close to the ri...

Page 26: ..._manual_en_V0201 docx Start EasyCheck and select the Service Pin tab Select in the network interface combo box MIP0 and then press the button Wait for Service Pin Now press the Service Pin button on the eShark boxes and you will have this output in EasyCheck ...

Page 27: ...ON_manual_en_V0201 docx After verification that the communication is working and we are ready to go into detail 5 2 Setup for development Take care to turn of power for the EVK system 5 2 1 Breakout board Connect the breakout boards using the ribbon cable ...

Page 28: ...ection Finally connect a USB cable to the USB port of the breakout board This will in stall the FTDI USB drivers on the PC and generate a virtual COM port In HDPLC utilities you will find FTDI Ports exe This application scans for FTDU USB Uarts and list them together with their serial number The serial number of the FTDI USB uart chip is printed on the breakout board Connector to eShark Connector ...

Page 29: ...201 docx The demo application is using 115200 n 8 1 as parameters 5 2 4 Check with preloaded application Please turn on now main power The red LEDs on the breakout boards will turn on Pressing the pushbutton on a breakout board will turn off the red LED of the other one ...

Page 30: ...ts the NVs are grouped in The EVK software helps the developer by generating an ANSI C framework including the definitions for the NVs and handling updates between the BlueChip and the SMT32F091CB microcontroller This chapter uses the provided source code of the demo application to explain the development workflow The demo application is handling the digital and an alog inputs and outputs together...

Page 31: ...eShark HD PLC LON EVK 30 HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx 6 1 Software Structure This is your playground Fixed and pro ven software en vironment ...

Page 32: ...application e g including the index definitions for the network variables It is generated by the XIF editor utility EposDebug h The LON API generates debug prints which are sent to UART4 of the STM32 being available with the FTDI USB UART The print can be deactivated in this file EposHostApp h This file remains unchanged it is for internal use by the LON API EposSerialComm h This file remains unch...

Page 33: ...ppUtil c serrecv c All this files implement the serial driver for the communication between the STM32F091CB and the BlueChip These files remain unchanged Main c It includes the startup of the applica tion and the main while 1 loop call ing the merry go round functions for the LON api and the peripheral han dling It is generated by the STM32CubeMx utility User code must be placed between the USER C...

Page 34: ...ble to add or remove network variables Adding network variables requires selecting a SNVT type If the number or types of network variables are changed the program id MUST be changed Otherwise IzoT CT will complain an inconsistency with the previous definition and stop commissioning the device ...

Page 35: ...network variables so they do have an Array Size according to the number of inputs and outputs The demo application is configured to use 6 digital inputs and 6 digital outputs 6 3 2 Generate ANSI C application frame work After defining the network variables the C framework needs to be generated Se lect the menu entry File Export for EPOS ...

Page 36: ... in these files will be de stroyed Sync both source codes afterwards 6 4 Drop in custom code Now custom code needs to be dropped into the generated framework For incom ing updates here the updates for the digital output network variable nviDigitalx switch msg nv_index case NvIdx_nviDigital_0 0 nviDigital 0 HAL_GPIO_WritePin DIO2_GPIO_Port DIO2_Pin msg value 0 GPIO_PIN_SET GPIO_PIN_RESET break case...

Page 37: ...nged peripheral status and calls the appropriate change function for EPOS 6 5 Download After compiling the code it can be downloaded using a connected ST LINK V2 debugger You may use breakpoints to pick up the events Additionally you may use TeraTerm to receive the debug prints of the application 6 6 Commission in IzoT CT When the system is running you are able now to generate a connection between...

Page 38: ...t Visio is starting now and will act as graphical user interface for IzoT CT The next dialog asks for the Network interface name select Network attached and LNS as Network interface name IzoT CT asks now for Plug In registration Please tick the checkboxes as shown below and press Finish ...

Page 39: ...eShark HD PLC LON EVK 38 HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx Select the Management Mode OnNet in the next formular Now IzoT CT is preparing the network ...

Page 40: ...ceShark_HD PLC_LON_manual_en_V0201 docx Finally you will have this view in Visio Now we need to adapt the channel settings right now IZot CT does not pro vide settings for an HD PLC LON channel Right click on Channel 1 and select Properties ...

Page 41: ...erDoceShark_HD PLC_LON_manual_en_V0201 docx Select Transceiver Type IP 10W which sets similar timing compared with HD PLC LON Now drag a device shape from the LON shapes to the working sheet Check the checkboxes as shown and press Next ...

Page 42: ...eShark HD PLC LON EVK 41 HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx Please select here Upload from Device and press Next No changes are needed here just press again Next ...

Page 43: ...eShark HD PLC LON EVK 42 HD PLC UserDoceShark_HD PLC_LON_manual_en_V0201 docx Select Service Pin option here and press Next In State you need to set Online the press Next ...

Page 44: ...e service pin push button of the first eShark box IzoT CT starts now commissioning the box and after a short time it appears on the working sheet Please repeat the procedure with the second box Now drag a functional block shape on the sheet and tick create for all network variables and repeat this for the second device ...

Page 45: ... drag a Connector on the sheet and connect nvoDigital 0 of one box with nviDigital 0 of the other box This maps the status of the pushbutton on the red LED of the other board Repeat the procedure vice versa for the second box Congratulations now you created your first HD PLC LON system ...

Page 46: ...NTF This macro effects a debug printf on UAR4 on the breakout board It is used like this DPRINTF EPOS AI d d nvIndex value take care on the double parenthesis DUMPBUFFER generates a hexdump of a byte buffer DUMPBUFFER msg value msg length it starts with a text followed by the address of the byte buffer and the length ...

Page 47: ...ent 1 DAC_OUT1 DAC_OUT2 fixed 2 ADC_IN6 ADC_IN7 fixed 3 GND A VCC A 4 PB0 PB1 programmable digital 5 PB2 PB3 programmable digital 6 PB4 PB5 programmable digital 7 PB6 PB7 programmable digital 8 PB8 PB9 programmable digital 9 PB10 PB11 programmable digital 10 GND VCC 11 SWDIO SWCLK ARM Debug 12 GND Reset ARM Debug 13 UART4TX UART4_RX Diagnostics ...

Page 48: ...PLC_LON_manual_en_V0201 docx 8 2 STM32CubeIDE The picture shows the GPIO setting used by the demo application For changes just PB0 PB11 can be changed The other functions are fixed The demo applica tion is using PB0 PB11 as digital inputs and outputs ...

Page 49: ...PA8 Unused PA9 BCP UART USART1_TX PA10 BCP UART USART1_RX PA11 Live LED PA11 PA12 BCP Stack Ready PA12 PA13 y Debug SWDIO PA14 y Debug SWCLK PA15 Unused Pin name PB0 y User flexible PB1 y User flexible PB2 y User flexible PB3 y User flexible PB4 y User flexible PB5 y User flexible PB6 y User flexible PB7 y User flexible PB8 y User flexible PB9 y User flexible PB10 y User flexible PB11 y User flexi...

Reviews:

No comments