Enable GPS receiver on the Starter Kit

October 9, 2020
TeamViewer IoT Documentation

The TeamViewer IoT Starter Kit contains a built-in GPS receiver.

What you will need

Make sure that you have prepared the following points:

Enable

  1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
  2. Install the needed dependencies for python. In the terminal type in the following commands and press return:
sudo apt-get update
sudo apt-get install -y python3-pip
  1. Download the Starter Kit configuration package. In the terminal type in the following commands and press return:
wget -q https://download.teamviewer-iot.com/teamviewer-iot-kit/v2.0.1/teamviewer_iot_kit-2.0.1-py3-none-any.whl
sudo -H pip3 install teamviewer_iot_kit-2.0.1-py3-none-any.whl
  1. Configure the location receiver. In the terminal type in the following command and press return.
sudo teamviewer-iot-kit -e location_receiver
  1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
  2. Check that you enabled the GPS. From the left menu select Inventory and on the right side from the drop-down-menu select Metrics.

After the GPS receiver has been enabled you can visualize its data with a widget.

More Information

  • The GPS data is NMEA 0183 formatted and packed into a JSON object called NMEA 0183: TPV. In the “Metrics” tab you will find the data in the raw format as well as dedicated metrics for each parameter.
  • The location receiver provides the NMEA 0183: SKY object as well which is not presented in the Starter Kit. From that object, two metrics are being calculated and presented separately with the names In View and Used.

The table represents all the available parameters/metrics and their descriptions of the location receiver.

Metric/ParameterAlwaysDatatypeDescription
TimeNostringTime/date stamp in ISO8601 format, UTC. May have a fractional part of up to .001sec precision. May be absent if the mode is not 2 or 3.
NMEA 0183: TPVYesstringNMEA 0183 formatted JSON data of the TPV class.
ModeYesnumericNMEA mode: %d, 0=no mode value yet seen, 1=no fix, 2=2D, 3=3D.
Estimated timestamp errorNonumericEstimated timestamp error in seconds. Present if time is present.
LatitudeNonumericLatitude in degrees: +/- signifies  North/South.  Present  when the mode  is 2 or 3.
Estimated latitude errorNonumericLatitude error estimate in meters. Present if the mode is 2 or 3 and DOPs can be calculated from the satellite view.
LongitudeNonumericLongitude in degrees: +/- signifies East/West. Present when the mode is 2 or 3.
Estimated longitude errorNonumericLongitude error estimate in meters. Present if the mode is 2D or 3D and DOPs can be calculated from the satellite view.
AltitudeNonumericAltitude in meters. Present if the mode is 3.
Estimated vertical errorNonumericEstimated vertical error in meters. Present if the mode is 3 and DOPs can be calculated from the satellite view.
SpeedNonumericSpeed over ground, meters per second.
Estimated speed errorNonumericEstimated speed error in meters per second. Present for consecutive 2D or 3D fixes.
ClimbNonumericClimb (positive) or sink (negative) rate, meters per second.
Estimated vertical errorNonumericEstimated climb error in meters per second. Present if consecutive 3D fixes.
TrackNonumericCourse over ground, degrees from true north.
In ViewNonumericNumber of satellites which are in view of the location receiver.
UsedNonumericNumber of satellites to which the location receiver is locked.

Related posts

Want more? Exclusive deals, the latest news: Our Newsletter!