@dskowronski/homebridge-denon-marantz-avr
v1.1.2
Published
Denon and Marantz AVR support for Homebridge: https://github.com/nfarina/homebridge
Downloads
20
Maintainers
Readme
homebridge-denon-marantz-avr
homebridge-plugin for Denon and Marantz AVR control with Apple-Homekit. Works with most Denon AVR since 2011, supports a second zone and implements the speaker service with Audio Receiver (AVR) characteristic.
Installation
Follow standard installation via Homebridge UI or follow the instruction in NPM for the Homebridge server installation. The plugin is published through NPM and should be installed "globally" by typing:
sudo npm install -g homebridge-denon-marantz-avr
Configuration
Example platforms
section for DRA-N4 (with customized inputs):
{
"platforms": [
{
"platform": "denon-marantz-avr",
"accessories": [
{
"uniqueId": "DenonMarantzAVR",
"displayName": "DENON Ceol Piccolo",
"ip": "192.168.1.2",
"maxVolume": 50,
"defaultVolume": 10,
"defaultInput": "ANALOGIN",
"availableInputs": [
"ANALOGIN",
"DIGITALIN1"
],
"zone2enabled": false
}
]
}
],
}
Usage in Home app
TVs and AVRs are required by HAP to be exposed as separate devices. Therefore, after usual Homekit pairing of Homebridge bridge you need to do the following in Home app:
- click
+
and select Add Accessory - click More options...
- select device with AVR icon and name matching
displayName
from the config - enter PIN that you chose for the bridge (either main Homebridge or plugin-dedicated)
Inputs and power can be controlled from Home app. For volume and up/down/left/right/select buttons, you must use Apple TV remote app and switch to AVR from top menu.
Caveat about volume control
Unfortunately, even Audio Receiver device category in HomeKit (added in R3? R2 is latest "open-source") can't control volume using Home automation, Siri or tvOS. In other words, while neat, HomeKit can't be used to link AppleTV with Denon AVRs that don't support HDMI-CEC (e.g. ones without HDMI and connect over HDMI audio extractors).
As a workaround you can set the following in Apple TV in section Settings - Remotes and Devices - Home Cinema Control - Select Volume Control:
- remove all IR remotes
- switch option to Auto
- confirm in upper level menu it says
Auto (Off)
That way, Siri Remote volume buttons somehow still send IR signals that are understood by some Denon AVRs (incl. DRA-N4), so you can control AVR volume.
Additionaly, iOS Control Other Speakers & TVs in Control Center and in media streaming (AirPlay or Apple Music remote) can control tvOS volume as well (on normal equipment it'd be equal to headphone volume setting as audio over HDMI is like line level). With ability to use Apple TV remote app to set output AVR levels it's semi-competent HDMI-CEC volume control replacement.
References
- DENON AVR control protocol - http://assets.eu.denon.com/DocumentMaster/DE/AVR1713_AVR1613_PROTOCOL_V8.6.0.pdf
- DENON SYSTEM control protocol - http://assets.eu.denon.com/DocumentMaster/DE/DRAN5_RCDN8_PROTOCOL_V.1.0.0.pdf
- Apple HomeKit Accessory Protocol (HAP) - https://developer.apple.com/apple-home/