using System;
using System.Collections.Generic;
namespace NewLife.XCoder.Tools.Modbus;
/// <summary>设备模板:常用的站号与寄存器区间预设,便于快速建立读写项</summary>
/// <param name="Name">模板名</param>
/// <param name="Unit">默认站号</param>
/// <param name="Address">默认起始地址</param>
/// <param name="Count">默认读取数量</param>
/// <param name="Note">适用场景说明</param>
public sealed record ModbusTemplate(String Name, Byte Unit, UInt16 Address, UInt16 Count, String Note);
/// <summary>设备模板清单</summary>
public static class ModbusTemplates
{
/// <summary>内置模板</summary>
public static IReadOnlyList<ModbusTemplate> All { get; } =
[
new("通用从站 · 保持寄存器", 1, 0, 10, "站号 1,从 40001 起读 10 个寄存器"),
new("I/O 模块 · 线圈", 1, 0, 8, "8 路继电器或输入点位"),
new("变频器 · 运行参数", 1, 0x2000, 8, "常见品牌运行频率/电流/电压区"),
new("电表 · 电量数据", 1, 0x0000, 12, "电压/电流/功率/电量连续区"),
];
/// <summary>按名称查找模板</summary>
/// <param name="name">模板名</param>
/// <returns>模板;找不到返回 null</returns>
public static ModbusTemplate? Find(String? name)
{
if (String.IsNullOrWhiteSpace(name)) return null;
foreach (var item in All)
{
if (String.Equals(item.Name, name, StringComparison.Ordinal)) return item;
}
return null;
}
}
|