GPS_Time.h

00001 /*
00002     Copyright (c) 2010 Andy Kirkham
00003  
00004     Permission is hereby granted, free of charge, to any person obtaining a copy
00005     of this software and associated documentation files (the "Software"), to deal
00006     in the Software without restriction, including without limitation the rights
00007     to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
00008     copies of the Software, and to permit persons to whom the Software is
00009     furnished to do so, subject to the following conditions:
00010  
00011     The above copyright notice and this permission notice shall be included in
00012     all copies or substantial portions of the Software.
00013  
00014     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
00015     IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
00016     FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
00017     AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
00018     LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
00019     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
00020     THE SOFTWARE.
00021 */
00022 
00023 #ifndef GPS_TIME_H
00024 #define GPS_TIME_H
00025 
00026 #include "mbed.h"
00027 
00028 /** GPS_Time definition.
00029  */
00030 class GPS_Time {
00031 public:
00032 
00033     //! The year
00034     int  year;      
00035     //! The month
00036     int  month;     
00037     //! The day
00038     int  day;       
00039     //! The hour
00040     int  hour;      
00041     //! The minute
00042     int  minute;    
00043     //! The second
00044     int  second;    
00045     //! Tenths of a second
00046     int  tenths;    
00047     //! Hundredths of a second
00048     int  hundreths; 
00049     //! Time status.
00050     char status;    
00051     //! The velocity (in knots)
00052     double velocity;
00053     //! The track (in decimal degrees true)
00054     double track;    
00055     //! The magnetic variation direction
00056     char magvar_dir;
00057     //! The magnetic variation value
00058     double magvar;
00059     
00060     GPS_Time();
00061     void fractionalReset(void) { tenths = hundreths = 0; }
00062     void operator++();
00063     void operator++(int);
00064     GPS_Time * timeNow(GPS_Time *n);
00065     GPS_Time * timeNow(void) { return timeNow(NULL); }
00066     void nmea_rmc(char *s);
00067     double velocity_knots(void) { return velocity; }
00068     double velocity_kph(void) { return (velocity * 1.852); }
00069     double velocity_mps(void) { return velocity_kph() / 3600.0; }
00070     double velocity_mph(void) { return velocity_kph() / 0.621371192; }
00071     double track_over_ground(void) { return track; }
00072     double magnetic_variation(void) { return magvar_dir == 'W' ? (magvar * -1.0) : (magvar); }
00073     double julian_day_number(GPS_Time *t);
00074     double julian_date(GPS_Time *t);
00075     double julian_day_number(void) { return julian_day_number(this); }
00076     double julian_date(void) { return julian_date(this); }   
00077     double siderealDegrees(double jd, double longitude);
00078     double siderealDegrees(GPS_Time *t, double longitude);
00079     double siderealHA(double jd, double longitude);
00080     double siderealHA(GPS_Time *t, double longitude);
00081     time_t to_C_tm(bool set = false);
00082 };
00083 
00084 #endif
00085