Toyota 协议驱动

包: Snet.Toyota | 类: ToyotaOperate | 类型数量: 1

通过 Toyopuc 专用以太网协议提供与丰田工业 PLC（Toyopuc 系列）的连接。

安装

dotnet add package Snet.Toyota

快速入门

using Snet.Toyota;

var op = await ToyotaOperate.InstanceAsync(new ToyotaData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 1025
});

var address = new Address(new List<AddressDetails>
{
    new("读数", "D100", DataType.Int16),
    new("读数2", "D102", 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("读数", "D100", 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	ToyoPuc	协议类型（单值）

支持类型

适用于 Toyopuc-PC2/PC3/PC10 系列的 Toyopuc 协议，支持 X/Y/M/D/T/C/L 寄存器。

地址格式

区域	地址格式	示例
K(32)/V(80)/T(96)/C(96)/L(128)/X(256)/Y(256)/M(384)/S(512)/N(1536)/R(2048)/D(4096)/B(24576)/H(6144)	{字母}{十六进制字} — 末位 hex 字符为字内位,或 {字母}{字}.{位}	K100, D100, K1005, K100.5
E 系列 (EK/EV/ET/EC/EL/EX/EY/EM/ES/EN/EB)	同上;PRG = 0，但 EB 按数值映射 PRG 9/10/11	EK10, EM100, EB20000
U / GX / GY / GM	U = PRG8, GX/GY/GM = PRG7	U100, GX10
显式程序号	prg=N;{字母}{十六进制字}	prg=1;K100

支持的数据类型

所有读取按 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	❌	ReadAsync 中有 case 但无底层读取 — "不支持该类型读取"

地址自动组包与解包

每个数采驱动都实现 IPacker。ToyoPuc 已注册在自动组包注册表中（ToyoPacker，SupportsAutoPack = true），因此 PackerAsync 可将分散地址合并为最小批量读取。引擎细节：地址自动组包。

Bool 地址自 26.235.x 起全部降级——消费层字读路径把位地址当纯十六进制字号解析（'K1005' → 字 0x1005，点号 'K100.5' 抛 FormatException），位批必然错位/失败；单点 ReadBool 才正确。

订阅

先绑定数据事件，再通过 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)

参见

• DaqAbstract 基类
• IDaq 接口