CLASS1.MEASUREMENT
Measurements are fetched from the SI units and from SI derived units. The SI unit (or the SI derived unit) is also used as the default unit. As in the SI unit standard, names for a unit is in lower case ("newton") and the unit ("N") is in upper case.
Byte 0 is the data coding byte for all measurement packages. The default unit has bits 0,1,2 set to 000 and the first optional unit 001 and so on. It also have a field for the item ( if more than one sensor is controlled by the node) that the value belongs to. See data-coding for a full description on data coding used.
All events in this class are mirrored in CLASS1.MEASUREMENT32=70 (0x46) as a single precision float. Default unit is used.
All events in this class are mirrored in CLASS1.MEASUREMENT64=60 (0x3C) as floating point values using only the default unit .
All events in this class are mirrored in CLASS1.MEASUREZONE=65 (0x41) as normalized integer values with index, zone, sub-zone. Default unit is used.
All events in this class are mirrored in CLASS1.SETVALUEZONE=85 (0x55) as a normalized value using only the default unit but with index/zone/subzone.
All of the above is also available as LEVEL I events over Level II.
All events in this class are mirrored in CLASS2.MEASUREMENT_STR=1040 (0x410) as the events, in the range 0-255, which use decimal string values.
All events in this class are mirrored in CLASS2.MEASUREMENT_FLOAT=1060 (0x424) as the events, in the range 0-255, which use decimal float values.
The relationship between Level II measurement events and Level I measurement events is like this
- CLASS1.MEASUREMENT=10 (0x0A) which is mirrored as Level II measurements 0-255.
- CLASS1.MEASUREMENT=11 (0x0B) which is mirrored as Level II measurements 256-511.
- CLASS1.MEASUREMENT=12 (0x0C) which is mirrored as Level II measurements 512-767.
- CLASS1.MEASUREMENT=13 (0x0D) which is mirrored as Level II measurements 768-1023.
- CLASS1.MEASUREMENT=14 (0x0E) which is mirrored as Level II measurements 1024-1279.
Level II measurement events with type >= 1280 have no relation to any Level I measurement events.
| Data byte | Description |
|---|---|
| 0 | Data coding. |
| 1-7 | Data with format defined by byte 0. |
VSCP_TYPE_MEASUREMENT_GENERAL
This is a general (custom) measurement event that can be used if no other event is suitable.
VSCP_TYPE_MEASUREMENT_COUNT
This is a discrete value typical for a count. There is no unit for this measurement just a discrete value.
VSCP_TYPE_MEASUREMENT_LENGTH
Default unit: Meter.
This is a measurement of a length or a distance.
VSCP_TYPE_MEASUREMENT_MASS
Default unit: Kilogram.
This is a measurement of a mass.
VSCP_TYPE_MEASUREMENT_TIME
A time measurement.
Default unit: Seconds.
Opt. unit: (1) Milliseconds. Absolute: (2) y-y-m-d-h-m-s (binary). String: (3) "HHMMSS".
VSCP_TYPE_MEASUREMENT_ELECTRIC_CURRENT
Default unit: Ampere.
This is a measurement of an electric current.
VSCP_TYPE_MEASUREMENT_TEMPERATURE
Default unit: Kelvin.
Opt. unit: Degree Celsius (1), Fahrenheit (2)
This is a measurement of a temperature.
VSCP_TYPE_MEASUREMENT_AMOUNT_OF_SUBSTANCE
Default unit: Mole.
This is a measurement of an amount of a substance.
VSCP_TYPE_MEASUREMENT_INTENSITY_OF_LIGHT
Default unit: Candela.
This is a measurement of luminous intensity.
VSCP_TYPE_MEASUREMENT_FREQUENCY
Default unit: Hertz.
This is a measurement of regular events during a second.
VSCP_TYPE_MEASUREMENT_RADIOACTIVITY
Default unit: becquerel. Optional unit: curie (1)
This is a measurement of rates of things, which happen randomly, or are unpredictable.
VSCP_TYPE_MEASUREMENT_FORCE
Default unit: newton.
This is a measurement of force.
VSCP_TYPE_MEASUREMENT_PRESSURE
Default unit: pascal.
Opt. unit: bar (1), psi (2)
This is a measurement of pressure.
VSCP_TYPE_MEASUREMENT_ENERGY
Default unit: Joule.
Optional unit: KWh (1)
This is a measurement of energy.
VSCP_TYPE_MEASUREMENT_POWER
Default unit: watt.
Optional unit: Horse power (1).
This is a measurement of power.
VSCP_TYPE_MEASUREMENT_ELECTRICAL_CHARGE
Default unit: coulomb.
This is a measurement electrical charge.
VSCP_TYPE_MEASUREMENT_ELECTRICAL_POTENTIAL
Default unit: volt.
This is a measurement of electrical potential.
VSCP_TYPE_MEASUREMENT_ELECTRICAL_CAPACITANCE
Default unit: farad (F).
This is a measurement of electric capacitance.
VSCP_TYPE_MEASUREMENT_ELECTRICAL_RESISTANCE
Default unit: ohm (Ω).
This is a measurement of resistance.
VSCP_TYPE_MEASUREMENT_ELECTRICAL_CONDUCTANCE
Default unit: siemens.
This is a measurement of electrical conductance.
VSCP_TYPE_MEASUREMENT_MAGNETIC_FIELD_STRENGTH
Default unit: amperes per meter (H).
Optional units: teslas (B) (1)
This is a measurement of magnetic field strength.
VSCP_TYPE_MEASUREMENT_MAGNETIC_FLUX
Default unit: weber (Wb).
This is a measurement of magnetic flux.
VSCP_TYPE_MEASUREMENT_MAGNETIC_FLUX_DENSITY
Default unit: tesla (B).
Optional unit: Gauss (1)
This is a measurement of flux density or field strength for magnetic fields (also called the magnetic induction).
VSCP_TYPE_MEASUREMENT_INDUCTANCE
Default unit: henry (H).
This is a measurement of inductance.
VSCP_TYPE_MEASUREMENT_FLUX_OF_LIGHT
Default unit: Lumen (lm= cd * sr)
This is a measurement of luminous Flux.
VSCP_TYPE_MEASUREMENT_ILLUMINANCE
Default unit: lux (lx) ( lx = lm / m² )
This is used to express both Illuminance (incidence of light) and Luminous Emittance (emission of light).
VSCP_TYPE_MEASUREMENT_RADIATION_DOSE_ABSORBED
Default unit: gray (Gy).
This is a measurement of a radiation dose (Absorbed dose of ionizing radiation).
VSCP_TYPE_MEASUREMENT_CATALYTIC_ACITIVITY
Default unit: katal (kat).
This is a measurement of catalytic activity used in biochemistry.
VSCP_TYPE_MEASUREMENT_VOLUME
Default unit: cubic meter (m³)
Opt. unit: Liter (dm³) (1), decilitre (100 cm³) (2), centilitre (10 cm³) (3), millilitre (cm³) (4) where unit 4 is only available for Level II measurement events where units can hold this value.
This is a measurement of volume.
VSCP_TYPE_MEASUREMENT_SOUND_INTENSITY
Default unit: W/m2, watt per square meter.
This is a measurement of sound intensity (acoustic intensity).
VSCP_TYPE_MEASUREMENT_ANGLE
- Default unit: radian (rad) (Plane angles).
- Opt Unit: degree (1).
- Opt Unit: arcminute (2).
- Opt Unit: arcseconds (3).
This is a measurement of an angle or a direction or similar.
VSCP_TYPE_MEASUREMENT_POSITION
Default unit: Longitude.
Opt. unit: Latitude.
This is a (decimal) measurement of a position as of WGS 84. Normally given as a floating point value. See ./class1.gps.md for a better candidate to use for position data.
VSCP_TYPE_MEASUREMENT_SPEED
Default unit: Meters per second.
Optional unit: Kilometers per hour (1) Miles per hour (2)
This is a measurement of a speed.
VSCP_TYPE_MEASUREMENT_ACCELERATION
Default unit: Meters per second/second (m/s2).
This is a measurement of acceleration.
VSCP_TYPE_MEASUREMENT_TENSION
Default unit: N/m.
This is a measurement of tension.
VSCP_TYPE_MEASUREMENT_HUMIDITY
Default unit: Relative percentage 0-100%.
This is a measurement of relative moistness (Humidity).
VSCP_TYPE_MEASUREMENT_FLOW
Default unit: Cubic meters/second.
Opt Unit: Liters/Second.
This is a measurement of flow.
VSCP_TYPE_MEASUREMENT_THERMAL_RESISTANCE
Default unit: Thermal ohm K/W.
This is a measurement of thermal resistance.
VSCP_TYPE_MEASUREMENT_REFRACTIVE_POWER
Default unit: dioptre (dpt) m-1.
This is a measurement of refractive (optical) power.
VSCP_TYPE_MEASUREMENT_DYNAMIC_VISCOSITY
Default unit: pascal second optional units poiseuille (Pl) = 1, poise (P) = 2
This is a measurement of dynamic viscosity.
VSCP_TYPE_MEASUREMENT_SOUND_IMPEDANCE
Default unit: rayl (Pa·s/m)
This is a measurement of sound impedance.
VSCP_TYPE_MEASUREMENT_SOUND_RESISTANCE
Default unit: Acoustic ohm Pa · s/ m³.
This is a measurement of sound resistance.
VSCP_TYPE_MEASUREMENT_ELECTRIC_ELASTANCE
Default unit: daraf (f-1).
This is a measurement of electric elasticity.
VSCP_TYPE_MEASUREMENT_LUMINOUS_ENERGY
Default unit: talbot ( tb = lm * s)
This is a measurement of luminous energy.
VSCP_TYPE_MEASUREMENT_LUMINANCE
Default unit: cd / m²) (non SI unit = nit)
This is a measurement of luminance.
VSCP_TYPE_MEASUREMENT_CHEMICAL_CONCENTRATION_MOLAR
Default unit: mol/m3. Opt. unit: ppm (1), percent (2)
This is a measurement of chemical mol/ppm/percent concentration.
VSCP_TYPE_MEASUREMENT_CHEMICAL_CONCENTRATION_MASS
Default unit: kg/m3.
VSCP_TYPE_MEASUREMENT_DOSE_EQVIVALENT
Reserved
VSCP_TYPE_MEASUREMENT_RESERVED48
Reserved
VSCP_TYPE_MEASUREMENT_DEWPOINT
Default unit: Kelvin.
Opt. unit: Degree Celsius (1), Fahrenheit (2)
This is a measurement of the Dew Point.
VSCP_TYPE_MEASUREMENT_RELATIVE_LEVEL
Default unit: Relative value.
This is a relative value for a level measurement without a unit. It is just relative to the min/max value for the selected data representation, typically percentage or per mille or similar.
VSCP_TYPE_MEASUREMENT_ALTITUDE
Default unit: Meter.
Opt. unit: Feet(1), inches (2)
Altitude in meters.
VSCP_TYPE_MEASUREMENT_AREA
Default unit: square meter (m²)
Area in square meter.
VSCP_TYPE_MEASUREMENT_RADIANT_INTENSITY
Default unit: watt per steradian ( W / sr )
Radiated power per room angle.
VSCP_TYPE_MEASUREMENT_RADIANCE
Default unit: watt per steradian per square metre ( W / (sr * m²) )
This is the radiant flux emitted, reflected, transmitted or received by a surface.
VSCP_TYPE_MEASUREMENT_IRRADIANCE
Default unit: watt per square metre ( W / m² )
Power emitted from or striking onto a surface or area.
VSCP_TYPE_MEASUREMENT_SPECTRAL_RADIANCE
Default unit: watt per steradian per square metre per nm (W·sr-1·m-2·nm-1)
Opt. unit: watt per steradian per meter3 (W·sr-1·m-3) (1), watt per steradian per square metre per hertz (W·sr-1·m-3) (2)
Radiance of a surface per unit frequency or wavelength.
VSCP_TYPE_MEASUREMENT_SPECTRAL_IRRADIANCE
Default unit: watt per square metre per nm (W·m-2·nm-1)
Opt. unit: watt per metre3 (W·m-3) (1), watt per square metre per hertz (W·m-2·Hz-1) (2)
Irradiance of a surface per unit frequency or wavelength.
VSCP_TYPE_MEASUREMENT_SOUND_PRESSURE
Default unit: pascal (Pa)
This is a measurement of sound pressure (acoustic pressure).
VSCP_TYPE_MEASUREMENT_SOUND_DENSITY
Default unit: pascal (Pa)
Sound energy density or sound density is the sound energy per unit volume.
VSCP_TYPE_MEASUREMENT_SOUND_LEVEL
Default unit: decibel (dB)
Sound level expressed in decibel. This event is supplied for convenience.
VSCP_TYPE_MEASUREMENT_RADIATION_DOSE_EQ
Default unit: sievert (Sv).
Optional unit rem (1)
This is a measurement of a radiation dose (Equivalent dose of ionizing radiation).
VSCP_TYPE_MEASUREMENT_RADIATION_DOSE_EXPOSURE
Default unit: coulomb per kilogram (C/kg).
Optional unit: Röntgen/R (1)
This is a measurement of a radiation dose (Exposed dose of ionizing radiation).
VSCP_TYPE_MEASUREMENT_POWER_FACTOR
Default unit: cos of phase angle.
This is a measurement of a power factor. Power factor is an expression of energy efficiency. It is usually expressed as a percentage—and the lower the percentage, the less efficient power usage is.
Power factor (PF) is the ratio of working power, measured in kilowatts (kW), to apparent power, measured in kilovolt amperes (kVA). Apparent power, also known as demand, is the measure of the amount of power used to run machinery and equipment during a certain period. It is found by multiplying (kVA = V x A). The result is expressed as kVA units.
VSCP_TYPE_MEASUREMENT_REACTIVE_POWER
Default unit: VAr
In electric power transmission and distribution, volt-ampere reactive (VAr) is a unit of measurement of reactive power. Reactive power exists in an AC circuit when the current and voltage are not in phase. The term var was proposed by the Romanian electrical engineer Constantin Budeanu and introduced in 1930 by the IEC in Stockholm, which has adopted it as the unit for reactive power. Special instruments called varmeters are available to measure the reactive power in a circuit. The unit "var" is allowed by the International System of Units (SI) even though the unit var is representative of a form of power. SI allows one to specify units to indicate common sense physical considerations. Per EU directive 80/181/EEC (the "metric directive"), the correct symbol is lower-case "var", although the spellings "Var" and "VAr" are commonly seen, and "VAR" is widely used throughout the power industry.
Definition from Wikipedia
VSCP_TYPE_MEASUREMENT_REACTIVE_ENERGY
Default unit: kVArh
Reactive Energy is the electrical Energy produced, flowing or supplied by an electric circuit during a time interval, measured in units of kVArh or standard multiples thereof.