--- id: onkyo label: Onkyo title: Onkyo - Bindings type: binding description: "This binding integrates the Onkyo AV receivers." since: 2x logo: images/addons/onkyo.png install: auto --- {% include base.html %} # Onkyo Binding This binding integrates the Onkyo AV receivers. ## Introduction Binding should be compatible with Onkyo AV receivers which support ISCP (Integra Serial Control Protocol) over Ethernet (eISCP). ## Supported Things This binding supports only one thing: The Onkyo AV Receiver. All supported Onkyo devices are registered as an audio sink in the framework. ## Discovery This binding can discover the supported Onkyo AV Receivers. At the moment only the following models are supported: * TX-NR414 * TX-NR509 * TX-NR515 * TX-NR525 * TX-NR535 * TX-NR555 * TX-NR535 * TX-NR616 * TX-NR626 * TX-NR636 * TX-NR646 * TX-NR656 * TX-NR717 * TX-NR727 * TX-NR747 * TX-NR818 * TX-NR828 * TX-NR838 ## Binding Configuration The binding can auto-discover the Onkyo AVRs present on your local network. The auto-discovery is enabled by default. To disable it, you can create a file in the services directory called onkyo.cfg with the following content: ``` org.openhab.onkyo:enableAutoDiscovery=false ``` This configuration parameter only controls the Onkyo AVR auto-discovery process, not the openHAB auto-discovery. Moreover, if the openHAB auto-discovery is disabled, the Onkyo AVR auto-discovery is disabled too. The binding has the following configuration options, which can be set for "binding:onkyo": | Parameter | Name | Description | Required | |-----------------|------------------------|--------------|------------ | | callbackUrl | Callback URL | URL to use for playing notification sounds, e.g. http://192.168.0.2:8080 | no | ## Thing Configuration The Onkyo AVR thing requires the ip address and the port to access it on. In the thing file, this looks e.g. like Model specific ``` onkyo:TX-NR818:myOnkyo [ipAddress="192.168.1.100", port="60128"] ``` or Generic model ``` onkyo:onkyoAVR:myOnkyo [ipAddress="192.168.1.100", port="60128"] ``` Optionally you can specify the refresh interval by refreshInterval parameter. ``` onkyo:onkyoAVR:myOnkyo [ipAddress="192.168.1.100", port="60128", refreshInterval=30] ``` Maximum volume level can also be configured by volumeLimit parameter. This prevent setting receiver volume level too high, which could damage your speakers or receiver. ``` onkyo:onkyoAVR:myOnkyo [ipAddress="192.168.1.100", port="60128", volumeLimit=50] ``` Binding then automatically scale the volume level in both directions (100% = 50 = 100%). ## Channels The Onkyo AVR supports the following channels (some channels are model specific): | Channel Type ID | Item Type | Description | |-------------------------|--------------|--------------| | zone1#power | Switch | Power on/off your device | | zone1#mute | Switch | Mute/unmute zone 1 | | zone1#input | Number | The input for zone 1 | | zone1#volume | Dimmer | Volume of zone 1 | | zone2#power | Switch | Power on/off zone 2 | | zone2#mute | Switch | Mute/unmute zone 2 | | zone2#input | Number | The input for zone 2 | | zone2#volume | Dimmer | Volume of zone 2 | | zone3#power | Switch | Power on/off zone 3 | | zone3#mute | Switch | Mute/unmute zone 3 | | zone3#input | Number | The input for zone 3 | | zone3#volume | Dimmer | Volume of zone 3 | | player#control | Player | Control the Zone Player, e.g. play/pause/next/previous/ffward/rewind (available if playing from Network or USB)| | player#title | String | Title of the current song (available if playing from Network or USB)| | player#album | String | Album name of the current song (available if playing from Network or USB)| | player#artist | String | Artist name of the current song (available if playing from Network or USB)| | player#currentPlayingTime | String | Current playing time of the current song (available if playing from Network or USB)| | player#listenmode | Number | Current listening mode e.g. Stereo, 5.1ch Surround,..| | player#playuri | String | Plays the URI provided to the channel | | player#albumArt | Image | Image of the current album art of the current song | | player#albumArtUrl | String | Url to the current album art of the current song | | netmenu#title | String | Title of the current NET service | | netmenu#control | String | Control the USB/Net Menu, e.g. Up/Down/Select/Back/PageUp/PageDown/Select[0-9] | netmenu#selection | Number | The number of the currently selected USB/Net Menu entry (0-9) | netmenu#item0 | String | The text of USB/Net Menu entry 0 | netmenu#item1 | String | The text of USB/Net Menu entry 1 | netmenu#item2 | String | The text of USB/Net Menu entry 2 | netmenu#item3 | String | The text of USB/Net Menu entry 3 | netmenu#item4 | String | The text of USB/Net Menu entry 4 | netmenu#item5 | String | The text of USB/Net Menu entry 5 | netmenu#item6 | String | The text of USB/Net Menu entry 6 | netmenu#item7 | String | The text of USB/Net Menu entry 7 | netmenu#item8 | String | The text of USB/Net Menu entry 8 | netmenu#item9 | String | The text of USB/Net Menu entry 9 ## Input Source Mapping Here after are the ID values of the input sources: * 00: DVR/VCR * 01: SATELLITE/CABLE * 02: GAME * 03: AUX * 04: GAME * 05: PC * 16: BLURAY/DVD * 32: TAPE1 * 33: TAPE2 * 34: PHONO * 35: CD * 36: FM * 37: AM * 38: TUNER * 39: MUSICSERVER * 40: INTERNETRADIO * 41: USB * 42: USB_BACK * 43: NETWORK * 45: AIRPLAY * 48: MULTICH * 50: SIRIUS ## Item Configuration demo.items ``` Switch avr1Z1_Power "Power" { channel="onkyo:onkyoAVR:avr1:zone1#power" } Switch avr1Z1_Mute "Mute" { channel="onkyo:onkyoAVR:avr1:zone1#mute" } Number avr1Z1_Input "Input [%s]" { channel="onkyo:onkyoAVR:avr1:zone1#input" } Dimmer avr1Z1_Volume "Volume [%d]" { channel="onkyo:onkyoAVR:avr1:zone1#volume" } Switch avr1Z2_Power "Power [%s]" { channel="onkyo:onkyoAVR:avr1:zone2#power" } Switch avr1Z2_Mute "Mute [%s]" { channel="onkyo:onkyoAVR:avr1:zone2#mute" } Number avr1Z2_Input "Input [%s]" { channel="onkyo:onkyoAVR:avr1:zone2#input" } Dimmer avr1Z2_Volume "Volume [%s]" { channel="onkyo:onkyoAVR:avr1:zone2#volume" } Player avr1Player_Control "Control" { channel="onkyo:onkyoAVR:avr1:player#control" } String avr1Player_Title "Title [%s]" { channel="onkyo:onkyoAVR:avr1:player#title" } String avr1Player_Album "Album [%s]" { channel="onkyo:onkyoAVR:avr1:player#album" } String avr1Player_Artist "Artist [%s]" { channel="onkyo:onkyoAVR:avr1:player#artist" } String avr1Player_CurrentPlayingTime "CurrentPlayingTime [%s]" { channel="onkyo:onkyoAVR:avr1:player#currentPlayingTime" } Number avr1Player_Listenmode "Listenmode [%d]" { channel="onkyo:onkyoAVR:avr1:player#listenmode" } String avr1Player_PlayURI "PlayURI [%s]" { channel="onkyo:onkyoAVR:avr1:player#playuri" } Image avr1Player_AlbumArt "AlbumArt [%s]" { channel="onkyo:onkyoAVR:avr1:player#albumArt" } String avr1Player_AlbumArtUrl "AlbumArtUrl [%s]" { channel="onkyo:onkyoAVR:avr1:player#albumArtUrl" } String avr1Net_Title "Title [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#title" } String avr1Net_Control "Control" { channel="onkyo:onkyoAVR:avr1:netmenu#control" } Number avr1Net_Selection "Selection [%d]" { channel="onkyo:onkyoAVR:avr1:netmenu#selection" } String avr1Net_Item0 "Item0 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item0" } String avr1Net_Item1 "Item1 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item1" } String avr1Net_Item2 "Item2 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item2" } String avr1Net_Item3 "Item3 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item3" } String avr1Net_Item4 "Item4 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item4" } String avr1Net_Item5 "Item5 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item5" } String avr1Net_Item6 "Item6 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item6" } String avr1Net_Item7 "Item7 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item7" } String avr1Net_Item8 "Item8 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item8" } String avr1Net_Item9 "Item9 [%s]" { channel="onkyo:onkyoAVR:avr1:netmenu#item9" } ``` ## Sitemap Configuration demo.sitemap ``` sitemap demo label="Onkyo AVR" { Frame label="Zone1" { Switch item=avr1Z1_Power Switch item=avr1Z1_Mute Selection item=avr1Z1_Input mappings=[ 0='DVR/VCR', 1='SATELLITE/CABLE', 2='GAME', 3='AUX', 4='GAME', 5='PC', 16='BLURAY/DVD', 32='TAPE1', 33='TAPE2', 34='PHONO', 35='CD', 36='FM', 37='AM', 38='TUNER', 39='MUSICSERVER', 40='INTE RNETRADIO', 41='USB', 42='USB_BACK', 43='NETWORK', 45='AIRPLAY', 48='MULTICH', 50='SIRIUS' ] Slider item=avr1Z1_Volume } Frame label="Zone 2" { Switch item=avr1Z2_Power Switch item=avr1Z2_Mute Selection item=avr1Z2_Input mappings=[ 0='DVR/VCR', 1='SATELLITE/CABLE', 2='GAME', 3='AUX', 4='GAME', 5='PC', 16='BLURAY/DVD', 32='TAPE1', 33='TAPE2', 34='PHONO', 35='CD', 36='FM', 37='AM', 38='TUNER', 39='MUSICSERVER', 40='INTE RNETRADIO', 41='USB', 42='USB_BACK', 43='NETWORK', 45='AIRPLAY', 48='MULTICH', 50='SIRIUS' ] Slider item=avr1Z2_Volume } Frame label="Player" { Default item=avr1Player_Control Text item=avr1Player_Title Text item=avr1Player_Album Text item=avr1Player_Artist Text item=avr1Player_CurrentPlayingTime Selection item=avr1Player_Listenmode mappings=[0=Stereo, 1=Direct, 2=Surround, 15=Mono, 31="Whole House", 66="THX Cinema"] } Frame label="NetMenu" { Text item=avr1Net_Title Selection item=avr1Net_Control mappings=[ Up='Up', Down='Down', Select='Select', Back='Back', PageUp='PageUp', PageDown='PageDow', Select0='Select0', Select1='Select1', Select2='Select2', Select3='Select3', Select4='Select4', S elect5='Select5', Select6='Select6', Select7='Select7', Select8='Select8', Select9='Select9' ] Selection item=avr1Net_Selection mappings=[ 0='Item0', 1='Item1', 2='Item2', 3='Item3', 4='Item4', 5='Item5', 6='Item6', 7='Item7', 8='Item8', 9='Item9' ] Text item=avr1Net_Item0 Text item=avr1Net_Item1 Text item=avr1Net_Item2 Text item=avr1Net_Item3 Text item=avr1Net_Item4 Text item=avr1Net_Item5 Text item=avr1Net_Item6 Text item=avr1Net_Item7 Text item=avr1Net_Item8 Text item=avr1Net_Item9 } } ``` ## Audio Support + All supported Onkyo AVRs are registered as an audio sink in the framework. + Audio streams are sent to the `playuri` channel.