using System;
using System.ComponentModel;
using System.Threading.Tasks;
using NewLife.XCoder.Tools.Modbus;
namespace XCoder.App.Tests;
/// <summary>Modbus 从站模拟测试</summary>
public class ModbusSlaveTests
{
[Fact]
[DisplayName("写单个寄存器后从站寄存器变化并回显")]
public void Process_WriteSingle_Echo()
{
using var slave = new ModbusSlaveService();
var request = MbFrame.BuildRequest(1, MbFunction.WriteSingle, 5, 1234);
var response = slave.Process(request[..7], request[7..]);
var parsed = MbFrame.ParseResponse(response);
Assert.False(parsed.IsError);
Assert.Equal(1234, slave.Registers[5]);
Assert.Equal(new UInt16[] { 1234 }, parsed.Values);
}
[Fact]
[DisplayName("读保持寄存器返回寄存器内容")]
public void Process_ReadHolding()
{
using var slave = new ModbusSlaveService();
slave.Registers[7] = 4321;
slave.Registers[8] = 8765;
var request = MbFrame.BuildRequest(1, MbFunction.ReadHolding, 7, 2);
var parsed = MbFrame.ParseResponse(slave.Process(request[..7], request[7..]));
Assert.False(parsed.IsError);
Assert.Equal(new UInt16[] { 4321, 8765 }, parsed.Values);
}
[Fact]
[DisplayName("越界读取返回异常码 02")]
public void Process_ReadOutOfRange_Error()
{
using var slave = new ModbusSlaveService();
var request = MbFrame.BuildRequest(1, MbFunction.ReadHolding, 999, 5);
var parsed = MbFrame.ParseResponse(slave.Process(request[..7], request[7..]));
Assert.True(parsed.IsError);
Assert.Equal(2, parsed.ErrorCode);
}
[Fact]
[DisplayName("不支持的功能码返回异常码 01")]
public void Process_UnsupportedFunction_Error()
{
using var slave = new ModbusSlaveService();
var request = MbFrame.BuildRequest(1, MbFunction.ReadHolding, 0, 1);
// 手工改成非法功能码 0x05
request[7] = 0x05;
var parsed = MbFrame.ParseResponse(slave.Process(request[..7], request[7..]));
Assert.True(parsed.IsError);
Assert.Equal(1, parsed.ErrorCode);
}
[Fact]
[DisplayName("主站 → 从站回环读写联通")]
public async Task Loopback_WriteThenRead()
{
using var slave = new ModbusSlaveService();
slave.Start();
var write = await ModbusMasterService.WriteSingleAsync("127.0.0.1", slave.Port, 1, 12, 999)
.WaitAsync(TimeSpan.FromSeconds(5));
Assert.False(write.IsError);
var read = await ModbusMasterService.ReadAsync("127.0.0.1", slave.Port, 1, 12, 1)
.WaitAsync(TimeSpan.FromSeconds(5));
Assert.False(read.IsError);
Assert.Equal(new UInt16[] { 999 }, read.Values);
}
[Fact]
[DisplayName("批量写多寄存器后回环读回一致")]
public async Task Loopback_WriteMultipleThenRead()
{
using var slave = new ModbusSlaveService();
slave.Start();
UInt16[] values = [11, 22, 33, 44];
var write = await ModbusMasterService.WriteMultipleAsync("127.0.0.1", slave.Port, 1, 20, values)
.WaitAsync(TimeSpan.FromSeconds(5));
Assert.False(write.IsError);
Assert.Equal(new UInt16[] { 20, 4 }, write.Values);
var read = await ModbusMasterService.ReadAsync("127.0.0.1", slave.Port, 1, 20, 4)
.WaitAsync(TimeSpan.FromSeconds(5));
Assert.False(read.IsError);
Assert.Equal(values, read.Values);
}
[Fact]
[DisplayName("批量写超过 123 个寄存器被拒绝")]
public async Task WriteMultiple_TooMany_Throws()
{
await Assert.ThrowsAsync<ArgumentException>(() =>
ModbusMasterService.WriteMultipleAsync("127.0.0.1", 502, 1, 0, new UInt16[124]));
}
[Fact]
[DisplayName("设备模板可按名称查找并带默认参数")]
public void Templates_Find()
{
var template = ModbusTemplates.Find("I/O 模块 · 线圈");
Assert.NotNull(template);
Assert.Equal(8, template!.Count);
Assert.Null(ModbusTemplates.Find("不存在"));
Assert.Null(ModbusTemplates.Find(""));
Assert.NotEmpty(ModbusTemplates.All);
}
}
|