CydandClaude Opus 4.8
b3cb764f4d
Port the RIO wire protocol from legacy/riovjoy2.cpp into testable C#: - Protocol/: command + length table, 7-bit checksum, packet builder, and a streaming receive-side framing state machine (PacketParser) that mirrors the legacy ReadCommBlock framing/resync (high-bit-mid-packet abort). Typed RIO->PC decodes: AnalogReport (14-bit sign-extend), VersionInfo, CheckStatus; lamp-state composition. - Serial/: RioSerialLink drives an async receive loop with ACK/NAK reply policy (legacy force-accept vs. opt-in VerifyInboundChecksum), the analog poll timer, and the >5s reset-recovery watchdog. IRioTransport abstracts the COM port; the SerialPort-backed transport does 9600 8N1 + DTR reset pulse, and acquire/release is just create/dispose (foundation for native-game serial yield). - tests/RioJoy.Core.Tests: 54 xUnit tests covering checksum, framing/resync, builder round-trips, analog sign-extension + sentinel rejection, lamp combos, and the read loop driven against an in-memory fake transport. Hardware verification (version/check/analog against a cabinet) remains; it can't be done off-device. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
48 lines
1.5 KiB
C#
48 lines
1.5 KiB
C#
using RioJoy.Core.Protocol;
|
|
using Xunit;
|
|
|
|
namespace RioJoy.Core.Tests.Protocol;
|
|
|
|
public class PacketBuilderTests
|
|
{
|
|
[Fact]
|
|
public void AnalogRequest_HasCommandAndChecksumOnly()
|
|
{
|
|
// 0x82, checksum = 0x82 & 0x7F = 0x02
|
|
Assert.Equal(new byte[] { 0x82, 0x02 }, PacketBuilder.AnalogRequest());
|
|
}
|
|
|
|
[Fact]
|
|
public void ResetRequest_EncodesTarget()
|
|
{
|
|
// 0x83, payload [0x00], checksum = 0x03
|
|
Assert.Equal(new byte[] { 0x83, 0x00, 0x03 }, PacketBuilder.ResetRequest(RioResetTarget.All));
|
|
// 0x83, payload [0x01], checksum = 0x04
|
|
Assert.Equal(new byte[] { 0x83, 0x01, 0x04 }, PacketBuilder.ResetRequest(RioResetTarget.Throttle));
|
|
}
|
|
|
|
[Fact]
|
|
public void LampRequest_EncodesLampAndState()
|
|
{
|
|
// 0x84, payload [0x05, 0x3C], checksum = (0x04 + 0x05 + 0x3C) & 0x7F = 0x45
|
|
Assert.Equal(new byte[] { 0x84, 0x05, 0x3C, 0x45 }, PacketBuilder.LampRequest(5, 0x3C));
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ValidatesPayloadLength()
|
|
{
|
|
Assert.Throws<ArgumentException>(() => PacketBuilder.Build(RioCommand.LampRequest, new byte[] { 0x01 }));
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_AppendsCorrectChecksum_ForFullPayload()
|
|
{
|
|
var payload = new byte[] { 1, 0, 2, 0, 3, 0, 4, 0, 5, 0 };
|
|
byte[] packet = PacketBuilder.Build(RioCommand.AnalogReply, payload);
|
|
|
|
Assert.Equal((byte)RioCommand.AnalogReply, packet[0]);
|
|
Assert.Equal(payload, packet[1..^1]);
|
|
Assert.Equal(RioChecksum.Compute(packet[..^1]), packet[^1]);
|
|
}
|
|
}
|