SIM 协议驱动

包: Snet.Sim | 类: SimOperate | 类型数量: N/A（无协议类型枚举）

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

安装

dotnet add package Snet.Sim

快速入门

using Snet.Sim;

// SimData.Basics 没有 IP/端口配置 —— SN 是它唯一的属性
var op = await SimOperate.InstanceAsync(new SimData.Basics
{
    SN = "Sim01"
});

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();

配置参数

参数	类型	默认值	说明
SN	string	Guid.NewGuid().ToUpperNString()	唯一标识符
（继承自 SubscribeData.SCData）			HandleInterval、ChangeOut、AllOut、TaskNumber

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

支持的虚拟地址类型

类型	说明
VirtualStatic	固定值（按目标数据类型生成一次）
VirtualDynamic_Random	随机值（不限定范围）
VirtualDynamic_RandomScope	限定范围的随机值：名称{间隔,最小值^最大值}
VirtualDynamic_Order	顺序增长：名称{间隔,增长比例}
VirtualDynamic_OrderScope	带范围循环的顺序增长：名称{间隔,增长比例,最小值^最大值}

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

地址格式

仿真点位 — 地址即虚拟点名,可带动态参数后缀。

区域	地址格式	示例
虚拟静态	{名称}	VirtualPoint1
随机(无界)	{名称} (随机值,范围无界)	RandomPoint
随机(有界)	{名称}{间隔,最小值^最大值}	Temp{1000,20^80}
顺序	{名称}{间隔,步长}	Counter{1000,1}
顺序(有界)	{名称}{间隔,步长,最小值^最大值}	Seq{1000,1,0^100}

支持的数据类型

仿真器按虚拟地址模式类型化生成值 — 无 ReadAsync 的 DataType switch。

数据类型	支持	说明
Bool	⚠️ 部分	VirtualStatic、VirtualDynamic_Random 与 VirtualDynamic_OrderScope 生成类型化 Bool;VirtualDynamic_RandomScope 与 VirtualDynamic_Order 无 Bool 分支，恒得 int 0
Int16 … Int64, UInt16 … UInt64, Float, Double	✅	类型化生成（静态 / 随机 / 顺序）
String / Char	✅	静态与随机模式
Date / DateTime / Time	✅	类型化生成（唯一支持这些类型的驱动）
Byte、全部 *Array 类型	❌	不生成 — 静态模式保持 null，动态模式得 int 0

地址自动组包与解包

每个数采驱动都实现 IPacker。SimOperate 使用标签/符号寻址，未注册在自动组包注册表中，因此 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("读数", "VirtualPoint1", DataType.Float)
});
await op.SubscribeAsync(subAddr);

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

支持操作

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

参见

• DaqAbstract 基类
• IDaq 接口