GNSS RTK 5 Click
GNSS RTK 5 Click demo application is developed using the NECTO Studio, ensuring compatibility with mikroSDK's open-source libraries and tools. Designed for plug-and-play implementation and testing, the demo is fully compatible with all development, starter, and mikromedia boards featuring a mikroBUS™ socket.
Click Library
- Author : Stefan Filipovic
- Date : Oct 2024.
- Type : UART type
Software Support
Example Description
This example demonstrates the use of GNSS RTK 5 Click by reading and displaying the GNSS coordinates.
Example Libraries
- MikroSDK.Board
- MikroSDK.Log
- Click.GNSSRTK5
Example Key Functions
- gnssrtk5_cfg_setup Config Object Initialization function.
void gnssrtk5_cfg_setup(gnssrtk5_cfg_t *cfg)
GNSS RTK 5 configuration object setup function.
GNSS RTK 5 Click configuration object.
Definition gnssrtk5.h:172
- gnssrtk5_init Initialization function.
err_t gnssrtk5_init(gnssrtk5_t *ctx, gnssrtk5_cfg_t *cfg)
GNSS RTK 5 initialization function.
GNSS RTK 5 Click context object.
Definition gnssrtk5.h:148
- gnssrtk5_cmd_run This function parses the GGA data from the read response buffer.
void gnssrtk5_cmd_run(gnssrtk5_t *ctx, uint8_t *cmd)
GNSS RTK 5 cmd run function.
- gnssrtk5_parse_gga This function parses the GGA data from the read response buffer.
err_t
gnssrtk5_parse_gga ( uint8_t *rsp_buf, uint8_t gga_element, uint8_t *element_data );
err_t gnssrtk5_parse_gga(uint8_t *rsp_buf, uint8_t gga_element, uint8_t *element_data)
GNSS RTK 5 parse GGA function.
- gnssrtk5_generic_read This function reads a desired number of data bytes by using UART serial interface.
err_t gnssrtk5_generic_read(gnssrtk5_t *ctx, uint8_t *data_out, uint16_t len)
GNSS RTK 5 data reading function.
Application Init
Initializes the driver, resets the Click board, reads the module version and config, and enables the NMEA GNGGA message output.
{
log_cfg_t log_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_printf( &logger, ">>> Reset device.\r\n" );
log_printf( &logger, ">>> Get module version.\r\n" );
log_printf( &logger, ">>> Get module config.\r\n" );
log_printf( &logger, ">>> Enable GNGGA output.\r\n" );
gnssrtk5_clear_app_buf( );
log_info( &logger, " Application Task " );
}
#define GNSSRTK5_RSP_COMMAND
Definition gnssrtk5.h:82
#define GNSSRTK5_CMD_GET_VERSION
GNSS RTK 5 commands string.
Definition gnssrtk5.h:73
#define GNSSRTK5_CMD_GET_CONFIG
Definition gnssrtk5.h:74
#define GNSSRTK5_RSP_RESET
GNSS RTK 5 response buffer commands.
Definition gnssrtk5.h:81
#define GNSSRTK5_CMD_ENABLE_GGA
Definition gnssrtk5.h:75
#define GNSSRTK5_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition gnssrtk5.h:132
void gnssrtk5_reset_device(gnssrtk5_t *ctx)
GNSS RTK 5 reset device function.
void application_init(void)
Definition main.c:92
Application Task
Reads the received data, parses the NMEA GGA info from it, and once it receives the position fix it will start displaying the coordinates on the USB UART.
{
{
{
gnssrtk5_parser_application( app_buf );
}
}
}
@ GNSSRTK5_OK
Definition gnssrtk5.h:198
#define GNSSRTK5_RSP_GGA
Definition gnssrtk5.h:86
#define GNSSRTK5_GGA_ELEMENT_SIZE
GNSS RTK 5 GGA command elements.
Definition gnssrtk5.h:92
void application_task(void)
Definition main.c:139
Application Output
This Click board can be interfaced and monitored in two ways:
- Application Output - Use the "Application Output" window in Debug mode for real-time data monitoring. Set it up properly by following this tutorial.
- UART Terminal - Monitor data via the UART Terminal using a USB to UART converter. For detailed instructions, check out this tutorial.
Additional Notes and Information
The complete application code and a ready-to-use project are available through the NECTO Studio Package Manager for direct installation in the NECTO Studio. The application code can also be found on the MIKROE GitHub account.