TRO.Y | HTTP | Version 1.0

Introduction

The TRO.Y driver provides monitoring and control of TRO.Y automation systems over a HTTP network connection. The driver communicates with the TRO.Y controller using the TRO.Y CGI JSON protocol and dynamically discovers available devices.

Driver Supports

• Device Discovery
• Shade Control
• Switch Control
• Group Control
• Super Group Control
• Scene Calling

Version History

• Version - 1.0 (Initial Release)

Driver Features

The driver automatically discovers devices configured in the TRO.Y controller and dynamically generates Functions, Variables, and Events based on the discovered devices.

Device Control

• Move Shade(UP/DOWN/STOP)
• Set Shade Position
• Step UP (-10%) / DOWN (+10%)

Switch Control

• Switch Control(ON/OFF/TOGGLE)

Group Control

• Move Shade(UP/DOWN/STOP)

Super Group Control

• Move Shade(UP/DOWN/STOP)

Scene Control

• Trigger Scene(from configuration)
• Refresh Scene List(fetch dynamically)
• Select Scene from List

Global

• Refresh Position

Events

For supported shade devices:

• Shade Opened
• Shade Closed

System Requirements

• RTI Integration Designer: 11.x or above
• RTI XP Processor Firmware: 25.x or above
• TRO.Y Controller and RTI Processor must be on the same subnet.

Driver Configuration

1. Prepare Devices

• Verify that the TRO.Y controller is installed, powered on, and connected to the network.
• Add/Pair the devices to the TRO.Y controller
• Recommended preparation steps:
  1. Confirm the TRO.Y controller is connected to the network.
  2. Verify the controller IP Address and Port.

2. Configure Driver Settings

• Enter the Driver Name.
• Enter the TRO.Y IP Address.
• Enter the TRO.Y Port.
• Configure Debug Level if required.
• Log levels are cumulative in priority:
  • None: No logs are recorded.
  • Connections: Connection logs.
  • userActions: Connection + User Action logs.
  • messages: Connection + User Action + Response Message logs.

3. Run the Configuration Script

• Click Get Device Data.
• Devices, Groups, Super Groups and Scenes are automatically discovered.
• Configuration settings are generated dynamically based on the discovered equipment.

4. Build Driver

• Click Build Driver.

The driver automatically generates:

1. Sources
2. Functions
3. Variables
4. Events

5. Add Sources

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

• {Device Name}

6. Export

• Click Export Configuration to save the driver's complete current configuration to a file.
• A prompt appears asking for the folder path to save to (the file name is generated automatically and shown in the prompt).
• If you leave the prompt blank or cancel, the export is cancelled — nothing is saved.
• The configuration is encrypted and written to a file with a .configbak extension at the path given.
• Each export creates a new, uniquely-named file (the file name includes the date and time it was created), so previous exports are never overwritten.

7. Import

• Click Import Configuration to restore a previously exported .configbak file.
• A prompt appears asking for the full file path (including file name) of the file to import.
• If you leave the prompt blank or cancel, the import is cancelled — nothing changes.
• The driver checks that the file exists and is a valid, matching TRO.Y configuration file. If it's missing, unreadable, or was exported from a different driver, you'll see an error and the import stops with no changes made.
• If the file is valid, all settings are restored, and the driver automatically rebuilds its device list, functions, and variables to match — this may take a few seconds.
• Importing replaces the driver's current configuration. Any changes made since the last export will be lost unless they were also backed up.

Autoprogram

• After adding sources, use RTI Autoprogram to automatically map functions and variables to supported RTI template buttons.
• The driver uses Button Tags including:
  • UP
  • DOWN
  • STOP
  • ON
  • OFF
  • TOGGLE
  • Position
  • Status
  • Etc.

Notes

• Functions and variables are generated dynamically based on the devices discovered from the TRO.Y controller.
• Shade Position variables are generated only for supported shade devices.
• Switch Control functions are generated only for supported switch devices.
• Groups and Super Groups are generated only which are present in the TRO.Y controller during configuration.
• Sources are automatically generated using discovered device names.
• In this driver, direction and percentage correspond to position as follows:
  • UP: Open (0%)
  • DOWN: Close (100%)

Limitations

• Only supported TRO.Y device functions are exposed within RTI.
• Scene additions or deletions on the TRO.Y controller are not automatically detected — refresh the scene list manually after making changes.
• The polling interval for this driver is 30 seconds; position/state feedback is not instantaneous.
• If a shade motor reports "Unknown" status, its travel limits may not be calibrated. In the TRO.Y web interface, use "Adjust" followed by the arrow controls under Motor Limits to set the Upper/Lower limits — limit values cannot be typed directly.
• Before performing Step Up/Down, it is recommended to refresh positions first, since the step is calculated from the driver's last known position rather than a live read from the device.

System Testing

RTI Platform

• Integration Designer: 11.x or above
• XP Processor Firmware: 25.x or above

Devices Tested

• TRO.Y 2

Support Contact

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