We are going to replace the live support session on Mondays by a more flexible calendar service where you can book a 30 min slot for getting support on your data model design or use.
Always available in the upper part of the page.
We are going to replace the live support session on Mondays by a more flexible calendar service where you can book a 30 min slot for getting support on your data model design or use.
Always available in the upper part of the page.
There is a new data model, WoodworkMachine, resembling the OPC UA WWMachine available in the subject dataModel.OPCUA.
In our Twitter account @smartdatamodels now it will be twit twice a day (9:00 and 15:00) a link with the chosen data model of the day. Follow
Enjoy!!
In the subject datamodel.AutonomousMobileRobots there is 5 new data models for managing the messages interchange with Atunomouse mobile robots.
CommandMessage. Command message
CommandReturnMessage. Command return message
StateMessage. State message
StopCommandMessage. Stop Command message
StopCommandReturnMessage. Stop Command Return Message
There is a new subject dataModel.IT for the management of IT infrastructures.
In this new subject, there are two new data models CloudRegion and ITTests.
CloudRegion. Cloud region description.
ITTests. This is the data model for representing the result of testing procedures.
Thaks to the collaboration with the open connectivity foundation there 66 new data models in very different scenarios, from Air qualty testing, blood pressure, Co2 detection, speed or weight.
Check them out at the specific subject for these models datamodel.OCF
Here you have the full lst.
3DPrinter. This Resource describes the attributes associated with 3D Printer. The type of 3D printing technology is specified by an enumerated string value. The maximum sizes in mm are included for the x, y, and z dimensions. A designation of whether the device is capable of WAN connectivity is represented in a boolean. The memory capacity is captured in MB.
Activity. This Resource describes the Properties associated with a person’s physical activity. All Properties are read-only values that are provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
AirFlow. This Resource describes Properties associated with air flow.The Property ‘supporteddirections’ is the set of valid values for the direction property for a particular instance of this Resource Type.The Property ‘direction’ is the directionality of the air flow if applicable, if Property ‘supporteddirections’ is also present it must be a value from that set. The values of Property ‘direction’ are dependent on the capabilities of the unit.The Property ‘speed’ is an integer representing the current speed level for the unit.The Property ‘range’ is an array of the min,max values for the speed level. If not present the ‘range’ defaults to [0,100]. Property ‘automode’ is the status of the automode feature; Off means automode is not enabled, On means automode is active and the speed is automatically controlled by the Device.
AirQuality. This Resource describes a qualitative or measured contaminant that can be used to infer Air Quality.The Property ‘valueType’ indicates a qualitative or measured reading within the contaminantvalue Property.The Property ‘contaminantvalue’ can contain the actual sensed value with units per contaminant type.Qualitative is a representative value within the range provided where the minimum value is minimum contamination and maximum value is maximum contamination for the specific contaminant.The Property ‘contaminantvalue’ contains the actual measured or qualitative level.The Property ‘range’ contains the allowed range for the value that is being reported.If valueType is ‘Measured’ then the units for the contaminant types are as follows: Methanol (also known as Formaldehyde): CH2O (ug/m^3), Carbon Dioxide: CO2 (ppm), Carbon Monoxide: CO (ppm), Particulate Matter (less than 1 micron in diameter): PM1 (ug/m^3), Particulate Matter (less than 2.5 microns in diameter): PM2.5 (ug/m^3), Particulate Matter (less than 10 microns in diameter): PM10 (ug/m^3), Volatile Organic Compounds: VOC (ug/m^3), Ozone: 03 (ppm), Nitrogen dioxide: NO2 (ppm), Sulphur dioxide: SO2 (ppm)
Alarm. This Resource describes the Properties associated with alarm status.
Altimeter. This Resource describes the properties associated with altimeter.The Property ‘alt’ is the distance (metres) above or below ‘local’ sea-level.
atmosphericPressure. This Resource provides a measurement of Mean Sea Level Pressure experienced at the measuring point expressed in millibars.The Property ‘atmosphericPressure’ is a float which describes the atmospheric pressure in hPa (hectoPascals).Note that hPa and the also commonly used unit of millibars (mbar) are numerically equivalent.
BloodPressure. This Resource describes the Properties associated with a person’s blood pressure.The unit is a single value that is one of mmHg or kPa.If the unit Property is missing the default is a millimeter of mercury [mmHg].The bloodpressure and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
BMI. This Resource describes the Properties associated with a person’s Body Mass Index (BMI).The unit, which is the default unit, is kg/m^2.The bmi and unit Properties are read-only values that are provided by the server.When range is omitted the default is 0 to +MAXFLOAT.
BodyFat. This Resource describes the Properties associated with a person’s body fat.The unit is a single value that is one of kg, lb or percent.If the unit Property is missing the default is kilograms [kg].The bodyfat and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
BodyFatFreeMass. This Resource describes the Properties associated with a person’s body fat free mass.The unit is a single value that is one of kg, lb or percent.If the unit Property is missing the default is kilograms [kg].The ffm and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
BodySoftLeanMass. This Resource describes the Properties associated with a person’s body soft lean mass.The unit is a single value that is one of kg, lb or percent.If the unit Property is missing the default is kilograms [kg].The slm and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
BodyWater. This Resource describes the Properties associated with a person’s body water.The unit is a single value that is one of kg or lb.If the unit Property is missing the default is kilograms [kg].The bwater and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
Cadence. This Resource describes the cadence, which is the number of revolutions of crank per minute when cyclists pedal the pedals. The unit, which is the default unit, is rpm. The cadence Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
capacity. This Resource describes the capacity (heating or cooling) of a HVAC system. ‘capacity’ is a number in units of kW (kilowatts). To convert from kW to other units that may be commonly used in certain geographic locales the following conversions should be applied: – to convert to BTU/hr: BTU/hr = 3412.142 * kW – to convert to ton: ton = kW/3.5168525
CircuitBreaker. This Resource describes functions for the control and monitoring of IEC 61850 based circuit breaker.
CO. This Resource describes whether carbon monoxide has been sensed or not.The Property ‘value’ is a boolean.A value of ‘true’ means that carbon monoxide has been detected.A value of ‘false’ means that carbon monoxide has not been detected.
CO2. This Resource describes whether carbon dioxide has been sensed or not.The Property ‘value’ is a boolean.A value of ‘true’ means that carbon dioxide has been detected.A value of ‘false’ means that carbon dioxide has not been detected.
ColourRGB. This Resource specifies the actual colour in the RGB space represented as an array of integers.Each colour value is described with a Red, Green, Blue component.These colour values are encoded as an array of integer values ([R,G,B]).The minimum and maximum colour value per component may be described by the Property ‘range’.When ‘range’ is omitted, then the ‘range’ is [0,255].
ColourTemp. This Resource describes the colour using colour temperature conventions.The Property ‘ct’ is the Mired colour temperature.The equivalent value in Kelvin is obtained by Colour Temp(K) = 1,000,000/Colour Temp(Mired)THe Resource provides the colour using colour temperature conventions.
Consumption. This Resource describes Properties associated with the energy associated with the consumption of natural gasThe gas value is in kilowatt hours [kWh].The volume value is in metres cubed [m3].Provides the cumulative gas energy, the cumulative gas volume and the calorific value and conversion factor used/required to convert from gas volume (m3[TB1]) to gas energy (KWh).
Contact. This Resource describes whether a contact sensor has been tripped or not.Typical use case is in Security Systems detecting window or door open.The Property ‘value’ is a boolean.A value of ‘true’ means that contact has been broken (open).A value of ‘false’ means that contact is in place (closed).
ContinuousGlucoseMeterCalibrate. This Resource describes the Properties associated with Calibrate for Continuous Glucose Meter (CGM).
ContinuousGlucoseMeterSamplingInterval. This Resource describes the Properties associated with Sampling Interval for Continuous Glucose Meter (CGM).
ContinuousGlucoseMeterSensor. This Resource describes the Properties associated with Sensor for Continuous Glucose Meter (CGM).
ContinuousGlucoseMeterStatus. This Resource describes the Properties associated with Status for Continuous Glucose Meter (CGM).
ContinuousGlucoseMeterThreshold. This Resource describes the Properties associated with Threshold for Continuous Glucose Meter (CGM).
Dimming. This Resource describes a dimming function.The Property ‘dimmingSetting’ is an integer showing the current dimming level.If Property ‘step’ is present then it represents the increment between dimmer values.When the Property ‘range’ is omitted, then the range is [0,100].A value of 0 means total dimming; a value of 100 means no dimming.
DRLC. This Resource describes any to be applied or currently being applied DRLC signal.The Property ‘DRType’ is the ApplianceLoadReductionType defined in Zigbee/HA Smart Energy Profile 2.0.The Property ‘start’ is a string containing an RFC3339 encoded start time.The Property ‘duration’ value is in minutes.The Property ‘Override’ indicates whether the consumer has overridden the request (true) or not (false).The Resource provides the current DRLC action that is being applied.A duration of 0 (zero) means that no DRLC is currently active.
Exercise. This Resource describes the Properties associated with glucose exercise.The exercise Property has a default unit of percentage.The exercise Property is a read-only value that is provided by the Server.
Foaming. This Resource describes the attributes associated with foaming. The Property ‘foamstrength’ of the liquid is represented as an integer.The foam strength is an integer, the range of which may be enforced by the presence of the Property ‘range’.
Geolocation. This Resource describes the properties associated with the current geolocation coordinate.Geolocation is a geolocation coordinate data.The Property ‘latitude’ is a device’s current Latitude coordinate (degrees).The Property ‘longitude’ is a device’s current Longitude coordinate (degrees).The Property ‘alt’ is a device’s current distance (metres) above or below ‘local’ sea-level.The Property ‘accuracy’ is the accuracy level of the latitude and longitude coordinates (metres).The Property ‘altitudeAccuracy’ is the accuracy level of the altitude coordinates (metres).The Property ‘heading’ is a direction of travel of device (degree).The Property ‘speed’ is a device’s current velocity (metres per second).
Glucose. This Resource describes the Properties associated with a person’s glucose level.The unit is a single value that is one of mg/dL, mmol/L.If the unit Property is missing the default is milligrams per decilitre [mg/dL].The glucose and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
GlucoseCarb. This Resource describes the Properties associated with a context carbohydrates.The carb Property has a default unit of grams[g].The carb and meal Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
GlucoseMedication. This Resource describes the Properties associated with context medication.The unit is a single value that is one of mg and mL.The medication Property has a default unit of milligrams[mg].The medication, unit and regimen Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
HbA1c. This Resource describes the Properties associated with a person’s hba1c level.The unit is a single value that is percentage.The hba1c Property is a read-only value that is provided by the Server.
HeartRate. This Resource describes the Properties associated with a person’s heart rate. The unit, which is the default unit, is bpm. The heartrate Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
Height. This Resource describes the Properties associated with height of an object’s physical size.The unit is a single value that is one of m, cm, ft or in.If the unit Property is missing the default is meters [m].The unit Property is a read-only value that is provided by the server.When range is omitted the default is 0 to +MAXFLOAT.
Illuminance. This Resource describes an illuminance sensor.The Property ‘illuminance’ is a float and represents the sensed luminous flux per unit area in lux.
Inverter. This Resource describes functions for the control and monitoring of IEC 61850 based circuit breaker.
Measurement. This Resource describes a continuous measurement of some value or property or entity .The Property ‘measurement’ is a number. The Property unit is a string and will contain an SI unit of measurement in senML format https://www.iana.org/assignments/senml/senml.xhtml
mediaSourceList. This Resource provides the list of input media sources available on the device.The sources are an array of Media Source(s) see Resource Type ‘oic.r.mediasource’
OpaqueData. This Resource defines opaque data that can be transfered between endpoints where the data itself is not interpretable by the OCF endpoints.The stringdata is a string of ASCII characters.
OpenLevel. This Resource describes how open or ajar an entity such as a window, door, blind or shutter is.The Property ‘openLevel’ can be read (acting as a sensor).The ‘openLevel’ can also be set (acting as an actuator).The ‘openLevel’ is device dependent across the range provided.When the Property ‘range’ is omitted then 0 to 100 is assumed where 0 means closed, 100 means fully open.If a ‘range’ is provided then the lower bound=closed, upper bound=open.If Property ‘step’ is present then it represents the increment between possible values; if not provided 1 is assumed.
pulsatilecharacteristic. This Resource describes the Properties associated with a pulsatile characteristic of the pulsative wave of a Pulse Oximeter. The characteristic Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
PulseRate. This Resource describes the Properties associated with a person’s pulse rate.The unit, which is the default unit, is bpm.The pulserate and unit Properties are read-only values that are provided by the Server.When range is omitted the default is 0 to +MAXFLOAT.
PVArrayConnectionTerminal. This Resource describes functions for the control and monitoring of IEC 61850 based PV Array system connection terminal.
RampTime. This Resource that describes the ramp time of a dimming function.It specifies the actual speed of changing between 2 dimming values.The Property ‘ramptime’ is specified in milliseconds [ms].When range is omitted the maximum value is 100 ms.The ramp time of 0ms indicates the minimal delay possible by the implementation.
Sensor. This Resource describes whether some value or property or entity has been sensed or not.The Property ‘value’ is a boolean.A value of ‘true’ means that the target has been sensed.A value of ‘false’ means that the target has not been sensed.
SensorProps. This Resource describes the properties which guide the reporting of a state change of a Sensor.The Property ‘silenttime’ represents the period after which a state change report was sent where the Sensor state change is not reported.The Property ‘sensitivity’ represents the level at which the sensor detects a state change.These values are completely dependent on the type of Sensor and the manufacturer capability, so no range restrictions are used.The Properties ‘range’, ‘step’ and ‘precision’ are only applied to the ‘sensitivity’ Property.
smoke. This Resource describes whether smoke has been sensed or not.The Property ‘value’ is a boolean.A value of ‘true’ means that smoke has been sensed.A value of ‘false’ means that smoke not been sensed.
Speed. This Resource describes the speed of an object, which is the magnitude of its velocity. The unit, which is the default SI unit, is metre per second. The speed Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
Temperature. This Resource describes a sensed or actuated Temperature value.The Property ‘temperature’ describes the current value measured.The Property ‘units’ is a single value that is one of ‘C’, ‘F’ or ‘K’.It provides the unit of measurement for the ‘temperature’ value.It is a read-only value that is provided by the server.If the ‘units’ Property is missing the default is Celsius [C].When the Property ‘range’ is omitted the default is +/- MAXINT.A client can specify the units for the requested temperature by use of a query parameter.If no query parameter is provided the server provides its default measure or set value.It is recommended to return always the units Property in the result.
threeAxis. This Resource provides a representation of the measurement from a three-axis sensor.The Property ‘orientation’ is an array of numbers representing x-plane, y-plane and z-plane values.The unit of measurement for each pane is ‘g’.
TimePeriod. This Resource describes the time period over which any additionally provided information is derived or bounded.The Property ‘startTime’ and ‘stopTime’ are RFC3339 encoded strings. The Property ‘startTime’ must be present.The interval is the interval of the time period in minutes, if present this value must be no less than 0 minute.The intervalsecond is the interval of the time period in seconds, if present this value must be numerical zero or greater.The repeat is the number of the time period’s iteration, which means how many times to repeat the time period. The Property ‘repeat’ accepts only negative one, numerical zero, and positive number. When this value is numerical zero, the time period will be repeated infinitely until a client makes it stop by inputting negative one for the value.The Property ‘stoptime’ and ‘interval’ are mutually exclusive; both Properties cannot be present in a Resource instance.The Property ‘intervalsecond’ cannot be presented with the Property ‘stopTime’. In case of both the Property ‘interval’ and ‘intervalsecond’ are presented together, the total time interval is the sum of ‘interval’ and ‘intervalsecond’.The Property ‘triggertiming’ describes a specific time to execute an action. This property must have one of the values among ‘startTime’, ‘stopTime’, and ‘totalInterval’. The totalInterval means the sum of the Property ‘interval’ and ‘intervalsecond’. If one of the properties does not exist, the value of the unexpressed property is taken as a numerical zero.The Property ‘state’ describes a state of time interval. This property must have one of the values among ‘preInterval’, ‘inInterval’, and ‘postInterval’.The Resource defines a time period for information retrieval, action or other behaviour.
TimeStamp. This Resource describes Properties associated with a timestamp.The ‘timestamp’ Property is a string that captures a timestamp using the RFC3339 datetime format (e.g: 2007-04-05T14:30Z) (Time+Date+Timezone).
Torque. This Resource describes the torque, which is the rotational equivalent of linear force. The unit, which is the default SI unit, is N*m (Newton metre). The torque Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
UserID. This Resource describes the Properties associated with user id of an OCF Client.The userid Property is a single value of type string.The userid Property is a read-only value that is provided by the Server.
valueconditional. This Resource specifies conditions that can be applied to an observed value in any Resource.These conditions are applied by the OCF Server exposing the Resource to any generated notifications because of subscriptions to the Resource.A unicast RETRIEVE to the Resource will receive the most recent value; which may not be the most recent notified value.An OCF Server exposes this Resource in association with the Resource conveying the observed value.This is done by means of a new Resource instance with an RT of [‘oic.r.’, ‘oic.r.value.conditional’], e.g [‘oic.r.temperature’, ‘oic.r.value.conditional’].The Property ‘threshold’ is the amount by which the thing being observed must change before a notification is sent.The Property ‘minnotifyperiod’ is the minimum time in ms (milliseconds) that must elapse before a notification is sent.If the maxnotifyperiod (time in ms (milliseconds)) elapses then a notification must be sent.The Property ‘maxnotifyperiod’ is a timer that resets each time a notification is sent.A value of ‘0’ for any of ‘threshold’,’ minnotifyperiod’ or ‘maxnotifyperiod’ means that the capability is supported but not active.
VehicleConnector. This Resource describes the attributes associated with an electric vehicle charging connector. The Property ‘connected’ is a boolean indicating the status of the connector (False = disconnected, True = connected). The Property ‘ratedchargingcapacity’ and ‘rateddischargingcapacity’ are in Amps (A).
Water. This Resource describes whether water has been sensed or not.The Property ‘value’ is a boolean.A value of ‘true’ means that water has been sensed.A value of ‘false’ means that water not been sensed.
Weight. This Resource describes the Properties associated with weight of an object.The unit is a single value that is one of kg, g, lb or oz.If the unit Property is missing the default is kilograms [kg].The unit Property is a read-only value that is provided by the server.When range is omitted the default is 0 to +MAXFLOAT.
acceleration. Smart Data Models Program adaptation of the original IoTData data Models. This Resource provides a measure of proper acceleration (g force) as opposed to co-ordinate acceleration (which is dependent on the co-ordinate system and the observer). The Property ‘value’ is a float which describes the acceleration experienced by the object in ‘g’.
AutoFocus. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes an auto focus on/off feature. The Property ‘autoFocus’ is a boolean. An ‘autoFocus’ value of ‘true’ means that the auto focus feature is on. An ‘autoFocus’ value of ‘false’ means that the auto focus feature is off. Note that when Pan Tilt Zoom (see ‘Pan Tilt Zoom’ Resource definition) is used the autofocus works only in the selected area.
AutomaticDocumentFeeder. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the state of an automatic document feeder, typically used with a scanner. The Property ‘adfstates’ and ‘currentAdfState’ are read only. The Property ‘adfStates’ is an array of the possible operational states. The Property ‘adfProcessing’ is the OK state, other states are errors or require ‘user attention’. The currentAdfState is the current value of the ADF state on the device.
AutoWhiteBalance. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes an auto balance on/off feature. The Property ‘autoWhiteBalance’ is a boolean. An AutoWhiteBalance value of ‘true’ means that the auto white balance feature is on. An AutoWhiteBalance value of ‘false’ means that the auto white balance feature is off.
BatteryMaterial. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the battery material represented as an enumerated set of strings.
BinarySwitch. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a binary switch (on/off). The Property ‘value’ is a boolean. A value of ‘true’ means that the switch is on. A value of ‘false’ means that the switch is off.
BodyLocationTemperature. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with body location for temperature measurement of a person. The bloc Property is a read-only value that is provided by the Server.
Brewing. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the attributes associated with brewing. This resource is used for configuration only. The Operation of the Device is handled independently of this Resource. The amount requested is in ml. The strength of a brewed drink is an integer, the range of which may be enforced by the presence of a strengthrange Property.
Brightness. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the brightness of a light or lamp. The Property ‘brightness’ is an integer showing the current brightness level as a quantized representation in the range 0-100. A brightness of 0 is the minimum for the resource. A brightness of 100 is the maximum for the resource.
Button. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the operation of a button style switch. The Property ‘value’ is a boolean. A value of ‘true’ means that the button is being pushed/pressed. A value of ‘false’ means that the button is not being pushed/pressed.
Calorific. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes Properties associated with the energy associated with the consumption of different fuels (including natural gas) The calorific value is a number the calorific value is a measure of the available heat energy, used as part of the calculation to convert a volume of a fuel (e.g. m3) to an energy value (e.g. KWh).
Clock. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the properties associated with clock and time. Clock is a time information. The Property ‘datetime’ is using RFC3339 datetime format (e.g: ‘2007-04-05T14:30Z’) (Time+Date+Timezone) The Property ‘countdown’ is the desired total seconds for countdown.
ColourChroma. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the colour using chroma conventions. Properties are ‘hue’, ‘saturation’, ‘csc’, and ‘ct’. The Property ‘hue’ is the hue angle, it is an integer value as defined by the CIECAM02 model definition (see reference [CIE CIE159:2004]). The Property ‘saturation’ is an integer value as defined by the CIECAM02 model definition (see reference [CIE CIE159:2004]). The Property ‘maximumsaturation’ is the upper bound on the saturation supported by the Device. If not present the maximum value for ‘saturation’ is 32767. The Property ‘csc’ is the colour space coordinates in CIE colour space. The first item in the array is the X coordinate. The second item in the array is the Y coordinate. The Property ‘nct’ is the Mired colour temperature. The Resource provides the colour using chroma conventions.
ColourCSC. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the colour using colour space co-ordinates. The Property ‘csc’ is the colour space coordinates in CIE colour space. The first item in the array is the X coordinate. The second item in the array is the Y coordinate. If the Property ‘precision’ is provided it applies to both the X and Y coordinates. The Resource provides the colour using colour space coordinates.
ColourHS. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the colour using hue-saturation conventions. The Property ‘hue’ is the hue angle, it is a number value as defined by the CIECAM02 model definition (see reference [CIE CIE159:2004]). A Device that does not support fractional hue angles can provide integer values. If Property ‘precision’ is provided it applies to the hue angle. The Property ‘saturation’ is an integer value as defined by the CIECAM02 model definition (see reference [CIE CIE159:2004]). The Property ‘saturation’ can be converted to a percentage by saturation/maximumsaturation X 100; where maximumsaturation is 32767 if the Property itself is not present. The Property ‘maximumsaturation’ is the upper bound on the saturation supported by the Device. If not present the maximum value for saturation is 32767. The Resource provides the colour using hue and saturation conventions.
consumable. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies a thing that can be consumed such as filter material, printer toner etc The Propert ‘typeofconsumable’ is an enumeration defining the thing being consumed as defined by the Smart Home Device Specification The Property ‘remaining’ is an integer capturing the percentatge remaining life The Property ‘orderpercentage’ is an integer capturing the percentage life at which replacement or replenishment is recommended by the manufacturer The Property ‘url’ is a string containing a URL at which further information may be obtained with respect to the consumable.
Conversion. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes Properties associated with the energy associated with the consumption of different fuels (including natural gas) The conversion factor is a number used as part of the calculation to convert gas volume to gas energy. The value used for this calculation is generally defined by local regulations and the conversion factor resource is therefore configurable. Provides the conversion factor used/required as part of the calculation to convert from fuel volume (m3) to fuel energy (kWh).
Count. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies an activity count. The Resource can be readonly (oic.if.s interface) in which instance it represents a count. The Resource can be readwrite (oic.if.a interface) in which instance it represents a goal or target for a count. The Property ‘count’ is an integer representing either the current count or goal value.
Dali. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the DALI write resource, able to convey FF and BF according IEC 62386-104, Digital addressable lighting interface – Part 104: General requirements – Wireless and alternative wired system. Retrieve on this Resource only returns common Properties.
Deodorization. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a deodorization function, which can be supported by controlling on air filter. The Property ‘mode’ is a mode of the deodorization function. The supported modes are defined by the enumeration [‘off’, ‘on’, ‘auto’]. ‘off’ means that the deodorization function is not enabled. ‘on’ means that the deodorization function is active. ‘auto’ means that the deodorization function is automatically controlled depending on sensed air condition in the device inside. The Property ‘currentstate’ is the current state of the deodorization function. In the case of ‘auto’ mode, if the sensed air condition is determined to be bad, the function will be ‘on’. Then, ‘mode’ value is ‘auto’ and ‘currentstate’ value is ‘on’. If not, the function is remaining ‘off’ state. Then, ‘currentstate’ value is ‘off’.
Door. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the open state of the door. A door is modelled by means of openState (Open/Closed), openDuration (ISO 8601 Time), and openAlarm (boolean). For Property ‘openState’, the value ‘Open’ indicates the door is open. The value ‘Closed’ indicates the door is closed. The type of Property ‘openDuration’ is an RFC Time encoded string. The Property ‘openAlarm’ value ‘true’ indicates that the open alarm is active. The openAlarm value ‘false’ indicates that open alarm is not active. retrieves the state of the Door.
ecomode. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies the supported and currently active Eco Mode of a Device The Resource is a deriviative of the Mode Resource (oic.r.mode) with a restriction that the population of supportedmodes and modes Properties is restricted to the set of values: ‘disabled’,’enabled’,’notsupported’. The adminforced Property indicates that the value has been set by another party (e.g. via some offboard Smart Energy interaction)
EnergyGeneration. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the attributes associated with energy generation The Property ‘energygenerated’ is a number that provides the energy generated in Watt-hour(Wh).
EnergyOverload. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes whether an energy overload detector/circuit breaker is currently tripped. The Property ‘value’ is a boolean. A value of ‘true’ means that energy overload has been tripped. A value of ‘false’ means that energy overload has not been tripped.
GlassBreak. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a glass break sensor. The Property ‘value’ is a boolean. A value of ‘true’ means that glass break has been sensed. A value of ‘false’ means that glass break not been sensed.
GlucoseHealth. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with context health. The health Property is a read-only value that is provided by the Server where minor and major are related to the general health or the level of illness of the person; menses refers to the female menstrual cycle; stress refers to physiological or psychological stress.
GlucoseMeal. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with context meal. Preprandial means pre-meal. Postprandial means post-meal. Fasting means the effect of long-term absence of food intake (overnight). The meal Property is a read-only value that is provided by the Server.
GlucoseSampleLocation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with context sample Location. AST means Alternative Site Test specifying that the location of test performed was from an alternative site on the body. The samplelocation Property is a read-only value that is provided by the Server.
GlucoseTester. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with context tester. The tester Property is a read-only value that is provided by the Server where especially hcp stands for HealthCare Professional.
heartRateZone. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a measured heart rate by the current Zone using the Zoladz method. The Zoladz method defines Zones based on maximum heart rate; Zone 1 is the lowest, Zone 5 is the highest. The heartRateZone is an enumeration containing one of: ‘Zone1’, ‘Zone2’, ‘Zone3’, ‘Zone4’, and ‘Zone5’.
HeatingZone. Smart Data Models Program adaptation of the original IoTData data Models. This Resource provides information about the status of a (single) heating zone of a Cook-Top. It describes the case of a Cook-Top whose zones can be activated dynamically (i.e. the device implements pot recognition). The Property ‘maxheatinglevel’ defines the max level for the heating zone The Property ‘heatinglevel’ is the current heating level of the zone For each element, the value range is from 0 (indication that the zone is not heating) to ‘maxheatinglevel’.
ImpactSensor. Smart Data Models Program adaptation of the original IoTData data Models. This Resource provides a status and properties of an impact sensor. Included is the current status (boolean), horizontal and vertical direction (in degrees) and impact level (g force).
KeyCardSwitch. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the operation of a KeyCard style switch. It has one mandatory Property,’stateofcard’, which is a string enum type. It has two enum values: ‘validCardInserted’, ‘validCardNotInserted’. ‘validCardInserted’ means that a keycard was inserted and passed validation check. ‘validCardNotInserted’ means that a keycard is not inserted or it was inserted but failed to pass validation check.
KeyPadChar. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a char (0-9,*,#) which is selected on a number keypad.
Lock. Smart Data Models Program adaptation of the original IoTData data Models. The Resource describing a lock. The Property ‘lockState’ is a string. The value ‘Locked’ indicates that the door is Locked. The value ‘Unlocked’ indicates that the door is Unlocked.
LockCode. Smart Data Models Program adaptation of the original IoTData data Models. The Resource describing a lock code. The Property ‘lockCodeList’ is an array of possible codes that may be associated with a lock. The codes are all presented as strings.
magneticFieldDirection. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the direction of the Earth’s magnetic field at the observer’s current point in space. Typical use case includes measurement of compass readings on a personal device. The Property ‘value’ is an array containing Hx, Hy, Hz (in that order) each of which are floats. Each of Hx, Hy and Hz are expressed in A/m (Amperes per metre).
Media. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies the media types that an OCF Server supports. The resource is an array of media elements. Each element contains: A URL at which the specified media type can be accessed. A string array containing the definition of the media using SDP. Each entry in the sdp array is an SDP line. Each line shall follow the SDP description syntax as defined in the SDP specification. The SDP specification can be found at http://tools.ietf.org/html/rfc4566.
mediaSource. Smart Data Models Program adaptation of the original IoTData data Models. This Resource defines a single media source that exists on a device. The source can be an input source or output source, this resource is agnostic of that. The Property ‘sourceName’ specifies a pre-defined media input or output (e.g.’HDMI’, ‘DVI’). The Property ‘sourceNumber’ is a label to specify the instance (e.g. ‘PC’, ‘1’). The Property ‘sourceType’ is an enumeration defining whether the source is audio, video or both. The Property ‘status’ is a boolean that determines if the specific source instance is selected or not. A status of true means that the source instance is selected. A status of false means that the source instance is not selected.
Mode. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the modes of operation that a Device can provide. The mode can be read or set. The Property ‘supportedModes’ is an array of possible modes the device supports. The Property ‘modes’ is an array of the currently active mode(s).
Motion. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes whether motion has been sensed or not. The Property ‘value’ is a boolean. A value of ‘true’ means that motion has been sensed. A value of ‘false’ means that motion not been sensed.
movement. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies linear movement. The Property ‘movementSettings’ is an array of strings containing possible movement values (e.g. spin, stop, left, right). The Property ‘movement’ is the currently selected movement value. The Property ‘movementModifier’ is a modifier to the movement value (e.g. ‘spin’, ’90’)
MuscleOxygenSaturation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the muscle oxygen saturation (SmO2), which is the percentage of hemoglobin that is saturated with oxygen in the capillaries of a muscle. The unit is percentage. The smo2 Property is a read-only value that is provided by the server.
NightMode. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a night mode on/off feature. A nightMode value of ‘true’ means that the feature is on. A nightMode value of ‘false’ means that the feature is off.
PanTiltZoom. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies the pan tilt and zoom capabilities of a device. The Resource Type is dynamic and reflects whether the values apply to physical movement of the device or digital/virtual enhancements to the image. For physical movement the Resource Type is ‘oic.r.movement.ptz’. For digital/virtual image enhancements the Resource Type is ‘oic.r.image.ptz’. The Properties ‘pan’ and ’tilt’ are specified in degrees. The Property ‘zoomFactor’ is a value in the range 1-100 for linear (optical) zoom. The zoom factor is a value in the range [1x, 2x, 4x, 8x, 16x, 32x] for digital zoom. If there is no zoom value to set the zoom factor shall be ‘1x’. The value 0 degrees means neutral, this is a vendor defined setting. Note that this resource also can be used to create an offset for physical movement. When that is the case, the Resource Type value is: ‘oic.r.movement.offset.ptz’ Note that this resource also can be used to create an offset for image movement. When that is the case, the Resource Type value is: ‘oic.r.image.offset.ptz’. When the Property ‘pan_range’ value is omitted, then the range is [-180.0,180.0]. If ‘pan’ is not supported then the range shall be [0.0,0.0] When the Property ’tilt_range’ value is omitted, then the range is [-180.0,180.0]. If ’tilt’ is not supported then the range shall be [0.0,0.0].
Presence. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes whether presence has been sensed or not. The Property ‘value’ is a boolean. A value of ‘true’ means that presence has been sensed. A value of ‘false’ means that presence not been sensed.
PrintQueue. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the items in a Printer Queue. The Properties ‘uri’ and ‘status’ are read only items that cannot be changed through this resource.
pulsatileoccurrence. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with a Pulsatile Occurrence detected by a Pulse Oximeter. The occurrence Property is a read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
RemoteControl. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a remote control function, which helps users to control a device without the actual remote controller provided by the manufacturer.
RenderingIndex. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a Colour Rendering Index (CRI). The Property ‘cri’ is an number. A colour rendering index (CRI) is a quantitative measure of the ability of a light source to reveal the colours of various objects faithfully in comparison with an ideal or natural light source. Light sources with a high CRI are desirable in colour-critical applications such as neonatal care and art restoration. It is defined by the International Commission on Illumination (CIE) as follows:[1] Colour rendering: Effect of an illuminant on the colour appearance of objects by conscious or subconscious comparison with their colour appearance under a reference illuminant. The value often quoted as ‘CRI’ on commercially available lighting products is properly called the CIE Ra value, ‘CRI’ being a general term and CIE Ra being the international standard colour rendering index
Request. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a DALI (addressing) configuration, IEC 62386-104, Digital addressable lighting interface – Part 104: General requirements – Wireless and alternative wired system.
Saturation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a Colour saturation value. The Property ‘colourSaturation’ is an integer. A ‘colourSaturation’ has a range of [0,100]. A ‘colourSaturation’ value of 0 means producing black and white images. A ‘colourSaturation’ value of 50 means producing device specific normal colour images. A ‘colourSaturation’ value of 100 means producing device very full colour images.
SelectableLevels. Smart Data Models Program adaptation of the original IoTData data Models. This Resource provides a set of device defined levels that can be selected for an operation. For example where a humidifier has a discrete set that model different humidity levels that can be set. The Property ‘availablelevels’ is an array of the levels that can be selected, these can be a number or an integer (as subset of integer). The Property ‘targetlevel’ is the level that has currently been selected and is written to in order to select a new level. When retrieved the targetlevel provides the actual value that has been selected.
settings-accessibility. Smart Data Models Program adaptation of the original IoTData data Models. Gets current device accessibility settings.
settings-broadcasting. Smart Data Models Program adaptation of the original IoTData data Models. Gets current device broadcasting settings.
settings-sound. Smart Data Models Program adaptation of the original IoTData data Models. Gets current device sound settings.
settings-support. Smart Data Models Program adaptation of the original IoTData data Models. Gets current device support settings.
SignalStrength. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the strength of a signal by means of lqi and rssi. The Property ‘lqi’ is a floating point number that represents Link Quality Indicator. The Property ‘rssi’ is a floating point number that represents the received signal strength indicator.
Sleep. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with Sleep. Sleep shows the time spent in each of the sleep stages (awake, nrem1, nrem2, nrem3, nrem4, rem, light sleep, deep sleep), along with a sleep score indicating the quality of sleep.
SoundPressure. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a measured sound pressure in Pascal (pa). The Sound pressure is a property of the sound field at a point in space where the point is the actual location of the sensor.
SoundPressureLevel. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes a measured sound pressure in dB. The Sound pressure is a property of the sound field at a point in space where the point is the actual location of the sensor.
Speech. Smart Data Models Program adaptation of the original IoTData data Models. This Resource may be created on the OCF Server that is capable of rendering speech by an OCF Client and allows the client to provide an SSML document with text to render or may be created on the OIC Server by some resident application. The audio rendered is at this stage local to the Server (i.e. not streamed). The utterance is an SSML document. The supportedLanguages is an array of the RFC5646 defined language tags that are supported. The supportedVoices is an SSML document fragment indicating the voices that are supported. Utterance in the example shall be a properly escaped (JSON rules) SSML document. An example: ‘ The title of the movie is: ‘Monty Pythons The Meaning of Life’ which is directed by Terry Jones. </speak’
SpO2. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the Properties associated with a person’s blood oxygen saturation level. The spo2 and perfusion Properties are read-only value that is provided by the server. When range (from ‘oic.r.baseresource’) is omitted the default is 0 to +MAXFLOAT.
Touch. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes whether a touch has been sensed or not. The Property ‘value’ is a boolean. A value of ‘true’ means that touch has been sensed. A value of ‘false’ means that touch not been sensed.
UserInfo-retrieve. Smart Data Models Program adaptation of the original IoTData data Models. This Resource defines credentials for user to application layer login. This does not relate to OCF Device to Device or Device to Cloud authentication. The username, password and token are strings.
UVARadiation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies UV radiation measurement. The Property ‘measurement’ is the current measured UVA. The intensity of UV radiation is measured in the units of milliwatts per square centimeter (mW/cm2) which is energy per square centimeter received per second. UVA is measured between 315 and 400 nanometers in the electromagnetic spectrum.
UVBRadiation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies UV radiation measurement. The Property ‘measurement’ is the current measured UVB. The intensity of UV radiation is measured in the units of milliwatts per square centimeter (mW/cm2) which is energy per square centimeter received per second. UVB is measured between 280 and 315 nanometers in the electromagnetic spectrum.
UVRadiation. Smart Data Models Program adaptation of the original IoTData data Models. This Resource specifies UV radiation measurement. The Property ‘measurement’ is the current measured UV Index
WaterInfo. Smart Data Models Program adaptation of the original IoTData data Models. This Resource describes the water information to indicate type of water currently provided by the device. The water type can be read or set. The Property ‘supportedwatertypes’ is an array of the possible water types are defined by the enumeration [‘cold’, ‘hot’, ‘ambient’, ‘ice’]. The Property ‘supportedadditivetypes’ is an array of the possible additive types for water. The additive types mean optional types that can be added to the specific water type according to Client’s preference and are defined by the enumeration [‘none’, ‘soda’, ‘mineral’]. If absent, the default value is ‘none’. The Property ‘currentwatertype’ is the currently desired water type. The Property ‘currentadditivetypes’ is the currently desired additive type(s). For example, if ‘cold’ is selected with the ‘currentwatertype’, ‘soda’ and ‘mineral’ or both can be selected as ‘currentadditivetypes’. Note that if ‘hot’ is selected with the ‘currentwatertype’, ‘soda’ and ‘mineral’ may be restricted for the ‘currentadditivetypes’.
When creating a new data model is good to collaborate. In the Smart Data Models Program you can announce you’re in the process of creating a new data model by pressing the green button on the front page
It will take you to a form where you can announce the main data and include a public mail (mandatory) for being contacted. After a manual review, SDM will grant you the work on the incubated repository thanks to the github user (mandatory).
Once approved you will be published in the official list of data models. You can access this list by clicking the link just below the green button.
Besides this now the creation of a new data model is simpler than ever. You need only a key values payload of your new data model and most of the job is done by this service available at Menu -> Draft a data model -> Generate your schema out of your payload.
NOTE: Apologies to the contributors that sent their last projects (a deactivated plugin prevent their projects to be published publicly, now it’s fixed)
The creation of a data model requires two mandatory files, one example and a JSON schema containing the definitions and data types of the elements in the entity.
However, the JSON schema creation could be somehow demanding.
The new tool opens the door for people with only basic knowledge of JSON (every FIWARE user should be proficient in it).
If you have an entity defined in your system just retrieve it in key values format and paste it in this form (available at Menu -> Draft a data model -> Generate your schema out of your payload.
It will return a new page with a raw version of a JSON schema. What you have to check for a final submission?
1.- The title and description of the overall schema
2.- The id address of the schema (you’d need the subject to locate it)
3.- If you want to include any tags
4.- Remove those definitions that does not match your data model and include the missing ones.
so you would be able to make a PR with this JSON schema and your example according to the contribution manual.
Check it here as well
There is a new subject STAT-DCAT-AP to map the standard STAT-DCAP 1.0.1 which maps inputs coming from SDMX statistical data sources.