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>
37 lines
900 B
C#
37 lines
900 B
C#
using RioJoy.Core.Protocol;
|
|
using Xunit;
|
|
|
|
namespace RioJoy.Core.Tests.Protocol;
|
|
|
|
public class RioChecksumTests
|
|
{
|
|
[Fact]
|
|
public void Empty_IsZero()
|
|
{
|
|
Assert.Equal(0, RioChecksum.Compute(ReadOnlySpan<byte>.Empty));
|
|
}
|
|
|
|
[Fact]
|
|
public void SumsLow7Bits()
|
|
{
|
|
// (0x84 & 0x7F) + (0x05 & 0x7F) + (0x3C & 0x7F) = 0x04 + 0x05 + 0x3C = 0x45
|
|
byte sum = RioChecksum.Compute(new byte[] { 0x84, 0x05, 0x3C });
|
|
Assert.Equal(0x45, sum);
|
|
}
|
|
|
|
[Fact]
|
|
public void MasksResultTo7Bits()
|
|
{
|
|
// Sum of low-7-bits = 0x7F + 0x7F = 0xFE; masked to 7 bits → 0x7E.
|
|
byte sum = RioChecksum.Compute(new byte[] { 0x7F, 0x7F });
|
|
Assert.Equal(0x7E, sum);
|
|
}
|
|
|
|
[Fact]
|
|
public void IgnoresHighBitOfInputs()
|
|
{
|
|
// 0x82 contributes only 0x02.
|
|
Assert.Equal(0x02, RioChecksum.Compute(new byte[] { 0x82 }));
|
|
}
|
|
}
|