using Common.Attributes;
using DeviceCommand.Base;
using Model.Models;
using System;
using System.Collections.Generic;
using System.Globalization;
using System.Threading;
using System.Threading.Tasks;
namespace DeviceCommand.Devices
{
[ACPCommand]
public class IT6720 : Serial_Port // 直接继承您提供的 Serial_Port 基类
{
// 帧格式:同步头 AA + 地址 + 命令字 + 数据[4-25] + 校验和,共 26 字节
private const byte FrameSyncByte = 0xAA;
private const int FrameLength = 26;
private readonly byte _deviceAddress; // 电源地址
public IT6720(SerialPortConfig config, byte address = 0x00) : base(config)
{
_deviceAddress = address;
}
#region 核心协议封装(不变)
///
/// 构建 26 字节的发送帧,并计算校验和
///
private byte[] BuildFrame(byte command, byte[] dataBytes)
{
List frame = new List { FrameSyncByte, _deviceAddress, command };
if (dataBytes != null && dataBytes.Length > 0)
{
frame.AddRange(dataBytes);
}
// 数据区必须占满 23 字节 (索引 3 到 24)
while (frame.Count < 25)
{
frame.Add(0x00);
}
// 计算校验和:前 25 字节之和取低 8 位
byte checkSum = 0;
for (int i = 0; i < 25; i++)
{
checkSum += frame[i];
}
frame.Add(checkSum);
return frame.ToArray();
}
///
/// 检查返回的 26 字节响应帧是否正确
///
private bool ValidateResponseFrame(byte[] response)
{
if (response == null || response.Length != FrameLength) return false;
if (response[0] != FrameSyncByte) return false;
if (response[1] != _deviceAddress) return false;
byte checkSum = 0;
for (int i = 0; i < 25; i++)
{
checkSum += response[i];
}
return response[25] == checkSum;
}
///
/// 将实际电压/电流值转换成协议要求的整型 (乘以 1000 变成整形)
///
private int ConvertToProtocolValue(double value)
{
return (int)Math.Round(value * 1000);
}
///
/// 将协议返回的 4 字节小端序转换为实际数值 (除以 1000.0)
///
private double Convert4BytesToValue(byte b0, byte b1, byte b2, byte b3)
{
uint raw = (uint)(b0 | (b1 << 8) | (b2 << 16) | (b3 << 24));
return raw / 1000.0;
}
///
/// 将协议返回的 2 字节小端序转换为实际数值 (除以 1000.0)
///
private double Convert2BytesToValue(byte b0, byte b1)
{
ushort raw = (ushort)(b0 | (b1 << 8));
return raw / 1000.0;
}
#endregion
#region 1. 核心二进制收发方法(使用基类新方法)
///
/// 发送命令帧并读取仪器返回的 26 字节数据帧
///
private async Task SendAndReadFrameAsync(byte command, byte[] dataBytes, CancellationToken ct = default)
{
byte[] sendFrame = BuildFrame(command, dataBytes);
// 使用基类提供的 WriteBytesAsync 发送二进制数据
await WriteBytesAsync(sendFrame, ct).ConfigureAwait(false);
// 使用基类提供的 ReadBytesAsync 读取定长 26 字节二进制数据
// 注意:这里的 ReadTimeout 由基类统一控制
return await ReadBytesAsync(FrameLength, ct).ConfigureAwait(false);
}
#endregion
#region 2. 操作模式与输出控制
///
/// 切换电源控制模式:PC 远程控制 / 面板控制
///
public virtual async Task 切换远程控制模式(bool 远程控制 = true, CancellationToken ct = default)
{
byte[] data = new byte[] { (byte)(远程控制 ? 0x01 : 0x00) };
byte[] response = await SendAndReadFrameAsync(0x20, data, ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 切换控制模式时通讯校验失败。");
}
public virtual async Task 切换本地控制模式(CancellationToken ct = default)
{
await 切换远程控制模式(false, ct);
}
///
/// 开启或关闭电源输出
///
public virtual async Task 设置输出开关(bool 开启 = true, CancellationToken ct = default)
{
byte[] data = new byte[] { (byte)(开启 ? 0x01 : 0x00) };
byte[] response = await SendAndReadFrameAsync(0x21, data, ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 设置输出时通讯校验失败。");
}
public virtual async Task 查询输出开关状态(CancellationToken ct = default)
{
var (_, _, status) = await 查询实时测量值(ct);
return (status & 0x01) != 0 ? "ON" : "OFF";
}
#endregion
#region 3. 电压 / 电流设定
///
/// 设置电源的电压上限
///
public virtual async Task 设置电压上限(double 电压, CancellationToken ct = default)
{
int raw = ConvertToProtocolValue(电压);
byte[] data = new byte[]
{
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF),
(byte)((raw >> 16) & 0xFF), (byte)((raw >> 24) & 0xFF)
};
byte[] response = await SendAndReadFrameAsync(0x22, data, ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 设置电压上限时通讯校验失败。");
}
///
/// 设置电源的输出电压
///
public virtual async Task 设置输出电压(double 电压, CancellationToken ct = default)
{
int raw = ConvertToProtocolValue(电压);
byte[] data = new byte[]
{
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF),
(byte)((raw >> 16) & 0xFF), (byte)((raw >> 24) & 0xFF)
};
byte[] response = await SendAndReadFrameAsync(0x23, data, ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 设置输出电压时通讯校验失败。");
}
///
/// 设置电源的输出电流限流值
///
public virtual async Task 设置输出电流(double 电流, CancellationToken ct = default)
{
int raw = ConvertToProtocolValue(电流);
byte[] data = new byte[]
{
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF)
};
byte[] response = await SendAndReadFrameAsync(0x24, data, ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 设置输出电流时通讯校验失败。");
}
#endregion
#region 4. 读取实时数据与状态(对应 0x26H)
///
/// 读取电源的实时电流、电压、设定值及电源状态
/// 返回元组:实际电流(A), 实际电压(V), 状态字节(int)
///
[Monitorable("IT6720 实时测量数据")]
public virtual async Task<(double ActualCurrent, double ActualVoltage, int StatusByte)> 查询实时测量值(CancellationToken ct = default)
{
byte[] response = await SendAndReadFrameAsync(0x26, new byte[0], ct);
if (!ValidateResponseFrame(response))
throw new Exception("IT6720 读取数据时通讯校验失败。");
double actualCurrent = Convert2BytesToValue(response[4], response[5]);
double actualVoltage = Convert4BytesToValue(response[6], response[7], response[8], response[9]);
int statusByte = response[10];
return (actualCurrent, actualVoltage, statusByte);
}
[Monitorable("IT6720 实际电压")]
public virtual async Task 查询实际电压(CancellationToken ct = default)
{
var (_, voltage, _) = await 查询实时测量值(ct);
return voltage.ToString("F2", CultureInfo.InvariantCulture);
}
[Monitorable("IT6720 实际电流")]
public virtual async Task 查询实际电流(CancellationToken ct = default)
{
var (current, _, _) = await 查询实时测量值(ct);
return current.ToString("F3", CultureInfo.InvariantCulture);
}
///
/// 读取状态字,判断是否处于恒压 (CV) 模式或恒流 (CC) 模式
/// 状态字节位详解:位 2,3 = 1(CV), 2(CC)
///
public virtual async Task 查询输出模式(CancellationToken ct = default)
{
var (_, _, status) = await 查询实时测量值(ct);
int mode = (status >> 2) & 0x03;
return mode switch
{
1 => "CV",
2 => "CC",
_ => "UNKNOWN"
};
}
#endregion
#region 5. 读取设备信息(命令字 31H)
///
/// 读取电源的序列号、型号及软件版本
///
public virtual async Task 查询设备信息(CancellationToken ct = default)
{
byte[] response = await SendAndReadFrameAsync(0x31, new byte[0], ct);
if (!ValidateResponseFrame(response)) return "Invalid Response";
string model = System.Text.Encoding.ASCII.GetString(response, 4, 5).Trim('\0');
string swVersion = $"{response[9]:X2}.{response[10]:X2}";
string serialNum = System.Text.Encoding.ASCII.GetString(response, 11, 10).Trim('\0');
return $"Model:{model}, SW:{swVersion}, SN:{serialNum}";
}
#endregion
#region 6. 扩展系统命令(兼容接口)
///
/// 基类自带的超时和清空缓冲区已经处理了大部分错误。
/// 如需在面板显示具体错误,需通过状态位自行判断或查看面板 ERROR 灯。
///
public virtual async Task 查询错误信息(CancellationToken ct = default)
{
return "IT6720 无标准 SCPI 错误信息查询,请检查前面板 ERROR 指示灯。";
}
#endregion
}
}