GNSS Report
=============
| Application name : ``gnss_report``

.. include:: ../_defs.rst

Overview
**********

The GNSS Report sample application is using the location report feature of the |CaaM| board.
This example requires additional hardware setup to work properly:
a push button and an LED need to be connected to the arduino board.
To wire up the hardware devices, follow the instruction in the :ref:`wiring_led_btn` topic.

The working principle of this application is to instruct the |CaaM| board to send location data to the cloud.
This is especially useful when the application mcu has limited resources because it does not need to handle
all the gnss data and build the cloud message. The type of the location event and the content of this event is preset, 
the application mcu can not change it.


Flashing
***********

To upload this application to an Arduino compatible board navigate to the examples and select the ``gnss_report`` from
the Embever IoT library in Arduino IDE. Upload the sketch to the board and see the result in the serial terminal.

Testing the Application
**************************
To test the application, the necessary hardware connections should be done (as mentioned before).
After powering up the device, the following information should appear in the serial terminal:

.. code-block:: none

    GNSS Report sample starting

To issue the location report command press the external button.
The following message will appear in the serial terminal:

.. code-block:: none

    Report request submitted

After some time (at maximum 5 minute), based on the result of the location report command
the following message will be sent to the serial terminal:

.. code-block:: none

    Location data sent to the cloud

In case of unsuccessful location report:

.. code-block:: none

    GPS fix timeout, location data not sent

To receive a valid position and other data, a suitable GPS signal quality must be present.