homebridge-denonmarantzavr

A homebridge plugin for Denon and Marantz AVRs, to control power in main and secondary zones.

Installation instructions

After Homebridge has been installed:

sudo npm install -g homebridge-denonmarantzavr

Configuration

An example platform configuration stanza:

"platforms": [
  {
    "platform": "DenonMarantzAVR",
    "avrs": [
      {
        "name": "DenAVR",
        "ip": "192.168.0.100",
        "model": "DenonX1400H",
        "zones": 2,
		"speaker": false,
        "zonenames": [
          "Den",
          "Patio"
        ]
      },
      {
        "name": "KitchenAVR",
        "ip": "192.168.0.101",
        "model": "DenonX4400H"
      }
    ]
  }
]

where:

• name: The name of the AVR to control.
• ip: Its (fixed) IP address (try configuring this in your router).
• model (Optional): Model name (defaults to "DENON-LIKE AVR").
• zones (Optional): The number of zones to create HomeKit switches for. Defaults to 1 (main zone only). A maximum of 4 zones is supported (depending on AVR model).
• zonenames (Optional): Names to give the zones, in order (main, Zone 2, Zone 3,...). If not passed, defaults to name, name(Z2), etc.
• speaker (Optional): Whether to use a speaker service instead of a switch. Offers volume control, but not yet supported by the Home App (works in Eve). Defaults to false (i.e. make switches instead).

How it works

This plugin works by opening a persistent socket connection to port 23 (aka telnet port) on the AVR. Since any external changes to state will be reported over this connection, no polling is required. This makes status updates nearly instantaneous compared to other similar plugins. If the connection goes down (e.g. during a network failure), it will attempt to reconnect.

Contributions

I'll accept pull requests for enhancements, additional commands etc. A very useful spreadsheet reference for the commands accepted on port 23 by recent-ish Denon/Marantz AVRs is available here. It's easy to play around with commands on your AVR like:

% nc 192.168.0.10 23

(replace with your AVR's IP address). If you don't have nc, you can try telnet.

Some items TBD:

• Add (optional) support for multi-zone volume control. Trivial command-wise, but the Speaker accessory is not (yet?) supported in Home, so that requires lightbulb or fan psuedo-accessory or the use of 3rd party HomeKit apps. Probably not worth implementing since Speaker works in apps like Eve.
• Map other control commands to HomeKit, e.g. changing inputs, surround mode, etc.

License

MIT License

Copyright (c) 2018-2019 J.D. Smith

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.