From 7ff516d8eb10d98ccc475f809cd13b4ecdb6347d Mon Sep 17 00:00:00 2001
From: ankraft <an.kraft@googlemail.com>
Date: Tue, 1 Dec 2015 20:18:42 +0100
Subject: [PATCH] Changed documentation according to HGI SHTF discussion.
---
SDT/schema3.0/docs/Introduction.md | 90 ++++++----
SDT/schema3.0/docs/SDT_Components.md | 164 ++++++++----------
.../docs/images/MC.Action.DataPoint.Event.png | Bin 0 -> 37326 bytes
SDT/schema3.0/docs/images/SDT_simplified.png | Bin 0 -> 37105 bytes
4 files changed, 128 insertions(+), 126 deletions(-)
create mode 100644 SDT/schema3.0/docs/images/MC.Action.DataPoint.Event.png
create mode 100644 SDT/schema3.0/docs/images/SDT_simplified.png
diff --git a/SDT/schema3.0/docs/Introduction.md b/SDT/schema3.0/docs/Introduction.md
index a2f738a..01f2bb2 100644
--- a/SDT/schema3.0/docs/Introduction.md
+++ b/SDT/schema3.0/docs/Introduction.md
@@ -1,65 +1,83 @@
# Introduction to the SDT
-The Smart Device Template (SDT) is a template which is used to model the capabilities, actions and events of connected devices. The intent of the SDT is to be able to model any type of connected device using a well accepted and standardised format. The main application of SDT is to enable a uniformly structured Application Programmer’s Interface (API) to applications that need to interact with connected devices. Usually, these applications would communicate to devices using an Abstraction Layer as an intermediary logic. The Abstraction Layer „hides“ the technology-specific, native language format of devices of different technology type from the applications.
+The SDT (Smart Device Template) is an initiative from HGI to find consensus amongst various SDOs and industry alliances to derive a common approach for device modelling. HGI and partners have the approach to agree on a set of automation commands, following a common syntax, which are sufficient to model most home appliance functions.
-## The goal
+At the time of writing, every software developed for home gateways or internet-of-things gateways needs to be capable of using various different protocols (ZigBee, UPnP, EchonetLite, DECT ULE, etc) to interact with a range of devices designed for the home environment. This adds extreme overheads in integrating, checking and updating code. The purpose of SDT is to describe devices and device services in a way which is independent of the LAN technology, in a format which is convenient and reliable for integration in modern code (Java, C/C++, ...).
-Interoperability for smart-home and other IoT-related applications and Internet-of-Things devices and services is a key objective that is not currently easy to meet, because of the many types of technology specific device interfaces in wide deployment. There is no accepted standard.
+The key goals of the SDT are: (1) keep it simple, especially for manufacturers to contribute device information; (2) modularity for functions and device types; (3) make it easy for developers to create unified APIs; (4) be independent of underlying home-area network technologies; (4) enable extendibility of the system in place without service interruption; (5) allow a pass-through mechanism to enable use of proprietary or technology-specific functions.
-A major goal for service providers is that software developers should be able to write application software which would handle most of the commonly used functions for any device, irrespective of the device technology. Furthermore, software developers should not have to make major changes to the software in case a new device of similar function but of a different interface technology is used.
-If these goals were fully or even partly met, major advantages can be obtained:
+In general a description of device (or complex appliance) behaviour can be made in many ways, with various kinds of constraints:
-- Service Providers would be more able to deploy and support select new technology types of devices, because existing software application code could be more easily adapted to the new device technology.
-- Devices of multiple technology types could be deployed and supported by the same platform (e.g. a Home Gateway), and applications could more easily communicate with them simultaneously.
-- Devices of multiple technology types could be deployed by a service provider in different regions or homes, but common application code could be used to support applications. For example, a home automation application could support ECHONET devices in one set of homes, and ZigBee devices in another
-- Makers of software application code can more easily support multiple device technology types
-- Vendors using newer device technologies could more easily bring their products to new markets.
+1. no constraints (e.g. using OWL 2.0 or even more "flexibly" RDF)
+2. moderate constraints (e.g. using XML and a related extensible XSD template)
+3. strict constraints (typical for a device certified to interoperate with a specific LAN protocol)
-The interoperability benefits can potentially partially obtain even without a fully complete interoperability of the SDT. For example, the most common functions can be modeled with SDT, and more particular functions can be modeled with technology-specific, proprietary, or seldom-used aspects.
+HGI chose to use the approach "moderate constraints" (XSD based) because for software development it offers ease of use and a good compromise. In particular, if there are few or no constraints on control parameters then few automatic checks can be made to detect if the software parameters are appropriate for each device integrated. XML and XSD languages were chosen because they are familiar to many developers, can be parsed with common software tools, and can still be created and interpreted by humans if necessary.
-## How should SDT work?
+HGI believes that Device information models based on XML and extensible XSD need some guidelines. If every possible feature of every existing LAN technology and appliance were allowed to be described in any formally correct way, then the results would be a modern Babel, no better than today's system of widely different and wildly competing automation protocols.
-The basic concept is that a manufacturer, organisation or global SDO would define its preferred Smart Device Template, in XML, specified by and based on an XSD. Using that XSD, manufacturers or indeed hobbyists could "describe" existing or new devices by means of XML files, specifying the capabilities and the parameters needed to control the devices.
+Therefore HGI proposes to recommend a certain structure (template) for the information model(s), but to allow extensions. Naturally, the more industry consensus is achieved for a single recommended template, the greater the utility for software developers (and users).
-Assuming that the XML files conform to the specified XSD and to some guidelines described in this document, software developers could readily create APIs able to "parse" the XML-descriptions of devices and (assuming the underlying LAN technology of the device is supported by the software/hardware environment in the gateway) operate the equipment.
+The SDT approach is to define re-usable basic functions (or services), labelled "ModuleClass" in the figure below, which can represent the typical functions found in many home automation systems, such as "on/off", "dim a lamp", "receive events from binary sensor", "read data from sensor", etc. Each ModuleClass is composed of a (small) number of actions, datapoint read/write operations, or asynchronous events. For example, an "on/off" ModuleClass would consist perhaps of just one Action, but a "ReadKeypad" Action might have a number of possible events, each with some data value and (usually) a sequence-ID or timestamp start/stop to indicate when and how long each key was pressed.
+
-The key to making software reliably interoperate with various technologies is to define in the SDT a finite and convenient to use number of functions (which is the decision of the SDO which are commonly used and can therefore be reliably re-used in software for one type of device or another.
+<center></center>
+<center>**SmartHome Device Template (XSD) for a generic device (simplification)</center>**
-For the convenience of users and developers, it would also be possible to collect the device descriptions of common "modules" (types of) appliances so that the operations of "a generic air-conditioner" could be agreed and re-used often, adapting descriptions of special models with just some special features added as local extensions. Agreeing on the definition of "a generic XYZ appliance" is rather time-consuming, so such "repository" may not become standardised, however the basic approach has huge benefits even if such an archive (also known as a "hierarchical ontology") is never formally agreed.
+The SDT represents the device models introduced in the above figure by using an XSD schema to allow formal checking of compliance for XML device descriptions of specific appliances. The modularity goal in the XSD schema is achieved with re-usable XSD fragments ("ModuleClass" in the figure).
-The sections below explain this in more detail.
+Complex devices or appliances can then be described by an appropriate set or collection of the agreed XSD fragments (ModuleClasses), as indicated in the figure, which also shows an optional DeviceInfo XSD fragment to allow noting of static information such as device manufacturer name, device firmware version, etc etc.
-## How does the SDT approach simplify software development?
+HGI has discussed with many SDOs to validate these concepts. SDT is designed to take into account the list of "services" compiled by the SAREF project (https://sites.google.com/site/smartappliancesproject/home).
-Simplification is achieved in software development by first developing methods to handle common or general functions, then treating necessary "uncommon" functions as extensions; treating each functionality as an individual special case does not scale. Identifying the general functions is often called "abstracting".
+The SDT supports the use of a set of templates for generic devices or appliances (e.g. for a dimmable lamp, a basic washing machine, etc, which would be specific instances of the "Device" object , which form the basis of APIs used by application developers. These templates can also be referenced by manufacturers creating XML documents to describe their specific products. For example, the SDT enables specification of a generic washing machine template, with on/off, set-wash-temperature, pause and a few other commands, which could be referenced by a manufacturer as the schema for a XML description of a basic model washing machine. The SDT allows for vendor-specific additional commands (ModuleClasses) to suit specific product types.
-There are four major levels of progressively greater abstraction in the signaling and software along the path between a sensor (or actuator) and a software application installed in the cloud:
+The interoperability benefits can potentially partially obtain even without a fully complete interoperability of the SDT. For example, the most common functions can be modeled with SDT, and more particular functions can be modeled with technology-specific, proprietary, or seldom-used aspects.
-1. a LAN protocol can provide a common set of signaling methods for all compatible sensors/actuators/devices (abstraction at the LAN-controller)
-2. a local gateway software can provide common functions to operate diverse kinds of LAN-controllers (abstraction in the local gateway)
-3. an IoT platform in the WAN can interoperate with a number of WAN protocols supported by different kinds of gateways (abstraction at the IoT platform)
-4. software in the Cloud can interact with diverse IoT platforms and other software applications (abstraction in the Cloud)
+Various details about the recommended structure for SDTs are described in the next sections. The key point to keep in mind is that HGI sought a compromise between, at the one extreme, complete flexibility (which could describe any device, of any complexity) and, at the other extreme, a rigid structure which could be 100% validated and lead to validated software APIs.
-The concept of the SDT was created in order to make life easier for the software developer working particularly at the second level, creating software for local gateways to interact with devices connected by various kinds of (wireless) LAN technologies/protocols. The same information written into XML instantiations of the SDT do describe sensors or appliances can also be very valuable, however, to applications in the Cloud, helping to interpret the data.
-Currently every software developed for home gateways or internet-of-things gateways needs to be capable of using various different protocols (ZigBee, UPnP, EchonetLite, DECT ULE, etc) to interact with a range of devices designed for the home environment. This adds extreme overheads in integrating, checking and updating code. The purpose of SDT is to describe devices and device services in a way which is independent of the LAN technology, in a format which is convenient and reliable for integration in modern code (Java, C/C++, ...).
+## Definitions
-In general a description of device (or complex appliance) behaviour can be made in many ways, with various kinds of constraints:
+This section provides an overview about the SDT 3.0 definitions and element hierarchy. Terms to be described in detail in this section are:
-1. no constraints (e.g. using OWL 2.0 or even more "flexibly" RDF)
-2. moderate constraints (e.g. using XML and a related extensible XSD template)
-3. strict constraints (typical for a device certified to interoperate with a specific LAN protocol)
+| Term | Definition |
+|------|------------|
+|Domain | Unique name, or "wrapper" which acts like a namespace, set by the organization creating the SDT, allowing reference to a package of definitions for the contained ModuleClasses and device definitions. Can be referenced when extending ModuleClasses. It has two possible uses: to select the scope of a technology domain, or to set the scope of a use case domain (like Home, SmartGrid, etc) |
+| Device | Physical, addressable, identifiable appliance/sensor/actuator. |
+| Sub-Device | A device (usually one of several) which may be embedded in a Device and/or is addressed via another Device. |
+| ModuleClass | Specification of a single service with one or more service methods, the involved abstracted data model and related events. The expectation is that each separate service which may be used in many kinds of Devices (like PowerON/OFF, Open/Close, ...) will be described by a ModuleClass which can be re-used in many Device definitions. |
+| Module | Instantiation of a ModuleClass for a specific Device or SubDevice|
-HGI chose to use the approach "moderate constraints" (XSD based) because for software development it offers ease of use and a good compromise. In particular, if there are few or no constraints on control parameters then few automatic checks can be made to detect if the software parameters are appropriate for each device integrated. XML and XSD languages were chosen because they are familiar to many developers, can be parsed with common software tools, and can still be created and interpreted by humans if necessary.
+<center>**Definitions of SDT Elements.**</center>
-HGI believes that Device information models based on XML and extensible XSD need some guidelines. If every possible feature of every existing LAN technology and appliance were allowed to be described in any formally correct way, then the results would be a modern Babel, no better than today's system of widely different and wildly competing automation protocols.
+A major decision, facilitating validation of code and signalling, was to describe services (functionality) of devices in terms of ModuleClasses made up of combinations of three kinds of elements:
+
+1. DataPoints which are aspects of the Device that can be read/written,
+2. Actions which consist of more complex sequences of operations;
+3. Events which can be signalled ("published") by devices asynchronously.
-Therefore HGI proposes to recommend a certain structure (template) for the information model(s), but to allow extensions. Naturally, the more industry consensus is achieved for a single recommended template, the greater the utility for software developers (and users).
+This ModuleClass structure is shown in the figure below and is a major part of the SDT which is illustrated in detail in the following figure:
+
+<center></center>
+<center>**UML description of device functionality in terms of Actions, DataPoints and Events**</center>
-## Related aspects which are out of scope of the SDT
+## How should SDT work?
-Not directly part of this work is a related but separate aspect of every gateway software development: a "device abstraction layer" which can translate between (1) software APIs written based on a particular SDT and (2) the "commands" expected by several different LAN protocols and their hardware controllers.
+The basic concept is that a manufacturer, organisation or global SDO would define its preferred Smart Device Template, in XML, specified by and based on an XSD. Using that XSD, manufacturers or indeed hobbyists could "describe" existing or new devices by means of XML files, specifying the capabilities and the parameters needed to control the devices.
-Programmers developing a "device abstraction layer" for software in a gateway need to create run-time representations of all the recognized devices, their operations and their actual states. This internal "information model" needs to be updated in real time as the devices and the users interact. Programmers may be tempted to use the SDT structure to organize their real-time information model, adding additional information elements for the current state of each device, for some kind of "history" of commands sent/acknowledged, the user etc. This is an efficient approach BUT it must be clear that the real-time state information and history of events, etc, can NOT be represented in a pre-defined SDT not in an XML giving specific details for a device.
+Assuming that the XML files conform to the specified XSD and to some guidelines described in this document, software developers could readily create APIs able to "parse" the XML-descriptions of devices and (assuming the underlying LAN technology of the device is supported by the software/hardware environment in the gateway) operate the equipment.
+
+The key to making software reliably interoperate with various technologies is to define in the SDT a finite and convenient to use number of functions (which is the decision of the SDO which are commonly used and can therefore be reliably re-used in software for one type of device or another.
+
+For the convenience of users and developers, it would also be possible to collect the device descriptions of common "modules" (types of) appliances so that the operations of "a generic air-conditioner" could be agreed and re-used often, adapting descriptions of special models with just some special features added as local extensions. Agreeing on the definition of "a generic XYZ appliance" is rather time-consuming, so such "repository" may not become standardised, however the basic approach has huge benefits even if such an archive (also known as a "hierarchical ontology") is never formally agreed.
+
+## Related aspects which are out of scope of the SDT
The SDT defines the structure of all compliant XML descriptions. Each XML description of a specific device is definable at the time of manufacture of the device and can therefore only contain "static" information: (a) manufacturer data in the form of documentation elements and properties, (b) device capability information detailing the firmware operations and types/meanings of input/output variables.
+
+NOT directly part of this work is a related but separate aspect of every gateway software development: a "device abstraction layer" which can translate between (1) software APIs written based on a particular SDT and (2) the "commands" expected by several different LAN protocols and their hardware controllers.
+
+Programmers developing a "device abstraction layer" for software in a gateway need to create run-time representations of all the recognized devices, their operations and their actual states. This internal "information model" needs to be updated in real time as the devices and the users interact. Programmers may be tempted to use the SDT structure to organize their real-time information model, adding additional information elements for the current state of each device, for some kind of "history" of commands sent/acknowledged, the user etc.
+
+The above is an efficient approach BUT it must be clear that the real-time state information and history of events, etc, can NOT be represented in a pre-defined SDT and in the XML giving specific details for a device.
diff --git a/SDT/schema3.0/docs/SDT_Components.md b/SDT/schema3.0/docs/SDT_Components.md
index 63a275a..533da50 100644
--- a/SDT/schema3.0/docs/SDT_Components.md
+++ b/SDT/schema3.0/docs/SDT_Components.md
@@ -3,7 +3,7 @@
[Domain](#Domain)
[Device](#Device) | [SubDevice](#SubDevice)
[Property](#Property)
-[ModuleClass](#ModuleClass)
+[Module and ModuleClass](#ModuleClass)
[Action](#Action)
[DataPoint](#DataPoint)
[Event](#Event)
@@ -17,28 +17,10 @@
---
-In this document an overview about the SDT 3.0 definitions and component hierarchy is given.
-
-Various details about recommended structure for SDTs are described in the next sections. The key point to keep in mind is that HGI sought a compromise between, at the one extreme, complete flexibility (which could describe any device, of any complexity) and, at the other extreme, a rigid structure which could be 100% validated and lead to validated software APIs.
-
-A major decision, facilitating validation of code and signalling, was to describe services (functionality) of devices in terms of ModuleClasses made up of combinations of three kinds of elements:
-
-1. DataPoints which can be read/written,
-2. Actions which consist of more complex sequences of operations;
-3. Events which can be signalled ("published") by devices asynchronously.
-
-This structure shown in the following figure.
-
-
-
## SDT Overview
-The following UML diagram presents an overview of the structure (elements) of every SDT which is conformant with these guidelines. As implied in the above descriptions, there can be many different choices of the details of a SDT, each one optimized for a particular market segment and the types of devices used in that market segment. Obviously an unnecessary proliferation is counter-productive, but as long as each SDT conforms to the structure shown below then it will be possible with little or modest effort for software applications to be adapted accordingly.
-
-The reader must keep in mind that the UML diagram below is in a sense the meta-format for different possible Smart Device Templates (XSDs) for device descriptions (XMLs) of real devices - sorry about that.
-
-The followng UML diagram presents an overview about the SDT components.
+The following UML diagram presents an overview of the structure (elements) of every SDT which is conformant with these guidelines. As implied in the above descriptions, there can be many different choices of the details of a SDT, each one optimized for a particular market segment and the types of devices used in that market segment. Obviously an unnecessary proliferation is counter-productive, but as long as each SDT conforms to the structure shown below then it will be possible with little or modest effort for software to be adapted accordingly.
@@ -46,11 +28,6 @@ The key to the diagram elements of the UML diagrams above and the snippets in th
-The syntax used in the diagram to model an XML Schema Definition (XSD) as an UML diagram follows the following approaches:
-
-- [Design XML schemas using UML](http://www.ibm.com/developerworks/library/x-umlschem/)
-- [UML For W3C XML Schema Design](http://www.xml.com/pub/a/2002/08/07/wxs_uml.html)
-
## Components
@@ -79,12 +56,10 @@ It can also be used to collect all specified [ModuleClasses](#ModuleClasses)
xmlns="http://homegatewayinitiative.org/xml/dal/3.0"
id="org.homegatewayinitiative">
<Doc>Some documentation</Doc>
-
<Imports>
<!-- Import other SDTs via XInclude's include mechanism -->
<xi:include href="./dal-core.xml" parse="xml" />
</Imports>
-
<Modules>
<!-- List of Domain global Modules goes here -->
</Modules>
@@ -166,7 +141,7 @@ An example for a compound device is a connected power-strip where each of the s
---
<a name="Property"/></a>
-### Property
+### Property : Element of a *Device* or *ModuleClass*
@@ -194,7 +169,7 @@ Since the *Properties* are highly varied, depending on industry segment, no atte
---
<a name="ModuleClass"/></a>
-### Module, ModuleClass
+### Module and ModuleClass
@@ -202,7 +177,7 @@ Since the *Properties* are highly varied, depending on industry segment, no atte
*Module* elements are basically constraints or templates for how to model functionality of real things/appliances/devices within the [Domain](#Domain). There could be an infinite number of possible functionalities, however it is recommended to identify a not-too-large selection of them as generic examples (called *"*ModuleClasses*, see below) and allow for additional proprietary extensions. In a particular [Domain](#Domain) there will be one *Module* for each of the agreed *ModuleClasses* plus additional ones for each extension of a *ModuleClass*.
-The advantage of identifying a subset of generic *ModuleClasses* is that any suitable high-level software would then be able to "parse" the generic functionality for all compliant appliances, even if the proprietary parts could not be interpreted by the software.
+The advantage of identifying a subset of generic *ModuleClasses*, described below, is that any suitable high-level software would then be able to "parse" the generic functionality for all compliant appliances, even if the proprietary parts could not be interpreted by the software.
Every [Device](#Device) can then be described by a collection of *Modules* (functionality). In the simplest examples, where there are no extensions needed, each *ModuleClass* has exactly one "child" Module ... in such cases the software developer can consider the two terms to be the same.
@@ -225,7 +200,7 @@ Typical *ModuleClasses* might be equivalent to "power ON/OFF", "Open/Close", "Pa
The element has the following attributes:
- **domain** : Identifier / Reference of the [Domain](#Domain) of the extended *ModuleClass*. Required for this element.
- **class** : Name of the *ModuleClass* in the [Domain](#Domain) that is extended. Required for this element.
-- **[Properties](#Property)** : Further meta-data (or properties) about the *SubDevice*. Optional.
+- **[Properties](#Property)** : Further meta-data (or properties) about the *Module* or *ModuleClass*. Optional.
- **[Actions](#Action)** : A list of *Action* components, each defining a single action. Optional.
- **[Data](#DataPoint)** : A list of *DataPoint* components. Optional.
- **[Events](#Event)** : A list of *Event* components. Optional.
@@ -247,8 +222,52 @@ The element has the following attributes:
---
+<a name="DataPoint"/></a>
+### DataPoint : Element of *ModuleClass* and *Event*
+
+
+
+A *DataPoint* element represents an aspect of a device which can be read/written to, and forms part of a device’s data model. Manipulating *DataPoints* is the most common way of controlling devices. Each *DataPoint* has an associated *type* (e.g. simple integer/real numbers, string of text, struct, or arrays thereof) which facillitates data integrity. Note that all RESTful systems (e.g. CoAP) use only *DataPoint* operations, so the mapping of a data models using an SDT into RESTful applications is easy.
+
+However, *DataPoints* are not the only way of controlling devices, so further [Actions](#Action) and [Events](#Event) are described below.
+
+Though *DataPoints* only refer to single data points of a physical device it is possible to describe hierarchies by model the path to the data point in the hierarchy by a path-like structure like to the pathname of a UNIX file system. Here, the root node of the hierarchy is a slash (/ 0x2F) and the segments or nodes along the path are also separated by slashes. The actual datapoint is the last leaf at the path.
+
+In EBNF:
+
+ name = dataPointName | "/" path ;
+ path = segment "/" path | dataPointName ;
+ segment = string ;
+ dataPointName = string ;
+ string = (* character string excluding the character "/" *) ;
+
+
+#### Attributes
+- **name** : The name (and possible path in a hierarchical data model) of the *DataPoint*. The name must be unique in the scope of the [ModuleClass](#ModuleClass). Required.
+- **optional**: Boolean that indicates whether a *DataPoint* is optional or mandatory. Optional, the default is *false*.
+- **writable** : Boolean value that indicates whether this *DataPoint* is writable by an application. Optional. Default: true.
+- **readable** : Boolean value that indicates whether this *DataPoint* is readable by an application. Optional. Default: true.
+- **eventable** : Boolean value that indicates whether an internal or external change of this *DataPoint* raises an event. Optional. Default: false.
+
+#### Elements
+- **[Doc](#Documentation)** : Documentation for the *DataPoint*. Optional.
+- **[DataType](#DataType)** : The type of the *DataPoint*. It must comply to the *DataType* definition. Required.
+
+#### Example
+
+ <Data>
+ <DataPoint name="attributeName" writable="false">
+ <Doc>Some documentation for the DataPoint</Doc>
+ <DataType>
+ <SimpleType type="string" />
+ </DataType
+ </DataPoint>
+ </Data>
+
+---
+
<a name="Action"/></a>
-### Action
+### Action : Element of *ModuleClass*
@@ -265,6 +284,7 @@ Note that systems which rely on RESTful operations need to carry out such comple
- **[DataType](#DataType)** : The return type of the *Action*. It must comply to the *DataType* definition. Optional. If no *DataType* is specified the *Action* does not return a value.
- **Args** : Zero or more occurances of [argument](#Arg) definitions for an *Action*. Optional.
+<a name="ActionExample"/></a>
#### Example
The following are two examples for actions implementing a getter and a setter for boolean values.
@@ -286,7 +306,7 @@ The following are two examples for actions implementing a getter and a setter fo
---
<a name="Arg"/></a>
-### Arg
+### Arg : Element of *Action*
@@ -301,54 +321,13 @@ The *Arg* has the following attributes and elements:
- **[Doc](#Documentation)** : Documentation for the *argument*. Optional.
- **[DataType](#DataType)** : The return type of the *argument*. It must comply to the *DataType* definition. Required.
----
-
-<a name="Data"/></a>
-### DataPoint
-
-
-
-A *DataPoint* element represents an aspect of a device which can be read/written to, and forms part of a device’s data model. Manipulating *DataPoints* is the most common way of controlling devices. Each *DataPoint* has an associated *type* (e.g. simple integer/real numbers, string of text, struct, or arrays thereof) which facillitates data integrity. Note that all RESTful systems (e.g. CoAP) only use *DataPoint* operations, so the mapping of a data models using an SDT into RESTful applications is easy.
-
-However, *DataPoints* are not the only way of controlling devices, so further "Actions" and "Events are described below.
-
-Though *DataPoints* only refer to single data points of a physical device it is possible to describe hierarchies by model the path to the data point in the hierarchy by a path-like structure like to the pathname of a UNIX file system. Here, the root node of the hierarchy is a slash (/ 0x2F) and the segments or nodes along the path are also separated by slashes. The actual datapoint is the last leaf at the path.
-
-In EBNF:
-
- name = dataPointName | "/" path ;
- path = segment "/" path | dataPointName ;
- segment = string ;
- dataPointName = string ;
- string = (* character string excluding the character "/" *) ;
-
-
-#### Attributes
-- **name** : The name (and possible path in a hierarchical data model) of the *DataPoint*. The name must be unique in the scope of the [ModuleClass](#ModuleClass). Required.
-- **optional**: Boolean that indicates whether a *DataPoint* is optional or mandatory. Optional, the default is *false*.
-- **writable** : Boolean value that indicates whether this *DataPoint* is writable by an application. Optional. Default: true.
-- **readable** : Boolean value that indicates whether this *DataPoint* is readable by an application. Optional. Default: true.
-- **eventable** : Boolean value that indicates whether an internal or external change of this *DataPoint* raises an event. Optional. Default: false.
-
-#### Elements
-- **[Doc](#Documentation)** : Documentation for the *DataPoint*. Optional.
-- **[DataType](#DataType)** : The type of the *DataPoint*. It must comply to the *DataType* definition. Required.
-
#### Example
-
- <Data>
- <DataPoint name="attributeName" writable="false">
- <Doc>Some documentation for the DataPoint</Doc>
- <DataType>
- <SimpleType type="string" />
- </DataType
- </DataPoint>
- </Data>
+See [example above](#ActionExample).
---
<a name="Event"/></a>
-### Event
+### Event : Element of *ModuleClass*
@@ -378,26 +357,20 @@ In EBNF:
---
<a name="Data_Types"/></a>
-### Data Types
+### DataType
The data type can be simple integers or string text, or rather complex, as shown below:
The various elements are described in the sections below.
----
-
-<a name="DataType"/></a>
-### DataType
-
-
The *DataType* element is a "container" for the various aspects of a type.
#### Attributes
- **name** : The name of the *DataType*. The name must be set for the [Struct](#Struct) types to distinguish individual fields in that structure. It can be used in other cases. Optional.
-- **unitOfMeasure** : This is the option to label the data with the units of measurement. A "Temperature" measurement is meaningless until the units Kelvin, Celcius, Fahrenheit etc are known. Because of the extreme variety of units, a string field is the default annotation method, although of course a SDO could decide to reference a standardized list of units. Optional.
+- **unitOfMeasure** : Before considering the type of data in detail, there is the option to label the data with the units of measurement. A "Temperature" measurement is meaningless until the units Kelvin, Celcius, Fahrenheit etc are known. Because of the extreme variety of units, a string field is the default annotation method, although of course a SDO could decide to reference a standardized list of units. Optional.
#### Elements
- **[Doc](#Documentation)** : Documentation for the *DataType* Element. Optional.
@@ -426,12 +399,20 @@ The *Constraint* element is an optional element allowing the manufacturer to pro
---
+### TypeChoice : Construct of *DataType*
+
+ 
+
+The *TypeChoice* construct is required for syntactic reasons in the UML diagram and the choice from the enumerated list simply designates the complexity of the following DataType.
+
+---
+
<a name="SimpleType"/></a>
-### SimpleType
+### SimpleType : Element of *TypeChoice*
-The "SimpleType" element is required in order for software to understand the format of the associated data, e.g. are the bytes an integer or real value? The selection choosen is based on practical experience to include some specific types which are slightly more complex:
+The *SimpleType* element is required in order for software to understand the format of the associated data, e.g. are the bytes an integer or real value? The selection choosen by HGI is based on practical experience to include some specific types which are slightly more complex:
1. the (technically redundant) options of *date* and *time* - to avoid problems which can arise interpreting a *datetime* value;
2. *url* because it is expected to become extremely common to provide links to other data sources;
@@ -454,7 +435,7 @@ If not stated otherwise datatypes should comply to the equivalent datatypes defi
---
<a name="StructType"/></a>
-### StructType
+### StructType : Element of *TypeChoice*
@@ -467,7 +448,7 @@ The *StructType* element can be used to represent an ordered list of diverse Dat
---
<a name="ArrayType"/></a>
-### ArrayType
+### ArrayType : Element of *TypeChoice*
@@ -479,8 +460,11 @@ The *ArrayType* element is provided for defining lists of data; the definition i
---
<a name="Documentation"/></a>
-# Documentation
-The *Doc* documentation element is optionally available in most components of the SDT. Its purpose is to provide a short documentation for the respective element. The documentation language *should* be English.
+### Doc : Element for all Documentation
+
+
+
+*Doc* elements (optional for all the above Elements) are very important to help understand the software-readable information for specific devices and services. They contain the human-readable information. Many automation protocols describe every possible operation in a comprehensive specification, however SDT is designed to include the relevant information at the "point of use" for the software developer, inside the SDT (and XML files based on it).
The text inside the *Doc* element can be structure using a very limited subset of HTML elements. The possible structuring is defined in EBNF as follows:
diff --git a/SDT/schema3.0/docs/images/MC.Action.DataPoint.Event.png b/SDT/schema3.0/docs/images/MC.Action.DataPoint.Event.png
new file mode 100644
index 0000000000000000000000000000000000000000..db3c9f52e1f4d0ad4ab3177f9c25f0cd9aaf9480
GIT binary patch
literal 37326
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
U?;Ve~0H}|VzNucNuFK>90n&+T_5c6?
literal 0
HcmV?d00001
diff --git a/SDT/schema3.0/docs/images/SDT_simplified.png b/SDT/schema3.0/docs/images/SDT_simplified.png
new file mode 100644
index 0000000000000000000000000000000000000000..041738b3536a9d7454aaf2a024f0c76a8c33a22e
GIT binary patch
literal 37105
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
literal 0
HcmV?d00001
--
GitLab