{
 "manufacturer": "Greystone Energy Systems",
 "manufacturer_slug": "greystone",
 "model": "VOC Series air quality transmitter (BACnet MS/TP)",
 "model_slug": "voc-air-quality-transmitter",
 "aliases": [
  "VOC Series",
  "VOCXXXBAC",
  "Greystone VOC sensor",
  "Greystone TVOC transmitter"
 ],
 "equipment_type": "VOC air quality sensor",
 "applies_to": "Greystone VOC series room air quality transmitters (VOC with RH and temperature) with BACnet MS/TP and optional relay.",
 "summary": "The VOC Series is a Greystone room air quality transmitter with native BACnet MS/TP. VOC (as an index or ppb), RH and temperature are Analog Inputs; offsets and relay setpoint, hysteresis and delay are Analog Values; Binary Values set units, override, the TVOC clean-air reference and the Bluetooth link, and Multi-State Values assign the relay and the display.",
 "bacnet_transport": [
  "BACnet MS/TP"
 ],
 "firmware": "1.0 (PICS, 19-Jul-21)",
 "default_device_instance": 381003,
 "access_inferred": false,
 "notes": [
  "Points from the object table on page 1 of the setup guide; names kept as printed (e.g. \"Set Overide\", \"Relay Hysterisis\").",
  "Each AI reads -1000 on a sensor error.",
  "Relay setpoint and hysteresis ranges follow MV 1, e.g. VOC index 100-500, TVOC 100-1000 ppb, RH 20-90 %RH, temperature 5-40 °C.",
  "Multistate objects are MSV in the guide; listed here as MV. Access from the PICS: AV, BV and MSV Present_Value are writable."
 ],
 "source": {
  "title": "VOC Series Air Quality Transmitter - Setup Guide for BACnet Communication",
  "doc_number": "SG-VOCXXXBAC-001",
  "revision_date": "2021-07-19 (PICS date)",
  "url": "https://downloads.greystoneenergy.com/SG/SG-VOCXXXBAC-001.pdf"
 },
 "integration": {
  "summary": "Set the MS/TP MAC in the menu, pick VOC units with BV 1, then read VOC, RH and temperature. Treat -1000 as a sensor error.",
  "minimum_points": [
   {
    "ref": "AI 1",
    "name": "VOC Sensor Value",
    "why": "VOC index or TVOC ppb (per BV 1)"
   },
   {
    "ref": "AI 3",
    "name": "Temperature Sensor Value",
    "why": "Room temperature"
   },
   {
    "ref": "AI 2",
    "name": "RH Sensor Value",
    "why": "Room RH"
   },
   {
    "ref": "BI 2",
    "name": "Override Status",
    "why": "Occupant override active"
   },
   {
    "ref": "BI 1",
    "name": "Relay Status",
    "why": "Relay alarm active"
   }
  ],
  "enable": null,
  "heartbeat": null,
  "remote_sensors": null,
  "setup": [
   "Device instance defaults to 381003 (381000 + MAC); it stops following the MAC once written over BACnet.",
   "MS/TP baud rates 9600-115200 are supported."
  ],
  "gotchas": [
   "Only write BV 5 (new TVOC reference) when the air is known to be clean; the reading is reset to 50 ppb."
  ]
 },
 "points": [
  {
   "type": "AI",
   "instance": 1,
   "name": "VOC Sensor Value",
   "description": "VOC: 0-500 index or 0-1000 ppb per BV 1",
   "units": "VOC index / ppb",
   "access": "R",
   "states": ""
  },
  {
   "type": "AI",
   "instance": 2,
   "name": "RH Sensor Value",
   "description": "Relative humidity, 0-100 %",
   "units": "%RH",
   "access": "R",
   "states": ""
  },
  {
   "type": "AI",
   "instance": 3,
   "name": "Temperature Sensor Value",
   "description": "Temperature, 0-50 °C",
   "units": "°C / °F",
   "access": "R",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 1,
   "name": "Temperature Offset",
   "description": "Temperature offset, ±5 Δ°C or ±10 Δ°F (default 0)",
   "units": "delta °C / °F",
   "access": "W",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 2,
   "name": "Humidity Offset",
   "description": "RH offset, ±10 %RH (default 0)",
   "units": "%RH",
   "access": "W",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 3,
   "name": "Relay Setpoint",
   "description": "Relay trip point; range follows MV 1 (default 20 VOC index)",
   "units": "",
   "access": "W",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 4,
   "name": "Relay Hysterisis",
   "description": "Relay hysteresis; range follows MV 1 (default 20 VOC index)",
   "units": "",
   "access": "W",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 5,
   "name": "Relay On Time",
   "description": "Relay on/off delay, 0-255 s (default 0)",
   "units": "s",
   "access": "W",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 1,
   "name": "VOC Units",
   "description": "VOC reporting units",
   "units": "",
   "access": "W",
   "states": "0=VOC Index, 1=TVOC ppb"
  },
  {
   "type": "BV",
   "instance": 2,
   "name": "Temperature Units",
   "description": "Temperature unit select",
   "units": "",
   "access": "W",
   "states": "0=°C, 1=°F"
  },
  {
   "type": "BV",
   "instance": 3,
   "name": "Relay Test",
   "description": "Forces the relay for testing",
   "units": "",
   "access": "W",
   "states": "0=Inactive, 1=Test"
  },
  {
   "type": "BV",
   "instance": 4,
   "name": "Set Overide",
   "description": "Override command",
   "units": "",
   "access": "W",
   "states": "0=Inactive, 1=Active"
  },
  {
   "type": "BV",
   "instance": 5,
   "name": "Set New TVOC Reference",
   "description": "Write 1 in clean air to reset the TVOC reference (reads 50 ppb)",
   "units": "",
   "access": "W",
   "states": "0=Inactive, 1=Active"
  },
  {
   "type": "BV",
   "instance": 6,
   "name": "Set Wireless Enable",
   "description": "Bluetooth (BLE) wireless link enable",
   "units": "",
   "access": "W",
   "states": "0=Disable, 1=Enable"
  },
  {
   "type": "BI",
   "instance": 1,
   "name": "Relay Status",
   "description": "Relay alarm state",
   "units": "",
   "access": "R",
   "states": "0=Normal, 1=Alarm"
  },
  {
   "type": "BI",
   "instance": 2,
   "name": "Override Status",
   "description": "Override active",
   "units": "",
   "access": "R",
   "states": "0=Inactive, 1=Active"
  },
  {
   "type": "BI",
   "instance": 3,
   "name": "Wireless Connect Status",
   "description": "Bluetooth connection state",
   "units": "",
   "access": "R",
   "states": "0=Disconnected, 1=Connected"
  },
  {
   "type": "MV",
   "instance": 1,
   "name": "Relay Assignment",
   "description": "Reading that drives the relay (default 1)",
   "units": "",
   "access": "W",
   "states": "0=No Relay, 1=VOC, 2=RH, 3=Temperature"
  },
  {
   "type": "MV",
   "instance": 2,
   "name": "LCD Backlight",
   "description": "LCD backlight mode (default 1)",
   "units": "",
   "access": "W",
   "states": "1=Auto, 2=Off, 3=On"
  },
  {
   "type": "MV",
   "instance": 3,
   "name": "LCD Format",
   "description": "Values shown on the LCD (default 1)",
   "units": "",
   "access": "W",
   "states": "1=VOC Index, 2=RH, 3=Temperature, 4=VOC/T/RH"
  }
 ],
 "page": "https://easybacnet.com/bacnet-points-lists/greystone/voc-air-quality-transmitter",
 "note": "Provided as-is. Point availability varies by firmware and options; verify against the live device.",
 "disclaimer": "DISCLAIMER: reference only, provided AS IS with no warranty. May contain errors or be out of date. You must verify every point against the manufacturer's current documentation and the live device before use. easybacnet.com accepts no liability for its use and is not affiliated with the manufacturer. Terms: https://easybacnet.com/terms#content"
}