Homebridge Denon TV

Package Requirements

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

Warning

• For plugin < v6.1.0 use Homebridge UI <= v5.5.0.
• For plugin >= v6.1.0 use Homebridge UI >= v5.13.0.

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.
  • Media control, need use RC app on iPhone/iPad.
  • Volume and mute control with extra tile Lightbulb/Fan or Hardware Buttons, need use RC app on iPhone/iPad.
  • Inputs control using inputs whell or buttons.
  • All other functions control using 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 UI 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.
generation	Here choose generation of Your device, old 0 - 2010 - 2012, middle 1 - 2013 - 2022, new 2 - 2023 and newer.
zoneControl	Here choose which zone will be controlled by this section, create same zone multiple times for same AVR is not possible -1 - None/Disabled,0 - Main Zone, 1 - Zone 2, 2 - Zone 3, 3 - Surrounds, 4 - Pass Through Inputs.
inputs{}	Inputs object.
inputs.getFromDevice	If enabled, Inputs will be loaded direct from device.
inputs.getFavoritesFromDevice	If enabled, Favorites will be loaded to the inputs list if exist.
inputs.getQuickSmartSelectFromDevice	If enabled, Quick/Smart Select will be loaded to the inputs list if exist.
inputs.displayOrder	Here choose display order of the inputs list, 0 - None, 1 - Ascending by Name, 2 - Descending by Name, 3 - Ascending by Reference, 4 - Descending by Reference.
inputs.data[]	Inputs array.
inputs.data[].name	Here set Input Name.
inputs.data[].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.displayOrder	Here choose display order of the surrounds list, 0 - None, 1 - Ascending by Name, 2 - Descending by Name, 3 - Ascending by Reference, 4 - Descending by Reference.
surrounds.data[]	Here create Surrounds which You want expose to the Homebridge/HomeKit.
surrounds.data[].name	Here set Surround Mode Name.
surrounds.data[].reference	Here choose Surround Mode, the mode that should be published to and appear in HomeKit app in the extra tile as Surrounds List.
buttons[]	Buttons array.
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 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 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 accessory name as a prefix for button name.
sensors[]	Sensors array.
sensors[].displayType	Here choose sensor type to be exposed in HomeKit app, possible 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor.
sensors[].mode	Here choose sensor mode, possible 0 - Input/Surround, 1 - Power, 2 - Volume, 3 - Mute.
sensors[].name	Here set sensor Name which You want expose to the Homebridge/HomeKit.
sensors[].reference	Here choose Input Reference, sensor fired on switch to this input.
sensors[].referenceSurround	Here choose Surround Reference, sensor fired on switch to this surround.
sensors[].pulse	Here enable sensor pulse, sensor send pulse and fired on every value change of selected mode.
sensors[].namePrefix	Here enable the accessory name as a prefix for sensor name.
sensors[].level	Here set Level between 0 - 100, sensor fired on this level.
power{}	Power object.
power.zone	Here choose 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.
volume{}	Volume object.
volume.displayTtype	Here choose what a additional volume control mode You want to use 0 - None/Disabled, 1 - Lightbulb, 2 - Fan, 3 - TV Speaker, 4 - TV Speaker / Lightbulb, 5 - TV Speaker / Fan.
volume.zone	Here choose 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
volume.name	Here set Your own volume/mute control name or leave empty.
volume.namePrefix	Here enable accessory name as a prefix for volume control name.
volume.max	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.
log{}	Log object.
log.deviceInfo	If enabled, log device info will be displayed by every connections device to the network.
log.success	If enabled, success log will be displayed in console.
log.info	If enabled, info log will be displayed in console.
log.warn	If enabled, warn log will be displayed in console.
log.error	If enabled, error log will be displayed in console.
log.debug	If enabled, debug log will be displayed in console.
restFul{}	RESTFul object.
restFul.enable	If enabled, RESTful server will start automatically and respond to any path request.
restFul.port	Here set the listening Port for RESTful server.
mqtt{}	MQTT object.
mqtt.enable	If enabled, MQTT Broker will start automatically and publish all awailable data.
mqtt.host	Here set the IP Address or Hostname for MQTT Broker.
mqtt.port	Here set the Port for MQTT Broker, default 1883.
mqtt.clientId	Here optional set the Client Id of MQTT Broker.
mqtt.prefix	Here set the Prefix for Topic or leave empty.
mqtt.auth{}	MQTT authorization object.
mqtt.auth.enable	Here enable authorization for MQTT Broker.
mqtt.auth.user	Here set the MQTT Broker user.
mqtt.auth.passwd	Here set the MQTT Broker password.

Extra Accessory Tile

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

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
• Path status response all available paths.

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.