Skip to content

Denon Binding

Wouter Luberti edited this page Apr 10, 2017 · 4 revisions


This binding supports Denon AV receivers. It is available from openHAB 1.7.0 onwards. It should be compatible with previous generation receivers (AVR-X2000/X3000 etc) as well as the current ones (X2100W/X3100W).

The binding seems to work with some Marantz receivers too.


# denon:<instance>.<property>=value

# IP adress of the Denon receiver instance

# Optional, set connection method for receiving updates. Can be http or telnet. 
# Denon receivers only support one concurrent telnet connection, so use http if 
# you have any other app using the telnet connection. Default = telnet

# Optional, this sets the refresh interval (in milliseconds) for all instances 
# if you're using the http connection method. Default = 5000 


All items use the following format:

Property Type Description Accepts
PW Switch Main power On, Off
ZM Switch Main zone power On, Off
Z2 Switch Zone 2 power On, Off
SURROUNDMODE String Current surround mode Read only
MV Dimmer Main volume Percent, Increase/Decrease
MU Switch Mute On, Off
Z2ZV Dimmer Zone 2 volume Percent, Increase/Decrease
Z2MU Switch Zone 2 mute On, Off
INPUT String Select main input Input name
SICD Switch Switch main input to CD On
SITV Switch Switch main input to TV On
Z2SOURCE Switch Switch zone 2 input to source On
Z2TUNER Switch Switch zone 2 input to tuner On
Now playing
TRACK String Current track that is playing, only available when playing something from network or USB. Read only
ARTIST String Current artist Read only
ALBUM String Current album Read only

Input mode names are different for different models. Check your control protocol documentation for the right values. The input mode switch commands in this table are not complete. The binding supports al SI* and Z2* commands.

The inputs for main and 2nd zone can be switched by sending ON command to the corresponding switch. The main input can also be switched by setting the INPUT property to the input name (without SI, see examples).

All zone commands also work on Zone 3 and Zone 4, if your receiver supports this (Z2MU -> Z3MU, etc.).


A lot of other commands can also be sent. Define them as a Switch item and send the ON command. There is no feedback on their state however. See the control protocol documentation for a list of commands.

There is special property 'COMMAND' that forwards all Denon commands that are sent to it:

String DenonCommand			"Command"				{denon="avr2000#COMMAND"}

This can be used in sitemaps:

Switch item=DenonCommand label="Surround Mode" mappings=[MSSTANDARD="Standard", MSSTEREO="Stereo"]

And scripts:

sendCommand(DenonCommand, "MNMEN ON")

Control protocol documentation



Switch DenonPower			"Power"					{denon="avr2000#PW"}
Switch DenonMainZone		"Main Zone"				{denon="avr2000#ZM"}
Dimmer DenonVolume			"Volume [%.1f]"			{denon="avr2000#MV"}
Switch DenonMute			"Mute"					{denon="avr2000#MU"}
String DenonSurroundMode	"Surround mode [%s]"	{denon="avr2000#SURROUNDMODE"}
String DenonCommand			"Command"				{denon="avr2000#COMMAND", autoupdate=false}

String DenonCurrentTrack		"Current track [%s]"		{denon="avr2000#TRACK"}
String DenonCurrentArtist		"Current artist [%s]"		{denon="avr2000#ARTIST"}
String DenonCurrentAlbum		"Current album [%s]"		{denon="avr2000#ALBUM"}

String DenonInput			"Input [%s]"			{denon="avr2000#INPUT"}
Switch DenonInputCD			"Input CD"				{denon="avr2000#SICD"}
Switch DenonInputUSBIPOD	"Input USB/IPOD"		{denon="avr2000#SIUSB/IPOD"}
Switch DenonInputNet		"Input Network"			{denon="avr2000#SINET"}
Switch DenonInputSpotify	"Input Spotify"			{denon="avr2000#SISPOTIFY"}
Switch DenonInputTuner		"Input Tuner"			{denon="avr2000#SITUNER"}
Switch DenonInputDVD		"Input DVD"				{denon="avr2000#SIDVD"}
Switch DenonInputBluray		"Input Bluray"			{denon="avr2000#SIBD"}
Switch DenonInputTV			"Input TV"				{denon="avr2000#SITV"}
Switch DenonInputSATCBL		"Input SAT/CBL"			{denon="avr2000#SISAT/CBL"}
Switch DenonInputMplay		"Input Mediaplayer"		{denon="avr2000#SIMPLAY"}
Switch DenonInputGame		"Input Game"			{denon="avr2000#SIGAME"}
Switch DenonInputAux1		"Input Aux1"			{denon="avr2000#SIAUX1"}

Switch DenonZoneTwo					"Zone 2"				{denon="avr2000#Z2"}
Dimmer DenonZoneTwoVolume			"Volume [%.1f]"			{denon="avr2000#Z2ZV"}
Switch DenonZoneTwoMute				"Zone 2 Mute"			{denon="avr2000#Z2MU"}

Switch DenonZoneTwoInputSource		"Zone 2 Input Source"	{denon="avr2000#Z2SOURCE"}
Switch DenonZoneTwoInputUSB			"Zone 2 Input USB"		{denon="avr2000#Z2USB/IPOD"}
Switch DenonZoneTwoInputTuner		"Zone 2 Tuner"			{denon="avr2000#Z2TUNER"}


Frame label="Main Zone" {
	Switch item=DenonPower
	Switch item=DenonMainZone
	Slider item=DenonVolume
	Setpoint item=DenonVolume minValue=0 maxValue=100 step=0.5
	Switch item=DenonMute
	Switch item=DenonCommand label="Surround Mode" mappings=[MSSTANDARD="Standard", MSSTEREO="Stereo"]
	Text item=DenonSurroundMode
Frame label="Main Zone Input" {
	Selection label="Input" item=DenonInput mappings=[CD="CD", TUNER="Tuner", DVD="DVD", BD="Bluray", TV="TV", "SAT/CBL"="SAT/CBL", MPLAY="Mediaplayer", GAME="Game", AUX1="Aux1"]
	Text item=DenonInput
	Switch item=DenonInputCD mappings=[ON="CD"]
	Switch item=DenonInputTuner mappings=[ON="Tuner"]
	Switch item=DenonInputDVD mappings=[ON="DVD"]
	Switch item=DenonInputBluray mappings=[ON="Bluray"]
	Switch item=DenonInputTV mappings=[ON="TV"]
	Switch item=DenonInputSATCBL mappings=[ON="SAT/CBL"]
	Switch item=DenonInputMplay mappings=[ON="Mediaplayer"]
	Switch item=DenonInputGame mappings=[ON="Game"]
	Switch item=DenonInputAux1 mappings=[ON="Aux1"]
Frame label="Title Info" visibility=[DenonCurrentTrack!="Undefined",DenonCurrentArtist!="Undefined"] {
	Text item=DenonCurrentTrack
	Text item=DenonCurrentArtist
	Text item=DenonCurrentAlbum
	Webview url="" height=9
Frame label="Zone 2" {
	Switch item=DenonZoneTwo
	Switch item=DenonZoneTwoMute
	Slider item=DenonZoneTwoVolume
	Switch item=DenonZoneTwoInputUSB mappings=[ON="USB"]
	Switch item=DenonZoneTwoInputSource mappings=[ON="Source"]
	Switch item=DenonZoneTwoInputTuner mappings=[ON="Tuner"]

feature overview


Setup intro

Linux and OS X





User Interfaces



(link to openHAB forum)



Application Integration



A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules


Syntax highlighting for external editors

Release Notes

Clone this wiki locally
You can’t perform that action at this time.