Ruckus/RiVi ICX RTI Driver Instructions

This RTI driver provides IP-based Telnet or RS232 control for Ruckus/Rivi ICX switches (ICX7000 series). It supports full control over port status (Link and PoE), real-time feedback and configuration of stacked switches.

Version History

Version 2.0 – Complete rewrite. Per-unit system information variables for stacked switches. RS232 serial support. Individual port functions with auto-programming support.

Version 1.3 – FIXED variables not feeding after turning PoE On/Off

Version 1.2 – Variable names now populate correctly. Also fixed variables not populating if connected via RS232 and reloading the project file.

Version 1.1 – RS232 control added

Version 1.0 – Initial release

Features

Enable / Disable individual Ethernet ports (Link status)

Enable / Disable PoE on PoE-capable ports

Reboot individual ports (Link and PoE)

Real-time feedback for port link status, speed, duplex and port names

Real-time feedback for PoE status and power consumption per port

Per-unit system information (model, firmware, boot version, uptime)

Per-unit PoE power budget (total, used, free)

Support for stack configurations (up to 12 switches)

Dynamic configuration for port count, C ports, and SFP ports per switch

Auto-programming support – functions are linked to feedback variables automatically

Prerequisites

Telnet Connection

Telnet must be enabled on the switch before the driver can connect. Connect to the switch via USB-C console cable or SSH and enter the following commands:

Enable

Configure terminal

Telnet server

Write memory

RS232 Serial Connection

If using RS232 to control the switch you will need to wire a specific RJ45 cable. Wire one end using standard T-568 wiring. At the ICX switch end you will need to wire it as follows:

If using T-568A wiring, the ICX end will need to be wired as:

Pin 1 – White/Orange

Pin 2 – Green

Pin 3 – White/Blue

Pin 4 – White/Green

Pin 5 – Blue

Pin 6 – Orange

Pin 7 – White/Brown

Pin 8 – Brown

If using T-568B wiring, the ICX end will need to be wired as:

Pin 1 – White/Orange

Pin 2 – Orange

Pin 3 – White/Blue

Pin 4 – White/Green

Pin 5 – Blue

Pin 6 – Green

Pin 7 – White/Brown

Pin 8 – Brown

Bold pins indicate wires that differ from standard wiring.

Driver Configuration

Connection Settings

Name – Name of the driver instance

Control Method – Telnet TCP or Serial RS232

IP Address – IP address of the switch (Telnet only)

Port Number – Telnet port, usually 23 (Telnet only)

Serial Port – COM port of the RS232 connection (Serial only)

Baud Rate – 9600 is standard and should not need to be changed (Serial only)

Username – Login username as configured on the switch

Password – Login password as configured on the switch

Enable Debug – Enables detailed logging in the XP debug output for troubleshooting

Stack Configuration

Stack Unit Count – How many switches are in the stack. Default is 1. Supports up to 12 switches (ICX limitation).

For each switch in the stack, the following settings are available:

Switch Port Count – The number of RJ45 Ethernet ports on the switch (8, 12, 24 or 48)

C Ports – Whether the switch has C ports (non-PoE copper uplink ports, labelled Cx on the switch)

SFP Ports – Whether the switch has SFP fibre ports (labelled X on the switch)

SFP Port Count – Number of SFP ports (2, 4 or 8)

These settings determine which ports appear in the driver. Ensure they match the physical switch hardware.

Supported Commands

Port Control

Link On – Enables the Ethernet port

Link Off – Disables the Ethernet port

Link Reboot – Disables and re-enables the port after a short delay

PoE Control (PoE-capable ports only)

PoE On – Enables Power over Ethernet on the port

PoE Off – Disables Power over Ethernet on the port

PoE Reboot – Disables and re-enables PoE after a short delay

Feedback Variables

Per-Port Feedback

Each configured port provides the following real-time feedback:

Link Status – Whether the port link is Up or Down

Port Enabled – Whether the port is administratively enabled or disabled

Speed – Current link speed (100M, 1G, 10G)

Duplex – Current duplex mode (Full, Half)

Port Name – The configured name of the port on the switch

PoE Enabled – Whether PoE is administratively enabled (PoE ports only)

PoE Status – Current PoE operating state (On, Off, Fault)

PoE Power – Current power draw in Watts (PoE ports only)

Per-Unit System Information

Each switch in the stack provides:

Switch Model – Hardware model (e.g. ICX7150-24-POE)

Firmware Version – Currently running software version

Boot Version – Boot monitor / primary boot code version

System Uptime – How long the switch has been running

PoE Total Power – Total available PoE power budget in Watts

PoE Used Power – Currently consumed PoE power in Watts

PoE Free Power – Remaining available PoE power in Watts

Global Information

Connection Status – Whether the driver is connected to the switch

Connection State – Current state (Connecting, Authenticating, Connected, Disconnected)

Total Ports – Total number of ports discovered on the switch

Stack Unit ID – The active stack unit ID

Stack Role – The bootup role of the active unit (active, standby, standalone)

Auto-Programming

This driver supports RTI auto-programming. Each port function has a matching button tag that corresponds to its feedback variable. When using auto-programming in Integration Designer, port control buttons will automatically link to the correct status feedback.

Diagnostics

All configured ports will appear in XP Diagnostics with their port names. Feedback updates reflect the real-time state of the switch. System information and PoE budget variables are grouped per switch unit in the stack.

Important Notes

Ensure the ICX switch is reachable from the XP processor over the network (Telnet) or connected via the console port (RS232).

The XP processor must not be powered via PoE from the same switch if you intend to use PoE disable or reboot commands. Disabling PoE on the port that powers the processor will result in loss of control.

Port status and PoE information refreshes automatically every 5 minutes. System information (model, firmware, uptime) also refreshes on this cycle.

Port names displayed in the driver are limited to 15 characters by the switch hardware.

Support

Support is handled by Habitech Ltd.

Please have the subject of the email titled – RTI Driver - <driver name>

For example: RTI Driver - ICX Switch

Email: RTI@Habitech.co.uk