Table of Contents

The GPS Wildcard User Guide

<< Previous | Next>>

C Demonstration Program

This section presents the ANSI C version of the demonstration program source code.

// Filename: GPS_WC_Demo.c

// Date: Feb 27, 2007

// copyright 2007 Mosaic Industries, Inc. All rights reserved.

// This is a demonstration program for the GPS Wildcard.

// Make sure that GPS_MODULE_NUM matches your hardware jumper settings.

// Note: in real applications, the GPS service should be invoked from a separate task.

#define GPS_MODULE_NUM 0   // MUST match hardware jumper settings!

void GPS_Run ( int local_hour_offset, int module_num )

// this function initializes the GPS Wildcard and prints a formatted summary

// of GPS info to the terminal every 5 seconds.  Type any key to terminate the function.

// Note: in real applications, the GPS service should be invoked from a separate task.

{  int print_counter;

   if(GPS_Init(local_hour_offset, module_num))

      printf(“GPS_Init FAILED!\r\n”);     // we’re done if GPS_Init error flag is true

   else                          // if initialization ok, proceed...

   {  printf(“\r\nStarting GPS info dump. Type any key to exit this function.\r\n”);

      printf(“This function gets a data frame from the GPS once per second,”);

      printf(“and prints a statement telling of the fix validity.”);

      printf(“If the fix is not valid, make sure your antenna is outside,”);

      printf(“and give the GPS some time (5 minutes worst case) to acquire its satellites.”);

      printf(“This function periodically calls GPS_Info_Dump to summarize the GPS data.\r\n”);

      while(?Key==0)                // type any key to end this routine

      {  printf(“\r\n\r\nValid fix?: “);

         if(GPS_Update(module_num) // runs every second

            printf(“NO”);           // if GPS_Update returned true error flag: no fix

         else

            printf(“YES”);          // if no GPS_Update error: yes, we have a fix

         if(print_counter++ == 5)      // detailed print every 5 seconds

         {  print_counter = 0;         // restart counter

            GPS_Info_Dump(); // print formatted extracted gps info

         }

      }

   }

}

void GPS_Demo ( void )

// this function initializes the GPS Wildcard with a specified time zone and module number,

// and prints a formatted summary of GPS info to the terminal every 5 seconds.

// Type any key to terminate the function.

// Note: in real applications, the GPS service should be invoked from a separate task.

{  GPS_Run(GPS_PACIFIC_TIME, GPS_MODULE_NUM);

}

void main(void)

{  GPS_Demo();

}

<< Previous | Next>>