MMS-EASE Lite
Reference Manual
Revision 14
© SISCO, Inc. 1994 - 2008
All Rights Reserved
Systems Integration Specialists Company, Inc.
6605 19½ Mile Road, Sterling Heights, MI 48314-1408, USA
Tel: +586-254-0020, Fax: +586-254-0053
E-Mail: [email protected], URL: http:\www.sisconet.com
Printed in U.S.A.
07/2008
DWG#100275/2.4
MMS-EASE Lite
Reference Manual
COPYRIGHT NOTICE
© Copyright 1994 - 2008 Systems Integration Specialists Company Inc.,
All Rights Reserved.
This document is provided under license to authorized licensees only. No part of this document may be
copied or distributed, transmitted, transcribed, stored in a retrieval system, or translated into any human or
computer language, in any form or by any means, electronic, mechanical, magnetic, manual, or otherwise,
disclosed to third parties, except as allowed in the license agreement, without the express written consent
of Systems Integration Specialists Company Incorporated, 6605 19½ Mile Road, Sterling Heights, MI,
48314, U.S.A.
DISCLAIMER
Systems Integration Specialists Company, Inc. makes no representation or warranties with respect to the
contents of this manual and specifically disclaims any implied warranties of merchantability of fitness for
any particular purpose. Further, Systems Integration Specialists Company, Inc. reserves the right to revise
this publication and to make changes in it from time to time without obligation of Systems Integration
Specialists Company, Inc. to notify any person or organization of such revision or changes.
All warranty and support for this product is provided by SISCO.
Revision 14
07/31/08
Table of Contents
i
CHAPTER 1: INTRODUCTION ..............................................................................................................................1
What is MMS-EASE Lite? ........................................................................................................................................1
About This Manual....................................................................................................................................................1
Conventions used in this Manual...............................................................................................................................2
CHAPTER 2: GETTING STARTED........................................................................................................................3
Prerequisites ..............................................................................................................................................................3
Installation.................................................................................................................................................................3
Installing WinPcap Developer’s Pack for OSI Support on Windows....................................................................4
Directory Structure....................................................................................................................................................8
CHAPTER 3: BUILDING MMS-EASE LITE.........................................................................................................9
Development System Preparation..............................................................................................................................9
Conditional Compilation Defines..........................................................................................................................9
glbtypes.h.............................................................................................................................................................13
sysincs.h...............................................................................................................................................................13
align.cfg (Data Alignment Rules)........................................................................................................................14
Unicode porting issues ........................................................................................................................................14
Floating Point Representation.............................................................................................................................16
High Resolution Timers.......................................................................................................................................16
Memory Allocation ..............................................................................................................................................16
Logging Mechanisms...........................................................................................................................................16
Global Variables .................................................................................................................................................17
Creating MMS-EASE Lite Libraries.......................................................................................................................18
Using Expat .........................................................................................................................................................18
Windows Batch Build...........................................................................................................................................21
WIN32 Development Environment......................................................................................................................22
GNU Development Environment.........................................................................................................................24
Building MMS-EASE Lite Step-by-Step ................................................................................................................26
CHAPTER 4: MMS-EASE LITE LOWER LAYERS...........................................................................................29
Profile Options.........................................................................................................................................................29
All MVL Profiles..................................................................................................................................................29
7 Layer OSI over Ethernet...................................................................................................................................30
TCP/IP (via RFC1006)........................................................................................................................................30
Lower Layer Component Portation.........................................................................................................................31
OSI Transport Layer (TP4) Portation.................................................................................................................31
TCP/IP (via RFC1006)........................................................................................................................................33
Subnetwork Layer Portation................................................................................................................................33
Protocol Stack Configuration ..................................................................................................................................34
TCP/IP Configuration .........................................................................................................................................34
OSI Transport Layer (TP4) Configuration..........................................................................................................34
OSI Network Layer (CLNP/ES-IS) Configuration...............................................................................................35
Network Addresses ..............................................................................................................................................36
Protocol Stack Configuration using XML Input File ..........................................................................................37
ACSE Authentication ..............................................................................................................................................38
CHAPTER 5: MVL APPLICATION PROGRAM INTERFACE........................................................................39
MVL Application Build Process .............................................................................................................................40
Code Generation Utility Programs .....................................................................................................................41
Network Profiles..................................................................................................................................................41
Selecting MMS Services Set.................................................................................................................................42
MVL Configuration.................................................................................................................................................42
MVL Connection Management...............................................................................................................................43
MVL Functions....................................................................................................................................................45
Using MVL with MMS Lite ACSE Components....................................................................................................55
Connection Management.....................................................................................................................................55
MMS-EASE Lite Reference Manual
ii
Building mvl_acse ...............................................................................................................................................55
Being a Called Node............................................................................................................................................55
Connection Activity Notifications........................................................................................................................55
Extending the MVL Service Set..............................................................................................................................56
MVL Server: Adding Support for another Service ..............................................................................................56
MVL Client: Adding Support for Another Service...............................................................................................56
MVL Support Functions ......................................................................................................................................57
MVL Dynamic Object Management .......................................................................................................................74
MMS Object Control...............................................................................................................................................91
Configured and Manufactured MMS Server Objects..........................................................................................91
MMS Object Scope ..............................................................................................................................................92
The MVL VMD Control Data Structure ..............................................................................................................93
The MVL Domain Control Data Structure..........................................................................................................94
The MVL AA Control Data Structure..................................................................................................................95
The MVL Named Variable List Data Structure...................................................................................................97
MVL MMS Server Facilities................................................................................................................................98
Synchronous vs. Asynchronous Response - Indication Control ..........................................................................98
MVL Indication Control Structure ......................................................................................................................99
Status Service.......................................................................................................................................................99
Identify Service..................................................................................................................................................103
GetNameList Service .........................................................................................................................................106
GetCapabilityList Service..................................................................................................................................112
Variable Access Overview.................................................................................................................................115
Read Service......................................................................................................................................................119
Write Service......................................................................................................................................................125
Information Report Service ...............................................................................................................................130
GetVariableAccessAttributes Service ................................................................................................................131
DefineNamedVariableList Service.....................................................................................................................135
DeleteNamedVariableList Service.....................................................................................................................138
GetNamedVariableListAttributes ......................................................................................................................143
GetDomainAttributes Service............................................................................................................................147
InitializeJournal Service....................................................................................................................................152
ReadJournal Service..........................................................................................................................................156
ReportJournalStatus Service .............................................................................................................................162
ObtainFile Service.............................................................................................................................................165
FileOpen Service ...............................................................................................................................................170
FileRead Service................................................................................................................................................173
FileClose Service...............................................................................................................................................176
FileDelete Service..............................................................................................................................................179
FileDirectory Service ........................................................................................................................................181
MVL MMS Client Facilities..................................................................................................................................184
General Data Structure .....................................................................................................................................184
Client Support Functions...................................................................................................................................186
Client Request Functions Overview...................................................................................................................187
Variable Access Support Structures ..................................................................................................................187
Read Service......................................................................................................................................................195
Write Service......................................................................................................................................................198
InformationReport Service ................................................................................................................................201
Status Service.....................................................................................................................................................203
Identify Service..................................................................................................................................................205
GetNameList Service .........................................................................................................................................207
FileOpen Service ...............................................................................................................................................209
FileRead Service................................................................................................................................................211
FileClose Service...............................................................................................................................................213
FileDirectory Service ........................................................................................................................................215
FileDelete Service..............................................................................................................................................218
ObtainFile Service.............................................................................................................................................219
FileGet Service ..................................................................................................................................................221
FileRename Service...........................................................................................................................................223
Table of Contents
iii
DefineNamedVariableList Service.....................................................................................................................225
GetVariableAccessAttributes Service ................................................................................................................227
GetNamedVariableListAttributes Service..........................................................................................................229
GetDomainAttributes Service............................................................................................................................231
DeleteNamedVariableList Service.....................................................................................................................233
InitializeJournal Service....................................................................................................................................235
ReadJournal Service..........................................................................................................................................237
ReportJournalStatus Service .............................................................................................................................240
CHAPTER 6: USING THE UCA FEATURES OF MVL ...................................................................................243
Read/Write Indication Functions...........................................................................................................................243
Read Indication Functions.................................................................................................................................243
Write Indication Functions................................................................................................................................246
Dynamic Type Creation for UCA and IEC 61850.............................................................................................246
Array Handling..................................................................................................................................................253
VA Processing Functions and UCA Variables..................................................................................................254
Combining UCA and Non-UCA Variables........................................................................................................254
UCA Buffer Management ..................................................................................................................................254
MVL UCA Report Handling ..............................................................................................................................255
MVL UCA SBO Handling..................................................................................................................................267
MVL_UCA Compilation Options.......................................................................................................................267
CHAPTER 7: USING THE IEC 61850 FEATURES OF MVL..........................................................................269
IEC 61850 Reporting Functions............................................................................................................................269
Sampled Value Support.........................................................................................................................................278
Sampled Value ASDU Data Structure (message contains multiple ASDU) ......................................................278
Sampled Value Message Data Structure ...........................................................................................................278
Functions for sending Sampled Value Messages ..................................................................................................279
Functions for Receiving SMPVAL Messages.......................................................................................................282
CHAPTER 8: CONFIGURING IEC 61850 DEVICES USING SCL.................................................................283
CHAPTER 9: IEC 61850 GOOSE SUPPORT .....................................................................................................291
General GOOSE Information................................................................................................................................291
Subnetwork functions used for IEC 61850 GOOSE Support.............................................................................291
IEC GOOSE ..........................................................................................................................................................292
IEC GOOSE Decode Data Structures...............................................................................................................292
IEC GOOSE Decode Functions ........................................................................................................................293
CHAPTER 10: IEC 61850 GSSE (SAME AS UCA 2.0 GOOSE).......................................................................301
Initialization ......................................................................................................................................................301
Receiving GSSE Messages.................................................................................................................................301
Sending GSSE Messages ...................................................................................................................................302
Porting Issues....................................................................................................................................................302
GSSE Data Structures .......................................................................................................................................303
GSSE Handling Functions.................................................................................................................................305
Alternate GSSE Reception Mode.......................................................................................................................308
Receiving GSSE Messages.................................................................................................................................308
CHAPTER 11: IEC 61850 GSE MANAGEMENT..............................................................................................311
GSE Request Data Structures............................................................................................................................311
GSE Response Structures ..................................................................................................................................311
GSE Management Message Encode Functions.................................................................................................314
CHAPTER 12: MMS OBJECT FOUNDRY.........................................................................................................325
MMS Object Foundry Workflow..........................................................................................................................325
Command Line Parameters....................................................................................................................................326
LAP XML Input File ..........................................................................................................................................326
