README.md

homebridge-radiora2

Lutron RadioRA2 plugin for homebridge

Installation

1. Install homebridge using: npm install -g homebridge
   
2. Install this plugin using npm install -g homebridge-radiora2
3. Using your RadioRA2 software, create a new integration user (only needs read access).
4. Run an integration report to get the ID numbers for your devices as needed.
5. Update your configuration file. See sample-config below for a sample.

Configuration Sample

"platforms": [
  {
    "name": "RadioRA2",
    "repeater": "<IP_Address_of_Main_Repeater",
    "username": "<integration_username_you_created>",
    "password": "<integration_username_you_created>",
    "lights":[
      {
        "name": "Main Lights",
        "id": 14,
        "serial": "01afwd56",
        "model": "RRD-6ND-LA",
        "adjustable": true
      },
      {
        "id": 15,
      }
     ],
     "fans":[
       {
         "id": 18,
         "adjustable": true,
         "onvalue": 25
       }
      ],
      "keypads":[
        {
        "name": "Phantom Keypad",
        "id": 21,
        "buttons":[
          {
            "name": "Night Light Levels",
            "id": 1,
            "led": 81
          }
        ]
      }
    ],
    "occupancysensors":[
      {
        "name": "Living Room Occupancy Sensor",
        "id": 6,
        "serial": "0266473A",
        "model": "LRF2-OCR2B-P-WH"
      }
    ],
    "hvaccontrollers":[
      {
        "name": "Living Room Thermostat",
        "id": 36,
        "serial": "0266473A",
        "model": "LR-HWLV-HVAC",
        "heatOnly": true //this is optional
      }
    ],
        "visorcontrolreceivers":[
      {
        "name": "Garage Visor Control Receiver",
        "id": 22,
        "serial": "0266473A",
        "model": "RR-VCRX-WH",
        "buttons":[
          {
            "name": "Garage Lights 100",
            "id": 1,
            "led": 81
          }
        ],
        "inputs":[
          {
            "name": "Garage Door Closed",
            "id": 3,
            "led": 83
          }
        ],
        "outputs":[
          {
            "name": "Garage Door Control",
            "id": 5
          }
        ]
      }
    ]
  }
]

• platform: RadioRA2
• name: can be anything you want
• repeater: the IP address of the main repeater
• username: the intergration username you created
• password: the integration password you created
• debug: optional parameter, will return details in log around response from the repeater.

Accessory Types in array groups

• lights
• fans
• occupancysensors
• keypads
• hvaccontrollers
• visorcontrolreceivers

Each entry in the array groups have the following

• id: (required) the integration ID of that accessory EXCEPT FOR OCCUPANCY SENSORS. USE THE ROOM ID WHEN SETTING UP OCCUPANCY SENSORS. LUTRON REPORTS THE WHOLE ROOM AS CHANGING STATE WHEN ANY ONE ACCESSORY DOES SO YOU DON'T HAVE TO ADD EACH ONE SEPERATELY
• name: (optional) the name of the accessory
• serial: (optional) for description, default:
• model: (optional) for description, default:

Lights and Fans

• adjustable: (optional) boolean value to determine if it is a dimmer or switch, default false
• onvalue: (optional) if the accessory is a dimmer, you can set the value that it turns on to when tapping on the tile, default: 100

Keypads

• stateless: (optional) determines if these are 2 way buttons that will also trigger a lutron button press (false) or listen only buttons that will trigger a HomeKit action (true), default: false
• buttons: (required) array group defining the buttons on the keypad exposed to HomeKit

Each button in the array has

• id: (required) integration ID of that button
• name: (optional) engraving name
• led: (required) the integration ID of that button used for statusing

HVAC Controlelrs

• heatOnly: (optional) will only allow the homekit thermostat to have the Off and Heat modes

Roadmap

• Shades eventually

Notes

Credits

djMax/homebridge-radiora for the inital telnet communication as well as alistairg/homebridge-lutron for some additional functionality.