Denon HEOS | IP | Version 2.0

Introduction

The Denon HEOS driver provides multi-room audio control for HEOS-supported devices. The driver communicates with HEOS devices using the HEOS CLI protocol over TCP/IP on Port 1255.

Driver Supports

• Individual Player Control
• Selected Player Control
• Individual Group Control
• Selected Group Control
• Queue Management
• Group Management
• Browsing Music Services
• Presets Selection
• Inputs Selection
• Service Options Control(Thumbs UP, Thumbs Down, Add to Presets)

Version History

• Version 2.0 — Updated Version

---

Driver Features

The driver dynamically builds functions, variables, events, and sources based on the HEOS devices and music services discovered on the network.

Player Control

• Play State Control
• Adjust Player Volume
• Set Player Volume
• Player Mute Control
• Set Player Mode - Repeat
• Set Player Mode - Shuffle
• Player Stream URL
• Player Service Options(Thumbs UP, Thumbs Down, Add to Presets)
• Play Quick Select
• Set Quick Select
• Player Set Input
• Queue Management(Fetch, Play, Clear)

Selected Player Control

The driver supports a selectable player model where a single UI can dynamically control different HEOS players.

Supported selected-player features include:

• Adjust Selected Player Volume
• Set Selected Player Volume
• Selected Player Mute Control
• Selected Player Play State Control
• Set Selected Player Mode - Repeat
• Set Selected Player Mode - Shuffle
• Selected Player Stream URL
• Selected Player Service Options(Thumbs UP, Thumbs Down, Add to Heos Presets)
• Selected Player Play quick select
• Selected Player Set Quick Select
• Selected Player Set Input
• Selected Player Queue Management(Fetch, Play, Clear)

Browse Control

• Select Browse List Item
• Select Browse List Back
• Select Browse List Top
• Select Browse List Context Selection(Selected Player)
• Browse List Context Selection(Individual Player)
• Set Browse Style
• Select Music Service

Queue Management

This applies to both the Selected Player and the Individual Player.

• Fetch Queue
• Set Queue Style(List Item, Song, Album, Artist)
• Queue Selection
• Player Queue Edit Mode(Play Selection, Remove Selection, Clear Selection, Clear All)

Group Control

• Group Add/Remove Players
• Add Player to Group Queue
• Set Group Volume
• Adjust Group Volume
• Group Mute Control

Selected Group Control

• Selected Group Add/Remove Players
• Add Player to Selected Group Queue
• Set Selected Group Volume
• Adjust Selected Group Volume
• Selected Group Mute Control

Global Functions

• Discard Active Groups – Deletes all currently active groups.
• Sync Players Status – Updates whether each player is connected to the network or inactive.

---

System Requirements

• RTI Integration Designer: 11.x or above
• RTI XP Processor Firmware: 25.x or above
• All HEOS devices and the RTI processor must be on the same subnet within the network

---

Driver Configuration

1. Prepare Devices

Using the HEOS app, configure all HEOS devices and verify normal operation before adding the driver.

Recommended preparation steps:

• Ensure that the RTI processor and all connected devices are on the same subnet within the network.
• Assign static IP addresses to HEOS devices and RTI Processor where possible to prevent IP changes after reboots.

2. Configure Driver Settings

• Enter the Driver name.
• Enter the HEOS credentials at HEOS Username and HEOS Password.
• Enter the IP address of any HEOS‑supported device.

3. Run the Configuration Script

• Click Get Device Data to connect to each configured device and pull in device information.
• Device count - No of devices in player count are automatically generated.
• Step Volume - Select the step volume value for device volume adjustment.
• Player Name - Name of the player and can be changed if needed.
• The script queries each device's capabilities and dynamically generates sources, functions, and variables scoped to what each device actually supports.
• click Build Driver.

4. Build Driver Data

The driver automatically creates controls only for discovered devices and supported capabilities.

5. Add Sources

After the configuration process completes, the following sources become available for discovered devices.

• {Player_Name} -- Player level Controls

Autoprogram

• With sources added, use autoprogramming to link functions and variables to your template buttons. The driver uses generic button tags (Play, Volume Up, Mute On, etc.) that match standard RTI template tags directly.

Note

• All HEOS devices and the RTI processor must be connected to the same subnet within the network. This is required for device discovery and reliable ongoing communication.
• Use the same HEOS account credentials across all configuration and control operations to ensure access to the full set of driver features.
• The driver exposes the following variable:
  • Driver Connected - (true/false) this indicates whether the driver is in connected state with HEOS device.
  • {Player_Name} Active - (true/false) this indicates whether the player is connected to the network or inactive.
  • Message - Holds the latest message generated by the driver, including status updates, warnings, or error notifications. This variable provides visibility into driver communication.
• If the Driver Connected variable reads false, verify that all devices are powered on, connected to the network, and on the correct subnet before troubleshooting further.
• Only select the available inputs that the device supports to avoid errors.
• Music Services are available based on HEOS documention.

Limitations

• Functions and variables are generated based on what each device reports as supported. A feature listed in Driver Features may not appear for a specific device model if that device does not report support for it via the API.
• All HEOS devices must be on the same subnet within the network — devices on different subnets or VLANs will not be discovered or controlled.

---

System Testing

RTI Platform

• Integration Designer: 11 or above
• XP Processor Model: XP-6s
• XP Processor Firmware: 25.11.20

HEOS Devices Tested

• Marantz CINEMA 50
• Marantz SR5015
• Marantz SR7015

---

Support Contact

Miantic AV Distribution Pvt. Ltd. licenses@miantic.com Copyright © Miantic AV Distribution 2021–2026