nmea 0.8.0

Simple NMEA 0183 parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use chrono::NaiveTime;
use nom::{
    IResult, Parser as _, character::complete::char, combinator::opt, number::complete::float,
};

use crate::{
    Error, SentenceType,
    parse::NmeaSentence,
    sentences::utils::{number, parse_hms, parse_lat_lon},
};

/// GBS - GPS Satellite Fault Detection
///
/// <https://gpsd.gitlab.io/gpsd/NMEA.html#_gbs_gps_satellite_fault_detection>
///
/// ```text
/// 1      2   3   4   5   6   7   8   9
/// |      |   |   |   |   |   |   |   |
/// $--GBS,hhmmss.ss,x.x,x.x,x.x,x.x,x.x,x.x,x.x*hh<CR><LF>
/// ```
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct GbsData {
    #[cfg_attr(feature = "defmt", defmt(Debug2Format))]
    pub time: Option<NaiveTime>,
    pub lat_error: Option<f64>,
    pub lon_error: Option<f64>,
    pub alt_error: Option<f32>,
    pub most_likely_failed_sat: Option<u8>,
    pub missed_probability: Option<f32>,
    pub bias_estimate: Option<f32>,
    pub bias_standard_deviation: Option<f32>,
}

/// GBS - GPS Satellite Fault Detection
///
/// ```text
/// 1      2   3   4   5   6   7   8   9
/// |      |   |   |   |   |   |   |   |
/// $--GBS,hhmmss.ss,x.x,x.x,x.x,x.x,x.x,x.x,x.x*hh<CR><LF>
/// ```
fn do_parse_gbs(i: &str) -> IResult<&str, GbsData> {
    // 1. UTC time of the GGA or GNS fix associated with this sentence. hh is hours, mm is minutes, ss.ss is seconds
    let (i, time) = opt(parse_hms).parse(i)?;
    let (i, _) = char(',').parse(i)?;

    // 2. Expected 1-sigma error in latitude (meters)
    // 3. Expected 1-sigma error in longitude (meters)
    let (i, lat_lon_errors) = parse_lat_lon(i)?;
    let (i, _) = char(',').parse(i)?;

    // 4. Expected 1-sigma error in altitude (meters)
    let (i, alt_error) = opt(float).parse(i)?;
    let (i, _) = char(',').parse(i)?;

    // 5. ID of most likely failed satellite (1 to 138)
    let (i, most_likely_failed_sat) = opt(number::<u8>).parse(i)?;
    let (i, _) = char(',').parse(i)?;

    // 6. Probability of missed detection for most likely failed satellite
    let (i, missed_probability) = opt(float).parse(i)?;
    let (i, _) = char(',').parse(i)?;

    // 7. Estimate of bias in meters on most likely failed satellite
    let (i, bias_estimate) = opt(float).parse(i)?;
    let (i, _) = char(',').parse(i)?;
    // 8. Standard deviation of bias estimate
    let (i, bias_standard_deviation) = opt(float).parse(i)?;
    // 9. Checksum

    Ok((
        i,
        GbsData {
            time,
            lat_error: lat_lon_errors.map(|(lat, _lon)| lat),
            lon_error: lat_lon_errors.map(|(_lat, lon)| lon),
            alt_error,
            most_likely_failed_sat,
            missed_probability,
            bias_estimate,
            bias_standard_deviation,
        },
    ))
}

/// # Parse BOD message
///
/// See: <https://gpsd.gitlab.io/gpsd/NMEA.html#_gbs_gps_satellite_fault_detection>
pub fn parse_gbs(sentence: NmeaSentence<'_>) -> Result<GbsData, Error<'_>> {
    if sentence.message_id != SentenceType::GBS {
        Err(Error::WrongSentenceHeader {
            expected: SentenceType::GBS,
            found: sentence.message_id,
        })
    } else {
        Ok(do_parse_gbs(sentence.data)?.1)
    }
}