IEC 62769-100:2023
(Main)Field device integration (FDI®) - Part 100: Profiles - Generic protocols
Field device integration (FDI®) - Part 100: Profiles - Generic protocols
IEC 62769-100:2023 specifies an FDI®[1] profile of IEC 62769 for Generic Protocols. That means that all interfaces are defined and a host can add support for more protocols without changing its implementation. Nevertheless, there are some protocol specific definitions (PSD) that need to be specified per protocol using this profile. Annex C specifies what PSD need to be defined per protocol so that FDI® Device Packages, FDI® Communication Packages for Gateways and FDI® Communication Servers, FDI® Communication Server, Gateways and Devices supporting such a protocol can work together in a host not aware about this specific protocol.
Intégration des appareils de terrain (FDI®) - Partie 100: Profils - Protocoles génériques
L'IEC 62769-100:2023 spécifie un profil FDI®[1] de l'IEC 62769 pour les Protocoles Génériques. Cela signifie que toutes les interfaces sont définies, et qu'un hôte peut ajouter une prise en charge pour davantage de protocoles sans modifier la mise en œuvre. Néanmoins, certaines définitions spécifiques au protocole (PSD) nécessitent d'être spécifiées à l'aide de ce profil. L'Annexe C spécifie les PSD qu'il est nécessaire de définir par protocole, de sorte que les Paquetages d'Appareils FDI®, les Paquetages de Communication FDI® pour les Passerelles et les Serveurs de Communication FDI®, le Serveur de Communication FDI®, les Passerelles et les Appareils qui prennent en charge ce type de protocole puissent fonctionner ensemble dans un hôte, quel que soit ce protocole spécifique.
General Information
Relations
Standards Content (Sample)
IEC 62769-100 ®
Edition 2.0 2023-04
REDLINE VERSION
INTERNATIONAL
STANDARD
colour
inside
Field device integration (FDI®) –
Part 100: Profiles – Generic Protocols
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC
copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or
your local IEC member National Committee for further information.
IEC Secretariat Tel.: +41 22 919 02 11
3, rue de Varembé info@iec.ch
CH-1211 Geneva 20 www.iec.ch
Switzerland
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.
About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigendum or an amendment might have been published.
IEC publications search - webstore.iec.ch/advsearchform IEC Products & Services Portal - products.iec.ch
The advanced search enables to find IEC publications by a Discover our powerful search engine and read freely all the
variety of criteria (reference number, text, technical publications previews. With a subscription you will always have
committee, …). It also gives information on projects, replaced access to up to date content tailored to your needs.
and withdrawn publications.
Electropedia - www.electropedia.org
IEC Just Published - webstore.iec.ch/justpublished
The world's leading online dictionary on electrotechnology,
Stay up to date on all new IEC publications. Just Published
containing more than 22 300 terminological entries in English
details all new publications released. Available online and once
and French, with equivalent terms in 19 additional languages.
a month by email.
Also known as the International Electrotechnical Vocabulary
(IEV) online.
IEC Customer Service Centre - webstore.iec.ch/csc
If you wish to give us your feedback on this publication or need
further assistance, please contact the Customer Service
Centre: sales@iec.ch.
IEC 62769-100 ®
Edition 2.0 2023-04
REDLINE VERSION
INTERNATIONAL
STANDARD
colour
inside
Field device integration (FDI®) –
Part 100: Profiles – Generic Protocols
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
ICS 25.040.40; 35.100.05 ISBN 978-2-8322-6845-2
– 2 – IEC 62769-100:2023 RLV © IEC 2023
CONTENTS
FOREWORD . 5
1 Scope . 7
2 Normative references . 7
3 Terms, definitions, abbreviated terms and conventions acronyms . 8
3.1 Terms and definitions . 8
3.2 Abbreviated terms and acronyms . 8
4 Conventions . 8
4.1 EDDL syntax . 8
4.2 XML syntax . 8
4.3 Capitalizations . 8
5 Profile for Generic Protocols . 9
5.1 General . 9
5.2 Catalog profile . 9
5.2.1 Protocol support file . 9
5.2.2 CommunicationProfile definition . 10
5.2.3 Profile device . 10
5.2.4 Protocol version information . 10
5.3 Associating a Package with a device . 10
5.3.1 Device type identification mapping . 10
5.3.2 Device type revision mapping . 12
5.4 Information Model mapping . 12
5.4.1 ProtocolType definition . 12
5.4.2 DeviceType mapping . 12
5.4.3 FunctionalGroup identification definition . 13
5.5 Topology elements . 13
5.5.1 ConnectionPoint definition . 13
5.5.2 Communication Device definition . 14
5.5.3 Communication service provider definition . 15
5.5.4 Network definition . 16
5.6 Methods . 16 ®
5.6.1 Methods for FDI Communication Servers . 16
5.6.2 Methods for Gateways . 20
4.6.3 Transfer service parameters .
Annex A (normative) Topology scan result schema . 29
A.1 General . 29
A.2 Network . 29
A.3 GenericNetworkT . 29
A.4 GenericConnectionPointT . 30
A.5 GenericIdentificationT . 30
A.6 GenericAddressT . 31
A.7 GenericIdentificationExtendedT . 31
Annex B (normative) Transfer service parameters . 32
B.1 General . 32
B.2 sendData . 32
B.3 receiveData . 32
B.4 TransferSendDataT . 32
B.5 EddDataTypeInfoListT . 33
B.6 EddDataTypeInfoT . 33
B.7 EddDataTypeT . 34
B.8 TransferResultDataT . 35
Annex C (normative) Protocol specific definitions . 36
C.1 General . 36
C.2 Header . 36
C.3 ProtocolIdentifier . 36
C.4 Address . 36
C.5 Manufacturer . 37
C.6 DeviceModel . 37
C.7 DeviceRevision . 37
C.8 SerialNumber . 37
C.9 Tag . 37
C.10 ProfileId . 38
C.11 Version . 38
C.12 ProtocolSupportFile . 38
C.13 ExtendedDeviceRevision . 38
Bibliography . 39
®
Table 1 – ProtocolSupportFile for FDI Device Packages . 10
Table 2 – Catalog values for profile devices . 10
Table 3 – Device identification information mapping . 11
Table 4 – Device revision information mapping . 12
Table 5 – Protocol type GenericProtocol . 12
Table 6 – Inherited DeviceType property mapping . 12
Table 7 – Generic Protocol Device Types identification attributes . 13
Table 8 – ConnectionPoint type for Generic Protocols . 13
Table 9 – Method Connect arguments . 17
Table 10 – Method Disconnect arguments . 17
Table 11 – Method Transfer arguments . 18
Table 12 – EddDataTypeInfo DataType Structure . 19
Table 13 – EddDataTypeEnum Values . 19
Table 14 – Method SetAddress arguments . 20
Table 15 – Connect service arguments . 22
Table 16 – Method Transfer arguments . 24
Table 17 – Method SetAddress arguments . 27
Table A.1 – Elements of GenericNetworkT . 29
Table A.2 – Attributes of GenericConnectionPointT . 30
Table A.3 – Elements of GenericConnectionPointT . 30
Table A.4 – Attributes of GenericIdentificationT . 31
Table A.5 – Attributes of GenericIdentificationExtendedT . 31
Table B.1 – Attributes of TransferSendDataT . 33
Table B.2 – Elements of TransferSendDataT . 33
Table B.3 – Elements of EddDataTypeInfoListT . 33
– 4 – IEC 62769-100:2023 RLV © IEC 2023
Table B.4 – Attributes of EddDataTypeInfoT . 34
Table B.5 – Enumerations of EddDataTypeT . 35
Table B.6 – Attributes of TransferResultDataT . 35
INTERNATIONAL ELECTROTECHNICAL COMMISSION
____________ ®
FIELD DEVICE INTEGRATION (FDI ) –
Part 100: Profiles – Generic Protocols
FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote international
co-operation on all questions concerning standardization in the electrical and electronic fields. To this end and
in addition to other activities, IEC publishes International Standards, Technical Specifications, Technical Reports,
Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC Publication(s)”). Their
preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with
may participate in this preparatory work. International, governmental and non-governmental organizations liaising
with the IEC also participate in this preparation. IEC collaborates closely with the International Organization for
Standardization (ISO) in accordance with conditions determined by agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence between
any IEC Publication and the corresponding national or regional publication shall be clearly indicated in the latter.
5) IEC itself does not provide any attestation of conformity. Independent certification bodies provide conformity
assessment services and, in some areas, access to IEC marks of conformity. IEC is not responsible for any
services carried out by independent certification bodies.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of patent
rights. IEC shall not be held responsible for identifying any or all such patent rights.
This redline version of the official IEC Standard allows the user to identify the changes
made to the previous edition IEC 62769-100:2020. A vertical bar appears in the margin
wherever a change has been made. Additions are in green text, deletions are in
strikethrough red text.
– 6 – IEC 62769-100:2023 RLV © IEC 2023
IEC 62769-100 has been prepared by subcommittee 65E: Devices and integration in enterprise
systems, of IEC technical committee 65: Industrial-process measurement, control and
automation. It is an International Standard.
This second edition cancels and replaces the first edition published in 2020. This edition
constitutes a technical revision.
This edition includes the following significant technical changes with respect to the previous
edition: ®
Version scheme and the method
a) added ExtendedDeviceRevision implementing the FDI
ScanExtended.
The text of this International Standard is based on the following documents:
Draft Report on voting
65E/865/CDV 65E/922/RVC
Full information on the voting for its approval can be found in the report on voting indicated in
the above table.
The language used for the development of this International Standard is English.
This document was drafted in accordance with ISO/IEC Directives, Part 2, and developed in
accordance with ISO/IEC Directives, Part 1 and ISO/IEC Directives, IEC Supplement, available
at www.iec.ch/members_experts/refdocs. The main document types developed by IEC are
described in greater detail at www.iec.ch/standardsdev/publications.
A list of all parts in the IEC 62769 series, published under the general title Field device ®
integration (FDI ), can be found on the IEC website.
The committee has decided that the contents of this document will remain unchanged until the
stability date indicated on the IEC website under "http://webstore.iec.ch" in the data related to
the specific document. At this date, the document will be
• reconfirmed,
• withdrawn,
• replaced by a revised edition, or
• amended.
IMPORTANT – The "colour inside" logo on the cover page of this document indicates that it
contains colours which are considered to be useful for the correct understanding of its
contents. Users should therefore print this document using a colour printer.
®
FIELD DEVICE INTEGRATION (FDI ) –
Part 100: Profiles – Generic Protocols
1 Scope
®1
This part of IEC 62769 specifies an FDI profile of IEC 62769 for Generic Protocols. That
means that all interfaces are defined and a host can add support for more protocols without
changing its implementation. Nevertheless, there are some protocol specific definitions (PSD)
that need to be specified per protocol using this profile. Annex C specifies what PSD need to
® ®
be defined per protocol so that FDI Device Packages, FDI Communication Packages for
® ®
Gateways and FDI Communication Servers, FDI Communication Server, Gateways and
Devices supporting such a protocol can work together in a host not aware about this specific
protocol. ®
NOTE A host not using FDI Communication Server but a proprietary mechanism for communication defines needs
to define its own means to deal with this profile to support several protocols without changing its implementation.
This is specific to the proprietary way how the communication driver is bound to the host.
2 Normative references
The following documents are referred to in the text in such a way that some or all of their content
constitutes requirements of this document. For dated references, only the edition cited applies.
For undated references, the latest edition of the referenced document (including any
amendments) applies.
IEC 61804 (all parts), Devices and integration in enterprise systems − Function blocks (FB) for
process control and Electronic Device Description Language (EDDL)
IEC 61804-3, Devices and integration in enterprise systems − Function blocks (FB) for process
control and electronic device description language (EDDL) − Part 3: EDDL syntax and
semantics
IEC 62541-100:2015, OPC Unified Architecture – Part 100: OPC UA for Devices Device
Interface ®
) – Part 1: Overview
IEC 62769-1, Field Device Integration (FDI ®
IEC 62769-2, Field Device Integration (FDI ) – Part 2: FDI Client ®
IEC 62769-3, Field Device Integration (FDI ) – Part 3: Server
® ®
IEC 62769-4, Field Device Integration (FDI ) – Part 4: FDI Packages
® ®
IEC 62769-5, Field Device Integration (FDI ) – Part 5: FDI Information Model
___________
1 ®
FDI is a registered trademark of the non-profit organization Fieldbus Foundation, Inc. This information is given
for the convenience of users of this document and does not constitute an endorsement by IEC of the trademark
holder or any of its products. Compliance does not require use of the trade name. Use of the trade name requires
permission of the trade name holder.
– 8 – IEC 62769-100:2023 RLV © IEC 2023 ®
IEC 62769-7, Field Device Integration (FDI ) – Part 7: FDI Communication Devices ®
IEC 62769-151-1, Field Device Integration (FDI ) – Part 151-1: Profiles – OPC UA
3 Terms, definitions, abbreviated terms and conventions acronyms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in IEC 61804 series,
IEC 62541-100, IEC 62769-2, IEC 62769-3, IEC 62769-4, IEC 62769-5, and IEC 62769-7
apply.
ISO and IEC maintain terminology databases for use in standardization at the following
addresses:
• IEC Electropedia: available at https://www.electropedia.org/
• ISO Online browsing platform: available at https://www.iso.org/obp
3.2 Abbreviated terms and acronyms
EDD Electronic Device Description
EDDL Electronic Device Description Language (see IEC 61804 series)
® 2
FDI™ Field Device Integration™
FCG FieldComm Group
PSD Protocol-specific definitions
XML Extensible markup language (see FCG TS62769-100, Edition 1.1, Field Device
Integration Part 100: Profiles – Generic Protocols, available at
https://fieldcommgroup.org) REC-xml-20081126)
4 Conventions
4.1 EDDL syntax ®
This part of IEC 62769 specifies content for the EDD component that is part of FDI
Communication Packages. The specification content using EDDL syntax uses the font Courier
New. The EDDL syntax is used for method signature, variable, data structure and component
declarations.
4.2 XML syntax
XML syntax examples use font Courier New. The XML syntax is used to describe XML
document schema.
Example:
4.3 Capitalizations
The IEC 62769 series uses capitalized terms to emphasize that these terms have an FDI-
specific meaning.
___________
Field Device Integration (FDI) is the trademark of a product supplied by FieldComm Group. This information is
given for the convenience of users of this document and does not constitute an endorsement by IEC of the product
named. Equivalent products may be used if they can be shown to lead to the same results.
®
Capitalization of the first letter of words is used in the IEC 62769 series to emphasize an FDI
defined term.
EDD language elements are written with all letters in uppercase.
Some of these terms using an initialism acronym as a prefix for example ®
• FDI Client, or ®
• FDI Server.
Some of these terms are compound terms such as:
• Communication Servers, or
• Profile Package.
Parameter names or attributes are concatenated to a single term, where the original terms start
in this term with a capital letter such as:
• ProtocolSupportFile, or
• ProtocolType.
Parameter names or attributes can also be constructed by using an underscore character to
concatenate two or more terms such as:
• DEVICE_REV, or
• DEVICE_MODEL.
5 Profile for Generic Protocols
5.1 General ®
This profile document to the FDI specification in IEC 62769 specifies the protocol specifics ®
needed for FDI Packages describing Communication Servers, Gateways and Devices.
For Communication Servers, this document defines protocol specifics as these need to be
considered in the Information Model hosted by the Communication Servers.
This document also defines protocol specifics for Communication Servers as these need to be
considered in the Communication Servers hosted Information Model.
Annex B defines the XML schema for Direct Access Services.
5.2 Catalog profile
5.2.1 Protocol support file ®
5.2.1.1 FDI Device Package
Protocol specific attachments are mentioned in the Package Catalog as defined in IEC 62769-5.
As this document defines a profile generically suitable for many protocols, it does not define
requirements for any protocol specific attachments. However, it does also not prevent the usage
of protocol specific attachments. The PSDs (see Annex C) define the requirements on the need
of ProtocolSupportFiles for a specific protocol. However, the configuration of a device using an ®
FDI Device Package shall not require the usage of a protocol specific attachment. Table 1 ®
specifies the parameters of the ProtocolSupportFile in the FDI Device Package in case one or
many are provided.
– 10 – IEC 62769-100:2023 RLV © IEC 2023 ®
Table 1 – ProtocolSupportFile for FDI Device Packages
Parameter Description
Content Type text/plain
Root Namespace empty
Source Relationship http://FDI-cooperation.com/2010/relationship/attachment-protocol
Filename Not defined ®
5.2.1.2 FDI Communication Packages ®
The same rules as for FDI Device Packages apply.
5.2.2 CommunicationProfile definition
IEC 62769-4 defines a CommunicationProfileT string for the Catalog XML schema. The string
is protocol specific and defined as ProfileIdentifier in the PSD (see Annex C).
5.2.3 Profile device ®
A Profile Package shall provide the catalog values for profile devices, enabling the FDI Server
to leverage a generic device description, if a specific one is not available. The definitions in
Table 2 focus on catalog content that is vendor independent.
Table 2 – Catalog values for profile devices
Element Attribute Content
PackageType — Profile
Manufacturer — Empty
DeviceModel — The format of the DeviceModel is protocol specific and details on the
format are defined in the PSD (see Annex C).
In order to assign a scan result with a Profile Package, the ProfileId of
the scan result shall be mapped to the DeviceModel of the Profile
Package.
5.2.4 Protocol version information
IEC 62769-4 defines an element type named InterfaceT for the Catalog XML schema. The
element type InterfaceT contains an element named Version which is supposed to provide
version information about the applied communication protocol profile. The value shall follow the
IEC 62769-4 defined version information schema defined in the element type VersionT. The
PSD (see Annex C) define the mapping of versions of a specific protocol to this field.
5.3 Associating a Package with a device
5.3.1 Device type identification mapping ®
The purpose of device type identification mapping is to enable FDI Host systems to compare ®
the scan result against the topology representation in the Information Model. FDI Host systems ®
shall also be enabled to determine the FDI Device Package that fits for a device entry ®
contained in the scan result. This will enable the user of an FDI Host system to synchronize
the Information Model with the actual installation.
The Communication Server implemented scan service (defined in 5.6.1.7) provides the scan
result through an XML document (the schema is defined in Clause A.5).
The Gateway implemented scan service (defined in 5.6.2.7) provides the scan result by means
of the Information Model that contains data structures created from EDD content as specified
in 5.6.2.7.
Common for both ways of presenting the scan result is that scan results contain device type
identification and device instance identification. ®
FDI Host systems comparing the actual network topology configuration against the topology
representation in the Information Model shall be enabled to handle the following situations:
a) The physical Device instance identified at a specific device address is not logically present ®
in the Information Model (as Instance): Enable the FDI Host system to find the appropriate ®
FDI Device Package according to the device catalog information.
b) The physical Device instance identified by the device address is logically present in the ®
Host system to compare device type
Information Model (as Instance): Enable the FDI
information presented in scan result (see the identification in Clause A.5) and the device
type specific information of the Instance present in the Information Model. ®
The FDI Device Package contains device type identification information that can be compared
to scan result based on the Catalog Schema in IEC 62769-4 defining the XML (simple) element
types "DeviceModel" and "Manufacturer". Both types are used in the (complex) element types
"Protocol" and "RegDeviceType".
® ®
As a result of the FDI Package deployment, the FDI Package information is then present in
the Information Model as the specified FunctionalGroup Identification containing SerialNumber
and Tag (see 5.4.3).
The mapping between different device identification data sources is described in Table 3. Since
scan results provided by the Communication Server or Gateway can convey data that is
produced by the device (firmware), the device type identification mapping shall be supported ®
by providing corresponding data in the FDI Device Package contained Catalog and Information
Model.
Table 3 – Device identification information mapping ®
FDI Device Package Information Model Communication Server Gateway provided
provided scan result scan result
Catalog specified type FunctionalGroup: Element (path): COLLECTION
Identification ConnectionPoint/Identification ConnectionPoint.
Manufacturer
Browse Name: Attribute: Manufacturer Identification:
Manufacturer Manufacturer
Catalog specified type FunctionalGroup: Element (path): COLLECTION
Identification ConnectionPoint/Identification ConnectionPoint.
DeviceModel
Browse Name: Attribute: DeviceModel Identification.
DeviceModel DeviceModel
Since not all protocols that are intended to be used with this profile for Generic Protocols might
support a mandatory discovery mechanism allowing to identify the type of device (Manufacturer
and DeviceModel), the scan results provide the capability to exclude the identification of the
device and only provide the address. In that case, some host-specific mechanisms can might ®
be used to assign the desired FDI package to the device, e.g., by user interaction.
Since some protocols do might not even have mandatory capabilities to identify if there is a
device at all for a specific protocol address hosts should provide the capability for that some
users to can add devices by manually specifying address information.
– 12 – IEC 62769-100:2023 RLV © IEC 2023
5.3.2 Device type revision mapping ®
IEC 62769-4 envisions a concept that allows to determine the compatibility between an FDI
Device Package and a Device. IEC 62769-4 specifies a life cycle management process bearing
on a single version information provided for the entire device. This is captured in the
DeviceRevision (see Table 4). The DeviceRevision might be available as single number or as
a string. Mapping of version information is protocol-specific and needs to be defined in the PSD
(see Annex C).
Table 4 – Device revision information mapping ®
FDI Device Package Information Model Communication Server Gateway provided
provided scan result scan result
Catalog specified type FunctionalGroup: Element (path): COLLECTION
ListOfSupportedDeviceRevisions Identification ConnectionPoint/Identification ConnectionPoint.
Browse Name: Attribute: DeviceRevision Identification.
DeviceRevision DeviceRevision
5.4 Information Model mapping
5.4.1 ProtocolType definition
In Table 5, a subtype of ProtocolType is defined to identify network communication using this
profile.
Table 5 – Protocol type GenericProtocol
Attribute Value
BrowseName GenericProtocol
IsAbstract False
References NodeClass BrowseName DataType TypeDefinition ModellingRule
Subtype of the ProtocolType defined in IEC 62541-100.
HasProperty Variable ProtocolIdentifier String PropertyType Mandatory
The mandatory Variable ProtocolIdentifier defines which concrete protocol is represented using
the GenericProtocol type. It shall match the ProtocolIdentifier defined for the
CommunicationProfile in 5.2.2. The string is protocol specific and defined as ProfileIdentifier in
the PSD (see Annex C).
5.4.2 DeviceType mapping
Each device type inherits the properties of DeviceType. The mapping of the inherited properties
from DeviceType is defined in Table 6. Note that only the attributes defined in Annex C and
therefore expected by each generic protocol are used. Specific protocols can might provide for
example a SoftwareRevsion but since this is not accessible for the host, this profile does not
make use of it.
Table 6 – Inherited DeviceType property mapping
Property Generic Protocol Mapping
SerialNumber SerialNumber (see Annex C)
RevisionCounter -1 (not defined) ®
Manufacturer String taken from FDI package catalog
(ManufacturerName from PackageT)
®
Model String taken from FDI package catalog (Name of
DeviceTypeT, which is a localized name)
a
DeviceManual
empty text string (not supported)
DeviceRevision DeviceRevision (see Annex C)
SoftwareRevision empty string (not defined)
HardwareRevision empty string (not defined)
a ®
Device manuals are exposed as attachments of the FDI Device Package.
5.4.3 FunctionalGroup identification definition ®
As defined in IEC 62541-100:2015, 5.3, each device representation in the FDI Server hosted
Information Model shall contain a protocol specific FunctionalGroup named Identification. The
Parameters of this FunctionalGroup are defined for generic protocol device types as follows:
Table 7 – Generic Protocol Device Types identification attributes
BrowseName DataType Mandatory/Optional
Manufacturer String Mandatory
DeviceModel String Mandatory
SerialNumber String Optional
Tag String Optional
DeviceRevision UInt16 Optional
ExtendedDeviceRevision String Optional
ProfileId String Optional
The BaseDataVariable instances shall be created from VARIABLE declarations with identifiers
that correspond to the browse names listed in Table 7.
5.5 Topology elements
5.5.1 ConnectionPoint definition
The ConnectionPoint type GenericConnectionPoint shall be used to parameterize network
access points using the Generic Protocols. The ConnectionPoint type GenericConnectionPoint
is a sub type of the abstract type ConnectionPointType defined in IEC 62541-100. Table 8
specifies the representation of the GenericConnectionPoint in the AddressSpace.
Table 8 – ConnectionPoint type for Generic Protocols
Attribute Value
BrowseName GenericConnectionPoint
IsAbstract False
References NodeClass BrowseName DataType TypeDefinition ModellingRule
Sub type of the ConnectionPointType defined in IEC 62541-100.
HasProperty Variable Address String PropertyType Mandatory
HasProperty Variable ProtocolIdentifier String PropertyType Mandatory
The ConnectionPoint type GenericConnectionPoint shall be described by an EDD element ®
contained in a Communication Device related FDI Package that can drive a generic protocol
network. Actual ConnectionPoint properties are declared by VARIABLE constructs grouped
– 14 – IEC 62769-100:2023 RLV © IEC 2023
together in a COLLECTION named ConnectionPoint. For this profile, it shall only contain the
CONNECTION_POINT_ADDRESS, mapped to the OPC UA Property Address. In addition, the
PROTOCOL specified by the COMPONENT shall be mapped to the ProtocolIdentifier Property.
The following EDDL source code is an example describing a Connection Point for an
ExampleProtocol. The ProtocolIdentifier defined by the PSD (see Annex C) shall be used as
PROTOCOL name in the EDD.
COMPONENT ConnectionPoint_Generic
{
LABEL "Generic Connection Point";
CLASSIFICATION NETWORK_CONNECTION_POINT;
CAN_DELETE FALSE;
PROTOCOL ExampleProtocol;
CONNECTION_POINT ConnectionPoint;
}
VARIABLE Address
{
LABEL "Address";
HELP "Address of the device";
TYPE EUC();
CLASS LOCAL;
}
COLLECTION ConnectionPoint
{
LABEL "Connection Point";
MEMBERS
{
CONNECTION_POINT_ADDRESS, Address;
}
}
5.5.2 Communication Device definition ®
According to IEC 62769-7, each FDI Communication Package shall contain an EDD element
describing the communication device. The following EDDL source code is an example
describing a Communication Server.
COMPONENT Generic_Communication_Server
{
LABEL "Generic communication server";
PRODUCT_URI "urn:Company Name:Product Name";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMPONENT;
COMPONENT_RELATIONS
{
Generic_Communication_Device_Setup
}
}
COMPONENT_RELATION Generic_Communication_Device_Setup
{
LABEL "Relation between Device and communication device";
RELATION_TYPE CHILD_COMPONENT;
COMPONENTS
{
Generic_Communication_Device{AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 4;
} ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing at least one communication device component. The following EDDL source
code in is an example for a generic protocol communication device:
COMPONENT Generic_Communication_Device
{
LABEL "Generic communication device";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMPONENT;
COMPONENT_RELATIONS { Generic_Service_Provider_Relation }
}
COMPONENT_RELATION Generic_Service_Provider_Relation
{
LABEL "Relation to communication service provider";
RELATION_TYPE CHILD_COMPONENT;
COMPONENTS
{
Generic_Service_Provider{AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 1;
}
In an actual communication device, the ConnectionPoint_Generic needs to be adapted
according to the supported protocol and the related connection point definitions given in 5.5.
The attribute BYTE_ORDER shall not be used for this profile as the byte order handling shall
be done in the gateway business logic.
5.5.3 Communication service provider definition ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing at least one communication service provider component. The following
EDDL source code below is an example for a generic protocol communication service provider
component.
The component reference (ConnectionPoint_Generic) corresponds to the related connection
point definition in 5.5. The attribute BYTE_ORDER shall not be used for this profile as the byte
order handling shall be done in the gateway business logic.
COMPONENT Generic_Service_Provider
{
LABEL "Generic Protocol communication service provider";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMMUNICATION_SERVICE_PROVIDER;
COMPONENT_RELATIONS
{
Generic_Service_Provider_Connection_Point_Relation
}
}
COMPONENT_RELATION Generic_Service_Provider_Connection_Point_Relation
{
LABEL "Relation between communication service provider and Connection Point";
RELATION_TYPE CHILD_COMPONENT;
ADDRESSING {Address}
COMPONENTS
{
ConnectionPoint_Generic{ AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 1;
}
– 16 – IEC 62769-100:2023 RLV © IEC 2023
5.5.4 Network definition ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing network configuration constraints using the component construct.
COMPONENT Network_Generic
{
LABEL "Generic Network";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK;
COMPONENT_RELATIONS
{
Generic_Network_Connection_Point_Relation
}
}
COMPONENT_RELATION Generic_Network_Connection_Point_Relation
{
LABEL "Relation between network and Connection Point";
RELATION_TYPE CHILD_COMPONENT;
ADDRESSING {Address}
COMPONENTS
{
ConnectionPoint_Generic
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 32;
}
5.6 Methods ®
5.6.1 Methods for FDI Communication Servers
5.6.1.1 General
The Communication Server contained Information Model shall implement services according to
method signatures described in 5.6.1.
5.6.1.2 Connect
Signature:
Connect(
[in] ByteString CommunicationRelationId,
[in] String Address,
[out] Int32 ServiceError);
Table 9 provides the description of the arguments.
Table 9 – Method Connect arguments
Argument Description
CommunicationRelationId The argument value contains the nodeId of the ConnectionPoint representing
the connection between a device and a physical network which is directly
connected to the Communication Server hardware. The nodeId allows finding
the direct parent-child relation.
Address The argument name shall match with the corresponding attribute name
defined for the ConnectionPoint which is described by a corresponding EDD
element specified in 5.5. The argument value holds the protocol-specific
device’s network address that is unique within the network segment.
ServiceError 0: OK / execution finished, connection established successfully
-1: Connect Failed / cancelled by caller
-3: Connect Failed / device not found
-4: Connect Failed / invalid device address
-5: Connect Failed / invalid device identification
5.6.1.3 Disconnect
Signature:
Disconnect(
[in] ByteString CommunicationRelationId,
[out] Int32 ServiceError);
Table 10 provides the description of the arguments.
Table 10 – Method Disconnect arguments
Argument Description
CommunicationRelationId The argument value contains the nodeId of the ConnectionPoint representing
...
IEC 62769-100 ®
Edition 2.0 2023-04
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
Field device integration (FDI®) –
Part 100: Profiles – Generic Protocols
Intégration des appareils de terrain (FDI®) –
Partie 100: Profils – Protocoles Génériques
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC
copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or
your local IEC member National Committee for further information.
Droits de reproduction réservés. Sauf indication contraire, aucune partie de cette publication ne peut être reproduite ni
utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie et
les microfilms, sans l'accord écrit de l'IEC ou du Comité national de l'IEC du pays du demandeur. Si vous avez des
questions sur le copyright de l'IEC ou si vous désirez obtenir des droits supplémentaires sur cette publication, utilisez
les coordonnées ci-après ou contactez le Comité national de l'IEC de votre pays de résidence.
IEC Secretariat Tel.: +41 22 919 02 11
3, rue de Varembé info@iec.ch
CH-1211 Geneva 20 www.iec.ch
Switzerland
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.
About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigendum or an amendment might have been published.
IEC publications search - webstore.iec.ch/advsearchform IEC Products & Services Portal - products.iec.ch
The advanced search enables to find IEC publications by a Discover our powerful search engine and read freely all the
variety of criteria (reference number, text, technical publications previews. With a subscription you will always have
committee, …). It also gives information on projects, replaced access to up to date content tailored to your needs.
and withdrawn publications.
Electropedia - www.electropedia.org
IEC Just Published - webstore.iec.ch/justpublished
The world's leading online dictionary on electrotechnology,
Stay up to date on all new IEC publications. Just Published
containing more than 22 300 terminological entries in English
details all new publications released. Available online and once
and French, with equivalent terms in 19 additional languages.
a month by email.
Also known as the International Electrotechnical Vocabulary
(IEV) online.
IEC Customer Service Centre - webstore.iec.ch/csc
If you wish to give us your feedback on this publication or need
further assistance, please contact the Customer Service
Centre: sales@iec.ch.
A propos de l'IEC
La Commission Electrotechnique Internationale (IEC) est la première organisation mondiale qui élabore et publie des
Normes internationales pour tout ce qui a trait à l'électricité, à l'électronique et aux technologies apparentées.
A propos des publications IEC
Le contenu technique des publications IEC est constamment revu. Veuillez vous assurer que vous possédez l’édition la
plus récente, un corrigendum ou amendement peut avoir été publié.
Recherche de publications IEC - Découvrez notre puissant moteur de recherche et consultez
webstore.iec.ch/advsearchform gratuitement tous les aperçus des publications. Avec un
La recherche avancée permet de trouver des publications IEC abonnement, vous aurez toujours accès à un contenu à jour
en utilisant différents critères (numéro de référence, texte, adapté à vos besoins.
comité d’études, …). Elle donne aussi des informations sur les
projets et les publications remplacées ou retirées. Electropedia - www.electropedia.org
Le premier dictionnaire d'électrotechnologie en ligne au monde,
IEC Just Published - webstore.iec.ch/justpublished
avec plus de 22 300 articles terminologiques en anglais et en
Restez informé sur les nouvelles publications IEC. Just
français, ainsi que les termes équivalents dans 19 langues
Published détaille les nouvelles publications parues.
additionnelles. Egalement appelé Vocabulaire
Disponible en ligne et une fois par mois par email.
Electrotechnique International (IEV) en ligne.
Service Clients - webstore.iec.ch/csc
Si vous désirez nous donner des commentaires sur cette
publication ou si vous avez des questions contactez-nous:
sales@iec.ch.
IEC Products & Services Portal - products.iec.ch
IEC 62769-100 ®
Edition 2.0 2023-04
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
Field device integration (FDI®) –
Part 100: Profiles – Generic Protocols
Intégration des appareils de terrain (FDI®) –
Partie 100: Profils – Protocoles Génériques
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
INTERNATIONALE
ICS 25.040.40; 35.100.05 ISBN 978-2-8322-6475-1
– 2 – IEC 62769-100:2023 © IEC 2023
CONTENTS
FOREWORD . 5
1 Scope . 7
2 Normative references . 7
3 Terms, definitions, abbreviated terms and acronyms . 8
3.1 Terms and definitions . 8
3.2 Abbreviated terms and acronyms . 8
4 Conventions . 8
4.1 EDDL syntax . 8
4.2 XML syntax . 8
4.3 Capitalizations . 8
5 Profile for Generic Protocols . 9
5.1 General . 9
5.2 Catalog profile . 9
5.2.1 Protocol support file . 9
5.2.2 CommunicationProfile definition . 9
5.2.3 Profile device . 10
5.2.4 Protocol version information . 10
5.3 Associating a Package with a device . 10
5.3.1 Device type identification mapping . 10
5.3.2 Device type revision mapping . 11
5.4 Information Model mapping . 12
5.4.1 ProtocolType definition . 12
5.4.2 DeviceType mapping . 12
5.4.3 FunctionalGroup identification definition . 12
5.5 Topology elements . 13
5.5.1 ConnectionPoint definition . 13
5.5.2 Communication Device definition . 14
5.5.3 Communication service provider definition . 15
5.5.4 Network definition . 16
5.6 Methods . 16 ®
5.6.1 Methods for FDI Communication Servers . 16
5.6.2 Methods for Gateways . 20
Annex A (normative) Topology scan result schema . 29
A.1 General . 29
A.2 Network . 29
A.3 GenericNetworkT . 29
A.4 GenericConnectionPointT . 30
A.5 GenericIdentificationT . 30
A.6 GenericAddressT . 31
A.7 GenericIdentificationExtendedT . 31
Annex B (normative) Transfer service parameters . 32
B.1 General . 32
B.2 sendData . 32
B.3 receiveData . 32
B.4 TransferSendDataT . 32
B.5 EddDataTypeInfoListT . 33
B.6 EddDataTypeInfoT . 33
B.7 EddDataTypeT . 34
B.8 TransferResultDataT . 35
Annex C (normative) Protocol specific definitions . 36
C.1 General . 36
C.2 Header . 36
C.3 ProtocolIdentifier . 36
C.4 Address . 36
C.5 Manufacturer . 37
C.6 DeviceModel . 37
C.7 DeviceRevision . 37
C.8 SerialNumber . 37
C.9 Tag . 37
C.10 ProfileId . 38
C.11 Version . 38
C.12 ProtocolSupportFile . 38
C.13 ExtendedDeviceRevision . 38
Bibliography . 39
®
Table 1 – ProtocolSupportFile for FDI Device Packages . 9
Table 2 – Catalog values for profile devices . 10
Table 3 – Device identification information mapping . 11
Table 4 – Device revision information mapping . 11
Table 5 – Protocol type GenericProtocol . 12
Table 6 – Inherited DeviceType property mapping . 12
Table 7 – Generic Protocol Device Types identification attributes . 13
Table 8 – ConnectionPoint type for Generic Protocols . 13
Table 9 – Method Connect arguments . 17
Table 10 – Method Disconnect arguments . 17
Table 11 – Method Transfer arguments . 18
Table 12 – EddDataTypeInfo DataType Structure . 19
Table 13 – EddDataTypeEnum Values . 19
Table 14 – Method SetAddress arguments . 20
Table 15 – Connect service arguments . 22
Table 16 – Method Transfer arguments . 24
Table 17 – Method SetAddress arguments . 27
Table A.1 – Elements of GenericNetworkT . 29
Table A.2 – Attributes of GenericConnectionPointT . 30
Table A.3 – Elements of GenericConnectionPointT . 30
Table A.4 – Attributes of GenericIdentificationT . 31
Table A.5 – Attributes of GenericIdentificationExtendedT . 31
Table B.1 – Attributes of TransferSendDataT . 33
Table B.2 – Elements of TransferSendDataT . 33
Table B.3 – Elements of EddDataTypeInfoListT . 33
Table B.4 – Attributes of EddDataTypeInfoT . 34
– 4 – IEC 62769-100:2023 © IEC 2023
Table B.5 – Enumerations of EddDataTypeT . 35
Table B.6 – Attributes of TransferResultDataT . 35
INTERNATIONAL ELECTROTECHNICAL COMMISSION
____________ ®
FIELD DEVICE INTEGRATION (FDI ) –
Part 100: Profiles – Generic Protocols
FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote international
co-operation on all questions concerning standardization in the electrical and electronic fields. To this end and
in addition to other activities, IEC publishes International Standards, Technical Specifications, Technical Reports,
Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC Publication(s)”). Their
preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with
may participate in this preparatory work. International, governmental and non-governmental organizations liaising
with the IEC also participate in this preparation. IEC collaborates closely with the International Organization for
Standardization (ISO) in accordance with conditions determined by agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence between
any IEC Publication and the corresponding national or regional publication shall be clearly indicated in the latter.
5) IEC itself does not provide any attestation of conformity. Independent certification bodies provide conformity
assessment services and, in some areas, access to IEC marks of conformity. IEC is not responsible for any
services carried out by independent certification bodies.
6) All users should ensure that they have the latest edition of this publication.
7) No liability shall attach to IEC or its directors, employees, servants or agents including individual experts and
members of its technical committees and IEC National Committees for any personal injury, property damage or
other damage of any nature whatsoever, whether direct or indirect, or for costs (including legal fees) and
expenses arising out of the publication, use of, or reliance upon, this IEC Publication or any other IEC
Publications.
8) Attention is drawn to the Normative references cited in this publication. Use of the referenced publications is
indispensable for the correct application of this publication.
9) Attention is drawn to the possibility that some of the elements of this IEC Publication may be the subject of patent
rights. IEC shall not be held responsible for identifying any or all such patent rights.
IEC 62769-100 has been prepared by subcommittee 65E: Devices and integration in enterprise
systems, of IEC technical committee 65: Industrial-process measurement, control and
automation. It is an International Standard.
This second edition cancels and replaces the first edition published in 2020. This edition
constitutes a technical revision.
This edition includes the following significant technical changes with respect to the previous
edition: ®
a) added ExtendedDeviceRevision implementing the FDI Version scheme and the method
ScanExtended.
– 6 – IEC 62769-100:2023 © IEC 2023
The text of this International Standard is based on the following documents:
Draft Report on voting
65E/865/CDV 65E/922/RVC
Full information on the voting for its approval can be found in the report on voting indicated in
the above table.
The language used for the development of this International Standard is English.
This document was drafted in accordance with ISO/IEC Directives, Part 2, and developed in
accordance with ISO/IEC Directives, Part 1 and ISO/IEC Directives, IEC Supplement, available
at www.iec.ch/members_experts/refdocs. The main document types developed by IEC are
described in greater detail at www.iec.ch/standardsdev/publications.
A list of all parts in the IEC 62769 series, published under the general title Field device ®
integration (FDI ), can be found on the IEC website.
The committee has decided that the contents of this document will remain unchanged until the
stability date indicated on the IEC website under "http://webstore.iec.ch" in the data related to
the specific document. At this date, the document will be
• reconfirmed,
• withdrawn,
• replaced by a revised edition, or
• amended. ®
FIELD DEVICE INTEGRATION (FDI ) –
Part 100: Profiles – Generic Protocols
1 Scope
®1
This part of IEC 62769 specifies an FDI profile of IEC 62769 for Generic Protocols. That
means that all interfaces are defined and a host can add support for more protocols without
changing its implementation. Nevertheless, there are some protocol specific definitions (PSD)
that need to be specified per protocol using this profile. Annex C specifies what PSD need to
® ®
be defined per protocol so that FDI Device Packages, FDI Communication Packages for
® ®
Gateways and FDI Communication Servers, FDI Communication Server, Gateways and
Devices supporting such a protocol can work together in a host not aware about this specific
protocol. ®
NOTE A host not using FDI Communication Server but a proprietary mechanism for communication needs to define
its own means to deal with this profile to support several protocols without changing its implementation. This is
specific to the proprietary way how the communication driver is bound to the host.
2 Normative references
The following documents are referred to in the text in such a way that some or all of their content
constitutes requirements of this document. For dated references, only the edition cited applies.
For undated references, the latest edition of the referenced document (including any
amendments) applies.
IEC 61804 (all parts), Devices and integration in enterprise systems − Function blocks (FB) for
process control and Electronic Device Description Language (EDDL)
IEC 61804-3, Devices and integration in enterprise systems − Function blocks (FB) for process
control and electronic device description language (EDDL) − Part 3: EDDL syntax and
semantics
IEC 62541-100:2015, OPC Unified Architecture – Part 100: Device Interface ®
IEC 62769-1, Field Device Integration (FDI ) – Part 1: Overview ®
) – Part 2: Client
IEC 62769-2, Field Device Integration (FDI ®
IEC 62769-3, Field Device Integration (FDI ) – Part 3: Server
® ®
IEC 62769-4, Field Device Integration (FDI ) – Part 4: FDI Packages
® ®
IEC 62769-5, Field Device Integration (FDI ) – Part 5: FDI Information Model ®
IEC 62769-7, Field Device Integration (FDI ) – Part 7: Communication Devices
___________
1 ®
FDI is a registered trademark of the non-profit organization Fieldbus Foundation, Inc. This information is given
for the convenience of users of this document and does not constitute an endorsement by IEC of the trademark
holder or any of its products. Compliance does not require use of the trade name. Use of the trade name requires
permission of the trade name holder.
– 8 – IEC 62769-100:2023 © IEC 2023 ®
IEC 62769-151-1, Field Device Integration (FDI ) – Part 151-1: Profiles – OPC UA
3 Terms, definitions, abbreviated terms and acronyms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in IEC 61804 series,
IEC 62541-100, IEC 62769-2, IEC 62769-3, IEC 62769-4, IEC 62769-5, and IEC 62769-7
apply.
ISO and IEC maintain terminology databases for use in standardization at the following
addresses:
• IEC Electropedia: available at https://www.electropedia.org/
• ISO Online browsing platform: available at https://www.iso.org/obp
3.2 Abbreviated terms and acronyms
EDD Electronic Device Description
EDDL Electronic Device Description Language (see IEC 61804 series) ®
FDI Field Device Integration
FCG FieldComm Group
PSD Protocol-specific definitions
XML Extensible markup language (see REC-xml-20081126)
4 Conventions
4.1 EDDL syntax ®
This part of IEC 62769 specifies content for the EDD component that is part of FDI
Communication Packages. The specification content using EDDL syntax uses the font Courier
New. The EDDL syntax is used for method signature, variable, data structure and component
declarations.
4.2 XML syntax
XML syntax examples use font Courier New. The XML syntax is used to describe XML
document schema.
Example:
4.3 Capitalizations ®
Capitalization of the first letter of words is used in the IEC 62769 series to emphasize an FDI
defined term.
EDD language elements are written with all letters in uppercase.
Some of these terms using an acronym as a prefix for example ®
• FDI Client, or ®
• FDI Server.
Some of these terms are compound terms such as:
• Communication Servers, or
• Profile Package.
Parameter names or attributes are concatenated to a single term, where the original terms start
in this term with a capital letter such as:
• ProtocolSupportFile, or
• ProtocolType.
Parameter names or attributes can also be constructed by using an underscore character to
concatenate two or more terms such as:
• DEVICE_REV, or
• DEVICE_MODEL.
5 Profile for Generic Protocols
5.1 General ®
This profile document to the FDI specification in IEC 62769 specifies the protocol specifics ®
needed for FDI Packages describing Communication Servers, Gateways and Devices.
This document also defines protocol specifics for Communication Servers as these need to be
considered in the Communication Servers hosted Information Model.
Annex B defines the XML schema for Direct Access Services.
5.2 Catalog profile
5.2.1 Protocol support file ®
Device Package
5.2.1.1 FDI
Protocol specific attachments are mentioned in the Package Catalog as defined in IEC 62769-5.
As this document defines a profile generically suitable for many protocols, it does not define
requirements for any protocol specific attachments. However, it does also not prevent the usage
of protocol specific attachments. The PSD define the requirements on the need of
ProtocolSupportFiles for a specific protocol. However, the configuration of a device using an ®
FDI Device Package shall not require the usage of a protocol specific attachment. Table 1 ®
specifies the parameters of the ProtocolSupportFile in the FDI Device Package in case one or
many are provided. ®
Table 1 – ProtocolSupportFile for FDI Device Packages
Parameter Description
Content Type text/plain
Root Namespace empty
Source Relationship http://FDI-cooperation.com/2010/relationship/attachment-protocol
Filename Not defined ®
5.2.1.2 FDI Communication Packages ®
The same rules as for FDI Device Packages apply.
5.2.2 CommunicationProfile definition
IEC 62769-4 defines a CommunicationProfileT string for the Catalog XML schema. The string
is protocol specific and defined as ProfileIdentifier in the PSD (see Annex C).
– 10 – IEC 62769-100:2023 © IEC 2023
5.2.3 Profile device ®
A Profile Package shall provide the catalog values for profile devices, enabling the FDI Server
to leverage a generic device description, if a specific one is not available. The definitions in
Table 2 focus on catalog content that is vendor independent.
Table 2 – Catalog values for profile devices
Element Attribute Content
PackageType — Profile
Manufacturer — Empty
DeviceModel — The format of the DeviceModel is protocol specific and details on the
format are defined in the PSD (see Annex C).
In order to assign a scan result with a Profile Package, the ProfileId of
the scan result shall be mapped to the DeviceModel of the Profile
Package.
5.2.4 Protocol version information
IEC 62769-4 defines an element type named InterfaceT for the Catalog XML schema. The
element type InterfaceT contains an element named Version which is supposed to provide
version information about the applied communication protocol profile. The value shall follow the
IEC 62769-4 defined version information schema defined in the element type VersionT. The
PSD (see Annex C) define the mapping of versions of a specific protocol to this field.
5.3 Associating a Package with a device
5.3.1 Device type identification mapping ®
The purpose of device type identification mapping is to enable FDI Host systems to compare ®
the scan result against the topology representation in the Information Model. FDI Host systems ®
shall also be enabled to determine the FDI Device Package that fits for a device entry ®
contained in the scan result. This will enable the user of an FDI Host system to synchronize
the Information Model with the actual installation.
The Communication Server implemented scan service (defined in 5.6.1.7) provides the scan
result through an XML document (the schema is defined in Clause A.5).
The Gateway implemented scan service (defined in 5.6.2.7) provides the scan result by means
of the Information Model that contains data structures created from EDD content as specified
in 5.6.2.7.
Common for both ways of presenting the scan result is that scan results contain device type
identification and device instance identification. ®
FDI Host systems comparing the actual network topology configuration against the topology
representation in the Information Model shall be enabled to handle the following situations:
a) The physical Device instance identified at a specific device address is not logically present ®
in the Information Model (as Instance): Enable the FDI Host system to find the appropriate ®
FDI Device Package according to the device catalog information.
b) The physical Device instance identified by the device address is logically present in the ®
Information Model (as Instance): Enable the FDI Host system to compare device type
information presented in scan result (see the identification in Clause A.5) and the device
type specific information of the Instance present in the Information Model.
®
The FDI Device Package contains device type identification information that can be compared
to scan result based on the Catalog Schema in IEC 62769-4 defining the XML (simple) element
types "DeviceModel" and "Manufacturer". Both types are used in the (complex) element types
"Protocol" and "RegDeviceType".
® ®
As a result of the FDI Package deployment, the FDI Package information is then present in
the Information Model as the specified FunctionalGroup Identification containing SerialNumber
and Tag (see 5.4.3).
The mapping between different device identification data sources is described in Table 3. Since
scan results provided by the Communication Server or Gateway can convey data that is
produced by the device (firmware), the device type identification mapping shall be supported ®
by providing corresponding data in the FDI Device Package contained Catalog and Information
Model.
Table 3 – Device identification information mapping ®
FDI Device Package Information Model Communication Server Gateway provided
provided scan result scan result
Catalog specified type FunctionalGroup: Element (path): COLLECTION
Identification ConnectionPoint/Identification ConnectionPoint.
Manufacturer
Browse Name: Attribute: Manufacturer Identification:
Manufacturer Manufacturer
Catalog specified type FunctionalGroup: Element (path): COLLECTION
Identification ConnectionPoint/Identification ConnectionPoint.
DeviceModel
Browse Name: Attribute: DeviceModel Identification.
DeviceModel DeviceModel
Since not all protocols that are intended to be used with this profile for Generic Protocols might
support a mandatory discovery mechanism allowing to identify the type of device (Manufacturer
and DeviceModel), the scan results provide the capability to exclude the identification of the
device and only provide the address. In that case, some host-specific mechanisms might be ®
used to assign the desired FDI package to the device, e.g., by user interaction.
Since some protocols might not even have mandatory capabilities to identify if there is a device
at all for a specific protocol address hosts should provide the capability that some users can
add devices by manually specifying address information.
5.3.2 Device type revision mapping ®
IEC 62769-4 envisions a concept that allows to determine the compatibility between an FDI
Device Package and a Device. IEC 62769-4 specifies a life cycle management process bearing
on a single version information provided for the entire device. This is captured in the
DeviceRevision (see Table 4). The DeviceRevision might be available as single number or as
a string. Mapping of version information is protocol-specific and needs to be defined in the PSD
(see Annex C).
Table 4 – Device revision information mapping ®
FDI Device Package Information Model Communication Server Gateway provided
provided scan result scan result
Catalog specified type FunctionalGroup: Element (path): COLLECTION
ListOfSupportedDeviceRevisions Identification ConnectionPoint/Identification ConnectionPoint.
Browse Name: Attribute: DeviceRevision Identification.
DeviceRevision DeviceRevision
– 12 – IEC 62769-100:2023 © IEC 2023
5.4 Information Model mapping
5.4.1 ProtocolType definition
In Table 5, a subtype of ProtocolType is defined to identify network communication using this
profile.
Table 5 – Protocol type GenericProtocol
Attribute Value
BrowseName GenericProtocol
IsAbstract False
References NodeClass BrowseName DataType TypeDefinition ModellingRule
Subtype of the ProtocolType defined in IEC 62541-100.
HasProperty Variable ProtocolIdentifier String PropertyType Mandatory
The mandatory Variable ProtocolIdentifier defines which concrete protocol is represented using
the GenericProtocol type. It shall match the ProtocolIdentifier defined for the
CommunicationProfile in 5.2.2. The string is protocol specific and defined as ProfileIdentifier in
the PSD (see Annex C).
5.4.2 DeviceType mapping
Each device type inherits the properties of DeviceType. The mapping of the inherited properties
from DeviceType is defined in Table 6. Note that only the attributes defined in Annex C and
therefore expected by each generic protocol are used. Specific protocols might provide for
example a SoftwareRevsion but since this is not accessible for the host, this profile does not
make use of it.
Table 6 – Inherited DeviceType property mapping
Property Generic Protocol Mapping
SerialNumber SerialNumber (see Annex C)
RevisionCounter -1 (not defined) ®
Manufacturer String taken from FDI package catalog
(ManufacturerName from PackageT) ®
String taken from FDI package catalog (Name of
Model
DeviceTypeT, which is a localized name)
a
DeviceManual
empty text string (not supported)
DeviceRevision DeviceRevision (see Annex C)
SoftwareRevision empty string (not defined)
HardwareRevision empty string (not defined)
a ®
Device manuals are exposed as attachments of the FDI Device Package.
5.4.3 FunctionalGroup identification definition ®
As defined in IEC 62541-100:2015, 5.3, each device representation in the FDI Server hosted
Information Model shall contain a protocol specific FunctionalGroup named Identification. The
Parameters of this FunctionalGroup are defined for generic protocol device types as follows:
Table 7 – Generic Protocol Device Types identification attributes
BrowseName DataType Mandatory/Optional
Manufacturer String Mandatory
DeviceModel String Mandatory
SerialNumber String Optional
Tag String Optional
DeviceRevision UInt16 Optional
ExtendedDeviceRevision String Optional
ProfileId String Optional
The BaseDataVariable instances shall be created from VARIABLE declarations with identifiers
that correspond to the browse names listed in Table 7.
5.5 Topology elements
5.5.1 ConnectionPoint definition
The ConnectionPoint type GenericConnectionPoint shall be used to parameterize network
access points using the Generic Protocols. The ConnectionPoint type GenericConnectionPoint
is a sub type of the abstract type ConnectionPointType defined in IEC 62541-100. Table 8
specifies the representation of the GenericConnectionPoint in the AddressSpace.
Table 8 – ConnectionPoint type for Generic Protocols
Attribute Value
BrowseName GenericConnectionPoint
IsAbstract False
References NodeClass BrowseName DataType TypeDefinition ModellingRule
Sub type of the ConnectionPointType defined in IEC 62541-100.
HasProperty Variable Address String PropertyType Mandatory
HasProperty Variable ProtocolIdentifier String PropertyType Mandatory
The ConnectionPoint type GenericConnectionPoint shall be described by an EDD element ®
contained in a Communication Device related FDI Package that can drive a generic protocol
network. Actual ConnectionPoint properties are declared by VARIABLE constructs grouped
together in a COLLECTION named ConnectionPoint. For this profile, it shall only contain the
CONNECTION_POINT_ADDRESS, mapped to the OPC UA Property Address. In addition, the
PROTOCOL specified by the COMPONENT shall be mapped to the ProtocolIdentifier Property.
The following EDDL source code is an example describing a Connection Point for an
ExampleProtocol. The ProtocolIdentifier defined by the PSD (see Annex C) shall be used as
PROTOCOL name in the EDD.
– 14 – IEC 62769-100:2023 © IEC 2023
COMPONENT ConnectionPoint_Generic
{
LABEL "Generic Connection Point";
CLASSIFICATION NETWORK_CONNECTION_POINT;
CAN_DELETE FALSE;
PROTOCOL ExampleProtocol;
CONNECTION_POINT ConnectionPoint;
}
VARIABLE Address
{
LABEL "Address";
HELP "Address of the device";
TYPE EUC();
CLASS LOCAL;
}
COLLECTION ConnectionPoint
{
LABEL "Connection Point";
MEMBERS
{
CONNECTION_POINT_ADDRESS, Address;
}
}
5.5.2 Communication Device definition ®
According to IEC 62769-7, each FDI Communication Package shall contain an EDD element
describing the communication device. The following EDDL source code is an example
describing a Communication Server.
COMPONENT Generic_Communication_Server
{
LABEL "Generic communication server";
PRODUCT_URI "urn:Company Name:Product Name";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMPONENT;
COMPONENT_RELATIONS
{
Generic_Communication_Device_Setup
}
}
COMPONENT_RELATION Generic_Communication_Device_Setup
{
LABEL "Relation between Device and communication device";
RELATION_TYPE CHILD_COMPONENT;
COMPONENTS
{
Generic_Communication_Device{AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 4;
} ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing at least one communication device component. The following EDDL source
code in is an example for a generic protocol communication device:
COMPONENT Generic_Communication_Device
{
LABEL "Generic communication device";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMPONENT;
COMPONENT_RELATIONS { Generic_Service_Provider_Relation }
}
COMPONENT_RELATION Generic_Service_Provider_Relation
{
LABEL "Relation to communication service provider";
RELATION_TYPE CHILD_COMPONENT;
COMPONENTS
{
Generic_Service_Provider{AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 1;
}
In an actual communication device, the ConnectionPoint_Generic needs to be adapted
according to the supported protocol and the related connection point definitions given in 5.5.
The attribute BYTE_ORDER shall not be used for this profile as the byte order handling shall
be done in the gateway business logic.
5.5.3 Communication service provider definition ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing at least one communication service provider component. The following
EDDL source code below is an example for a generic protocol communication service provider
component.
The component reference (ConnectionPoint_Generic) corresponds to the related connection
point definition in 5.5. The attribute BYTE_ORDER shall not be used for this profile as the byte
order handling shall be done in the gateway business logic.
COMPONENT Generic_Service_Provider
{
LABEL "Generic Protocol communication service provider";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK_COMMUNICATION_SERVICE_PROVIDER;
COMPONENT_RELATIONS
{
Generic_Service_Provider_Connection_Point_Relation
}
}
COMPONENT_RELATION Generic_Service_Provider_Connection_Point_Relation
{
LABEL "Relation between communication service provider and Connection Point";
RELATION_TYPE CHILD_COMPONENT;
ADDRESSING {Address}
COMPONENTS
{
ConnectionPoint_Generic{ AUTO_CREATE 1;}
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 1;
}
– 16 – IEC 62769-100:2023 © IEC 2023
5.5.4 Network definition ®
According to IEC 62769-7, each FDI Communication Package shall contain at least one EDD
element describing network configuration constraints using the component construct.
COMPONENT Network_Generic
{
LABEL "Generic Network";
CAN_DELETE TRUE;
CLASSIFICATION NETWORK;
COMPONENT_RELATIONS
{
Generic_Network_Connection_Point_Relation
}
}
COMPONENT_RELATION Generic_Network_Connection_Point_Relation
{
LABEL "Relation between network and Connection Point";
RELATION_TYPE CHILD_COMPONENT;
ADDRESSING {Address}
COMPONENTS
{
ConnectionPoint_Generic
}
MINIMUM_NUMBER 1;
MAXIMUM_NUMBER 32;
}
5.6 Methods ®
5.6.1 Methods for FDI Communication Servers
5.6.1.1 General
The Communication Server contained Information Model shall implement services according to
method signatures described in 5.6.1.
5.6.1.2 Connect
Signature:
Connect(
[in] ByteString CommunicationRelationId,
[in] String Address,
[out] Int32 ServiceError);
Table 9 provides the description of the arguments.
...










Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.
Loading comments...