模拟库 - Snet Docs

SIM 协议驱动

包: Snet.Sim | 类: SimOperate | 类型数量: 0

提供一个用于测试和开发的仿真/虚拟设备驱动。可生成多种虚拟地址类型的合成数据,无需物理硬件。

安装

dotnet add package Snet.Sim

快速入门

using Snet.Sim;

var op = new SimOperate(new SimData.Basics
{
    IpAddress = "localhost",
    Port = 6688
});

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

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

await op.DisposeAsync();

配置参数

参数 类型 默认值 说明
IpAddress string 未使用(虚拟)
Port int 6688 未使用(虚拟)
ConnectTimeOut int 1000 连接超时(毫秒)
ReceiveTimeOut int 1000 接收超时(毫秒)

Sim 没有协议类型枚举 — 它是一个纯粹的仿真器。下方"类型"指的是虚拟地址行为,而非协议变体。

支持的虚拟地址类型

类型 说明
Random(随机) 可配置范围和分布的伪随机值
Sine(正弦波) 可配置幅度、周期和偏移的正弦波形
Ramp(斜坡) 可配置起点、终点和步长的线性斜坡
Constant(常量) 固定常量值
Increment(递增) 自动递增计数器

适用于在连接真实硬件前测试 SCADA 画面、报警配置、趋势曲线及数据处理管道。

支持操作

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

参见