借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
3.76 KiB
XCoder
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;
    }
}