IEC 61850 Server/Client Application Demo for TQ - TQ
Contents
1. Calls Update is a Server Function called from the user application indicating a change in the hardware to the IEC 61850 stack Figure 17 PIS 10 API Overview Server Controls PIS 10 API Overview Client Controls IEC61850 Create Starting up the IEC 61850 Stack must be programmed in this sequence IEC61850 Start Basic Exchange 1EC61850 Read IEC61850 Write Operates a control output on the Server My User Update 1EC61850 ControGelect 1EC61850 Controlperate 1061850 Controltancel IEC61850 Stop IEC61850 Free Figure 18 PIS 10 API Overview Client Controls User Manual 1 00 Page 18 of 182. ae eto 17 Figure 1 Table of Figures The IEC 61850 Server Demo SCIeeNn cccccceccccecececccccceccccccececcaeaceceneeaceteceaeacetensavatetsneaesusteceansnenss 8 Fig re 2 Update Analog INPUTS seso 9 FOUE 3 Del Alarm Trhreshol nnsnascas constancias 9 Figure 4 Single Point Control Server creen coooccccccnccccnccncnccncnnonnnnnnnonnnnnnnnnnnnnnnnnnnonnnnnnnnnnnnnnnnnnnennnnonannnnaninnons 10 Figure 5 Indication SWItCN ON SeIVer eise aa a 10 Figure 6 Double Point Control ON Sener rrer a a a a ia 11 Figure 7 Stop Free and Exit ON Serve ccccccccccsecccececeeeeeeeeeseeeseeeseeeseeeeseeeeseeeesaeeesaeessaeesseeesseeesseeesaeeesaaees 11 Figure 8 The IEC 61850 Client Demo Screen ccoocccccccccccnncncnncncnncnnnnnnnnnnnnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnaninnannnnans 12 Figure 9 Read frOM Server coocccccccccccnccncnccnonccncnnnnnnnn nn esse ease EA REAA KEE EO AUER 12 Figure 10 Read Alarm Threshold occoocccocccocnoccncncnononoconocononnnnonnnonanonnnnnnrnnnnnonnnnrnnnrrnnnnnonannrnnnrnrnrnnenaninans 13 Figure 11 Indications Client side oocooocccnnccocncocncoconocnnonnconncnnconnrnnnnncnnnnnnrnnnrnnnnnnnnnnrnrrrnrnrnnnnnnnrrnrnrnrnrnnnnnanenass 13 Figure 12 Client Control Single Point Control ccoocnccocnccccnccocnconncnconononnnonononnnnnnnnonnnnnonnnnnnnnnnnnnnnnnnnonaninnnos 13 Figure 13 Client Control Double Point Control ooccccocnccocnccccnnccnononnnnonnnnnonon
3. 2 will be displayed to the right of the button for ReadAnIn2 This function is explained in code under pshbtnReadAnIn1 Handler pshbtnReadAnIn2Handler Read Read Anin1 Anin2 Figure 9 Read from Server User Manual 1 00 Page 12 of 18 IEC 61850 Server Client Application l Demo for TQ Systems GmbH IEC 61850 Demo Server Client STKA28 Development Kit Application Functionality 3 2 2 Read Alarm Threshold This section is designed to demonstrate the functionality of the IEC61850_Read function This function will read the value in the stack which corresponds to the Alarm Threshold value on the Server side Clicking the button ReadAlarmThreshold will initiate this read function and the value set under AlarmThreshold on the server will be displayed to the right of the button The LED shown below will flash orange automatically if an Alarm has been triggered and a GOOSE message received le if either Analog Input 1 or 2 values are greater than the Alarm Threshold Value This function is explained in code under pbAlrmHandler Read Alarm m AlarmThreshold LED Figure 10 Read Alarm Threshold 3 2 3 Indications Client Side The LED s 1 4 correspond to the DIP switches on the server side If the DIP switch on the server side are operated this updates the corresponding value in the stack using the IEC61850 Update function by the server A report is generated The client is subscribed to these reports and it will update the LED stat
4. 3 Set Alarm Threshold User Manual 1 00 Page 9 of 18 IEC 61850 Server Client Application i Demo for TQ Systems GmbH IEC 61850 Demo Server Client STKA28 Development Kit Application Functionality 3 1 3 Single Point Control on Server SPCO This section demonstrates the functionality of the IEC61850_ControlOperation function used by the IEC 61850 Client These 4 LED s are controlled directly by the IEC 61850 Client Demo They will light up green if they receive a operate message from the Client which in turn will call the OperateCallback function on the server side refer to PIS 10 API user manual for more details The client side is explained in section 3 2 4 This function is explained further in the commented source code under the section LedController LED1 LED2 LED3 LED4 Figure 4 Single Point Control Server Screen 3 1 4 Indications Server Side This section demonstrates the functionality of the IEC61850_ Update function on the IEC 61850 Server By clicking on one of these DIP switches will update the corresponding value in the stack and a report will be triggered with updated status information This will be read on the client side Indications and is explained in section 3 2 3 By clicking on a DIP switch the color or the LED on the switch button will change to green to show that it has been clicked This function is explained further in the commented source code under the section pbDipSw1 Handler pbDipSw2Handler pbDipSw
5. 3Handler pbDipSw4Handler and OperateCallbackHandler DIP SW1 DIP SW2 DIP SW3 DIP SW4 Figure 5 Indication switch on Server 3 1 5 Double Point Control This section demonstrates the functionality of the IEC61850 ControlOperation function used by the IEC 61850 Client You cannot make changes on the Server side as it only indicates the status which is controlled by the Client A client will send an Operate Request to control the switch DCP On the Server side they will receive an OperateCallback The server application will operate the switch and update the status in the stack using the IEC61850 Update function This will trigger a report and a GOOSE message In this example it is showing the status position of a Circuit Breaker XCBR and Earth Switch CSWI The position is also shown by the picture Table 1 shows the meaning of the position This function is explained further in the commented source code under the section XcbrCswController and OperateCallbackHandler User Manual 1 00 Page 10 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit IEC 61850 Demo Server Client Application Functionality Table 1 XCBR CSWI positon meaning XCBR CSWI position Explanation Intr Intermediate state XCBR Pos Intr 4 OFF On Bad CSWI Pos Intr t OFF On Bad Figure 6 Double Point Control on Server 3 1 6 Stop Free and Exit This section is designed to demon
6. Application Functionality The Application Demo consists of both a Server and Client Screen for development and testing purposes The functionality and interaction between the Server and Client is documented in this section The demonstration has been designed to show how the functionality of SystemCORP s PIS 10 IEC 61850 stack can be implemented 3 1 The Server Screen To explain the functionality of the Server Screen the screen has been divided into 6 sections which can be explained individually K y SystemCORP Froo IEC 61850 Client Server Demonstration 1EC61850 Server Demo XCBR Pos Intr Off Update 0 Update 0 On Anin1 Anin2 Bad CSWI Pos Intr l Alarm Alarm off Threshold 0 LED On Bad LED1 LED2 LED3 LED4 WO 2 e B DIP SW1 DIP SW2 DIP SW3 DIP SW4 Exit Figure 1 The IEC 61850 Server Demo Screen User Manual 1 00 Page 8 of 18 IEC 61850 Server Client Application l Demo for TQ Systems GmbH IEC 61850 Demo Server Client STKA28 Development Kit Application Functionality 3 1 1 Update Analog Inputs This section demonstrates the functionality of the IEC61850_Update function The value can be varied up and down using the arrow up and down to the right of the value To set the value click on the Update button to the left of the value This input will update the corresponding value in the stack On the client side this value is read using IEC61850_Read function Refer to Read from Server Section under the C
7. PL Purpose MO 1EC61850_ControlSelect Indicate intention to perform Operate on identified control MI 1EC61850_ControlOperate Perform Operate function on selected control s with specified value ME 1EC61850_ControlCancel Cancel existing selection of controls User Manual 1 00 Page 16 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit 4 1 4 IEC 61850 PIS 10 API Overview PI5S 10 API Overview Server IEC61850 Create Changes a value ON the Server Starting up the IEC i 61850 Stack must be programmed inthis sequence IEC61850 Start Basic Exchange I Client My User Write EREINA Write IEC61850_ Update S Client My User Read New 7 _ Read 7 Sl Call Backs IEC61850 Stop Requests a value FROM the Server Update isa Server Function called from the user application indicating a change inthe hardware to the IEC 61850 stack IEC61850 Free Server Calls Figure 16 PIS 10 API Overview Server User Manual 1 00 Appendix Page 17 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH Appendix STKA28 Development Kit PIS 10 API Overview Server Controls IEC61850 Create Starting up the IEC CS LESO_LoadstL hie 61850 Stack must be programmed in this IEC61850 Start SEQUENCE lEC61850_ Update My User Control My User Cancel Call Backz IEC61850 Stop IEC61850 Free Server
8. SystemC ORP Embedded Technology Pty Ltd IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit User Manual This PDF Document contains internal hyperlinks for ease of navigation For example click on any item listed in the Table of Contents to go to that page IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit Copyright All rights reserved None of the information contained in this document may be reproduced or stored in a database or retrieval system or disclosed to others without written authorization by SystemCORP Embedded Technology Pty Ltd The information in this document is subject to change without prior notice and should not be construed as a commitment by SystemCORP Embedded Technology Pty Ltd SystemCORP Embedded Technology Pty Ltd do not assume responsibility for any errors which may be in this document Documentation Control Author Brigid Reilly Version 1 00 Version History 1 00 Initial release Creation Date 22 November 2013 Last Version Date 22 November 2013 Product Reference 500 0041 Document Status RELEASED User Manual 1 00 Page 2 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit Table of Contents 1 MOGUC IO esa EA AEA EEE E sumeeeoeacsedest 5 2 MEE A E EA E O 6 2 1 Whats VOU SGA intos Deno ac ac wc EEEE EEE EE 6 2 2 MIIMUN T egur MOMS eioen
9. ennie a E EENE EEA E E SENEN 6 2 3 Instala ton inSUTUCIONS eee ee eee Nl E E E O AT hn han ha hd E 6 2 4 Development Guidelines coi esata sidstienalasaieantoanna EEEE EEEE ESERI EEE NEEESE EEEREN 7 3 IEC 61850 Demo Server Client Application Functionality occococcccocncconncconnnnonnnss 8 3 1 The Senor oO ON aeee a elect cee oe 8 0 MU o A ocean ce aetna ate etn ade a 9 32 DELANTE aaa Dec 9 3 1 3 Single Point Control on Server SPCO zerena a a a 10 gA NAC AMOS Sewer oldo aa a ee le deal lll ele ated nde ate intel leeds 10 3125 DOUBIE POINT CONTO saccade a edad 10 So Op Fe a cs 11 3 2 Mie e 1o1 AAA AA eee cme EE mee ott eee ae ee ene tae 12 gt Radon eee treet tees cel cosh nracandct cae cau Sexe aaah Powutcywrtieatnictasaten actions 12 322 Read Alam aU SION tia 13 3 2 3 Indications CEA SIde ee titi 13 3 2 4 Client Control Single Control POiNt occooccnccccnccccnccccnccnnncnonononnnnnnnnonnnnnnnnnnnnnnnnncnnnnnnnnncnnnanoss 13 3 2 5 Client Gontrol Double Point CODIO l srest cc decido le 14 32 5 1 AWarninQ Message iii bailarina alar ade 14 o 9 AES E md eee ere en aE enn en ee re eee eee eee er eee rere nie te 15 A APPO anna lo 16 4 1 1 PIS 10 Object Management FUNCTIONS cccocccccccncccnnccncnnnnnocnononnnnnonnnonnnnonnnnonnnnonnnnnnnnnonannnnannnnas 16 41 2 PIS 10 Data Attributes ACCESS FUNCTIONS iia aa 16 AS PIS TO GONT FUNCION S L ide dn ade Mu uinddenc E 16 Ad WEG 61650 PIS TO Al OV CIV We a eae aac
10. lient Demo U miu hal XCBR SW Anin1 Qtclient o i CSWI is switched ON y Switch CSWI OFF l dl CSWI SW Read AlarmThreshold y LED1 LED2 LED3 LED4 W E E E W DIP SW1 WDIPSW2 WDIPSW3 WODIPSW4 Exit Figure 15 Warning Message Confirm Action CSWI 3 2 6 Stop Free Exit See section 3 1 6 User Manual 1 00 Page 15 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH Appendix STKA28 Development Kit 4 Appendix This Appendix contains PIS 10 API for quick reference For further information and details please refer to the Online API 4 1 1 PIS 10 Object Management Functions Table 2 PIS 10 Object Management Functions API SC Purpose IEC61850_Create API to create a client or server object with call backs for reading writing and updating data objects IEC61850_LoadSCLFile API to read the SCL XML file to get the configuration of server or client IEC61850_ Star API to start the server or client IEC61850_ Stop API to stop the server or client IEC61850_ Free API to delete a client or server object created 4 1 2 PIS 10 Data Attributes Access Functions Table 3 PIS 10 Data Attributes Access Functions E Purpose S IEC61850_Read Read the value of a specified data attribute IEC61850 Write Write the value to a specified data attribute a IEC61850_ Update Update the value of a specified data attribute 4 1 3 PIS 10 Control Functions Table 4 PIS 10 Control Functions p No A
11. lient Screen explained in 3 2 1 This function is explained further in the commented source code under the section pshbtnUpdateAnIn1 Handler and pshbinUpdateAnin2Handler Update 0 Update 0 Anin1 Anin2 Figure 2 Update Analog Inputs 3 1 2 Set Alarm Threshold This section demonstrates the functionality of the IEC61850_ Update function To set the Alarm Threshold value it can be varied up and down using the arrow up and down to the right of the value To set the value click on AlarmThreshold button to the left of the value This input will update the corresponding value in the stack On the client side this value is read using IEC61850_Read function Refer to Read Alarm Threshold Section under the Client Screen explained in 3 2 2 The Alarm Threshold is relating to the Analog Inputs in section 0 If either of the Analog Inputs are set to a value greater than the Alarm Threshold then an Alarm message will be sent to the Client via GOOSE Also the alarm LED to the right of the Alarm Threshold will flash orange on both Client and Server For Example if Analog Input 1 has a value of 7 and Analog Input 2 has a value of 8 and the Alarm Threshold is set to a value of 6 then an Alarm will be triggered and GOOSE message will be sent The Alarm LED will flash Orange on both the Server and the Client Screen This function is explained further in the commented source code under the section MaxAlarmHandler Alarm 0 Alarm Threshold LED Figure
12. n The STKA28 Development Kit contains both hardware and software components required for a basic development This document will introduce you to the basics of the standard IEC 61850 and using the STKA28 This Manual gets you started with creating an IEC 61850 application with your STKA28 This document is intended for those with a basic to intermediate knowledge of IEC 61850 The Demo shows the implementation of SystemCORP 61850 PIS 10 stack on TQ Systems GmbH STKA28 and how to integrate this with your application This manual will outline how to get started with IEC 61850 Server Client Application Demo This Demo has been created for developer s who wish to start writing IEC 61850 applications to run on TQ Systems GmbH STKA28 Further information on IEC 61850 standards can be found in the Appendix User Manual 1 00 Page 5 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH Installation Guide STKA28 Development Kit 2 Installation Guide Basic Definitions PC refers to host Linux PC PC Blue Power 28 refers to the touch screen STKA28 Starter kit Qtcreator is a common developer s tool 2 1 What is included in this Demo Demo package includes e A Qt application executable which can be run on the Host Linux PC which is based on Ubuntu11 10 QtServerDemoPc QtClientDemoPc e A Qt application executable which can be run on the PC Blue Power 28 which has been compiled using PTXdist toolchain QtServerDemoT q QtClie
13. ntDemoTq e Scripts for running Demo on PC Blue Power 28 run QtServer and run QtClient e Server Client CID files e Qt Source code for Server and Client 2 2 Minimum requirements Host Machine e Ubuntu 11 10 e Qt Creator 2 2 1 e Qt4 7 e PTXdist toolchain for TQMaz28 platform PC Blue Power 28 e Full file system with Qt provided by TQ Systems GmbH 2 3 Installation Instructions 1 Extract QtServerDemoTq tar on Host PC tar xvf lt Demo File Name gt tar 2 Extract QtServerClientTq tar on Host PC tar xvf lt Demo File Name gt tar 3 Extract QtServerDemoPC tar on Host PC tar xvf lt Demo File Name gt tar 4 Extract QtServerClientPC tar on Host PC tar xvf lt Demo File Name gt tar 5 Both Server and Client can run on either the Host PC or the Blue PC Based on test develop requirements modify QtServer Cid and QtClient Cid The following information can be obtained using ifconfig command a Change the IP address to Match the IP address of the PC Blue Power 28 Host PC b Change the IP SUBNET to match the Subnet of PC Blue Power 28 Host PC c Change the IP GATEWAY to match Gateway of PC Blue Power 28 Host PC d Change the MAC Address to match MacAddress of PC Blue Power 28 Host PC 6 Copy PIS10 License key PIS10 key into demo folders for PC Blue Power 28 and for Host PC if used 7 Copy the demo which you want to run on the PC Blue Power 28 on to a SD Card Single Partition 8 Pl
14. oned this operation then a report and GOOSE message is generated by the stack with contains the updated status information The LED in the button will change colour once it has been clicked This function is explained in code under pbXcbrHandler and pbCswiHandler my XCBR SW CSWI SW Y Figure 13 Client Control Double Point Control 3 2 5 1 Warning Message Performing an action on an Circuit Breaker and Earth Switch will effect serious implications on the network as it may energise or de energise the network In the event that a switch might be clicked accidently there is another window which will pop up to make sure that the Operator wishes to perform that action The operator will then click Ok to process or x to cancel the operation This function is explained within the in code under pbXcbrHandler and pbCswiHandler K y SystemCORP Foiro IEC 61850 Client Server Demonstration Technology 1EC61850 Client Demo a XCBR SW Anin1 Qrclient XCB is switched ON y Switch XCBR OFF al CSWISW AlarmThreshold LED1 LED2 LED3 LED4 wW E E E DIP SW1 DIP SW2 w DIP SW3 w DIP SW4 Exit Figure 14 Warning Message Confirm Action XCBR User Manual 1 00 Page 14 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit IEC 61850 Demo Server Client Application Functionality SystemCORP roinoioay IEC 61850 Client Server Demonstration 1EC61850 C
15. onnnonononnnnnnnnnnnnnnnnnnnnnnaninnanennnos 14 Figure 14 Warning Message Confirm Action XCBR c ccccccecccseeeeseeeeeeeeaeeeeseeeeeeeeeseeesseeeeseeeesaeesseeeeseeeeaaees 14 Figure 15 Warning Message Confirm Action CSW c cccccsecccseeeeseeeeseeeeaeeeeseeeeaeeeeseeesseeeeseeesaeesseeesaeeessaees 15 Figure 16 PIS 10 API Overview S rvel cccccceccccsececeeceseeeeseeeeeeeeeseeeeseeeeseeeeseeeeseeeesaeeesaeessaeessaeesseesseeessaeesaaees 17 Figure 17 PIS 10 API Overview Server Controls ccccccceececececeeeeeeeeeseeeeaeeeeseeeeeeeeeseeesseeesseeesseesseeeeseeeesaees 18 Figure 18 PIS 10 API Overview Client CONTTOlS cooocccocncocncconocococononnconnconnnnonnnonnronncnnnnnonnnonnronnronnnnonanenass 18 User Manual 1 00 Page 3 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit List of Tables Table XGBR6SWIpPOStonmeaINdadidadnlalecalucadaonidacidacidacadana dana lan cinasiaaiandanadona dada 11 Table 2 PIS 10 Object Management FUNC ONS coocccocncocnconnccnnnconcconnoncnonononononnnonnnnnnnnonnnonnnnnanonnnnnnnnnnnnnnninaso 16 Table 3 PIS 10 Data Attributes Access FUNCTIONS ccc ccccceccccececccccececcceucaceueuceneueeneueeneaceneateneaeeneanentaneneass 16 Table 4 PIS 10 Control Functions User Manual 1 00 Page 4 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH Introduction STKA28 Development Kit 1 Introductio
16. strate the functionality of the IEC61850_ Stop and the IEC61850 Free functions It also functions as an Exit function to close the Demo application When the button is pressed it operates the function IEC61850_ Stop function followed by the IEC61850_Free function It will then exit the Server Demo This function is explained in code under pshbtnCloseHandler Figure 7 Stop Free and Exit on Server User Manual 1 00 Page 11 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH STKA28 Development Kit IEC 61850 Demo Server Client Application Functionality 3 2 The Client Screen To explain the functionality of the Client Screen the screen has been divided into 6 sections which can be explained individually K y SystemCORP Trove IEC 61850 Client Server Demonstration 1EC61850 Client Demo Read Read Anin1 Anin2 Read Alarm ff AlarmThreshold LED LED1 LED2 LED3 LED4 2 ff e DIP SW1 DIP SW2 al DIP SW3 w DIP SW4 Figure 8 The IEC 61850 Client Demo Screen 3 2 1 Read from Server This section is designed to demonstrate the functionality of the IEC61850_ Read function This function will read the value in the stack which corresponds to Analog Input 1 and 2 on the Server Clicking the button ReadAnIn1 will initiate this read function and the value set under Analog Input 1 will be displayed to the right of the button Similarly by clicking the button ReadAnIn2 the value set under Analog Input
17. ug the SD Card into the PC Blue Power 28 9 Connect to the PC Blue Power 28 using telnet or COM Port 10 Create a directory root sdcard on the PC Blue Power 28 11 Mount the SD Card using mount dev mmcblk1p1 sdcard To run the demo on the PC Blue go to the demo folder which you want to run and then run a script called run QtServer or run QtClient Note Run the server first before running the client 12 To run the demo on the Host PC then run as administrator by typing sudo QtServer or sudo QtClient Note Run the server first before running the client User Manual 1 00 Page 6 of 18 IEC 61850 Server Client Application Demo for TQ Systems GmbH Installation Guide STKA28 Development Kit PIS10 key contains the license key and should be obtained from TQ Systems GmbH upon purchase for the PC Blue Power 28 and to puchase a HostPC PIS10 key please contact info systemcorp com au 2 4 Development Guidelines For developing an Application which requires graphic user Interface use Qt creater Qt and PT Xdist toolchain to compile the source code For developing command Line application then only PT Xdist toolchain is required and Qt Creator and Qt is not required Please refer to SystemCORP S PIS 10 online API documentation User Manual 1 00 Page 7 of 18 IEC 61850 Server Client Application IEC 61850 Demo Server Client db es Application Functionality STKA28 Development Kit 3 IEC 61850 Demo Server Client
18. us Once the report is received by the client side an update callback ptUpdateCallback function is called by the stack This function is explained in code under LedController LED1 LED2 LEDS LED4 E E Figure 11 Indications Client side 3 2 4 Client Control Single Control Point This section demonstrates the functionality of the IEC61850_ControlOperate function By clicking on one of the buttons DIP SW 1 4 the client will send an operate message to the Server which will change the status of the LED s on the server refer to 3 1 3 Once the server has actioned this operation then a report is generated by the stack with contains the updated status information The LED in the button will change to green once it has been clicked This function is explained in code under pbDipSw1 Handler pbDipSw2Handler pbDipSw3Handler pbDipSw4Handler DIP SW1 DIP SW2 DIP SW3 DIP SW4 Figure 12 Client Control Single Point Control User Manual 1 00 Page 13 of 18 IEC 61850 Server Client Application IEC 61850 Demo Server Client o IA o i Application Functionality STKA28 Development Kit 3 2 5 Client Control Double Point Control This section demonstrates the functionality of the IEC61850_ControlOperate function By clicking on one of the buttons XCBR or CSWI switches the client will send an operate message to the Server The server will action this operate function and change the status in the stack accordingly Once the server has acti
Download Pdf Manuals
Related Search