ACP/DeviceCommand/Devices/RLT1000.cs

using Common.Attributes;
using DeviceCommand.Base;
using Model.Models;
using System;
using System.Threading;
using System.Threading.Tasks;

namespace DeviceCommand.Devices
{
    /// <summary>
    /// 环境箱（型号：RLT1000） 一拖三，支持温度/湿度/水温/水流量的监测与定值控制 (Modbus TCP 协议)
    /// </summary>
    [ACPCommand]
    public class RLT1000 : ModbusTcp
    {
        /// <summary>
        /// 构造函数：传入 <see cref="TcpConfig"/> 初始化环境箱 Modbus TCP 通信参数
        /// </summary>
        public RLT1000(TcpConfig config) : base(config)
        {
        }

        // Modbus 从站号
        private const byte SlaveId = 1;

        #region 读取

        /// <summary>
        /// 读取环境箱运行状态监控字 (保持寄存器 5)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>状态监控字 (ushort 原始值)</returns>
        public async Task<ushort> 读取状态监控(CancellationToken ct = default)
        {
            ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 5, 1, ct);
            return re[0];
        }

        /// <summary>
        /// 读取环境箱当前温度值 (保持寄存器 10-11)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>当前温度值 (单位: ℃，保留两位小数)</returns>
        public async Task<double> 读取当前温度(CancellationToken ct = default)
        {
            try
            {
                ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 10, 2, ct);
                return Math.Round(ConvertToFloat(re), 2);
            }
            catch (Exception)
            {
                return 0;
            }
        }

        /// <summary>
        /// 读取环境箱当前湿度值 (保持寄存器 16-17)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>当前湿度值 (单位: %RH，保留两位小数)</returns>
        public async Task<double> 读取当前湿度(CancellationToken ct = default)
        {
            ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 16, 2, ct);
            return Math.Round(ConvertToFloat(re), 2);
        }

        /// <summary>
        /// 读取环境箱当前水温值 (保持寄存器 22-23)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>当前水温值 (单位: ℃，保留两位小数)</returns>
        public async Task<double> 读取当前水温(CancellationToken ct = default)
        {
            try
            {
                ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 22, 2, ct);
                return Math.Round(ConvertToFloat(re), 2);
            }
            catch (Exception)
            {
                return 0;
            }
        }

        /// <summary>
        /// 读取当前 1 号水流量值 (保持寄存器 28-29)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>1 号水流量值 (保留两位小数)</returns>
        public async Task<double> 读取当前1号水流量值(CancellationToken ct = default)
        {
            ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 28, 2, ct);
            return Math.Round(ConvertToFloat(re), 2);
        }

        /// <summary>
        /// 读取当前 2 号水流量值 (保持寄存器 34-35)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>2 号水流量值 (保留两位小数)</returns>
        public async Task<double> 读取当前2号水流量值(CancellationToken ct = default)
        {
            ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 34, 2, ct);
            return Math.Round(ConvertToFloat(re), 2);
        }

        /// <summary>
        /// 读取当前 3 号水流量值 (保持寄存器 40-41)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        /// <returns>3 号水流量值 (保留两位小数)</returns>
        public async Task<double> 读取当前3号水流量值(CancellationToken ct = default)
        {
            ushort[] re = await ReadHoldingRegistersAsync(SlaveId, 40, 2, ct);
            return Math.Round(ConvertToFloat(re), 2);
        }

        #endregion

        #region 读写（控制命令）

        /// <summary>
        /// 切换环境箱为本地控制模式 (寄存器 147 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 切换为本地模式(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 147, 0, ct);
        }

        /// <summary>
        /// 切换环境箱为远程控制模式 (寄存器 147 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 切换为远程模式(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 147, 1, ct);
        }

        /// <summary>
        /// 远程模式下关闭环境箱 (寄存器 148 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 远程模式关机(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 148, 0, ct);
        }

        /// <summary>
        /// 远程模式下开启环境箱 (寄存器 148 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 远程模式开机(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 148, 1, ct);
        }

        /// <summary>
        /// 远程模式复位结束 (寄存器 149 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 远程模式复位结束(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 149, 0, ct);
        }

        /// <summary>
        /// 远程模式复位 (寄存器 149 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 远程模式复位(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 149, 1, ct);
        }

        /// <summary>
        /// 切换为程序运行模式 (寄存器 153 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 切换为程序模式(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 153, 0, ct);
        }

        /// <summary>
        /// 切换为定值运行模式 (寄存器 153 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 切换为定值模式(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 153, 1, ct);
        }

        /// <summary>
        /// 定值模式下设置目标温度 (寄存器 154-155)
        /// </summary>
        /// <param name="温度">目标温度值 (单位: ℃)</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值温度设定(float 温度, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(温度);
            await WriteMultipleRegistersAsync(SlaveId, 154, tmp, ct);
        }

        /// <summary>
        /// 定值模式下设置目标湿度 (寄存器 158-159)
        /// </summary>
        /// <param name="湿度">目标湿度值 (单位: %RH)</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值湿度设定(float 湿度, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(湿度);
            await WriteMultipleRegistersAsync(SlaveId, 158, tmp, ct);
        }

        /// <summary>
        /// 定值模式下设置目标水温 (寄存器 162-163)
        /// </summary>
        /// <param name="水温">目标水温值 (单位: ℃)</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值水温设定(float 水温, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(水温);
            await WriteMultipleRegistersAsync(SlaveId, 162, tmp, ct);
        }

        /// <summary>
        /// 定值模式下设置 1 号水流量目标值 (寄存器 164-165)
        /// </summary>
        /// <param name="水流量">1 号水流量目标值</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值1号水流量设定(float 水流量, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(水流量);
            await WriteMultipleRegistersAsync(SlaveId, 164, tmp, ct);
        }

        /// <summary>
        /// 定值模式下设置 2 号水流量目标值 (寄存器 166-167)
        /// </summary>
        /// <param name="水流量">2 号水流量目标值</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值2号水流量设定(float 水流量, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(水流量);
            await WriteMultipleRegistersAsync(SlaveId, 166, tmp, ct);
        }

        /// <summary>
        /// 定值模式下设置 3 号水流量目标值 (寄存器 168-169)
        /// </summary>
        /// <param name="水流量">3 号水流量目标值</param>
        /// <param name="ct">取消令牌</param>
        public async Task 定值3号水流量设定(float 水流量, CancellationToken ct = default)
        {
            var tmp = ConvertFromFloat(水流量);
            await WriteMultipleRegistersAsync(SlaveId, 168, tmp, ct);
        }

        /// <summary>
        /// 设置水温模式不使用 (寄存器 1181 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 水温模式不使用(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 1181, 0, ct);
        }

        /// <summary>
        /// 设置水温模式使用 (寄存器 1181 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 水温模式使用(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 1181, 1, ct);
        }

        /// <summary>
        /// 设置环境箱温度模式不使用 (寄存器 1182 写 0)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 环境箱温度模式不使用(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 1182, 0, ct);
        }

        /// <summary>
        /// 设置环境箱温度模式使用 (寄存器 1182 写 1)
        /// </summary>
        /// <param name="ct">取消令牌</param>
        public async Task 环境箱温度模式使用(CancellationToken ct = default)
        {
            await WriteSingleRegisterAsync(SlaveId, 1182, 1, ct);
        }

        #endregion

        #region 数据转换助手方法

        /// <summary>
        /// 将两个 16 位寄存器（大端序）转换为 IEEE754 单精度浮点数
        /// </summary>
        /// <param name="values">两个 ushort 寄存器值</param>
        /// <returns>转换后的浮点数值</returns>
        private float ConvertToFloat(ushort[] values)
        {
            if (values == null || values.Length < 2) return 0f;

            byte[] bytes = new byte[4];
            bytes[3] = (byte)(values[0] >> 8);
            bytes[2] = (byte)(values[0] & 0xFF);
            bytes[1] = (byte)(values[1] >> 8);
            bytes[0] = (byte)(values[1] & 0xFF);
            return BitConverter.ToSingle(bytes, 0);
        }

        /// <summary>
        /// 将单精度浮点数转换为两个 16 位寄存器（大端序）
        /// </summary>
        /// <param name="value">待转换的浮点数值</param>
        /// <returns>两个 ushort 寄存器值</returns>
        private ushort[] ConvertFromFloat(float value)
        {
            byte[] bytes = BitConverter.GetBytes(value);
            ushort[] result = new ushort[2];
            result[0] = (ushort)((bytes[3] << 8) | bytes[2]);
            result[1] = (ushort)((bytes[1] << 8) | bytes[0]);
            return result;
        }

        #endregion
    }
}