Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Digital Matter Site
  • Contact Us

Guppy Tilt - Small Changes from Vertical

Written by Matthew Clark-Massera

Updated at February 2nd, 2023

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Contact Support
  • Home
  • Devices
  • LoRaWAN®
  • Guppy LoRaWAN®

The tilt reporting feature in the Guppy, as of firmware v1.9, is explained in the Guppy Configuration and Usage Guide.

Here are some examples illustrating small changes from vertical/straight up.

This could be useful for checking an electrical box is still mounted correctly on a pole.

Straight up:

Starting in the straight up, or vertical, position. We expect gravity to align well with the negative Y axis. 

This position resulted in this payload: 

8c7fecdb

{
"type": "status",
"inTrip": false,
"batV": 2.98,
"temp": 23.5,
"manDown": false,
"inclinationDeg": 177,
"azimuthDeg": 328.5,
"xyz": {
"downUnit": [
-0.027345,
-0.9986,
0.04462
],
"azimuthDeg": [ left out ],
"inclinationDeg": [ left out ],
}
}

You can see the inclination angle at close to 180 degrees.

The azimuth angle is quite small and insignificant in this position.

Tilt right:

Now a tilt to the right.

This results in this payload:

8c80e054

Which decodes to:

{
"type": "status",
"inTrip": false,
"batV": 2.98,
"temp": 24,
"manDown": false,
"inclinationDeg": 168,
"azimuthDeg": 126,
"xyz": {
"downUnit": [
0.1682,
-0.9781,
-0.1222
],
"azimuthDeg": [ left out ],
"inclinationDeg": [ left out ],
}
}

Note the inclination angle changes to 168, which is 9 degrees different.

The azimuth angle is more significant in this position, but makes most sense when you consider the x,y,z axis. Note the positive 0.168 on the x axis. Keep that in mind for the next example.

Tilt left:

Now a tilt to the left.

This results in this payload:

8c7fe0ae

Which decodes to:

{
"type": "status",
"inTrip": false,
"batV": 2.98,
"temp": 23.5,
"manDown": false,
"inclinationDeg": 168,
"azimuthDeg": 261,
"xyz": {
"downUnit": [
-0.2054,
-0.9781,
-0.03252
],
"azimuthDeg": [ left out ],
"inclinationDeg": [ left out ],
}
}

Note the inclination angle changes is 168 again. The inclination angle is always 0-180 degrees. In this case we need the azimuth angle to understand which direction the Guppy is leaning.

As in the tilt right, the azimuth angle is significant in this position. Consider the x,y,z axis. Note the negative 0.205 on the x axis. This indicates the lean left, instead of right.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Guppy LoRaWAN® - Configuration and Usage Guide
  • Guppy LoRaWAN® Integration
  • Introduction to the Guppy LoRaWAN®

Subscribe to Partner News

Subscribe to our mailing list to receive Digital Matter news, product and tehnical updates, and more.

Subscribe

Copyright © Digital Matter . All Rights Reserved.

Privacy Contact Support

Knowledge Base Software powered by Helpjuice

Expand