Homebridge Denon TV

Homebridge plugin for Denon/Marantz AV Receivers series X/SR. Tested Denon AVR-2112CI, AVR-3311CI, AVR-X6300H, AVR-X2700H, AVC-X4800H, Marantz SR8012, SR6013, M-CR611, PM7000N.

Package Requirements

Package	Installation	Role	Required
Homebridge	Homebridge Wiki	HomeKit Bridge	Required
Config UI X	Config UI X Wiki	Homebridge Web User Interface	Recommended
Denon TV	Plug-In Wiki	Homebridge Plug-In	Required

About The Plugin

• This plugin is based upon the official documentation: Denon Control Protocol 2020
  • Multi Zone control.
  • Power ON/OFF control with short press the tile in HomeKit app.
  • RC/Media control, RC app on iPhone/iPad.
  • Speaker Volume and Mute control with hardware buttons, RC app on iPhone/iPad.
  • Volume and Mute control with extra tile lightbulb/fan (slider).
  • Inputs control using inputs whell or buttons.
  • Digital Input Modes control using extra buttons.
  • Surrounds/Pass Trough Inputs control as a extra accessory tile.
• Siri, some times need to create buttons/switches/sensors.
• Automations, some times need to create buttons/switches/sensors.
• External integrations, RESTFul, MQTT.

Configuration

• First enable Network Contorl Denon/Marantz.
• Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
• Install and use Homebridge Config UI X to configure this plugin.
• The sample-config.json can be edited and used as an alternative.

Key	Description
name	Here set the accessory Name to be displayed in Homebridge/HomeKit.
host	Here set the Hostname or Address IP of AVR.
port	Here set the API communication port, if 8080 is not working try to use port 80 which some receivers use alternatively.
zoneControl	Here choose which zone will be controlled by this section 0 - Main Zone, 1 - Zone 2, 2 - Zone 3, 3 - Surrounds, 4 - Pass Through Inputs.
generation	Here choose generation of Your device, old 0 - 2010 - 2012, middle 1 - 2013 - 2022, new 2 - 2023 and newer.
getInputsFromDevice	If enabled, Inputs will be loaded direct from device.
getFavoritesFromDevice	If enabled, Favorites will be loaded to the inputs list if exist.
getQuickSmartSelectFromDevice	If enabled, Quick/Smart Select will be loaded to the inputs list if exist.
inputsDisplayOrder	Here choose display order of the inputs list, 0 - None, 1 - Ascending by Name, 2 - Descending by Name, 3 - Ascending by Reference, 4 - Ascending by Reference.
inputs	Here create Inputs which You want expose to the Homebridge/HomeKit.
inputs.name	Here set Input Name.
inputs.reference	Choose from available inputs, the inputs that should be published to and appear in HomeKit app in the device tile as inputs list.
surrounds	Here create Surrounds which You want expose to the Homebridge/HomeKit.
surrounds.name	Here set Surround Mode Name.
surrounds.reference	Here choose Surround Mode, the mode that should be published to and appear in HomeKit app in the extra tile as Surrounds List.
passThroughInputs	Here create Pass Through Inputs which You want expose to the Homebridge/HomeKit.
passThroughInputs.name	Here set Pass ThroughInput Name.
passThroughInputs.reference	Choose from available inputs, the inputs that should be published to and appear in HomeKit app in the device tile as inputs list.
buttons	Here create Buttons which You want expose to the Homebridge/HomeKit for Main Zone.
buttons.name	Here set Button Name.
buttons.reference	Here choose Function for this button.
buttons.displayType	Here choose characteristic type to be exposed in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.
buttons.namePrefix	Here enable/disable the accessory name as a prefix for button name.
buttonsZ2	Here create Buttons which You want expose to the Homebridge/HomeKit for Zone 2.
buttonsZ2.name	Here set Button Name.
buttonsZ2.reference	Here choose function for this button.
buttonsZ2.displayType	Here choose characteristic type to be exposed in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.
buttonsZ2.namePrefix	Here enable/disable the accessory name as a prefix for button name.
buttonsZ3	Here create Buttons which You want expose to the Homebridge/HomeKit for Zone 3.
buttonsZ3.name	Here set Button Name.
buttonsZ3.reference	Here choose function for this button.
buttonsZ3.displayType	Here choose characteristic type to be exposed in HomeKit app, possible 0 - None/Disabled, 1 - Outlet, 2 - Switch.
buttonsZ3.namePrefix	Here enable/disable the accessory name as a prefix for button name.
sensorPower	If enabled, then the Power will be exposed as a Contact Sensor, fired if power ON.
sensorVolume	If enabled, then the Volume will be exposed as a Contact Sensor, fired on every Volume change.
sensorMute	If enabled, then the Mute will be exposed as a Contact Sensor, fired if Mmute ON.
sensorInput	If enabled, then the Input will be exposed as a Contact Sensor, fired on every Input change.
sensorInputs	Here create custom Inputs Sensor which You want expose to the Homebridge/HomeKit.
sensorInputs.name	Here set own Sensor Name.
sensorInputs.reference	Here choose Input Reference, sensor fired if switch to this reference.
sensorInputs.displayType	Here choose characteristic type to be exposed in HomeKit app, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor.
sensorInputs.namePrefix	Here enable/disable the accessory name as a prefix for sensor name.
sensorSurrounds	Here create custom Surrounds Sensor which You want expose to the Homebridge/HomeKit.
sensorSurrounds.name	Here set own Sensor Name.
sensorSurrounds.reference	Here choose Sensor Reference, sensor fired if switch to this reference.
sensorSurrounds.displayType	Here choose characteristic type to be exposed in HomeKit app, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor.
sensorSurrounds.namePrefix	Here enable/disable the accessory name as a prefix for sensor name.
powerControlZone	Here select which zone the power want control, 0 - Main Zone, 1 - Zone 2, 2 - Zone 3, 3 - Zone 2/3, 4 - Main Zone + Z2, 5 - Main Zone + Z3, 6 - Main Zone + Z2/Z3, 7 - Master Power, this also working with power button in RC app.
volumeControlNamePrefix	Here enable/disable the accessory name as a prefix for volume control name.
volumeControlName	Here set Your own volume/mute control name or leave empty.
volumeControlType	Here choose what a additional volume/mute control type You want to use, 0 - None/Disabled, 1 - Lightbulb, 2 - Fan.
volumeControlZone	Here select which zone the volume/mute want control, 0 - Main Zone, 1 - Zone 2, 2 - Zone 3, 3 - Zone 2/3, 4 - Main Zone + Z2, 5 - Main Zone + Z3, 6 - Main Zone + Z2/Z3, this also working with hardware buttons in RC app.
volumeMax	Here set the maximum possible volume to set, 0 - 100.
infoButtonCommand	Here choose the function for I button in RC app.
refreshInterval	Here set the data refresh interval.
disableLogDeviceInfo	If enabled, add ability to disable log device info by every connections device to the network.
disableLogInfo	If enabled, disable log info, all values and state will not be displayed in Homebridge log console.
disableLogSuccess	If enabled, disable logging device success.
disableLogWarn	If enabled, disable logging device warnings.
disableLogError	If enabled, disable logging device error.
enableDebugMode	If enabled, debug log will be present in homebridge console.
restFul	This is RSTful server.
enable	If enabled, RESTful server will start automatically and respond to any path request.
port	Here set the listening Port for RESTful server.
debug	If enabled, debug log will be present in homebridge console for RESTFul server.
mqtt	This is MQTT Broker.
enable	If enabled, MQTT Broker will start automatically and publish all awailable PV data.
host	Here set the IP Address or Hostname for MQTT Broker.
port	Here set the Port for MQTT Broker, default 1883.
clientId	Here optional set the Client Id of MQTT Broker.
prefix	Here set the Prefix for Topic or leave empty.
auth	If enabled, MQTT Broker will use authorization credentials.
user	Here set the MQTT Broker user.
passwd	Here set the MQTT Broker password.
debug	If enabled, debug log will be present in homebridge console for MQTT.

Extra Accessory Tile

• Surrounds - supports only Surrounds Control, Surrounds Sensors.
• Pass Tgrough Inputs - always ON, supports only Pass Through Inputs Control, Pass Through Inputs Sensors.

RESTFul Integration

• Only for Main Zone, Zone 2, Zone 3
• POST data as a JSON Object {Power: true}
• Header content type must be application/json

Method	URL	Path	Response	Type
GET	http//ip:port/	info, state, picture, surround	{"Power": {"value": OFF}}	JSON object.

Method	URL	Key	Value	Type	Description
POST	http//ip:port	Power	true, false	boolean	Set power On/Off.
	http//ip:port	Input	SAT/CBL	string	Set input/pass through input.
	http//ip:port	Surround	MUSIC	string	Set surround mode.
	http//ip:port	Volume	0 - 98	integer	Set volume.
	http//ip:port	Mute	true, false	boolean	Set mute On/Off.
	http//ip:port	RcControl	NS9E	string	Send RC command.

MQTT Integration

• Only for Main Zone, Zone 2, Zone 3
• Subscribe data as a JSON Object {Power: true}

Method	Topic	Message	Type
Publish	Info, State, Picture, Surround	{"Power": {"value": OFF}}	JSON object.

Method	Topic	Key	Value	Type	Description
Subscribe	Set	Power	true, false	boolean	Set power On/Off.
	Set	Input	SAT/CBL	string	Set input/pass through input.
	Set	Surround	MUSIC	string	Set surround mode.
	Set	Volume	0 - 98	integer	Set volume.
	Set	Mute	true, false	boolean	Set mute On/Off.
	Set	RcControl	NS9E	string	Send RC command.