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

• Multi Zone control.
• Power ON/OFF short press tile in HomeKit app.
• RC/Media control is possible after you go to the RC app on iPhone/iPad.
• Speaker control is possible after you go to RC app on iPhone/iPad Speaker Service.
• Legacy Volume and Mute control is possible throught extra lightbulb/fan (slider).
• Inputs/Surrounds can be changed using Inputs selector in the Home app or using extra tile.
• Digital Input Modes can be controlled by creating separate tile in the buttons section.
• Siri can be used for all functions, some times need create legacy buttons/switches/sensors.
• Automations can be used for all functions, some times need create legacy buttons/switches/sensors.
• This plugin is based upon the official documentation: Denon Control Protocol 2020
• Support 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 - Surround Mode. | | 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. | | 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. | | masterPower | If enabled, then the Power switch for that zone will turn the entire receiver ON or OFF/STANDBY rather than just the zone itself. | | masterVolume| If enabled, then the Volume for that zone will set the entire receiver UP or DOWN rather than just the zone itself, (only for the Zone 1 and 2). | | masterMute| If enabled, then the Mute switch for that zone will muted the entire receiver ON or OFF rather than just the zone itself, (only for the Zone 1 and 2). | | volumeControlNamePrefix | Here enable/disable the accessory name as a prefix for volume control name. | | volumeControlName | Here set Your own volume control name or leave empty. | | volumeControl | Here choose what a additional volume control mode You want to use, 0 - None/Disabled, 1 - Lightbulb, 2 - Fan. | | 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. | | enableDebugMode | If enabled, deep log will be present in homebridge console. | | disableLogInfo | If enabled, disable log info, all values and state will not be displayed in Homebridge log console. | | disableLogDeviceInfo | If enabled, add ability to disable log device info by every connections device to the network. | | disableLogConnectError | If enabled, disable logging device connect error. | | enableRestFul | If enabled, RESTful server will start automatically and respond to any path request. | | 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, deep 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, deep log will be present in homebridge console for MQTT. | | AV Surround Mode | This extra Accessory will control all functions of Main Zone except Inputs and Buttons. |

RESTFul Integration

• POST data as a JSON Object {Power: true}

| 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 | Power On/Off. | | | http//ip:port | Input | SAT/CBL | string | Set input. | | | http//ip:port | Surround | MUSIC | string | Set surround mode. | | | http//ip:port | RcControl | NS9E | string | Send RC command. | | | http//ip:port | Volume | 100 | integer | Set volume. | | | http//ip:port | Mute | true, false | string | Set mute On/Off. |

MQTT Integration

• 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 | Power state. | | | Set | Input | SAT/CBL | string | Set input. | | | Set | Surround | MUSIC | string | Set surround mode. | | | Set | RcControl | NS9E | string | Send RC command. | | | Set | Volume | 100 | integer | Set volume. | | | Set | Mute | true, false | boolean | Set mute. |