gps

type Fix struct {
	Latitude  float64 // degrees, north positive
	Longitude float64 // degrees, east positive
	Altitude  float64 // metres above MSL
	HasAlt    bool
	Speed     float64   // knots (APRS/NMEA canonical unit)
	Heading   float64   // degrees true, 0..360
	HasCourse bool      // true if Speed/Heading are valid for this fix
	Timestamp time.Time // UTC
	FixMode   int       // 0=unknown, 1=no fix, 2=2D, 3=3D (from GSA)
	PDOP      float64   // position dilution of precision
	HDOP      float64   // horizontal dilution of precision
	VDOP      float64   // vertical dilution of precision
	HasDOP    bool      // true if DOP values are valid
}

type GPSDConfig struct {
	Host string // default "localhost"
	Port int    // default 2947
	// OnParseError, if non-nil, is invoked for every JSON line that
	// fails to unmarshal into a TPV report. source is always "gpsd"
	// for the caller's convenience so the same callback can be shared
	// between the gpsd and NMEA readers.
	OnParseError func(source string)
}

type MemCache struct {
	// contains filtered or unexported fields
}

type NMEAOptions struct {
	OnParseError func(source string)
}

type PositionCache interface {
	// Get returns the latest fix and whether any fix has been stored.
	Get() (Fix, bool)
	// Update stores a new fix. Readers call this from their goroutines.
	Update(Fix)
}

type PositionSource int

type SatelliteCache interface {
	GetSatellites() (SatelliteView, bool)
	UpdateSatellites(SatelliteView)
}

type SatelliteInfo struct {
	PRN       int // satellite PRN/ID number
	Elevation int // degrees above horizon (0-90)
	Azimuth   int // degrees from true north (0-359)
	SNR       int // signal-to-noise dB-Hz (0-99), -1 if not tracking
}

type SatelliteView struct {
	Satellites []SatelliteInfo
	UpdatedAt  time.Time
}

type SerialConfig struct {
	Device   string // e.g. /dev/ttyUSB0
	BaudRate int    // e.g. 4800, 9600, 38400
	// OnParseError, if non-nil, is invoked for every NMEA sentence
	// that fails to parse. source is always "nmea".
	OnParseError func(source string)
}

type SerialPortInfo struct {
	Path         string `json:"path"`        // device path, e.g. /dev/cu.usbserial-110
	Name         string `json:"name"`        // basename of path
	Description  string `json:"description"` // human-readable description
	IsUSB        bool   `json:"is_usb"`
	VID          string `json:"vid,omitempty"`
	PID          string `json:"pid,omitempty"`
	SerialNumber string `json:"serial_number,omitempty"`
	Product      string `json:"product,omitempty"`
	// Recommended is true for the device path users should pick. On macOS
	// we recommend the /dev/cu.* callout device over /dev/tty.* (which
	// blocks until DCD is asserted).
	Recommended bool `json:"recommended"`
	// Warning is set when there's a known gotcha with this path (e.g. the
	// macOS tty.* / cu.* distinction).
	Warning string `json:"warning,omitempty"`
}

type StationPos struct {
	// contains filtered or unexported fields
}