Struct UlcpGnssRecord 

pub struct UlcpGnssRecord {
    pub fix: UlcpFixKind,
    pub location: Vec<u8>,
    pub latitude_deg: Option<f64>,
    pub longitude_deg: Option<f64>,
    pub location_cell_meters: Option<f64>,
    pub altitude_m: Option<i32>,
    pub accuracy_dm: Option<u16>,
    pub satellites_used: u8,
    pub satellites_in_view: Option<u8>,
}

What the receiver currently reports, folded from the five positioning telemetry properties.

Unlike a battery reading this is carried on every snapshot rather than reported once: it is state the UI mirrors — a map pin does not disappear because an unrelated property arrived — and the receiver announces position and fix changes on its own schedule.

Fields

fix: UlcpFixKind

location: Vec<u8>

PROP_GNSS_LOCATION as it travels: the interleaved variable-precision grid code, empty without a fix. Carried verbatim so a caller can compare or forward the cell itself rather than re-encoding degrees.

latitude_deg: Option<f64>

Center of the encoded cell, in degrees. None without a fix.

A location names a cell rather than a point; location_cell_meters says how large that cell is, and rendering a pin without it claims a precision the device did not report. Widened from the f32 the decoder works in, because that is the shape every consumer of a coordinate wants.

longitude_deg: Option<f64>

location_cell_meters: Option<f64>

Approximate width of the encoded cell at the equator, in meters.

altitude_m: Option<i32>

PROP_GNSS_ALTITUDE in meters above the WGS-84 ellipsoid.

accuracy_dm: Option<u16>

PROP_GNSS_PRECISION: estimated horizontal accuracy in decimeters. An estimate scaled from dilution of precision, not a measured error bound.

satellites_used: u8

Satellites contributing to the solution. Reads 0 while the receiver is off.

satellites_in_view: Option<u8>

Satellites in view, when the receiver reports them.

Trait Implementations

impl Clone for UlcpGnssRecord

fn clone(&self) -> UlcpGnssRecord

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for UlcpGnssRecord

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for UlcpGnssRecord

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<UT> FfiConverter<UT> for UlcpGnssRecord

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl<UT> Lift<UT> for UlcpGnssRecord

type FfiType = <UlcpGnssRecord as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for UlcpGnssRecord

type LiftType = UlcpGnssRecord

impl<UT> LiftReturn<UT> for UlcpGnssRecord

type ReturnType = <UlcpGnssRecord as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for UlcpGnssRecord

type FfiType = <UlcpGnssRecord as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for UlcpGnssRecord

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for UlcpGnssRecord

type ReturnType = <UlcpGnssRecord as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for UlcpGnssRecord

fn eq(&self, other: &UlcpGnssRecord) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<UT> TypeId<UT> for UlcpGnssRecord

const TYPE_ID_META: MetadataBuffer

impl StructuralPartialEq for UlcpGnssRecord