OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
openhab-docs/_addons_bindings/denon1/readme.md

195 lines
9.2 KiB
Markdown
Raw Permalink Blame History

---
id: denon
label: Denon
title: Denon - Bindings
type: binding
description: "The openHAB Denon Binding allows interaction with Denon AV receivers. It should be compatible with previous generation receivers such as AVR-X2000/X3000, as well as current ones such as X2100W/X3100W."
source: https://github.com/openhab/openhab1-addons/blob/master/bundles/binding/org.openhab.binding.denon/README.md
since: 1x
logo: images/addons/denon.png
install: legacy
---
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
{% include base.html %}
# Denon Binding
The openHAB Denon Binding allows interaction with Denon AV receivers. It should be compatible with previous generation receivers such as AVR-X2000/X3000, as well as current ones such as X2100W/X3100W.
The binding also seems to work with some [Marantz receivers](https://groups.google.com/d/msg/openhab/bSTEfSRt0RU/rOI6uWUe7bIJ).
## Binding Configuration
The binding can be configured in the file `services/denon.cfg`.
Multiple receivers may be defined. Each requires a unique `<name>` to be defined.
| Property | Default | Required | Description |
|------------------|---------|:--------:|-------------------------------------------------------------|
| `<name>`.host | | Yes | The IP address of the receiver |
| `<name>`.update | telnet | No | Connection method. Allowed values are "telnet" or "http". Denon receivers only support one concurrent telnet connection, so use http if any other app is using the telnet connection. |
| refresh | 5000 | No | The refresh interval (in milliseconds) for the http connection method. |
## Item Configuration
Item bindings must conform to the following format:
```
{denon="<name>#<property>"}
```
`<name>` is the name of the receiver defined in the Binding Configuration, and `<property>` is one of the following:
| Property | Type | Description | Accepts |
| :----------- |:------------- | :-------------- | :-------- |
| **General** |
| PW | Switch | Main power | On, Off |
| ZM | Switch | Main zone power | On, Off |
| Z2 | Switch | Zone 2 power | On, Off |
| SURROUNDMODE | String | Surround mode | |
| **Volume** |
| 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** |
| INPUT | String | 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 from network or USB. |
| ARTIST | String | Current artist | |
| ALBUM | String | Current album | |
Property names may be different for different models. Check the [control protocol documentation](#references) to verify the right values.
The input mode switch commands in this table are not comprehensive. The binding supports all SI* and Z2* commands.
The inputs for main and 2nd zone can be switched by sending an 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.).
### Advanced
A lot of other commands can also be sent. Define a Switch item and send it the ON command.
There is no feedback on the state of such commands. See the control protocol documentation for a list of commands.
There is a special property 'COMMAND' that can be used in sitemaps and in scripts. It forwards all Denon commands that are sent to it:
```
String DenonCommand "Command" {denon="avr2000#COMMAND"}
```
In sitemaps:
```
Switch item=DenonCommand label="Surround Mode" mappings=[MSSTANDARD="Standard", MSSTEREO="Stereo"]
```
In scripts:
```
DenonCommand.sendCommand("MNMEN ON")
```
## Examples
###Items
```
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"}
```
### Sitemap
```
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="http://192.168.1.70/NetAudio/art.asp-jpg" 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"]
}
```
## References
### Control protocol documentation
- [AVR-X2000/E400](http://www2.aerne.com/Public/dok-sw.nsf/0c6187bc750a16fcc1256e3c005a9740/96a2ba120706d10dc1257bdd0033493f/$FILE/AVRX2000_E400_PROTOCOL(10.1.0)_V04.pdf)
- [AVR-X4000](http://assets.denon.com/documentmaster/de/avrx4000_protocol%2810.3.0%29_v01.pdf)
- [AVR-3311CI/AVR-3311/AVR-991](http://www.awe-europe.com/documents/Control%20Docs/Denon/Archive/AVR3311CI_AVR3311_991_PROTOCOL_V7.1.0.pdf)
- [CEOL Piccolo DRA-N5/RCD-N8](http://www.audioproducts.com.au/downloadcenter/products/Denon/CEOLPICCOLOBK/Manuals/DRAN5_RCDN8_PROTOCOL_V.1.0.0.pdf)
- [Marantz Control Protocol (2014+)](http://m.us.marantz.com/DocumentMaster/US/Marantz%202014%20NR%20Series%20-%20SR%20Series%20RS232%20IP%20Protocol.xls)
Reference in New Issue View Git Blame Copy Permalink