File: kwd.py

package info (click to toggle)
python-nmea2 1.19.0-3
  • links: PTS
  • area: main
  • in suites: forky, sid, trixie
  • size: 420 kB
  • sloc: python: 2,948; makefile: 3
file content (104 lines) | stat: -rw-r--r-- 4,447 bytes parent folder | download
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
100
101
102
103
104
# Kenwood

from decimal import Decimal
from datetime import date, time

from ... import nmea
from ... import nmea_utils


class KWD(nmea.ProprietarySentence):
    sentence_types = {}

    def __new__(_cls, manufacturer, data):
        name = manufacturer + data[0]
        cls = _cls.sentence_types.get(name, _cls)
        return super(KWD, cls).__new__(cls)

    def __init__(self, manufacturer, data):
        self.sentence_type = manufacturer + data[0]
        super(KWD, self).__init__(manufacturer, data)


class KWDWPL(KWD, nmea_utils.LatLonFix, nmea_utils.DatetimeFix, nmea_utils.ValidStatusFix):
    """ Kenwood Waypoint Location

    https://github.com/wb2osz/direwolf/blob/master/waypoint.c

    $PKWDWPL,hhmmss,v,ddmm.mm,ns,dddmm.mm,ew,speed,course,ddmmyy,alt,wname,ts*99
    Where,
       hhmmss       is time in UTC from the clock in the transceiver.
                    This will be bogus if the clock was not set properly.
                    It does not use the timestamp from a position
                    report which could be useful.

       GPS Status	A = active, V = void.
                    It looks like this might be modeled after the GPS status values
                    we see in $GPRMC.  i.e. Does the transceiver know its location?
                    I don't see how that information would be relevant in this context.
                    I've observed this under various conditions (No GPS, GPS with/without
                    fix) and it has always been "V."

       ddmm.mm,ns   is latitude. N or S.
       dddmm.mm,ew  is longitude.  E or W.
       speed        is speed over ground, knots.
       course       is course over ground, degrees.
       ddmmyy       is date.  See comments for time.
       alt          is altitude, meters above mean sea level.
       wname        is the waypoint name.  For an Object Report, the id is the object name.
                    For a position report, it is the call of the sending station.
                    An Object name can contain any printable characters.
                    What if object name contains , or * characters?
                    Those are field delimiter characters and it would be unfortunate
                    if they appeared in a NMEA sentence data field.

                    If there is a comma in the name, such as "test,5" the Kenwood TM-D710A displays
                    it fine but we end up with an extra field.

                       $PKWDWPL,150803,V,4237.14,N,07120.83,W,,,190316,,test,5,/'*30

                    If the name contains an asterisk, it doesn't show up on the
                    display and no waypoint sentence is generated.
                    Some other talkers substitute these two characters following the AvMap precedent.

                       $PKWDWPL,204714,V,4237.1400,N,07120.8300,W,,,200316,,test|5,/'*61
                       $PKWDWPL,204719,V,4237.1400,N,07120.8300,W,,,200316,,test~6,/'*6D

       ts           are the table and symbol.

                    What happens if the symbol is comma or asterisk?
                        , Boy Scouts / Girl Scouts
                        * SnowMobile / Snow

                    the D710A just pushes them thru without checking.
                    These would not be parsed properly:

                        $PKWDWPL,150753,V,4237.14,N,07120.83,W,,,190316,,test3,/,*1B
                        $PKWDWPL,150758,V,4237.14,N,07120.83,W,,,190316,,test4,/ **3B

                    Other talkers do the usual substitution and the other end would
                    need to change them back after extracting from NMEA sentence.

                       $PKWDWPL,204704,V,4237.1400,N,07120.8300,W,,,200316,,test3,/|*41
                       $PKWDWPL,204709,V,4237.1400,N,07120.8300,W,,,200316,,test4,/~*49


        *99            is checksum

    Oddly, there is no place for comment.
    """
    fields = (
        ("Subtype", "subtype"),
        ("Time of Receipt", "timestamp", nmea_utils.timestamp),
        ("GPS Status (Void)","status"),
        ("Latitude", "lat"),
        ("Latitude Direction", "lat_dir"),
        ("Longitude", "lon"),
        ("Longitude Direction", "lon_dir"),
        ("Speed over Ground", "sog", float),
        ("Course over Ground", "cog", float),
        ("Date", "datestamp", nmea_utils.datestamp),
        ("Altitude", "altitude", Decimal),
        ("Waypoint Name", "wname"),
        ("Table and Symbol", "ts"),
    )