汇川 - Snet Docs
文档/协议/inovance

Inovance 协议驱动

包: Snet.Inovance | 类: InovanceOperate | 类型: 6

提供通过 Modbus TCP 和汇川专有协议连接汇川 PLC 和伺服驱动器（H3U/H5U/AM600/Easy 系列）的能力。

安装

dotnet add package Snet.Inovance

快速开始

using Snet.Inovance;

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

var address = new Address(new List<AddressDetails>
{
    new("读数", "MW50", DataType.Int16),
    new("读数2", "MD100", 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("读数", "MW50", DataType.Int16)
});
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 接收超时（毫秒）
ProtocolType enum InovanceTcpNet 协议类型 — 默认 AM 系列不支持 D{编号} 地址（仅 H3U/H5U）；AM 请使用 MW/MD

支持的协议类型

类型 描述
InovanceTcpNet 基于 MODBUS-TCP 的协议，通过以太网（H3U/H5U/AM600 系列）
InovanceSerial 基于 MODBUS-RTU 的协议，通过串行 RS-232/485
InovanceSerialOverTcp 通过 TCP 桥接的汇川串行协议
InovanceComputerLink Computer Link 协议
InovanceConnectedCipNet CIP（EtherNet/IP），适用于 AM600 系列
InovanceEasyNet Easy 系列以太网协议

地址格式

寻址取决于 Basics.InovanceSeries(默认 AM)。

系列 区域 地址格式 示例
AM 位 Q/I/M, SM/SMX Q{编号} / I{编号} / M{编号} / SM{编号} / SMX{编号} — 点号取位 Q0.5, I0.0, M100, SM0
AM 字 SDW/SD, MW/MD/MB SDW{编号} / SD{编号} / MW{编号} / MD{编号} / MB{编号} SDW0, SD0, MW50, MD100
H3U 位 M/SM/S/T/C/X/Y (X/Y 八进制) M{编号} / X{编号} / Y{编号} M100, X17, Y0
H3U 字 D/SD/R/T/C D{编号} / SD{编号} / R{编号} D100, SD0, R0
H5U 位 M/B/S/X/Y M{编号} / B{编号} / X{编号} M0, B1, X0
H5U 字 D/R D{编号} / R{编号} D100, R0
EasyNet W/D/R 字; X/Y (八进制)/M/S/B 位; UB/UW/U (十六进制) W{编号} / D{编号} / R{编号} / X{编号} / M{编号} / UB{编号} D100, X0, M0, UB100
注意

支持 AddressStartWithZero 与 s={站号}; 前缀;H5U 内部 W 元件不支持通信访问。

支持的数据类型

所有读取按 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 ⚠️ 部分 除 InovanceComputerLink / InovanceEasyNet 外支持
注意

None、Date、DateTime、Time 在 ReadAsync 中没有分支 — 不支持。

地址自动组包与解包

每个数采驱动都实现 IPacker。Inovance 地址映射到 Modbus 族（已注册在自动组包注册表中），因此数字地址可合并为最小批量读取，而符号样式地址（s={站号}; 前缀）保持原样。引擎细节：地址自动组包。

订阅

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

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

支持的操作

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

参见