自由协议 - Snet Docs
文档/协议/freedom

Freedom 协议驱动

包: Snet.Freedom | 类: FreedomOperate | 类型数量: 3

提供一个灵活的用户可自定义协议驱动，支持自定义串口（RS-232/485）和 TCP 通信，并支持脚本化帧解析。适用于非标准或专有设备协议。

安装

dotnet add package Snet.Freedom

快速入门

using Snet.Freedom;

var op = new FreedomOperate(new FreedomData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 6688
});

var address = new Address(new List<AddressDetails>
{
    new("读数", "010300000001", DataType.ByteArray),
    new("读数2", "010300000002", DataType.ByteArray)
});
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("读数", "010300000001", DataType.ByteArray)
});
await op.SubscribeAsync(subAddr);

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

await op.DisposeAsync();

配置参数

参数 类型 默认值 说明
IpAddress string — 设备 IP 或 COM 端口
Port int 6688 TCP 端口或波特率
ConnectTimeOut int 1000 连接超时（毫秒）
ReceiveTimeOut int 1000 接收超时（毫秒）

支持类型

类型 说明
FreedomTcpNet TCP 网络通信
FreedomUdpNet UDP 网络通信
FreedomSerial RS-232/485 串口通信

帧格式、编码和解析规则可通过脚本或配置完全自定义，从而支持与几乎任何串口或 TCP 设备协议进行集成。

支持操作

操作 方法
连接 OnAsync()
断开 OffAsync()
读取 ReadAsync(address)
写入 WriteAsync(values)
订阅 SubscribeAsync(address)

参见