Library Description

Library provides function for controlling GPIO, sending commands over UART module. There is generic parser that can parse response of specific command that device is sending, buffer for parser is getting data from process function that sends one byte of data to buffer, and there is function for clearing that buffer.

Key functions:

• uint8_t nanogps2_generic_parser ( char *command, uint8_t element, char *parser_buf ) - Generic parser function
• void nanogps2_process ( char temp ) - Process function that adds byte data to buffer for parsing
• void nanogps2_clear_rsp_buf ( void ) - Function for clearing buffer for parsing

Examples description

The application is composed of three sections :

• System Initialization - Initialization of UART module and additional pins
• Application Initialization - UART interrupt initialization
• Application Task - Parsing RX data and logs GPS data if there is some every 2sec and then clears buffer.

void application_task ( )
{
    error_flag = NANOGPS2_DEV_OK;
    error_flag |= nanogps2_generic_parser( NANOGPS2_GNGGA_DATA_CMD,
                                           NANOGPS2_GNGGA_LONGITUDE,
                                           &p_lon[ 0 ] );
    error_flag |= nanogps2_generic_parser( NANOGPS2_GNGGA_DATA_CMD,
                                           NANOGPS2_GNGGA_LATITUDE,
                                           &p_lat[ 0 ] );
    error_flag |= nanogps2_generic_parser( NANOGPS2_GNGGA_DATA_CMD,
                                           NANOGPS2_GNGGA_ALTITUDE,
                                           &p_alt[ 0 ] );

    if ( ( NANOGPS2_DEV_OK == error_flag ) &&
         ( p_lon[0] != 0 ) && ( p_lat[0] != 0 ) && ( p_alt[0] != 0 ) )
    {
        mikrobus_logWrite( " - Latitude: ", _LOG_TEXT );
        mikrobus_logWrite( p_lat, _LOG_LINE );
        mikrobus_logWrite( " - Longitude: ", _LOG_TEXT );
        mikrobus_logWrite( p_lon, _LOG_LINE );
        mikrobus_logWrite( " - Altitude: ", _LOG_TEXT );
        mikrobus_logWrite( p_alt, _LOG_LINE );
        mikrobus_logWrite( "-------------------------------------", _LOG_LINE );
        memset( &p_lat[ 0 ], 0, 50 );
        memset( &p_lon[ 0 ], 0, 50 );
        memset( &p_alt[ 0 ], 0, 50 );
    }
    
    if ( NANOGPS2_DEV_OK == error_flag )
    {
        nanogps2_clear_rsp_buf(  );
    }
}

Other mikroE Libraries used in the example:

• CString
• UART

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 click or RS232 click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.