mos/dev/include/mica2-gps.h

//  This file is part of MOS, the MANTIS Operating System
//  See http://mantis.cs.colorado.edu/
//
//  Copyright (c) 2002 - 2007 University of Colorado, Boulder
//
//   All rights reserved.
//
//   Redistribution and use in source and binary forms, with or without
//   modification, are permitted provided that the following conditions are
//   met:
//
//       * Redistributions of source code must retain the above copyright
//         notice, this list of conditions and the following disclaimer.
//       * Redistributions in binary form must reproduce the above
//         copyright notice, this list of conditions and the following
//         disclaimer in the documentation and/or other materials provided
//         with the distribution. 
//       * Neither the name of the MANTIS Project nor the names of its
//         contributors may be used to endorse or promote products derived
//         from this software without specific prior written permission.
//
//   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
//   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
//   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
//   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
//   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
//   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
//   BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
//   LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
//   CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
//   LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
//   ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
//   POSSIBILITY OF SUCH DAMAGE.

#ifndef __MICA2_GPS_H__
#define __MICA2_GPS_H__

// pin 7 on switch 1
#define GPS_POWER_ADDR (1 << 6)
// pin 8 on switch 1
#define GPS_ENABLE_ADDR (1 << 7)

// pin 2 on switch 2
#define GPS_TX_ADDR (1 << 1)
// pin 1 on switch 2
#define GPS_RX_ADDR (1 << 0)


#define GPS_TX_RX  ( GPS_TX_ADDR | GPS_RX_ADDR )


// these two ADG715BRU switches on the i2c line
// are used to connect peripherals on the weatherboard to
// power, the uart, etc.

// switch 1 contains the enable switch for the GPS
#define SWITCH_1 (uint16_t)0x48 /*72*/
// switch 2 contains the uart tx/rx switches for the GPS
#define SWITCH_2 (uint16_t)0x49 /*73*/

enum GPS_FIX_QUALITY
{
   FIX_INVALID = 0,
   FIX_GPS,
   FIX_DGPS,
   FIX_PPS,
   FIX_RTK,
   FIX_FRTK,
   FIX_ESTIMATED,
   FIX_MANUAL,
   FIX_SIMULATION
};

enum MICA2_GPS_READ_TYPE
{
   MICA2_GPS_READ_STRING,
   MICA2_GPS_READ_GGA
};

   

typedef struct timestamp_struct
{
   uint8_t hours;
   uint8_t minutes;
   uint8_t seconds;
   
} timestamp_t;

typedef struct meter_struct
{
   uint16_t whole;
   uint16_t decimal;

   char units;
} measurement_t;

typedef struct latitude_struct
{
   uint16_t degrees;
   measurement_t minutes;
   char direction;
} latlong_t;
   

typedef struct gga_struct
{
   timestamp_t utc;
   latlong_t latitude;
   latlong_t longitude;
   uint8_t fix_quality;
   uint8_t satellite_count;
   measurement_t horiz_dilution;
   measurement_t altitude;
   measurement_t geoid_height;
   uint16_t since_last_update;
   uint16_t dgps_id;
} gps_gga_t;

void mica2_gps_print_gga(const gps_gga_t* gga);


void mica2_gps_init(void);

#endif // __MICA2_GPS_H__

---