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 1.0 – Initial release
Version 1.1 - RS232 control added

Features

Enable / Disable individual ports (Link status)

Enable / Disable PoE on PoE-capable ports

Real-time feedback for PoE status

Support for stack configurations (up to 12 switches)

Dynamic configuration for port naming and availability

Prerequisites

Due to this being a telnet driver we need to ensure that the switch has telnet enabled.
Command Line Interface
Connect to the switch via USB C or SSH via putty
After logging into the switch you will need to enter the following commands
Enable (enter)
Configure terminal (enter)
Telnet server (enter)
Write memory (enter)

If using RS232 to control the switch you will need to wire a specific RJ45 cable
Wire one end using standard T-568 at the ICX end you will need to wire it in a set way.

If using T-568A wiring the ICX end will need to be wired as such
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 then the ICX switch end will need to be wired as such
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

Driver Configuration

Connection Settings
Name - name of the driver if you wish to change
Connection Type - Telnet TCP or Serial RS232
IP address or Port & Baud Rate (9600 is usually standard and doesnt need to be changed)
Username and Password - how you would login to the switch if connected directly via a PC to the Telnet or Console port.

Stack Configuration

Stack Unit Count - How many switches are in the stack - 1 is default but can support up to 12 switches in a stack (ICX Limitation)

Switch Port Count - the number of RJ45 ports labeled 1 through to total port numbers

C Port Count - labeled on the ICX switch as Cx - non POE ports on the switch - usually 2 or 4

SFP Port count - labled on the ICX switch as X - Fibre ports - either 2, 4 or 8

Support Commands

Enable and disable port

PortLinkOn – Enables Ethernet port

PortLinkOff – Disables Ethernet port

PoE Control (Only on supported ports)

PortPoEOn – Enables PoE

PortPoEOff – Disables PoE

> ⚠️ No safe reboot command is available for PoE. Disabling PoE on the control processor's own port will result in loss of control.

Diagnostics

All ports configured through settings will appear in XP Diagnostics with clear port names. Feedback updates reflect real-time switch state.

PoE status variables are grouped under each of the switch in the stack

Notes

Ensure the ICX switch stack is reachable over Telnet from the XP processor.

The processor must not be powered via PoE from the same switch if using PoE disable commands.

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 to RTI@Habitech.co.uk