CLASS1.SETVALUEZONE
This class mirrors the standard measurement events is CLASS1.MEASUREMENT=10 but also have zone information and is intended for setting a value instead of providing a measurement.
This class can for example be used to set setpoints on a node. If 256 set points is enough (!!!) use index to identify the setpoint. If more is needed use subzone as a page into this storage and make this configurable on the node.
For large integers and strings several events may need to be used to set a single value.
| Byte | Description |
|---|---|
| 0 | Index for device (This is NOT the same as senorindex is in data coding byte). |
| 1 | Zone for which event applies to (0-255). 255 is all zones. |
| 2 | Sub-zone for which event applies to (0-255). 255 is all sub-zones. |
| 3 | Data coding. |
| 4-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.
This is a measurement of chemical mass concentration.
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.