SAREF for Energy Flexibility

Latest version
https://saref.etsi.org/saref4ener/
Permanent IRI for this version (v2.1.1)
https://saref.etsi.org/saref4ener/v2.1.1/
Previous version
https://saref.etsi.org/saref4ener/v1.2.1/
ETSI Technical Specification:
https://www.etsi.org/deliver/etsi_ts/103400_103499/10341001/02.01.01_60/ts_10341001v020101p.pdf
Sources on the ETSI Forge
https://saref.etsi.org/sources/saref4ener/
Publication Date
2025-06-05
Last Modification Date
2025-06-05
Creators
Contributors
Ontology requirements and tests
requirements and tests
Imports ontologies
Examples
8 Examples
Prefix and namespace declaration
Turtle: @prefix s4ener: <https://saref.etsi.org/saref4ener/> .
SPARQL: PREFIX s4ener: <https://saref.etsi.org/saref4ener/>
Download serialization
License
Browse ontology
NOTE: The text in this section is extracted from ETSI TS 103 410-1 (V2.1.1) [0], and therefore falls inside the ETSI IPR Policy

SAREF4ENER ontology and semantics

Introduction and overview

The present document is a technical specification of SAREF4ENER, an OWL-DL ontology that extends SAREF [1] for the energy domain.

The present document was created based on the CENELEC standards EN 50631:2023, parts 1 [4], 2 [5], 3-1 [6] and 4-1 [7], and EN 50491-12-2 [8], in collaboration with the Horizon 2020 project Interconnect [i.8], and with industry associations such as EEBUS(http://www.eebus.org/), Energy@Home and the S2 consortium (https://s2standard.org/#consortium), which includes KNX (https://www.knx.org/) and the Flexible power Alliance Network (FAN, https://flexible-energy.eu/).

The EN 50631 "Household appliances network and grid connectivity" series, produced by the CENELEC/Technical Committee (CLC/TC) 59X on "Performance of household and similar electrical appliances", defines the information exchange between smart appliances and management systems in homes and buildings including energy management. Part 1 of the standard (EN 50631-1 [4]) defines the data models for interoperable connected household appliances that are derived from a logical decomposition of use cases into functional blocks. Part 2 (EN 50631-2 [5]) maps the generic use cases, use case functions, and generic data definitions to categories of appliances (e.g. washer, dishwasher, water heater, HVAC devices). Part 3-1 (EN 50631-3-1 [6]) maps the generic use case functions and data models defined in Part 1 to specific languages such as SPINE and SPINE-IoT. Part 4-1 (EN 50631-4-1 [7]) defines the Communication Protocol Specific Aspects in terms of SPINE, SPINE-IoT and Smart Home IP (SHIP).

NOTE 1:

SPINE and SPINE-IoT are used by manufacturers from the EEBUS association.

NOTE 2:

Since it is based on mappings to the SPINE language and protocol, EN 50631:2023, parts 3-1 [6] and 4-1 [7], is often referred to directly as "SPINE". The EEBUS SPINE specification used in EN 50631 is available free of charge at https://www.eebus.org/media-downloads/.

The EN 50491 "General requirements for Home and Building Electronic Systems (HBES) and Building Automation and Control Systems (BACS)" standard is produced by the CLC/TC 205 on HBES. EN 50491-12-2 [8] specifies the fundamental aspects of interoperability for the S2 interface and the related data exchange between a CEM and the Resource Managers within the home and building premises. It defines a communication standard for energy flexibility and energy management, which helps to optimize the use of energy of smart devices in homes and buildings. Energy flexibility, which can be offered by (a combination of), for example, PV systems, EV chargers, batteries, and (hybrid) heat pumps, is the ability to alter the use of energy without a significant impact on the user's comfort. Energy flexibility plays an important role in the digital energy transition.

NOTE 3:

S2 is the customer interface between the CEM in the home/building premises and the Resource Manager(s), as defined in the European Smart Grid Architecture developed in Mandate 490 of the European Commission [i.2]. Therefore, EN 50491-12-2 [8], which defines the S2 interface, is often called the "S2 standard".

NOTE 4:

The S2 standard is endorsed by the KNX and FAN industry associations. Concerning its usage, the S2 standard has been recently published (2022) and it is gaining momentum in the industry among heat pump manufactures.

NOTE 5:

Additional information about the S2 standard is available at https://s2standard.org/, including a white paper [i.5] and an S2 implementation in JSON [i.6].

The SAREF4ENER extension should be used to annotate (or generate) a neutral (protocol-independent) set of messages, for example by energy smart appliances manufacturers, to exchange information at the home/buildings premises among smart appliances, their Resource Manager (RM) and a Customer Energy Manager (CEM) to efficiently optimize energy consumption and production within the constraints set by the user.

NOTE 6:

An alternative term used for CEM is Energy Management System (EMS).

NOTE 7:

SAREF4ENER, together with SAREF core, have been adopted as common semantic model in the Code of Conduct (CoC) for Energy Smart Appliances (ESA) manufactures [i.9] promoted by the European Commission [i.8] (EC). The CoC has the goal to increase the number of interoperable ESA that are placed on the European Union market. The current CoC V1.0 has been officially launched by the EC in April 2024 and 10 manufacturers producing appliances have signed this first version, namely Arçelik, Clivet, Daikin, Electrolux, Miele, Mitsubishi Electric, Panasonic, Vaillant Group, Vestel and Viessmann. The manufacturers have committed to develop interoperable connected products within a year. In addition, a Home Energy Management System manufacturer, GEO, has committed to support compliant ESA through their products. This first CoC version includes examples of mappings from EN 50631 (SPINE) to SAREF4ENER V1.2.1. Future releases of the CoC intend to include also examples of mappings from EN 50491-12-2 [8] (S2) to SAREF4ENER. SAREF4ENER V1.1.1 was primarily based on the power profiles as defined in EN 50631:2023 parts 1 [4], 2 [5], 3-1 [6] and 4-1 [7] (SPINE). The subsequent version, SAREF4ENER V1.2.1, added new SPINE concepts not previously covered and introduced the most important concepts from EN 50491-12-2 [8] (S2), with the explicit goal of harmonizing and providing interoperability between the SPINE and S2 standards. In the meantime, a new version of SAREF core, V4.1.1, was released. Therefore, the present document, SAREF4ENER V2.1.1, aligns to the latest SAREF core release 4.1.1, yet preserving the important changes made in SAREF4ENER V1.2.1. The history of the main changes in SAREF4ENER can be found in Annex D.

The application of SAREF4ENER focuses on demand response scenarios, in which customers can offer energy flexibility to the Smart Home and Smart Grid. Energy smart devices and energy managers communicate with each other to achieve the best possible result. Energy smart devices can express their demand/production and flexibility, energy managers are responsible to find the most optimal measure between energy consumption and energy production of energy smart devices based on the customer's chosen configuration and the characteristics of the devices. Next to self-consumption optimization, the Smart Grid can influence the quantity or patterns of use of the energy consumed by customers when grid-energy-supply systems are constrained, e.g. during peak hours.

This can be realized by connecting a smart home device with an Energy Management System (EMS) (see EN 50631:2023, parts 1 [4], 2 [5], 3-1 [6] and 4-1 [7]) or by means of a Resource Manager (RM) (see EN 50491-12-2 [8]).These scenarios involve (but are not limited to) the following use cases. The SAREF4ENER parts applicable per use case are primarily decided by the types of devices that are involved:

  • Use case 1: flexible start of smart appliances. Smart energy management should be able to (re-)schedule appliances in certain modes and preferred times using power profiles to optimize energy efficiency and accommodate the customer's preferences. The user should be able to decide on a preferred interval within which the energy manager computes the starting time that optimizes the energy usage. Interruption options, such as pausing a task, can further optimize the energy usage.
  • Use case 2: monitoring and control of the start, status, and power consumption of the appliances. It is essential for an energy manager to be aware of the power consumption of all devices it optimizes for, including devices that are not smart.
  • Use case 3: reaction to special requests from the Smart Grid, for example, incentives to consume more or less depending on current energy availability, or emergency situations that require temporary reduction of the power consumption.
  • Use case 4: limitation of power consumption. This use case covers power limits that are sent by the energy manager, as well as power limits set by the manufacturer in the case of a lost connection (fail-safe limits), as well as contractual and nominal power limits.
  • Use case 5: incentive table. This use case aims to influence the energy usage via a set of incentives that the energy consumer and energy manager negotiate about.
  • Use case 6: description of the energy flexibility capabilities of any type of device in a (smart) home/building in the information exchange of such devices with resource and energy managers. Energy flexibility, which can be offered by (a combination of), for example, PV systems, EV chargers, batteries, and (hybrid) heat pumps, is the ability to alter the use of energy without a significant impact on the user's comfort [i.5].
  • Use case 7: Interoperable data exchange between a Distribution System Operator (DSO) and other market parties, such as services providers and flexibility aggregators to support:

i) network flexibility that can be used by network operators to manage the electricity grids more efficiently and to provide a potential additional revenue stream to the consumers without limiting their consumer behaviour patterns [i.12]; and

ii) increased grid observability for home appliances that are mostly passive and not actively monitored, enabling a faster identification of potential outages and electricity quality issues [i.12].

These use cases are associated with the user stories described in [i.3], which include, among others, the following examples:

  • User wants to do basic settings of his/her devices;
  • User wants to know when the washing machine has finished working;
  • User wants the washing done by 5:00 p.m. with least electrical power costs;
  • User likes to limit his/her own energy consumption up to a defined limit;
  • User allows the EMS to reduce the energy consumption of his/her freezer in a defined range for a specific time, if the grid recognizes (severe) stability issues;
  • Grid related emergency situations (blackout prevention).

The prefixes and namespaces used in SAREF4ENER and in the present document are listed in Table 1.

Prefix Namespace
dct http://purl.org/dc/terms/
foaf http://xmlns.com/foaf/0.1/
owl http://www.w3.org/2002/07/owl#
rdf http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs http://www.w3.org/2000/01/rdf-schema#
s4ener https://saref.etsi.org/saref4ener/
saref https://saref.etsi.org/core/
time http://www.w3.org/2006/time#
vann http://purl.org/vocab/vann/
xsd http://www.w3.org/2001/XMLSchema#
Table 1: Namespace Declarations

SAREF4ENER

General Overview

The main addition that SAREF4ENER provides on top of SAREF Core is a set of saref:Profiles that describe the energy flexibility capabilities of a device (see clause 4.2.3). These profiles are defined according to the SPINE/SPINE IoT [6] and the S2 [8] data models, with some profiles occurring in both [6] and [8], while some other profiles occurring either in [6] or [8]. For example, the Power Profile flexibility type is described in both S2 and SPINE/IoT, thus is merged into a single representation in SAREF4ENER (see clause 4.2.3.1). The Power Envelope defined in S2 and Power Limits defined in SPINE also present similarities which are therefore specified in SAREF4ENER using several shared concepts (see clause 4.2.3.6). The remaining types of flexibility are unique to either S2 or SPINE, namely, Incentive Tables are defined only in SPINE, whereas Operation Mode, Fill Rate Based, and Demand Driven energy flexibility are control types defined only in S2 [i.5].

The SAREF4ENER extension additionally describes flexibility instructions (see clause 4.2.5) separately from the flexibility profiles. These instructions describe the communication taking place between a device and the EMS to decide on the energy flexibility plan, such as offers from the device and requests from an EMS. A real-time check on the monitoring of power consumption is facilitated via the reuse of the main SAREF module and the load control use case (see clause 4.2.4). Finally, the SAREF4ENER extension provides a modelling approach for data points and time series (see clause 4.2.6), which is necessary for modelling the various forecasts and data elements involved.

An overview of the SAREF4ENER (V2.1.1) ontology is provided in Figure 1. In the image, classes are represented as rectangles. Relationships (object properties) between entities are represented as arrows. Arrows are additionally used to represent some RDF, RDF-S and OWL constructs, more precisely: plain arrows with white triangles represent the rdfs:subClassOf relation between two classes. The origin of the arrow shall be considered as the subclass of the entity at the destination of the arrow. Dashed arrows accompanied by the expression rdf:type are used to indicate that the individual at the origin of the arrow is an instance of the class placed at the end of the arrow. Datatype properties and class restrictions are presented as plain text and positioned within the boxes of the rectangles. The green colour is used to distinguish SAREF core entities. The blue colour is used for highlighting the classes and properties already existing in the previous version of SAREF4ENER (V1.1.2). The white colour is used to denote the classes and properties that have been added in the SAREF4ENER version specified in the present document (V2.1.1). 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 in the rest of the present document .

SAREF4ENER overview
Figure 1: SAREF4ENER overview

Device

This extension adds several properties to the existing saref:Device which may be used to describe additional device details to the basic properties already defined in SAREF core.

Table 2: Properties of a Device
Property Definition
s4ener:receives A relationship between a device (e.g. an appliance or a smart meter) and a load control event.
s4ener:brandName The name of the brand of a device. Useful where the name of the brand and the vendor differs.
s4ener:deviceCode Device code for the device as defined by the manufacturer.
s4ener:deviceName Name of the device as defined by the manufacturer.
s4ener:hardwareRevision Hardware revision of the device as defined by the manufacturer.
s4ener:manufacturerDescription A description for the device as defined by the manufacturer.
s4ener:manufacturerLabel A short label of the device as defined by the manufacturer.
s4ener:manufacturerNodeIdentification 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 re-joined later with changed node address.
s4ener:powerSource The power source of a device. Possible values are s4ener:MainsSinglePhase, s4ener:Mains3Phase, s4ener:Battery, and s4ener:DC.
s4ener:serialNumber Serial number of a device as defined by the manufacturer. Usually the same as printed on the case.
s4ener:softwareRevision Software revision of a device as defined by the manufacturer.
s4ener:vendorCode Code for the vendor of the device as defined by the manufacturer.
s4ener:vendorName Name of the vendor of the device as defined by the manufacturer.

Flexibility Profile

Foreword

The SAREF4ENER extension defines different energy flexibility profiles that can be offered by a saref:Device. They are: s4ener:PowerProfile, s4ener:PowerLimitProfile, s4ener:DemandDrivenProfile, s4ener:OperationModeProfile, s4ener:FillRateBasedProfile, s4ener:IncentiveTableBasedProfile, and s4ener:PowerEnvelopeProfile. They are all subclasses of s4ener:FlexibilityProfile which is in turn a subclass of saref:Profile.

SAREF4ENER Flexibility Profiles
Figure 2: SAREF4ENER Flexibility Profiles

Power Profile

A s4ener:PowerProfile describes the power usage of a particular task of a device that can be known or predicted beforehand, such as in the case of white goods like a washing machine. The s4ener:PowerProfile is used by a saref:Device to expose the power sequences that are potentially relevant for the energy manager. A saref: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 saref:Device.

The s4ener:AlternativesGroup consists of one or more power sequences (s4ener:PowerSequence) and, inversely, a s4ener:PowerSequence belongs to only and exactly one s4ener:AlternativesGroup. The s4ener:PowerSequence consists of one or more slots (s4ener:Slot) and, inversely, a s4ener:Slot belongs to only and exactly one s4ener:PowerSequence.

Power Profile Overview
Figure 3: Power Profile Overview
Power Profile and Power Sequence
Figure 4: Power Profile and Power Sequence
Table 3: Properties of a Power Profile and an AlternativesGroup
Property Definition
s4ener:alternativesCount Number of "alternatives" groups provided by a power profile.
s4ener:nodeRemoteControllable Whether the device is configured for remote control by the EMS. This refers to the selection chosen by the user on the remote control feature of the device.
s4ener:supportsReselection Whether the device restricts the number of sequence re-selections by the EMS. If set to TRUE, there is no restriction, i.e. within a given alternative the EMS may first choose one sequence, alter the selection by configuring another sequence later on, then alter the selection again, etc. If set to FALSE, the device permits the EMS to select a sequence of an alternative only one time.
s4ener:supportsSingleSlotSchedulingOnly Whether the device permits the modification of more than one slot per configuration command. If set to TRUE the device does NOT permit this modification.
s4ener:totalSequencesCountMax Total number of sequences supported by the device, i.e. the sum of all power sequences across all alternatives.
Table 4: Properties of the PowerSequence
Property Definition
s4ener:isStoppable If the power sequence is stoppable by the EMS, this element is TRUE. Otherwise it SHALL be omitted.
s4ener:isPausable If the power sequence is pausable by the EMS, this element is TRUE. Otherwise it SHALL be omitted.
s4ener:taskIdentifier Used by a device that wants to uniquely identify reoccurring types of power sequences. For example, specific types of washing cycles with specific parameters SHOULD have the same s4ener:taskIdentifier value every time they are offered using power sequences.
s4ener:activeRepetitionNumber The current repetition of the sequence of slots. SHALL be present if s4ener:repetitionsTotal is present and has a value > 1. Otherwise, it SHALL be absent.
s4ener:activeSlotNumber If s4ener:PowerSequenceState is set to "running" or "paused" this element SHALL contain the currently active slot. Otherwise it SHALL be omitted.
s4ener:cheapest If present and set to TRUE, the SHALL try to apply a configuration that minimizes the user's energy bill for this power sequence. Absence of this element is equal to the presence with value FALSE.
s4ener:greenest If present and set to TRUE, the SHALL try to optimize the configuration towards the maximum availability of renewable energy. Absence of this element is equal to the presence with value FALSE.
s4ener:maxCyclesPerDay The maximum amount of starts that the device allows per day.
s4ener:repetitionsTotal If a power sequence repeats its sequence of slots, the element is present and contains the total number of repetitions. Absence of the element is equal to a presence with a value of 0 (zero). SHALL be absent if the value is 1.
s4ener:sequenceRemoteControllable Whether the 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.
s4ener:valueSource The source (origin/foundation) of the forecasted values for this power sequence. If absent, the source is undefined.
s4ener:hasEnergy 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.
saref:hasPrice The additional costs for the resumption of a device to its normal operation (after a pause).
saref:hasState

The current state of the power sequence. It can assume one of the following values:

s4ener:Running, s4ener:Paused, s4ener:Scheduled, ss4ener:ScheduledPaused, s4ener:Pending, s4ener:Inactive, s4ener:Completed or s4ener:Invalid.

s4ener:hasActiveDurationMax The active maximum duration the power sequence can run without interruption.
s4ener:hasActiveDurationMin The active minimum duration the power sequence can run without interruption.
s4ener:hasActiveDurationSumMax The active maximum duration the power sequence can run in total (summation of all active times).
s4ener:hasActiveDurationSumMin The active minimum duration the power sequence runs in total (summation of all active times).
s4ener:hasStartTime The start time of the power sequence. SHALL be present.
s4ener:hasEarliestStartTime SHALL state the earliest possible start time for the whole power sequence.
s4ener:hasEndTime The end time of the power sequence. If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted.
s4ener:hasLatestEndTime The latest possible end time for the whole power sequence.
s4ener:hasElapsedSlotTime If the power sequence 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.
s4ener:hasRemainingSlotTime If the power sequence 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.
s4ener:hasPauseDurationMax The maximum duration the power sequence can pause after the end of an activity.
s4ener:hasPauseDurationMin The minimum duration the power sequence can pause after the end of an activity.
Table 5: Properties of a Slot
Property Definition
s4ener:optionalSlot It is set to TRUE if the slot can be omitted, otherwise the element SHALL be omitted or set to FALSE (see note 1).
s4ener:slotActivated If the slot is optional, i.e. s4ener:optionalSlot is set to TRUE, this element reflects 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.
s4ener:hasValueType The type of energy or power (subclasses of saref:Energy and saref:Power). The energy can be of type s4ener:EnergyMin, s4ener:EnergyMax, s4ener:EnergyExpected, s4ener:EnergyStandardDeviation or s4ener:EnergySkewness. The power can be of type s4ener:PowerMin, s4ener:PowerMax, s4ener:PowerExpected, s4ener:PowerStandardDeviation or s4ener: Power Skewness.
s4ener:hasDefaultDuration The duration of the slot (in case of 'determined slot'). If the slot has a configurable length, this element SHALL reflect the currently configured length.
s4ener:hasMaxDuration The maximum supported configuration (if the slot has a configurable duration).
s4ener:hasMinDuration The minimum supported configuration (if the slot has a configurable duration) (see note 2).
s4ener:hasDurationUncertainty The uncertainty of the duration given in the s4ener:defaultDuration property.
s4ener:hasStartTime The start time of the slot. SHALL be present.
s4ener:hasEarliestStartTime SHALL state the earliest possible start time for the slot.
s4ener:hasEndTime The end time of the slot. The following equation SHALL apply: endTime - startTime = defaultDuration.
s4ener:hasLatestEndTime The latest possible end time for the slot.
s4ener:hasRemainingPauseTime The duration that the current slot permits being paused. This element SHALL ONLY be present if the power sequence is interruptible (pausable), i.e. saref:isInterrupionPossible has value TRUE.
  • NOTE 1: This element applies to every repetition of the slot number.
  • NOTE 2: This element applies to the first repetition of the slot number only.
  • Demand Driven Profile

    The s4ener:DemandDrivenProfile can be used for devices that can consume different types of energy resources such as electricity or natural gas, but that lack a way of buffering that energy. This may for example be a hybrid heat pump that is powered using either electricity of gas. The power demand is determined by the device, but the customer energy manager can choose how to generate that power.

    The profile contains a set of saref:Actuators that describe the various ways that the demanded energy can be provided. These actuators may be (part of) the actual saref:Device that offers this profile. The forecast of the average demand rate (i.e. the amount of energy, heat, and any other resource that needs to be produced by a device in the near future) can be expressed by defining time series (s4ener:TimeSeries).

    Demand Driven Profile
    Figure 5: Demand Driven Profile
    Table 6: Property of Demand Driven Profile
    Property Definition
    s4ener:hasDemandRateForecast The relationship between the demand driven profile and the time series that indicates the forecasted average demand rate.
    s4ener:isActuatedBy A reference to an (external) actuator that can activate this profile.
    s4ener:hasDemandRate The present demand rate that needs to be satisfied by the device.
    s4ener:hasEarliestStartTime The moment from which the profile is valid.
    Table 7: Actuator of a Demand Driven Profile
    Property Definition
    s4ener:supportsCommodity A reference to all commodities by this actuator.
    s4ener:hasOperationMode This property indicates the s4flex:OperationModes that can be used by this actuator.
    s4ener:hasTransition The transitions between various s4flex:OperationModes that the Actuator can support.
    s4ener:hasTimer The set of timers that are available in this actuator.
    s4ener:hasActiveOperationMode A reference to the Operation Mode that is presently active.
    s4ener:hasOperationModeFactor The number indicates the factor with which the actuator is configured.
    s4ener:hasPreviousOperationMode The previous operation mode this actuator was in.
    s4ener:hasTransitionTimestamp Time at which the transition from the previous operation mode was initiated.
    Table 8: Operation Mode of a Demand Drive Profile
    Property Definition
    s4ener:hasPowerRange The range of power that can be produced or consumed via this operation mode. The start of the range is associated with operation mode factor 0, the end of the range is associated with operation mode factor 1.
    s4ener:hasSupplyRange The Supply Range this operation mode can deliver. The start of the range is associated with operation mode factor 0, the end of the range is associated with operation mode factor 1.
    s4ener:hasRunningCosts Additional costs per second associated with this operation mode.
    s4ener:abnormalConditionOnly Indicates if this element can only be used during an abnormal condition.

    Fill Rate Based Profile

    The s4ener:FillRateBasedProfile can be used for devices that can store energy (s4ener:Storage), such as heat pumps with a buffer, EVs, batteries, and even fridges and freezers. The saref:Actuators associated with this fill rate based profile can consume energy to fill the buffer. The information regarding the leakage behaviour of the storage and its fill level (i.e. a measure expressing how full the storage is) can respectively be defined through the classes s4ener:LeakageBehaviour and saref:Observation via the properties s4ener:hasLeakageBehaviour and s4ener:presentFillLevel, respectively. The s4ener:LeakageBehaviour is always associated with an element detailing the leakage behaviour of the storage (s4ener:LeakageBehaviourElement). Ultimately, certain storage devices might have a fill-level target profile (s4ener:FillLevelTargetProfile) with its associated s4ener:FillLevelTargetProfileElement.

    Fill Rate Based Profile
    Figure 6: Fill Rate Based Profile
    Table 9: Properties of Fill Rate Based Profile
    Property Definition
    s4ener:hasStorage The relationship between the fill rate based profile and the storage that describes energy storage details.
    s4ener:isActuatedBy A reference to an actuator that can activates this profile.
    s4ener:hasEarliestStartTime The moment this fill rate based profile becomes valid.
    Table 10: Properties of Storage
    Property Definition
    s4ener:hasLeakageBehaviour The relationship between the storage and its associated leakage behaviour.
    s4ener:presentFillLevel The property that connects the storage to a data point with a percentage value indicating the storage fill level.
    s4ener:hasFillLevelTargetProfile The property that connects the fill rate based profile to the current fill level target profile, represented as a timeseries, that the profile should accommodate for.
    s4ener:hasFillLevelRange The range in which the fill level of the storage should remain.
    s4ener:hasUsageForecast Indicates a timeseries containing the usage forecast for this fill rate based profile.
    Table 11: Properties of Leakage Behaviour
    Property Definition
    s4ener:hasLeakageBehaviourElement The property that relates the leakage behaviour to the leakage behaviour element(s).
    s4ener:hasStartTime The moment from which this leakage behaviour is valid.
    Table 12: Properties of Leakage Behaviour Element
    Property Definition
    s4ener:hasFillLevelRange The property that connects the leakage behaviour element with the range for which this leakage behaviour is applicable.
    s4ener:leakageRate Indicates how fast the fill level decreases in this particular range.

    The Actuator of a Fill Rate Based Profile is identical to Table 7.

    Table 13: Operation Mode of a Fill Rate Based Profile Actuator
    Property Definition
    s4ener:hasOperationModeElement References to the Operation Mode Elements contained within this Operation Mode.
    s4ener:abnormalConditionOnly Indicates if this element can only be used during an abnormal condition.
    Table 14: Operation Mode Element of a Fill Rate Base Profile Operation Mode
    Property Definition
    s4ener:hasFillLevelRange The range of the fill level for which this Operation Mode Element applies.
    s4ener:fillRate Indicates the change in fill level per second. The lower_boundary of the Power Range is associated with an operation mode factor of 0, the upper boundary is associated with an operation mode factor of 1.
    s4ener:hasPowerRange The power produced or consumed by this operation mode.
    s4ener:hasRunningCosts Additional costs per second (e.g. wear, services) associated with this operation mode.

    Incentive Table Based Profile

    The s4ener:IncentiveTableBasedProfile can be used to describe an incentive table, compiled of incentive table slots (s4ener:IncentiveTableSlot) as well as a power plan (s4ener:PowerPlan). Both are used to negotiate the allocation of upcoming energy usage of a device between the energy manager and the device. The incentive table is used by the energy manager to express the availability of energy via real and/or artificial incentives or costs over time. The device itself uses the table to negotiate the own demand and request the allocation by sending the resulting power plan to the energy manager.

    Incentive types can be expressed in the form of relative costs (s4ener:RelativeCost), absolute costs (s4ener:AbsoluteCost), CO2 emissions (s4ener:CO2Emission), and renewable energy percentage (s4ener:RenewableEnergyPercentage). An incentive table also defines a scope type (s4ener:ScopeType) to indicate whether it is a preliminary (s4ener:Preliminary) or committed version (s4ener:Committed).

    An incentive table consists of a number of slots (s4ener:IncentiveTableSlot) where each slot may contain a series of incentives (s4ener:Incentive) representing various tiers (s4ener:Tier). Each tier may be linked to a particular energy source, such as the grid, solar panels, or surplus power. Each incentive describes the cost, expressed as a unit applicable to the s4ener:IncentiveType, for that power source in the particular (time) slot. The lower and optional upper boundary (s4ener:DataPoint) describe for each incentive at which level of power consumption it becomes applicable.

    The power plan of a device is defined by a series of sets of data points (s4ener:TimeSeries). Each set of data points contains a time interval (time:Interval), a relation to a property (s4ener:Power), a binding to a minimum (s4ener:Minimum), average (s4ener:Average) or maximum (s4ener:Maximum) value and the value itself (saref:Observation). Finally, it also contains a scope type (s4ener:ScopeType) to indicate whether it is a preliminary (s4ener:Preliminary) or committed value (s4ener:Committed).

    An incentive table based profile can be used with any type of device.

    Incentive Table Based Profile
    Figure 7: Incentive Table Based Profile
    Power Plan associated with an Incentive Table
    Figure 8: Power Plan associated with an Incentive Table
    Table 15: Properties of Incentive Table Based Profile
    Property Definition
    s4ener:isChangeable Boolean indicating whether this incentive table is fixed or can be changed (see note).
    s4ener:requiresUpdate Boolean indicating whether the incentive table requires an update (see note).
    s4ener:hasSlot The slots that this incentive table consists of.
    s4ener:hasIncentiveType A reference to the Incentive Type like relative or absolute costs, CO2 emission or Renewables percentage.
    s4ener:hasScopeType The scope type indicates whether the incentive table is preliminary or committed.
    s4ener:hasPowerPlan A reference to a power plan indicating the preliminary or committed usage of the energy smart device for a specific period.
  • NOTE: The properties s4ener:isChangeable and s4ener:requiresUpdate can be applied on any incentive table element of clause 4.2.3.4.
  • Table 16: Properties of Incentive Table Slot
    Property Definition
    s4ener:hasIncentive The incentive indicates the tier, boundary, value, and type of value per incentive.
    s4ener:hasEffectivePeriod The time interval of the incentive slot.
    Table 17: Properties of Incentive
    Property Definition
    saref:belongsTo Reference to the tier.
    saref:isMeasuredIn The unit of measure that is applicable for this value, which may be s4ener:EuroPerKilowattHour.
    saref:hasValue The incentive value for this boundary.
    s4ener:hasLowerBoundary A reference to an s4ener:DataPoint indicating the lower boundary for this particular boundary. The value and unit of measure of the lower boundary are found in the data point object.
    s4ener:hasUpperBoundary An optional reference to an s4ener:DataPoint indicating the upper boundary for this particular boundary. If omitted, the value of the next lower boundary is assumed.
    Table 18: Properties of Power Plan
    Property Definition
    s4ener:hasTimeSeries The TimeSeries that a Power Plan consists of. There usually are three, namely one with usage of minimum values, one for expected values, and one for maximum values.
    s4ener:isWritable This Boolean value indicates whether this power plan is writable or fixed.

    Operation Mode Profile

    Devices that offer the s4ener:operationModeProfile can control the amount of power that they generate and/or consume, such as diesel generators and variable electrical resistors. The states in which devices fall in, such as "running at reduced power" or "running at full power", can be described as operation modes (s4ener:OperationMode). These operation modes have therefore been modelled as subclasses of saref:State. Transitions between operation modes can be defined as s4ener:Transition with associated timers (s4ener:Timer) that specify the minimum duration of a particular operation model.

    Operation Mode Profile
    Figure 9: Operation Mode Profile
    Table 19: Property of Operation Mode Profile
    Property Definition
    s4ener:hasOperationMode The relationship between the operation mode profile and the various operation mode it offers.
    s4ener:hasTransition The transitions between various Operation Modes that this OperationModeProfile can support.
    s4ener:hasTimer The set of timers that are available in this OperationModeProfile.
    s4ener:hasStartTime The moment this Operation Mode Profile becomes valid.
    s4ener:hasActiveOperationMode A reference to the OperationMode that is presently active.
    s4ener:hasOperationModeFactor The number indicates the factor with which the Operation Mode should be configured.
    s4ener:hasPreviousOperationMode The previous operation mode this device was in.
    s4ener:transitionTimestamp Time at which the transition from the previous Operation Mode was initiated.
    Table 20: Properties of Operation Mode
    Property Definition
    s4ener:abnormalConditionOnly The relationship between the operation mode and the boolean datatype value indicating whether the operation mode has abnormal condition.
    s4ener:hasPowerRange The power produced or consumed by this operation mode. The start of the range is associated with operation mode factor 0, the end of the range is associated with operation mode factor 1.
    s4ener:hasRunningCosts Additional costs per second (e.g. wear, services, or money) associated with this operation mode.
    Table 21: Properties of Timer
    Property Definition
    s4ener:isFinishedAt The relationship between the timer and its date-time datatype value.
    s4ener:hasDuration The time it takes for the timer to finish after it has been started.
    Table 22: Properties of Transition
    Property Definition
    s4ener:abnormalConditionOnly The relationship between the transition and the boolean datatype value indicating whether the transition can only take place with an abnormal condition.
    s4ener:hasTransitionCosts The relationship between the operation mode and the decimal datatype value indicating the transition costs from a particular operation mode to another.
    s4ener:toOperationMode The relationship between the transition and the ID of the operation mode that will be switched to.
    s4ener:fromOperationMode The relationship between the transition and the ID of the operation mode that will be switched from.
    s4ener:startsTimer The relationship between the transition and the IDs of timers that will be (re)started when this transition is initiated.
    s4ener:isBlockedBy The relationship between the transition and the IDs of timers that block this transition if not finished.
    s4ener:hasTransitionDuration Indicates the delay between the initiation of this Transition, and the time at which the device behaves according to the Operation Mode.

    Power Limitation

    Power Envelope Profile

    A saref:Device offers a s4ener:PowerEnvelopeBasedProfile when the device is operating within a minimum and maximum amount of power for energy production and/or consumption per time block, but the production or consumption cannot be directly regulated by the energy manager. A PV panels inverter is a typical example, because the energy produced is dependent on the amount of sunshine. The EMS may constrain the power production of the PV panels below its potential to lower a peak.

    The minimum and maximum amount of power that can be generated and/or spent by a device in a certain timespan can be set by instantiating the s4ener:PowerEnvelope and its corresponding s4ener:PowerConstraint. Power constraints are always bound to the allowed power limit ranges of a device (s4ener:AllowedLimitRange). The energy level of the s4ener:PowerEnvelope can be defined by using s4ener:TimeSeries. The type of the allowed limit ranges of a device (i.e. upper limit or lower limit) can be defined through the class s4ener:PowerEnvelopeLimitType. Commodity quantities relating to s4ener:PowerEnvelope can be described through the class s4ener:CommodityQuantity.

    Power Envelope Profile
    Figure 10: Power Envelope Profile
    Table 23: Property of Power Envelope Profile
    Property Definition
    s4ener:hasPowerEnvelope The Power Envelope is a specification received by a resource from an energy manager. This specification is received dynamically and conforms to the power constraints and energy constraints of the resource.
    s4ener:hasConstraints A reference to the sets of constraints that a power envelope consists of. Each set of constraint concerns either power constraints or energy constraints. A device has to have at least one set of power constraints.
    Table 24: Properties of Power Envelope
    Property Definition
    s4ener:relatesToCommodityQuantity The relationship between the power envelope and the commodity quantity this envelope constraints.
    s4ener:hasEnvelope The relationship between the power envelope and the time series indicating the actual values of the envelope.
    Table 25: Properties of Power Constraint
    Property Definition
    s4ener:allowedLimitRange The relationship between the power constraint and the allowed limit range of this constraint.
    s4ener:hasStartTime The moment this constraint becomes valid.
    s4ener:hasEndTime The moment until which this constraint is valid.
    s4ener:hasConsequenceType The consequence type of this power constraint, which can be Vanish or Defer. This indicates whether surplus power is wasted (s4ener:Vanish) or stored (s4ener:Defer).
    Table 26: Properties of Energy Constraint
    Property Definition
    s4ener:rangeBoundary The range of the average consumed power during this time period.
    s4ener:hasStartTime The moment this constraint becomes valid.
    s4ener:hasEndTime The moment until this constraint is valid.
    s4ener:relatesToCommodityQuantity The commodity quantity this energy constraint applies on.
    Table 27: Property of Allowed Limit Range
    Property Definition
    s4ener:abnormalConditionOnly The relationship between the power constraint and the boolean datatype value indicating whether the power constraint has an abnormal condition.
    s4ener:limitType The relationship between the allowed limit range and the power envelope limit type, which can be upper or lower limit.
    s4ener:relatesToCommodityQuantity The commodity quantity this allowed limit range relates draws its energy or power from.
    s4ener:rangeBoundary The range indicating the boundaries of this allowed limit range.
    Power Limit Profile

    SAREF4ENER further specifies allowed limit ranges through the classes s4ener:ContractualPowerLimit, s4ener:NominalPowerLimit, and s4ener:FailsafePowerLimit. They are all subclasses of s4ener:PowerLimit which is the general upper-class of power limits. Power limits can be toggled active or inactive via the s4ener:isActive property. A device has nominal power consumption and/or production values (s4ener:NominalPowerLimit) when the manufacturers define quantifiable and measurable limits that has not to be exceeded. The failsafe values provided by the manufacturers has to be given as instances of saref:Observation. In case the communication between a device and the energy manager is interrupted, the device enters a fail-safe state (s4ener:FailsafeState). Fail-safe values (s4ener:FailsafePowerLimit) apply until the communication is re-established, with an optional minimal duration of the fail-safe state given in the s4ener:hasFailsafeDuration. Ultimately, a saref:Device is always bound to a s4ener:ContractualPowerLimit (which is defined in a specification by the manufacturers) and limited by a s4ener:FailsafePowerLimit.

    Power Limit Profile
    Figure 11: Power Limit Profile
    Table 28: Power Limit Profile
    Property Definition
    s4ener:receivesPowerLimit The Power Limit received by the device from an energy manager that conforms to the other power limits of the device.
    s4ener:isBoundTo A contractual power limit the device is bound to.
    s4ener:isProtectedBy A nominal power limit the device is protected by.
    s4ener:isLimitedWith The power limit that the device is limited with when it is in a fail-safe state.
    Table 29: Power Limit
    Property Definition
    s4ener:isChangeable The relationship between the power limit and the boolean datatype value indicating whether the power limit is changeable.
    s4ener:isObligatory The relationship between the power limit and the boolean datatype value indicating whether the power limit is obligatory.
    s4ener:hasDuration The duration of the power limitation.
    s4ener:isActive The relationship indicating whether this Power Limit is currently active.
    s4ener:hasNumberRange The Power Limit can have a number range indicating the range of this limit.
    Table 30: Failsafe State
    Property Definition
    s4ener:hasFailsafeDuration Indication of the minimum duration a device should stay in the failsafe state once entered.

    Load control

    This clause presents the part of SAREF4ENER that defines how to model events used in, for example, a direct load management or power curtailing scenario (e.g. use case 3 in clause 4.1). The classes of interest are s4ener:LoadControlEventData, s4ener:LoadControlEventAction, s4ener:LoadControlStateData and s4ener:LoadControlState.

    Load Control
    Figure 12: Load Control

    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.

    Flexibility Communication

    Flexibility Request

    This clause presents how flexibility requests can be modelled in SAREF4ENER (e.g. use case 7 in clause 4.1). This message can be sent by an EMS to a device to inquire for the flexibility it can offer. A flexibility requests can be defined by using the s4ener:FlexRequest class. Flexibility requests can include a s4ener:IncentiveTable, s4ener:FlexibilityProfile, s4ener:TimeSeries and s4ener:Datapoint. An s4ener:FlexRequest can be produced by an agent (foaf:Agent) or device (saref:Device) and be sent to either an agent or device. An s4ener:FlexRequest always has an effective period and a creation time expressed through the Time ontology.

    Flexibility Request
    Figure 13: Flexibility Request
    Table 31: Flexibility Request
    Property Definition
    s4ener:producedBy The relationship between the flexibility request and the foaf:agent or saref:Device that produced the flexibility request.
    s4ener:hasRecipient The relationship between the flexibility request and the foaf:agent or saref:Device to which the flexibility request is directed.
    s4ener:includes The relationship between the flexibility request and the incentive table, flexibility profile, timeseries and datapoint included in the flexibility offer.
    s4ener:hasCreationTime The relationship between the flexibility request and its creation time.
    s4ener:hasEffectivePeriod The relationship between the flexibility request and its creation time.

    Flexibility Offer

    This clause presents how flexibility offers can be modelled in SAREF4ENER (e.g. use case 7 in clause 4.1). This message can be sent by a device to the EMS as a response to a Flexibility Request, indicating the device's flexibility potential. Flexibility offers can be defined by using s4ener:FlexOffer. Flexibility offers can include a s4ener:IncentiveTable, s4ener:FlexibilityProfile, s4ener:TimeSeries and s4ener:Datapoint. A s4ener:FlexOffer can be produced by an agent (foaf:Agent) or device (saref:Device) and it can be sent to either an agent or device. Flexibility offers relate to flexibility requests (s4ener:FlexRequest). A s4ener:FlexOffer always has an effective period and a creation time expressed through the Time ontology.

    Flexibility Offer
    Figure 14: Flexibility Offer
    Table 32: Flexibility Offer
    Property Definition
    s4ener:relatesToRequest The relationship between the flexibility offer and the flexibility request.
    s4ener:producedBy The relationship between the flexibility offer and the foaf:Agent or saref:Device that produced the flexibility offer.
    s4ener:hasRecipient The relationship between the flexibility offer and the foaf:Agent or saref:Device to which the flexibility offer is directed.
    s4ener:includes The relationship between the flexibility offer and the incentive table, flexibility profile, timeseries and datapoint included in the flexibility offer.
    s4ener:hasCreationTime The relationship between the flexibility offer and its creation time.
    s4ener:hasEffectivePeriod The relationship between the flexibility offer and its creation time.

    Flexibility Instruction

    This clause presents how a flexibility instruction can be modelled in SAREF4ENER (e.g. use case 7 in clause 4.1). This class describes the instruction that an EMS sends to a device about how it should operate according to the EMS optimization plan. Flexibility instruction can be defined by using s4ener:FlexibilityInstruction. Flexibility instructions have an activation plan expressed in time-series (s4ener:TimeSeries) and a cost defined as a datapoint (s4ener:DataPoint). A s4ener:FlexInstruction can have an execution time, period of validity, instructionID defined as datatype values. The operation mode factor and the presence of abnormal condition can be specified through the datatype properties s4ener:abnormalConditionOnly and s4ener:operationModeFactor. Flexibility instructions relate to flexibility requests (s4ener:FlexRequest). An s4ener:Flexinstruction can be produced by an agent (foaf:Agent) or device (saref:Device) and be sent to either an agent or device. An s4ener:FlexInstruction always has an effective period and a creation time expressed through the Time ontology.

    Flexibility Instruction
    Figure 15: Flexibility Instruction
    Table 33: Flexibility Instruction
    Property Definition
    s4ener:producedBy The relationship between the flexibility instruction and the foaf:Agent or saref:Device that produced the flexibility instruction.
    s4ener:hasRecipient The relationship between the flexibility instruction and the foaf:Agent or saref:Device to which the flexibility request is directed.
    saref:hasPrice The relationship between the flexibility instruction and the cost expressed as a datapoint.
    s4ener:hasInstructionStatus The relationship between the flexibility instruction and its instruction status.
    s4ener:hasExecutionTime The relationship between the flexibility instruction and the dateTime datatype value of its execution time.
    s4ener:hasStartTime The relationship between the flexibility instruction and the dateTime datatype value expressing the starting time of its validity.
    s4ener:hasEndTime The relationship between the flexibility instruction and the dateTime datatype value expressing the ending time of its validity.
    s4ener:abnormalCondition The relationship between the flexibility instruction and the boolean datatype value indicating whether the power constraint has an abnormal condition.
    s4ener:hasOperationModeFactor The relationship between the flexibility instruction and the integer datatype value expressing its operation mode factor.
    s4ener:relatesToOffer The relationship between the flexibility instruction and the flexibility offer.

    Data Points and Time Series

    The s4ener:DataPoint is an atomic piece of information about a certain observable quantity in nature that can contain a numerical value and a corresponding unit of measure [i.7]. An s4ener:TimeSeries is related to the s4ener:Datapoint class via the s4ener:hasDataPoint property and is defined as an ordered sequence of data-points of a quantity that is observed at spaced (not necessarily equally spaced) time intervals.

    The s4ener:DataPoint is defined as a subclass of saref:Observation and, as such, inherits the saref:hasResult and saref:hasTimestamp properties. Therefore, if the combination of a result and timestamp is sufficient to represent a datapoint, then the SAREF concepts for observation can be directly reused. However, it can be noticed that often, especially when representing timeseries of datapoints in a forecast, a number of additional properties are needed.

    Time Series and Data Point
    Figure 16: Time Series and Data Point
    Table 34: Time Series
    Property Definition
    s4ener:hasUpdateRate Defines the rate at which a data point or timeseries is being updated.
    s4ener:hasTemporalResoultion Defines the distance between two data points measured at different times.
    s4ener:hasEffectivePeriod Connects to the interval (with a beginning and an end) in which the data point was, is, or will be in effect.
    s4ener:hasCreationTime Defines the instant in which a data point or timeseries has been created.
    s4ener:hasUsage Gives some additional information about the usage of a data point, i.e. to define for which purpose the datapoint or timeseries is used.
    s4ener:hasDataPoint Refers to the various data points that this timeseries consists of.
    Table 35: Data point
    Property Definition
    s4ener:belongsToTimeSeries Relates a data point to the timeseries it may belong to.
    s4ener:hasQuantile This property assigns to the data point the percentage of values that are below this value. In other words, a data point with quantile 90 indicates that 90 % of other data points are (estimated to be) lower.
  • NOTE: This class contains the same properties as Timeseries, except for s4ener:hasDataPoint.
  • Table 36: Gaussian data point
    Property Definition
    s4ener:hasStandardDeviation This is a mandatory property for Gaussian forecast data points. The standard deviation (i.e. the square root of the average of the squared deviations of the values subtracted from their average value) can be described with this property.

    Exemplifying SAREF4ENER

    Clause 4.3 provides a set of examples to show the usage of the various SAREF4ENER clauses. The following are available on the SAREF Labs repository for SAREF4ENER:

    Discussion

    The present document is a major revision of the SAREF4ENER ontology extension, developed, using updated reference ontology patterns specified in ETSI TS 103 548 [2] to solve the harmonization needs identified in ETSI TR 103 781 [i.13], with updated development framework and tools defined in ETSI TS 103 673 [i.14].

    As all the SAREF ontologies, SAREF4ENER is a dynamic semantic model that is meant to evolve over time. Therefore, the stakeholders in the energy domain are invited to use, validate and provide feedback on SAREF4ENER, collaborating with the SAREF ontology experts to improve and evolve SAREF4ENER in an iterative and interactive manner, so that changes and additions can be incorporated in future releases of the present document. The first extension of SAREF for the energy domain was originally called SAREF4EE [i.1], since it was created for the Energy@Home and EEBus industry associations with the purpose to make semantically interoperable their different data models, as described in [i.10]. However, once it was brought to ETSI to make it an official specification, that initial SAREF4EE extension has been renamed to SAREF4ENER, as in the present document, according to the naming convention for SAREF extensions adopted in ETSI TR 103 411 [i.4] (i.e. SAREF4XXXX, where XXXX are letters that describe the domain for which the extension was created).

    The first version of SAREF4ENER (V1.1.1) was based on SAREF core V2.1.1. The subsequent version SAREF4ENER V1.2.1 was based on SAREF core V3.1.1. The SAREF4ENER V2.1.1 specified in the present document is based on SAREF core V4.1.1.

    Ontology Reference

    Classes

    s4ener:ActuatorLevel — Actuator level top Classes ToC

    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:Actuator

    s4ener:ActuatorSwitch — Actuator switch top Classes ToC

    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:Actuator

    s4ener:AlternativesGroup — Alternatives group top Classes ToC

    A collection of power sequences for a certain profile

    s4ener:ContractualPowerLimit — Contractual Power Limit top Classes ToC

    The contractual power limit of a device

    s4ener:DDBCInstruction — Demand Driven Based Control Instruction top Classes ToC

    An Instruction as specified for an Demand Driven Based Control Profile.

    has super-classes
    s4ener:FlexibilityInstruction

    s4ener:DataPoint — Data point top Classes ToC

    A data point is a quantity that is extended with various pieces of process information, namely

    - A creation time (instant). This is the point in time when the data point was created, which is not necessarily the time for which it is valid. In the case of soft-sensors or forecasters, a data point might have been created ahead of time, in the case of a direct observation a data point might created at its time of validity (or at the end of its validity time interval) and in the case of an archived value the data point might have been created after the fact.

    - A validity time (temporal entity) which will be named "time stamp". The validity time is the instant or interval in time in which a specific quantity is in effect. For example a room temperature might be measured at 12:00, which means it is in effect at this very instant. A specific amount of energy might me expended within the time-slot between 12:30 and 12:45, which means that the energy observation is in effect during this time interval.

    - A location or topological association. For example, an observation might be taken in a specific room, a power avarage might have been measured by a specific meter, a forecast might be valid for a specific region or grid segment. This association is therefore not always a location.

    s4ener:DemandDrivenProfile — Demand driven control top Classes ToC

    The Flexibility Profile following the Demand Driven strategy.

    s4ener:Device — Device top Classes ToC

    A specialization of a saref:Device that exposes a power profile with power sequences to the CEM. Most of the existing devices can expose at most one 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)

    s4ener:EndInterruptionInstruction — End Interruption Instruction top Classes ToC

    An Instruction message indicating when an interruption can end.

    has super-classes
    s4ener:InterruptionInstruction

    s4ener:EndTimeDurationDescription — End time duration Description top Classes ToC

    The duration description for the end time duration temporal entities

    has super-classes
    time:DurationDescription

    s4ener:EnergyConstraint — Energy Constraint top Classes ToC

    The energy constraint described in the Allowed Limit Range or Power Limit.

    s4ener:EventActionConsume — Event action consume top Classes ToC

    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).

    s4ener:EventActionProduce — Event action produce top Classes ToC

    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).

    s4ener:EventStateConsume — Event state consume top Classes ToC

    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).

    s4ener:EventStateProduce — Event state produce top Classes ToC

    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).

    s4ener:FRBCInstruction — Fill Rate Based Control Instruction top Classes ToC

    A Fill Rate Based Instruction message.

    has super-classes
    s4ener:FlexibilityInstruction

    s4ener:FailsafePowerLimit — Failsafe Power Limit top Classes ToC

    In case the communication between a device and the energy manager is interrupted, fail-safe values apply and the device enters fail-safe state until the communication is re-established.

    s4ener:FailsafeState — Fail-safe state top Classes ToC

    State that indicates that the device currently is in its Fail-safe state. This means that it has lost its connection to a central energy manager. This may result in the device following stricter power limits.

    is in domain of
    s4ener:hasFailsafeDuration

    s4ener:FillLevelTargetProfile — Fill level target profile top Classes ToC

    The target profile that a fill rate based control flexibility profile tries to follow.

    s4ener:FillLevelTargetProfileElement — Fill level target profile element top Classes ToC

    A description of the various Elements detailing the Fill Level Target Profile consists.

    has super-classes
    owl:Thing
    is in range of
    s4ener:hasFillLevelTargetProfileElement

    s4ener:FillRateProfile — Fill rate control top Classes ToC

    A flexibility profile specified through a Fill Rate Based Profile.

    has super-classes
    s4ener:FlexibilityProfile
    is in domain of
    s4ener:hasStorage

    s4ener:FlexOffer — Flex offer top Classes ToC

    It allows to represent a flexibility offer (or schedule) as a combination of multiple time-series, data-points and forecasts. For example, we can create a flexibility offer that includes a time-series ex:T-power of power values, combined with a time-series ex:T-costs of associated costs.

    s4ener:FlexibilityInstruction — Flexibility Instruction top Classes ToC

    s4ener:FlexibilityProfile — Flexibility Profile top Classes ToC

    Different control types to describe the energy flexibility that a device has to offer. Charging of an EV for instance, may be controlled by power profile-based control or fill-rate -based control. It is not allowed to mix different control types at the same time, but different control types may be used sequentially.
    Control Types dictates flexibility instructions. Control Type provides Flexibility options.

    s4ener:GaussianDataPoint — Gaussian data point top Classes ToC

    A data point whose quantity is a standard deviation.

    s4ener:Incentive — Incentive top Classes ToC

    An Incentive indicates the intersection of a tier with a slot. In this particular combination of slot and tier there are a particular costs to draw this type of energy. For example, drawing power from the grid costs 0.30 euro per kilowatthour during the afternoon, but will only be activated from a lower boundary of 3000W.

    has super-classes
    s4ener:DataPoint
    is in domain of
    s4ener:hasLowerBoundary
    s4ener:hasUpperBoundary
    is in range of
    s4ener:hasIncentive

    s4ener:IncentiveTableProfile — Incentive table based profile top Classes ToC

    This flexibility profile describes the usage of an incentive table to describe an incentive type in the form of costs (relative or absolute), CO2 emissions or renewable energy percentage that can be associated to power values (expressed as a time-series of power data-points).

    s4ener:IncentiveTableSlot — Incentive table slot top Classes ToC

    This concept describes a slot that belongs to a Incentive Table. Each slot of the Incentive Table consists of a series of (lower) boundaries, each indicating the power at which a change to another incentive takes place. Additionally, each boundary is associated with a IncentiveTableTier.

    has super-classes
    s4ener:Slot

    s4ener:IncentiveTableTier — Incentive table tier top Classes ToC

    This concept specifies a Tier that an Incentive Table consists of. Each Tier indicates through a series of Boundaries the price per kilowatthour this incentive costs. For example, a tier may describe grid power, solar panel power, or surplus power.

    has super-classes
    s4ener:TimeSeries
    is in domain of
    s4ener:hasIncentiveType

    s4ener:IncentiveType — Incentive Type top Classes ToC

    In the incentive table, an incentive type is defined in the form of costs (relative or absolute), CO2 emissions or renewable energy percentage.

    s4ener:InstructionStatus — Instruction Status top Classes ToC

    The status an instruction has at a specific moment.

    s4ener:InterruptionInstruction — Interruption Instruction top Classes ToC

    An instruction indicating an interruption to the process.

    s4ener:LeakageBehaviour — Leakage behaviour top Classes ToC

    A description of the Leakage Behaviour associated with this Fill Rate Flexibility Profile.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasLeakageBehaviourElement
    is in range of
    s4ener:hasLeakageBehaviour

    s4ener:LeakageBehaviourElement — Leakage behaviour element top Classes ToC

    An element detailing the leakage behaviour of a storage.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:leakageRate
    is in range of
    s4ener:hasLeakageBehaviourElement

    s4ener:LoadControlEventAction — Load Control event action top Classes ToC

    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).

    s4ener:LoadControlEventData — Load control event data top Classes ToC

    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).

    s4ener:LoadControlEventState — Load control event state top Classes ToC

    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).

    s4ener:LoadControlStateData — Load control state data top Classes ToC

    s4ener:NominalPowerLimit — Nominal Power Limit top Classes ToC

    A device may have nominal power consumption and/or production values that are defined by the manufacturer and must not be exceeded, so that the power limit must stay within these constraints.

    s4ener:NumberRange — Number range top Classes ToC

    This class describes a range via a datatype property indicating the start of the range and another datatype property indicating the end of the range.

    s4ener:OMBCInstruction — Operation Mode Based Control Instruction top Classes ToC

    An instruction following the Operation Mode Based Profile.

    has super-classes
    s4ener:FlexibilityInstruction

    s4ener:OperationMode — Operation Mode top Classes ToC

    A resource manager can declare multiple operation modes for a device. An operation mode is a mode/state that a device can find itself in, that is associated with a specific power value.

    s4ener:OperationModeElement — Operation Mode Element top Classes ToC

    Operation Mode Elements of a Fill Rate Based Control

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasRunningCosts
    is in range of
    s4ener:hasOperationModeElement

    s4ener:OperationModeProfile — Operation mode control top Classes ToC

    A resource manager can declare multiple operation modes for a device. An operation mode is a mode/state that a device can find itself in, that is associated with a specific power value.

    has super-classes
    s4ener:FlexibilityProfile

    s4ener:PEBCInstruction — Power Envelop Based Control Instruction top Classes ToC

    An instruction for the Power Envelope Based Profile.

    has super-classes
    s4ener:FlexibilityInstruction

    s4ener:PPBCInstruction — Power Profile Based Control Instruction top Classes ToC

    s4ener:PowerConstraint — Power constraint top Classes ToC

    The actual power constraint contained in the Allowed Limit Range or Power limit.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasConsequenceType

    s4ener:PowerEnvelope — Power Envelope top Classes ToC

    A specific Power Envelope to be followed by an energy manager

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasEnvelope
    is in range of
    s4ener:hasPowerEnvelope
    s4ener:hasPowerEnvelopeElement

    s4ener:PowerEnvelopeConsequenceType — Power Envelope Consequence Type top Classes ToC

    The type of consequence of limiting power, which can be Defer or Vanish.

    has super-classes
    owl:Thing
    is in range of
    s4ener:hasConsequenceType
    has members
    s4ener:Defer, s4ener:Vanish

    s4ener:PowerEnvelopeLimitType — Power Envelope Limit Type top Classes ToC

    An enumeration containing the codelist for Power Envelope Limit Types, which may be Lower limit or Upper limit.

    has super-classes
    owl:Thing
    is in range of
    s4ener:limitType
    has members
    s4ener:LowerLimit, s4ener:UpperLimit

    s4ener:PowerEnvelopeProfile — Power envelope control top Classes ToC

    A Flexibility Profile described through a Power Envelope Profile.

    has super-classes
    s4ener:FlexibilityProfile
    is in domain of
    s4ener:hasPowerEnvelopeElement

    s4ener:PowerLimit — Power Limit top Classes ToC

    A power limit is defined as the maximum value for power consumption and/or production that must not be exceeded by e.g. a (group of) device(s), a building, or also a district.

    s4ener:PowerLimitProfile — Power limit profile top Classes ToC

    This profile describes the energy flexibility of a device via a set of power limits, following the SPINE documentation

    s4ener:PowerPlan — Power plan top Classes ToC

    The Power Plan that an energy manager creates for a device. It contains three timeseries indicating the minimum, average, and maximum respectively.

    has super-classes
    saref:consistsOf some s4ener:TimeSeries
    s4ener:TimeSeries
    is in domain of
    s4ener:isWritable
    is in range of
    s4ener:hasPowerPlan

    s4ener:PowerProfile — Power profile control top Classes ToC

    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).

    s4ener:PowerRange — Power range top Classes ToC

    A class describing a power range, containing a start of range, an end of range, and a saref:Property indicating the type of power involved.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasNumberRange
    is in range of
    s4ener:hasPowerRange

    s4ener:PowerSequence — Power sequence top Classes ToC

    A Power Sequence following S2 is a container containing one or more PowerSequenceElements among which the EMS can choose the Element with the best fit to the current energy demands.

    s4ener:PowerSequenceContainer — Power profile container top Classes ToC

    A container containing the various Power Sequences among which the EMS may choose for the appropriate Power Sequence at a given time.

    s4ener:PowerSequenceElement — Power sequence element top Classes ToC

    An element of a power sequence, roughly equivalent to slots in the existing S4ener.

    has super-classes
    owl:Thing
    is in range of
    s4ener:hasPowerSequenceElement

    s4ener:PowerSequenceState — Power sequence state top Classes ToC

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

    s4ener:PowerSequenceStatus — Power sequence status top Classes ToC

    A codelist for the various Power Sequence statuses.

    s4ener:PowerSource — Power source top Classes ToC

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

    s4ener:Role — Role top Classes ToC

    A codelist containing the various roles a device can take: producer, consumer, and storage.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:hasCommodity
    s4ener:hasRoleType
    is in range of
    s4ener:hasRole

    s4ener:RoleType — Role Type top Classes ToC

    An enumeration containing the various roles a device can take up: consumer, producer, or storage.

    s4ener:ScheduleInstruction — Schedule Instruction top Classes ToC

    Schedule instruction for a power profile flexibility profile.

    has super-classes
    s4ener:PPBCInstruction

    s4ener:ScopeType — Scope Type top Classes ToC

    An incentive table may additionally define a scope type to indicate whether it is a preliminary or committed version.

    s4ener:Slot — Slot top Classes ToC

    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.

    s4ener:StartInterruptionInstruction — Start Interruption Instruction top Classes ToC

    An instruction or message indicating the start of an interruption.

    has super-classes
    s4ener:InterruptionInstruction

    s4ener:Storage — Storage top Classes ToC

    storage device which is the main component of Fill Rate Based Control type.). In the context of flexibility control and instructuons, a device shall be able to inform the CEM about its fill level, a measure of how full the storage is, and the lower and upper boundaries that the fill level should remain within.

    s4ener:TimeSeries — Time Series top Classes ToC

    An ordered sequence of data points of a quantity observed at spaced time intervals is referred to as a time series. Time series can be a result of prediction algorithm.

    s4ener:Timer — Timer top Classes ToC

    A timer for time-based operation mode and transition constraints.

    has super-classes
    owl:Thing
    is in domain of
    s4ener:isFinishedAt
    is in range of
    s4ener:hasTimer
    s4ener:isBlockedBy
    s4ener:startsTimer

    s4ener:Transition — Transition top Classes ToC

    Possible transitions to switch from one Operation Mode to another or to set new parameters.

    s4ener:ValueSource — Value source top Classes ToC

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

    has super-classes
    owl:Thing
    is in range of
    s4ener:hasValueSource
    has members
    s4ener:Calculated, s4ener:Empirical, s4ener:Measured

    s4ener:ValueTendency — Value tendency top Classes ToC

    This type indicates a codelist for the s4ener:valueTendency property about whether the tendency of an observation is rising, stable or falling.

    has super-classes
    owl:Thing
    is in range of
    s4ener:valueTendency
    has members
    s4ener:Falling, s4ener:Rising, s4ener:Stable

    Object Properties

    s4ener:allowedLimitRange — allowed limit range top Object Properties ToC

    This property indicates the various AllowedLimitRanges or PowerLimits that this PowerConstraint object consists of.

    s4ener:belongsTo — belongs to top Object Properties ToC

    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.

    s4ener:belongsToTimeSeries — belongs to time series top Object Properties ToC

    The relationship that connects a data point to a time series.

    has domain
    s4ener:DataPoint
    has range
    s4ener:TimeSeries
    is inverse of
    s4ener:hasDataPoint

    s4ener:endOfRange — end of range top Object Properties ToC

    This property indicates the end of a number range.

    s4ener:fillRate — Fill Rate Level top Object Properties ToC

    Indicates the change in fill_level per second. The lower_boundary of the NumberRange is associated with an operation_mode_factor of 0, the upper_boundary is associated with an operation_mode_factor of 1.

    s4ener:fromOperationMode — from operation mode top Object Properties ToC

    ID of the OperationMode (exact type differs per ControlType) that should be switched from.

    s4ener:hasActiveOperationMode — has active operation mode top Object Properties ToC

    A reference to the OperationMode that is presently active

    s4ener:hasAppliedEventActionConsume — has applied event action consume top Object Properties ToC

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

    s4ener:hasAppliedEventActionProduce — has applied event action produce top Object Properties ToC

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

    s4ener:hasCommodity — Uses commodity top Object Properties ToC

    An indication of which commodity this Role is a consumer, producer, or storer of.

    has domain
    s4ener:Role
    has range
    saref:Commodity

    s4ener:hasConsequenceType — Has Consequence Type top Object Properties ToC

    The consequence type associated with this Power Constraint, which can be Defer or Vanish.

    s4ener:hasConstraints — has constraints top Object Properties ToC

    This property relates a Power Envelop Instruction or Profile to the constraints it needs to follow. There are two types of constraints modelled: Power constraints and energy constraints.

    s4ener:hasContractualConsumptionMax — has contractual consumption Max top Object Properties ToC

    The relationship between the contractual power limit and the value indicating the max limit consumption.

    s4ener:hasContractualProductionMax — has contractual production Max top Object Properties ToC

    The relationship between the contractual power limit and the value indicating the max limit production.

    s4ener:hasCost — hasCost top Object Properties ToC

    Additional costs per second (e.g. wear, services) associated with this operation mode in the currency defined by the ResourceManagerDetails , excluding the commodity cost. The range is expressing uncertainty and is not linked to the operation_mode_factor.

    s4ener:hasDataPoint — has data point top Object Properties ToC

    This relationship connects a time series to data point.

    s4ener:hasDemandRate — has demand rate top Object Properties ToC

    The present demand rate that needs to be satisfied by the system

    s4ener:hasDemandRateForecast — has average demand rate forecast top Object Properties ToC

    This property relates a Demand Driven Profile to a TimeSeries object that indicates a forecast of the average demand rate.

    s4ener:hasDevice — has device top Object Properties ToC

    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.

    s4ener:hasEffectivePeriod — has effective period top Object Properties ToC

    This connects to the temporal entity which describes when (time interval) the quantity of this data point was, is, or will be in effect. This is the time interval which is covered by the forecast.
    This should be equivalent to the time interval covered by the time-series that express the forecast.

    has range
    time:Interval

    s4ener:hasElapsedSlotTime — has elapsed slot time top Object Properties ToC

    If state is set to 'running' or 'paused' AND the slot is determined, this property 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.

    s4ener:hasEnergy — has energy top Object Properties ToC

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

    s4ener:hasEnvelope — has envelope top Object Properties ToC

    This property relates a Power Envelope to the Timeseries object that describes the envelope

    s4ener:hasEventStateConsume — has event state consume top Object Properties ToC

    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:hasState

    s4ener:hasEventStateProduce — has event state produce top Object Properties ToC

    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:hasState

    s4ener:hasFailsafeConsumptionMax — has failsafe consumption max top Object Properties ToC

    The relationship between the failsafe power limit and the value indicating its consumption.

    s4ener:hasFailsafeProductionMax — has failsafe production max top Object Properties ToC

    The relationship between the failsafe power limit and the value indicating its production.

    s4ener:hasFillLevelRange — Fill Level Range top Object Properties ToC

    The range of the fill level for which this FRBC.OperationModeElement applies.

    If this concept is applied on a Storage it indicated the range in which a storage should remain.

    s4ener:hasFillLevelTargetProfile — has fill level target profile top Object Properties ToC

    The Fill Level Target Profile of the storage that the current Fill Rate Profile tries to accomodate for.

    NB. This cannot be modelled as a TimeSeries, since the x-axis is not time.

    s4ener:hasFillLevelTargetProfileElement — has fill level target profile element top Object Properties ToC

    The various Fill Level Target Profile Elements detailing the Fill Level Target Profile that the current Fill Level Based Profile tries to accomodate for.

    s4ener:hasIncentive — has incentive top Object Properties ToC

    This property relates an IncentiveTable element, such as an IncentiveTableSlot or an IncentiveTableTier to the boundaries that it consists of.

    s4ener:hasIncentiveType — has incentive type top Object Properties ToC

    The relationship between the tier and its incentive type

    s4ener:hasInstructionStatus — has Instruction Status top Object Properties ToC

    Present status of this instruction.

    s4ener:hasLeakageBehaviour — has leakage behaviour top Object Properties ToC

    The Leakage Behaviour associated with this storage.

    s4ener:hasLeakageBehaviourElement — has leakage behaviour element top Object Properties ToC

    This property relates the LeakageBehaviour description to the LeakageBehaviourElements indicating the detailed description.

    s4ener:hasLowerBoundary — has lower boundary top Object Properties ToC

    This property relates an IncentiveTableBoundary to the datapoint describing its lower boundary or starting point at which this boundary becomes active.

    has domain
    s4ener:Incentive
    has range
    s4ener:DataPoint

    s4ener:hasNominalConsumption — has nominal consumption Max top Object Properties ToC

    The relationship between the nominal power limit and the value indicating the max limit consumption.

    s4ener:hasNominalProduction — has nominal production Max top Object Properties ToC

    The relationship between the nominal power limit and the value indicating the max limit production.

    s4ener:hasNumberRange — has number range top Object Properties ToC

    This property provides the association between a power range and its number range.

    has domain
    s4ener:PowerRange
    has range
    s4ener:NumberRange

    s4ener:hasOperationMode — has Operation Modes top Object Properties ToC

    This property indicates the s4ener:OperationMode inidicated by this Actuator, Instruction, or OperationModeProfile.

    The SAREF4ENER extension expects the following classes to be used as domain:
    - saref:Actuator
    - s4ener:FRBCInstruction
    - s4ener:DDBCInstruction
    - s4ener:OMBCInstruction
    - s4ener:OperationModeProfile

    s4ener:hasOperationModeElement — Has Operation Mode Element top Object Properties ToC

    List of OperationModeElements, which describe the properties of this FRBC.OperationMode depending on the fill_level. The fill_level_ranges of the items in the Array must be contiguous.

    s4ener:hasPowerEnvelope — has power envelope top Object Properties ToC

    The PEBC.PowerEnvelope(s) that should be followed by the Resource Manager. There shall be at least one PEBC.PowerEnvelope, but at most one PEBC.PowerEnvelope for each Commodity.

    s4ener:hasPowerEnvelopeElement — has power envelope element top Object Properties ToC

    This property relates a PowerEnvelopeProfile to the various specific PowerEnvelops contained in the profile.

    s4ener:hasPowerLimitConsumptionMax — has power limit consumption Max top Object Properties ToC

    The relationship between the power limit and the value indicating the max limit consumption.

    s4ener:hasPowerLimitProductionMax — has power limit production Max top Object Properties ToC

    The relationship between the power limit and the value indicating the max limit production.

    s4ener:hasPowerLimitState — has power limit state top Object Properties ToC

    The relationship between the power limit state and its state (active/ inactive).

    has domain
    s4ener:PowerLimit

    s4ener:hasPowerPlan — has power plan top Object Properties ToC

    A reference to a power plan indicating the preliminary or committed usage of the energy smart device for a specific period.

    s4ener:hasPowerRange — has power ranges top Object Properties ToC

    The power produced or consumed by this operation mode. The start of each PowerRange is associated with an operation_mode_factor of 0, the end is associated with an operation_mode_factor of 1. In the array there must be at least one PowerRange, and at most one PowerRange per Commodity.

    s4ener:hasPowerSequence — has power sequence top Object Properties ToC

    The various Sequences contained in a Power Sequence Container among which the EMS can choose the proper PowerSequence for the current energy demands.

    s4ener:hasPowerSequenceContainer — has power sequence container top Object Properties ToC

    The various power sequence containers contained within an S2 Power Profile. The containers have to executed one after the other. Each container contains various Power Sequence anong which the EMS can choose the appropriate Power Sequence for the current energy demands.

    s4ener:hasPowerSequenceElement — has power sequence element top Object Properties ToC

    A connection between the Power Sequence and the elements (or Slots) describing the exact contents.

    s4ener:hasPowerSequenceStatus — has power sequence status top Object Properties ToC

    This property indicates the current status of this Power Sequence.

    s4ener:hasPowerSource — Power source top Object Properties ToC

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

    has range
    s4ener:PowerSource

    s4ener:hasPreviousOperationMode — has previous operation mode top Object Properties ToC

    The previous operation mode this device was in

    s4ener:hasRecipient — has recipient top Object Properties ToC

    This property can be used to connect a flexibility offer or/and flexibility request to a foaf:agent or saref:Device.

    s4ener:hasResumeCostEstimated — Resume cost estimated top Object Properties ToC

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

    has super-properties
    saref:hasPropertyValue

    s4ener:hasResumeEnergyEstimated — Resume energy estimated top Object Properties ToC

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

    has super-properties
    saref:hasPropertyValue

    s4ener:hasRole — performs role top Object Properties ToC

    Each Resource Manager provides one or more energy Roles

    has domain
    s4ener:Device
    has range
    s4ener:Role

    s4ener:hasRoleType — role type top Object Properties ToC

    The type of this specific role

    has domain
    s4ener:Role
    has range
    s4ener:RoleType

    s4ener:hasRunningCosts — has running costs top Object Properties ToC

    Additional costs per second (e.g. wear, services) associated with this operation mode in the currency defined by the ResourceManagerDetails , excluding the commodity cost. The range is expressing uncertainty and is not linked to the operation_mode_factor.

    s4ener:hasScopeType — has scope type top Object Properties ToC

    The relationship between the incentive table and the scope type

    s4ener:hasSlotValue — has slot value top Object Properties ToC

    This property is intended to specify the power or energy value of a slot in a power sequence as part of a power profile.

    has domain
    s4ener:Slot
    has range
    saref:PropertyValue

    s4ener:hasStorage — has storage top Object Properties ToC

    The storage regulated by the related Fill Rate Profile.

    has domain
    s4ener:FillRateProfile
    has range
    s4ener:Storage

    s4ener:hasSupplyRange — Has Supply Range top Object Properties ToC

    The SupplyRange this OperationMode of a Demand Driven Profile can deliver for the CEM to match the DemandRate. The start of the NumberRange is associated with an operation_mode_factor of 0, the end is associated with an operation_mode_factor of 1.

    s4ener:hasTier — has tier incentive top Object Properties ToC

    The relationship between the incentive table and the tiers it consists of

    s4ener:hasTimer — Has Timer top Object Properties ToC

    The set of timers that are available in this Actuator or OperationModeProfile

    s4ener:hasTransition — has transition top Object Properties ToC

    The transitions between various saref:States or s4ener:OperationModes that either the Actuator or the OperationModeProfile can support.

    s4ener:hasUpperBoundary — has upper boundary top Object Properties ToC

    This property relates a boundary to its upper boundary or the value at which this incentive becomes inactive. This value is optional, because the upper boundary can be inferred from the lower boundary of the next boundary.

    has domain
    s4ener:Incentive
    has range
    s4ener:DataPoint

    s4ener:hasUsage — has usage top Object Properties ToC

    This property provides the possibility to add some additional information about the usage of a data-point or time-series. For example, a data point or time series can be used as an upper limit, a lower limit, a baseline, a maximum versus minimum value, or a consumption versus a production value.

    has range
    s4ener:Usage

    s4ener:hasUsageForecast — Has Usage Forecast top Object Properties ToC

    Indicates the usage forecast that may be relevant to decide the energy flexibility strategy following a specific flexibility profile, specifically a fill rate based profile or incentive table.

    In SAREF4ENER this property is intended to be applied on an s4ener:FlexibilityProfile.

    has range
    s4ener:TimeSeries

    s4ener:hasValueSource — has value source top Object Properties ToC

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

    has range
    s4ener:ValueSource

    s4ener:includes — includes top Object Properties ToC

    This property can be used to connect the flexibility offer and/or flexibility request to the flexibility profile. Additionally, it can be used to specify the s4ener:datapoint, s4ener:timeseries and ic-fc:forecast included in the flexibility offer and/or flexibility request.

    s4ener:isActuatedBy — is actuated by top Object Properties ToC

    A reference to an (external) actuator that can potentially activate this profile or where the instruction originates from.

    s4ener:isBlockedBy — is blocked by top Object Properties ToC

    The Timers that block this Transition from initiating while at least one of these Timers is not yet finished

    has domain
    s4ener:Transition
    has range
    s4ener:Timer

    s4ener:isBoundTo — is bound to top Object Properties ToC

    The relationship between a device and its contractual power limit

    s4ener:isLimitedWith — is limited with top Object Properties ToC

    The relationship between device and failsafe power limit

    s4ener:isProtectedBy — is protected by top Object Properties ToC

    The relationship between the device and the nominal power limit

    s4ener:leakageRate — Leakage Rate top Object Properties ToC

    Indicates how fast the momentary fill level will decrease per second due to leakage within the given range of the fill level.

    s4ener:limitType — Limit Type top Object Properties ToC

    Indicates if this ranges applies to the upper limit or the lower limit.

    s4ener:presentFillLevel — present fill level top Object Properties ToC

    A saref:PropertyValue with a percentage value indicating the fill level of the storage.

    has domain
    s4ener:Storage
    has range
    saref:PropertyValue

    s4ener:producedBy — produced by top Object Properties ToC

    A relation between an entity (datapoint, message, timeseries, instruction) that has been produced by a device or other agent.

    In the context of SAREF4ENER this property is intended for s4ener:DataPoint, s4ener:TimeSeries, and the various types of flexibility instructions, FlexOffers and FlexRequests.

    has range
    foaf:Agent or saref:Device

    s4ener:rangeBoundary — range boundary top Object Properties ToC

    Boundaries of the power range of this PEBC.AllowedLimitRange. The CEM is allowed to choose values within this range for the power envelope for the limit as described in limit_type. The start of the range shall be smaller or equal than the end of the range.

    s4ener:receives — receives top Object Properties ToC

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

    s4ener:receivesPowerLimit — receives power limit top Object Properties ToC

    The relationship between a power limit profile and the power limit it has received for its device to follow

    s4ener:relatesToCommodity — relates to commodity quantity top Object Properties ToC

    Relates the classes to the various commodities introduced by the S2 standard.

    In the SAREF4ENER extension this property is intended for the following:
    - s4ener:PowerRange
    - s4ener:AllowedLimitRange
    - s4ener:EnergyConstraint
    - s4ener:PowerEnvelope

    has range
    saref:Commodity

    s4ener:relatesToOffer — relates to offer top Object Properties ToC

    The relationship between the s4ener:FlexibilityInstruction and the flexibility offer.

    s4ener:relatesToPowerProfile — Relates to power profile top Object Properties ToC

    ID of the PPBC.PowerProfileDefinition of which the PPBC.PowerSequence is being selected and scheduled by the CEM.

    s4ener:relatesToPowerProfileSequence — Relates to power profile sequence top Object Properties ToC

    ID of the PPBC.PowerSequence that is being selected and scheduled by the CEM.

    s4ener:relatesToPowerProfileSequenceContainer — Relates to power profile sequence container top Object Properties ToC

    ID of the PPBC.PowerSequnceContainer of which the PPBC.PowerSequence is being selected and scheduled by the CEM.

    s4ener:relatesToRequest — relates to request top Object Properties ToC

    The relationship between the flexibility offer and flexibility request

    has domain
    s4ener:FlexOffer
    has range
    s4ener:FlexRequest

    s4ener:startOfRange — start of range top Object Properties ToC

    This property indicates the start of a number range.

    s4ener:startsTimer — Starts Timer top Object Properties ToC

    List of IDs of Timers that will be (re)started when this transition is initiated

    has domain
    s4ener:Transition
    has range
    s4ener:Timer

    s4ener:toOperationMode — to state operation mode top Object Properties ToC

    ID of the OperationMode (exact type differs per ControlType) that will be switched to.

    s4ener:triggersEventActionConsume — triggers event action consume top Object Properties ToC

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

    s4ener:triggersEventActionProduce — triggers event action produce top Object Properties ToC

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

    s4ener:valueTendency — value tendency top Object Properties ToC

    Indicates whether the tendency of an observation is rising, stable, or falling.

    Data Properties

    s4ener:abnormalCondition — abnormal condition top Data Properties ToC

    Indicates if this is an instruction during an abnormal condition

    s4ener:abnormalConditionOnly — Abnormal Condition Only top Data Properties ToC

    Indicates if this element can only be used during an abnormal condition.

    In SAREF4ENER this property is intended to be used on the following properties:
    - s4ener:OperationMode
    - s4ener:Transition
    - s4ener:AllowedLimitRange
    - s4ener:PowerSequence

    has range
    xsd:boolean

    s4ener:activateSlot — activate slot top Data Properties ToC

    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

    s4ener:activeRepetitionNumber — active repetition number top Data Properties ToC

    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

    s4ener:activeSlotNumber — active slot number top Data Properties ToC

    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

    s4ener:brandName — brand name top Data Properties ToC

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

    has range
    xsd:string

    s4ener:cheapest — cheapest top Data Properties ToC

    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

    s4ener:deviceCode — device code top Data Properties ToC

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

    has range
    xsd:string

    s4ener:deviceName — device name top Data Properties ToC

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

    has range
    xsd:string

    s4ener:firmwareVersion — has firmware version top Data Properties ToC

    Version identifier of the firmware used in the device (provided by the manufacturer)

    has domain
    s4ener:Device
    has range
    xsd:string

    s4ener:greenest — greenest top Data Properties ToC

    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

    s4ener:hardwareRevision — hardware revision top Data Properties ToC

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

    has range
    xsd:string

    s4ener:hasActivationDelay — has activation delay top Data Properties ToC

    The scheduled activation delay for a slot.

    has range
    xsd:duration

    s4ener:hasActiveDurationMax — has active duration max top Data Properties ToC

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

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasActiveDurationMin — has active duration min top Data Properties ToC

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

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasActiveDurationSumMax — has active duration sum max top Data Properties ToC

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

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasActiveDurationSumMin — has active duration sum min top Data Properties ToC

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

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasCreationTime — has creation time top Data Properties ToC

    The time instant that defines the creation time of a data point or quantity or forecast or similar entities. This is not the same as the time at which the quantity is in effect. For example, if a temperature is forecasted today at 12:30 (creation time of the forecast) for the following day at 14:45 (time when the temperature is expected to be in effect), the this instant should be 12:30 of today.

    A creation time (instant). This is the point in time when the data point was created, which is not necessarily the time for which it is valid. In the case of soft-sensors or forecasters, a data point might have been created ahead of time, in the case of a direct observation a data point might created at its time of validity (or at the end of its validity time interval) and in the case of an archived value the data point might have been created after the fact.

    has range
    xsd:dateTimeStamp

    s4ener:hasDefaultDuration — has default duration top Data Properties ToC

    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

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasDuration — duration in xsd top Data Properties ToC

    This property specifies that the componenrt has a duration attribute further specified in the subproperty

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    s4ener:hasDurationMin — duration minimum top Data Properties ToC

    The minimum duration for some component

    This property is suggested to be added in SAREF4ENER_V2

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasDurationUncertainty — Duration uncertainty top Data Properties ToC

    The uncertainty of the duration given in the s4ener:defaultDuration property.

    has super-properties
    s4ener:hasDuration
    has range
    xsd:duration

    s4ener:hasEarliestStartTime — has earliest start time top Data Properties ToC

    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.

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    saref:hasTimestamp
    has range
    xsd:dateTimeStamp

    s4ener:hasEndTime — end time top Data Properties ToC

    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.

    has super-properties
    saref:hasTimestamp
    has range
    xsd:duration

    s4ener:hasExecutionTime — has execution time top Data Properties ToC

    Start time of the instruction

    has super-properties
    saref:hasTimestamp
    has domain
    s4ener:FlexibilityInstruction
    has range
    xsd:dateTimeStamp

    s4ener:hasFailsafeDuration — has failsafe duration top Data Properties ToC

    The relationship between the failsafe power limit and its duration. This property indicates the minimum duration the fail safe state will take once a device has entered that state.

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:FailsafeState
    has range
    xsd:duration

    s4ener:hasIndex — has index top Data Properties ToC

    Gives the index for elements that are an array in the S2 specification. Can be used regularly as well as in RDF* manner on properties.

    has range
    xsd:integer

    s4ener:hasInterruptionEndTime — has end time Interruption top Data Properties ToC

    The end time included in an Interruption Instruction message indicating when the interruption should end.

    has super-properties
    saref:hasTimestamp
    has domain
    s4ener:InterruptionInstruction
    has range
    xsd:dateTimeStamp

    s4ener:hasInterruptionStartTime — Has Interruption Start Time top Data Properties ToC

    The start time included in an Interruption Instruction message indicating when the interruption should start.

    has super-properties
    saref:hasTimestamp
    has domain
    s4ener:InterruptionInstruction
    has range
    xsd:dateTimeStamp

    s4ener:hasLatestEndTime — has latest end time top Data Properties ToC

    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.

    This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.

    has super-properties
    saref:hasTimestamp

    s4ener:hasLowerAveragePower — has lower average power top Data Properties ToC

    The lower average power associated with this Energy constraint.

    has domain
    s4ener:EnergyConstraint
    has range
    xsd:integer

    s4ener:hasManufacturerNodeIdentification — has manufacturer node identification top Data Properties ToC

    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 re-joined later with changed node address.

    has super-properties
    saref:hasIdentifier
    has domain
    saref:Device

    s4ener:hasMaxDuration — has max duration top Data Properties ToC

    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

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerSequence
    has range
    xsd:duration

    s4ener:hasMaxPauseBefore — max pause before top Data Properties ToC

    The maximum duration for which a device can be paused between the end of the previous running sequence and the start of this one

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerSequence
    has range
    xsd:duration

    s4ener:hasMinDuration — has min duration top Data Properties ToC

    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.

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerSequence
    has range
    xsd:duration

    s4ener:hasOperationModeFactor — Has Operation Mode Factor top Data Properties ToC

    The number indicates the factor with which the FRBC.OperationMode or OMBC.OperationMode is usedconfigured. The factor should be greater than or equal than 0 and less or equal to 1.

    Within the SAREF4ENER extension, this property is to be used on the following classes:
    - s4ener:OMBCInstruction
    - s4ener:OperationMode
    - saref:Actuator
    - s4ener:FRBCInstruction
    - s4ener:DDBCInstruction

    has range
    xsd:decimal

    s4ener:hasPauseDurationMax — has pause duration max top Data Properties ToC

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

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerSequence
    has range
    xsd:duration

    s4ener:hasPauseDurationMin — has pause duration min top Data Properties ToC

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

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerSequence
    has range
    xsd:duration

    s4ener:hasPowerLimitDuration — has power limit duration top Data Properties ToC

    The relationship between the power limit and its duration. Power limit may come with a time period of validity based on duration

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:PowerLimit
    has range
    xsd:duration

    s4ener:hasQuantile — has quantile top Data Properties ToC

    Used to define a quantile for example on a data point of a quantile time series. The quantile must be a ratio, usually a percentage. In a quantile forecast the hasQuantile property cannot be empty. his property assigns to the data point the percentage of values that are below this value. In other words, a data point with quantile 90 indicates that 90 % of other measurements are (estimated to be) lower.

    has domain
    s4ener:DataPoint
    has range
    xsd:decimal

    s4ener:hasRemainingPauseTime — has remaining pause time top Data Properties ToC

    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.

    has range
    xsd:duration

    s4ener:hasRemainingSlotTime — has remaining slot time top Data Properties ToC

    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.

    has range
    xsd:duration

    s4ener:hasStandardDeviation — has standard deviation top Data Properties ToC

    The standard deviation (i.e. the square root of the average of the squared deviations of the values subtracted from their average value) can be described with this property.

    has domain
    s4ener:GaussianDataPoint
    has range
    xsd:decimal

    s4ener:hasStartTime — has start time top Data Properties ToC

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

    has super-properties
    saref:hasTimestamp
    has range
    xsd:dateTimeStamp

    s4ener:hasTaskIdentifier — has task identifier top Data Properties ToC

    Used by a device that wants to uniquely identify reoccurring types of power sequences. For example, specific types of washing cycles with specific parameters SHOULD have the same s4ener:taskIdentifier value every time they are offered using power sequences.

    has super-properties
    saref:hasIdentifier
    has domain
    s4ener:PowerSequence

    s4ener:hasTemporalResolution — has temporal resolution top Data Properties ToC

    The resolution is the distance between two observation timestamps. This only makes sense if the observations are equidistant.

    has range
    xsd:duration

    s4ener:hasTransitionCosts — has transition costs top Data Properties ToC

    Absolute costs for going through this Transition in the currency as described in the ResourceManagerDetails.

    has domain
    s4ener:Transition
    has range
    xsd:decimal

    s4ener:hasTransitionDuration — Transition Duration top Data Properties ToC

    Indicates the time between the initiation of this Transition, and the time at which the device behaves according to the Operation Mode which is defined in the appropriate data element. When no value is provided it is assumed the transition duration is negligible.

    has super-properties
    s4ener:hasDuration
    has domain
    s4ener:Transition
    has range
    xsd:duration

    s4ener:hasTransitionTimestamp — transition Timestamp top Data Properties ToC

    Time at which the transition from the previous Operation Mode was initiated. This value shall always be provided, unless the active OperationMode is the first OperationMode the Resource Manager is aware of.

    has super-properties
    saref:hasTimestamp
    has domain
    s4ener:OperationMode or saref:Actuator
    has range
    xsd:dateTimeStamp

    s4ener:hasUpdateRate — has update rate top Data Properties ToC

    The rate at which a data point or time-series or forecast or other data entity is being updated.

    If the time series gets regularly updated, then the time between two updates can be recorded here.

    has range
    xsd:duration

    s4ener:hasUpperAveragePower — has upper average power top Data Properties ToC

    The upper average power of an Energy constraint of a Power Envelope profile.

    has domain
    s4ener:EnergyConstraint
    has range
    xsd:integer

    s4ener:hasValue — has value top Data Properties ToC

    Power value expressed in the unit associated with the Commodity of the Power Value.

    has range
    xsd:decimal

    s4ener:isActive — is active top Data Properties ToC

    Indicates whether the power limit is currently active

    has domain
    s4ener:PowerLimit
    has range
    xsd:boolean

    s4ener:isChangeable — is changeable top Data Properties ToC

    A relationship indicating that this element can be changed by its operator. The boolean value indicates whether it is indeed changeable.

    In the SAREF4ENER extension this property is intended for PowerLimits and IncentiveTable elements, such as the IncentiveTableProfile, IncentiveTableSlot, and the IncentiveTableTier.

    has range
    xsd:boolean

    s4ener:isFinishedAt — is finished at top Data Properties ToC

    Indicates when the Timer will be finished. If the DateTimeStamp is in the future, the timer is not yet finished. If the DateTimeStamp is in the past, the timer is finished. When the timer was never started, the value can be an arbitrary DateTimeStamp in the past.

    has super-properties
    saref:hasTimestamp
    has domain
    s4ener:Timer
    has range
    xsd:dateTimeStamp

    s4ener:isInterruptible — is interruptible top Data Properties ToC

    This property indicates whether the PowerSequence is interruptible.

    has domain
    s4ener:PowerSequence
    has range
    xsd:boolean

    s4ener:isObligatory — is obligatory top Data Properties ToC

    A relationship between the power limit and the boolean value indicating whether the power limit is obligatory

    has domain
    s4ener:PowerLimit
    has range
    xsd:boolean

    s4ener:isPausable — is pausable top Data Properties ToC

    Specifies if the power sequence is pausable.

    has range
    xsd:boolean

    s4ener:isStoppable — is stoppable top Data Properties ToC

    Specifies if the power sequence is stoppable.

    has range
    xsd:boolean

    s4ener:isWritable — is writable top Data Properties ToC

    This Boolean value indicates whether this power plan is writable or fixed.

    has domain
    s4ener:PowerPlan
    has range
    xsd:boolean

    s4ener:maxCyclesPerDay — max cycles per day top Data Properties ToC

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

    has range
    xsd:unsignedInt

    s4ener:nodeRemoteControllable — node remote controllable top Data Properties ToC

    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

    s4ener:optionalSlot — optional slot top Data Properties ToC

    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

    s4ener:progress — progress top Data Properties ToC

    Time that has passed since the selected sequence has started. A value must be provided, unless no sequence has been selected or the selected sequence hasn't started yet.

    s4ener:repetitionsTotal — repetition total top Data Properties ToC

    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

    s4ener:requiresUpdate — requiresUpdate top Data Properties ToC

    The relationship between the incentive table element and the boolean data indicating whether the incentive table requires an update.

    In the SAREF4ENER extension this property is intended for the following classes:
    - IncentiveTableProfile
    - IncentiveTableTier
    - IncentiveTableSlot

    has range
    xsd:boolean

    s4ener:sequenceRemoteControllable — sequence remote controllable top Data Properties ToC

    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

    s4ener:serialNumber — serial number top Data Properties ToC

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

    has range
    xsd:string

    s4ener:slotActivated — slot activated top Data Properties ToC

    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

    s4ener:slotNumber — slot number top Data Properties ToC

    Provides a unique slot identifier for a certain power sequence

    has range
    xsd:unsignedInt

    s4ener:softwareRevision — software revision top Data Properties ToC

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

    has range
    xsd:string

    s4ener:supportsReselection — supports reselection top Data Properties ToC

    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

    s4ener:supportsSingleSlotSchedulingOnly — supports single slot scheduling only top Data Properties ToC

    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

    s4ener:totalSequencesCountMax — total sequences count max top Data Properties ToC

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

    has range
    xsd:unsignedInt

    s4ener:vendorCode — vendor code top Data Properties ToC

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

    has range
    xsd:string

    s4ener:vendorName — vendor name top Data Properties ToC

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

    has range
    xsd:string

    s4ener:Aborted — Aborted top Named Individuals ToC

    The selected PPBC.PowerSequence was aborted by the device and will not continue

    s4ener:AbsoluteCost — Absolute cost top Named Individuals ToC

    The incentive type ''absolute cost'' defined in the incentive table.

    s4ener:Accepted — Accepted top Named Individuals ToC

    Instruction has been accepted

    s4ener:Average — Average top Named Individuals ToC

    The datapoint indicates an average value aggregated over a number of values.

    belongs to
    s4ener:Usage

    s4ener:BaseLine — Baseline top Named Individuals ToC

    This datapoint indicates the baseline.

    belongs to
    s4ener:Usage

    s4ener:BatteryPowerSource — Battery power source top Named Individuals ToC

    This Power Source codelist element indicates that a battery is the power source of this device.

    belongs to
    s4ener:PowerSource

    s4ener:CO2Emission — CO2 Emission top Named Individuals ToC

    The incentive type ''CO2 Emission'' defined in the incentive table.

    s4ener:Calculated — Calculated top Named Individuals ToC

    This value source codelist element indicates that this observation has been calculated instead of measured or empirical.

    belongs to
    s4ener:ValueSource

    s4ener:Committed — Committed top Named Individuals ToC

    The committed version of this concept, usually an incentive table or power plan

    belongs to
    s4ener:ScopeType

    s4ener:Completed — Completed top Named Individuals ToC

    Power sequence state with value 'completed'

    s4ener:Consumption — Consumption top Named Individuals ToC

    This datapoint indicates the consumption.

    belongs to
    s4ener:Usage

    s4ener:DCPowerSource — DC Power source top Named Individuals ToC

    This Power Source codelist element indicates that the type of power source is DC.

    belongs to
    s4ener:PowerSource

    s4ener:Defer — Defer top Named Individuals ToC

    Indicating that the limited load or generation will be postponed to a later moment

    s4ener:Downflex — Downflex top Named Individuals ToC

    This datapoint indicates the down flexibility.

    belongs to
    s4ener:Usage

    s4ener:ElectricPower3PhaseSymmetric — Electric Power 3 Phase Symmetric top Named Individuals ToC

    Electric power described in Watt on when power is equally shared among the three phases. Only applicable for 3 phase devices.

    belongs to
    saref:Commodity

    s4ener:ElectricPowerL1 — Electric Power L1 top Named Individuals ToC

    Electric power described in Watt on phase 1. If a device utilizes only one phase it should always use L1.

    belongs to
    saref:Commodity

    s4ener:ElectricPowerL2 — Electric Power L2 top Named Individuals ToC

    Electric power described in Watt on phase 2. Only applicable for 3 phase devices.

    belongs to
    saref:Commodity

    s4ener:ElectricPowerL3 — Electric Power L3 top Named Individuals ToC

    Electric power described in Watt on phase 3. Only applicable for 3 phase devices.

    belongs to
    saref:Commodity

    s4ener:Electricity — Electricity top Named Individuals ToC

    Identifier for Commodity ELECTRICITY

    belongs to
    saref:Commodity

    s4ener:Emergency — Emergency top Named Individuals ToC

    Load control event action with value 'emergency'

    s4ener:Empirical — Empirical top Named Individuals ToC

    This value source codelist element indicates this value is an empirical value instead of a calculated or measured value.

    belongs to
    s4ener:ValueSource

    s4ener:Energy — Energy top Named Individuals ToC

    The Property of Energy that a Value Property may be about. This concept can be related to observations and property values that are characterized by a certain value measured in an energy unit (such as Kilowatt_Hour or Watt_hour).

    belongs to
    saref:Property

    s4ener:EnergyConsumer — Energy Consumer top Named Individuals ToC

    Identifier for RoleType Consumer

    belongs to
    s4ener:RoleType

    s4ener:EnergyProducer — Energy Producer top Named Individuals ToC

    Identifier for RoleType Producer

    belongs to
    s4ener:RoleType

    s4ener:EnergyStorage — Energy Storage top Named Individuals ToC

    Identifier for RoleType Storage

    belongs to
    s4ener:RoleType

    s4ener:EuroPerKilowattHour — Euro per kilo watt hour top Named Individuals ToC

    Unit of Measure to represent euro's per kilowatt per hour

    belongs to
    saref:UnitOfMeasure

    s4ener:EventAccepted — Event accepted top Named Individuals ToC

    Load control state with value 'event accepted'

    s4ener:EventCancelled — Event cancelled top Named Individuals ToC

    Load control state with value 'event cancelled'

    s4ener:EventError — Event error top Named Individuals ToC

    Load control state with value 'event error'

    s4ener:EventRejected — Event rejected top Named Individuals ToC

    Load control state with value 'event rejected'

    s4ener:EventStarted — Event started top Named Individuals ToC

    Load control state with value 'event started'

    s4ener:EventStopped — Event stopped top Named Individuals ToC

    Load control state with value 'event stopped'

    s4ener:Executing — EXECUTING top Named Individuals ToC

    The selected PPBC.PowerSequence is currently being executed

    s4ener:Falling — Falling top Named Individuals ToC

    This value tendency codelist element indicates that the tendency of this observation indicates that the value is decreasing (i.e., falling).

    s4ener:Finished — Finished top Named Individuals ToC

    The selected PPBC.PowerSequence was executed and finished successfully

    s4ener:Gas — Gas top Named Individuals ToC

    Identifier for Commodity GAS

    belongs to
    saref:Commodity

    s4ener:Heat — Heat top Named Individuals ToC

    Identifier for Commodity Heat

    belongs to
    saref:Commodity

    s4ener:HeatFlowRate — Heat Flow Rate top Named Individuals ToC

    Flow rate of heat carrying gas or liquid in liters per second

    belongs to
    saref:Commodity

    s4ener:HeatTemperature — Heat Temperature top Named Individuals ToC

    Heat described in degrees Celsius

    belongs to
    saref:Commodity

    s4ener:HeatThermalPower — Heat Thermal Power top Named Individuals ToC

    Thermal power in Watt

    belongs to
    saref:Commodity

    s4ener:HydrogenFlowRate — Hydrogen Flow Rate top Named Individuals ToC

    Gas flow rate described in grams per second

    belongs to
    saref:Commodity

    s4ener:Inactive — Inactive top Named Individuals ToC

    Power sequence state with value 'inactive'

    s4ener:Increase — Increase top Named Individuals ToC

    Load control event action with value 'increase'

    s4ener:Interrupted — Interrupted top Named Individuals ToC

    The selected PPBC.PowerSequence is being executed, but is currently interrupted and will continue afterwards

    s4ener:Invalid — Invalid top Named Individuals ToC

    Power sequence state with value 'invalid'

    s4ener:LowerLimit — Lower Limit top Named Individuals ToC

    The PowerEnvelopeLimitType codelist element indicating the lower limit.

    s4ener:Mains3Phase — Mains3Phase top Named Individuals ToC

    This Power Source codelist element indicates that the power source of this device is Mains 3 Phase.

    belongs to
    s4ener:PowerSource

    s4ener:MainsSinglePhase — Mains single phase top Named Individuals ToC

    This codelist element of power source indicates that the power source is the mains single phase.

    belongs to
    s4ener:PowerSource

    s4ener:Maximum — Maximum top Named Individuals ToC

    The usage of this datapoint is the Maximum value.

    belongs to
    s4ener:Usage

    s4ener:Measured — Measured top Named Individuals ToC

    The value source type indicates that this data point has been measured by a device.

    belongs to
    s4ener:ValueSource

    s4ener:Minimum — Minimum top Named Individuals ToC

    The usage of this datapoint is the Minimum value.

    belongs to
    s4ener:Usage

    s4ener:NaturalGasFlowRate — Natural Gas Flow Rate top Named Individuals ToC

    Gas flow rate described in liters per second

    belongs to
    saref:Commodity

    s4ener:New — New top Named Individuals ToC

    Instruction was newly created

    s4ener:Normal — Normal top Named Individuals ToC

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

    s4ener:NotScheduled — NotScheduled top Named Individuals ToC

    No PPBC.PowerSequence within the PPBC.PowerSequenceContainer is scheduled

    s4ener:Oil — Oil top Named Individuals ToC

    Identifier for Commodity OIL

    belongs to
    saref:Commodity

    s4ener:OilFlowRate — Oil Flow Rate top Named Individuals ToC

    Oil flow rate described in liters per hour

    belongs to
    saref:Commodity

    s4ener:Pause — Pause top Named Individuals ToC

    Load control event action with value 'pause'

    s4ener:Paused — Paused top Named Individuals ToC

    Power sequence state or sensor state with value 'paused'

    s4ener:Pending — Pending top Named Individuals ToC

    Power sequence state with value 'pending'

    s4ener:Power — Power top Named Individuals ToC

    The Property of Power that a Value Property may be about. This concept can be related to observation or property values that are characterized by a certain value that is measured in a power unit (such as watt or kilowatt).

    belongs to
    saref:Property

    s4ener:Preliminary — Preliminary top Named Individuals ToC

    The preliminary version of this concept, usually an incentive table or power plan

    belongs to
    s4ener:ScopeType

    s4ener:Production — Production top Named Individuals ToC

    This datapoint indicates the energy production.

    belongs to
    s4ener:Usage

    s4ener:Reduce — Reduce top Named Individuals ToC

    Load control event action with value 'reduce'

    s4ener:Rejected — Rejected top Named Individuals ToC

    Instruction was rejected

    s4ener:RelativeCost — Relative cost top Named Individuals ToC

    The incentive type ''relative cost'' defined in the incentive table.

    s4ener:RenewableEnergyPercentage — Renewable energy percentage top Named Individuals ToC

    The incentive type ''renewable energy percentage'' defined in the incentive table.

    s4ener:Resume — Resume top Named Individuals ToC

    Load control event action with value 'resume'

    s4ener:Revoked — Revoked top Named Individuals ToC

    Instruction was revoked

    s4ener:Rising — Rising top Named Individuals ToC

    This value tendency codelist element indicates that the tendency of this observation indicates that the value is increasing (i.e., rising).

    s4ener:Running — Running top Named Individuals ToC

    Power sequence state with value 'running'

    s4ener:Scheduled — Scheduled top Named Individuals ToC

    Power sequence state with value 'scheduled'

    s4ener:ScheduledPaused — Scheduled paused top Named Individuals ToC

    Power sequence state with value 'scheduled paused'

    s4ener:SetPoint — Setpoint top Named Individuals ToC

    This datapoint indicates a setpoint.

    belongs to
    s4ener:Usage

    s4ener:Skewness — Skewness top Named Individuals ToC

    The usage of this datapoint is the power skewness (assymetry of the distribution).

    belongs to
    s4ener:Usage

    s4ener:Stable — Stable top Named Individuals ToC

    This value tendency codelist element indicates that the tendency this observation has is to stay stable, instead of rising or falling.

    s4ener:Started — Started top Named Individuals ToC

    Instruction was executed

    s4ener:Succeeded — Succeeded top Named Individuals ToC

    Instruction finished successfully

    s4ener:Upflex — Upflex top Named Individuals ToC

    This datapoint indicates the upper flexibility.

    belongs to
    s4ener:Usage

    s4ener:UpperLimit — Upper limit top Named Individuals ToC

    The PowerEnvelopeLimitType enumeration for the upper limit.

    s4ener:Vanish — Vanish top Named Individuals ToC

    The load or generation that is limited will vanish. This is for example the case with curtailing production from solar panels; the potentially generated energy is lost and will never reappear.

    References

    Normative references

    • [0] ETSI TS 103 410-1 (V2.1.1): "SmartM2M;; Extension to SAREF; Part 1: Energy Domain".
    • [1] ETSI TS 103 264: "SmartM2M; Smart Applications; Reference Ontology and oneM2M Mapping".
    • [2] ETSI TS 103 548: "SmartM2M; SAREF reference ontology patterns".
    • [3] Void.
    • [4] EN 50631-1:2023: "Household appliances network and grid connectivity - Part 1: General requirements, generic data modelling and neutral messages", (produced by CEN).
    • [5] EN 50631-2:2023: "Household appliances network and grid connectivity - Part 2: Product specific mappings, details, requirements and deviations", (produced by CEN).
    • [6] EN 50631-3-1:2023: "Household appliances network and grid connectivity - Part 3-1: Specific Data Model Mapping: SPINE and SPINE-IoT", (produced by CEN).
    • [7] EN 50631-4-1:2023: "Household appliances network and grid connectivity - Part 4-1: Communication Protocol Specific Aspects: SPINE, SPINE-IoT and SHIP", (produced by CEN).
    • [8] EN 50491-12-2:2022: "General requirements for Home and Building Electronic Systems (HBES) and Building Automation and Control Systems (BACS) - Part 12-2: Smart grid - Application specification - Interface and framework for customer - Interface between the Home / Building CEM and Resource manager(s) - Data model and messaging", (produced by CEN).

    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.