Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
GnssParser Class Reference
Basic GNSS parser class. More...
#include <gnss.h>
Inherited by GnssI2C, and GnssSerial.
Public Types | |
| enum | { WAIT = -1, NOT_FOUND = 0 } |
Public Member Functions | |
| GnssParser () | |
| Constructor. | |
| virtual | ~GnssParser (void) |
| Destructor. | |
| virtual bool | init (PinName pn)=0 |
| Power-on/wake-up the GNSS. | |
| virtual int | getMessage (char *buf, int len)=0 |
| Get a line from the physical interface. | |
| virtual int | send (const char *buf, int len) |
| Send a buffer. | |
| virtual int | sendNmea (const char *buf, int len) |
| send a NMEA message, this function just takes the payload and calculates and adds checksum. | |
| virtual int | sendUbx (unsigned char cls, unsigned char id, const void *buf=NULL, int len=0) |
| Send a UBX message, this function just takes the payload and calculates and adds checksum. | |
| void | powerOff (void) |
| Power off the GNSS, it can be again woken up by an edge on the serial port on the external interrupt pin. | |
Static Public Member Functions | |
| static const char * | findNmeaItemPos (int ix, const char *start, const char *end) |
| get the first character of a NMEA field. | |
| static bool | getNmeaItem (int ix, char *buf, int len, double &val) |
| Extract a double value from a buffer containing a NMEA message. | |
| static bool | getNmeaItem (int ix, char *buf, int len, int &val, int base) |
| Extract a interger value from a buffer containing a NMEA message. | |
| static bool | getNmeaItem (int ix, char *buf, int len, char &val) |
| Extract a char value from a buffer containing a NMEA message. | |
| static bool | getNmeaAngle (int ix, char *buf, int len, double &val) |
| Extract a latitude/longitude value from a buffer containing a NMEA message. | |
Protected Member Functions | |
| void | _powerOn (void) |
| Power on the GNSS module. | |
| virtual int | _send (const void *buf, int len)=0 |
| Write bytes to the physical interface. | |
Static Protected Member Functions | |
| static int | _getMessage (Pipe< char > *pipe, char *buf, int len) |
| Get a line from the physical interface. | |
| static int | _parseNmea (Pipe< char > *pipe, int len) |
| Check if the current offset of the pipe contains a NMEA message. | |
| static int | _parseUbx (Pipe< char > *pipe, int len) |
| Check if the current offset of the pipe contains a UBX message. | |
Protected Attributes | |
| DigitalInOut * | _gnssEnable |
| IO pin that enables GNSS. | |
Static Protected Attributes | |
| static const char | _toHex [16] = { '0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F' } |
| num to hex conversion | |
Detailed Description
Basic GNSS parser class.
Definition at line 44 of file gnss.h.
Member Enumeration Documentation
| anonymous enum |
Constructor & Destructor Documentation
| GnssParser | ( | void | ) |
| ~GnssParser | ( | void | ) | [virtual] |
Member Function Documentation
| int _getMessage | ( | Pipe< char > * | pipe, |
| char * | buf, | ||
| int | len | ||
| ) | [static, protected] |
Get a line from the physical interface.
- Parameters:
-
pipe the receiveing pipe to parse messages . buf the buffer to store it. len size of the buffer.
- Returns:
- type and length if something was found, WAIT if not enough data is available, NOT_FOUND if nothing was found.
| int _parseNmea | ( | Pipe< char > * | pipe, |
| int | len | ||
| ) | [static, protected] |
Check if the current offset of the pipe contains a NMEA message.
- Parameters:
-
pipe the receiveing pipe to parse messages. len numer of bytes to parse at maximum.
- Returns:
- length if something was found (including the NMEA frame), WAIT if not enough data is available, NOT_FOUND if nothing was found.
| int _parseUbx | ( | Pipe< char > * | pipe, |
| int | len | ||
| ) | [static, protected] |
Check if the current offset of the pipe contains a UBX message.
- Parameters:
-
pipe the receiveing pipe to parse messages. len numer of bytes to parse at maximum.
- Returns:
- length if something was found (including the UBX frame), WAIT if not enough data is available, NOT_FOUND if nothing was found.
| void _powerOn | ( | void | ) | [protected] |
| virtual int _send | ( | const void * | buf, |
| int | len | ||
| ) | [protected, pure virtual] |
Write bytes to the physical interface.
This function needs to be implemented by the inherited class.
- Parameters:
-
buf the buffer to write. len size of the buffer to write.
- Returns:
- bytes written.
Implemented in GnssSerial, and GnssI2C.
| const char * findNmeaItemPos | ( | int | ix, |
| const char * | start, | ||
| const char * | end | ||
| ) | [static] |
| virtual int getMessage | ( | char * | buf, |
| int | len | ||
| ) | [pure virtual] |
Get a line from the physical interface.
This function needs to be implemented in the inherited class.
- Parameters:
-
buf the buffer to store it. len size of the buffer.
- Returns:
- type and length if something was found, WAIT if not enough data is available, NOT_FOUND if nothing was found
Implemented in GnssSerial, and GnssI2C.
| bool getNmeaAngle | ( | int | ix, |
| char * | buf, | ||
| int | len, | ||
| double & | val | ||
| ) | [static] |
Extract a latitude/longitude value from a buffer containing a NMEA message.
- Parameters:
-
ix the index of the field to extract (will extract ix and ix + 1), buf the NMEA message, len the size of the NMEA message, val the extracted latitude or longitude,
- Returns:
- true if successful, false otherwise.
| bool getNmeaItem | ( | int | ix, |
| char * | buf, | ||
| int | len, | ||
| int & | val, | ||
| int | base | ||
| ) | [static] |
Extract a interger value from a buffer containing a NMEA message.
- Parameters:
-
ix the index of the field to extract. buf the NMEA message. len the size of the NMEA message. val the extracted value. base the numeric base to be used (e.g. 8, 10 or 16).
- Returns:
- true if successful, false otherwise.
| bool getNmeaItem | ( | int | ix, |
| char * | buf, | ||
| int | len, | ||
| double & | val | ||
| ) | [static] |
| bool getNmeaItem | ( | int | ix, |
| char * | buf, | ||
| int | len, | ||
| char & | val | ||
| ) | [static] |
| virtual bool init | ( | PinName | pn ) | [pure virtual] |
Power-on/wake-up the GNSS.
Implemented in GnssSerial, and GnssI2C.
| void powerOff | ( | void | ) |
| int send | ( | const char * | buf, |
| int | len | ||
| ) | [virtual] |
| int sendNmea | ( | const char * | buf, |
| int | len | ||
| ) | [virtual] |
send a NMEA message, this function just takes the payload and calculates and adds checksum.
($ and *XX
will be added).
- Parameters:
-
buf the message payload to write. len size of the message payload to write.
- Returns:
- total bytes written.
Reimplemented in GnssI2C.
| int sendUbx | ( | unsigned char | cls, |
| unsigned char | id, | ||
| const void * | buf = NULL, |
||
| int | len = 0 |
||
| ) | [virtual] |
Send a UBX message, this function just takes the payload and calculates and adds checksum.
- Parameters:
-
cls the UBX class id. id the UBX message id. buf the message payload to write. len size of the message payload to write.
- Returns:
- total bytes written.
Reimplemented in GnssI2C.
Field Documentation
DigitalInOut* _gnssEnable [protected] |
Generated on Thu Jul 14 2022 09:58:19 by
1.7.2