/* / _____) _ | | ( (____ _____ ____ _| |_ _____ ____| |__ \____ \| ___ | (_ _) ___ |/ ___) _ \ _____) ) ____| | | || |_| ____( (___| | | | (______/|_____)_|_|_| \__)_____)\____)_| |_| (C)2013 Semtech-Cycleo Description: Minimum test program for the loragw_gps 'library' License: Revised BSD License, see LICENSE.TXT file include in the project Maintainer: Michael Coracin */ /* -------------------------------------------------------------------------- */ /* --- DEPENDANCIES --------------------------------------------------------- */ /* fix an issue between POSIX and C99 */ #if __STDC_VERSION__ >= 199901L #define _XOPEN_SOURCE 600 #else #define _XOPEN_SOURCE 500 #endif #include /* C99 types */ #include /* bool type */ #include /* printf */ #include /* memset */ #include /* sigaction */ #include /* exit */ #include /* read */ #include "loragw_hal.h" #include "loragw_spi.h" #include "loragw_gps.h" #include "loragw_aux.h" /* -------------------------------------------------------------------------- */ /* --- PRIVATE VARIABLES ---------------------------------------------------- */ static int exit_sig = 0; /* 1 -> application terminates cleanly (shut down hardware, close open files, etc) */ static int quit_sig = 0; /* 1 -> application terminates without shutting down the hardware */ struct tref ppm_ref; /* -------------------------------------------------------------------------- */ /* --- PRIVATE FUNCTIONS DECLARATION ---------------------------------------- */ static void sig_handler(int sigio); static void gps_process_sync(void); static void gps_process_coords(void); /* -------------------------------------------------------------------------- */ /* --- PRIVATE FUNCTIONS DEFINITION ----------------------------------------- */ void usage(void) { //printf("Library version information: %s\n", lgw_version_info()); printf("Available options:\n"); printf(" -h print this help\n"); printf(" -d COM path to be used to connect the concentrator\n"); } static void sig_handler(int sigio) { if (sigio == SIGQUIT) { quit_sig = 1;; } else if ((sigio == SIGINT) || (sigio == SIGTERM)) { exit_sig = 1; } } static void gps_process_sync(void) { /* variables for PPM pulse GPS synchronization */ uint32_t ppm_tstamp; struct timespec ppm_gps; struct timespec ppm_utc; /* variables for timestamp <-> GPS time conversions */ uint32_t x, z; struct timespec y; /* get GPS time for synchronization */ int i = lgw_gps_get(&ppm_utc, &ppm_gps, NULL, NULL); if (i != LGW_GPS_SUCCESS) { printf(" No valid reference GPS time available, synchronization impossible.\n"); return; } /* get timestamp for synchronization */ i = lgw_get_trigcnt(&ppm_tstamp); if (i != LGW_HAL_SUCCESS) { printf(" Failed to read timestamp, synchronization impossible.\n"); return; } /* try to update synchronize time reference with the new GPS & timestamp */ i = lgw_gps_sync(&ppm_ref, ppm_tstamp, ppm_utc, ppm_gps); if (i != LGW_GPS_SUCCESS) { printf(" Synchronization error.\n"); return; } /* display result */ printf(" * Synchronization successful *\n"); printf(" UTC reference time: %lld.%09ld\n", (long long)ppm_ref.utc.tv_sec, ppm_ref.utc.tv_nsec); printf(" GPS reference time: %lld.%09ld\n", (long long)ppm_ref.gps.tv_sec, ppm_ref.gps.tv_nsec); printf(" Internal counter reference value: %u\n", ppm_ref.count_us); printf(" Clock error: %.9f\n", ppm_ref.xtal_err); x = ppm_tstamp + 500000; printf(" * Test of timestamp counter <-> GPS value conversion *\n"); printf(" Test value: %u\n", x); i = lgw_cnt2gps(ppm_ref, x, &y); printf(" Conversion to GPS: %lld.%09ld\n", (long long)y.tv_sec, y.tv_nsec); i = lgw_gps2cnt(ppm_ref, y, &z); printf(" Converted back: %u ==> %dµs\n", z, (int32_t)(z-x)); printf(" * Test of timestamp counter <-> UTC value conversion *\n"); printf(" Test value: %u\n", x); i = lgw_cnt2utc(ppm_ref, x, &y); printf(" Conversion to UTC: %lld.%09ld\n", (long long)y.tv_sec, y.tv_nsec); i = lgw_utc2cnt(ppm_ref, y, &z); printf(" Converted back: %u ==> %dµs\n", z, (int32_t)(z-x)); x = ppm_tstamp - 500000; printf(" * Test of timestamp counter <-> past GPS value conversion *\n"); printf(" Test value: %u\n", x); i = lgw_cnt2gps(ppm_ref, x, &y); printf(" Conversion to GPS: %lld.%09ld\n", (long long)y.tv_sec, y.tv_nsec); i = lgw_gps2cnt(ppm_ref, y, &z); if (i != LGW_GPS_ERROR) printf(" ** FAILED **: Converted past time back: %u ==> %dµs\n", z, (int32_t)(z-x)); else printf(" ** PASS **: Could not convert to CNT, GPS time has passed\n"); printf(" * Test of timestamp counter <-> past UTC value conversion *\n"); printf(" Test value: %u\n", x); i = lgw_cnt2utc(ppm_ref, x, &y); printf(" Conversion to UTC: %lld.%09ld\n", (long long)y.tv_sec, y.tv_nsec); i = lgw_utc2cnt(ppm_ref, y, &z); if (i != LGW_GPS_ERROR) printf(" ** FAILED **: Converted past time back: %u ==> %dµs\n", z, (int32_t)(z-x)); else printf(" ** PASS **: Could not convert to CNT, UTC time has passed\n"); } static void gps_process_coords(void) { /* position variable */ struct coord_s coord; struct coord_s gpserr; int i = lgw_gps_get(NULL, NULL, &coord, &gpserr); /* update gateway coordinates */ if (i == LGW_GPS_SUCCESS) { printf("# GPS coordinates: latitude %.5f, longitude %.5f, altitude %i m\n", coord.lat, coord.lon, coord.alt); printf("# GPS err: latitude %.5f, longitude %.5f, altitude %i m\n", gpserr.lat, gpserr.lon, gpserr.alt); } } /* -------------------------------------------------------------------------- */ /* --- MAIN FUNCTION -------------------------------------------------------- */ int main(int argc, char **argv) { struct sigaction sigact; /* SIGQUIT&SIGINT&SIGTERM signal handling */ int i; unsigned int arg_u; /* concentrator variables */ struct lgw_conf_board_s boardconf; struct lgw_conf_rxrf_s rfconf; /* serial variables */ char serial_buff[128]; /* buffer to receive GPS data */ size_t wr_idx = 0; /* pointer to end of chars in buffer */ int gps_tty_dev; /* file descriptor to the serial port of the GNSS module */ /* NMEA/UBX variables */ enum gps_msg latest_msg; /* keep track of latest NMEA/UBX message parsed */ char arg_s[64]; /* parse command line options */ while ((i = getopt (argc, argv, "hd:")) != -1) { switch (i) { case 'h': usage(); return -1; break; case 'd': if (optarg != NULL) { i = sscanf(optarg, "%s", arg_s); if ((i != 1) || (strncmp(arg_s, "/dev/", 5 ) != 0)) { printf("ERROR: argument parsing of --path argument. Use -h to print help\n"); return -1; } else { lgw_spi_set_path(arg_s); } } break; default: printf("ERROR: argument parsing\n"); usage(); exit(EXIT_FAILURE); } } /* configure signal handling */ sigemptyset(&sigact.sa_mask); sigact.sa_flags = 0; sigact.sa_handler = sig_handler; sigaction(SIGQUIT, &sigact, NULL); sigaction(SIGINT, &sigact, NULL); sigaction(SIGTERM, &sigact, NULL); /* Intro message and library information */ printf("Beginning of test for loragw_gps.c\n"); printf("*** Library version information ***\n%s\n***\n", lgw_version_info()); /* Open and configure GPS */ i = lgw_gps_enable(); if (i != LGW_GPS_SUCCESS) { printf("ERROR: Failed to enable GPS\n"); exit(EXIT_FAILURE); } /* start concentrator (default conf for IoT SK) */ /* board config */ memset(&boardconf, 0, sizeof(boardconf)); boardconf.lorawan_public = true; boardconf.clksrc = 0; lgw_board_setconf(boardconf); /* RF config */ memset(&rfconf, 0, sizeof(rfconf)); rfconf.enable = true; rfconf.freq_hz = 868000000; rfconf.rssi_offset = 0.0; rfconf.type = LGW_RADIO_TYPE_SX1257; rfconf.tx_enable = true; lgw_rxrf_setconf(0, rfconf); lgw_start(); /* initialize some variables before loop */ memset(serial_buff, 0, sizeof serial_buff); memset(&ppm_ref, 0, sizeof ppm_ref); uint8_t read_fail_count = 0; uint8_t empty_packet_count = 0; enum gps_state state = GPS_RUNNING; /* loop until user action */ while ((quit_sig != 1) && (exit_sig != 1)) { size_t rd_idx = 0; size_t frame_end_idx = 0; ssize_t nb_char = 0; switch (state) { case GPS_LOST: { lgw_gps_disable(); printf("INFO: GPS closed\n"); empty_packet_count = 0; read_fail_count = 0; state = GPS_RECONNECTING; wait_ms(5000); continue; } case GPS_RECONNECTING: { /* try and reestablish connection */ i = lgw_gps_enable(); if (i != LGW_GPS_SUCCESS) { printf("WARNING: [main] impossible to open for GPS sync (Check GPSD)\n"); wait_ms(2000); continue; } else { printf("INFO: [main] GPSD polling open for GPS synchronization\n"); state = GPS_RUNNING; wait_ms(1000); continue; } } case GPS_RUNNING: { int result = lgw_gps_data_ready(); if (result != 1) { empty_packet_count++; if (empty_packet_count > 9) { state = GPS_LOST; } continue; } /* reading directly from the socket avoids decode overhead */ nb_char = lgw_gps_stream(serial_buff + wr_idx, sizeof(serial_buff) - wr_idx); if (nb_char <= 0) { printf("WARNING: [gps] read() returned value %zd\n", nb_char); read_fail_count++; if (read_fail_count > 9) { state = GPS_LOST; } continue; } break; } default: printf("ERROR: Unknown GPS state, resetting\n"); state = GPS_LOST; continue; } wr_idx += (size_t)nb_char; /******************************************* * Scan buffer for UBX/NMEA sync chars and * * attempt to decode frame if one is found * *******************************************/ while (rd_idx < wr_idx) { size_t frame_size = 0; /* Scan buffer for UBX sync char */ if (serial_buff[rd_idx] == (char)LGW_GPS_UBX_SYNC_CHAR) { /*********************** * Found UBX sync char * ***********************/ latest_msg = lgw_parse_ubx(&serial_buff[rd_idx], (wr_idx - rd_idx), &frame_size); if (frame_size > 0) { if (latest_msg == INCOMPLETE) { /* UBX header found but frame appears to be missing bytes */ frame_size = 0; } else if (latest_msg == INVALID) { /* message header received but message appears to be corrupted */ printf("WARNING: [gps] could not get a valid message from GPS (no time)\n"); frame_size = 0; } else if (latest_msg == UBX_NAV_TIMEGPS) { printf("\n~~ UBX NAV-TIMEGPS sentence, triggering synchronization attempt ~~\n"); gps_process_sync(); } } } else if(serial_buff[rd_idx] == (char)LGW_GPS_NMEA_SYNC_CHAR) { /************************ * Found NMEA sync char * ************************/ /* scan for NMEA end marker (LF = 0x0a) */ char* nmea_end_ptr = memchr(&serial_buff[rd_idx],(int)0x0a, (wr_idx - rd_idx)); if (nmea_end_ptr) { /* found end marker */ frame_size = nmea_end_ptr - &serial_buff[rd_idx] + 1; latest_msg = lgw_parse_nmea(&serial_buff[rd_idx], frame_size); if(latest_msg == INVALID || latest_msg == UNKNOWN) { /* checksum failed */ frame_size = 0; } else if (latest_msg == NMEA_RMC) { /* Get location from RMC frames */ gps_process_coords(); } } } if (frame_size > 0) { /* At this point message is a checksum verified frame we're processed or ignored. Remove frame from buffer */ rd_idx += frame_size; frame_end_idx = rd_idx; } else { rd_idx++; } } /* ...for(rd_idx = 0... */ if (frame_end_idx) { /* Frames have been processed. Remove bytes to end of last processed frame */ memcpy(serial_buff,&serial_buff[frame_end_idx],wr_idx - frame_end_idx); wr_idx -= frame_end_idx; } /* ...for(rd_idx = 0... */ /* Prevent buffer overflow */ if ((sizeof(serial_buff) - wr_idx) < LGW_GPS_MIN_MSG_SIZE) { memcpy(serial_buff,&serial_buff[LGW_GPS_MIN_MSG_SIZE],wr_idx - LGW_GPS_MIN_MSG_SIZE); wr_idx -= LGW_GPS_MIN_MSG_SIZE; } } /* clean up before leaving */ if (exit_sig == 1) { lgw_gps_disable(); lgw_stop(); } printf("\nEnd of test for loragw_gps.c\n"); exit(EXIT_SUCCESS); } /* --- EOF ------------------------------------------------------------------ */