device code Provides a device code for the device as defined by the manufacturer. 1 1 Event started Load control state with value 'event started' 1 0 device name Provides the name of the device as defined by the manufacturer. Load control event data 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). 1 Event cancelled Load control state with value 'event cancelled' Duration uncertainty description The duration description for the duration uncertainty temporal entity Load control state data The representation of the state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter). 1 0 exposes A relationship between a device and its power profile vendor code Provides a code for the vendor of the device as defined by the manufacturer. has value type A relation representing the value type of an entity dc alternatives count Indicates the number of alternatives groups provided by a power profile greenest Indicates whether a power sequence optimises the configuration towards the maximum availability of renewable energy (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE. 1 active repetition number 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. Event rejected Load control state with value 'event rejected' duration in xsd This property is added to the time:DurationDescription class to allow to express time duration also as xsd:duration. This is necessary because in the EEBus/E@h model time is always expressed as xsd:duration. We use this property to express the following time information in the EEBus/E@h model: - the startTime of the power sequence (in the PowerSequence class). SHALL be present - the endTime of the power sequence (in the PowerSequence class). If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted. - the startTime of measurement as absolute or relative value (in the Measurement class). - the endTime of measurement as absolute or relative value (in the Measurement class). The duration is expected to be described as in xsd:duration https://saref.etsi.org/saref4ener/ 2020-06-04 SAREF4ENER is an extension of SAREF for the Energy domain that was created in collaboration with Energy@Home (http://www.energy-home.it) and EEBus (http://www.eebus.org/en), the major Italy- and Germany-based industry associations, to enable the interconnection of their (different) data models. SAREF4ENER focuses on demand response scenarios, in which customers can offer flexibility to the Smart Grid to manage their smart home devices by means of a Customer Energy Manager (CEM). The CEM is a logical function for optimizing energy consumption and/or production that can reside either in the home gateway or in the cloud. SAREF4ENER is published as an ETSI tecnical specificatoion (ETSI TS 103 410-1). 2015-09-04 s4ener 2016-12-13 v1.1.2 SAREF4ENER: an extension of SAREF for the energy domain created in collaboration with Energy@Home and EEBus associations 1 Energy expected A possible type of energy in a slot that represents the expected energy consumption and its value Elapsed slot time If state is set to 'running' or 'paused' AND the slot is determined, this element CAN contain the time the slot has already been in 'running' state (this also means the value remains constant during a 'paused' state). Otherwise it SHALL be omitted. cheapest Indicates whether a power sequence applies a configuration that minimises the user’s energy bill (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE. Power sequence The specification of a task, such as wash or tumble dry, according to user preferences and/or manufacturer's settings for a certain device. It is the most 'coarse' view, a power sequence can represent all single steps of a whole task,where the single steps are represented by slots. If the power sequence is pausable by the bound power sequences client, the property 'saref:isInterruptionPossible' SHALL be present and set to true. Otherwise it SHALL be omitted. If the power sequence is stoppable by the bound power sequences client, the property 'saref:isFlexible' SHALL be present and set to true. Otherwise it SHALL be omitted. measuredValue has device 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. 1 node remote controllable 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. 1 1 value source Indicates the source (origin/foundation) of the measurement forecasted values for a power sequence. If absent, the source is undefined. Remark: This element shall express the reliability of the forecast. unknown Power max A possible type of power in a slot that represents the maximum power consumption and its value Energy min A possible type of energy in a slot that represents the minimum energy consumption and its value measurement id Enables the identification of different sensors on one EEBus address. 1 1 1 Slot The single steps of a power sequence are represented by slots. A slot is associated with a slot number (while a power sequence is associated with a power sequence identifier). The slot numbers of two power sequences should be considered independent from each other, i.e., slot number 7 of sequence 1 describes a different slot than slot number 7 of sequence 2. Therefore a slot is only uniquely identified in combination with a sequence ID. Reduce Load control event action with value 'reduce' max cycles per day States the maximum amount of starts a power sequence (of a device) allows per day. Activation delay duration description The duration description for the activation delay duration temporal entity receives A relationship between a device (e.g., an appliance or a smart meter) and a load control event 0 Resume Load control event action with value 'resume' Start time The startTime of a power sequence or slot. SHALL be present 1 Resume energy estimated In a power sequence, the additional energy the device will consume before resuming its normal operation (after a pause). This is only an estimated value which will not be added to the value stated in any slot value information. 0 1 Alternatives group A collection of power sequences for a certain profile Normal The value NORMAL used to instantiate the Load Control Event Action class and MeasurandState class emergency 1 manufacturer node identification Indicates a node identification for the device as defined by the manufacturer. This could be used for the identification of a device, even if it was removed from the network and rejoined later with changed node address. 1 is pausable Specifies if the power sequence is pausable. Scheduled Power sequence state with value 'scheduled' vendor name Provides the name of the vendor of the device as defined by the manufacturer. 1 0 manufacturer description A description for the device as defined by the manufacturer. supports reselection 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. Active duration max The active maximum duration a power sequence can run without interruption. warning Power profile 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). has power value type A relationship representing a power value type 0 1 value tendency Indicates whether the tendency of a measurement is rising, stable or falling. 1 Power Power type and value in a slot (i.e. power, powerMin, powerMax, powerExpectedValue, powerStandardDeviation, powerSkewness) 1 1 Power standard deviation A possible type of power in a slot that represents the power standard deviation and its value Load Control event action 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). Device A specialization of a saref:Device that exposes a power profile with power sequences to the CEM (note that a s4ee:Device can also be called 'power sequence server'). Most of the existing devices can expose at most 1 power profile, but there are special cases in which more than one power profiles can be exposed by the same device. For example, consider the case of a combined fridge-freezer in which there are 2 logical devices (fridge and freezer) combined in 1 physical device. This combined device can expose 2 power profiles, one for the fridge and one for the freezer. A s4ee:Device (e.g. a household appliance or a smart meter) can also receive events about overload warning severity level and related load control commands (LoadControlEventData) 1 Default duration 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 Max anticipation This field allows the anticipation of the phase if (and only if) the previous phase has the energy set to 0 Wh, each unit is a minute. Completed Power sequence state with value 'completed' 1 0 Activation delay The scheduled activation delay for a slot. Resume cost estimated In a power sequence the additional costs for the resumption of a device to its normal operation (after a pause). Event stopped Load control state with value 'event stopped' 1 Active duration sum min The active minimum duration a power sequence must run in total (summation of all active times). Inactive Power sequence state with value 'inactive' 1 1 End time 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. 0 1 Power sequence state The current state of the power sequence. It can assume one of the values 'running', 'paused', 'scheduled', 'scheduled paused', 'pending', 'inactive', 'completed', or 'invalid'. Slot time duration description The duration description for the slot time duration temporal entities 1 1 0 End time duration Description The duration description for the end time duration temporal entities 1 Pause duration max The maximum duration a power sequence can pause after the end of an activity. Energy Standard Deviation A possible type of energy in a slot that represents the energy standard deviation and its value 1 Power min A possible type of power in a slot that represents the minimum power consumption and its value Load control event state 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). 1 Pause Load control event action with value 'pause' Energy skewness A possible type of energy in a slot that represents the energy skewness and its value event ID Used in the Demand Response use case to identify an event logging messaging type Indicates the type of the message. Possible values are: - logging (used for messages, that shall be stored in a log file) - information (messages, that shall be presented to the customer on a display; lower priority) - warning (messages, that shall be presented to the customer on a display; medium priority) - alarm (messages, that shall be presented to the customer on a display; high priority; if there is an alarm device in the household, it shall generate an alarm) - emergency (messages, that shall be presented to the customer on a display; very high priority; if there is an alarm device in the household, it shall generate an alarm; additionally, if possible and configured, an emergency call shall be done) - obsolete (previously sent messages, that shall be marked as obsolete) belongs to 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. 1 Active duration description The duration description for the active duration (min and max, sum max and sum min) temporal entities has energy value type A relationship representing an energy value type Pending Power sequence state with value 'pending' 1 0 1 has event state consume A relationship between the specification of the state of a load control event consume and the value that this state can assume. 0 Earliest start time 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. has connection In the Remote Network Management (RemoteNWM) use case, a relationship between a node in a network (i.e., a s4ee:Device) and its connections (i.e., a s4ee:DeviceConnections). The same s4ee:Device (or node) can have multiple device connections as it can be connected to several networks at the same time. power source Indicates the power source of a device. Possible values are e.g. mainsSinglePhase or battery Latest end time 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. Time period The time period associated with load control event data Event action consume 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). software revision Indicates the software revision of a device as defined by the manufacturer. Time period duration description The duration description for the time period duration temporal entities task identifier Represents the task identifier of the power sequence. Max activation delay Maximum delay time between the end of the previous slot and the beginning of the current slot. alternatives group ID The endpoint-wide unique identifier for the alternatives group instances provided by a power profile 1 Pause time The pause time of a power sequence or a slot slot activated 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. 1 Max duration 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 Actuator switch 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. Remaining pause time 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. 1 1 has applied event action consume A relationship between the state of a load control event consume and the action to be performed as a consequence of this event. Active duration min The active mininum duration a power sequence can run without interruption. activate slot 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). Scheduled paused Power sequence state with value 'scheduled paused' 1 Event state consume In the load control, it expresses a consume state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter). Event action produce 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). hardware revision Indicates the hardware revision of the device as defined by the manufacturer. Pause duration description The duration description for the pause duration (max and min) temporal entities 1 has energy A relationship between a power sequence and its energy (in terms of value and unit of measure) Emergency Load control event action with value 'emergency' 1 Paused Power sequence state or sensor state with value 'paused' sequence remote controllable 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. 1 information Increase Load control event action with value 'increase' Invalid Power sequence state with value 'invalid' Anticipation duration description The duration description for the anticipation duration temporal entities Power skewness A possible type of power in a slot that represents the power skewness and its value Energy Energy type and value in a slot (i.e., Energy, EnergyMin, EnergyMax, EnergyExpected, EnergyStandardDeviation, EnergySkewness); or the ResumeEnergyEstimated in a power sequence, i.e., the additional energy the device will consume before resuming its normal operation (after a pause) triggers event action consume A relationship between a load control event and the consume action triggered by this event 1 1 1 optional slot 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. alarm slot number Provides a unique slot identifier for a certain power sequence Event accepted Load control state with value 'event accepted' mains3Phase active slot number Indicates the currently active slot number, if the power sequence state is set to 'running' or 'paused'. Otherwise it SHALL be omitted. obsolete 1 1 Active duration sum max The active maximum duration a power sequence can run in total (summation of all active times). Running Power sequence state with value 'running' Event error Load control state with value 'event error' Power expected A possible type of power in a slot that represents the expected power consumption and its value triggers event action produce A relationship between a load control event and the produce action triggered by this event Default duration description The duration description for the default duration temporal entity 0 serial number Indicates the serial number of a device as defined by the manufacturer. Usually the same as printed on the case. repetition total 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. 1 supports single slot scheduling only If set toTRUE, the power profile of a device does NOT permit the modification of more than one slot per configuration command. is stoppable Specifies if the power sequence is stoppable. 1 Duration uncertainty The uncertainty of the duration 1 1 1 Energy max A possible type of energy in a slot that represents the maximum energy consumption and its value 1 1 Min duration 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. 1 manufacturer label A short label of the device as defined by the manufacturer. messaging number An identifier for one specific message. If a message is marked as obsolete, this number can be used to identify the original message. State An entity that represents the possible states in SAREF4EE has event state produce A relationship between the specification of the state of a load control event produce and the value that this state can assume. 1 1 stable 1 brand name Provides the name of the brand of a device. Useful where the name of the brand and the vendor differs. total sequences count max Represents the total number of power sequences supported by the power profile of a device Event state produce 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). has function A relationship identifying the functions performed by an actuator level and an actuator switch 1 0 rising Remaining slot time 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. mainsSinglePhase sequence ID Provides a unique power sequence identifier for a certain device 1 falling 0 1 Start time duration description The duration description for the start time duration temporal entities 1 1 1 1 battery has applied event action produce A relationship between the state of a load control event produce and the action to be performed as a consequence of this event. calculatedValue Actuator level 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. Pause duration min The minimum duration a power sequence can pause after the end of an activity. empiricalValue has expression A relationship between an appliance parameter compatibility action and the associated expressions