Adafruit_GPS Class

Adafruit_GPS Class

Description
A class used to handle GPS module on Ameba.

Syntax
class Adafruit_GPS

Members

Public Constructors 
Adafruit_GPS::Adafruit_GPSConstructs an Adafruit_GPS object.
Public Methods 
Adafruit_GPS::beginInitialize serial communication.
*Adafruit_GPS::lastNMEAGet the last National Marine Electronics Association (NMEA) line received and set the received flag to false.
Adafruit_GPS::newNMEAreceivedCheck to see if a new NMEA line has been received.
Adafruit_GPS::common_initInitialization code used by all constructor types.
Adafruit_GPS::sendCommandSend a command to the GPS device.
Adafruit_GPS::pausePause/ resume receiving new data.
Adafruit_GPS::parseHexRead a Hexadecimal value and convert into decimal value.
Adafruit_GPS::readRead one character from the GPS device.
Adafruit_GPS::parseParse data such as latitude, longitude, speed, angle, etc.
Adafruit_GPS::wakeupWake the sensor up.
Adafruit_GPS::standbyStandby Mode Switches.
Adafruit_GPS::waitForSentenceWait for a specified sentence from the device.
Adafruit_GPS::LOCUS_StartLoggerStart the LOCUS logger.
Adafruit_GPS::LOCUS_StopLoggerStop the LOCUS logger.
Adafruit_GPS::LOCUS_ReadStatusRead the logger status.

Adafruit_GPS::Adafruit_GPS

Description
Constructs an Adafruit_GPS object and initialize serial using a SoftwareSerial object.

Syntax
Adafruit_GPS(SoftwareSerial *ser);
Adafruit_GPS(HardwareSerial *ser);

Parameters
ser: a Serial instance.

Returns
NA

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)
This example code from Adafruit demonstrates GPS modules using MTK3329/MTK3339 driver. This code shows how to listen to the GPS module in an interrupt which allows the program to have more ‘freedom’ – just parse when a new NMEA sentence is available! Then access data when desired.

Notes and Warnings
IMPORTANT: SoftSerial is using hardware serial so pin mapping cannot be altered.
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::begin

Description
Initialize a serial communication.

Syntax
void begin(uint16_t baud);

Parameters
baud: serial baud rate.

Returns
NA

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

*Adafruit_GPS::lastNMEA

Description
Get the last National Marine Electronics Association (NMEA) line received and set the received flag to false.

Syntax
char *lastNMEA(void);

Parameters
NA

Returns
This function returns a pointer to the last line of the string.

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::newNMEAreceived

Description
Check if a new NMEA line has been received.

Syntax
boolean newNMEAreceived(void);

Parameters
NA

Returns
This function returns true if a new NMEA line has been received. Otherwise, false.

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::common_init

Description
Initialization code used by all constructor types.

Syntax
void common_init(void);

Parameters
NA

Returns
NA

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::sendCommand

Description
Send a command to the GPS device.

Syntax
void sendCommand(const char *str);

Parameters
str: Pointer to a string holding the command to send.

Returns
NA

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::pause

Description
Pause/ resume receiving new data.

Syntax
void pause(boolean p);

Parameters
p: True = pause, False = resume.

Returns
NA

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::parseHex

Description
Read a Hexadecimal value and convert into decimal value.

Syntax
uint8_t parseHex(char c);

Parameters
c: Hexadecimal value

Returns
This function returns the decimal equivalent of the Hexadecimal value.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::read

Description
Read one character from the GPS device.

Syntax
char read(void);

Parameters
NA

Returns
The function returns the character that we received or returns 0 if nothing was received.

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::parse

Description
Parse data such as latitude, longitude, speed, angle, etc.

Syntax
boolean parse(char *nmea);

Parameters
nmea: an NMEA string

Returns
This function returns true if there are valid data to be parsed, false if it has invalid data.

Example Code
Example: Adafruit_GPS_parsing
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SoftwareSerial/examples/Adafruit_GPS_parsing/Adafruit_GPS_parsing.ino)

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::wakeup

Description
Wake the sensor up.

Syntax
boolean wakeup(void);

Parameters
NA

Returns
This function returns true if the sensor is awake, otherwise return false if the sensor is not on standby or failed to wake.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::standby

Description
Standby mode switches.

Syntax
boolean standby(void);

Parameters
NA

Returns
This function returns false if it is already in standby mode so that no commands need to be sent to the GPS to wake it up. Otherwise, returns true if it entered standby mode.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::waitForSentence

Description
Wait for a specified sentence from the device.

Syntax
boolean waitForSentence(const char *wait4me, uint8_t max);

Parameters
wait4me: Pointer to a string holding the desired response.
max: maximum duration to wait for the sentence, default value: 5.

Returns
This function returns true if we the sentence is received, otherwise returns false.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::LOCUS_StartLogger

Description
Start the LOCUS logger.

Syntax
boolean LOCUS_StartLogger(void);

Parameters
NA

Returns
This function returns true if the logger starts successfully. Otherwise, returns false.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::LOCUS_StopLogger

Description
Stop the LOCUS logger.

Syntax
boolean LOCUS_StopLogger(void);

Parameters
NA

Returns
This function returns true if the logger stops successfully. Otherwise, returns false.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

Adafruit_GPS::LOCUS_ReadStatus

Description
Read the logger status

Syntax
boolean LOCUS_ReadStatus(void);

Parameters
NA

Returns
This function returns true if the logger reads the status successfully. Otherwise, returns false if there was no response.

Example Code
NA

Notes and Warnings
“Adafruit_GPS.h” must be included to use the class function.

請先確認已安裝QQ通訊軟體