Configuration

This is the default configuration of the middleware. When any of the settings shall be modified, it shall be done in dedicated application config lwgps_opts.h file.

Note

Check Getting started to create configuration file.

group LWGPS_OPT

Default configuration setup.

Defines

LWGPS_CFG_DOUBLE

Enables 1 or disables 0 double precision for floating point values such as latitude, longitude, altitude.

double is used as variable type when enabled, float when disabled.

LWGPS_CFG_STATUS

Enables 1 or disables 0 status reporting callback by lwgps_process.

Note

This is an extension, so not enabled by default.

LWGPS_CFG_STATEMENT_GPGGA

Enables 1 or disables 0 GGA statement parsing.

Note

This statement must be enabled to parse:

  • Latitude, Longitude, Altitude

  • Number of satellites in use, fix (no fix, GPS, DGPS), UTC time

LWGPS_CFG_STATEMENT_GPGSA

Enables 1 or disables 0 GSA statement parsing.

Note

This statement must be enabled to parse:

  • Position/Vertical/Horizontal dilution of precision

  • Fix mode (no fix, 2D, 3D fix)

  • IDs of satellites in use

LWGPS_CFG_STATEMENT_GPRMC

Enables 1 or disables 0 RMC statement parsing.

Note

This statement must be enabled to parse:

  • Validity of GPS signal

  • Ground speed in knots and coarse in degrees

  • Magnetic variation

  • UTC date

LWGPS_CFG_STATEMENT_GPGSV

Enables 1 or disables 0 GSV statement parsing.

Note

This statement must be enabled to parse:

LWGPS_CFG_STATEMENT_GPGSV_SAT_DET

Enables 1 or disables 0 detailed parsing of each satellite in view for GSV statement.

Note

When this feature is disabled, only number of “satellites in view” is parsed

LWGPS_CFG_SATS_IN_VIEW_SIZE

Maximum number of satellite descriptors stored in lwgps_t::sats_in_view_desc. 

             48 covers GPS(32) + GLONASS(24) + Galileo(24) + BeiDou(35) worst-case
             visible subsets. Increase if more are needed; decrease to save RAM
             (~8 bytes per descriptor).
LWGPS_CFG_STATEMENT_PUBX

Enables 1 or disables 0 parsing and generation of PUBX (uBlox) messages.

PUBX are a nonstandard ublox-specific extensions, so disabled by default.

LWGPS_CFG_STATEMENT_PUBX_TIME

Enables 1 or disables 0 parsing and generation of PUBX (uBlox) TIME messages.

This is a nonstandard ublox-specific extension, so disabled by default.

This configure option requires LWGPS_CFG_STATEMENT_PUBX

Note

TIME messages can be used to obtain:

  • UTC time of week

  • UTC week number

  • Leap seconds (allows conversion to eg. TAI)

LWGPS_CFG_CRC

Enables 1 or disables 0 CRC calculation and check.

Note

When not enabled, CRC check is ignored

LWESP_CFG_DISTANCE_BEARING

Enables 1 or disables 0 distance and bearing calculation.

Note

When not enabled, corresponding function is disabled

LWGPS_MEMSET(dst, val, len)

Memory set function.

Note

Function footprint is the same as memset

LWGPS_MEMCPY(dst, src, len)

Memory copy function.

Note

Function footprint is the same as memcpy