About GPS ToolKit
Introduction
Purchasing GPS ToolKit
Redistributing GPS ToolKit
License Agreement
Support
Getting Started
How to Use GPS ToolKit
Adding GPS ToolKit to a Visual Basic Project
Adding GPS ToolKit to a Visual C++ Project
Adding GPS ToolKit to an Excel Worksheet
Setting up the GPS
How to Use Events
Handling Events in Visual Basic
Handling Events in Visual C++
Handling Events in Microsoft Excel
GPS ToolKit Sample Projects
Handling GPS ToolKit Errors
Reference
Properties
Altitude
AltitudeUnits
ArrivedAtDest
AutomaticOperation
BaudRate
CrossTrackError
DegLabel
DestClosingVelocity
DestWptID
DestWptLatitude
DestWptLongitude
DistUnits
DGPSRefStationID
FixDateTime
FixGood
FixQuality
FixSatellitePRNs
GeoidHeightAboveWGS84Ellipsoid
HDOP
Latitude
LatLonFormat
Longitude
MagVariation
MinLabel
ModeIndicator
NumSatellitesInFix
NumSatellitesInView
OperationMode
OrigToDestMagBearing
OrigToDestTrueBearing
OriginWptID
PDOP
PortHandle
PortName
RangeToDest
RouteContainsAllWpts
RouteName
SatelliteInViewPRNs
SecLabel
Speed
SpeedUnits
TimeSinceLastDGPSUpdate
TrueBearingToDest
TrueCourse
VDOP
WptsInRoute
Methods
Close
GetSatelliteInfo
GetWptLocation
Open
OpenFile
Events
FixUpdate
FileComplete
NavUpdate
RawDataReceived
SatelliteUpdate

Open Method

Opens the communications port and begins reading GPS data.

Syntax

Visual Basic

object.Openport

Visual C++

object.Open(port)

Part Description
object An object expression that evaluates to a GPS ToolKit object.
port A string containing the name of the communications port.

Example

Visual Basic

myGPSToolKit.Open "COM1"

Visual C++

m_myGPSToolKit.Open("COM1");

Remarks

Baud rate is set through the BaudRate property. The communications port is always with 8 data bits, no parity, and 1 stop bit.

Returns

Nothing

Errors

  • After opening a port using Open(), any subsequent call to Open() or OpenFile() will cause GPS ToolKit to throw a "Port or file is already open" exception.

  • An attempt to open a port that has already been opened by another application or that does not exist will cause GPS ToolKit to throw a "Could not open port. This may be because the port does not exist or it is already in use." exception.

See Also

BaudRate property, OpenFile method, Close method