SAREF4ENER: an extension of SAREF for the energy domain created in collaboration with Energy@Home and EEBus associations

Latest version:
https://saref.etsi.org/saref4ener/
Permanent IRI for this version (v1.1.2)
https://saref.etsi.org/saref4ener/v1.1.2/
ETSI Technical Specification
https://www.etsi.org/deliver/etsi_ts/103400_103499/10341001/01.01.02_60/ts_10341001v010102p.pdf
Sources on the SAREF Forge
https://saref.etsi.org/sources/saref4ener/
Publication Date
2020-06-04
Last Modification Date
2016-12-13
Creators
Ontology requirements and tests
requirements and tests
Imported Ontologies
<https://saref.etsi.org/core/v3.1.1/>
Prefix and namespace declaration:
Turtle: @prefix s4ener: <https://saref.etsi.org/saref4ener/> .
SPARQL: PREFIX s4ener: <https://saref.etsi.org/saref4ener/>
Download serialization:
License:

Abstract

The present document is a technical specification of SAREF4ENER, an extension of SAREF [2] that was created in collaboration with Energy@Home (http://www.energy-home.it) and EEBus (http://www.eebus.org/en), the major Italy- and Germany-based industry associations, to enable the interconnection of their (different) data models.

Introduction

General Overview

An overview of the SAREF4ENER ontology is provided in Figure 1, where rectangles containing an orange circle are used to denote classes created in SAREF4ENER, while rectangles containing a faded orange circle denote classes reused from other ontologies, such as SAREF. For all the entities described in the present document, it is indicated whether they are defined in the SAREF4ENER extension or elsewhere by the prefix included before their identifier, i.e. if the element is defined in SAREF4ENER the prefix is s4ener:, while if the element is reused from another ontology it is indicated in the Namespace Declarations section.

Arrows with white triangles on top represent the rdfs:subClassOf relation between two classes. The origin of the arrow is the class to be declared as subclass of the class at the destination of the arrow.

Directed arrows are used to represent properties between classes.

Rectangles that contain a list of values between square brackets denote an enumeration of individuals.

Note that Figure 1 aims at showing a global overview of the main classes of SAREF4ENER and their mutual relations. More details on the different parts of Figure 1 are provided below.

SAREF Overview
Figure 1: SAREF4ENER overview

Figure 2 shows the hierarchy of classes and properties defined in SAREF4ENER.

Orange circles represent classes of SAREF4ENER, while faded orange circles represent classes that are reused from other ontologies. Object properties - which are properties between two classes - are denoted by blue rectangles, while datatype properties - which are properties between a class and a data type, such as xsd:string or xsd:dateTime - are denoted by green rectangles. Faded blue and green rectangles denote object properties and datatype properties that are reused from other ontologies.

SAREF4ENER class and property hierarchy
Figure 2: SAREF4ENER class and property hierarchy

Device

A s4ener:Device is a subclass of a saref:Device, i.e. it inherits the properties of the more general saref:Device and extends it with additional properties that are specific for SAREF4ENER. The s4ener:Device class is shown in Figure 3.

Device class
Figure 3: Device class

Power Profile and Alternatives Group

This clause presents the classes of interest for smart energy management. These classes are used to schedule devices in certain modes and preferred times using power profiles to optimize energy efficiency and accommodate the customer's preferences (i.e. use case 2). These classes are s4ener:PowerProfile, s4ener:Alternative, s4ener:PowerSequence and s4ener:Slot, which are shown in Figure 4.

A s4ener:PowerProfile is a subclass of a saref:Profile, i.e. it inherits the properties of the more general saref:Profile extending it with additional properties that are specific for SAREF4ENER. The s4ener:PowerProfile is used by a s4ener:Device to expose the power sequences that are potentially relevant for the CEM. A s4ener:Device can expose a s4ener:PowerProfile, which consists of one or more alternative plans (s4ener:AlternativesGroup class). A s4ener:AlternativesGroup consists of one or more power sequences (s4ener:PowerSequence class), and a s4ener:PowerSequence consists of one or more slots (s4ener:Slot class). Inversely, a s4ener:Slot belongs to only and exactly one s4ener:PowerSequence, which, in turn, belongs to only and exactly one s4ener:AlternativesGroup, which, in turn, belongs to only and exactly one s4ener:PowerProfile. A s4ener:PowerProfile belongs to only and exactly one s4ener:Device.

Power Profile and Alternatives Group
Figure 4: Power Profile and Alternatives Group

Power Sequence

The s4ener:AlternativesGroup consists of one or more power sequences (s4ener:PowerSequence class) and, inversely, a s4ener:PowerSequence belongs to only and exactly one s4ener:AlternativesGroup. Figure 5 shows the details of the s4ener:PowerSequence class.

Power Sequence
Figure 5: Power Sequence

Slot

The s4ener:PowerSequence consists of one or more slots (s4ener:Slot class) and, inversely, a s4ener:Slot belongs to only and exactly one s4ener:PowerSequence. Figure 6 shows the details of the s4ener:Slot class.

Slot
Figure 6: Slot

Load control

This clause presents the part of SAREF4ENER that defines how to model events used in, for example, a direct load management and power curtailing scenarios (i.e. use case 4). The classes of interest are s4ener:LoadControlEventData, s4ener:LoadControlEventAction, s4ener:LoadControlStateData and s4ener:LoadControlState, as shown in Figure 7.

The s4ener: LoadControlEventData class is used to represent overload warning severity level and related load control commands to a device. It is characterized by an event ID and a timestamp that represents the time the event information instance was created or received, and the time period that denotes the period of validity of the event. For example, 5 minutes ago an event was received which says that it shall take effect tomorrow from 14:00 to 15:30. In this event the timestamp is "5 minutes ago" and time period is "tomorrow from 14:00 to 15:30".

The s4ener:LoadControlEventAction class expresses the type of actions to be performed as a consequence of a load control event. A s4ener:LoadControlEventAction can be of type "consume" or "produce" to denote consumption or production of energy or power. Values for both consume and produce actions can be s4ener:emergency, s4ener:increase, s4ener:normal, s4ener:pause, s4ener:reduce, s4ener:resume.

The s4ener: LoadControlStateData class expresses the data about the state of an event and is characterized by the same event ID used in the s4ener:LoadControlEventData class, as well as a timestamp, and it is associated to the class s4ener:LoadControlState, which can be of type "consume" or "produce" - analogously to a load control event action – and expresses the possible states of a load control event. Values for both consume and produce load control states can be s4ener:eventAccepted, s4ener:eventStarted, s4ener:eventStopped, s4ener:eventRejected, s4ener:eventCancelled, or s4ener:eventError.

Load control
Figure 7: Load control

Namespace Declarations

owl:
http://www.w3.org/2002/07/owl#
rdf:
http://www.w3.org/1999/02/22-rdf-syntax-ns#
saref:
https://saref.etsi.org/core/
xsd:
http://www.w3.org/2001/XMLSchema#
dcterms:
http://purl.org/dc/terms/
rdfs:
http://www.w3.org/2000/01/rdf-schema#
vann:
http://purl.org/vocab/vann/
s4ener:
https://saref.etsi.org/saref4ener/

Classes

Activation delay back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActivationDelay

The scheduled activation delay for a slot.

Activation delay duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActivationDelayDurationDescription

The duration description for the activation delay duration temporal entity

Active duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActiveDurationDescription

The duration description for the active duration (min and max, sum max and sum min) temporal entities

Active duration max back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActiveDurationMax

The active maximum duration a power sequence can run without interruption.

Active duration min back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActiveDurationMin

The active mininum duration a power sequence can run without interruption.

Active duration sum max back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActiveDurationSumMax

The active maximum duration a power sequence can run in total (summation of all active times).

Active duration sum min back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActiveDurationSumMin

The active minimum duration a power sequence must run in total (summation of all active times).

Actuator level back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActuatorLevel

Independent from the ActuatorSwitch class, the ActuatorLevel class enables a user or application to model LEVEL commands (start, up, percentageAbsolute, relative, etc.). This can be used to dim a light, set the speed of an electric motor, etc.

has super-classes
saref:Actuatorc

Actuator switch back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ActuatorSwitch

Basic on/off operations on a simple actuator can be modelled with the ActuatorSwitch class. Whether the function turns a device itself ON or OFF, or whether it switches a specific feature, depends on the implementation. For example, one could model the super freeze program of a freezer using ActuatorSwitch class. An ON command would then activate the super freeze program and an OFF command would deactivate it. This example shall just give an idea how ActuatorSwitch can be used for more purposes than only turning devices on and off.

has super-classes
saref:Actuatorc

Alternatives group back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/AlternativesGroup

A collection of power sequences for a certain profile

Anticipation duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/AnticipationDurationDescription

The duration description for the anticipation duration temporal entities

Default duration back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/DefaultDuration

The duration of a slot (SHALL be present in case of 'determined slot'). If a slot has a configurable lenght, this element SHALL reflect the currently configured lenght

Default duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/DefaultDurationDescription

The duration description for the default duration temporal entity

Device back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/Device

A specialization of a saref:Device that exposes a power profile with power sequences to the CEM (note that a s4ee:Device can also be called 'power sequence server'). Most of the existing devices can expose at most 1 power profile, but there are special cases in which more than one power profiles can be exposed by the same device. For example, consider the case of a combined fridge-freezer in which there are 2 logical devices (fridge and freezer) combined in 1 physical device. This combined device can expose 2 power profiles, one for the fridge and one for the freezer. A s4ee:Device (e.g. a household appliance or a smart meter) can also receive events about overload warning severity level and related load control commands (LoadControlEventData)

Duration uncertainty back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/DurationUncertainty

The uncertainty of the duration

Duration uncertainty description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/DurationUncertaintyDescription

The duration description for the duration uncertainty temporal entity

Earliest start time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EarliestStartTime

The earliest possible start time for a power sequence or a slot. Only 'xs:duration' value types SHALL be used to denote a relative time which relates to 'now' as time 0.

Note: This element applies to the first repetition of the slot number only.

Elapsed slot time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ElapsedSlotTime

If state is set to 'running' or 'paused' AND the slot is determined, this element CAN contain the time the slot has already been in 'running' state (this also means the value remains constant during a 'paused' state). Otherwise it SHALL be omitted.

End time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EndTime

The endTime of a power sequence. If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted.

The end time of a slot MAY be stated in this element. The following equation SHALL apply: endTime - startTime = defaultDuration.

End time duration Description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EndTimeDurationDescription

The duration description for the end time duration temporal entities

Energy back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/Energy

Energy type and value in a slot (i.e., Energy, EnergyMin, EnergyMax, EnergyExpected, EnergyStandardDeviation, EnergySkewness); or the ResumeEnergyEstimated in a power sequence, i.e., the additional energy the device will consume before resuming its normal operation (after a pause)

Energy expected back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EnergyExpected

A possible type of energy in a slot that represents the expected energy consumption and its value

has super-classes
s4ener:Energyc

Energy max back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EnergyMax

A possible type of energy in a slot that represents the maximum energy consumption and its value

has super-classes
s4ener:Energyc

Energy min back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EnergyMin

A possible type of energy in a slot that represents the minimum energy consumption and its value

has super-classes
s4ener:Energyc

Energy skewness back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EnergySkewness

A possible type of energy in a slot that represents the energy skewness and its value

has super-classes
s4ener:Energyc

Energy Standard Deviation back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EnergyStandardDeviation

A possible type of energy in a slot that represents the energy standard deviation and its value

has super-classes
s4ener:Energyc

Event action consume back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EventActionConsume

An action type used to express a consume action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Event action produce back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EventActionProduce

An action type used to express a produce action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Event state consume back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EventStateConsume

In the load control, it expresses a consume state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Event state produce back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/EventStateProduce

In the load control, it expresses a produce state of an event an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Latest end time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/LatestEndTime

The latest possible end time for a power sequence or a slot. Only 'xs:duration' value types SHALL be used to denote a relative time which relates to 'now' as time 0.

Note: This element applies to the first repetition of the slot number only.

Load Control event action back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/LoadControlEventAction

An action type used to express the action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Load control event data back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/LoadControlEventData

An event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Load control event state back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/LoadControlEventState

In the load control, it expresses the possible states of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Load control state data back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/LoadControlStateData

The representation of the state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Max activation delay back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/MaxActivationDelay

Maximum delay time between the end of the previous slot and the beginning of the current slot.

Max anticipation back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/MaxAnticipation

This field allows the anticipation of the phase if (and only if) the previous phase has the energy set to 0 Wh, each unit is a minute.

Max duration back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/MaxDuration

If a slot has a configurable duration, it SHALL be present and denote the maximum supported configuration. Note: This element applies to the first repetition of the slot number only

Min duration back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/MinDuration

If a slot has a configurable duration, it SHALL be present and denote the minimum supported configuration. Note: This element applies to the first repetition of the slot number only.

Pause duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PauseDurationDescription

The duration description for the pause duration (max and min) temporal entities

Pause duration max back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PauseDurationMax

The maximum duration a power sequence can pause after the end of an activity.

Pause duration min back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PauseDurationMin

The minimum duration a power sequence can pause after the end of an activity.

Pause time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PauseTime

The pause time of a power sequence or a slot

Power back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/Power

Power type and value in a slot (i.e. power, powerMin, powerMax, powerExpectedValue, powerStandardDeviation, powerSkewness)

Power expected back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerExpected

A possible type of power in a slot that represents the expected power consumption and its value

has super-classes
s4ener:Powerc

Power max back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerMax

A possible type of power in a slot that represents the maximum power consumption and its value

has super-classes
s4ener:Powerc

Power min back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerMin

A possible type of power in a slot that represents the minimum power consumption and its value

has super-classes
s4ener:Powerc

Power profile back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerProfile

A way to model curves of power and energy over time, which also provides definitions for the modelling of power scheduling including alternative plans. With a PowerProfile, a device (or power sequences server) exposes the power sequences that are potentially relevant for the CEM (or power sequences client).

Power sequence back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerSequence

The specification of a task, such as wash or tumble dry, according to user preferences and/or manufacturer's settings for a certain device. It is the most 'coarse' view, a power sequence can represent all single steps of a whole task,where the single steps are represented by slots. If the power sequence is pausable by the bound power sequences client, the property 'saref:isInterruptionPossible' SHALL be present and set to true. Otherwise it SHALL be omitted. If the power sequence is stoppable by the bound power sequences client, the property 'saref:isFlexible' SHALL be present and set to true. Otherwise it SHALL be omitted.

Power sequence state back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerSequenceState

The current state of the power sequence. It can assume one of the values 'running', 'paused', 'scheduled', 'scheduled paused', 'pending', 'inactive', 'completed', or 'invalid'.

Power skewness back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerSkewness

A possible type of power in a slot that represents the power skewness and its value

has super-classes
s4ener:Powerc

Power standard deviation back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/PowerStandardDeviation

A possible type of power in a slot that represents the power standard deviation and its value

has super-classes
s4ener:Powerc

Remaining pause time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/RemainingPauseTime

The duration that the current slot (s4ee:activeSlotNumber) permits being paused. This element SHALL ONLY be present if the power sequence is interruptible. Otherwise, it SHALL be omitted. In case the power sequence is interruptible the following rules apply: If the element is absent this means there is no explicit pause duration restriction for the current slot; a value of 0s denoted the slot does not permit being paused.

Remaining slot time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/RemainingSlotTime

If state is set to 'running' or 'paused' AND the slot is determined, this element SHALL contain the time the slot still needs to be in 'running' state (this also means the value remains constant during a 'paused' state). Otherwise it SHALL be omitted.

Resume cost estimated back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ResumeCostEstimated

In a power sequence the additional costs for the resumption of a device to its normal operation (after a pause).

has super-classes
saref:Pricec

Resume energy estimated back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/ResumeEnergyEstimated

In a power sequence, the additional energy the device will consume before resuming its normal operation (after a pause). This is only an estimated value which will not be added to the value stated in any slot value information.

has super-classes
s4ener:Energyc

Slot back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/Slot

The single steps of a power sequence are represented by slots. A slot is associated with a slot number (while a power sequence is associated with a power sequence identifier). The slot numbers of two power sequences should be considered independent from each other, i.e., slot number 7 of sequence 1 describes a different slot than slot number 7 of sequence 2. Therefore a slot is only uniquely identified in combination with a sequence ID.

Slot time duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/SlotTimeDurationDescription

The duration description for the slot time duration temporal entities

Start time back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/StartTime

The startTime of a power sequence or slot. SHALL be present

Start time duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/StartTimeDurationDescription

The duration description for the start time duration temporal entities

State back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/State

An entity that represents the possible states in SAREF4EE

Time period back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/TimePeriod

The time period associated with load control event data

Time period duration description back to ToC or Class ToC

IRI: https://saref.etsi.org/saref4ener/TimePeriodDurationDescription

The duration description for the time period duration temporal entities

Object Properties

belongs to back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/belongsTo

A relationship identifying the ownership of an entity. In particular, a slot belongs to a power sequence, a power sequence belongs to an alternative, an alternative belongs to a power profile, a power profile belongs to a device.

exposes back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/exposes

A relationship between a device and its power profile

has applied event action consume back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasAppliedEventActionConsume

A relationship between the state of a load control event consume and the action to be performed as a consequence of this event.

has applied event action produce back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasAppliedEventActionProduce

A relationship between the state of a load control event produce and the action to be performed as a consequence of this event.

has connection back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasConnection

In the Remote Network Management (RemoteNWM) use case, a relationship between a node in a network (i.e., a s4ee:Device) and its connections (i.e., a s4ee:DeviceConnections). The same s4ee:Device (or node) can have multiple device connections as it can be connected to several networks at the same time.

has device back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasDevice

A relationship between a load control event (used to send overload warning severity level and related load control commands) and the device interested by this event.

has energy back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasEnergy

A relationship between a power sequence and its energy (in terms of value and unit of measure)

has range
s4ener:Energyc

has energy value type back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasEnergyValueType

A relationship representing an energy value type

has super-properties
s4ener:hasValueTypeop

has event state consume back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasEventStateConsume

A relationship between the specification of the state of a load control event consume and the value that this state can assume.

has super-properties
saref:hasStateop

has event state produce back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasEventStateProduce

A relationship between the specification of the state of a load control event produce and the value that this state can assume.

has super-properties
saref:hasStateop

has expression back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasExpression

A relationship between an appliance parameter compatibility action and the associated expressions

has function back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasFunction

A relationship identifying the functions performed by an actuator level and an actuator switch

has power value type back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasPowerValueType

A relationship representing a power value type

has super-properties
s4ener:hasValueTypeop

has value type back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/hasValueType

A relation representing the value type of an entity

receives back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/receives

A relationship between a device (e.g., an appliance or a smart meter) and a load control event

triggers event action consume back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/triggersEventActionConsume

A relationship between a load control event and the consume action triggered by this event

triggers event action produce back to ToC or Object Property ToC

IRI: https://saref.etsi.org/saref4ener/triggersEventActionProduce

A relationship between a load control event and the produce action triggered by this event

Data Properties

activate slot back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/activateSlot

Indicates whether a slot is used (activateSlot = true) or not (activateSlot = false). SHALL be present if a slot is optional (i.e., the property s4ee:optionalSlot is TRUE), otherwise SHALL be absent (i.e. in case the slot is mandatory).

has range
xsd:boolean

active repetition number back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/activeRepetitionNumber

Indicates the current repetition of the sequence of slots. SHALL be present if a power sequence can repeat its sequence of slots (i.e., if s4ee:repetitionTotal is present and has a value > 1). Otherwise, it SHALL be absent.

has range
xsd:unsignedInt

active slot number back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/activeSlotNumber

Indicates the currently active slot number, if the power sequence state is set to 'running' or 'paused'. Otherwise it SHALL be omitted.

has range
xsd:unsignedInt

alternatives count back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/alternativesCount

Indicates the number of alternatives groups provided by a power profile

has range
xsd:integer

alternatives group ID back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/alternativesGroupID

The endpoint-wide unique identifier for the alternatives group instances provided by a power profile

has range
xsd:integer

brand name back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/brandName

Provides the name of the brand of a device. Useful where the name of the brand and the vendor differs.

has range
xsd:string

cheapest back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/cheapest

Indicates whether a power sequence applies a configuration that minimises the user’s energy bill (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE.

has range
xsd:boolean

device code back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/deviceCode

Provides a device code for the device as defined by the manufacturer.

has range
xsd:string

device name back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/deviceName

Provides the name of the device as defined by the manufacturer.

has range
xsd:string

event ID back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/eventID

Used in the Demand Response use case to identify an event

has range
xsd:unsignedInt

greenest back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/greenest

Indicates whether a power sequence optimises the configuration towards the maximum availability of renewable energy (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE.

has range
xsd:boolean

hardware revision back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/hardwareRevision

Indicates the hardware revision of the device as defined by the manufacturer.

has range
xsd:string

is pausable back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/isPausable

Specifies if the power sequence is pausable.

has range
xsd:boolean

is stoppable back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/isStoppable

Specifies if the power sequence is stoppable.

has range
xsd:boolean

manufacturer description back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/manufacturerDescription

A description for the device as defined by the manufacturer.

has range
xsd:string

manufacturer label back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/manufacturerLabel

A short label of the device as defined by the manufacturer.

has range
xsd:string

manufacturer node identification back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/manufacturerNodeIdentification

Indicates a node identification for the device as defined by the manufacturer. This could be used for the identification of a device, even if it was removed from the network and rejoined later with changed node address.

has range
xsd:string

max cycles per day back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/maxCyclesPerDay

States the maximum amount of starts a power sequence (of a device) allows per day.

has range
xsd:unsignedInt

measurement id back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/measurementID

Enables the identification of different sensors on one EEBus address.

has range
xsd:unsignedInt

messaging number back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/messagingNumber

An identifier for one specific message. If a message is marked as obsolete, this number can be used to identify the original message.

has range
xsd:unsignedInt

messaging type back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/messagingType

Indicates the type of the message. Possible values are:

- logging (used for messages, that shall be stored in a log file)

- information (messages, that shall be presented to the customer on a display; lower priority)

- warning (messages, that shall be presented to the customer on a display; medium priority)

- alarm (messages, that shall be presented to the customer on a display; high priority; if there is an alarm device in the household, it shall generate an alarm)

- emergency (messages, that shall be presented to the customer on a display; very high priority; if there is an alarm device in the household, it shall generate an alarm; additionally, if possible and configured, an emergency call shall be done)

- obsolete (previously sent messages, that shall be marked as obsolete)

has range
{"logging", "information", "warning", "alarm", "emergency", "obsolete"}

node remote controllable back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/nodeRemoteControllable

Indicates whether the power profile of a device is configured for remote control (e.g., by an energy management system).This refers to the selection chosen by the user on the remote control feature of the device. If nodeRemoteControllable is equal to FALSE, all the supported power sequences shall set the sequenceRemoteControllable property to FALSE. If nodeRemoteControllable is equal to TRUE, at least one power sequence shall be remotely controllable by setting the sequenceRemoteControllable property to TRUE.

has range
xsd:boolean

optional slot back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/optionalSlot

Indicates whether a slot is optional (if set to TRUE). Otherwise, if a slot is mandatory, SHALL be omitted or set to FALSE. Note: This element applies to every repetition of the slot number.

has range
xsd:boolean

power source back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/powerSource

Indicates the power source of a device. Possible values are e.g. mainsSinglePhase or battery

has range
{"unknown", "mainsSinglePhase", "mains3Phase", "battery", "dc"}

repetition total back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/repetitionsTotal

Contains the total number of repetitions, if a power sequence repeats its sequence of slots. Absence of the element is equal to a presence with a value of 0 (zero). SHALL be absent if the value is 1.

has range
xsd:unsignedInt

sequence ID back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/sequenceID

Provides a unique power sequence identifier for a certain device

has range
xsd:unsignedInt

sequence remote controllable back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/sequenceRemoteControllable

Denotes whether a power sequence is modifiable (if value is TRUE) or not (if value is FALSE). Modifiability is required to configure power sequences and slots. It is also required to change a power sequence state.

has range
xsd:boolean

serial number back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/serialNumber

Indicates the serial number of a device as defined by the manufacturer. Usually the same as printed on the case.

has range
xsd:string

slot activated back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/slotActivated

If a slot is optional, represents the current status of the slot (true = the slot will be executed, false = the slot will not be executed). If the slot is not optional, this element SHALL be absent.

has range
xsd:boolean

slot number back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/slotNumber

Provides a unique slot identifier for a certain power sequence

has range
xsd:unsignedInt

software revision back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/softwareRevision

Indicates the software revision of a device as defined by the manufacturer.

has range
xsd:string

supports reselection back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/supportsReselection

If set toTRUE, the power profile of a device does not restrict the number of power sequence re-selections by the CEM, i.e. within a given alternative the CEM may first choose one power sequence, alter the selection by configuring another sequence later on, then alter the selection again, etc. (provided the process rules and data still permit configuration). If supportsReselection is set to FALSE, the device permits the CEM to select a power sequence of an alternative only once.

has range
xsd:boolean

supports single slot scheduling only back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/supportsSingleSlotSchedulingOnly

If set toTRUE, the power profile of a device does NOT permit the modification of more than one slot per configuration command.

has range
xsd:boolean

task identifier back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/taskIdentifier

Represents the task identifier of the power sequence.

has range
xsd:unsignedInt

total sequences count max back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/totalSequencesCountMax

Represents the total number of power sequences supported by the power profile of a device

has range
xsd:unsignedInt

value source back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/valueSource

Indicates the source (origin/foundation) of the measurement forecasted values for a power sequence. If absent, the source is undefined. Remark: This element shall express the reliability of the forecast.

has range
{"measuredValue", "calculatedValue", "empiricalValue"}

value tendency back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/valueTendency

Indicates whether the tendency of a measurement is rising, stable or falling.

has range
{"rising", "stable", "falling"}

vendor code back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/vendorCode

Provides a code for the vendor of the device as defined by the manufacturer.

has range
xsd:string

vendor name back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/vendorName

Provides the name of the vendor of the device as defined by the manufacturer.

has range
xsd:string

duration in xsd back to ToC or Data Property ToC

IRI: https://saref.etsi.org/saref4ener/xsdDuration

This property is added to the time:DurationDescription class to allow to express time duration also as xsd:duration. This is necessary because in the EEBus/E@h model time is always expressed as xsd:duration. We use this property to express the following time information in the EEBus/E@h model:



- the startTime of the power sequence (in the PowerSequence class). SHALL be present

- the endTime of the power sequence (in the PowerSequence class). If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted.

- the startTime of measurement as absolute or relative value (in the Measurement class).

- the endTime of measurement as absolute or relative value (in the Measurement class).



The duration is expected to be described as in xsd:duration

Named Individuals

Completed back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Completed

Power sequence state with value 'completed'

Emergency back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Emergency

Load control event action with value 'emergency'

Event accepted back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventAccepted

Load control state with value 'event accepted'

Event cancelled back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventCancelled

Load control state with value 'event cancelled'

Event error back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventError

Load control state with value 'event error'

Event rejected back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventRejected

Load control state with value 'event rejected'

Event started back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventStarted

Load control state with value 'event started'

Event stopped back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/EventStopped

Load control state with value 'event stopped'

Inactive back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Inactive

Power sequence state with value 'inactive'

Increase back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Increase

Load control event action with value 'increase'

Invalid back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Invalid

Power sequence state with value 'invalid'

Normal back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Normal

The value NORMAL used to instantiate the Load Control Event Action class and MeasurandState class

Pause back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Pause

Load control event action with value 'pause'

Paused back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Paused

Power sequence state or sensor state with value 'paused'

Pending back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Pending

Power sequence state with value 'pending'

Reduce back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Reduce

Load control event action with value 'reduce'

Resume back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Resume

Load control event action with value 'resume'

Running back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Running

Power sequence state with value 'running'

Scheduled back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/Scheduled

Power sequence state with value 'scheduled'

Scheduled paused back to ToC or Named Individuals ToC

IRI: https://saref.etsi.org/saref4ener/ScheduledPaused

Power sequence state with value 'scheduled paused'

References

Normative references

Informative references

Acknowledgements

The editors would like to thank the ETSI SmartM2M technical committee for providing guidance and expertise.

Also, many thanks to the ETSI staff and all other current and former active Participants of the ETSI SmartM2M group for their support, technical input and suggestions that led to improvements to this ontology.

Also, special thanks goes to the ETSI SmartM2M Technical Officer Guillemin Patrick for his help.

This documentation page was generated automatically using SPARQL-Generate, developed by Maxime Lefrançois. The SAREF public portal, the SAREF sources with continuous integration and deployment, the SAREF Pipeline software, and ETSI Technical Specification TS 103 673 v1.1.1 "SAREF Development Framework and Workflow, Streamlining the Development of SAREF and its Extensions", have been developed in the context of the ETSI STF 578, which followed the ETSI STF 556.