{
 "manufacturer": "Lutron",
 "manufacturer_slug": "lutron",
 "model": "Quantum BACnet Area Virtual Device",
 "model_slug": "quantum-area-virtual-device",
 "aliases": [
  "Lutron Quantum BACnet",
  "Quantum area device",
  "Quantum BACnet integration",
  "QSW-BAC-PP-A",
  "369696",
  "Lutron lighting BACnet points",
  "Quantum Lighting Hub BACnet"
 ],
 "equipment_type": "Lighting control system (BACnet IP area device)",
 "applies_to": "Lutron Quantum lighting control systems with the BACnet license; each programmed area appears as its own virtual BACnet device.",
 "summary": "Quantum processors (Quantum Lighting Hubs) speak BACnet IP natively once a BACnet license is enabled. Each subsystem is a main BACnet device that routes to one virtual device per area (room). Every area device carries the same fixed objects for light level, scene, occupancy, daylighting, load shedding, Hyperion shades, power and device failures, plus one object per lighting zone, shade group, 3-wire motor zone and light sensor in that area.",
 "bacnet_transport": [
  "BACnet IP"
 ],
 "firmware": "Quantum 2.6 (BACnet integration software 2.0)",
 "default_device_instance": null,
 "access_inferred": false,
 "notes": [
  "Object names in braces ({ZoneName}, {ShadeGroupName}, {3-Wire Motor Zone Name}) take the names set in the Quantum project.",
  "Only the first instance of each repeating range is listed. The document gives each zone level object a unique instance from 1000 to 1999 and each shade group level a unique instance from 2000 to 2999; shade group presets use 3000-3999, shade group window sensor status 4000-4999, 3-wire motor zones 5000-5999 and light sensors 6000-6999.",
  "Instance 24 is not used in the document.",
  "Area device IDs are Base + System + 1, with Base set in the Quantum software (default 1760000) and System 0-127.",
  "Unoccupied Level and Occupied Level are numeric codes: 0 off, 1-100 percent, 101 unaffected, 102 daylighting, 200 off scene, 201-216 scenes 1-16.",
  "The document is Lutron 369696a (PIC statement for Quantum area virtual devices, Quantum 2.6)."
 ],
 "source": {
  "title": "BACnet PIC Statement for Quantum Area Virtual Devices using Quantum Version 2.6",
  "doc_number": "369696a",
  "revision_date": "2013-08-12",
  "url": "https://assets.lutron.com/a/documents/369696.pdf"
 },
 "integration": {
  "summary": "A Lutron service engineer enables the BACnet license and sets device IDs and network numbers. Each area then shows up as a virtual device behind the processor. Command the area light level (AV 2) or scene (MV 4), read occupancy (MV 8) and power (AV 18), and watch the failure counters.",
  "minimum_points": [
   {
    "ref": "AV 2",
    "name": "Lighting Level",
    "why": "Area light level command, 0-100 %"
   },
   {
    "ref": "MV 4",
    "name": "Lighting Scene",
    "why": "Scene select; 1 = Off scene"
   },
   {
    "ref": "BV 3",
    "name": "Lighting State",
    "why": "On if any light in the area is on"
   },
   {
    "ref": "MV 8",
    "name": "Occupancy State",
    "why": "1 Unocc, 2 Occ, 3 Inactive, 4 Unknown"
   },
   {
    "ref": "AV 18",
    "name": "Total Power",
    "why": "Present lighting power, W"
   },
   {
    "ref": "AV 15",
    "name": "Number of Lamp Failures",
    "why": "Count of failed lamps"
   },
   {
    "ref": "AV 16",
    "name": "Number of Devices Not Responding",
    "why": "Count of offline lighting devices"
   }
  ],
  "enable": "BACnet is native to the Quantum processor but needs a BACnet software license per processor (QSW-BAC-PP-A covers 50 areas); a Lutron service representative enables it and sets the device IDs and network numbers. No separate BMS enable point exists.",
  "heartbeat": null,
  "remote_sensors": null,
  "setup": [
   "BACnet IP (Annex J). The processor is a BACnet router: area virtual devices sit on a virtual network behind the subsystem device.",
   "Device ID = Base + System + 1; Base default 1760000, System 0-127. Agree device IDs and network numbers with the integrator first.",
   "Lutron advises at most 50 areas per subsystem; more areas means slower BACnet responses.",
   "The processor can register as a foreign device; give the BBMD address to the Lutron engineer if the BMS is on another subnet.",
   "Enable COV on the Lutron side before the BMS discovers the system."
  ],
  "gotchas": [
   "Lighting Level reports the brightest fixture in the area when fixtures differ.",
   "Lutron application notes say Schedule and Trend Log objects are not supported; trend and schedule from the BMS or the Quantum timeclock.",
   "Zone and shade object instances are assigned per area; read the object list of each area device."
  ]
 },
 "points": [
  {
   "type": "AV",
   "instance": 2,
   "name": "Lighting Level",
   "description": "Highest light level in the area, 0-100",
   "units": "%",
   "access": "W",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 3,
   "name": "Lighting State",
   "description": "On if any light in the area is on",
   "units": "",
   "access": "W",
   "states": "0=Off, 1=On"
  },
  {
   "type": "MV",
   "instance": 4,
   "name": "Lighting Scene",
   "description": "Active lighting scene; 1 = Off scene",
   "units": "",
   "access": "W",
   "states": "1=Off scene; 2..n = scenes named in the Quantum project ({SceneName})"
  },
  {
   "type": "BV",
   "instance": 5,
   "name": "Daylighting Enabled",
   "description": "Lets daylight sensors limit the area's light level",
   "units": "",
   "access": "W",
   "states": "0=Disabled, 1=Enabled"
  },
  {
   "type": "AV",
   "instance": 6,
   "name": "Daylighting Level",
   "description": "Daylight target cap, 0-100",
   "units": "%",
   "access": "W",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 7,
   "name": "Disable Occupancy",
   "description": "True stops occupancy sensors affecting the lights",
   "units": "",
   "access": "W",
   "states": "0=False, 1=True"
  },
  {
   "type": "MV",
   "instance": 8,
   "name": "Occupancy State",
   "description": "Occupancy of the whole area",
   "units": "",
   "access": "R",
   "states": "1=Unoccupied, 2=Occupied, 3=Inactive, 4=Unknown"
  },
  {
   "type": "AV",
   "instance": 9,
   "name": "Unoccupied Level",
   "description": "Light level/scene used when the area goes unoccupied (0-216)",
   "units": "",
   "access": "W",
   "states": "0=Off, 1-100=level %, 101=Unaffected, 102=Daylighting, 200=Off scene, 201-216=Scene 1-16"
  },
  {
   "type": "AV",
   "instance": 10,
   "name": "Occupied Level",
   "description": "Light level/scene used when the area goes occupied (0-216)",
   "units": "",
   "access": "W",
   "states": "0=Off, 1-100=level %, 101=Unaffected, 102=Daylighting, 200=Off scene, 201-216=Scene 1-16"
  },
  {
   "type": "AV",
   "instance": 11,
   "name": "Additional Occupied Timeout",
   "description": "Extra wait after sensors go unoccupied, 0-300",
   "units": "min",
   "access": "W",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 12,
   "name": "Loadshed Allowed",
   "description": "Area takes part in load shedding",
   "units": "",
   "access": "W",
   "states": "0=No, 1=Yes"
  },
  {
   "type": "AV",
   "instance": 13,
   "name": "Loadshed Goal",
   "description": "Light reduction when loadshed is on, 0-90 %",
   "units": "",
   "access": "W",
   "states": ""
  },
  {
   "type": "MV",
   "instance": 14,
   "name": "Occupancy Mode",
   "description": "How occupancy sensors control the lights",
   "units": "",
   "access": "W",
   "states": "1=Inactive, 2=Automatic ON and Automatic OFF, 3=Manual ON and Automatic OFF, 4=Not Applicable"
  },
  {
   "type": "AV",
   "instance": 15,
   "name": "Number of Lamp Failures",
   "description": "Digital ballasts/drivers reporting lamp failure",
   "units": "",
   "access": "R",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 16,
   "name": "Number of Devices Not Responding",
   "description": "Programmed devices not responding",
   "units": "",
   "access": "R",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 17,
   "name": "Hyperion Enabled",
   "description": "Sun-tracking shade control for the area",
   "units": "",
   "access": "W",
   "states": "0=Disabled, 1=Enabled"
  },
  {
   "type": "AV",
   "instance": 18,
   "name": "Total Power",
   "description": "Present lighting power in the area",
   "units": "watts",
   "access": "R",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 19,
   "name": "Maximum Power",
   "description": "Connected lighting load of the area",
   "units": "watts",
   "access": "R",
   "states": ""
  },
  {
   "type": "BV",
   "instance": 20,
   "name": "Roof-Mount Cloudy Day Sensor: Area Status",
   "description": "Cloudy-day override for Hyperion shades",
   "units": "",
   "access": "W",
   "states": "0=Dark, 1=Sunny"
  },
  {
   "type": "BV",
   "instance": 21,
   "name": "Radio Window Sensor State",
   "description": "Radio window sensor override of Hyperion",
   "units": "",
   "access": "W",
   "states": "0=Disabled, 1=Enabled"
  },
  {
   "type": "BV",
   "instance": 22,
   "name": "Light Level Discrepancy",
   "description": "Photo sensor reading disagrees with timeclock state",
   "units": "",
   "access": "R",
   "states": "0=False, 1=True"
  },
  {
   "type": "AV",
   "instance": 23,
   "name": "Number of Wireless Input Device Failures",
   "description": "Wireless keypads/sensors not communicating",
   "units": "",
   "access": "R",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 25,
   "name": "Number of Loads with Lamps Nearing End of Life",
   "description": "Loads past their programmed lamp-hours",
   "units": "",
   "access": "R",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 1000,
   "name": "{ZoneName} Level",
   "description": "Zone light level; one object per zone, instances 1000-1999",
   "units": "%",
   "access": "W",
   "states": ""
  },
  {
   "type": "AV",
   "instance": 2000,
   "name": "{ShadeGroupName} Level",
   "description": "Shade group level, 100 = open; instances 2000-2999",
   "units": "%",
   "access": "W",
   "states": ""
  },
  {
   "type": "MV",
   "instance": 3000,
   "name": "{ShadeGroupName} Preset",
   "description": "Shade group preset; instances 3000-3999",
   "units": "",
   "access": "W",
   "states": "1=Open, 2-30=user presets, 31=Closed, 32-33=not used, 34=Undefined"
  },
  {
   "type": "MV",
   "instance": 4000,
   "name": "{ShadeGroupName} Radio Window Sensor Shade Group Status",
   "description": "Window sensor state per shade group; instances 4000-4999",
   "units": "",
   "access": "R",
   "states": "1=Unknown, 2=Sunny, 3=Dark"
  },
  {
   "type": "MV",
   "instance": 5000,
   "name": "{3-Wire Motor Zone Name}",
   "description": "3-wire motor output state; instances 5000-5999",
   "units": "",
   "access": "W",
   "states": "1=Stop, 2=Open, 3=Close"
  },
  {
   "type": "AV",
   "instance": 6000,
   "name": "Light Sensor Value",
   "description": "Light sensor reading per sensor; instances 6000-6999",
   "units": "fc",
   "access": "R",
   "states": ""
  }
 ],
 "page": "https://easybacnet.com/bacnet-points-lists/lutron/quantum-area-virtual-device",
 "note": "Re-typed from the manufacturer's public documentation (see source). Point availability varies by firmware and options; verify against the live device."
}