MikroElektronika GPS Click Element

The GPS click element is used to obtain GPS coordinates. This element is for using the MikroElektronika Nano GPS Click board.

NOTE: This click board is asynchronous. It’s constantly reading data from the GPS module and will execute the Location Received, Latitude Received, and Longitude Received triggers when a location is available.

This click board may take between several minutes to an hour to receive a GPS lock.

The GPS click is a sensor element that can be imported into the Element Toolbox through the Add Element Add Element button located in the toolbox from the Embedded tab.

Element Icon
GPS Click Element

Properties

The following properties can be changed for the GPS click element:

Name

The name of the element.

UART Driver Instance

The UART driver instance number to use.

GPIO Driver Instance

The GPIO driver instance number to use.

Power Pin

The GPIO pin connected to the power pin of the click board.

WUP Pin

The GPIO pin connected to the wake-up pin (WUP) of the click board.

Reset Pin

The GPIO pin connected to the reset pin of the click board.

Location Report Frequency (Hz)

Control the frequency of how often the GPS click reports its location once it’s locked onto a satellite.

Triggers

The following triggers are available to execute events from within the GPS click element:

Triggered

Execute an event when the source element connected to the GPS click triggers.

Location Received

Execute an event when the device’s GPS location is received. The GPS will send its current latitude and longitude in a ATMO_GPS_NANO_LocData_t structure. You can use a Function element to convert this data to a string as follows:

ATMO_Status_t Function_trigger(ATMO_Value_t *in, ATMO_Value_t *out) {
	ATMO_GPS_NANO_LocData_t locData;
	ATMO_GetBinary(in, &locData, sizeof(locData));
	char s[64];
	sprintf(s, "Lat: %.2f\r\nLong: %.2f\r\n", locData.latitude, locData.longitude);
	ATMO_CreateValueString(out, s);
	return ATMO_Status_Success;
}

Latitude Received

Execute an event when the board’s latitude coordinate is received. This will be a float value.

Longitude Received

Execute an event when the board’s longitude coordinate is received. This will be a float value.

Abilities

The following abilities are available for the GPS click element when its source element triggers:

Trigger

Trigger the element(s) that follow the GPS click element.