Getting started with Franson GpsGate 2.0

Transcription

1 Franson GpsGate Franson Technology AB, All rights reserved User's Guide Franson GpsGate v2.0 for Windows Getting started with Franson GpsGate 2.0 How you install GpsGate. And how you setup GpsGate using the Wizard. In most cases this is all you need to read. License Key How to enter the license key. GPS status information How to see if everything is working. GPS simulator and Logger GPS Simulator How to simulate a GPS for presentations, development and similar indoor activites. GPS/NMEA Logger GPS/NMEA Logger. How to record and replay data from your GPS. Manual configuration of GpsGate Using a Garmin GPS as input How to connect a Garmin GPS to GpsGate. Using a Bluetooth GPS as input How to connect a Bluetooth GPS to GpsGate. Using a (NMEA) GPS as input How to connect a NMEA GPS to GpsGate. Connect a GPS application to GpsGate How to connect a GPS application to GpsGate. Connect nroute to GpsGate How to connect nroute to GpsGate. Some sample setups: Use your Ipaq hw6515, Ipaq hw6915 as a USB GPS Use Ipaq hw6515 or Ipaq hw6915 as a Bluetooth GPS Advanced usage of GpsGate Connecting Google Earth to GpsGate! How to display your GPS position in Google Earth. Connecting Google Maps to GpsGate! How to display your GPS position in Google Maps. Sharing GPS data over a network and between computers (1 of 38) :35:42

2 How to share GPS data using TCP/IP, UDP, Bluetooth or COM ports. NMEA MUX - combine multiple inputs How to merge and split several NMEA channels. Run GpsGate as a Service How to set up GpsGate to run as a NT service. Some more advanced features in GpsGate How to run multiple instances of GpsGate, close input when no output is used, block writing and reading, and more... Click here for the GpsGate 1.10 user's guide Click here for the GpsGate 1.03 user's guide Technical support can be found in the user forum. We will constantly monitor and answer questions in the forum. The forum also includes frequently asked question (FAQ). FAQ for GpsGate Browse the Technical support forum! Search the Technical support forum! Getting started with GpsGate The main purpose of GpsGate is to share one GPS between several GPS applications running at the same time. In its simplest form GpsGate is very easy to install and setup for a novice user. For the more advanced user there are many other uses as well, like GPS simulator, Logger, protocol translation, sharing over ActiveSync and network sharing to just mention a few, the options for configuration and usage are endless. Install GpsGate for Windows GpsGate 2.0 can be installed on the same computer as GpsGate 1.1 For more information on how to upgrade from GpsGate 1.1 to GpsGate 2.0, please read this: How to upgrade from GpsGate Download GpsGate. 2. Run GpsGate.exe and go through the installation steps. If you get an error while running the installtion program you need to install "Microsoft Windows Installer" first (see below) NOTE! To run the installation program you must have "Microsoft Windows Installer" installed on your computer. This is already installed on Windows XP and Windows ME. But for earlier versions of Windows you need to download and install this update separately. Windows NT/2K Download More info Windows 9x Download More info Run GpsGate (2 of 38) :35:42

3 You can launch GpsGate under "Start->Programs->Franson GpsGate 2.0". The first time GpsGate is run a setup Wizard will start. The Wizard will help you to find your GPS and tell you how to connect your GPS applications to GpsGate. If you have had GpsGate 1.1 installed before the settings from 1.1 will be used in 2.0, and the Wizard will not run. Running the setup Wizard Make sure you turn your GPS on, and connect it to your computer, if it is a wireless Bluetooth GPS simply turn it on. To speed up the search you can uncheck the types of GPS receivers you do not want to search for. If you are unsure, keep all options checked. After this is done, click "Next" and the Wizard will scan your computer for a connected GPS. If you are an advanced user, click "Advanced setup..." for a setup process where you have complete control. You can always run the Wizard again from the Settings Dialog. Click Next. The Wizard will now start searching for a GPS. This can take some time. (3 of 38) :35:42

4 When the Wizard finds a GPS, a message dialog is displayed. Click "Yes" to accept the found GPS as input. If you have several GPS receivers connected, click "No" until GpsGate finds the receiver you want to use. If GpsGate won't find your GPS, you need to use "Advanced Setup..." Select Output and click "Next". If you are unsure, simply click "Next". (4 of 38) :35:42

5 The next screen displays a summary. It is importaint to save this summary. You can save it to a file and print it. You can also find the this information later in the Settings dialog (from the Tray menu). You connect Garmin applications like nroute to the first port in the list, and other NMEA applications to the remaining ports. You can only connect one application to one port at a time. If you need to create more ports you can do that from the Settings Dialog at any time. Now you can start your GPS applications and connect them to the ports created by GpsGate in the last step above. You can (5 of 38) :35:42

6 run all the GPS applications at the same time! When GpsGate is running it is displayed as a Tray Icon. By clicking on this icon you can access its functions. You can re-run the Wizard at any time by selecting clicking "Setup Wizard.." in the Settings dialog. Tray icon colors and shapes The tray icon always indicates the status of GpsGate. Here is a list of the possible displayed tray icons: No GPS or NMEA data is detected by GpsGate. Valid GPS data has been detected at the selected input, but the GPS data has no fix, that is it cannot determine its position (yet). A valid GPS position (fix) has been detected at the selected input. If the tray icon is not green your GPS application will not display/use a correct position. Back to index Install license key If you after 14 days trial want to continue using GpsGate you need to buy a license. If you have purchased a GpsGate Express license, please make sure you have GpsGate 1.10 (or later) installed. 1. First you need to purchase a license key. You will have the key delivered to you by directly after the purchase. You can make the purchase here. 2. Start GpsGate. If your trial period has expired you will have the dialog below displayed to you. If your trial period has not expired, select License Key from the GpsGate tray menu. (6 of 38) :35:42

7 3. Cut and paste your address (Windows only) and the license key you received by after your purchase. Then press OK. 4. The license key is now installed! Back to index GpsGate status Tray icon colors and shapes The tray icon always indicates the status of GpsGate. The status icon is also displayed in the Input tab of the Settings dialog. Here is a list of the possible displayed tray icons: No GPS or NMEA data is detected by GpsGate. Valid GPS data has been detected at the selected input, but the GPS data has no fix, that is it cannot determine its position (yet). A valid GPS position (fix) has been detected at the selected input. If the tray icon is not green your GPS application will not display/use a correct position. Detailed status for Input Open the Settings dialog from the Tray menu. In the Input tab, you can read out the status of the Input (GPS). The above line, marked with a red arrow, will display any errors or status messages. The line below displays information about which kind of data is coming in. (7 of 38) :35:42

8 Detailed status for Outputs Open the Output tab in the Settings dialog. By clicking on each item in the list of active Outputs, you can see its status, marked with red arrow in the picture below. Any error message will be shown here or any other useful status information. Here one GPS application is connected to Virtual COM4. (8 of 38) :35:42

9 Back to index GPS simulator License GpsGate Standard Version GpsGate 1.00 (and later) GPS Simulator To show the simulator window select "Simulator" from the GpsGate tray menu. NOTE! On Pocket PC you need to go to the Today screen to see the tray icon. You do that by selecting "Start- >Today" (9 of 38) :35:42

10 Use the Insert, Edit and Delete buttons to edit the list of waypoints. The simulator will act as a GPS traveling between the waypoints in the selected speed. NOTE! The waypoints should be entered in decimal degrees. You can use CoordTrans to convert coordinates from other coordinate systems. Use the File menu to save the waypoints to a file. The file can later be reloaded using "Open" To start the simulator click Start. NMEA data will now be sent out the virtual serial ports you defined under Settings. (10 of 38) :35:42

11 To stop the simulator click Stop Use the settings under "Advanced..." to control exactly which NMEA sentences will be used and in what paste they will be sent. If you don't know, just leave it at the default settings. Back to index License GpsGate Standard Version GpsGate 1.0 (and later) NMEA Logger The NMEA Logger can be used to record data from a GPS source (selected in the Settings window). And use it for later play back (or other custom use). Standard NMEA sentences are stored in the log file. Record data To start recording data from the GPS, you need to add a "File Recorder" to GpsGate's Output. Open the Settings dialog from the Tray menu and click on the "Output" tab. Then select "File Recorder / NMEA Filter" from the drop down, and click "Add". (11 of 38) :35:42

12 A dialog will open where you can select a file to save the GPS data to. A name derived from the current date and time will be suggested for you. By default log files are saved under "My Documents\GpsGate\GpsLog". Simply click "OK" if you are happy with the preselected file name. You can also select if you want a new log file to be created in a specified interval. GpsGate will in that case save the log files in the selected folder, and name them "Log YYYY-MM-DD HHMMSS.nmea". When you are happy with your settings, click "OK". (12 of 38) :35:42

13 Filter recorded data In the next step you can select how much of the data from the GPS you want to be saved. If you want all data to be saved, simply click "OK". If you have some knowledge of the NMEA format you can specify filters that blocks specific sentences and stores data in intervals, this will save disk space needed by your log files. Playback recorded data Open the "NMEA Logger" window from the Tray menu or from the Settings dialogs Input tab. To play back a log file. Click "Play" in the NMEA Logger window and select the log file to play back. If you check "Reset time" GpsGate will change the time stamp of the NMEA data to the current (UTC) time. "Repeat" will make GpsGate automatically restart the log file when it has reached its end. Use "Rewind" and "Forward" to change the playback speed. And use "+/- min" and "+/- hour" to browse back and forward in the log file. (13 of 38) :35:42

14 How to display your NMEA log file on Google Maps How to import your NMEA log file to Google Earth Back to index License GpsGate Express Version GpsGate 1.10 (and later) Using a Garmin GPS as input The USB version of Garmin GPS receivers (like Garmin 18) do not support NMEA, they only support Garmin's own protocol. Therefore very few GPS applications can use Garmin USB GPS receivers. GpsGate solves this problem! You can connect GpsGate to a Garmin USB GPS and GpsGate will make the Garmin GPS appear as a normal NMEA GPS connected to a serial port. And! You can connect any number of GPS applications to the GPS at the same time! Including nroute! Detecting Garmin GPS using the Wizard The easiest way to detect a Garmin GPS is to use the Setup Wizard. If you have already run the Wizard you can do it again by opening the Settings dialog and click "Setup Wizard..." More info on the Setup Wizard here. Manually detecting a Garmin USB GPS Open the Settings dialog from the Tray manu. Select "Garmin USB" from the drop down. Click "Open". If the GPS is connected and everything is working, thet GpsGate icon will turn yellow or green. More info here: GPS status information (14 of 38) :35:42

15 Manually detecting a Garmin Serial GPS (15 of 38) :35:42

16 Using a Garmin GPS in NMEA mode If you have configured your Garmin to use NMEA as protocol, please read this Using a (NMEA) GPS as input. Uploading and downloading waypoints, tracks and routes GpsGate does not support waypoints, tracks or routes. Back to index License GpsGate Express Version GpsGate 2.0 (and later) Bluetooth GPS This feature enables you to make a direct connection to a Bluetooth GPS, without the need to configure any Bluetooth (virtual) COM ports. This will make configuration much easier, and operation much more stable. For this to be possible you must either Bluetooth hardware that support the MIcrosoft or WidComm/BroadCom stacks. (GpsGate will automatically detect and informa you if this is the case or not.) Detection using the Wizard The easiest way to detect a Bluetooth GPS is to use the Setup Wizard. If you have already run the Wizard you can do it again by opening the Settings dialog and click "Setup Wizard..." (16 of 38) :35:42

17 More info on the Setup Wizard here. Manual detection Open the Settings dialog from the Tray manu. Select "Bluetooth GPS" from the drop down. Click "Open". A dialog now opens which you can use to select your Bluetooth GPS. (17 of 38) :35:42

18 If the GPS is connected and everything is working, thet GpsGate icon will turn yellow or green. More info here: GPS status information Connection using Bluetooth COM ports If the Bluetooth hardware on your computer doesn't support the Microsoft or WidComm stacks, you will need to connect GpsGate to a Bluetooth (virtual) COM port. This port is created by the Bluetooth driver that comes with your Bluetooth hardware. Using a COM port as input. Back to index License GpsGate Express Version GpsGate 1.0 (and later) Using serial port (NMEA) GPS as input Detecting a GPS using the Wizard The easiest way to detect a NMEA GPS is to use the Setup Wizard. If you have already run the Wizard you can do it again by opening the Settings dialog and click "Setup Wizard..." More info on the Setup Wizard here. Manually detecting a GPS Open the Settings dialog from the Tray manu. Select "COM Port" from the drop down. Click "Open". (18 of 38) :35:42

19 A dialog now opens from which you can use to select the port your GPS is connected to. If the GPS is connected and everything is working, thet GpsGate icon will turn yellow or green. More info here: GPS status (19 of 38) :35:42

20 information Back to index License GpsGate Express Version GpsGate 1.0 (and later) Connecting a GPS application to GpsGate What is a virtual port? A virtual port is a "fake" serial port that GpsGate creates. GPS applications (and other applications as well) can connect to this port and believe it is a real serial port. The GPS application will believe it is a real GPS. By creating virtual ports, you can have several GPS applications share one GPS. Create virtual ports using the Wizard The easiest way to create some virtual ports is by using the Setup Wizard. If you have already run the Wizard you can do it again by opening the Settings dialog and click "Setup Wizard..." More info on the Setup Wizard here. Manually creating virtual ports Open the Settings dialog from the Tray manu. Select the "Output" tab. Select "Virtual Port" from the drop down. Click "Add". (20 of 38) :35:42

21 A dialog now opens were you can select a virtual port to create. This is the port you should connect your GPS application to. Back to index License GpsGate Express Version GpsGate 2.0 (and later) Connect nroute to GpsGate Create virtual ports using the Wizard The easiest way to create some virtual ports is by using the Setup Wizard. If you have already run the Wizard you can do it again by opening the Settings dialog and click "Setup Wizard..." More info on the Setup Wizard here. Manually creating virtual ports Open the Settings dialog from the Tray manu. Select the "Output" tab. Select "Virtual Port / NMEA to Garmin" from the drop down. Click "Add". (21 of 38) :35:42

22 A dialog now opens were you can select a virtual port to create. This is the port you should connect your nroute or any other Garmin software to. Note that GpsGate does not support up and downloading of waypoints, routes and tracks. Back to index (22 of 38) :35:42

23 License GpsGate Express Version GpsGate 2.0 (or later) GpsGate PlugIn Pack 1.0 (or later) Connecting Google Earth to GpsGate With Franson GpsGate PlugIn Pack it is now possible to use GpsGate with Google Earth. GpsGate fills the gap between the GPS and Google Earth, and enables real-time GPS tracking in Google Earth. You need GpsGate 2.0 or later. This PlugIn is free for all users that has a licensed copy of GpsGate. 1. Setting up the Google Earth plugin To set up the Google Earth plugin, follow these steps: 1. Make sure you have GpsGate for Windows 2.0 or later installed. If not download here 2. Start by downloading the GpsGate PlugIn Pack from here and follow the install instructions. 3. Start Franson GpsGate 2.0 and open the output tab of the settings dialog. If the wizard appears when you start GpsGate, you can reach the settings dialog by clicking the "Advanced setup". Otherwise, you can reach the settings dialog by clicking on the GpsGate tray icon and then clicking "Settings". 4. To enable the real-time GPS tracking support in Google Earth, you need to add the "Google Earth" output in GpsGate. See image below. (23 of 38) :35:42

24 Figure 1 - selecting the Google Earth output in GpsGate. 5. When you have added the output, a settings dialog appears as illustrated in the image below. This dialog allows you to control parts of the tracking experience in Google Earth. See section 2 for more information on the configurable parameters. (24 of 38) :35:42

25 Figure 2 - the Google Earth plugin configuration dialog. 6. Check the "Start Google Earth automatically" checkbox. This will ensure that Google Earth is started as the plugin is activated, and that Google Earth is setup to receive the GPS data. Figure 3 - setting allowing you to start Google Earth when the Google Earth output is enabled. 7. Finally, click OK and Google Earth will be launched, if not already running, and will be tracking your position! 2. Plugin Settings This section explains more about how you can configure the Google Earth plugin to enable and disable various features. (25 of 38) :35:42

26 2.1. Camera Settings The Camera Settings group (see figure 4) allows you to control the viewing perspective used in Google Earth. If Follow placemark is checked, the camera will be locked onto the position marker, and the position marker will thus always be the centered in the view. When you check this item, you have the option to configure the parameters in the camera settings group. Figure 4 - the camera settings section. By changing these parameters, you can change how you follow the marker in Google Earth. If you do not wish to follow the marker, simply uncheck "Follow placemark" in the camera settings section. You can see some examples below. Tilt Altitude Angle The tilt determines the vertical angle of the camera, relative to the vertical axis. For instance, if you set this to 0, the camera will be aimed at the marker directly from above. If you set it to 65, you will get the angle illustrated above. The altitude, or more correctly range, determines the distance between the camera and the marker. If you increase this value, you will get further away from the marker. The picture above illustrates a range of 5000 meters. The angle setting determine the angle between the camera and the axis defined by the direction of travel (the bearing). The example above illustrates a 90 degree angle ("from the left"). To follow the marker from behind, set this to zero Misc Settings The Misc settings section (see figure 5) allows you to control how the GpsGate output should be started. GpsGate needs to let Google Earth know that there's data available by opening the correct kml-file. There are two options available: (26 of 38) :35:42

27 If you check "Start Google Earth automatically", Google Earth will be started and set to use the proper kml file as soon as the plugin is enabled. If Google Earth is already started, the kml file will simply be opened in Google Earth when the plugin is enabled. If you check "Open automatically if Earth is started", the GpsGate output will be opened in Google Earth only if Google Earth is already started. If Google Earth is not started, nothing will happen. If you uncheck both options above, you need to remove and add the plugin at a later point. Figure 5 - the misc settings section Appearance Settings The appearance section (see figure 6) lets you control the marker that displays your current position in Google Earth. The palette is an ordinary png image that generally contains a set of smaller icons. The icon is where you select an icon within the palette above that should be displayed in Google Earth. The name is the text that is displayed next to the marker in Google Earth. The Show Altitude option allows you to decide whether or not the altitude of the marker/track should be visible, or if it should be projected onto the ground. Figure 6 - the appearance settings section Track Settings The track settings allows you to configure whether or not a track should be visible in Google Earth, and if so, how it should look. If enabled, a tail will be drawn after the marker, indicating the points it has passed. (27 of 38) :35:42

28 Figure 7 - the track settings section. If "Enable track" is checked, there will be a track drawn after the marker. If not checked, none of the other settings will be available. The "Track Name" allows you to decide the name of the track, as it appears in the Places panel in Google Earth. "Track width" determines the width in pixels of the polygon representing the track. Note that tracks in Google Earth 3 are always 1 pixel wide. Track color determines the color of the polygon representing the track. Max points determines the maximum number of points that should be used. When this number is exceded, the oldest position will be removed. Thus, you can get a "tail" by setting this number fairly low. If you check "Show shadow" (only available if "Show altitude" is checked) you will get a flat track in addition to the one with altitude. This can be useful if you only want to see the position on the ground. Track with Shadow (28 of 38) :35:42

29 Example of a track with "Show shadow" checked. Notice that the elevated track is projected onto the ground, causing a flat reflection of the original track. Track with no shadow (29 of 38) :35:42

30 Example of a track without a shadow. Here, only the elevated track is visible, and no shadow is projected onto the ground. Back to index License GpsGate Express GpsGate (or later) Version GpsGate PlugIn Pack 1.1 (or later) Connecting Google Maps to GpsGate With Franson GpsGate PlugIn Pack, it is now possible to connect your GPS to Google Maps! GpsGate enables real-time tracking directly in your browser; at maps.google.com as well as maps in arbitrary web pages! Setting up GpsGate with Internet Explorer and Google Maps To connect Google Maps to your GPS, follow these steps: 1. Make sure you have GpsGate for Windows or later installed. If not download here 2. Start by downloading Franson GpsGate PlugIn Pack from here and follow the install instructions. (30 of 38) :35:42

31 3. Start GpsGate and add Google Maps to the output, as you can see in the image below. 4. When installed, the Franson GpsGate toolbar will be available in Internet Explorer. Restart Internet Explorer and enable the toolbar if not already enabled (see figure 1). 5. When the toolbar is visible, no buttons will initially be enabled (figure 2). Browse to a page that contains a Google map, e.g. maps.google.com or 6. Now the GpsGate icon will be enabled, as can be seen in figure 3. Clicking it will start GpsGate if not already started and connect Google Maps to your GPS. (31 of 38) :35:42

32 Figure 1 - Right click on the Internet Explorer Toolbar, and make sure "Franson GpsGate" is checked. Figure 2 - disabled GpsGate toolbar. No buttons will be enabled when you're browsing pages that doesn't contain a map. Figure 3 - enabled GpsGate toolbar. When browsing pages with maps, the GpsGate icon will be enabled. Clicking this will connect to GpsGate. Franson GpsGate toolbar buttons The GpsGate button will connect to GpsGate and start showing your position in the Google Map. If GpsGate is not started when when you click this button, it will be started. Note that if the Google Maps plugin is not added to the output of GpsGate, you need to add it. Clicking this button will cause the Google Map currently utilizing the GPS to get centered around the current GPS position. This of course assumes there's a valid GPS fix available to center around. If there are several maps available on the page, you can use this button to select a different map to use with the GPS. Simply click the button and then click on the map. Clicking this button will cause the selected Google Map to continuously center around the current GPS position as they become available. Design Guidelines (developers only!!) If you wish to include a Google Map on your page that should work with GpsGate, you need to use the Google Maps API Version 2. The quickest way to get a map up and running is to use the example available here, as illustrated below. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" " <html xmlns=" <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"/> <title>google Maps JavaScript API Example</title> <script src=" type="text/javascript"></script> <script type="text/javascript"> //<![CDATA[ function load() { if (GBrowserIsCompatible()) { var map = new GMap2(document.getElementById("map")); (32 of 38) :35:42

33 } } //]]> </script> </head> <body onload="load()" onunload="gunload()"> <div id="map" style="width: 500px; height: 300px"></div> </body> </html> Disclaimer This solution does not work on all Google Maps enabled sites. If you find a site that doesn't work, please report it to the web master of that site, and to us. If the web site follows our guide lines, it will work. Googles own web site maps.google.com is not based on Google's standard API. This means that this solution may stop working at any time if Google changes its implementation of maps.google.com (Note that this does not apply to third party web sites using Google Maps API). Back to index License GpsGate Standard Version GpsGate 2.0 (and later) Share GPS data over a network and between computers Franson GpsGate can be used to share one GPS connected to a Pocket PC or laptop to other computers connected to the same LAN. This can be useful if you have several computers in the same vehicle. On each computer running GpsGate you can in turn connect any number of GPS applications to GpsGate, everything running at the same time. Share GPS data over ActiveSync Select "ActiveSync" as Output on the sending computer and "ActiveSync" as Input on the receiving computer. (33 of 38) :35:42

34 Share GPS data over TCP/IP Select "TCP/IP Server" as Output on the sending computer and "TCP/IP Input" as Input on the receiving computer. Share GPS data over UDP Select "UDP Sender" as Output on the sending computer and "UDP Receiver" as Input on the receiving computer. Share GPS data over Bluetooth Select "Bluetooth Server" as Output on the sending computer and "Bluetoth GPS" as Input on the receiving computer. The "Bluetooth Server" will emulate a real Bluetooth GPS. You can connect any number of GPS applications to the "Bluetooth Server" over Bluetooth as it was a real GPS. Share GPS data over a COM port To share a GPS over a NULL modem between two computers. Select "COM Port" as Output on the sending computer and "COM Port" as Input on the receiving computer. Back to index License GpsGate Standard Version GpsGate 2.0 (and later) NMEA MUX - Using several inputs to GpsGate You need to click "Show more options..." in the Advanced tab to for all features described below. What is a NMEA MUX? This feature is useful if you have several devices that generate NMEA data, and you want to combine the data from those devices. This can for example be AIS + GPS data. GpsGate can combine NMEA input from several inputs and merge it into one stream. This stream can typically be streamed over a network using UDP or TCP/IP. And it can be received and split up again at some other computer by GpsGate. Another option is to merge a set of NMEA inputs and stream it to one virtual port to which a GPS/NMEA application is connected that can handle the merged stream of NMEA data. The merged stream can also be saved by the GPS/NMEA Logger for later replay. Setting up the inputs Open the Input tab in the Settings dialog. Select "Use multiple inputs (MUX)". Then add all inputs you want to collect NMEA data from. Note that you can add an NMEA filter to each input. (34 of 38) :35:42

35 Setting up the Outputs Open the Output tab. Add all Outputs you want to forward NMEA data to. Note that some of the Output plugins like "Virtual Port / NMEA Filter" and "UDP Sender / NMEA Filter" has filters you can use to selectively forward certain NMEA data. Very advanced: It is possible to add an NMEA Filter to any of the plugins like TCP/IP by editing the ggxml files you find in the "Chains" folder. (35 of 38) :35:42

36 Back to index License GpsGate Express Version GpsGate 2.0 (and later) Run GpsGate as a Service This option works on Windows NT, 2000 and XP The benefits of running GpsGate as a service is that no user needs to be logged into the computer for GpsGate to run. GpsGate will start up at boot and run in the background for all users that logs in. Configure GpsGate service When GpsGate is started as a service it cannot be configured. You need to start GpsGate as an EXE to configure it. After you are happy with its configuration you can start GpsGate as a service. When running as a service GpsGate must be using shared settings. ("Share settings for all user accounts" must be selected in the Advanced tab of the Settings dialog.) For more info about shared settings read Where settings files are saved. Also note that you can copy settings between different computers by copying the "Instances" folder. (36 of 38) :35:42

37 Start GpsGate service Make sure GpsGate is not running. Then select Start -> Programs -> Franson GpsGate 2.0 -> Run GpsGate as Service Click on "Start Service" to activate GpsGate as a service and "Stop Service" to deactivate it. The GpsGate service can also be managed from the Control Panel as all services can. Back to index Advanced features in GpsGate You need to click "Show more options..." in the Advanced tab to for all features described below. Where settings files are saved By default are settings saved under "My Documents\GpsGate\Instances". This means each user account on one computer will have separate settings. If you want all users on the same computer to share the same settings, goto the Advanced tab in the Settings dialog. Click on "Show more options", and then check "Share settings for all user accounts". You need to restart GpsGate for the settings to take effect. Now the settings are saved under "\Program Files\Franson\GpsGate 2.0\Instances" which is the same directory where GpsGate 2.0 is installed. You need to configure GpsGate again if no previous settings are saved at the new location. You can run the Wizard again, configure GpsGate manually, or copy the "Instances" directory from the old location. GpsGate will never delete any settings when making this change. You must be logged in as administrator to make this change, and to configure GpsGate in shared mode. GpsGate 1.1 saved its settings in the registry. GpsGate 2.0 will try to import the GpsGate 1.1 settings if found the first time GpsGate 2.0 is started. After this first import, GpsGate 2.0 will not try this import again. Close input when nothing is connected to outputs To save battery on a Bluetooth GPS it can be a good thing to close the GPS input connection when no GPS application is connected to the output anyway. You can enabled this option by selecting "Close input when no outputs are opened" in the Input tab of the Settings dialog. By default it is turned off. You need to click "Show more options..." in the Advanced tab to see this option. Block data to and from Output By default all data written to an Output. For example data written back to a virtual port by an application is also written back to the Input (GPS). You can block data from a specific Output by selecting "Block data from Output" before you add the Output (37 of 38) :35:42

38 plugin. In a similar way you can select "Block data to Output". Multiple instances GpsGate 2.0 can be run in multiple instances. This means GpsGate can handle several GPS receivers as inputs and route its data to different places. GpsGate can also be used to route none GPS data. All Input and Output plugins that do not have a filter will pass all kind of data through. Go to the "Advanced" tab in the Settings dialog. There you can create, select, rename and delete instances. The settings for each instance will be saved under a new sub folder in the "Instances" folder. You can route data beween the different instances. The NMEA logger and GPS simulator can be used for each instance. Activate and deactivate an instance When using several instances it can be convenient to deactive and activate them. By unchecking "Active" in the "Advanced" tab an instance will be deactivated, and all its inputs and outputs will be closed until the instance is activated again, or the Input is opened manually again. Back to index GpsGate error tracking Back to index GpsGate for Developers Back to index Franson Technology AB, All rights reserved (franson.com) (38 of 38) :35:42