Driver Details

Integra Receiver DTR (Deprecated)

By: RTI
Updated: Feb. 21, 2017
Version: 2.34

Important Note: This driver has been replaced by the Integra/Onkyo/Pioneer Receivers driver. This driver can continue to be used for older installations and updates but any receivers from 2017 and later should use the newer driver.

Description:

This driver is for the Integra DTR and Onkyo receivers via RS-232 or Ethernet.

Please Note: Starting with the xx.4 model receivers, Integra has made most of the browsing commands and metadata for the NET input into IP only commands, RS-232 control of streaming services will not work.

Version History:

Version 2.0: adds supportfor iPod and HD Radio Universal Port Modules. It also supports Internet Radio and streaming services.

Version 2.1: adds new sources, including the direct select of streaming sources. It also supports receiver pop-ups and keyboard entry.

Version 2.2: adds new inputs from the 2015 models.

Version 2.31: adds fix for .5 increment.

Version 2.33: Driver Maintenance.

Version 2.34: Adds fix for Cyrillic text on NET/USB Menu Title.

Integra/Onkyo Receiver Driver 2

With the xx.4 models (ISCP Protocol V1.24) Integra has made most control and metadata of the NET/USB function into IP control only functions. Control of the streaming functions through the serial port is limited to non-existant.

Revision History

1.0 The Initial release of the driver
1.01
Fixed the failure to accurately scale the sliders when Graph Data Sources were dragged onto them.

2.0 Sources adjusted to newer models, raw input of input codes added. Support added for control of devices (UP-HT1 and UP-A1) connected via the universal port. Metadata added for Internet Radio, Pandora and Rhapsody.

2.1 Added support for multiple, directly accessible streaming services. Also supports pop ups, pop up lists and keyboards
2.11 Fixed Network Service list population when using RS-232.
2.12-2.15
Bug fixes.
2.16
Creates an variable for the top menu of the streaming services menu because it does not work when the NET functions are used in secondary zones only. See the menus section below
2.17
Polls zone 3 and 4 power correctly on connecting, fixes zone 4 volume, fixes zone 2 tone controls and Quick Setup command
2.18 Initializes Zone 3 power correctly on startup
2.19 Adds Bluetooth source selection and state variables for zones main - 4

2.2 Adds STRM BOX and TV source selection and state variables for zones main - 4

2.3 Adds the Advanced Programming Extensions for Integration Designer 10 and above

2.31 Fixes .5 increment volume
2.32 Repairs non-standard tags

2.33 Driver Maintenance

2.34 Adds fix for cyrillic NET/USB Menu Title

New Integra Receivers use volume from 0-100 where older ones used -82-18. Both sets of commands/variables are in the driver. The system auto-programs the 0-100. You'll have to change it manually for older receivers

Menus (2.1)

The Streaming and USB sources use a menu system made up of 10 menu line variables and another 10 to highlight them. There are 10 matching commands that allow each of the 10 menu lines to be selected. The menus automatically fill themselves up when the source is selected. Return or the left cursor command will go back a level.

The top level menu of the streaming function is non-functional unless the main zone is set to NET. A variable was created to show when the system in on the top menu with a matching one for when it's not. This allows you to hide the menu when you're on the top level and replace it with discrete commands (Network Direct Service Select) to switch to the desired service. The sample file uses this strategy. The upside is that it allows you to customize the top level to only include the services desired. Because the Network Direct Service Select command allows the option of including account credentials in the command it's even possible to put multiple Pandora accounts on the main menu.

Pop Ups and Keyboards (2.1)

The receiver supports several different types of pop ups, pop up lists and keyboards. There are boolean variables that are used for the visibility of these items. The sample file contains example of their use.

Pop Ups: Pop ups are simple choices. a pop up will have a title, two buttons and a description. Once these are visible you use the two button commands, labeled with the text variable for that button, to tell the receiver your selection. Then the pop up variable will go off, hiding the pop up.

Pop Up Lists: Pop ups are less often used. They have 6 different parameters, each with it's own title. While the list can show you many parameters, you still just select one of the two buttons

Keyboards: Use the flag variable to make a keyboard graphic visible. The shift/numeric commands and flags are for your convenience only, and give you options when designing your keyboard. In fact, any key can be entered at any time (the sample file even uses a single key to enter '.com').

The sample file has pages that never get displayed. The keyboards and pop ups were built on these pages and then pasted onto the server pages. If they need to be edited they can be deleted from their normal page, edited in smaller chunks on smaller pages, and then re-pasted back where they belong.

Driver Notes

The driver attempts to be compatible with as many models as possible. All input sources and surround modes are returned as integers so that their names are editable by using the 'Edit Text...' menu for the button. If your model returns the input (or listening mode) as a number rather than text, you can just add it to the translation table.

The 12v Triggers can only be set remotely if they are set to ‘OFF” for all devices in the setup menu.

Net-Tune Commands for FF/REW must be sent continuously with no more than 100ms between codes.

You must be certain to use the correct set of commands/variables if you're using HD Radio. Receivers with internal HD Radio use the commands under the Tuner category, those using an UP-HT1 attached to the Universal Port should use the commands from the Universal Port HD Tuner category.

You have limited control of the Universal Port peripherals from the zones, Track up and Down, Chan Up and Down is pretty much it.

Templates
The driver uses the following templates in its subsources:
Analog Tuner: AM/FM Radio, Tuner
Unversal Port HD Tuner: AM/FM Radio, Tuner
iPod (Direct): iPod, Media Player - Advanced, Media Player - Basic, Media Player - Simple, Music Player
Universal Port Devices: Media Player - Advanced, Media Player - Simple, Music Player
Net/USB: Media Player - Advanced, Media Player - Simple, Music Player

In case of multiple entries, APEX uses the first available device in the template file.