An Interaction Affordance that allows to invoke a function of the Thing, which manipulates state (e.g., toggling a lamp on or off) or triggers a process on the Thing (e.g., dim a lamp over time).
A property related to some measurements that are characterized by a certain value that is measured in a power unit (such as watt or kilowatt).
A function that allows to transmit data to actuators, such as level settings (e.g., temperature) or binary switching (e.g., open/close, on/off)
Actuating function
A device responsible for moving or controlling a mechanism or system by performing an actuating function
Actuator
A device that is used by, or implements, an (Actuation) Procedure that changes the state of the world.
Property of the environment indicating the humidity.
The Ambient sensor can measure the ambient temperature and humidity
An electrical/mechanical machine that accomplish some household functions, such as cleaning or cooking
Appliance
"An area unit which is equal to an area enclosed by a square with sides each 1 meter long." [NIST:NIST]
The level of remaining battery (if any : in percent) for a device.
A building represents a structure that provides shelter for its occupants or contents and stands in one place. The building is also used to provide a basic element within the spatial structure hierarchy for the components of a building project (together with site, storey, and space). The basement floor of a building is floor number 0.
A property representing the carbon dioxide concentration that can be measured in "ppm".
A type of task for which a device is designed
Cleaning
A type of command
Close command
The state of a device that is CLOSE
Close state
A type of commodity
Coal
Comfort
A directive that a device must support to perform a certain function. A command may act upon a state, but does not necessarily act upon a state. For example, the ON command acts upon the ON/OFF state, but the GET command does not act upon any state, it simply gives a directive to retrieve a certain value. We propose here a list of commands that are relevant for the purpose of SAREF, but this list can be extended.
Command
A marketable item for which there is demand, but which is supplied without qualitative differentiation across a market. SAREF refers to energy commodities such as electricity, gas, coal and oil.
Commodity
A controller is a device that monitors inputs and controls outputs within a building automation system. A controller may be physical (having placement within a spatial structure) or logical (a software interface or aggregated within a programmable physical controller).
"A volume unit which is equal to the volume of a cube with edges one meter in length. One cubic meter equals to 1000 liters." [NIST:NIST]
A tangible object designed to accomplish a particular task. In order to accomplish this task, the device performs one or more functions. For example, a washing machine is designed to wash (task) and to accomplish this task it performs a start and stop function.
Device
A switch that performs the saref:OpenCloseFunction, is used for controlling a door, and can be found in the state saref:OpenCloseState. A saref:DoorSwitch is typically used to accomplish saref:Safety.
Door switch
Drying
Represent an electric vehicule charching appliance.
Electricity
A device built to accurately detect and display energy in a form readable by machines.
A saref:Property related to some measurements that are characterized by a certain value measured in an energy unit (such as Kilowatt_Hour or Watt_hour). Furter specializations of the saref:Energy class can be found in the SAREF4ENER extension, where classes such as EnergyMax, EnergyMin and EnergyExpected are defined.
Energy
Entertainment
An Interaction Affordance that describes an event source, which asynchronously pushes event data to Consumers (e.g., overheating alerts).
A function that allows to notify about some relevant activity; e.g., that a certain threshold value has been exceeded or that some object has moved.
Event function
A feature of interest represents any real world entity from which a property is measured.
Feature of interest
The functionality necessary to accomplish the task for which a device is designed. A device can be designed to perform more than one function. Functions can be structured in categories (subclasses) that reflect different points of view, for example, considering the specific application area for which a function can be used (e.g., light, temperature, motion, heat, power, etc.), or the capability that a function can support (e.g., receive, reply, notify, etc.), and so forth.
Function
Gas
Gas boilers are used to provide hot water and heating to households.
Represent the actuator of the gas boiler.
A gas meter is a specialized flow meter, used to measure the volume of fuel gases such as natural gas and liquefied petroleum gas. Gas meters are used at residential, commercial, and industrial buildings that consume fuel gas supplied by a gas utility
Get command
A type of get command
Get current meter value command
Get meter data command
Get meter history command
Get sensing data command
A heat meter is a device which measures thermal energy provided by a source or delivered to a sink, by measuring the flow rate of the heat transfer fluid and the change in its temperature (ΔT) between the outflow and return legs of the system.
A heat pump appliance is used to warm and sometimes also cool buildings by transferring thermal energy from a cooler space to a warmer space using the refrigeration cycle, being the opposite direction in which heat transfer would take place without the application of external power
A saref:Property related to some measurements that are characterized by a certain value that is measured in a humidity unit
Humidity
The humidity sensor measures the concentration of water vapor in air.
Metadata of a Thing that shows the possible choices to Consumers, thereby suggesting how Consumers may interact with the Thing. There are many types of potential affordances, but W3C WoT defines three types of Interaction Affordances: Properties, Actions, and Events.
An actuating function that allows to do level adjustments of a property in a certain range (e.g., 0%-100%), such as dimming a light in a room or setting the speed of an electric motor.
Level control function
A saref:Property related to some measurements that are characterized by a certain value that is measured in a illuminance unit (lux)
Light
A switch that performs the saref:OnOffFunction, controls the property saref:Light, and can be found in the state saref:OnOffState. It can offer a switch on service. A saref:LightSwitch is typically used to accomplish saref:Lighting.
Light switch
Lighting
Represents the measured value made over a property. It is also linked to the unit of measure in which the value is expressed and the timestamp of the measurement.
Measurement
A device built to accurately detect and display a quantity in a form readable by a human being. Further, a device of category saref:Meter that performs a saref:MeteringFunction.
Meter
A device that measure usage or consumption of some media --- typically a form energy or power.
Meter reading
A function that allows to get data from a meter, such as current meter reading or instantaneous demand
Metering function
A saref:Property related to some measurements that are characterized by a certain value that is measured in a unit of measure for motion
Motion
A type of state
Multi level state
Notify command
A saref:Property related to some measurements that are characterized by a certain value (saref:hasValue property) that is measured in a unit of measure for occupancy
Occupancy
Off command
The state of a device that is Off
Off state
On command
An actuating function that allows to switch on and off an actuator
On off function
On off state
The state of a device that is On
On state
An actuating function that allows to open and close a device
Open close function
Open close state
Open command
The state of a device that is OPEN
Open state
Enumeration of well-known operation types necessary to implement the WoT interaction model
Repesent the temperature property oustide a building.
A dimensionless concentration notation which denotes the amount of a given substance in a total amount of 1,000,000 regardless of the units of measure used as long as they are the same or 1 part in 10^[6].
"A dimensionless concentration notation which describes the amount of one substance in another. It is the ratio of the amount of the substance of interest to the amount of that substance plus the amount of the substance." [Wikipedia:Wikipedia]
Pause command
Represent the temperature of the pipe. It typically requires that pipe be kept to a temperature just above freezing typically at 40°F (4.4°C).
A saref:Property related to some measurements that are characterized by a certain value that is measured in a power unit (such as watt or kilowatt). Further specializations of the saref:Power class can be found in the SAREF4ENER extension, where classes such as PowerMax, PowerMin and PowerExpected are defined.
Power
A saref:Property related to some measurements that are characterized by a certain value that is measured in a pressure unit (bar or pascal)
Pressure
A saref:Property crelated to some measurements that are characterized by a certain value that is measured using saref:Currency
Price
A specification associated to a device to collect information about a certain Property (e.g., Energy) for optimizing its usage in the home, office or building in which the device is located. This specification is about a certain Property (saref:isAbout), can be calculated over a time span (saref:hasTime) and can be associated to some costs (saref:hasPrice). An example is the Power Profile defined in the SAREF4ENER extension that can be associated to a device for optimizing the Energy efficiency in the home, office or building in which the device is located.
Profile
A quality of a feature of interest that can be measured; an aspect of a feature of interest that is intrinsic to and cannot exist without the feature
Property
An Interaction affordance that exposes state of the Thing. This state can then be retrieved (read) and optionally updated (write). Things can also choose to make Properties observable by pushing the new state after a change.
An Interaction Affordance that exposes state of the Thing. This state can then be retrieved (read) and/or updated (write). Things can also choose to make Properties observable by pushing the new state after a change.
This sensor measures the return temperature.
Safety
A function that allows to transmit data from sensors, such as measurement values (e.g., temperature) or sensing data (e.g., occupancy)
Sensing function
A device that detects and responds to events or changes in the physical environment such as light, motion, or temperature changes. Further, a device of category saref:Sensor that performs a saref:SensingFunction.
Sensor
Device, agent (including humans), or software (simulation) involved in, or implementing, a Procedure. Sensors respond to a stimulus, e.g., a change in the environment, or input data composed from the results of prior Observations, and generate a Result. Sensors can be hosted by Platforms.
A service is a representation of a function to a network that makes the function discoverable, registerable, remotely controllable by other devices in the network. A service can represent one or more functions. A Service is offered by a device that wants (a certain set of) its function(s) to be discoverable, registerable, remotely controllable by other devices in the network. A Service must specify the device that is offering the service and the function(s) to be represented.
Service
A type of set level command
Set absolute level command
Set level command
Set relative level command
Represent a household of a single family.
A saref:Property related to some measurements that are characterized by a certain value that is measured in a unit of measure for smoke
Smoke
A sensor that performs the saref:SensingFunction and the saref:EventFunction, and is used for the purpose of sensing a property of type saref:Smoke. A saref:SmokeSensor is typically used to saref:accomplish saref:Safety.
Smoke sensor
A solar panel, or photo-voltaic (PV) module, is an assembly of photo-voltaic cells mounted in a framework for installation. Solar panels use sunlight as a source of energy and generate direct current electricity.
A part of the physical world or a virtual world whose 3D spatial extent is bounded actually or theoretically, and provides for certain functions within the zone it is contained in.
Space Hearting
Start command
The state of a device that is STARTED
Start state
An actuating function that allows to start and stop a device
Start stop function
Start stop state
The state in which a device can be found, e.g, ON/OFF/STANDBY, or ONLINE/OFFLINE. We propose here a list of states that are relevant for the purpose of SAREF, but this list can be extended.
State
Step down command
Step up command
Stop command
The state of a device that is STOPPED
Stop state
This sensor measures the supplied temperature by a directly from the heater.
A device of category saref:Actuator that performs an actuating function of type saref:OnOffFunction or saref:OpenCloseFunction
Switch
A type of service that represents an on/off function to the network
Switch on service
The goal for which a device is designed (from a user perspective). For example, a washing machine is designed for the task of washing. We propose here a list of tasks that are relevant for the purpose of SAREF, but this list can be extended. Tasks can be accomplished by devices (saref:isAccomplishedBy).
Task
A saref:Property related to some measurements that are characterized by a certain value that is measured in a temperature unit (degree_Celsius, degree_Fahrenheit, or degree_kelvin)
Temperature
A sensor that is used for the purpose of sensing a property of type saref:Temperature. A saref:TemperatureSensor is typically used to saref:accomplish saref:Comfort.
Temperature sensor
A sensor that is used for the purpose of sensing the temperature property.
An automatic control device used to maintain temperature at a fixed or adjustable setpoint.
A class that allows to specify the time concept.
Time
Toggle command
A unit of measurement is a definite magnitude of a quantity, defined and adopted by convention and/or by law. It is used as a standard for measurement of the same quantity, where any other value of the quantity can be expressed as a simple multiple of the unit of measure. For example, length is a quantity; the metre is a unit of length that represents a definite predetermined length. When we say 10 metre (or 10 m), we actually mean 10 times the definite predetermined length called "metre".
In electric power transmission and distribution, volt-ampere reactive (var) is a unit in which reactive power is expressed in an AC electric power system.
"A unit which is a standard measure of the amount of space occupied by any substance, whether solid, liquid, or gas." [NIST:NIST]
Washing
Water
Water flow refers to the amount of water coming out of a hose, faucet or other pipe fixture in a certain amount of time.
A water meter is an instrument intended to measure continuously, memorize, and display the volume of water passing through the meter.
This sensor measures the water temperature.
Water volume means the quantity of water that can be measured in liters, cubic meters, gallons, milliliters, teaspoons, and ounces, though many other units exist.
WellBeing
A relationship between a certain entity (e.g., a device) and the task it accomplishes
accomplishes
A relationship between a command and a state
acts upon
Operation type of forms used to cancel an action
A relationship specifying the property that can be controlled by a certain device
controls property
A Thing may define abstract security schemes, used to configure the secure access of (a set of) affordance(s).
description of the TD element (Thing, interaction affordance, security scheme or data schema)
description of the TD element (Thing, interaction affordance, security scheme or data schema) with language tag. By convention, a language tag must be added to the object of 'descriptionInLanguage' triples. Otherwise, use 'description'.
All Action-based interaction affordance of the Thing.
Defines any data that needs to be passed to cancel a subscription, e.g., a specific message to remove a Webhook
A relationship between a function and a command
has command
Instantiation, as used here, is a form of non-symmetric equivalence between a scheme and a configuration: whatever statement on the scheme is also true of the configuration but not vice-versa.
A relationship providing a description of an entity (e.g., device). The value is expected to be a string or a string with language tag.
DEPRECATED: The use of rdfs:comment is recommended instead.
has description
All Event-based interaction affordance of the Thing.
Set of form hypermedia controls that describe how an operation can be performed. Forms are serializations of Protocol Bindings.
A relationship identifying the function of a device
has function
Used to define the input data schema of the action.
Offers an affordance to interact with the Thing
Provides Web links to arbitrary resources that relate to the specified Thing Description.
A relationship identifying the manufacturer of an entity (e.g., device). The value is expected to be a string or a string with language tag.
has manufacturer
A relationship between a feature of interest and a measurement about it
has measurement
A relationship between a metering function and the measurement of the reading
has meter reading
A relationship identifying the reading type of a metering function (e.g., Water, Gas, Pressure , Energy , Power, etc.)
has meter reading type
A relationship identifying the model of an entity (e.g., device). The value is expected to be a string or a string with language tag.
has model
Defines the data schema of the Event response messages sent be the consumer in a response to a data message.
Defines the data schema of the Event instance messages pushed by the Thing.
Used to define the output data schema of the action.
A relationship associating a profile to a certain device
has profile
A relationship between a feature of interest and a property of that feature
has property
All Property-based interaction affordance of the Thing.
A security configuration is a a security scheme applied to a (set of) affordance(s).
A relationship between a sensing function and a measurement identifying the range of a sensor detection
has sensing range
A relationship identifying the sensing type of a sensor detection (i.e., Temperature, Occupancy, Humidity, Motion , Smoke, Pressure, etc.)
has sensor type
A relationship identifying the type of state of a device
has state
Defines data that needs to be passed upon subscription, e.g., filters or message format for setting up Webhooks.
A relationship associated with an event function to notify that a certain threshold measurement has been exceeded
has threshold measurement
A relationship to associate time information to an entity
has time
A relationship stating the timestamp of an entity (e.g. a measurement).
has timestamp
This defines the total surface of a dCO:Space measured in square meter
A relationship identifying the typical (energy or power) consumption of a device
has typical consumption
Define URI template variables according to RFC6570 as collection based on schema specifications. The individual variables DataSchema cannot be an ObjectSchema or an ArraySchema.
A relationship defining the value of a certain property, e.g., energy or power. Note that, even if numeric values are expected to enable reasoning, measurement values could use other datatypes.
has value
Operation type of forms used to read a property value
A relationship identifying what an entity, such as a profile, is about
isAbout
A relationship identifying an entity (e.g., a device) that can accomplish a task.
is accomplished by
A relationship between a command and a function.
is command of
A relationship specifying the devices that can control a certain property
is controlled by device
Indicates whether the action is idempotent (=true) or not. Informs whether the action can be called repeatedly with the same result, if present, based on the same input.
A relationship specifying the devices that can measure a certain property
is measured by device
A relationship identifying the unit of measure used for a certain entity.
is measured in
A relationship between a measurement and the feature of interest whose quality was measured
isMeasurementOf
A hint that indicates whether Servients hosting the Thing and Intermediaries should provide a Protocol Binding that supports the observeproperty and unobserveproperty operations for this Property.
A relationship between a service and a device that offers the service
is offered by
A relationship between a property and the feature of interest it belongs to
is property of
Signals if the action is safe (=true) or not. Used to signal if there is no internal state (cf. resource state) is changed when invoking an Action. In that case responses can be cached as example.
A relationship specifying the commodity for which a device is used for
is used for
A relation between a device and the measurements it makes. Such measurement will link together the value of the measurement, its unit of measure and the property to which it relates.
makes measurement
A relation between a measurement and the device that made it.
measurement made by
A relationship specifying the property that can be measured by a certain device
measures property
Indexing property to store entity names when serializing them in a JSON-LD @index container.
Operation type of forms used to observe all property values
Operation type of forms used to observe a property value
A relationship between a device and a service
offers
Operation type of forms used to query the status of an action
Operation type of forms used to query the status of all actions
Operation type of forms used to read all property values
A relationship between a property and the measurements it relates to
relates to measurement
A relationship between a measurement and the property it relates to
relates to property
A relationship between a service and a function.
represents
Operation type of forms used to subscribe to all event types
title of the TD element (Thing, interaction affordance or data schema)
title of the TD element (Thing, interaction affordance or data schema) with language tag. By convention, a language tag must be added to the object of 'titleInLanguage' triples. Otherwise, use 'title'.
Operation type of forms used to unobserve all property value
Operation type of forms used to unobserve a property value
Operation type of forms used to unsubscribe from all event types
Operation type of forms used to write a property value