LSis 协议驱动

包: Snet.LSis | 类: LSisOperate | 类型数量: 4

通过 XGT 专用协议提供与 LS 电气（LSIS）PLC（XGT/XGB/Master-K 系列）的连接。

安装

dotnet add package Snet.LSis

快速入门

using Snet.LSis;

var op = await LSisOperate.InstanceAsync(new LSisData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 2004,
    ProtocolType = ProtocolType.LSFastEnet
});

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

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

await op.DisposeAsync();

配置参数

参数	类型	默认值	说明
IpAddress	string	127.0.0.1	PLC IP 地址
Port	int	6688	通信端口
ConnectTimeOut	int	1000	连接超时（毫秒）
ReceiveTimeOut	int	1000	接收超时（毫秒）
ProtocolType	enum	LSCnet	协议类型 — 默认 LSCnet 是串口（Cnet）；上方快速开始（以太网，端口 2004）必须设置 ProtocolType = ProtocolType.LSFastEnet
SlotNo	int	3	CPU 槽号（FastEnet）
CpuType	enum	XGK	CPU 类型（FastEnet）
CompanyID	enum	LSIS_XGT	公司 ID（FastEnet）

支持类型

适用于 XGT、XGB 和 Master-K 系列的 LS 电气 XGT/Cnet 协议，支持 %MW/%MX/%QW/%QX/%IW/%IX 寄存器。

• LSFastEnet — LS Fast Enet 通信
• LSCnet — LS Cnet 通信
• LSCpu — LS CPU 通信
• LSCnetOverTcp — LS Cnet over TCP

地址格式

区域	地址格式	示例
核心类型 (D/M/P/K/L/T/C/F/S/Q/I/N/U/Z/R)	{类型}{编号}[.{位}]	D100, M100.0
位宽 B	{类型}B{编号}	MB100, DB10
字宽 W/X	{类型}W{编号}（X 缩放按协议，见注意）	MW100, DW10
双字宽 D	{类型}D{编号}	MD100, DD50
长字宽 L	{类型}L{编号}	ML100, DL50
U 区(字)	U{十六进制}.{字}[.{位}]	U0.100, U10.50.0
I / Q (位)	I{a}.{b}.{c} / Q{a}.{b}.{c}	I1.2.3, Q0.1.0

支持的数据类型

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

数据类型	支持	说明
Bool	✅	位读取 — 线圈 / 字内位
Int16 / Short, UInt16 / Ushort	✅	16 位整数
Int32 / Int, UInt32 / Uint	✅	32 位整数
Int64 / Long, UInt64 / Ulong	✅	64 位整数
Float / Single, Double	✅	32 / 64 位浮点
String / Char	✅	带 length + 编码读取
ByteArray + 全部 10 种 *Array	✅	带 length 的数组读取
Byte	⚠️ 部分	仅 LSFastEnet / LSCnetOverTcp 支持

地址自动组包与解包

每个数采驱动都实现 IPacker，因此 LSisOperate 可直接将分散地址合并为最小批量读取，并直接解包结果——无需装配处理器（见 IPacker 接口）。26.235.x 起 LSisPacker 运行在三种协议族模式——LSis_Cnet / LSis_Cpu / LSis_FastEnet——各自匹配驱动语义（LSCnetHelper / LSCpuHelper / LSFastEnet.AnalysisAddress）：

模式	地址形式	可组包	上限
LSis_Cnet	{类型}{B/W/D/L}{十进制}[.{位}]、U{a}.{b}.{c} / I{a}.{b}.{c} 复合	Bool + Word	MaxReadLength 500、PhysicalMaxBytes 131070（驱动自动分帧，254 字/帧）
LSis_Cpu	{类型}{十六进制}（GLOFA 串口，如 M100 = 元素 0x100 = 256）	仅 Bool（位流批，10 位/字）	MaxReadLength 120、PhysicalMaxBytes 120（单命令无分帧）
LSis_FastEnet	{类型}{B/W/D/L}{十进制}（XGB 以太网）	仅 Word 且必须显式位宽（B=1/W=2/D=4/L=8 字节）	MaxReadLength 500、PhysicalMaxBytes 500（单命令无分帧）

降级（原样透传——单点读取仍可用）：

• Cpu：Word 读取（驱动位宽字母形式在 HexToOct 抛异常；无位宽默认为位语义）——Word 不可组包。
• FastEnet：X= 位设备（位读单地址，无连续位读）、无位宽字母地址（hex 直传与 ×2 模型冲突）、U/I/Q（10 位/字特殊编址）、点号位地址——全部降级。
• Cnet：U/I/Q 点号地址保留原样（驱动原生解析——U3.2.5 → 3210、I3.2.10 → 420）；普通点号地址（MB100.3）批首剥离点号。

// 组包：将分散地址合并为最少的批量读取
var packed = await op.PackerAsync(address, "LSCnet");   // 或 "LSCpu" / "LSFastEnet"
if (!packed.Status) return;                                  // 组包失败
var packedAddr = packed.GetSource<Address>();

// 一次往返读取组包后的批次
var result = await op.ReadAsync(packedAddr);
if (!result.Status) return;                                  // 读取失败
var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();

// 解包：将每个批次的原始字节解析回各地址的值
var unpacked = await op.UnPackerAsync(data);
if (!unpacked.Status) return;                                // 解包失败
var values = unpacked.GetSource<List<ConcurrentDictionary<string, AddressValue>>>();
foreach (var dict in values)
    foreach (var v in dict)
        Console.WriteLine($"{v.Key} = {v.Value.ResultValue}");

Cnet 单次最多组包 500 字节（自动分帧）；Cpu 120（10 位/字位流）；FastEnet 500。引擎细节：地址自动组包。

订阅

先绑定数据事件，再通过 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("读数", "MW100", DataType.Int16)
});
await op.SubscribeAsync(subAddr);

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

支持操作

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

参见

• DaqAbstract 基类
• IDaq 接口