diff --git a/DeviceCommand/Devices/MCc30W.cs b/DeviceCommand/Devices/MCc30W.cs index 4d5b718..ebc8379 100644 --- a/DeviceCommand/Devices/MCc30W.cs +++ b/DeviceCommand/Devices/MCc30W.cs @@ -1,20 +1,337 @@ -using DeviceCommand.Base; +using Common.Attributes; +using DeviceCommand.Base; using Model.Models; using System; -using System.Collections.Generic; -using System.Linq; -using System.Text; +using System.Threading; using System.Threading.Tasks; namespace DeviceCommand.Devices { /// - /// 水冷机 一拖三 + /// 水冷机 Modbus TCP 驱动 (支持3回路独立控制) + /// 通讯协议: MCx ModbusTCP /// - public class MCc30W:ModbusTcp + [ACPCommand] + public class 冷水机 : ModbusTcp { - public MCc30W(TcpConfig config) : base(config) + // 默认配置 (可从 config 或 TcpConfig 注入) + private readonly byte _slaveId = 0x01; // 单元标识符 + + public 冷水机(TcpConfig config) : base(config) { } + + #region 1. 底层连接与字节序转换辅助 + + /// + /// 将单精度浮点数转换为 Modbus 大端序 2个16位寄存器 + /// + private ushort[] FloatToRegisters(float value) + { + byte[] bytes = BitConverter.GetBytes(value); + if (BitConverter.IsLittleEndian) Array.Reverse(bytes); + return new ushort[] + { + BitConverter.ToUInt16(bytes, 0), + BitConverter.ToUInt16(bytes, 2) + }; + } + + /// + /// 将 Modbus 大端序 2个16位寄存器转换回单精度浮点数 + /// + private float RegistersToFloat(ushort[] registers) + { + if (registers.Length < 2) return 0f; + byte[] bytes = new byte[4]; + Buffer.BlockCopy(BitConverter.GetBytes(registers[0]), 0, bytes, 0, 2); + Buffer.BlockCopy(BitConverter.GetBytes(registers[1]), 0, bytes, 2, 2); + if (BitConverter.IsLittleEndian) Array.Reverse(bytes); + return BitConverter.ToSingle(bytes, 0); + } + + /// + /// 将 32位无符号整数转换为 Modbus 大端序 2个16位寄存器 + /// + private ushort[] UInt32ToRegisters(uint value) + { + byte[] bytes = BitConverter.GetBytes(value); + if (BitConverter.IsLittleEndian) Array.Reverse(bytes); + return new ushort[] + { + BitConverter.ToUInt16(bytes, 0), + BitConverter.ToUInt16(bytes, 2) + }; + } + + /// + /// 将 Modbus 大端序 2个16位寄存器转换回 32位无符号整数 + /// + private uint RegistersToUInt32(ushort[] registers) + { + byte[] bytes = new byte[4]; + Buffer.BlockCopy(BitConverter.GetBytes(registers[0]), 0, bytes, 0, 2); + Buffer.BlockCopy(BitConverter.GetBytes(registers[1]), 0, bytes, 2, 2); + if (BitConverter.IsLittleEndian) Array.Reverse(bytes); + return BitConverter.ToUInt32(bytes, 0); + } + + #endregion + + #region 2. 模拟量读写 API (支持 3 通道) + + /// + /// 设置指定回路的出液目标温度 (℃) + /// + public virtual async Task 设置出液目标温度Async(int loop, float temperature, CancellationToken ct = default) + { + ushort address = (ushort)(0x0000 + (loop - 1) * 2); + ushort[] data = FloatToRegisters(temperature); + await WriteMultipleRegistersAsync(_slaveId, address, data, ct); + } + + /// + /// 设置指定回路的出液目标流量 (L/min) + /// + public virtual async Task 设置出液目标流量Async(int loop, float flow, CancellationToken ct = default) + { + ushort address = (ushort)(0x0008 + (loop - 1) * 2); + ushort[] data = FloatToRegisters(flow); + await WriteMultipleRegistersAsync(_slaveId, address, data, ct); + } + + /// + /// 设置指定回路的出液目标压力 (kPa) + /// + public virtual async Task 设置出液目标压力Async(int loop, float pressure, CancellationToken ct = default) + { + ushort address = (ushort)(0x000E + (loop - 1) * 2); + ushort[] data = FloatToRegisters(pressure); + await WriteMultipleRegistersAsync(_slaveId, address, data, ct); + } + + /// + /// 读取指定回路的当前出液温度 (℃) + /// + [Monitorable("水冷机出液当前温度")] + public virtual async Task 读取出液当前温度Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0018 + (loop - 1) * 2); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的当前出液流量 (L/min) + /// 注意:协议中三通道流量地址间隔为 0x08 + /// + [Monitorable("水冷机出液当前流量")] + public virtual async Task 读取出液当前流量Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x001E + (loop - 1) * 8); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的当前出液压力 (kPa) + /// 注意:协议中三通道压力地址间隔为 0x08 + /// + [Monitorable("水冷机出液当前压力")] + public virtual async Task 读取出液当前压力Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0020 + (loop - 1) * 8); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的当前回液压力 (kPa) (0x0022 + (loop-1)*8) + /// + [Monitorable("水冷机回液当前压力")] + public virtual async Task 读取回液当前压力Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0022 + (loop - 1) * 8); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的当前回液温度 (℃) (0x0024 + (loop-1)*8) + /// + [Monitorable("水冷机回液当前温度")] + public virtual async Task 读取回液当前温度Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0024 + (loop - 1) * 8); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的外部温度反馈 (℃) (0x0036 + (loop-1)*2) + /// + [Monitorable("水冷机外部温度反馈")] + public virtual async Task 读取外部温度反馈Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0036 + (loop - 1) * 2); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取指定回路的温变速率设定 (℃/min) (0x0006 + (loop-1)*2) + /// + [Monitorable("水冷机温变速率")] + public virtual async Task 读取温变速率Async(int loop, CancellationToken ct = default) + { + ushort address = (ushort)(0x0006 + (loop - 1) * 2); + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, address, 2, ct); + return RegistersToFloat(regs); + } + + /// + /// 读取回抽2流量目标值 (L/min) (0x0016) + /// + [Monitorable("水冷机回抽2流量目标值")] + public virtual async Task 读取回抽2流量目标值Async(CancellationToken ct = default) + { + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x0016, 2, ct); + return RegistersToFloat(regs); + } + + #endregion + + #region 3. 系统状态与位控制 API (支持 3 通道) + + /// + /// 核心位操作方法:读取 -> 置位/复位 -> 写入系统状态控制寄存器 (0x0014) + /// + private async Task SetControlBit(int bitIndex, bool isSet, CancellationToken ct = default) + { + // 1. 读取当前状态 + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x0014, 1, ct); + ushort currentState = regs[0]; + + // 2. 修改位 + if (isSet) + currentState |= (ushort)(1 << bitIndex); + else + currentState &= (ushort)~(1 << bitIndex); + + // 3. 写回 + await WriteSingleRegisterAsync(_slaveId, 0x0014, currentState, ct); + } + + /// + /// 启动/停止 指定回路 (Bit 01, 02, 03) + /// + public virtual async Task 设置回路运行Async(int loop, bool enable, CancellationToken ct = default) + { + if (loop < 1 || loop > 3) throw new ArgumentOutOfRangeException(nameof(loop), "回路号必须为1, 2, 3"); + await SetControlBit(loop, enable, ct); // 回路1->Bit1, 回路2->Bit2, 回路3->Bit3 + } + + /// + /// 启动/停止 指定回路 预控温 (Bit 10, 11, 12) + /// + public virtual async Task 设置回路预控温Async(int loop, bool enable, CancellationToken ct = default) + { + if (loop < 1 || loop > 3) throw new ArgumentOutOfRangeException(nameof(loop), "回路号必须为1, 2, 3"); + await SetControlBit(9 + loop, enable, ct); // 回路1->Bit10, 回路2->Bit11, 回路3->Bit12 + } + + /// + /// 设置指定回路 流量/压力 控制模式 (Bit 04, 05, 06) + /// true=控压, false=控流 + /// + public virtual async Task 设置回路压力控制Async(int loop, bool isPressureControl, CancellationToken ct = default) + { + if (loop < 1 || loop > 3) throw new ArgumentOutOfRangeException(nameof(loop), "回路号必须为1, 2, 3"); + await SetControlBit(3 + loop, isPressureControl, ct); // 回路1->Bit4, 回路2->Bit5, 回路3->Bit6 + } + + /// + /// 报警复位 (Bit 08) + /// + public virtual async Task 报警复位Async(bool enable, CancellationToken ct = default) + { + await SetControlBit(8, enable, ct); + } + + /// + /// 报警消音 (Bit 09) + /// + public virtual async Task 报警消音Async(bool enable, CancellationToken ct = default) + { + await SetControlBit(9, enable, ct); + } + + /// + /// 设置指定回路 自动回液开关 (寄存器 0x0015, 低位部分) + /// 此方法操作的是 0x0015 寄存器的低 16 位 + /// + public virtual async Task 设置回路自动回液Async(int loop, bool enable, CancellationToken ct = default) + { + if (loop < 1 || loop > 3) throw new ArgumentOutOfRangeException(nameof(loop), "回路号必须为1, 2, 3"); + // 协议 Sheet2 中 0x0015 寄存器位定义: + // Bit 13 (Loop1), Bit 14 (Loop2), Bit 15 (Loop3) + int bitIndex = 12 + loop; + // 0x0015 控制寄存器逻辑 + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x0015, 1, ct); + ushort currentState = regs[0]; + + if (enable) + currentState |= (ushort)(1 << bitIndex); + else + currentState &= (ushort)~(1 << bitIndex); + + await WriteSingleRegisterAsync(_slaveId, 0x0015, currentState, ct); + } + + #endregion + + #region 4. 状态回读 (报警、心跳、运行状态) + + /// + /// 读取心跳帧 (0x0044),用于判断通讯是否正常 + /// + [Monitorable("水冷机心跳帧")] + public virtual async Task 读心跳帧Async(CancellationToken ct = default) + { + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x0044, 2, ct); + return RegistersToUInt32(regs); + } + + /// + /// 读取运行状态反馈 (0x0046),含各回路完成状态 (Sheet5) + /// + [Monitorable("水冷机运行状态反馈")] + public virtual async Task 读运行状态反馈Async(CancellationToken ct = default) + { + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x0046, 2, ct); + return RegistersToUInt32(regs); + } + + /// + /// 读取报警信息1 (0x003C) + /// + [Monitorable("水冷机报警信息1")] + public virtual async Task 读报警信息1Async(CancellationToken ct = default) + { + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x003C, 2, ct); + return RegistersToUInt32(regs); + } + + /// + /// 读取报警信息2 (0x003E) + /// + [Monitorable("水冷机报警信息2")] + public virtual async Task 读报警信息2Async(CancellationToken ct = default) + { + ushort[] regs = await ReadHoldingRegistersAsync(_slaveId, 0x003E, 2, ct); + return RegistersToUInt32(regs); + } + + #endregion } -} +} \ No newline at end of file