[[Image(front_med.jpg)]]

= Onkyo Receiver (AVR) Plugin=

The Onkyo Audio Video Receiver is a networked receiver that is capable of being controlled through the eISCP protocol.

This plugin can be used to trigger scenes on your Vera device automatically when the device is turned on. This plugin will also allow you to control most of its features which include: 
* Power 
* Volume 
* Mute 
* Input 
* Surround Type 
* Navigation 
* Playback Control 
* HDMI Out 
* Macros - Automated commands

Link to company page ​http://www.onkyousa.com \\ 
Relevant forum thread ​http://forum.micasaverde.com/index.php/topic,17811.msg139582.html#msg139582 \\
Advanced Users Page: [[Advanced Users]] - includes the Macro Guide.

== Installation Instructions==

You can install the plugin from http://apps.mios.com/plugin.php?id=5176 or within Vera UI.  The plugin name is Onkyo Receiver (AVR).

After installing the plugin a device will automatically be created.  
* Go to the advanced tab of that device and add IP address of your receiver (I recommend setting a static IP address on your receiver).  
    * Click save, reload, and refresh the page a couple of times for the buttons to show up.
* Set the Number of Zones in the Config tab.  By default it is set to 2.
* You will have basic control from the dashboard.  
* Note: You must have "network standby" enabled for this plugin to turn the receiver on and off.

== Configuration==

||Parameter||Description||
|--
||IP Address||(Required) This is the IP address of the Onkyo Receiver.||
||Number of Zones||(Default 2) This correlates how many zones that your receiver supports.||
||DEBUG_MODE||(Default 0 or Off) Value of 1 or On enables debugging. This sets the flag to allow logging of plugin tasks and functions.||
||LOG_LEVEL||(Default 1) Allowed values 0-4. The higher the value the more data is logged.||

== Notifications==

The following notification triggers can be used in your scenes. 

||Status||Description||
|----
||On||Is the zone on.||
||Off||Is the zone off||
|--
||TBA||More coming in later versions.  Suggestions please.||

== Service Variables==
This plugin supports 5 service types.  Below are the services and the associated variables.

urn:onkyo-com:serviceId:Receiver1

* !NetService - The input NET individual services.  Such as Spotify and Pandora.
* !NetServiceTarget - Target of !NetService
* Surround - The type of surround setting.  IE: Stereo, Mono, THX.
* !SurroundTarget - Target of Surround.
* HDMIOut - The HDMI output variable.  Main or Sub.
* HDMIOutTarget - Target of HDMIOut.
* zoneCount - The number of zones the receiver has. (not automatically set) Default value 2.
* DEBUGMODE - Setting to enable or disable advanced logging.
* LOGLEVEL - Setting to tell what to log.
* !MacroInput(1 or 2) - Macro variable to select a specific input.  
* !MacroNetService(1 or 2) - Macro variable to select a specific Netservice.
* !MacroNetIndex(1 or 2) - Macro variable CSV list of index values of listed content or menu commands.
* !LastChange - Unformated Timestamp of when any time or track information is updated.
* !PlayStatus - Play,Pause,Stop
* !RepeatStatus - On or Off
* !ShuffleStatus - On or Off


urn:upnp-org:serviceId:SwitchPower1
* Target
* Status

urn:micasaverde-com:serviceId:InputSelection1
* Input
* InputTarget

urn:micasaverde-com:serviceId:Volume1
* Volume
* VolumeTarget
* Mute

urn:upnp-org:serviceId:RenderingControl
* Volume
* Mute

urn:micasaverde-com:serviceId:MediaNavigation1
* stuff

urn:micasaverde-com:serviceId:MenuNavigation1
* stuff

urn:micasaverde-com:serviceId:HaDevice1
* Commfailure

urn:upnp-org:serviceId:AVTransport (Beta)
* stuff