RockPlus iBox

C# SDK (RockPlus.iBoxSDK)

The SDK wraps connection, heartbeat keep-alive, automatic reconnection, I/O read/write, serial port pass-through and event callbacks. The core class is IBOXControlHelper, suited to quick integration into MES, SCADA and host software written in .NET languages.

// C# example
using RockPlus.iBoxSDK;
using RockPlus.iBoxSDK.Objects;

var ibox = new IBOXControlHelper();

ibox.OnIBOXDataReceived += (s, e) =>
{
    switch (e.EDataReceivedType)
    {
        case EDataReceivedType.DIAutoUploadResponse:   // input change auto-upload
            Console.WriteLine($"DI{e.AutoUploadDIIndex} = {e.AutoUploadDIStatus}");
            break;
        case EDataReceivedType.COMPortReadData:        // serial data auto-upload
            Console.WriteLine($"COM{e.ComPort}: {e.Message}");
            break;
    }
};

if (ibox.ConnectIBox("192.168.1.100", 5000))
{
    ibox.InitHebeatEvent();      // heartbeat keep-alive + auto reconnect
    ibox.OpenDO(0);              // turn on output 1 (numbering starts at 0)
    ibox.CloseDO(0);             // turn off
    ibox.ReadDIStatus();         // actively read all inputs (optional)
}

TCP/IP Socket Hex Commands

iBox listens as a TCP server, default port 5000. In any language, just open a TCP connection and send hexadecimal bytes in the frame format; no specific development language or platform is required.

Frame header AA 55, frame tail 55 AA. The message ID is a 1-byte incrementing sequence number that the device returns unchanged in its response, used to match requests.

// Example: turn on output 1 (index 0), message ID = 01
AA 55 07 01 00 01 55 AA

// Example: send hex data 01 03 (length 2) to serial port 1
AA 55 09 02 01 02 00 01 03 55 AA

// Auto-upload received: input point 2 turned on
AA 55 A0 02 01 55 AA

Communicate with the device at least once every 60 seconds (for example, by sending a heartbeat). The SDK uses a 60-second heartbeat period by default; if no data is received for more than 60 seconds, it treats the link as disconnected and reconnects.