倍福 - Snet Docs
文档/协议/beckhoff

Beckhoff 协议驱动

包: Snet.Beckhoff | 类: BeckhoffOperate | 类型: 1

提供通过 TCP/IP 上的 ADS（自动化设备规范）协议连接 Beckhoff TwinCAT PLC 的能力。

安装

dotnet add package Snet.Beckhoff

快速开始

using Snet.Beckhoff;

var op = new BeckhoffOperate(new BeckhoffData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 851
});

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

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

await op.DisposeAsync();

配置

参数 类型 默认值 描述
IpAddress string — PLC IP 地址
Port int 851 ADS TCP 端口
ConnectTimeOut int 1000 连接超时（毫秒）
ReceiveTimeOut int 1000 接收超时（毫秒）

支持的类型

ADS 协议，支持符号变量访问、NetId 路由和 AMS 寻址，适用于 TwinCAT 2/3 运行时。

  • BeckhoffAdsNet — Beckhoff ADS Net 通信

支持的操作

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

参见