esp32_Adafruit_GPS/Adafruit_GPS.h

138 lines
4.1 KiB
C
Raw Normal View History

2012-03-27 22:56:07 +01:00
/***********************************
2012-03-28 17:23:26 +01:00
This is the Adafruit GPS library - the ultimate GPS library
for the ultimate GPS module!
Tested and works great with the Adafruit Ultimate GPS module
using MTK33x9 chipset
------> http://www.adafruit.com/products/746
Pick one up today at the Adafruit electronics shop
and help support open source hardware & software! -ada
2012-03-27 22:56:07 +01:00
Adafruit invests time and resources providing this open source code,
please support Adafruit and open-source hardware by purchasing
products from Adafruit!
Written by Limor Fried/Ladyada for Adafruit Industries.
BSD license, check license.txt for more information
All text above must be included in any redistribution
****************************************/
#ifndef _ADAFRUIT_GPS_H
#define _ADAFRUIT_GPS_H
2012-11-03 23:27:41 +00:00
#if ARDUINO >= 100
#include <SoftwareSerial.h>
#else
#include <NewSoftSerial.h>
#endif
2012-03-27 22:56:07 +01:00
// different commands to set the update rate from once a second (1 Hz) to 10 times a second (10Hz)
#define PMTK_SET_NMEA_UPDATE_1HZ "$PMTK220,1000*1F"
#define PMTK_SET_NMEA_UPDATE_5HZ "$PMTK220,200*2C"
#define PMTK_SET_NMEA_UPDATE_10HZ "$PMTK220,100*2F"
2012-09-08 01:25:48 +01:00
2012-10-17 10:32:37 +01:00
#define PMTK_SET_BAUD_57600 "$PMTK251,57600*2C"
#define PMTK_SET_BAUD_9600 "$PMTK251,9600*17"
2012-09-08 01:25:48 +01:00
2012-03-27 22:56:07 +01:00
// turn on only the second sentence (GPRMC)
#define PMTK_SET_NMEA_OUTPUT_RMCONLY "$PMTK314,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*29"
// turn on GPRMC and GGA
#define PMTK_SET_NMEA_OUTPUT_RMCGGA "$PMTK314,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*28"
// turn on ALL THE DATA
#define PMTK_SET_NMEA_OUTPUT_ALLDATA "$PMTK314,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0*28"
2012-04-17 16:42:20 +01:00
// turn off output
#define PMTK_SET_NMEA_OUTPUT_OFF "$PMTK314,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*28"
2012-03-27 22:56:07 +01:00
// to generate your own sentences, check out the MTK command datasheet and use a checksum calculator
// such as the awesome http://www.hhhh.org/wiml/proj/nmeaxor.html
2012-03-28 19:14:32 +01:00
#define PMTK_LOCUS_STARTLOG "$PMTK185,0*22"
#define PMTK_LOCUS_LOGSTARTED "$PMTK001,185,3*3C"
2012-03-27 22:56:07 +01:00
#define PMTK_LOCUS_QUERY_STATUS "$PMTK183*38"
2012-09-08 01:25:48 +01:00
#define PMTK_LOCUS_ERASE_FLASH "$PMTK184,1*22"
2012-03-28 19:14:32 +01:00
#define LOCUS_OVERLAP 0
#define LOCUS_FULLSTOP 1
2012-03-27 22:56:07 +01:00
2012-11-09 17:01:23 +00:00
// standby command & boot successful message
#define PMTK_STANDBY "$PMTK161,0*28"
#define PMTK_STANDBY_SUCCESS "$PMTK001,161,3*3" // Not needed currently
#define PMTK_AWAKE "$PMTK010,002*2D"
2012-06-12 16:09:02 +01:00
// ask for the release and version
#define PMTK_Q_RELEASE "$PMTK605*31"
2012-03-27 22:56:07 +01:00
// request for updates on antenna status
#define PGCMD_ANTENNA "$PGCMD,33,1*6C"
2013-02-26 20:24:17 +00:00
#define PGCMD_NOANTENNA "$PGCMD,33,0*6C"
2012-03-28 19:14:32 +01:00
// how long to wait when we're looking for a response
#define MAXWAITSENTENCE 5
2012-03-27 22:56:07 +01:00
#if ARDUINO >= 100
#include "Arduino.h"
2012-11-03 23:27:41 +00:00
#if !defined(__AVR_ATmega32U4__)
2012-03-27 22:56:07 +01:00
#include "SoftwareSerial.h"
2012-11-03 23:27:41 +00:00
#endif
2012-03-27 22:56:07 +01:00
#else
#include "WProgram.h"
#include "NewSoftSerial.h"
#endif
class Adafruit_GPS {
public:
void begin(uint16_t baud);
2012-03-27 22:56:07 +01:00
2012-11-03 23:27:41 +00:00
#if ARDUINO >= 100
Adafruit_GPS(SoftwareSerial *ser); // Constructor when using SoftwareSerial
2012-03-27 22:56:07 +01:00
#else
Adafruit_GPS(NewSoftSerial *ser); // Constructor when using NewSoftSerial
2012-03-27 22:56:07 +01:00
#endif
Adafruit_GPS(HardwareSerial *ser); // Constructor when using HardwareSerial
2012-03-27 22:56:07 +01:00
char *lastNMEA(void);
boolean newNMEAreceived();
void common_init(void);
void sendCommand(char *);
void pause(boolean b);
boolean parseNMEA(char *response);
uint8_t parseHex(char c);
char read(void);
2012-03-27 22:56:07 +01:00
boolean parse(char *);
void interruptReads(boolean r);
2012-11-09 17:01:23 +00:00
boolean wakeup(void);
boolean standby(void);
2012-03-27 22:56:07 +01:00
uint8_t hour, minute, seconds, year, month, day;
uint16_t milliseconds;
float latitude, longitude, geoidheight, altitude;
float speed, angle, magvariation, HDOP;
char lat, lon, mag;
boolean fix;
uint8_t fixquality, satellites;
2012-03-28 19:14:32 +01:00
boolean waitForSentence(char *wait, uint8_t max = MAXWAITSENTENCE);
boolean LOCUS_StartLogger(void);
boolean LOCUS_ReadStatus(void);
uint16_t LOCUS_serial, LOCUS_records;
uint8_t LOCUS_type, LOCUS_mode, LOCUS_config, LOCUS_interval, LOCUS_distance, LOCUS_speed, LOCUS_status, LOCUS_percent;
2012-03-27 22:56:07 +01:00
private:
boolean paused;
uint8_t parseResponse(char *response);
#if ARDUINO >= 100
SoftwareSerial *gpsSwSerial;
#else
NewSoftSerial *gpsSwSerial;
#endif
HardwareSerial *gpsHwSerial;
};
#endif