mirror of
https://github.com/betaflight/betaflight.git
synced 2025-07-19 14:25:20 +03:00
37dbbd0755
Adds variations in GPS coordinate OSD element display: 1. Fractional degrees with 7 digits (default) - 000.0000000 2. Fractional degrees with 4 digits - 000.0000 3. Degrees, minutes, seconds - 000^00'00.0"E 4. Open Location Code (sometimed called Google Plus Code) - 23ABC4R8+M37 Uses Open Location Code library from: https://github.com/google/open-location-code Added support for `STATE(GPS_FIX_EVER)` to differentiate from having a fix now (`STATE(GPS_FIX)`) vs. ever having a fix. Logic change to only display coordinates from the GPS module once a fix has been initially established. This prevents displaying interim coordinates supplied by the GPS while the fix is still being establised as these coordinates can be inaccurate by hundreds of miles. Once a fix is established initially then the coordinates will continue to be displayed even if the fix is lost or degrades in quality. Add logic to "blink" the coordinates if the 3D fix is lost after initially being established. Alerts the user that the coordinate display may be inaccurate or no longer being updated. We want to keep the coordinates displayed to aid recovery if the user loses the fix (like crashing upside down). Replace GPS defines `LAT` and `LON` used throughout the code with the enumeration: ``` typedef enum { GPS_LATITUDE, GPS_LONGITUDE } gpsCoordinateType_e; ``` The Open Location Code option is bounded with `USE_GPS_PLUS_CODE` to allow it to be excluded if needed for targets with limited flash space. It currently fits for F411 but we may have to remove it in the future.
75 lines
2.5 KiB
C
75 lines
2.5 KiB
C
#ifndef OLC_OPENLOCATIONCODE_H_
|
|
#define OLC_OPENLOCATIONCODE_H_
|
|
|
|
#include <stdlib.h>
|
|
|
|
#define OLC_VERSION_MAJOR 1
|
|
#define OLC_VERSION_MINOR 0
|
|
#define OLC_VERSION_PATCH 0
|
|
|
|
// OLC version number: 2.3.4 => 2003004
|
|
// Useful for checking against a particular version or above:
|
|
//
|
|
// #if OLC_VERSION_NUM < OLC_MAKE_VERSION_NUM(1, 0, 2)
|
|
// #error UNSUPPORTED OLC VERSION
|
|
// #endif
|
|
#define OLC_MAKE_VERSION_NUM(major, minor, patch) \
|
|
((major * 1000 + minor) * 1000 + patch)
|
|
|
|
// OLC version string: 2.3.4 => "2.3.4"
|
|
#define OLC_MAKE_VERSION_STR_IMPL(major, minor, patch) \
|
|
(#major "." #minor "." #patch)
|
|
#define OLC_MAKE_VERSION_STR(major, minor, patch) \
|
|
OLC_MAKE_VERSION_STR_IMPL(major, minor, patch)
|
|
|
|
// Current version, as a number and a string
|
|
#define OLC_VERSION_NUM \
|
|
OLC_MAKE_VERSION_NUM(OLC_VERSION_MAJOR, OLC_VERSION_MINOR, OLC_VERSION_PATCH)
|
|
#define OLC_VERSION_STR \
|
|
OLC_MAKE_VERSION_STR(OLC_VERSION_MAJOR, OLC_VERSION_MINOR, OLC_VERSION_PATCH)
|
|
|
|
// A pair of doubles representing latitude / longitude
|
|
typedef struct OLC_LatLon {
|
|
double lat;
|
|
double lon;
|
|
} OLC_LatLon;
|
|
|
|
// An area defined by two corners (lo and hi) and a code length
|
|
typedef struct OLC_CodeArea {
|
|
OLC_LatLon lo;
|
|
OLC_LatLon hi;
|
|
size_t len;
|
|
} OLC_CodeArea;
|
|
|
|
// Get the center coordinates for an area
|
|
void OLC_GetCenter(const OLC_CodeArea* area, OLC_LatLon* center);
|
|
|
|
// Get the effective length for a code
|
|
size_t OLC_CodeLength(const char* code, size_t size);
|
|
|
|
// Check for the three obviously-named conditions
|
|
int OLC_IsValid(const char* code, size_t size);
|
|
int OLC_IsShort(const char* code, size_t size);
|
|
int OLC_IsFull(const char* code, size_t size);
|
|
|
|
// Encode location with given code length (indicates precision) into an OLC
|
|
// Return the string length of the code
|
|
int OLC_Encode(const OLC_LatLon* location, size_t code_length, char* code,
|
|
int maxlen);
|
|
|
|
// Encode location with default code length into an OLC
|
|
// Return the string length of the code
|
|
int OLC_EncodeDefault(const OLC_LatLon* location, char* code, int maxlen);
|
|
|
|
// Decode OLC into the original location
|
|
int OLC_Decode(const char* code, size_t size, OLC_CodeArea* decoded);
|
|
|
|
// Compute a (shorter) OLC for a given code and a reference location
|
|
int OLC_Shorten(const char* code, size_t size, const OLC_LatLon* reference,
|
|
char* buf, int maxlen);
|
|
|
|
// Given shorter OLC and reference location, compute original (full length) OLC
|
|
int OLC_RecoverNearest(const char* short_code, size_t size,
|
|
const OLC_LatLon* reference, char* code, int maxlen);
|
|
|
|
#endif
|