1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
/**************************************************************************
*
* $Id: gpsutils.h 1.7.1.4 2016/08/11 13:50:01 martin TEST $
*
* Copyright (c) Meinberg Funkuhren, Bad Pyrmont, Germany
*
* Description:
* Definitions and prototypes for gpsutils.c.
*
* -----------------------------------------------------------------------
* $Log: gpsutils.h $
* Revision 1.7.1.4 2016/08/11 13:50:01 martin
* Include stddef.h.
* Revision 1.7.1.3 2015/08/27 16:24:41Z martin
* Revision 1.7.1.2 2015/08/25 15:34:48 martin
* Use save string functions from str_util.c.
* Revision 1.7.1.1 2015/08/21 14:22:06 martin
* Revision 1.7 2010/07/15 09:32:09 martin
* Use DEG character definition from pcpslstr.h.
* Revision 1.6 2005/02/18 10:32:33Z martin
* Check more predefined macros to determine if compiling for Windows.
* Revision 1.5 2003/02/04 09:18:48Z MARTIN
* Updated function prototypes.
* Revision 1.4 2002/12/12 16:08:11 martin
* Definitions for degree character.
* Requires mbggeo.h.
* Updated function prototypes.
* Revision 1.3 2001/02/05 09:40:42Z MARTIN
* New file header.
* Source code cleanup.
*
**************************************************************************/
#ifndef _GPSUTILS_H
#define _GPSUTILS_H
/* Other headers to be included */
#include <mbggeo.h>
#include <stddef.h>
#ifdef _GPSUTILS
#define _ext
#define _DO_INIT
#else
#define _ext extern
#endif
/* Start of header body */
/* function prototypes: */
#ifdef __cplusplus
extern "C" {
#endif
/* ----- function prototypes begin ----- */
/* This section was generated automatically */
/* by MAKEHDR, do not remove the comments. */
/**
* @brief Swap the bytes of a single variable of type "double"
*
* The memory layout of a "double" on Meinberg bus level devices
* and computers usually differs. This function can be used to
* fix this and is usually called from inside API functions,
* if required.
*
* @param[in,out] p Pointer to a "double" to be swapped
*
* @see ::swap_eph_doubles
* @see ::swap_alm_doubles
* @see ::swap_utc_doubles
* @see ::swap_iono_doubles
* @see ::swap_pos_doubles
*/
void swap_double( double *p ) ;
/**
* @brief Swap the "double" fields in an ::EPH structure
*
* See comments for ::swap_double
*
* @param[in,out] p Pointer to an ::EPH structure to be converted
*
* @see ::swap_double
* @see ::swap_alm_doubles
* @see ::swap_utc_doubles
* @see ::swap_iono_doubles
* @see ::swap_pos_doubles
*/
void swap_eph_doubles( EPH *p ) ;
/**
* @brief Swap the "double" fields in an ::ALM structure
*
* See comments for ::swap_double
*
* @param[in,out] p Pointer to an ::ALM structure to be converted
*
* @see ::swap_double
* @see ::swap_eph_doubles
* @see ::swap_utc_doubles
* @see ::swap_iono_doubles
* @see ::swap_pos_doubles
*/
void swap_alm_doubles( ALM *p ) ;
/**
* @brief Swap the "double" fields in a ::UTC structure
*
* See comments for ::swap_double
*
* @param[in,out] p Pointer to a ::UTC structure to be converted
*
* @see ::swap_double
* @see ::swap_eph_doubles
* @see ::swap_alm_doubles
* @see ::swap_iono_doubles
* @see ::swap_pos_doubles
*/
void swap_utc_doubles( UTC *p ) ;
/**
* @brief Swap the "double" fields in a ::IONO structure
*
* See comments for ::swap_double
*
* @param[in,out] p Pointer to a ::IONO structure to be converted
*
* @see ::swap_double
* @see ::swap_eph_doubles
* @see ::swap_alm_doubles
* @see ::swap_utc_doubles
* @see ::swap_pos_doubles
*/
void swap_iono_doubles( IONO *p ) ;
/**
* @brief Swap the "double" fields in a ::POS structure
*
* See comments for ::swap_double
*
* @param[in,out] p Pointer to a ::POS structure to be converted
*
* @see ::swap_double
* @see ::swap_eph_doubles
* @see ::swap_alm_doubles
* @see ::swap_utc_doubles
* @see ::swap_iono_doubles
*/
void swap_pos_doubles( POS *p ) ;
/**
* @brief Print the ::DMS part of a geo position into a string buffer
*
* @param[out] s The string buffer to be filled
* @param[in] max_len Size of the output buffer for 0-terminated string
* @param[in] p Pointer to a ::DMS structure to be printed
* @param[in] prec Precision, i.e. number of fractions of the seconds
*
* @return Length of the string in the buffer
*
* @see snprint_dms
* @see snprint_alt
* @see snprint_pos_geo
* @see snprint_fixed_freq
*/
size_t snprint_dms( char *s, size_t max_len, const DMS *p, int prec ) ;
/**
* @brief Print the altitude part of a geo position into a string buffer
*
* @param[out] s The string buffer to be filled
* @param[in] max_len Size of the output buffer for 0-terminated string
* @param[in] alt The altitude value to be printed, in [m]
*
* @return Length of the string in the buffer
*
* @see snprint_dms
* @see snprint_pos_geo
* @see snprint_fixed_freq
*/
size_t snprint_alt( char *s, size_t max_len, double alt ) ;
/**
* @brief Print a geo position in ::POS format into a string buffer
*
* @param[out] s The string buffer to be filled
* @param[in] max_len Size of the output buffer for 0-terminated string
* @param[in] p Pointer to a ::POS structure to be printed
* @param[in] sep Separator character for the ::DMS part
* @param[in] prec Precision, i.e. number of fractions of the seconds of the ::DMS part
*
* @return Length of the string in the buffer
*
* @see snprint_dms
* @see snprint_alt
* @see snprint_fixed_freq
*/
size_t snprint_pos_geo( char *s, size_t max_len, const POS *p, char sep, int prec ) ;
/**
* @brief Print a formatted ::FIXED_FREQ_INFO into a string buffer
*
* @param[out] s The string buffer to be filled
* @param[in] max_len Size of the output buffer for 0-terminated string
* @param[in] p_ff Pointer to a ::FIXED_FREQ_INFO structure to be printed
*
* @return Length of the string in the buffer
*
* @see snprint_dms
* @see snprint_alt
* @see snprint_pos_geo
*/
size_t snprint_fixed_freq( char *s, size_t max_len, FIXED_FREQ_INFO *p_ff ) ;
/* ----- function prototypes end ----- */
#ifdef __cplusplus
}
#endif
/* End of header body */
#undef _ext
#undef _DO_INIT
#endif /* _GPSUTILS_H */
|
