Skip to content

Commit

Permalink
Docs: Add Windows GIS
Browse files Browse the repository at this point in the history
  • Loading branch information
@nseidle
nseidle committed Jun 11, 2024
1 parent 71fcc81 commit e308d5e
Show file tree
Hide file tree
Showing 3 changed files with 63 additions and 35 deletions.
36 changes: 1 addition & 35 deletions docs/gis_software_android.md
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Anrdoid
# Android

Torch: ![Feature Supported](img/Icons/GreenDot.png)

Expand Down Expand Up @@ -124,40 +124,6 @@ Select the Positioning Menu. Then, with your RTK device on and in normal mode (n

Once connected exit out of the menus and see position information within your project.

## QGIS

QGIS is a free and open-source geographic information system software for desktops. It's available [here](https://qgis.org/).

Once the software is installed open QGIS Desktop.

![View Menu](img/QGIS/SparkFun%20RTK%20QGIS%20-%20View%20Menu.png)

Open the View Menu, then look for the 'Panels' submenu.

![Panels submenu](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Enable%20GPS%20Info%20Panel.png)

From the Panels submenu, enable 'GPS Information'. This will show a new panel on the left side.

At this point, you will need to enable *TCP Server* mode on your RTK device from the [WiFi Config menu](menu_wifi.md). Once the RTK device is connected to local WiFi QGIS will be able to connect to the given IP address and TCP port.

![Select GPSD](img/QGIS/SparkFun%20RTK%20QGIS%20-%20GPS%20Panel.png)

Above: From the subpanel, select 'gpsd'.

![Entering gpsd specifics](img/QGIS/SparkFun%20RTK%20QGIS%20-%20GPS%20Panel%20Entering%20IP%20and%20port.png)

Enter the IP address of your RTK device. This can be found by opening a serial connection to the device. The IP address will be displayed every few seconds. Enter the TCP port to use. By default an RTK device uses 2947.

Press 'Connect'.

![Viewing location in QGIS](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Location%20on%20Map.png)

The device location will be shown on the map. To see a map, be sure to enable OpenStreetMap under the XYZ Tiles on the Browser.

![Connecting over Serial](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Direct%20Serial%20Connection.png)

Alternatively, a direct serial connection to the RTK device can be obtained. Use a USB cable to connect to the RTK device. See [Output GNSS Data over USB](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/menu_ports/#output-gnss-data-over-usb) for more information.

## Survey Master

[Survey Master](https://www.comnavtech.com/companyfile/4/) by ComNam / SinoGNSS is an Android-based option. The download location can vary so google 'Survey Master ComNav Download' if the link above fails. Download the zip file, send the APK file to a phone and install the program.
Expand Down
61 changes: 61 additions & 0 deletions docs/gis_software_windows.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Windows

Torch: ![Feature Supported](img/Icons/GreenDot.png)

There are a variety of 3rd party apps available for GIS and surveying. We will cover a few examples below that should give you an idea of how to get the incoming NMEA data into the software of your choice.

## QGIS

QGIS is a free and open-source geographic information system software for desktops. It's available [here](https://qgis.org/).

Once the software is installed open QGIS Desktop.

![View Menu](img/QGIS/SparkFun%20RTK%20QGIS%20-%20View%20Menu.png)

Open the View Menu, then look for the 'Panels' submenu.

![Panels submenu](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Enable%20GPS%20Info%20Panel.png)

From the Panels submenu, enable 'GPS Information'. This will show a new panel on the left side.

At this point, you will need to enable *TCP Server* mode on your RTK device from the [WiFi Config menu](menu_wifi.md). Once the RTK device is connected to local WiFi QGIS will be able to connect to the given IP address and TCP port.

![Select GPSD](img/QGIS/SparkFun%20RTK%20QGIS%20-%20GPS%20Panel.png)

Above: From the subpanel, select 'gpsd'.

![Entering gpsd specifics](img/QGIS/SparkFun%20RTK%20QGIS%20-%20GPS%20Panel%20Entering%20IP%20and%20port.png)

Enter the IP address of your RTK device. This can be found by opening a serial connection to the device. The IP address will be displayed every few seconds. Enter the TCP port to use. By default an RTK device uses 2947.

Press 'Connect'.

![Viewing location in QGIS](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Location%20on%20Map.png)

The device location will be shown on the map. To see a map, be sure to enable OpenStreetMap under the XYZ Tiles on the Browser.

![Connecting over Serial](img/QGIS/SparkFun%20RTK%20QGIS%20-%20Direct%20Serial%20Connection.png)

Alternatively, a direct serial connection to the RTK device can be obtained. Use a USB cable to connect to the RTK device. See [Output GNSS Data over USB](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/menu_ports/#output-gnss-data-over-usb) for more information.

## Other GIS Packages

Hopefully, these examples give you an idea of how to connect the RTK product line to most any GIS software. If there is other GIS software that you'd like to see configuration information about, please open an issue on the [RTK Firmware repo](https://github.com/sparkfun/SparkFun_RTK_Everywhere_Firmware/issues) and we'll add it.

## What's an NTRIP Caster?

In a nutshell, it's a server that is sending out correction data every second. There are thousands of sites around the globe that calculate the perturbations in the ionosphere and troposphere that decrease the accuracy of GNSS accuracy. Once the inaccuracies are known, correction values are encoded into data packets in the RTCM format. You, the user, don't need to know how to decode or deal with RTCM, you simply need to get RTCM from a source within 10km of your location into the RTK device. The NTRIP client logs into the server (also known as the NTRIP caster) and grabs that data, every second, and sends it over Bluetooth to the RTK device.

## Where do I get RTK Corrections?

Be sure to see [Correction Sources](correction_sources.md).

Don't have access to an NTRIP Caster or other RTCM correction source? There are a few options.

The [SparkFun RTK Facet L-Band](https://www.sparkfun.com/products/20000) gets corrections via an encrypted signal from geosynchronous satellites. This device gets RTK Fix without the need for a WiFi or cellular connection.

Also, you can use a 2nd RTK product operating in Base mode to provide the correction data. Check out [Creating a Permanent Base](permanent_base.md).

If you're the DIY sort, you can create your own low-cost base station using an ESP32 and a ZED-F9P breakout board. Check out [How to Build a DIY GNSS Reference Station](https://learn.sparkfun.com/tutorials/how-to-build-a-diy-gnss-reference-station).

There are services available as well. [Syklark](https://www.swiftnav.com/skylark) provides RTCM coverage for $49 a month (as of writing) and is extremely easy to set up and use. [Point One](https://app.pointonenav.com/trial?utm_source=sparkfun) also offers RTK NTRIP service with a free 14 day trial and easy to use front end.
1 change: 1 addition & 0 deletions mkdocs.yml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -132,6 +132,7 @@ nav:
- GIS Software:
- gis_software_android.md
- gis_software_ios.md
- gis_software_windows.md
- Configuration Methods:
- configure_with_bluetooth.md
- configure_with_serial.md
Expand Down

0 comments on commit e308d5e

Please sign in to comment.