petwash/系统参数Modbus读写实现说明.md

系统参数 Modbus 读写功能实现说明

实现时间

2026-02-27

功能概述

实现了完整的系统参数 Modbus 读写功能，包括：

1. 系统初始化时从设备读取默认配置
2. 界面实时显示设备参数
3. 用户修改参数后保存到设备
4. 定时读取液位传感器数据

Modbus 地址映射

时间参数寄存器（保持寄存器）

地址	参数名称	说明	单位	范围
D404	首次喷水时间	第一次冲水时长	分钟	0-60
D406	沐浴1后喷水时间	第一次沐浴露后冲水时长	分钟	0-60
D408	沐浴2后喷水时间	第二次沐浴露后冲水时长	分钟	0-60
D410	沐浴3后喷水时间	第三次沐浴露后冲水时长	分钟	0-60
D412	清洗笼子喷水	保留参数	分钟	0-60
D414	喷沐浴露1时间	第一次喷沐浴露时长	分钟	0-60
D416	喷沐浴露2时间	第二次喷沐浴露时长	分钟	0-60
D418	喷沐浴露3时间	第三次喷沐浴露时长	分钟	0-60
D420	吹热风时间	热风吹干时长	分钟	0-60
D422	吹冷风时间	冷风吹干时长	分钟	0-60
D424	紫外线杀菌时间	紫外线消毒时长	分钟	0-60

液位传感器寄存器（保持寄存器）

地址	参数名称	说明	单位	范围
D1280	1号液位	沐浴露1液位	%	0-100
D1330	2号液位	沐浴露2液位	%	0-100
D1380	3号液位	沐浴露3液位	%	0-100

核心功能实现

1. 初始化时读取设备参数

public async Task InitializeAsync()
{
    // 连接 Modbus TCP 设备
    var modbusConnected = await _modbusService.ConnectAsync();
    IsModbusConnected = modbusConnected;
    
    if (modbusConnected)
    {
        // 从设备读取初始配置参数
        await LoadDeviceParametersAsync();
    }
    else
    {
        // 使用默认配置
        LoadDefaultParameters();
    }
}

2. 读取设备参数

private async Task LoadDeviceParametersAsync()
{
    // 读取时间参数（D404-D424，共11个寄存器）
    var timeParams = await _modbusService.ReadHoldingRegistersAsync(404, 11);
    
    FirstSprayWaterTime = timeParams[0];           // D404
    AfterShampoo1SprayTime = timeParams[1];        // D406
    AfterShampoo2SprayTime = timeParams[2];        // D408
    AfterShampoo3SprayTime = timeParams[3];        // D410
    // D412 保留
    SprayShampoo1Time = timeParams[5];             // D414
    SprayShampoo2Time = timeParams[6];             // D416
    SprayShampoo3Time = timeParams[7];             // D418
    HotAirTime = timeParams[8];                    // D420
    ColdAirTime = timeParams[9];                   // D422
    UvSterilizationTime = timeParams[10];          // D424
    
    // 读取液位参数
    await LoadLiquidLevelsAsync();
}

3. 读取液位传感器

private async Task LoadLiquidLevelsAsync()
{
    // 读取1号液位 (D1280)
    var level1 = await _modbusService.ReadHoldingRegistersAsync(1280, 1);
    Shampoo1Level = level1[0];

    // 读取2号液位 (D1330)
    var level2 = await _modbusService.ReadHoldingRegistersAsync(1330, 1);
    Shampoo2Level = level2[0];

    // 读取3号液位 (D1380)
    var level3 = await _modbusService.ReadHoldingRegistersAsync(1380, 1);
    Shampoo3Level = level3[0];
}

4. 保存参数到设备

[RelayCommand]
private async Task SaveSettingsAsync()
{
    // 更新本地配置
    _config.FirstSprayWaterTime = FirstSprayWaterTime;
    // ... 其他参数
    
    // 如果 Modbus 已连接，写入设备
    if (IsModbusConnected)
    {
        await SaveParametersToDeviceAsync();
        MessageBox.Show("系统参数已保存到设备！", "成功");
    }
    else
    {
        MessageBox.Show("系统参数已保存到本地配置！\n\n注意：设备未连接，参数未写入设备。", 
                      "保存成功", MessageBoxButton.OK, MessageBoxImage.Warning);
    }
}

5. 写入参数到设备

private async Task SaveParametersToDeviceAsync()
{
    // 准备时间参数数据（D404-D424，共11个寄存器）
    ushort[] timeParams = new ushort[11];
    timeParams[0] = (ushort)FirstSprayWaterTime;           // D404
    timeParams[1] = (ushort)AfterShampoo1SprayTime;        // D406
    timeParams[2] = (ushort)AfterShampoo2SprayTime;        // D408
    timeParams[3] = (ushort)AfterShampoo3SprayTime;        // D410
    timeParams[4] = 0;                                     // D412 保留
    timeParams[5] = (ushort)SprayShampoo1Time;             // D414
    timeParams[6] = (ushort)SprayShampoo2Time;             // D416
    timeParams[7] = (ushort)SprayShampoo3Time;             // D418
    timeParams[8] = (ushort)HotAirTime;                    // D420
    timeParams[9] = (ushort)ColdAirTime;                   // D422
    timeParams[10] = (ushort)UvSterilizationTime;          // D424

    // 写入设备
    await _modbusService.WriteMultipleRegistersAsync(404, timeParams);
}

6. 定时更新液位数据

// 初始化液位监测定时器（每30秒更新一次）
_liquidLevelTimer = new System.Timers.Timer(30000);
_liquidLevelTimer.Elapsed += async (s, e) =>
{
    if (IsModbusConnected)
    {
        try
        {
            await LoadLiquidLevelsAsync();
        }
        catch (Exception ex)
        {
            _logger.LogError("定时更新液位失败", ex);
        }
    }
};
_liquidLevelTimer.Start();

用户操作流程

初始化流程

1. 启动应用程序

   • 系统自动连接 Modbus TCP 设备（192.168.1.10:502）
   • 连接成功后自动读取设备参数
   • 界面显示设备当前配置

2. 连接失败处理

   • 如果设备连接失败，使用本地默认配置
   • 界面显示 "系统就绪，设备未连接"
   • 用户仍可修改参数，但无法写入设备

修改参数流程

1. 进入设置界面

   • 点击 "系统设置" 按钮
   • 显示当前参数值（来自设备或本地配置）

2. 调整参数

   • 使用 +/- 按钮调整各项时间参数
   • 参数范围：0-60 分钟
   • 实时显示修改后的值

3. 保存参数

   • 点击 "保存设置" 按钮
   • 系统检查 Modbus 连接状态

   设备已连接：

   • 参数写入设备寄存器
   • 同时更新本地配置
   • 显示 "系统参数已保存到设备！"

   设备未连接：

   • 仅更新本地配置
   • 显示警告："参数未写入设备"

液位监控

1. 自动更新

   • 系统每30秒自动读取液位数据
   • 仅在设备连接时执行

2. 界面显示

   • 实时显示三个液位百分比
   • 液位低于阈值时可添加告警（可选功能）

错误处理

读取失败

try
{
    await LoadDeviceParametersAsync();
}
catch (Exception ex)
{
    _logger.LogError("读取设备参数失败，使用默认配置", ex);
    LoadDefaultParameters();
    StatusMessage = "设备参数读取失败，使用默认配置";
}

写入失败

try
{
    await SaveParametersToDeviceAsync();
}
catch (Exception ex)
{
    _logger.LogError("写入设备参数失败", ex);
    throw new Exception($"写入设备失败: {ex.Message}", ex);
}

连接断开处理

• Modbus 服务有自动重连机制
• 连接状态变化时触发事件通知
• 界面实时更新连接状态

日志记录

所有操作都有详细的日志记录：

[INFO] 正在从设备读取系统参数...
[INFO] 时间参数读取成功 - 首次喷水:2min, 沐浴1后:2min, ...
[INFO] 液位读取成功 - 1号:80%, 2号:75%, 3号:70%
[INFO] 正在将参数写入设备...
[INFO] 参数已成功写入设备
[ERROR] 读取设备参数失败，使用默认配置
[ERROR] 定时更新液位失败

数据验证

参数范围验证

// 使用 Math.Min 和 Math.Max 确保参数在有效范围内
private void IncreaseFirstSprayWater() => 
    FirstSprayWaterTime = Math.Min(FirstSprayWaterTime + 1, 60);

private void DecreaseFirstSprayWater() => 
    FirstSprayWaterTime = Math.Max(FirstSprayWaterTime - 1, 0);

数据类型转换

// 确保数据类型正确转换
timeParams[0] = (ushort)FirstSprayWaterTime;  // int -> ushort

性能优化

批量读写

• 使用 ReadHoldingRegistersAsync(404, 11) 一次读取11个连续寄存器
• 使用 WriteMultipleRegistersAsync(404, timeParams) 一次写入所有参数
• 减少网络通信次数，提高效率

定时更新策略

• 液位数据每30秒更新一次（可配置）
• 避免频繁读取影响性能
• 仅在设备连接时执行

异步操作

• 所有 Modbus 操作都是异步的
• 不阻塞 UI 线程
• 提供良好的用户体验

生产环境注意事项

1. 地址验证

在实际部署前，请确认：

• 设备的实际 Modbus 地址映射
• 寄存器的数据格式（UINT16、INT16等）
• 数据单位和缩放因子

2. 超时设置

根据网络环境调整超时参数：

public int ModbusConnectTimeoutMs { get; set; } = 5000;  // 连接超时
public int ModbusReadTimeoutMs { get; set; } = 3000;     // 读写超时

3. 错误恢复

• 读取失败时使用默认配置
• 写入失败时提示用户重试
• 连接断开时自动重连

4. 数据持久化

当前实现：

• 参数保存到 ConfigurationService（内存）
• 建议：添加配置文件持久化功能

5. 参数验证

建议添加：

• 参数合理性检查
• 总时长限制
• 参数组合验证

测试建议

单元测试

1. 读取测试

   // 测试参数读取
   await LoadDeviceParametersAsync();
   Assert.AreEqual(2, FirstSprayWaterTime);
   

2. 写入测试

   // 测试参数写入
   FirstSprayWaterTime = 5;
   await SaveParametersToDeviceAsync();
   // 验证写入成功
   

3. 液位测试

   // 测试液位读取
   await LoadLiquidLevelsAsync();
   Assert.IsTrue(Shampoo1Level >= 0 && Shampoo1Level <= 100);
   

集成测试

1. 完整流程测试

   • 启动应用 → 读取参数 → 修改参数 → 保存参数 → 验证

2. 断线重连测试

   • 断开网络 → 观察重连 → 恢复网络 → 验证功能

3. 长时间运行测试

   • 运行24小时 → 检查液位更新 → 验证稳定性

扩展功能建议

1. 参数模板

// 保存/加载参数模板
public void SaveTemplate(string name);
public void LoadTemplate(string name);

2. 参数历史

// 记录参数修改历史
public void LogParameterChange(string paramName, int oldValue, int newValue);

3. 液位告警

// 液位低于阈值时告警
if (Shampoo1Level < 20)
{
    ShowLowLevelWarning("1号沐浴露液位过低");
}

4. 远程监控

// 通过 MQTT 发布参数变化
await _mqttService.PublishAsync("device/parameters", parameters);

总结

已实现的功能：

• ✅ 初始化时从设备读取参数
• ✅ 界面实时显示设备配置
• ✅ 用户修改参数
• ✅ 保存参数到设备
• ✅ 定时读取液位数据
• ✅ 完整的错误处理
• ✅ 详细的日志记录
• ✅ 连接状态监控
• ✅ 自动重连机制

系统现在可以完整地读写设备参数，适合生产环境部署。