using System;
using System.Collections.Generic;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
namespace NewLife.XCoder.Tools.Io;
/// <summary>Modbus I/O ç‚¹è¯»å†™ä¸ŽçŠ¶æ€æè¿°</summary>
/// <remarks>
/// I/O 模å—(继电器æ¿ã€è¿œç¨‹ IO)通常把一路输入/è¾“å‡ºæ˜ å°„ä¸ºä¸€ä¸ªçº¿åœˆï¼š
/// 写å•个线圈å³å¸åˆ/释放继电器,读线圈å³å–当å‰è¾“出状æ€ï¼Œè¯»ç¦»æ•£è¾“å…¥å³å–现场输入状æ€ã€‚
/// </remarks>
public static class IoControlService
{
/// <summary>读 I/O 点状æ€</summary>
/// <param name="host">模å—地å€</param>
/// <param name="port">端å£ï¼Œä¸€èˆ¬ 502</param>
/// <param name="unit">ç«™å·</param>
/// <param name="address">起始地å€</param>
/// <param name="count">点数</param>
/// <param name="readInput">true 读现场输入(02),false 读输出状æ€ï¼ˆ01)</param>
/// <param name="timeout">超时毫秒</param>
/// <param name="token">å–æ¶ˆ</param>
/// <returns>按地å€é¡ºåºçš„ç‚¹çŠ¶æ€æ•°ç»„</returns>
public static async Task<Boolean[]> ReadAsync(String host, Int32 port, Byte unit, UInt16 address, UInt16 count,
Boolean readInput = false, Int32 timeout = 3000, CancellationToken token = default)
{
var response = await Modbus.ModbusMasterService.ReadCoilsAsync(host, port, unit, address, count, readInput, timeout, token);
return Decode(response, count);
}
/// <summary>写å•个 I/O 点</summary>
/// <param name="host">模å—地å€</param>
/// <param name="port">端å£</param>
/// <param name="unit">ç«™å·</param>
/// <param name="address">点地å€</param>
/// <param name="value">true å¸åˆï¼Œfalse 释放</param>
/// <param name="timeout">超时毫秒</param>
/// <param name="token">å–æ¶ˆ</param>
public static async Task SetAsync(String host, Int32 port, Byte unit, UInt16 address, Boolean value,
Int32 timeout = 3000, CancellationToken token = default)
{
var response = await Modbus.ModbusMasterService.WriteCoilAsync(host, port, unit, address, value, timeout, token);
if (response.IsError) throw new InvalidOperationException($"写入失败,异常ç 0x{response.ErrorCode:X2}");
}
/// <summary>把å“åº”æŠ¥æ–‡è¿˜åŽŸä¸ºç‚¹çŠ¶æ€æ•°ç»„</summary>
/// <param name="response">Modbus å“应</param>
/// <param name="count">请求点数</param>
/// <returns>ç‚¹çŠ¶æ€æ•°ç»„,长度ç‰äºŽè¯·æ±‚点数</returns>
public static Boolean[] Decode(Modbus.MbResponse response, Int32 count)
{
if (response == null) throw new ArgumentNullException(nameof(response));
if (response.IsError) throw new InvalidOperationException($"读å–失败,异常ç 0x{response.ErrorCode:X2}");
if (count <= 0) return [];
var bits = new Boolean[count];
for (var i = 0; i < count && i < response.Values.Count; i++)
{
bits[i] = response.Values[i] != 0;
}
return bits;
}
/// <summary>æ ¼å¼åŒ–ä¸ºç´§å‡‘çŠ¶æ€æ–‡æœ¬ï¼Œå¦‚ "1 0 1 0"</summary>
/// <param name="bits">点状æ€</param>
public static String Format(IReadOnlyList<Boolean>? bits)
{
if (bits == null || bits.Count == 0) return "";
var sb = new StringBuilder(bits.Count * 2);
for (var i = 0; i < bits.Count; i++)
{
if (i > 0) sb.Append(' ');
sb.Append(bits[i] ? '1' : '0');
}
return sb.ToString();
}
/// <summary>统计å¸åˆç‚¹æ•°</summary>
/// <param name="bits">点状æ€</param>
public static Int32 CountOn(IReadOnlyList<Boolean>? bits)
{
if (bits == null) return 0;
var count = 0;
for (var i = 0; i < bits.Count; i++)
{
if (bits[i]) count++;
}
return count;
}
}
|