CSoft.Protocol.Adam4017 10.0.18

Adam4017

Adam4017 数据采集模块的 C# 通讯协议实现，支持串口和 TCP 两种通讯模式。

安装

dotnet add package CSoft.Protocol.Adam4017

特性

• ✅ 串口通讯（RS-485）
• ✅ TCP 客户端模式
• ✅ TCP 服务端模式（支持多客户端）
• ✅ Fluent API 配置
• ✅ 异步操作
• ✅ 连接事件监听

快速开始

串口模式

using Adam4017;

// 创建串口设备
var device = Adam4017Device
    .UseSerial("COM3", baudRate: 9600)
    .Timeout(5000)
    .OnConnect(() => Console.WriteLine("已连接"))
    .OnDisconnect(() => Console.WriteLine("已断开"))
    .Build();

// 打开连接
await device.OpenAsync();

// 读取信号量（8路模拟量）
var values = await device.ReadSignalValueAsync(address: "01");
if (values != null)
{
    Console.WriteLine($"信号量: {string.Join(", ", values)}");
}

// 关闭连接
await device.CloseAsync();

TCP 客户端模式

// 连接 Adam4017 设备
var client = Adam4017Device
    .UseTcpClient(host: "192.168.1.100", port: 9000)
    .Timeout(5000)
    .Build();

await client.OpenAsync();
var values = await client.ReadSignalValueAsync("01");
await client.CloseAsync();

TCP 服务端模式

服务端用于接收 Adam4017 设备主动连接，支持同时管理多个设备。

// 创建服务端
var server = Adam4017Device
    .UseTcpServer(host: "0.0.0.0", port: 9000)
    .Timeout(5000)
    .OnClientConnected(clientId => Console.WriteLine($"设备连接: {clientId}"))
    .OnClientDisconnected(clientId => Console.WriteLine($"设备断开: {clientId}"))
    .Build();

// 启动监听
await server.StartAsync();

// 获取所有连接的客户端
var clients = server.GetConnectedClients();
foreach (var clientId in clients)
{
    // 向指定客户端读取信号量
    var values = await server.ReadSignalValueAsync(clientId, address: "01");
    Console.WriteLine($"{clientId}: {string.Join(", ", values)}");
}

// 停止服务
await server.StopAsync();

API 参考

Adam4017Device 静态方法

配置选项

IAdam4017 接口

public interface IAdam4017
{
    bool IsConnect { get; }
    Task OpenAsync();
    Task CloseAsync(bool closePhysicalPort = true);
    Task<List<decimal>?> ReadSignalValueAsync(string address = "01", int tryCount = 0, CancellationToken cancelToken = default);
    
    event DisconnectEventHandler OnDisconnect;
    event ConnectEventHandler OnConnect;
}

IAdam4017Server 接口

public interface IAdam4017Server
{
    bool IsListened { get; }
    Task StartAsync();
    Task StopAsync();
    Task<List<decimal>?> ReadSignalValueAsync(string clientId, string address = "01", int tryCount = 0, CancellationToken cancelToken = default);
    IEnumerable<string> GetConnectedClients();
    
    event ClientConnectEventHandler OnClientConnect;
    event ClientDisconnectEventHandler OnClientDisconnect;
}

协议说明

Adam4017 采用 ASCII 协议，帧格式如下：

• 请求: #地址\r 例如: #01\r
• 响应: >+0.123+0.456+0.789+1.234+1.567+1.890+2.123+2.456\r

返回 8 路模拟量信号值，单位为电压值（V）。

依赖

• .NET Standard 2.0 / .NET 10.0
• CSoft.Protocol.ProtocolInterface
• CSoft.Communication.TopPortLib

许可证

MIT