gbxgarminacfr::Driver Class Reference

#include <driver.h>

List of all members.

Public Member Functions
	Driver (const Config &config, gbxutilacfr::Tracer &tracer, gbxutilacfr::Status &status, int serialDebugLevel=0)
std::auto_ptr< GenericData >	read ()

---

Detailed Description

Garmin GPS driver.

All Garmin receivers understand the latest NMEA standard which is called: 0183 version 2.0.

This standard dictates a transfer rate of 4800 baud.

This driver can read only the following messages (sentences):

• GPGGA: fix data
• PGRME: (estimated error) - not sent if set to 0183 1.5 (garmin-specific)
• GPVTG: vector track and speed over ground
• GPRMC: known as the "Recommended Minimum" sentence, is the most common sentence transmitted by GPS devices. This one sentence contains nearly everything a GPS application needs: latitude, longitude, speed, bearing, satellite-derived time, fix status and magnetic variation.

Processing of individual messages can be disabled in the Config structure.

Note that when fixType contained in the GPGGA is Invalid, all other data in all messages except the time stamps are meaningless.

Referennces:

• http://en.wikipedia.org/wiki/NMEA
• http://www.gpsinformation.org/dale/interface.htm

---

Constructor & Destructor Documentation

gbxgarminacfr::Driver::Driver	(	const Config &	config,
		gbxutilacfr::Tracer &	tracer,
		gbxutilacfr::Status &	status,
		int	serialDebugLevel = 0
	)

Constructor

gbxutilacfr::Tracer and gbxutilacfr::Status allow (human-readable and machine-readable respectively) external monitorining of the driver's internal state.

References gbxutilacfr::Tracer::debug(), gbxgarminacfr::Config::device, gbxgarminacfr::Config::isValid(), and gbxgarminacfr::Config::toString().

---

Member Function Documentation

std::auto_ptr< GenericData > gbxgarminacfr::Driver::read

(

)

Blocks till new data is available.

Throws gbxutilacfr::Exception when a problem is encountered.

std::auto_ptr<gbxgarminacfr::GenericData> data;

try {
    data = device->read();
}
catch ( const std::exception& e ) {
    cout <<"Test: Failed to read data: "<<e.what()<<endl;
} 

References gbxutilacfr::Tracer::debug(), gbxutilacfr::Tracer::error(), gbxgarminacfr::Config::ignoreUnknown, gbxgarminacfr::Config::readGga, gbxgarminacfr::Config::readRmc, gbxgarminacfr::Config::readRme, and gbxgarminacfr::Config::readVtg.

---

The documentation for this class was generated from the following files:

• gbxgarminacfr/driver.h
• gbxgarminacfr/driver.cpp