借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
6.38 KiB
XCoder
using System;
using System.ComponentModel;
using System.Linq;
using NewLife.XCoder.Tools.Gps;
using Xunit;

namespace XCoder.App.Tests;

/// <summary>GPS 定位数据解析</summary>
public class GpsParserTests
{
    /// <summary>按 NMEA 规则补上校验和</summary>
    private static String Nmea(String body)
    {
        var sum = 0;
        foreach (var c in body) sum ^= c;

        return $"${body}*{sum:X2}";
    }

    [Fact]
    [DisplayName("NMEA 度分格式转换为十进制度")]
    public void ParseCoordinate_DegreeMinute()
    {
        // 31°12.3456' = 31 + 12.3456/60 ≈ 31.20576
        var lat = GpsParser.ParseCoordinate("3112.3456", "N");

        Assert.NotNull(lat);
        Assert.Equal(31.20576, lat!.Value, 5);
    }

    [Fact]
    [DisplayName("南纬与西经为负值")]
    public void ParseCoordinate_SouthWest_IsNegative()
    {
        Assert.True(GpsParser.ParseCoordinate("3112.3456", "S") < 0);
        Assert.True(GpsParser.ParseCoordinate("12130.6789", "W") < 0);
    }

    [Theory]
    [DisplayName("非法度分输入返回空")]
    [InlineData("")]
    [InlineData("3112")]
    [InlineData("3160.0000")]     // 分达到 60
    [InlineData("abc.def")]
    public void ParseCoordinate_Invalid_ReturnsNull(String value)
    {
        Assert.Null(GpsParser.ParseCoordinate(value, "N"));
    }

    [Fact]
    [DisplayName("度分输入为空时返回空")]
    public void ParseCoordinate_Null_ReturnsNull()
    {
        Assert.Null(GpsParser.ParseCoordinate(null, "N"));
    }

    [Fact]
    [DisplayName("校验和正确时通过,被篡改时拒绝")]
    public void CheckSum_Works()
    {
        var line = Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");

        Assert.True(GpsParser.CheckSum(line));
        Assert.False(GpsParser.CheckSum(line[..^2] + "FF"));
        Assert.False(GpsParser.CheckSum("GPRMC,123"));
    }

    [Fact]
    [DisplayName("解析 RMC 语句得到坐标与时间")]
    public void ParseNmea_Rmc()
    {
        var line = Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");

        var fix = GpsParser.ParseNmea(line);

        Assert.NotNull(fix);
        Assert.Equal(31.20576, fix!.Latitude, 5);
        Assert.Equal(121.511315, fix.Longitude, 5);
        Assert.Equal("GPRMC", fix.Source);
        Assert.NotNull(fix.Time);
        Assert.Equal(8, fix.Time!.Value.Hour);
        Assert.Equal(35, fix.Time.Value.Minute);
        Assert.Equal(0.004, fix.SpeedKnots!.Value, 6);
    }

    [Fact]
    [DisplayName("RMC 定位状态为 V 时视为无效")]
    public void ParseNmea_RmcVoid_ReturnsNull()
    {
        var line = Nmea("GPRMC,083559.00,V,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A");

        Assert.Null(GpsParser.ParseNmea(line));
    }

    [Fact]
    [DisplayName("解析 GGA 语句得到卫星数与海拔")]
    public void ParseNmea_Gga()
    {
        var line = Nmea("GPGGA,083559.00,3112.3456,N,12130.6789,E,1,08,0.9,32.5,M,46.9,M,,");

        var fix = GpsParser.ParseNmea(line);

        Assert.NotNull(fix);
        Assert.Equal(8, fix!.Satellites);
        Assert.Equal(32.5, fix.Altitude!.Value, 3);
        Assert.Equal("GPGGA", fix.Source);
    }

    [Fact]
    [DisplayName("GGA 定位质量为 0 时视为未定位")]
    public void ParseNmea_GgaNoFix_ReturnsNull()
    {
        var line = Nmea("GPGGA,083559.00,,,,,0,00,99.9,,M,,M,,");

        Assert.Null(GpsParser.ParseNmea(line));
    }

    [Fact]
    [DisplayName("批量解析跳过空行、注释与非法语句")]
    public void ParseNmeaBatch_FiltersInvalid()
    {
        var text = $"""
            # 日志导出的示例
            {Nmea("GPRMC,083559.00,A,3112.3456,N,12130.6789,E,0.004,77.52,091202,,,A")}

            {Nmea("GPGGA,083600.00,3112.3500,N,12130.6800,E,1,08,0.9,32.5,M,46.9,M,,")}
            $GPRMC,BAD,LINE
            """;

        var list = GpsParser.ParseNmeaBatch(text);

        Assert.Equal(2, list.Count);
        Assert.Equal("GPRMC", list[0].Source);
        Assert.Equal("GPGGA", list[1].Source);
    }

    [Fact]
    [DisplayName("没有语句时批量解析返回空清单")]
    public void ParseNmeaBatch_Empty_ReturnsEmpty()
    {
        Assert.Empty(GpsParser.ParseNmeaBatch(null));
        Assert.Empty(GpsParser.ParseNmeaBatch("   \r\n 没有语句 "));
    }

    [Fact]
    [DisplayName("HEX 与单精度浮点可互相转换")]
    public void HexAndSingle_RoundTrip()
    {
        var hex = GpsParser.SingleToHex(31.20576f);

        Assert.Equal(8, hex.Length);
        Assert.Equal(31.20576f, GpsParser.HexToSingle(hex), 4);
    }

    [Fact]
    [DisplayName("十六进制长度不足或含非法字符时报参数错误")]
    public void HexToSingle_Invalid_Throws()
    {
        Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle("C3F5"));
        Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle("ZZZZZZZZ"));
        Assert.Throws<ArgumentException>(() => GpsParser.HexToSingle(null));
    }

    [Fact]
    [DisplayName("16 位合并坐标按前 8 后 8 拆分")]
    public void TryParseCombined_Works()
    {
        var hex = GpsParser.SingleToHex(31.25f) + GpsParser.SingleToHex(121.5f);

        Assert.True(GpsParser.TryParseCombined(hex, out var lat, out var lng));
        Assert.Equal(31.25f, lat);
        Assert.Equal(121.5f, lng);
    }

    [Fact]
    [DisplayName("合并坐标长度不足时返回 false 而不抛异常")]
    public void TryParseCombined_Short_ReturnsFalse()
    {
        Assert.False(GpsParser.TryParseCombined("C3F5", out _, out _));
        Assert.False(GpsParser.TryParseCombined(null, out _, out _));
        Assert.False(GpsParser.TryParseCombined("ZZZZZZZZZZZZZZZZ", out _, out _));
    }

    [Fact]
    [DisplayName("同一点距离为零,纬度差 1 度约 111 公里")]
    public void Distance_KnownValues()
    {
        Assert.Equal(0, GpsParser.Distance(31.2, 121.5, 31.2, 121.5), 3);

        var d = GpsParser.Distance(0, 0, 1, 0);
        Assert.InRange(d, 111_000, 111_400);
    }

    [Fact]
    [DisplayName("轨迹里程为各段距离之和")]
    public void TotalDistance_SumsSegments()
    {
        GpsFix[] points =
        [
            new(0, 0),
            new(0, 1),
            new(0, 2),
        ];

        var total = GpsParser.TotalDistance(points);

        Assert.InRange(total, 222_000, 222_800);
        Assert.Equal(0, GpsParser.TotalDistance([points[0]]));
        Assert.Equal(0, GpsParser.TotalDistance(null));
    }
}