This page is part of archived documentation for openHAB 3.4. Go to the current stable version
# Denon / Marantz Binding
This binding integrates Denon & Marantz AV receivers by using either Telnet or a (undocumented) HTTP API.
# Supported Things
This binding supports Denon and Marantz receivers having a Telnet interface or a web based controller at http://<AVR IP address>/.
The thing type for all of them is avr.
Tested models: Marantz SR5008, Denon AVR-X2000 / X3000 / X1200W / X2100W / X2200W / X3100W / X3300W / X4400H
Denon models with HEOS support (AVR-X..00H) do not support the HTTP API. They do support Telnet.
During Discovery this is auto-detected and configured.
# Discovery
This binding can discover Denon and Marantz receivers using mDNS. The serial number (which is the MAC address of the network interface) is used as unique identifier.
It tries to detect the number of zones (when the AVR responds to HTTP). It defaults to 2 zones.
# Thing Configuration
The DenonMarantz AVR thing requires the host it can connect to.
There are more parameters which all have defaults set.
| Parameter | Values | Default |
|---|---|---|
| host | hostname / IP address of the AVR | - |
| zoneCount | [1, 2, 3 or 4] | 2 |
| telnetEnabled | true, false | false |
| telnetPort | port number, e.g. 23 | 23 |
| httpPort | port number, e.g. 80 | 80 (1) |
| httpPollingInterval | polling interval in seconds (minimal 5) | 5 |
(1) Models >= 2016 use port 8080 and have a slightly different API
# Channels
The DenonMarantz AVR supports the following channels (some channels are model specific):
| Channel Type ID | Item Type | Description |
|---|---|---|
| General | ||
| general#power | Switch (RW) | Power on/off |
| general#surroundProgram | String (R) | current surround program (e.g. STEREO) |
| general#artist | String (R) | artist of current track |
| general#album | String (R) | album of current track |
| general#track | String (R) | title of current track |
| general#command | String (W) | Command to send to the AVR (for use in Rules) |
| Main zone | ||
| mainZone#power | Switch (RW) | Main zone power on/off |
| mainZone#volume | Dimmer (RW) | Main zone volume |
| mainZone#volumeDB | Number (RW) | Main zone volume in dB (-80 offset) |
| mainZone#mute | Switch (RW) | Main zone mute |
| mainZone#input | String (RW) | Main zone input (e.g. TV, TUNER, ..) |
| Zone 2 | ||
| zone2#power | Switch (RW) | Zone 2 power on/off |
| zone2#volume | Dimmer (RW) | Zone 2 volume |
| zone2#volumeDB | Number (RW) | Zone 2 volume in dB (-80 offset) |
| zone2#mute | Switch (RW) | Zone 2 mute |
| zone2#input | String (RW) | Zone 2 input |
| Zone 3 | ||
| zone3#power | Switch (RW) | Zone 3 power on/off |
| zone3#volume | Dimmer (RW) | Zone 3 volume |
| zone3#volumeDB | Number (RW) | Zone 3 volume in dB (-80 offset) |
| zone3#mute | Switch (RW) | Zone 3 mute |
| zone3#input | String (RW) | Zone 3 input |
| Zone 4 | ||
| zone4#power | Switch (RW) | Zone 4 power on/off |
| zone4#volume | Dimmer (RW) | Zone 4 volume |
| zone4#volumeDB | Number (RW) | Zone 4 volume in dB (-80 offset) |
| zone4#mute | Switch (RW) | Zone 4 mute |
| zone4#input | String (RW) | Zone 4 input |
(R) = read-only (no updates possible) (RW) = read-write (W) = write-only (no feedback)
# Full Example
.things file:
Thing denonmarantz:avr:1 "Receiver" @ "Living room" [host="192.168.1.100"]
.items file:
Switch marantz_power "Receiver" <switch> {channel="denonmarantz:avr:1:general#power"}
Dimmer marantz_volume "Volume" <soundvolume> {channel="denonmarantz:avr:1:mainZone#volume"}
Number marantz_volumeDB "Volume [%.1f dB]" {channel="denonmarantz:avr:1:mainzone#volume"}
Switch marantz_mute "Mute" <mute> {channel="denonmarantz:avr:1:mainZone#mute"}
Switch marantz_z2power "Zone 2" {channel="denonmarantz:avr:1:zone2#power"}
String marantz_input "Input [%s]" {channel="denonmarantz:avr:1:mainZone#input" }
String marantz_surround "Surround: [%s]" {channel="denonmarantz:avr:1:general#surroundProgram"}
String marantz_command {channel="denonmarantz:avr:1:general#command"}
.sitemap file:
...
Group item=marantz_input label="Receiver" icon="receiver" {
Default item=marantz_power
Default item=marantz_mute visibility=[marantz_power==ON]
Setpoint item=marantz_volume label="Volume [%.1f]" minValue=0 maxValue=40 step=0.5 visibility=[marantz_power==ON]
Default item=marantz_volumeDB visibility=[marantz_power==ON]
Selection item=marantz_input mappings=[TV=TV,MPLAY=Kodi] visibility=[marantz_power==ON]
Default item=marantz_surround visibility=[marantz_power==ON]
}
...
# Control Protocol Reference
These resources can be useful to learn what to send using the commandchannel:
← DBQuery Denon HEOS →