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.
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...
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.
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.
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.
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.
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.
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.
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...
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.
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.
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.
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...
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.
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...
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...
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.
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...
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.
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.
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...
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.
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.
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.
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((">>...
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.
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...
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