RKC 协议驱动

包: Snet.RKC | 类: RKCOperate | 类型数量: 2

通过 RKC 专有 ASCII 协议经 RS-485 串口或以太网提供与 RKC 温控器及仪表的连接。

安装

dotnet add package Snet.RKC

快速入门

using Snet.RKC;

var op = await RKCOperate.InstanceAsync(new RKCData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 502
});

var address = new Address(new List<AddressDetails>
{
    new("读数", "M1", DataType.Double),
    new("读数2", "M2", DataType.Double)
});
var result = await op.ReadAsync(address);
if (result.Status)
{
    var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();
    foreach (var kv in data)
        Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
}
else
{
    Console.WriteLine($"读取失败: {result.Message}");
}

// 订阅之前 绑定数据事件
op.OnDataEventAsync += async (sender, e) =>
{
    if (e.Status)
    {
        var data = e.GetSource<ConcurrentDictionary<string, AddressValue>>();
        foreach (var kv in data)
            Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
    }
    else
    {
        Console.WriteLine($"{e.Message}");
    }
};

var subAddr = new Address(new List<AddressDetails>
{
    new("读数", "M1", DataType.Double)
});
await op.SubscribeAsync(subAddr);

// 后续：取消订阅
// await op.UnSubscribeAsync(subAddr);

await op.DisposeAsync();

配置参数

参数	类型	默认值	说明
IpAddress	string	127.0.0.1	控制器 IP 地址
Port	int	6688	通信端口
ConnectTimeOut	int	1000	连接超时（毫秒）
ReceiveTimeOut	int	1000	接收超时（毫秒）
Station	int	1	控制器站号（串口）
SerialPortInfo	string	COM3-9600-8-N-1	串口设置
RtsEnable	bool	false	RTS 握手（串口）
DtrEnable	bool	false	DTR 握手（串口）
SleepTime	int	0	帧间休眠（毫秒，串口）
ProtocolType	enum	TemperatureControllerOverTcp	协议类型

支持类型

类型	说明
TemperatureControllerOverTcp	RKC 的 CD/CH 系列数字式温度控制器网口透传类对象，可读取测量值、CT1 输入值、CT2 输入值等
TemperatureController	RKC 的 CD/CH 系列数字式温度控制器串口类对象，可读取测量值、CT1 输入值、CT2 输入值等

适用于 RKC CD/CH 系列数字式温度控制器的协议，支持测量值（PV）、CT1、CT2 等寄存器访问。

地址格式

RKC CD/CH 系列助记符寄存器 — ASCII 字符串直接入报文。

寄存器(助记符)	含义(惯例)	示例
M1 / M2 / M3	PV(测量值) / SV(设定值) / MV(操作输出)	M1, M2, M3
AA / AB / B1 / ER	CT1 输入等(RKC 手册惯例)	AA, AB, B1, ER
站号前缀	s={站号};{助记符} (站号 < 100)	s=2;M1

支持的数据类型

所有读取按 AddressDetails.DataType 分发 — 别名(Short = Int16、Float = Single、Int = Int32 等)共用同一分支。

数据类型	支持	说明
Bool	❌	无位读取 — 设备层抛出 NotSupportedFunction
Int16 / Short, UInt16 / Ushort	❌	设备层抛出 NotSupportedFunction
Int32 / Int, UInt32 / Uint	❌	设备层抛出 NotSupportedFunction
Int64 / Long, UInt64 / Ulong	❌	设备层抛出 NotSupportedFunction
Float / Single	❌	设备层抛出 NotSupportedFunction
Double	✅	驱动唯一重写的类型（ReadDouble / Write(string, double)；数值以 ASCII 数字传输）
String / Char	❌	设备层抛出 NotSupportedFunction
ByteArray + 全部 10 种 *Array	❌	设备层抛出 NotSupportedFunction
Byte	❌	ReadAsync 中有 case 但无底层读取 — 实际消息为格式化资源串（含协议名与类型名），并非字面文本 "不支持该类型读取"

地址自动组包与解包

每个数采驱动都实现 IPacker。RKCOperate 使用标签/符号寻址，未注册在自动组包注册表中，因此 Packer 原样返回地址集合（透传）——见 IPacker 接口。支持字节偏移寻址的协议（如西门子 S7、Modbus、三菱 MC）可组包：地址自动组包。

订阅

先绑定数据事件，再通过 SubscribeAsync 添加地址；数据通过 OnDataEventAsync 到达：

op.OnDataEventAsync += async (sender, e) =>
{
    if (e.Status)
    {
        var data = e.GetSource<ConcurrentDictionary<string, AddressValue>>();
        foreach (var kv in data)
            Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
    }
    else
    {
        Console.WriteLine($"订阅错误: {e.Message}");
    }
};

var subAddr = new Address(new List<AddressDetails>
{
    new("读数", "M1", DataType.Double)
});
await op.SubscribeAsync(subAddr);

// 后续：停止监视
// await op.UnSubscribeAsync(subAddr);

支持操作

操作	方法
连接	OnAsync()
断开	OffAsync()
读取	ReadAsync(address)
写入	WriteAsync(values)
订阅	SubscribeAsync(address)
组包 / 解包	PackerAsync(address, protocolTypeKey) / UnPackerAsync(data)

参见

• DaqAbstract 基类
• IDaq 接口