_gps_data_file_v1.h

Go to the documentation of this file.

/* kate: indent-mode cstyle; tab-width 6; indent-width 6; */
#ifndef X_GPS_DATA_FILE_H
#define X_GPS_DATA_FILE_H

#include <stdint.h>
#include <math.h>

/* Macro's: */
#define _GPS_SPEC_HAVE_ACCURACY 1
#define _GPS_SPEC_VERSION 1

/* minima and maxima according to the gps spec for differential notation */
#define LAT_GPS_SPEC_DIFF_MAX (uint64_t)(pow(2, _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_DIFF_FIELD_SIZE) - 1)
#define LNG_GPS_SPEC_DIFF_MAX (uint64_t)(pow(2, _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_DIFF_FIELD_SIZE) - 1)
#define ALT_GPS_SPEC_DIFF_MAX (uint32_t)(pow(2, _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_DIFF_FIELD_SIZE) - 1)
#define TIME_GPS_SPEC_DIFF_MAX (uint64_t)(pow(2, _GPS_PARTIAL_LOCATION_BLOCK_TIME_DIFF_FIELD_SIZE) - 1)

#define LAT_GPS_SPEC_MULTIPIER (double)(pow(10, 10))
#define LNG_GPS_SPEC_MULTIPIER (double)(pow(10, 10))
#define ALT_GPS_SPEC_MULTIPIER (double)(pow(10, 3))

/* blocks from the GPS DATA FILE */
#define _GPS_HEADER_BLOCK_SIZE (16)
#define _GPS_COMPLETE_LOCATION_BLOCK_SIZE (32)
#define _GPS_PARTIAL_LOCATION_BLOCK_SIZE (16)
#define _GPS_COMMENT_BLOCK_SIZE (128)
#define _GPS_SUMMARY_BLOCK_SIZE (32)
#define _GPS_EMPTY_BLOCK_SIZE (8)
#define _GPS_DEFAULT_BLOCK_SIZE _GPS_COMPLETE_LOCATION_BLOCK_SIZE

#define _GPS_BLOCK_IDENTITY_SIZE (4)
#define _GPS_ACCURACY_FIELD_SIZE (10)
#define _GPS_SIGN_FIELD_SIZE (1)

/* block identities */
#define _GPS_HEADER_BLOCK_IDENTITY 0x50
#define _GPS_COMPLETE_LOCATION_BLOCK_IDENTITY 0xC0
#define _GPS_PARTIAL_LOCATION_BLOCK_IDENTITY 0x30
#define _GPS_COMMENT_BLOCK_IDENTITY 0x10
#define _GPS_SUMMARY_BLOCK_IDENTITY 0x80
#define _GPS_EMPTY_BLOCK_IDENTITY 0x00

/* fields for the header block */
#define _GPS_HEADER_BLOCK_VERSION_FIELD_START (_GPS_BLOCK_IDENTITY_SIZE)
#define _GPS_HEADER_BLOCK_VERSION_FIELD_SIZE (4)
#define _GPS_HEADER_BLOCK_TEXT_FIELD_START (_GPS_HEADER_BLOCK_VERSION_FIELD_START + _GPS_HEADER_BLOCK_VERSION_FIELD_SIZE)
#define _GPS_HEADER_BLOCK_TEXT_FIELD_SIZE (104)
#define _GPS_HEADER_BLOCK_OPTIONS_FIELD_START (_GPS_HEADER_BLOCK_TEXT_FIELD_START + _GPS_HEADER_BLOCK_TEXT_FIELD_SIZE)
#define _GPS_HEADER_BLOCK_OPTIONS_FIELD_SIZE (8)
#define _GPS_HEADER_BLOCK_FUTURE_FIELD_START (_GPS_HEADER_BLOCK_OPTIONS_FIELD_START + _GPS_HEADER_BLOCK_OPTIONS_FIELD_SIZE)
#define _GPS_HEADER_BLOCK_FUTURE_FIELD_SIZE (8)

/* fields for the complete location block */
#define _GPS_COMPLETE_LOCATION_BLOCK_TIME_FIELD_START (_GPS_BLOCK_IDENTITY_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_TIME_FIELD_SIZE (42)
#define _GPS_COMPLETE_LOCATION_BLOCK_LATITUDE_FIELD_START (_GPS_COMPLETE_LOCATION_BLOCK_TIME_FIELD_START + _GPS_COMPLETE_LOCATION_BLOCK_TIME_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_LATITUDE_FIELD_SIZE (41)
#define _GPS_COMPLETE_LOCATION_BLOCK_LONGITUDE_FIELD_START (_GPS_COMPLETE_LOCATION_BLOCK_LATITUDE_FIELD_START + _GPS_COMPLETE_LOCATION_BLOCK_LATITUDE_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_LONGITUDE_FIELD_SIZE (42)
#define _GPS_COMPLETE_LOCATION_BLOCK_ALTITUDE_FIELD_START (_GPS_COMPLETE_LOCATION_BLOCK_LONGITUDE_FIELD_START + _GPS_COMPLETE_LOCATION_BLOCK_LONGITUDE_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_ALTITUDE_FIELD_SIZE (24)
#define _GPS_COMPLETE_LOCATION_BLOCK_ACCURACY_FIELD_START  (_GPS_COMPLETE_LOCATION_BLOCK_ALTITUDE_FIELD_START + _GPS_COMPLETE_LOCATION_BLOCK_ALTITUDE_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_ACCURACY_FIELD_SIZE (_GPS_ACCURACY_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_FUTURE_FIELD_START (_GPS_COMPLETE_LOCATION_BLOCK_ACCURACY_FIELD_START + _GPS_COMPLETE_LOCATION_BLOCK_ACCURACY_FIELD_SIZE)
#define _GPS_COMPLETE_LOCATION_BLOCK_FUTURE_FIELD_SIZE (93)

/* fields for the partial location block */
#define _GPS_PARTIAL_LOCATION_BLOCK_TIME_DIFF_FIELD_START (_GPS_BLOCK_IDENTITY_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_TIME_DIFF_FIELD_SIZE (16)
#define _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_SIGN_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_TIME_DIFF_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_TIME_DIFF_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_SIGN_FIELD_SIZE (_GPS_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_DIFF_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_SIGN_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_DIFF_FIELD_SIZE (24)
#define _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_SIGN_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_DIFF_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_LATITUDE_DIFF_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_SIGN_FIELD_SIZE (_GPS_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_DIFF_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_SIGN_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_DIFF_FIELD_SIZE (25)
#define _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_SIGN_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_DIFF_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_LONGITUDE_DIFF_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_SIGN_FIELD_SIZE (_GPS_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_DIFF_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_SIGN_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_SIGN_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_DIFF_FIELD_SIZE (14)
#define _GPS_PARTIAL_LOCATION_BLOCK_ACCURACY_FIELD_START  (_GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_DIFF_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_ALTITUDE_DIFF_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_ACCURACY_FIELD_SIZE (_GPS_ACCURACY_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_FUTURE_FIELD_START (_GPS_PARTIAL_LOCATION_BLOCK_ACCURACY_FIELD_START + _GPS_PARTIAL_LOCATION_BLOCK_ACCURACY_FIELD_SIZE)
#define _GPS_PARTIAL_LOCATION_BLOCK_FUTURE_FIELD_SIZE (32)

/* fields for the summary block */
#define _GPS_SUMMARY_BLOCK_MODE_FIELD_START (_GPS_BLOCK_IDENTITY_SIZE)
#define _GPS_SUMMARY_BLOCK_MODE_FIELD_SIZE (2)
#define _GPS_SUMMARY_BLOCK_TOTAL_TIME_FIELD_START (_GPS_SUMMARY_BLOCK_MODE_FIELD_START + _GPS_SUMMARY_BLOCK_MODE_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_TOTAL_TIME_FIELD_SIZE (17)
#define _GPS_SUMMARY_BLOCK_TRAVEL_TIME_FIELD_START (_GPS_SUMMARY_BLOCK_TOTAL_TIME_FIELD_START + _GPS_SUMMARY_BLOCK_TOTAL_TIME_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_TRAVEL_TIME_FIELD_SIZE (17)
#define _GPS_SUMMARY_BLOCK_DISTANCE_FIELD_START (_GPS_SUMMARY_BLOCK_TRAVEL_TIME_FIELD_START + _GPS_SUMMARY_BLOCK_TRAVEL_TIME_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_DISTANCE_FIELD_SIZE (20)
#define _GPS_SUMMARY_BLOCK_CLIMB_HEIGHT_FIELD_START (_GPS_SUMMARY_BLOCK_DISTANCE_FIELD_START + _GPS_SUMMARY_BLOCK_DISTANCE_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_CLIMB_HEIGHT_FIELD_SIZE (18)
#define _GPS_SUMMARY_BLOCK_CLIMB_DISTANCE_FIELD_START (_GPS_SUMMARY_BLOCK_CLIMB_HEIGHT_FIELD_START + _GPS_SUMMARY_BLOCK_CLIMB_HEIGHT_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_CLIMB_DISTANCE_FIELD_SIZE (20)
#define _GPS_SUMMARY_BLOCK_CLIMB_TOTAL_TIME_FIELD_START (_GPS_SUMMARY_BLOCK_CLIMB_DISTANCE_FIELD_START + _GPS_SUMMARY_BLOCK_CLIMB_DISTANCE_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_CLIMB_TOTAL_TIME_FIELD_SIZE (17)
#define _GPS_SUMMARY_BLOCK_CLIMB_TRAVEL_TIME_FIELD_START (_GPS_SUMMARY_BLOCK_CLIMB_TOTAL_TIME_FIELD_START + _GPS_SUMMARY_BLOCK_CLIMB_TOTAL_TIME_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_CLIMB_TRAVEL_TIME_FIELD_SIZE (17)
#define _GPS_SUMMARY_BLOCK_FUTURE_FIELD_START (_GPS_SUMMARY_BLOCK_CLIMB_TRAVEL_TIME_FIELD_START + _GPS_SUMMARY_BLOCK_CLIMB_TRAVEL_TIME_FIELD_SIZE)
#define _GPS_SUMMARY_BLOCK_FUTURE_FIELD_SIZE (124)

/* fields for the comment block */
#define _GPS_COMMENT_BLOCK_COMMENT_FIELD_START (_GPS_BLOCK_IDENTITY_SIZE + 4)
#define _GPS_COMMENT_BLOCK_COMMENT_FIELD_SIZE (1016)

/* some macro's that make life easy */
#ifndef MIN
# define MIN(a,b) (((a) < (b)) ? (a) : (b))
#endif
#ifndef MAX
# define MAX(a,b) (((a) > (b)) ? (a) : (b))
#endif

/* some handsome macro's for reading and writing from and to bits */
#define GET_BYTE(a) ((a) / 8)
#define GET_BIT(a) (7 - ((a) % 8))
#define SHIFT(b, n) (((n) < 0) ? ((b) << (-(n))) : ((b) >> (n)))
#define GET_SHIFT(l, s, p) ((l) + (s) - (1) - (p))

#endif /* X_GPS_DATA_FILE_H */