Advertisement

Quick Links

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: 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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the eShark HD-PLC LON EVK and is the answer not in the manual?

Questions and answers

Summary of Contents for Gesytec eShark HD-PLC LON EVK

  • Page 1 HD-PLC LON 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: info@gesytec.de www.gesytec.com Doc.
  • Page 2 HD-PLC LON EVK 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.
  • Page 3: Table Of Contents

    HD-PLC LON EVK Contents About HD-PLC LON EVK ....................4 Content of the EVK ....................4 Hardware ........................4 Software provided ....................7 party software needed ..................8 PC requirements .....................8 Important Notes .....................9 Basics ..........................10 HD-PLC .......................10 LON ........................11 HD-PLC LON ......................11 IP addressing ......................11 Install Software and Settings ..................13...
  • Page 4 HD-PLC LON EVK 5.1.5 EasyCheck......................24 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 Software Structure ....................30 Structure of the LON application on the STM32F091 ........31 6.2.1...
  • Page 5: About Hd-Plc Lon Evk

    HD-PLC LON EVK About HD-PLC LON EVK 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. Hardware To allow development of HD-PLC LON applications, the EVK consists of this hardware: •...
  • Page 6 HD-PLC LON EVK • 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...
  • Page 7 HD-PLC LON EVK • 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...
  • Page 8: Software Provided

    HD-PLC LON EVK 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.
  • Page 9: Rd Party Software Needed

    HD-PLC LON EVK • Gesyline Manager Using this software allows updating the firmware of the BlueChip and other diagnostics of the HD-PCL network. party software needed For full working with the EVK, some 3 party software is necessary: • STM32CubeIDE The STM32CubeIDE is the preferred solution to define the peripheral pin definition of the STM32F091CB.
  • Page 10: Important Notes

    HD-PLC LON EVK 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.
  • Page 11: Basics

    HD-PLC LON EVK Basics HD-PLC This powerline technology, standardized by IEEE 1901 and ITU G.9905 is a highly efficient Ethernet transmission on a couple of cable types, with or without power. It is using a spread spectrum transmission in the frequency range of 2-28 MHz.
  • Page 12: Lon

    HD-PLC LON EVK LON is a control network defined by ISO/IEC 14908. It can use different transport layers by implementing the identic upper layers of addressing, transac- tion processing and representation of data. This is a unique feature for a control network.
  • Page 13 HD-PLC LON EVK The IP address of the eShark Boxes can be set, using the Gesyline Manager.
  • Page 14: Install Software And Settings

    HD-PLC LON EVK Install Software and Settings IP address for the PC The EVK comes with static addresses in the 192.168.0.x subnet, default address is 192.168.0.249. The Ethernet interface of the PC to be connected with the EVK network needs to be setup to 192.168.0.1 It is recommended to use a dedicated Ethernet interface for the communication with the HD-PLC system to have a clean environment.
  • Page 15 HD-PLC LON EVK Run the “Standard” setup and select “Complete” in the following dialog. 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.
  • Page 16 HD-PLC LON EVK 852 server instance (852Base0) running. If not do right-click on the ‘Easy 852 Service’ and select ‘New 852 server’ in the context menu. New 852 server in- stance will be created. Select the Easy852-0 interface and change the number of VNI and MIP inter- faces to 4.
  • Page 17 HD-PLC LON EVK xxx-VNI3 VNI2 xxx-MIP0 MIP0 xxx-MIP1 MIP1 xxx-MIP2 MIP2 xxx-MIP3 MIP3 Using this logical name prevents us from getting lost in the different applications with the LON driver names. HDPLC will be used for the Easylon HD-PLC gateway software, LNS will be used for Echelon IzoT CT.
  • Page 18: Easylon Hd-Plc Gateway Software

    Easylon OPC Server M Since a long time, Gesytec is having an OPC (OLE for Process Control) Server for LON. Due to the vanishing role of OPC DA in the industry, the software is no longer actively marketed, but still available. It gives easy access to all values...
  • Page 19: Epos Xif Editor Code Generator

    HD-PLC LON EVK of a LON network. The user interface can be used to have an overview on the network, if LonMaker is not available. Please refer to the manual of the Easylon OPC server. The setup is located in HDPLC\EasylonOPC.
  • Page 20: Overview

    HD-PLC LON EVK 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: Setup The Hardware

    HD-PLC LON EVK Setup the hardware It is recommended using a power strip with power switch to turn on and off the whole system easily. First steps Select one device to be the HD-PLC Master. 5.1.1 Easylon HD-PLC Bridge Connect a power cable to the eShark box.
  • Page 22: Gesyline Manager

    HD-PLC LON EVK Lon Stack Error Live LED Service LED Service Pin Push Button 5.1.3 Gesyline Manager Start the Gesyline Manager. Note: The Gesyline Manager MUST be launched with administrators’ rights!
  • Page 23 HD-PLC LON EVK 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...
  • Page 24: Hd-Plc Lon Master Setting

    HD-PLC LON EVK Because we have three devices in the system, three devices will be found. Now the Gesyline manager is operational and may be used to update the firm- ware of a module. Select device or devices and press Firmware update button.
  • Page 25: Easycheck

    HD-PLC LON EVK All terminal eShark boxes receive multicast and send unicast messages to the master. So, they need to know its IP and MAC address. This is the master’s setting: IP address 192.168.0.249, MAC address 00:60:A9:00:35:25. (The MAC address of your devices is different.)
  • Page 26 HD-PLC LON EVK 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...
  • Page 27: Setup For Development

    HD-PLC LON EVK After verification that the communication is working and we are ready to go into detail. 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: Debugger

    HD-PLC LON EVK Pushbutton Connector to eShark Connector to ST-LINK USB UART 5.2.2 Debugger Now connect the ST-LINK/V2 with a ribbon cable, the plug is marked on the silk screen printing of the breakout board. 5.2.3 USB terminal connection Finally connect a USB cable to the USB port of the breakout board.
  • Page 29: Check With Preloaded Application

    HD-PLC LON EVK 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...
  • Page 30: Developing A Lon Application

    HD-PLC LON EVK Developing a LON application In general, the development of a LON application starts with the defining of the network variables (NVs), the device shall implement, and the LonMark objects 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.
  • Page 31: Software Structure

    HD-PLC LON EVK Software Structure This is your „playground“ Fixed and pro- ven software en- vironment...
  • Page 32: Structure Of The Lon Application On The Stm32F091

    HD-PLC LON EVK Structure of the LON application on the STM32F091 You will find the source code in the FTP archive, located in HDPLC/sourcecode/DFA-EPOS. The demo application is using the HAL, provided by ST, which is located in the drv subfolder of the project.
  • Page 33: Using The Xif Editor

    HD-PLC LON EVK EposHostApp.c Here is the state machine of the LON api implemented. Especially it con- tains the setup and merry go round function of the LON api. EposSerialComm.c In this file the interface between the LON api and the serial interface is lo- cated.
  • Page 34 HD-PLC LON EVK Now you are able 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...
  • Page 35: Generate Ansi-C Application Frame Work

    HD-PLC LON EVK The demo application is using arrays for the GPIO related 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.
  • Page 36: Drop In Custom Code

    HD-PLC LON EVK At first select the location of the template files with the xtf extension. Please re- fer to the installation chapter. Afterwards select the output directory, which sould be a good place in your project. The XIFEditor generates now a new EposCustomApp.c and EposCus- tomApp.h.
  • Page 37: Remarks

    HD-PLC LON EVK 6.4.1 Remarks The analog inputs are read using IRQ in DFA_TIM14_IRQHandler(). This is implemented in DFAPeripherals.c. Furthermore the timer handler toggles the green life LED of the eShark box. Because you can’t call EPOS functions in an interrupt service routine, a merry go round function DFA_HW_DoIt() is imple- mented which is called from the main loop.
  • Page 38 HD-PLC LON EVK Microsoft Visio is starting now and will act as graphical user interface for IzoT 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...
  • Page 39 HD-PLC LON EVK Select the Management Mode OnNet in the next formular: Now IzoT CT is preparing the network:...
  • Page 40 HD-PLC LON EVK 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 HD-PLC LON EVK 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 HD-PLC LON EVK Please select here „Upload from Device“ and press Next. No changes are needed here, just press again Next.
  • Page 43 HD-PLC LON EVK Select Service Pin option here and press Next. In State you need to set Online, the press Next.
  • Page 44 HD-PLC LON EVK Press nothing in this dialog! But press the 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.
  • Page 45 HD-PLC LON EVK Finally 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.
  • Page 46: Epos Api For Stm32

    HD-PLC LON EVK EPOS API for STM32 Diagnostics DPRINTF 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((">>...
  • Page 47: Hardware Details

    HD-PLC LON EVK Hardware details Peripherals eShark box header: Row-A Row-B Comment DAC_OUT1 DAC_OUT2 fixed ADC_IN6 ADC_IN7 fixed GND-A VCC-A programmable digital programmable digital programmable digital programmable digital programmable digital PB10 PB11 programmable digital SWDIO SWCLK ARM Debug Reset...
  • Page 48: Stm32Cubeide

    HD-PLC LON EVK 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: Stm32F091 Pin Out

    HD-PLC LON EVK STM32F091 pin out Con- Pin Name nector Usage Debug UART USART4_TX Debug UART USART4_RX Unused Unused User DAC_OUT1 User DAC_OUT2 User ADC_IN6 User ADC_IN7 Unused BCP UART USART1_TX PA10 BCP UART USART1_RX PA11 Live LED PA11...

Table of Contents