RockPlus iBox

C# SDK（RockPlus.iBoxSDK）

SDK 封装了连接、心跳保活、断线重连、I/O 读写、串口透传与事件回调，核心类为 IBOXControlHelper，适合 .NET 语言的 MES、SCADA 与上位机软件快速集成。

// C# 示例
using RockPlus.iBoxSDK;
using RockPlus.iBoxSDK.Objects;

var ibox = new IBOXControlHelper();

ibox.OnIBOXDataReceived += (s, e) =>
{
    switch (e.EDataReceivedType)
    {
        case EDataReceivedType.DIAutoUploadResponse:   // 输入变化自动回传
            Console.WriteLine($"DI{e.AutoUploadDIIndex} = {e.AutoUploadDIStatus}");
            break;
        case EDataReceivedType.COMPortReadData:        // 串口数据自动回传
            Console.WriteLine($"COM{e.ComPort}: {e.Message}");
            break;
    }
};

if (ibox.ConnectIBox("192.168.1.100", 5000))
{
    ibox.InitHebeatEvent();      // 心跳保活 + 断线重连
    ibox.OpenDO(0);              // 打开第 1 路输出（编号从 0 开始）
    ibox.CloseDO(0);             // 关闭
    ibox.ReadDIStatus();         // 主动读取全部输入（可选）
}

TCP 通信指令（十六进制）

iBox 作为 TCP 服务端监听，默认端口 5000。任何语言只需建立 TCP 连接，按帧格式发送十六进制字节即可，不依赖特定开发语言或平台。

帧头 AA 55，帧尾 55 AA；消息 ID 为 1 字节自增序号，设备在应答中原样返回，用于区分请求。

// 示例：打开第 1 路输出（编号 0），消息 ID = 01
AA 55 07 01 00 01 55 AA

// 示例：向串口 1 发送十六进制数据 01 03（长度 2）
AA 55 09 02 01 02 00 01 03 55 AA

// 收到自动回传：输入点位 2 变为通
AA 55 A0 02 01 55 AA

建议每 60 秒内至少与设备通信一次（例如发送心跳），SDK 默认以 60 秒为心跳周期，超过 60 秒无任何数据会判定断线并重连。