RS-232 Toolkit RTI Driver

Drive any RS-232 device. 50 commands + 80 feedbacks, browser-based web UI with Send + Capture, ships with Epson projector sample config.

Drive any RS-232 device — projectors, AVRs, matrix switchers, lighting controllers, automation gateways. The Send + Capture web UI lets you author 50 commands and 80 feedbacks against the live device in minutes instead of hours of trial-and-error against a docs PDF. Ships with a real Epson projector .driverconfig as a starting point — 50 ESC/VP21 commands and 14 feedbacks for power, source, volume, lamp hours, aspect, colour mode, mute, freeze, keylock — paste your own COM port and baud and you are driving a projector in 2 minutes.

Features: - Browser-based web UI on the processor (port 9030) — no other RTI driver has this - Live RX/TX traffic log — see every byte to and from the device in real time - Send + Capture — fire a query, click capture, the feedback pattern auto-populates from the device's actual response. Saves time - 50 commands + 80 feedbacks (20 Boolean + 20 Integer + 20 String + 20 Enum) per driver - .driverconfig export/import — share config between sites, version-control device profiles - 15-minute trial mode — try it on real gear before buying - MAC per licence — locked to a single processor MAC, no DRM phone-home

Introduction

The RS-232 Toolkit is a general-purpose serial control driver from Smart Home Programming and Automation. It controls any device with an RS-232 port that has no dedicated RTI driver, and it doubles as a development scratchpad while you work out an unfamiliar protocol.

Pre-define up to 50 commands that macros fire as "Send Slot N", and up to 80 feedback patterns (20 Boolean, 20 Integer, 20 String, 20 Enum) that watch the incoming serial data and write the result to system variables. A browser page hosted on the processor lets you send commands, watch live traffic and capture feedback patterns straight from the device's replies.

Driver Features

• Commands (TX) - up to 50 pre-defined commands, ASCII (with \r \n \t \xNN escapes) or hex bytes, each with its own terminator (None, LF, CR, CR+LF or custom hex). Macros call SendSlot1 - SendSlot50, and each send fires its own event.
• Ad-hoc sends - Send ASCII Text and Send Hex Bytes take a string, so a macro can send a value built from variables.
• Boolean feedback - an ON pattern and an OFF pattern set a true/false variable (power, mute, freeze).
• Integer feedback - a prefix match extracts the first number in the reply (volume, lamp hours, error code).
• String feedback - a prefix match stores the whole reply text (source name, status text).
• Enum feedback - a list of pattern|label pairs; the first match writes both its label and its 1-based position (inputs, picture modes).
• Two events per feedback - Matched fires on every match; Changed fires only when the value actually changes. Feedbacks also react to unsolicited replies, so a change made on the device's own remote still updates the panel.
• Web page on the processor (default port 9030) - send commands, watch the traffic log, edit every command and feedback, capture patterns from live replies, and export the result as a .driverconfig file.
• Debug console (optional, telnet) for development.

Feedback variable names

For feedback N: BoolFbNBool, IntFbNInt, StrFbNStr, EnumFbNInt + EnumFbNStr, plus a Name, Category and Last Response for each. Event tags: BOOLFBN_MATCHED / BOOLFBN_CHANGED, and the same with INTFB, STRFB and ENUMFB.

Example: an Epson projector

• Commands: "Power On" (PWR ON, CR), "Power Off" (PWR OFF, CR), "Power Query" (PWR?, CR).
• Boolean Feedback 1 "Power State": ON = ":PWR=01", OFF = ":PWR=00".
• Integer Feedback 1 "Volume": prefix ":VOL=".
• Enum Feedback 1 "Source": ":SOURCE=30|HDMI 1;:SOURCE=A0|HDMI 2;:SOURCE=11|Computer".

Bind a power image to BoolFb1Bool, a volume label to IntFb1Int and a source label to EnumFb1Str, and fire SendSlot1 to power on.

Supported Devices

Any device with an RS-232 control port whose protocol is ASCII text or binary bytes. No particular device is certified. Tested by Smart Home Programming against an Epson ESC/VP21 projector simulator connected to an RTI XP processor's serial port, and with serial loopback on the processor. Test the trial against your own device before buying a key.

System Requirements

• Integration Designer - 11.4 or above
• RTI processor - XP-8 class (XP-3 / XP-6 / XP-6s / XP-8 / XP-8s / XP-8v)
• Processor script runtime - 24 or above
• An RS-232 cable between the processor's serial port and the device.

Limitations

• One serial port per driver instance. Load the driver again for a second port.
• For a multi-byte custom receive delimiter, only the last byte is used to split messages.
• Line settings cannot be changed while running: edit Driver Properties and send the project again.
• Enum pattern lists longer than about 250 characters may not survive a reboot. Keep lists short.
• The Connection State reports whether the serial port opened. A serial link has no handshake, so it cannot tell whether a device is actually connected; use a feedback to confirm the device answers.
• The trial restarts each time the driver is loaded.

Related RTI drivers

• Calendar Range Trigger RTI Driver
• Elgato Stream Deck Bridge RTI Driver
• Flic Hub Trigger RTI Driver
• HTTP Toolkit RTI Driver
• Macro Runner RTI Driver
• Panel Keyboard RTI Driver
• Presence Simulation RTI Driver
• Pushover Notifications RTI Driver
• TCP Toolkit RTI Driver
• Tesla Wall Connector WebObject Monitor RTI Driver
• Traffic Camera Viewer RTI Driver
• UDP Toolkit RTI Driver

See all RTI drivers