{
  "spec_version": 1,
  "slug": "lufft-ventus-umb",
  "manufacturer": "Lufft (OTT HydroMet)",
  "model": "Ventus / V200A-UMB ultrasonic wind sensor",
  "category": "Sensor",
  "supplier_url": "https://www.kippzonen.com/products/ventus.umt",
  "default_configuration": {
    "protocol": "modbus_rtu",
    "unit_id": 1,
    "addressing": "zero_based",
    "byte_order": "BigEndian",
    "word_order": "HighFirst",
    "native_interface": "rs485",
    "serial": {
      "baud_rate": 19200,
      "parity": "Even",
      "data_bits": 8,
      "stop_bits": 1
    }
  },
  "coils": [],
  "discrete_inputs": [],
  "input_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "Identification",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "High byte = device subtype, low byte = software version."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Device status",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "A value other than 0 means the configuration storage could not be read or the device hit a serious problem during system start (contact OTT HydroMet with the code)."
    },
    {
      "address": 2,
      "count": 1,
      "name": "Sensor status 1",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Four 4-bit sensor states: high byte high nibble = temperature buffer, high byte low nibble = temperature, low byte high nibble = air-pressure buffer, low byte low nibble = air pressure. 0 = OK, 1 = OK (alternate code), 2 = UNGLTG_KANAL, 3 = MEAS_ERROR, 4 = INIT_ERROR, 5 = VALUE_OVERFLOW, 6 = BUSY, 7 = other."
    },
    {
      "address": 3,
      "count": 1,
      "name": "Sensor status 2",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Same 4-bit coding: wind buffer, wind, then two unused nibbles."
    },
    {
      "address": 9,
      "count": 1,
      "name": "Diagnostic: run time",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Run time in 10-second steps."
    },
    {
      "address": 10,
      "count": 1,
      "name": "Relative air pressure (actual)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 (scaling factor 10)."
    },
    {
      "address": 11,
      "count": 1,
      "name": "Relative air pressure (minimum)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 12,
      "count": 1,
      "name": "Relative air pressure (maximum)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 13,
      "count": 1,
      "name": "Relative air pressure (average)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 14,
      "count": 1,
      "name": "Wind direction (actual)",
      "data_type": "Int16",
      "units": "°",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 degrees."
    },
    {
      "address": 15,
      "count": 1,
      "name": "Wind direction (minimum)",
      "data_type": "Int16",
      "units": "°",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 degrees."
    },
    {
      "address": 16,
      "count": 1,
      "name": "Wind direction (maximum)",
      "data_type": "Int16",
      "units": "°",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 degrees."
    },
    {
      "address": 17,
      "count": 1,
      "name": "Wind direction (vector average)",
      "data_type": "Int16",
      "units": "°",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 degrees."
    },
    {
      "address": 18,
      "count": 1,
      "name": "Wind measurement quality",
      "data_type": "Int16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Scaling factor 1; the document's scaling column marks the row signed (s), so it is read as a signed 16-bit value."
    },
    {
      "address": 19,
      "count": 1,
      "name": "Air temperature (actual)",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 20,
      "count": 1,
      "name": "Air temperature (minimum)",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 21,
      "count": 1,
      "name": "Air temperature (maximum)",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 22,
      "count": 1,
      "name": "Air temperature (average)",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 23,
      "count": 1,
      "name": "Heating temperature, top",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 24,
      "count": 1,
      "name": "Heating temperature, bottom",
      "data_type": "Int16",
      "units": "°C",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Signed value x 0.1."
    },
    {
      "address": 25,
      "count": 1,
      "name": "Wind speed (actual)",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 m/s."
    },
    {
      "address": 26,
      "count": 1,
      "name": "Wind speed (minimum)",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 m/s."
    },
    {
      "address": 27,
      "count": 1,
      "name": "Wind speed (maximum)",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 m/s."
    },
    {
      "address": 28,
      "count": 1,
      "name": "Wind speed (average)",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 m/s."
    },
    {
      "address": 29,
      "count": 1,
      "name": "Wind speed (vector average)",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "Scaling factor 1 (the document's only 1:1 wind-speed row)."
    },
    {
      "address": 30,
      "count": 1,
      "name": "Air temperature (actual)",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 31,
      "count": 1,
      "name": "Air temperature (minimum)",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 32,
      "count": 1,
      "name": "Air temperature (maximum)",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 33,
      "count": 1,
      "name": "Air temperature (average)",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 34,
      "count": 1,
      "name": "Heating temperature, top",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 35,
      "count": 1,
      "name": "Heating temperature, bottom",
      "data_type": "Int16",
      "units": "°F",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Signed value x 0.1."
    },
    {
      "address": 36,
      "count": 1,
      "name": "Wind speed (actual)",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Value x 0.1."
    },
    {
      "address": 37,
      "count": 1,
      "name": "Wind speed (minimum)",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Value x 0.1."
    },
    {
      "address": 38,
      "count": 1,
      "name": "Wind speed (maximum)",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Value x 0.1."
    },
    {
      "address": 39,
      "count": 1,
      "name": "Wind speed (average)",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Value x 0.1."
    },
    {
      "address": 40,
      "count": 1,
      "name": "Wind speed (vector average)",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Imperial block. Value x 0.1."
    },
    {
      "address": 41,
      "count": 1,
      "name": "Absolute air pressure (actual)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 42,
      "count": 1,
      "name": "Absolute air pressure (minimum)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 43,
      "count": 1,
      "name": "Absolute air pressure (maximum)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 44,
      "count": 1,
      "name": "Absolute air pressure (average)",
      "data_type": "Int16",
      "units": "hPa",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 45,
      "count": 1,
      "name": "Wind speed (actual)",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 46,
      "count": 1,
      "name": "Wind speed (minimum)",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 47,
      "count": 1,
      "name": "Wind speed (maximum)",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 48,
      "count": 1,
      "name": "Wind speed (average)",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 49,
      "count": 1,
      "name": "Wind speed (vector average)",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 50,
      "count": 1,
      "name": "Wind speed (actual)",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 51,
      "count": 1,
      "name": "Wind speed (minimum)",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 52,
      "count": 1,
      "name": "Wind speed (maximum)",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 53,
      "count": 1,
      "name": "Wind speed (average)",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 54,
      "count": 1,
      "name": "Wind speed (vector average)",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 55,
      "count": 1,
      "name": "Air density (actual)",
      "data_type": "UInt16",
      "units": "kg/m³",
      "scale_factor": 0.001,
      "offset": 0,
      "access": "R",
      "description": "Scaling factor 1000, unsigned, so the scale factor here is 0.001."
    },
    {
      "address": 56,
      "count": 1,
      "name": "Wind gust speed",
      "data_type": "Int16",
      "units": "m/s",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 57,
      "count": 1,
      "name": "Wind gust direction",
      "data_type": "Int16",
      "units": "°",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1 degrees."
    },
    {
      "address": 58,
      "count": 1,
      "name": "Wind gust speed",
      "data_type": "Int16",
      "units": "km/h",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 59,
      "count": 1,
      "name": "Wind gust speed",
      "data_type": "Int16",
      "units": "mph",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1."
    },
    {
      "address": 60,
      "count": 1,
      "name": "Wind gust speed",
      "data_type": "Int16",
      "units": "kts",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "Value x 0.1. Registers 61-124 are reserved."
    }
  ],
  "holding_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "Local altitude",
      "data_type": "Int16",
      "units": "m",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "Altitude above sea level used to calculate the relative air pressure. Value range -100...5000 m, scaling factor 1."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Heating operating mode / heating power mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "W",
      "description": "Write-only in the sense that the register returns 0; high byte = operating mode (0 off, 1 automatic, 2 test mode, 3 off when the external control line is high, 4 off when it is low), low byte = power mode (0 full heating power, 1 reduced power alternating the lower and upper heating element). Value = power mode + 256 x operating mode, e.g. 256 = full power, automatic."
    },
    {
      "address": 2,
      "count": 1,
      "name": "Station reset",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "W",
      "description": "Writing 0x3247 (12871 decimal) triggers a device reset. Returns 0 when read."
    }
  ],
  "combined_registers": [],
  "notes": "Source: OTT HydroMet Fellbach GmbH (Lufft) 'Ventus Ultrasonic Wind Sensor - Operational Manual', document 48.7230-Vent-EN, revision V31 (07/2024), chapter 8.2.1 'Factory settings', chapter 10 'Commissioning for MODBUS format' (10.1-10.8) and the technical specification in chapter 13; hosted by OTT HydroMet's Hach document CDN at https://cdn.hach.com/1XMCM0ZF/at/59sk8hp6b7rv7jcf98g8c5q/Operational_Manual_Ultrasonic_Wind_Sensor_Ventus_final.pdf (SHA-256 25be55f7f1fe31054887901dde4446973ebee15eae729e6ecfea86cc79e86a22). Factory settings from 8.2.1: device ID 1, 19200 baud, data format 8N1. Chapter 10.2 states that selecting MODBUS-RTU preselects 19200 baud and even parity and that the interface can be set to 8E1, 8N1 or 8N2; this seed stores the preselected 19200 8E1 frame with the factory device ID 1 (the Modbus address is the UMB device ID, 10.3). The device also ships in UMB binary protocol, so Modbus must be selected in ConfigTool.NET before the map below is served. Addressing: the register table prints 'Register number' and 'Register address' side by side with address = number - 1, and the measurement values are input registers 0-124 read with function 04, so the seed is zero_based. All values are 16-bit integers scaled to fit one register (the manual deliberately does not use register pairs); the scaling factor column gives the divisor, so the scale factors here are 1/factor. The scaling column also marks each row s (signed) or u (unsigned): s rows are seeded as Int16, and the one u row (air density) as UInt16. 65535 and 32767 mean the value is erroneous or unavailable, and the sensor-status registers 2 and 3 carry the 4-bit status codes. The metric block, the imperial block and the km/h and knots blocks are kept together because each one is a documented row of the same table, although one unit system is enough for a given site. Holding registers 0-2 are the only writable parameters the manual documents; rows 61-124 are reserved."
}
