Coverage Report

Created: 2024-10-20 06:20

/src/gpsd/gpsd-3.25.1~dev/drivers/driver_ubx.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * UBX driver.  For u-blox binary, also includes Antaris4 binary
3
 * Reference manuals are at
4
 * http://www.u-blox.com/en/download/documents-a-resources/u-blox-6-gps-modules-resources.html
5
 *
6
 * updated for u-blox 8
7
 * http://www.ublox.com/images/downloads/Product_Docs/u-bloxM8_ReceiverDescriptionProtocolSpec_%28UBX-13003221%29_Public.pdf
8
 *
9
 * Week counters are not limited to 10 bits. It's unknown what
10
 * the firmware is doing to disambiguate them, if anything; it might just
11
 * be adding a fixed offset based on a hidden epoch value, in which case
12
 * unhappy things will occur on the next rollover.
13
 *
14
 * For the Antaris 4, the default leap-second offset (before getting one from
15
 * the sats, one presumes) is 0sec; for the u-blox 6 it's 15sec.
16
 *
17
 * This file is Copyright by the GPSD project
18
 * SPDX-License-Identifier: BSD-2-clause
19
 *
20
 */
21
22
#include "../include/gpsd_config.h"  // must be before all includes
23
24
#include <math.h>
25
#include <stdbool.h>
26
#include <stdio.h>
27
#include <stdlib.h>                // for abs()
28
#include <string.h>
29
#include <unistd.h>
30
31
32
#include "../include/compiler.h"   // for FALLTHROUGH
33
#include "../include/gpsd.h"
34
#include "../include/driver_ubx.h"
35
36
#include "../include/bits.h"       // For UINT2INT()
37
#include "../include/timespec.h"
38
39
/*
40
 * Some high-precision messages provide data where the main part is a
41
 * signed 32-bit integer (same as the standard-precision versions),
42
 * and there's an 8-bit signed field providing an addend scaled to
43
 * 1/100th of the main value.  This macro provides a fetch for such
44
 * values, scaled to match the extension (i.e., 100X the main-value scale).
45
 * Since the fields are nonconsective, the offsets are provided separately.
46
 * The result is a signed 64-bit integer.
47
 *
48
 * The second macro incorporates scaling the result by a specified double.
49
 */
50
#define getles32x100s8(buf, off, offx) \
51
0
    ((int64_t)(getles32((buf), (off)) * 100LL + getsb((buf), (offx))))
52
#define getles32x100s8d(buf, off, offx, scale) \
53
0
    (getles32x100s8((buf), (off), (offx)) * (double)(scale))
54
55
/*
56
 * A ubx packet looks like this:
57
 * leader: 0xb5 0x62
58
 * message class: 1 byte
59
 * message type: 1 byte
60
 * length of payload: 2 bytes
61
 * payload: variable length
62
 * checksum: 2 bytes
63
 *
64
 * see also the FV25 and UBX documents on reference.html
65
 */
66
0
#define UBX_PREFIX_LEN          6
67
#define UBX_CLASS_OFFSET        2
68
#define UBX_TYPE_OFFSET         3
69
70
// because we hates magic numbers forever
71
0
#define USART1_ID               1
72
#define USART2_ID               2
73
0
#define USB_ID                  3
74
0
#define UBX_PROTOCOL_MASK       0x01
75
0
#define NMEA_PROTOCOL_MASK      0x02
76
0
#define RTCM_PROTOCOL_MASK      0x04
77
0
#define RTCM3_PROTOCOL_MASK     0x20    // protVer 20+
78
0
#define UBX_CFG_LEN             20
79
0
#define outProtoMask            14
80
81
// UBX Satellite/Dignal Numbering
82
static struct vlist_t vgnss_sig_ids[] = {
83
    {0x0000, "GPS L1 C/A"},
84
    {0x0003, "GPS L2 CL"},
85
    {0x0004, "GPS L2 CM"},
86
    {0x0006, "GPS L5 I"},
87
    {0x0007, "GPS L5 Q"},
88
    {0x0100, "SBAS L1 C/A"},
89
    {0x0200, "GAL E1 C"},
90
    {0x0201, "GAL E1 B"},
91
    {0x0203, "GAL E5 aI"},
92
    {0x0204, "GAL E5 aQ"},
93
    {0x0205, "GAL E5 bI"},
94
    {0x0206, "GAL E5 bQ"},
95
    {0x0300, "BDS B1I D1"},
96
    {0x0301, "BDS B1I D2"},
97
    {0x0302, "BDS B2I D1"},
98
    {0x0303, "BDS B2I D2"},
99
    {0x0305, "BDS B1 Cp"},
100
    {0x0306, "BDS B1 Cd"},
101
    {0x0307, "BDS B2 ap"},
102
    {0x0308, "BDS B2 ad"},
103
    {0x0508, "QZSS L1 C/A"},
104
    {0x0501, "QZSS L1 S"},
105
    {0x0504, "QZSS L2 CM"},
106
    {0x0505, "QZSS L2 CL"},
107
    {0x0508, "QZSS L5 I"},
108
    {0x0509, "QZSS L5 Q"},
109
    {0x0600, "GLO L1 OF"},
110
    {0x0602, "GLO L2 OF"},
111
    {0x0700, "NavIc L5 A"},
112
    {0, NULL},
113
};
114
115
// UBX-ACK-* ids
116
static struct vlist_t vack_ids[] = {
117
    {UBX_ACK_ACK, "ACK-ACK"},
118
    {UBX_ACK_NAK, "ACK-NAK"},
119
    {0, NULL},
120
};
121
122
// UBX-INF-* inf_ids
123
static struct vlist_t vinf_ids[] = {
124
    {UBX_INF_DEBUG, "INF-DEBUG"},
125
    {UBX_INF_TEST, "INF-TEST"},
126
    {UBX_INF_NOTICE, "INF-NOTICE"},
127
    {UBX_INF_WARNING, "INF-WARNING"},
128
    {UBX_INF_ERROR, " INF-ERROR"},
129
    {0, NULL},
130
};
131
132
// UBX-MON-COMMS protIds
133
static struct vlist_t vprotIds[] = {
134
    {0, "UBX"},
135
    {1, "NMEA"},
136
    {2, "RTCM2"},
137
    {5, "RTCM3"},
138
    {255, "None"},
139
    {0, NULL},
140
};
141
142
// UBX-MON-COMMS txErrors
143
static struct flist_t vmon_comms_txerrors[] = {
144
    {1, 1, "mem"},
145
    {2, 2, "alloc"},
146
    {0, 0, NULL},
147
};
148
149
// UBX-MON-TXBUF errors
150
static struct flist_t vmon_txbuf_errors[] = {
151
    {0x40, 0x40, "mem"},
152
    {0x80, 0x80, "alloc"},
153
    {0, 0, NULL},
154
};
155
156
// UBX-MON-HW flags
157
static struct flist_t vmon_hw_flags[] = {
158
    {1, 1, "RTC Calibrated"},
159
    {2, 2, "Safeboot Active"},
160
    {0x04, 0x0c, "Jam OK"},
161
    {0x08, 0x0c, "Jam Warn"},
162
    {0x0c, 0x0c, "Jam Critical"},
163
    {0x10, 0x10, "xtal Absent"},
164
    {0, 0, NULL},
165
};
166
167
// UBX-MON-HW aPower
168
static struct vlist_t vaPower[] = {
169
    {0, "Off"},
170
    {1, "On"},
171
    {2, "Unk"},
172
    {0, NULL},
173
};
174
175
// UBX-MON-HW aStatus
176
static struct vlist_t vaStatus[] = {
177
    {0, "Init"},
178
    {1, "Unk"},
179
    {2, "OK"},
180
    {3, "Short"},
181
    {4, "Open"},
182
    {0, NULL},
183
};
184
185
// UBX-MON-RF flags
186
static struct vlist_t vmon_rf_flags[] = {
187
    {0, "Jam Unk"},
188
    {1, "Jam OK"},
189
    {2, "Jam Warn"},
190
    {3, "Jam Crit"},
191
    {0, NULL},
192
};
193
194
// Names for portID values in:
195
//  UBX-CFG-PRT, UBX-MON-IO, UBX-MON-RXBUF, UBX-MON-TXBUF, target
196
static struct vlist_t vtarget[] = {
197
    {0, "DDC"},             // The license free name for I2C
198
    {1, "UART1"},
199
    {2, "UART2"},
200
    {3, "USB"},
201
    {4, "SPI"},
202
    {0x100, "UART1"},       // MON-COMMS
203
    {0x200, "UART2"},       // MON-COMMS
204
    {0x300, "USB"},         // MON-COMMS
205
    {0x400, "SPI"},         // MON-COMMS
206
    {0, NULL},
207
};
208
209
// UBX-HNR-PVT, UBX-NAV-SOL gpsFix, UBX-NAV-PVT fixType
210
static struct vlist_t vpvt_fixType[] = {
211
    {0, "None"},
212
    {1, "DR"},
213
    {2, "2D"},
214
    {3, "3D"},
215
    {4, "GNSSDR"},
216
    {5, "Time"},
217
    {0, NULL},
218
};
219
220
// UBX-HNR-PVT flags
221
static struct flist_t fhnr_pvt_flags[] = {
222
    {1, 1, "gnssFixOK"},
223
    {2, 2, "diffSoln"},
224
    {4, 4, "WKNSET"},
225
    {8, 8, "TOWSET"},
226
    {0x20, 0x20, "headVehValid"},
227
    {0, 0, NULL},
228
};
229
230
// UBX-NAV-PVT flags
231
static struct flist_t fnav_pvt_flags[] = {
232
    {1, 1, "gnssFixOK"},
233
    {2, 2, "diffSoln"},
234
    // {0, 0x1v, "psmState"},      // ??
235
    {0x20, 0x20, "headVehValid"},
236
    {0x40, 0xc0, "CarrSolnFLT"},   // protVer less than 20
237
    {0x80, 0xc0, "CarrSolnFIX"},
238
    {0, 0, NULL},
239
};
240
241
// UBX-NAV-PVT flags2
242
static struct flist_t fpvt_flags2[] = {
243
    {0x20, 0x20, "confirmedAvai"},   // protver 19+
244
    {0x40, 0x40, "confirmedDate"},
245
    {0x80, 0x80, "confirmedTime"},
246
    {0, 0, NULL},
247
};
248
249
// UBX-NAV-PVT flags3
250
static struct flist_t fpvt_flags3[] = {
251
    {0x20, 0x20, "invalLlh"},
252
    {0, 0, NULL},
253
};
254
255
// UBX-HNR-PVT, UBX-NAV-PVT valid
256
static struct flist_t fpvt_valid[] = {
257
    {1, 1, "validDate"},
258
    {2, 2, "validTime"},
259
    {4, 4, "fullyResolved"},
260
    {8, 8, "validMag"},
261
    {0, 0, NULL},
262
};
263
264
// UBX-NAV-PVT, dgps_age
265
static int pvt_dgps_age[] = {
266
    -1, 1, 2, 5, 10,
267
    15, 20, 30, 45, 60,
268
    90, 120, 240};
269
270
// UBX-NAV-SAT flags
271
static struct flist_t fsat_flags[] = {
272
    // bits 0, 1, and 2 == qualityInd
273
    {8, 8, "Used"},
274
    {0x10, 0x30, "healthy"},
275
    {0x20, 0x30, "unhealthy"},
276
    {0x40, 0x40, "diffCorr"},
277
    {0x800, 0x800, "ephAvail"},
278
    {0x1000, 0x1000, "almAvail"},
279
    {0x2000, 0x2000, "anoAvail"},
280
    {0x4000, 0x4000, "aopAvail"},
281
    {0x10000, 0x10000, "sbasCorrUsed"},
282
    {0x20000, 0x20000, "rtcmCorrUsed"},
283
    {0x40000, 0x40000, "slasCorrUsed"},
284
    {0x80000, 0x80000, "spartnCorrUsed"},
285
    {0x100000L, 0x100000L, "prCorrUsed"},
286
    {0x200000L, 0x200000L, "crCorrUsed"},
287
    {0x400000L, 0x400000L, "doCorrUsed"},
288
    {0x800000L, 0x800000L, "cbasCorrUsed"},
289
    {0, 0, NULL},
290
};
291
292
// UBX-NAV-SIG corrSource
293
static struct vlist_t vsig_corrsource[] = {
294
    {0, "None"},
295
    {1, "SBAS"},
296
    {2, "rBDS"},
297
    {3, "RTCM2"},
298
    {4, "RTCM3 OSR"},
299
    {5, "RTCM3 SSR"},
300
    {6, "QZSS SLAS"},
301
    {7, "SPARTN"},
302
    {8, "CLAS"},
303
    {0, NULL},
304
};
305
306
// UBX-NAV-SIG ionoModel
307
static struct vlist_t vsig_ionomodel[] = {
308
    {0, "None"},
309
    {1, "Klobuchar GPS"},
310
    {2, "SBAS"},
311
    {8, "Dual F Delay"},
312
    {0, NULL},
313
};
314
315
// UBX-NAV-SIG sigFlags
316
static struct flist_t fsig_sigFlags[] = {
317
    {1, 3, "healthy"},
318
    {2, 3, "unhealthy"},
319
    {4, 4, "prSmoothed"},
320
    {8, 8, "prUsed"},
321
    {0x10, 0x10, "crUsed"},
322
    {0x20, 0x20, "doUsed"},
323
    {0x40, 0x40, "prCorrUsed"},
324
    {0x80, 0x80, "crCorrUsed"},
325
    {0x100, 0x100, "doCorrUsed"},
326
    {0x200, 0x200, "Authenticated"},  // u-blox M9 SPG, GALILEO
327
    {0, 0, NULL},
328
};
329
330
// UBX-NAV-SVIN active
331
// UBX-TIM-SVIN active
332
static struct vlist_t vsvin_active[] = {
333
    {0, "Inactive"},
334
    {1, "Active"},
335
    {0, NULL},
336
};
337
338
// UBX-NAV-SVIN valid
339
// UBX-TIM-SVIN valid
340
static struct vlist_t vsvin_valid[] = {
341
    {0, "Invalid"},
342
    {1, "Valid"},
343
    {0, NULL},
344
};
345
346
// UBX-NAV-SVINFO flags
347
static struct flist_t fsvinfo_flags[] = {
348
    {1, 1, "svUsed"},
349
    {2, 2, "diffCorr"},
350
    {4, 4, "orbitAvail"},
351
    {8, 8, "orbitEph"},
352
    {0x10, 0x10, "unhealthy"},
353
    {0x20, 0x20, "orbitAlm"},
354
    {0x40, 0x40, "orbitAop"},
355
    {0x80, 0x80, "smoothed"},
356
    {0, 0, NULL},
357
};
358
359
// UBX-NAV-SVINFO globalFlags
360
static struct vlist_t vglobalFlags[] = {
361
    {0, "Antaris 4"},
362
    {1, "u-blox 5"},
363
    {2, "u-blox 6"},
364
    {3, "u-blox 7"},
365
    {4, "u-blox 8"},
366
    {0, NULL},
367
};
368
369
// UBX-NAV-SAT, UBX-NAV-SVINFO qualtyiInd
370
static struct vlist_t vquality[] = {
371
    {0, "None"},
372
    {1, "Searching"},
373
    {2, "Acquired"},
374
    {3, "Unusable"},
375
    {4, "Code locked"},
376
    {5, "Carrier locked"},
377
    {6, "Carrier locked"},
378
    {7, "Carrier locked"},
379
    {0, NULL},
380
};
381
382
// UBX-NAV-TIMEGPS valid
383
static struct flist_t vtimegps_valid[] = {
384
    {1, 1, "towValid"},
385
    {2, 2, "weekValid"},
386
    {4, 4, "leapSValid"},
387
    {0, 0, NULL},
388
};
389
390
// UBX-NAV-TIMELS srcOfCurrLs
391
static struct vlist_t vsrcOfCurrLs[] = {
392
    {0, "firmware"},
393
    {1, "GPS GLONASS difference"},
394
    {2, "GPS"},
395
    {3, "SBAS"},
396
    {4, "BeiDou"},
397
    {5, "Galileo"},
398
    {6, "Aided data"},
399
    {7, "Configured"},
400
    {0, NULL},
401
};
402
403
// UBX-NAV-TIMELS srcOfLsChange
404
static struct vlist_t vsrcOfLsChange[] = {
405
    {0, "No Source"},
406
    {1, "Undefined"},
407
    {2, "GPS"},
408
    {3, "SBAS"},
409
    {4, "BeiDou"},
410
    {5, "Galileo"},
411
    {6, "GLONASS"},
412
    {0, NULL},
413
};
414
415
// UBX-NAV-TIMELS valid
416
static struct flist_t vtimels_valid[] = {
417
    {1, 1, "validCurrLs"},
418
    {2, 2, "validTimeToLsEvent"},
419
    {0, 0, NULL},
420
};
421
422
// start ubx message configuration stuff
423
424
/* UBX-NAV-SOL deprecated in u-blox 6, gone in u-blox 9.
425
 * Use UBX-NAV-PVT after u-blox 7 (protver 15+)
426
 * u-blox 6 w/ GLONASS, protver 14 have NAV-PVT
427
 * UBX-NAV-SOL has same data from NAV-POSECEF and NAV-VELECEF.
428
 * Need NAV-SOL for fix type and fix flags.
429
 * skip NAV-POSLLH as we compute lat/lon/alt/geoid from ECEF.
430
 *
431
 * UBX-NAV-SVINFO deprecated in u-blox 8, gone in u-blox 9.
432
 * Use UBX-NAV-SAT after u-blox 7
433
 *
434
 * UBX-NAV-EOE makes a good cycle ender */
435
436
// nmea to turn off
437
static const unsigned char nmea_off[] = {
438
    0x00,          // msg id  = GGA
439
    0x01,          // msg id  = GLL
440
    0x02,          // msg id  = GSA
441
    0x03,          // msg id  = GSV
442
    0x04,          // msg id  = RMC
443
    0x05,          // msg id  = VTG
444
    0x07,          // msg id  = GST
445
    0x08,          // msg id  = ZDA
446
    0x09,          // msg id  = GBS
447
};
448
449
// UBX-NAV that ww want on, for all protver
450
static const unsigned char ubx_nav_on[] = {
451
    0x04,          // UBX-NAV-DOP
452
    0x20,          // UBX-NAV-TIMEGPS
453
    // UBX-NAV-CLOCK, nice cycle ender if no NAV-EOE (protVer 18)
454
    0x22,
455
};
456
457
// UBX-NAV for protver < 15, not present in protVer >= 27
458
static const unsigned char ubx_14_nav_on[] = {
459
    0x06,              // msg id = NAV-SOL
460
    0x30,              // msg id = NAV-SVINFO
461
};
462
463
// UBX for protver >= 15
464
static const unsigned char ubx_15_nav_on[] = {
465
    // Need NAV-POSECEF, NAV-VELECEF and NAV-PVT to replace NAV-SOL
466
    0x01,              // msg id = NAV-POSECEF
467
    0x07,              // msg id = NAV-PVT
468
    0x11,              // msg id = NAV-VELECEF
469
    0x35,              // msg id = NAV-SAT
470
    0x43,              // msg id = NAV-SIG
471
};
472
473
// end ubx message configuration stuff
474
475
static gps_mask_t ubx_msg_inf(struct gps_device_t *session, unsigned char *buf,
476
                              size_t data_len);
477
static gps_mask_t ubx_msg_log_batch(struct gps_device_t *session,
478
                                    unsigned char *buf, size_t data_len);
479
static gps_mask_t ubx_msg_log_info(struct gps_device_t *session,
480
                                   unsigned char *buf, size_t data_len);
481
static gps_mask_t ubx_msg_log_retrievepos(struct gps_device_t *session,
482
                                          unsigned char *buf, size_t data_len);
483
static gps_mask_t ubx_msg_log_retrieveposextra(struct gps_device_t *session,
484
                                               unsigned char *buf,
485
                                               size_t data_len);
486
static gps_mask_t ubx_msg_log_retrievestring(struct gps_device_t *session,
487
                                             unsigned char *buf,
488
                                             size_t data_len);
489
static gps_mask_t ubx_msg_nav_dop(struct gps_device_t *session,
490
                                  unsigned char *buf, size_t data_len);
491
static gps_mask_t ubx_msg_nav_eoe(struct gps_device_t *session,
492
                                  unsigned char *buf, size_t data_len);
493
static gps_mask_t ubx_msg_nav_posecef(struct gps_device_t *session,
494
                                      unsigned char *buf, size_t data_len);
495
static gps_mask_t ubx_msg_nav_pvt(struct gps_device_t *session,
496
                                  unsigned char *buf, size_t data_len);
497
static gps_mask_t ubx_msg_nav_sat(struct gps_device_t *session,
498
                                  unsigned char *buf, size_t data_len);
499
static gps_mask_t ubx_msg_nav_sbas(struct gps_device_t *session,
500
                                   unsigned char *buf, size_t data_len);
501
static gps_mask_t ubx_msg_nav_sol(struct gps_device_t *session,
502
                                  unsigned char *buf, size_t data_len);
503
static gps_mask_t ubx_msg_nav_svinfo(struct gps_device_t *session,
504
                                     unsigned char *buf, size_t data_len);
505
static gps_mask_t ubx_msg_nav_timegps(struct gps_device_t *session,
506
                                      unsigned char *buf, size_t data_len);
507
static gps_mask_t ubx_msg_sec_uniqid(struct gps_device_t *session,
508
                                  unsigned char *buf, size_t data_len);
509
static gps_mask_t ubx_msg_nav_velecef(struct gps_device_t *session,
510
                                      unsigned char *buf, size_t data_len);
511
static gps_mask_t ubx_msg_tim_tp(struct gps_device_t *session,
512
                                 unsigned char *buf, size_t data_len);
513
static void ubx_mode(struct gps_device_t *session, int mode);
514
515
typedef struct {
516
    const char *fw_string;
517
    const float protver;
518
} fw_protver_map_entry_t;
519
520
/* based on u-blox document no. GPS.G7-SW-12001-B1 (15 June 2018)
521
 * capture decimal parts of protVer info even when session->protver currently
522
 * is integer (which _might_ change in the future, so avoid having to revisit
523
 * the info at that time).
524
 * This list is substantially incomplete and over specific. */
525
static const fw_protver_map_entry_t fw_protver_map[] = {
526
    {"2.10", 8.10},           // antaris 4, version 8 is a guess
527
    {"2.11", 8.11},           // antaris 4, version 8 is a guess
528
    {"3.04", 9.00},           // antaris 4, version 9 is a guess
529
    {"4.00", 10.00},          // antaris 4, and u-blox 5
530
    {"4.01", 10.01},          // antaris 4, and u-blox 5
531
    {"5.00", 11.00},          // u-blox 5 and antaris 4
532
    {"6.00", 12.00},          // u-blox 5 and 6
533
    {"6.02", 12.02},          // u-blox 5 and 6
534
    {"6.02", 12.03},          // u-blox 5 and 6
535
    {"7.01", 13.01},          // u-blox 7
536
    {"7.03", 13.03},          // u-blox 6 and 7
537
    {"1.00", 14.00},          // u-blox 6 w/ GLONASS, and 7
538
    // protVer >14 should carry explicit protVer in MON-VER extension
539
    {NULL, 0.0},
540
};
541
542
/*
543
 * Model  Fw          Protver
544
 * M8     2,01        15.00
545
 * M9     HPG 1.13    27.12
546
 * M10    SPG 5.00    34.00
547
 */
548
549
/* send a ubx message.
550
 * calculate checksums, etc.
551
 */
552
bool ubx_write(struct gps_device_t * session,
553
               unsigned int msg_class, unsigned int msg_id,
554
               const unsigned char *msg, size_t data_len)
555
0
{
556
0
    unsigned char CK_A, CK_B;
557
0
    ssize_t count;
558
0
    size_t i;
559
0
    bool ok;
560
561
    // do not write if -b (readonly) option set
562
    // "passive" handled earlier
563
0
    if (session->context->readonly) {
564
0
        return true;
565
0
    }
566
567
0
    session->msgbuf[0] = 0xb5;
568
0
    session->msgbuf[1] = 0x62;
569
570
0
    CK_A = CK_B = 0;
571
0
    session->msgbuf[2] = msg_class;
572
0
    session->msgbuf[3] = msg_id;
573
0
    session->msgbuf[4] = data_len & 0xff;
574
0
    session->msgbuf[5] = (data_len >> 8) & 0xff;
575
576
0
    if ((sizeof(session->msgbuf) - 8) <= data_len) {
577
0
        GPSD_LOG(LOG_ERROR, &session->context->errout,
578
0
                 "=> GPS: UBX class: %02x, id: %02x, len: %zd TOO LONG!\n",
579
0
                 msg_class, msg_id, data_len);
580
0
    }
581
0
    if (NULL != msg &&
582
0
        0 < data_len) {
583
0
        (void)memcpy(&session->msgbuf[6], msg, data_len);
584
0
    }
585
586
    // calculate CRC
587
0
    for (i = 2; i < (6 + data_len); i++) {
588
0
        CK_A += session->msgbuf[i];
589
0
        CK_B += CK_A;
590
0
    }
591
592
0
    session->msgbuf[6 + data_len] = CK_A;
593
0
    session->msgbuf[7 + data_len] = CK_B;
594
0
    session->msgbuflen = data_len + 8;
595
596
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
597
0
             "=> GPS: UBX class: %02x, id: %02x, len: %zd, crc: %02x%02x\n",
598
0
             msg_class, msg_id, data_len,
599
0
             CK_A, CK_B);
600
0
    count = gpsd_write(session, session->msgbuf, session->msgbuflen);
601
0
    ok = (count == (ssize_t) session->msgbuflen);
602
0
    return (ok);
603
0
}
604
605
/* Convert a ubx PRN to an NMEA 4.0 (extended) PRN and ubx gnssid, svid
606
 *
607
 * return 0 on fail
608
 */
609
static short ubx_to_prn(int ubx_PRN, unsigned char *gnssId,
610
                        unsigned char *svId)
611
0
{
612
0
    *gnssId = 0;
613
0
    *svId = 0;
614
615
    // IRNSS??
616
0
    if (1 > ubx_PRN) {
617
        // skip 0 PRN
618
0
        return 0;
619
0
    } else if (32 >= ubx_PRN) {
620
        // GPS 1..32 -> 1..32
621
0
        *gnssId = 0;
622
0
        *svId = ubx_PRN;
623
0
    } else if (64 >= ubx_PRN) {
624
        // BeiDou, 159..163,33..64 -> 1..5,6..37
625
0
        *gnssId = 3;
626
0
        *svId = ubx_PRN - 27;
627
0
    } else if (96 >= ubx_PRN) {
628
        // GLONASS 65..96 -> 1..32
629
0
        *gnssId = 6;
630
0
        *svId = ubx_PRN - 64;
631
0
    } else if (120 > ubx_PRN) {
632
        // Huh?
633
0
        return 0;
634
0
    } else if (158 >= ubx_PRN) {
635
        // SBAS 120..158 -> 120..158
636
0
        *gnssId = 1;
637
0
        *svId = ubx_PRN;
638
0
    } else if (163 >= ubx_PRN) {
639
        // BeiDou, 159..163 -> 1..5
640
0
        *gnssId = 3;
641
0
        *svId = ubx_PRN - 158;
642
0
    } else if (173 > ubx_PRN) {
643
        // Huh?
644
0
        return 0;
645
0
    } else if (182 >= ubx_PRN) {
646
        // IMES 173..182 -> 1..5, in u-blox 8, bot u-blox 9
647
0
        *gnssId = 4;
648
0
        *svId = ubx_PRN - 172;
649
0
    } else if (193 > ubx_PRN) {
650
        // Huh?
651
0
        return 0;
652
0
    } else if (199 >= ubx_PRN) {
653
        // QZSS 193..197 -> 1..5
654
        // ZED-F9T also see 198 and 199
655
0
        *gnssId = 5;
656
0
        *svId = ubx_PRN - 192;
657
0
    } else if (211 > ubx_PRN) {
658
        // Huh?
659
0
        return 0;
660
0
    } else if (246 >= ubx_PRN) {
661
        // Galileo 211..246 -> 1..36
662
0
        *gnssId = 2;
663
0
        *svId = ubx_PRN - 210;
664
0
    } else {
665
        // greater than 246, GLONASS (255), unused, or other unknown
666
0
        return 0;
667
0
    }
668
0
    return ubx2_to_prn(*gnssId, *svId);
669
0
}
670
671
// UBX-ACK-ACK, UBX-ACK-NAK
672
static gps_mask_t ubx_msg_ack(struct gps_device_t *session,
673
                              unsigned char *buf, size_t data_len)
674
0
{
675
0
    unsigned msgid = getbes16(buf, 2);
676
677
0
    if (2 > data_len) {
678
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
679
0
                 "UBX: %s-: runt payload len %zd",
680
0
                 val2str(msgid, vack_ids), data_len);
681
0
        return 0;
682
0
    }
683
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
684
0
             "UBX: %s: class: %02x, id: %02x\n",
685
0
             val2str(msgid, vack_ids),
686
0
             buf[UBX_PREFIX_LEN],
687
0
             buf[UBX_PREFIX_LEN + 1]);
688
0
    return 0;
689
0
}
690
691
// UBX-CFG-RATE
692
// Deprecated in u-blox 10
693
static gps_mask_t ubx_msg_cfg_rate(struct gps_device_t *session,
694
                                   unsigned char *buf, size_t data_len)
695
0
{
696
0
    uint16_t measRate, navRate, timeRef;
697
698
0
    if (6 > data_len) {
699
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
700
0
                 "UBX: CFG-RATE, runt payload len %zd", data_len);
701
0
        return 0;
702
0
    }
703
704
0
    measRate = getleu16(buf, 0);  // Measurement rate (ms)
705
0
    navRate = getleu16(buf, 2);   // Navigation rate (cycles)
706
0
    timeRef = getleu16(buf, 4);   // Time system, e.g. UTC, GPS, ...
707
708
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
709
0
             "UBX: CFG-RATE: measRate %ums, navRate %u cycle(s), timeRef %u\n",
710
0
             (unsigned)measRate, (unsigned)navRate,
711
0
             (unsigned)timeRef);
712
713
    // Update our notion of what the device's measurement rate is
714
0
    MSTOTS(&session->gpsdata.dev.cycle, measRate);
715
716
0
    return 0;
717
0
}
718
719
/* UBX-CFG-VALGET
720
 * Present in protVer 24 and up
721
 */
722
static gps_mask_t ubx_msg_cfg_valget(struct gps_device_t *session,
723
                                   unsigned char *buf, size_t data_len)
724
0
{
725
0
    unsigned version, layer, position;
726
727
0
    if (4 > data_len) {
728
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
729
0
                 "UBX: CFG-VALGET, runt payload len %zd", data_len);
730
0
        return 0;
731
0
    }
732
733
0
    version = getub(buf, 0);        // version
734
735
0
    if (1 != version) {
736
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
737
0
                 "UBX: CFG-VALGET, unknown version %u\n", version);
738
0
        return 0;
739
0
    }
740
741
0
    layer = getub(buf, 1);           // layer
742
0
    position = getleu16(buf, 2);     // position
743
744
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
745
0
             "UBX: CFG-VALGET: version %u layer %u position %u\n",
746
0
             version, layer, position);
747
748
    // FIXME: get the key/value pairs.
749
750
0
    return 0;
751
0
}
752
753
/* UBX-ESF-ALG
754
 *
755
 * UBX-ESF-ALG, and UBX-ESF-INS are synchronous to the GNSS epoch.
756
 * They need to be combined and reported together with the rest of
757
 * the epoch.
758
 */
759
static gps_mask_t ubx_msg_esf_alg(struct gps_device_t *session,
760
                                  unsigned char *buf, size_t data_len)
761
0
{
762
0
    unsigned version, flags, error, reserved1;
763
0
    unsigned long yaw;
764
0
    int pitch, roll;
765
0
    static gps_mask_t mask = 0;
766
767
0
    if (16 > data_len) {
768
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
769
0
                 "UBX: ESF-ALG: runt payload len %zd", data_len);
770
0
        return mask;
771
0
    }
772
773
    // UBX-ESF-ALG is aligned with the GNSS epoch.
774
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
775
776
0
    version = getub(buf, 4);
777
0
    flags = getub(buf, 5);
778
0
    error = getub(buf, 6);
779
0
    reserved1 = getub(buf, 7);
780
0
    yaw = getleu32(buf, 8);
781
0
    pitch = getles16(buf, 12);
782
0
    roll = getles16(buf, 14);
783
784
0
    if (0 == (2 & error)) {
785
        // no yawAlgError
786
0
        session->gpsdata.attitude.yaw = 0.01 * yaw;
787
0
        mask |= ATTITUDE_SET;
788
0
    }
789
0
    if (0 == (5 & error)) {
790
        // no tiltAlgError or angleError
791
0
        session->gpsdata.attitude.roll = 0.01 * roll;
792
0
        session->gpsdata.attitude.pitch = 0.01 * pitch;
793
0
        mask |= ATTITUDE_SET;
794
0
    }
795
796
0
    if (0 != mask) {
797
0
        timespec_t ts_tow;
798
        // got good data, set the measurement time
799
0
        MSTOTS(&ts_tow, session->driver.ubx.iTOW);
800
0
        session->gpsdata.attitude.mtime =
801
0
            gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
802
0
    }
803
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
804
0
             "UBX: ESF-ALG: iTOW %lld version %u flags x%x error x%x"
805
0
             " reserved1 x%x yaw %ld pitch %u roll %u\n",
806
0
            (long long)session->driver.ubx.iTOW, version, flags, error,
807
0
            reserved1, yaw, pitch, roll);
808
809
0
    return mask;
810
0
}
811
812
/* UBX-ESF-INS
813
 *
814
 * protVer 19 and up.  ADR and UDR only
815
 *
816
 * UBX-ESF-ALG, and UBX-ESF-INS are synchronous to the GNSS epoch.
817
 * They need to be combined and reported together with the rest of
818
 * the epoch.
819
 */
820
static gps_mask_t ubx_msg_esf_ins(struct gps_device_t *session,
821
                                  unsigned char *buf, size_t data_len)
822
0
{
823
0
    unsigned long long bitfield0, reserved1;
824
0
    long xAngRate, yAngRate, zAngRate;
825
0
    long xAccel, yAccel, zAccel;
826
0
    static gps_mask_t mask = 0;
827
828
0
    if (16 > data_len) {
829
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
830
0
                 "UBX: ESF-INS: runt payload len %zd", data_len);
831
0
        return mask;
832
0
    }
833
834
0
    bitfield0 = getleu32(buf, 0);
835
0
    reserved1 = getleu32(buf, 4);
836
    // UBX-ESF-INS is aligned with the GNSS epoch.
837
0
    session->driver.ubx.iTOW = getleu32(buf, 8);
838
0
    xAngRate = getles32(buf, 12);
839
0
    yAngRate = getles32(buf, 16);
840
0
    zAngRate = getles32(buf, 20);
841
0
    xAccel = getles32(buf, 24);
842
0
    yAccel = getles32(buf, 28);
843
0
    zAccel = getles32(buf, 32);
844
845
0
    if (0x100 == (0x100 & bitfield0)) {
846
        // xAngRateValid
847
0
        session->gpsdata.attitude.gyro_x = 0.001 * xAngRate;  // deg/s
848
0
        mask |= ATTITUDE_SET;
849
0
    }
850
0
    if (0x200 == (0x200 & bitfield0)) {
851
        // yAngRateValid
852
0
        session->gpsdata.attitude.gyro_y = 0.001 * yAngRate;  // deg/s
853
0
        mask |= ATTITUDE_SET;
854
0
    }
855
0
    if (0x400 == (0x400 & bitfield0)) {
856
        // zAngRateValid
857
0
        session->gpsdata.attitude.gyro_z = 0.001 * zAngRate;  // deg/s
858
0
        mask |= ATTITUDE_SET;
859
0
    }
860
0
    if (0x800 == (0x800 & bitfield0)) {
861
        // xAccelValid
862
0
        session->gpsdata.attitude.acc_x = 0.01 * xAccel;  // m/s^2
863
0
        mask |= ATTITUDE_SET;
864
0
    }
865
0
    if (0x1000 == (0x1000 & bitfield0)) {
866
        // yAccelValid
867
0
        session->gpsdata.attitude.acc_y = 0.01 * yAccel;  // m/s^2
868
0
        mask |= ATTITUDE_SET;
869
0
    }
870
0
    if (0x2000 == (0x2000 & bitfield0)) {
871
        // zAccelValid
872
0
        session->gpsdata.attitude.acc_z = 0.01 * zAccel;  // m/s^2
873
0
        mask |= ATTITUDE_SET;
874
0
    }
875
876
0
    if (0 != mask) {
877
0
        timespec_t ts_tow;
878
        // got good data, set the measurement time
879
0
        MSTOTS(&ts_tow, session->driver.ubx.iTOW);
880
0
        session->gpsdata.attitude.mtime =
881
0
            gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
882
0
    }
883
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
884
0
             "UBX: ESF-INS: bitfield0 %llu, reserved1 %llu iTOW %lld"
885
0
             " xAngRate %ld yAngRate %ld zAngRate %ld"
886
0
             " xAccel %ld yAccel %ld zAccel %ld\n",
887
0
            bitfield0, reserved1,
888
0
            (long long)session->driver.ubx.iTOW,
889
0
            xAngRate, yAngRate, zAngRate, xAccel, yAccel, zAccel);
890
891
0
    return mask;
892
0
}
893
894
/* UBX-ESF-MEAS
895
 *
896
 * protVer 15 and up.  ADR only
897
 * protVer 19 and up.  ADR and UDR only
898
 *
899
 * asynchronous to the GNSS epoch, and at a higher rate.
900
 * Needs to be reported immediately.
901
 *
902
 */
903
static gps_mask_t ubx_msg_esf_meas(struct gps_device_t *session,
904
                                   unsigned char *buf, size_t data_len)
905
0
{
906
0
    unsigned flags, id, numMeas, expected_len;
907
0
    gps_mask_t mask = 0;
908
0
    unsigned i;
909
    // where to store the IMU data.
910
0
    struct attitude_t *datap = &session->gpsdata.imu[0];
911
912
0
    if (8 > data_len) {
913
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
914
0
                 "UBX: ESF-MEAS: runt payload len %zd", data_len);
915
0
        return mask;
916
0
    }
917
    // do not acumulate IMU data
918
0
    gps_clear_att(datap);
919
0
    (void)strlcpy(datap->msg, "UBX-ESF-MEAS", sizeof(datap->msg));
920
921
0
    datap->timeTag = getleu32(buf, 0);
922
0
    flags = getleu16(buf, 4);
923
0
    numMeas = (flags >> 11) & 0x01f;
924
0
    id = getleu16(buf, 6);
925
0
    expected_len = 8 + (4 * numMeas);
926
0
    if (0x08 & flags) {
927
0
        expected_len += 4;
928
0
    }
929
0
    if (expected_len != data_len) {
930
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
931
0
                 "UBX: ESF-MEAS: bad length.  Got %zd, expected %u",
932
0
                 data_len, expected_len);
933
0
        return 0;
934
0
    }
935
936
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
937
0
             "UBX: ESF-MEAS: timeTag %lu flags x%x (numMeas %u) id %u\n",
938
0
             datap->timeTag, flags, numMeas, id);
939
940
0
    for (i = 0; i < numMeas; i++) {
941
0
        unsigned long data, dataField;
942
0
        long dataF;
943
0
        unsigned char dataType;
944
945
0
        data = getleu32(buf, 8 + (i * 4));
946
0
        dataType = (unsigned char)(data >> 24) & 0x3f;
947
0
        dataField = data & BITMASK(24);
948
0
        switch (dataType) {
949
0
        case 5:            // gyro z angular rate, deg/s^2
950
0
            dataF = UINT2INT(dataField, 24);
951
0
            datap->gyro_z = dataF / 4096.0;
952
0
            mask |= IMU_SET;
953
0
            break;
954
0
        case 12:           // gyro temp, deg C
955
0
            dataF = UINT2INT(dataField, 24);
956
0
            datap->gyro_temp = dataF / 100.0;
957
0
            mask |= IMU_SET;
958
0
            break;
959
0
        case 13:           // gyro y angular rate, deg/s^2
960
0
            dataF = UINT2INT(dataField, 24);
961
0
            datap->gyro_y = dataF / 4096.0;
962
0
            mask |= IMU_SET;
963
0
            break;
964
0
        case 14:           // gyro x angular rate, deg/s^2
965
0
            dataF = UINT2INT(dataField, 24);
966
0
            datap->gyro_x = dataF / 4096.0;
967
0
            mask |= IMU_SET;
968
0
            break;
969
0
        case 16:            // accel x, m/s^2
970
0
            dataF = UINT2INT(dataField, 24);
971
0
            datap->acc_x = dataF / 1024.0;
972
0
            mask |= IMU_SET;
973
0
            break;
974
0
        case 17:           // accel y, m/s^2
975
0
            dataF = UINT2INT(dataField, 24);
976
0
            datap->acc_y = dataF / 1024.0;
977
0
            mask |= IMU_SET;
978
0
            break;
979
0
        case 18:           // accel z, m/s^2
980
0
            dataF = UINT2INT(dataField, 24);
981
0
            datap->acc_z = dataF / 1024.0;
982
0
            mask |= IMU_SET;
983
0
            break;
984
        // case 6:            // front-left wheel ticks
985
        // case 7:            // front-right wheel ticks
986
        // case 8:            // rear-left wheel ticks
987
        // case 9:            // rear-right wheel ticks
988
        // case 10:           // speed tick
989
        // case 11:           // speed, m/s
990
0
        default:
991
            // ignore all else
992
0
            dataF = dataField;
993
0
            break;
994
0
        }
995
996
0
        GPSD_LOG(LOG_PROG + 1, &session->context->errout,
997
0
                 "UBX: ESF-MEAS: dataType %2u dataField %9ld\n",
998
0
                 dataType, dataF);
999
0
    }
1000
1001
0
    return mask;
1002
0
}
1003
1004
/* UBX-ESF-RAW
1005
 *
1006
 * protVer 15 and up.  ADR only
1007
 * protVer 19 and up.  ADR and UDR only
1008
 *
1009
 * asynchronous to the GNSS epoch, and a a higher rate.
1010
 * Needs to be reported immediately.
1011
 *
1012
 */
1013
static gps_mask_t ubx_msg_esf_raw(struct gps_device_t *session,
1014
                                  unsigned char *buf, size_t data_len)
1015
0
{
1016
0
    unsigned long reserved1, last_sTtag = 0;
1017
0
    unsigned i;
1018
0
    uint16_t blocks;
1019
0
    gps_mask_t mask = 0;
1020
0
    struct attitude_t *datap = NULL;
1021
0
    int max_imu, cur_imu = -1;
1022
0
    max_imu = sizeof(session->gpsdata.imu) / sizeof(struct attitude_t);
1023
1024
0
    if (4 > data_len) {
1025
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1026
0
                 "UBX: ESF-RAW:runt payload len %zd", data_len);
1027
0
        return mask;
1028
0
    }
1029
1030
0
    reserved1 = getleu32(buf, 0);  // reserved1
1031
0
    if (0 != ((data_len - 4) % 8)) {
1032
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1033
0
                 "UBX: ESF-RAW: weird payload len %zd", data_len);
1034
0
        return mask;
1035
0
    }
1036
0
    blocks = (data_len - 4) / 8;
1037
1038
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1039
0
             "UBX: ESF-RAW: reserved1 x%lx, blocks %u\n",
1040
0
             reserved1, blocks);
1041
1042
    // loop over all blocks, use the next imu[] when time changes.
1043
0
    for (i = 0; i < blocks; i++) {
1044
0
        unsigned long data, dataField, sTtag;
1045
0
        long dataF;
1046
0
        unsigned char dataType;
1047
1048
0
        sTtag = getleu32(buf, 8 + (i * 8));
1049
0
        if ((-1 == cur_imu) ||
1050
0
            (last_sTtag != sTtag)) {
1051
0
            cur_imu++;
1052
0
            if (max_imu <= cur_imu) {
1053
0
                GPSD_LOG(LOG_WARN, &session->context->errout,
1054
0
                         "UBX: ESF-RAW: too many imu max %d block %u\n",
1055
0
                         max_imu, i);
1056
0
                break;
1057
0
            }
1058
0
            last_sTtag = sTtag;
1059
0
            datap = &session->gpsdata.imu[cur_imu];
1060
            // do not acumulate IMU data
1061
0
            gps_clear_att(datap);
1062
0
            (void)strlcpy(datap->msg, "UBX-ESF-RAW", sizeof(datap->msg));
1063
0
        }
1064
0
        if (NULL == datap) {
1065
            // paranoia
1066
0
            continue;
1067
0
        }
1068
1069
0
        data = getleu32(buf, 4 + (i * 8));
1070
0
        dataType = (unsigned char)(data >> 24) & 0x3f;
1071
0
        dataField = data & BITMASK(24);
1072
0
        datap->timeTag = sTtag;
1073
0
        switch (dataType) {
1074
0
        case 5:            // gyro z angular rate, deg/s^2
1075
0
            dataF = UINT2INT(dataField, 24);
1076
0
            datap->gyro_z = dataF / 4096.0;
1077
0
            mask |= IMU_SET;
1078
0
            break;
1079
0
        case 12:           // gyro temp, deg C
1080
0
            dataF = UINT2INT(dataField, 24);
1081
0
            datap->gyro_temp = dataF / 100.0;
1082
0
            mask |= IMU_SET;
1083
0
            break;
1084
0
        case 13:           // gyro y angular rate, deg/s^2
1085
0
            dataF = UINT2INT(dataField, 24);
1086
0
            datap->gyro_y = dataF / 4096.0;
1087
0
            mask |= IMU_SET;
1088
0
            break;
1089
0
        case 14:           // gyro x angular rate, deg/s^2
1090
0
            dataF = UINT2INT(dataField, 24);
1091
0
            datap->gyro_x = dataF / 4096.0;
1092
0
            mask |= IMU_SET;
1093
0
            break;
1094
0
        case 16:            // accel x, m/s^2
1095
0
            dataF = UINT2INT(dataField, 24);
1096
0
            datap->acc_x = dataF / 1024.0;
1097
0
            mask |= IMU_SET;
1098
0
            break;
1099
0
        case 17:           // accel y, m/s^2
1100
0
            dataF = UINT2INT(dataField, 24);
1101
0
            datap->acc_y = dataF / 1024.0;
1102
0
            mask |= IMU_SET;
1103
0
            break;
1104
0
        case 18:           // accel z, m/s^2
1105
0
            dataF = UINT2INT(dataField, 24);
1106
0
            datap->acc_z = dataF / 1024.0;
1107
0
            mask |= IMU_SET;
1108
0
            break;
1109
        // case 6:            // front-left wheel ticks
1110
        // case 7:            // front-right wheel ticks
1111
        // case 8:            // rear-left wheel ticks
1112
        // case 9:            // rear-right wheel ticks
1113
        // case 10:           // speed tick
1114
        // case 11:           // speed, m/s
1115
0
        default:
1116
            // ignore all else
1117
0
            dataF = dataField;
1118
0
            break;
1119
0
        }
1120
1121
0
        GPSD_LOG(LOG_PROG + 1, &session->context->errout,
1122
0
                 "UBX: ESF-RAW: dataType %2u dataField %9ld sTtag %lu\n",
1123
0
                 dataType, dataF, datap->timeTag);
1124
0
    }
1125
0
    return mask;
1126
0
}
1127
1128
// UBX-ESF-STATUS
1129
static gps_mask_t ubx_msg_esf_status(struct gps_device_t *session,
1130
                                     unsigned char *buf, size_t data_len)
1131
0
{
1132
0
    unsigned version, fusionMode, numSens, expected_len;
1133
0
    static gps_mask_t mask = 0;
1134
1135
0
    if (16 > data_len) {
1136
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1137
0
                 "UBX: ESF-STATUS:runt payload len %zd", data_len);
1138
0
        return mask;
1139
0
    }
1140
1141
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
1142
0
    version = getub(buf, 4);
1143
0
    fusionMode = getub(buf, 12);
1144
0
    numSens = getub(buf, 15);
1145
0
    expected_len = 16 + (4 * numSens);
1146
1147
0
    if (expected_len != data_len) {
1148
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1149
0
                 "UBX: ESF-STATUS: bad length.  Expected %u got %zd",
1150
0
                 expected_len, data_len);
1151
0
        return mask;
1152
0
    }
1153
1154
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1155
0
             "UBX: ESF-STATUS: iTOW %lld version %u fusionMode %u numSens %u\n",
1156
0
            (long long)session->driver.ubx.iTOW, version, fusionMode, numSens);
1157
1158
0
    return mask;
1159
0
}
1160
1161
/**
1162
 * HNR Attitude solution
1163
 * UBX-HNR-ATT Class x28, ID 1
1164
 *
1165
 * Not before u-blox 8, protVer 19.2 and up.
1166
 * only on ADR, and UDR
1167
 */
1168
static gps_mask_t ubx_msg_hnr_att(struct gps_device_t *session,
1169
                                  unsigned char *buf, size_t data_len)
1170
0
{
1171
0
    uint8_t version;
1172
0
    int64_t iTOW;
1173
0
    timespec_t ts_tow;
1174
0
    gps_mask_t mask = 0;
1175
1176
0
    if (32 > data_len) {
1177
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1178
0
                 "UBX: HNR-ATT: runt payload len %zd", data_len);
1179
0
        return 0;
1180
0
    }
1181
1182
    // don't set session->driver.ubx.iTOW, HNR is off-cycle
1183
0
    iTOW = getleu32(buf, 0);
1184
0
    MSTOTS(&ts_tow, iTOW);
1185
0
    session->gpsdata.attitude.mtime =
1186
0
        gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
1187
1188
0
    version  = (unsigned int)getub(buf, 4);
1189
1190
0
    session->gpsdata.attitude.roll = 1e-5 * getles32(buf, 8);
1191
0
    session->gpsdata.attitude.pitch = 1e-5 * getles32(buf, 12);
1192
    // seems to be true heading
1193
0
    session->gpsdata.attitude.heading = 1e-5 * getles32(buf, 16);
1194
0
    mask |= ATTITUDE_SET;
1195
1196
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1197
0
         "UBX: HNR-ATT: iTOW %lld version %u roll %.5f pitch %.5f "
1198
0
         "heading %.5f\n",
1199
0
         (long long)iTOW,
1200
0
         version,
1201
0
         session->gpsdata.attitude.roll,
1202
0
         session->gpsdata.attitude.pitch,
1203
0
         session->gpsdata.attitude.heading);
1204
1205
0
    return mask;
1206
0
}
1207
1208
/**
1209
 * HNR Vehicle dynamics information
1210
 * UBX-HNR-INS Class x28, ID 2
1211
 *
1212
 * Not before u-blox 8, protVer 19.1 and up.
1213
 * only on ADR, and UDR
1214
 */
1215
static gps_mask_t ubx_msg_hnr_ins(struct gps_device_t *session,
1216
                                  unsigned char *buf, size_t data_len)
1217
0
{
1218
0
    uint8_t version;
1219
0
    uint32_t bitfield0;
1220
0
    gps_mask_t mask = 0;
1221
0
    int64_t iTOW;
1222
1223
0
    if (36 > data_len) {
1224
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1225
0
                 "UBX: HNR-INS: runt payload len %zd", data_len);
1226
0
        return 0;
1227
0
    }
1228
1229
0
    version  = (unsigned int)getub(buf, 0);
1230
1231
0
    bitfield0 = getleu32(buf, 0);
1232
    // don't set session->driver.ubx.iTOW, HNR is off-cycle
1233
0
    iTOW = getleu32(buf, 8);
1234
1235
0
    if (0x100 == (0x100 & bitfield0)) {
1236
        // xAngRateValid
1237
0
        session->gpsdata.attitude.gyro_x = 0.001 * getles32(buf, 12);  // deg/s
1238
0
        mask |= ATTITUDE_SET;
1239
0
    }
1240
0
    if (0x200 == (0x200 & bitfield0)) {
1241
        // yAngRateValid
1242
0
        session->gpsdata.attitude.gyro_y = 0.001 * getles32(buf, 16);  // deg/s
1243
0
        mask |= ATTITUDE_SET;
1244
0
    }
1245
0
    if (0x400 == (0x400 & bitfield0)) {
1246
        // zAngRateValid
1247
0
        session->gpsdata.attitude.gyro_z = 0.001 * getles32(buf, 20);  // deg/s
1248
0
        mask |= ATTITUDE_SET;
1249
0
    }
1250
0
    if (0x800 == (0x800 & bitfield0)) {
1251
        // xAccelValid
1252
0
        session->gpsdata.attitude.acc_x = 0.01 * getles32(buf, 24);  // m/s^2
1253
0
        mask |= ATTITUDE_SET;
1254
0
    }
1255
0
    if (0x1000 == (0x1000 & bitfield0)) {
1256
        // yAccelValid
1257
0
        session->gpsdata.attitude.acc_y = 0.01 * getles32(buf, 28);  // m/s^2
1258
0
        mask |= ATTITUDE_SET;
1259
0
    }
1260
0
    if (0x2000 == (0x2000 & bitfield0)) {
1261
        // zAccelValid
1262
0
        session->gpsdata.attitude.acc_z = 0.01 * getles32(buf, 32);  // m/s^2
1263
0
        mask |= ATTITUDE_SET;
1264
0
    }
1265
1266
0
    if (0 != mask) {
1267
0
        timespec_t ts_tow;
1268
        // got good data, set the measurement time
1269
0
        MSTOTS(&ts_tow, iTOW);
1270
0
        session->gpsdata.attitude.mtime =
1271
0
            gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
1272
0
    }
1273
1274
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1275
0
         "UBX: HNR-INS: iTOW %lld version %u bitfield0 x%x "
1276
0
         "gyro_x %.3f gyro_y %.3f gyro_z %.3f "
1277
0
         "acc_x %.3f acc_y %.3f acc_z %.3f\n",
1278
0
         (long long)iTOW,
1279
0
         version, bitfield0,
1280
0
         session->gpsdata.attitude.gyro_x,
1281
0
         session->gpsdata.attitude.gyro_y,
1282
0
         session->gpsdata.attitude.gyro_z,
1283
0
         session->gpsdata.attitude.acc_x,
1284
0
         session->gpsdata.attitude.acc_y,
1285
0
         session->gpsdata.attitude.acc_z);
1286
1287
0
    return mask;
1288
0
}
1289
1290
/**
1291
 * High rate output of PVT solution
1292
 * UBX-HNR-PVT Class x28, ID 2
1293
 *
1294
 * Present in:
1295
 *    protVer 19 and up
1296
 *    only on ADR, and UDR
1297
 */
1298
static gps_mask_t ubx_msg_hnr_pvt(struct gps_device_t *session,
1299
                                  unsigned char *buf, size_t data_len)
1300
0
{
1301
0
    char buf2[80];
1302
0
    char buf3[80];
1303
0
    char ts_buf[TIMESPEC_LEN];
1304
0
    gps_mask_t mask = 0;
1305
0
    int64_t iTOW;
1306
0
    int *mode = &session->newdata.mode;
1307
0
    int *status = &session->newdata.status;
1308
0
    struct tm unpacked_date;
1309
0
    unsigned flags;
1310
0
    unsigned gpsFix;    // same as NAV-PVT typeFix
1311
0
    unsigned valid;
1312
1313
0
    if (72 > data_len) {
1314
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1315
0
                 "UBX: HNR-PVT: runt payload len %zd", data_len);
1316
0
        return 0;
1317
0
    }
1318
1319
    // don't set session->driver.ubx.iTOW, HNR is off-cycle
1320
0
    iTOW = getleu32(buf, 0);
1321
    // valid same as UBX-NAV-PVT valid
1322
0
    valid = (unsigned int)getub(buf, 11);
1323
    // gpsFix same as UBX-NAV-PVT fixType
1324
0
    gpsFix = (unsigned char)getub(buf, 16);
1325
    // flags NOT same as UBX-NAV-PVT flags
1326
0
    flags = (unsigned int)getub(buf, 17);
1327
1328
0
    switch (gpsFix) {
1329
0
    case UBX_MODE_TMONLY:
1330
        // 5 - Surveyed-in, so a precise 3D.
1331
0
        *mode = MODE_3D;
1332
0
        *status = STATUS_TIME;
1333
0
        mask |= STATUS_SET | MODE_SET;
1334
0
        break;
1335
1336
0
    case UBX_MODE_3D:
1337
        // 3
1338
0
        FALLTHROUGH
1339
0
    case UBX_MODE_GPSDR:
1340
        // 4
1341
0
        if (*mode != MODE_3D) {
1342
0
            *mode = MODE_3D;
1343
0
            mask |= MODE_SET;
1344
0
        }
1345
0
        *status = STATUS_GPS;   // GPSDR??
1346
0
        mask |= STATUS_SET | LATLON_SET;
1347
0
        break;
1348
1349
0
    case UBX_MODE_2D:
1350
        // 2
1351
0
        FALLTHROUGH
1352
0
    case UBX_MODE_DR:           // consider this too as 2D
1353
        // 1
1354
0
        if (MODE_2D != *mode) {
1355
0
            *mode = MODE_2D;
1356
0
            mask |= MODE_SET;
1357
0
        };
1358
0
        if (STATUS_GPS != *status) {
1359
            // FIXME: Set DR status if it is DR
1360
0
            *status = STATUS_GPS;
1361
0
            mask |= STATUS_SET;
1362
0
        }
1363
0
        mask |= LATLON_SET | SPEED_SET;
1364
0
        break;
1365
1366
0
    case UBX_MODE_NOFIX:
1367
        // 0
1368
0
        FALLTHROUGH
1369
0
    default:
1370
        // huh?
1371
0
        if (*mode != MODE_NO_FIX) {
1372
0
            *mode = MODE_NO_FIX;
1373
0
            mask |= MODE_SET;
1374
0
        };
1375
0
        if (*status != STATUS_UNK) {
1376
0
            *status = STATUS_UNK;
1377
0
            mask |= STATUS_SET;
1378
0
        }
1379
0
        break;
1380
0
    }
1381
1382
0
    if (UBX_NAV_PVT_FLAG_DGPS == (flags & UBX_NAV_PVT_FLAG_DGPS)) {
1383
        // RTK flags not in u-blox 8
1384
0
        if (UBX_NAV_PVT_FLAG_RTK_FIX == (flags & UBX_NAV_PVT_FLAG_RTK_FIX)) {
1385
0
            *status = STATUS_RTK_FIX;
1386
0
        } else if (UBX_NAV_PVT_FLAG_RTK_FLT ==
1387
0
                   (flags & UBX_NAV_PVT_FLAG_RTK_FLT)) {
1388
0
            *status = STATUS_RTK_FLT;
1389
0
        } else {
1390
0
            *status = STATUS_DGPS;
1391
0
        }
1392
0
        mask |= STATUS_SET;
1393
0
    }
1394
1395
0
    if (UBX_NAV_PVT_VALID_DATE_TIME == (valid & UBX_NAV_PVT_VALID_DATE_TIME)) {
1396
0
        unpacked_date.tm_year = (uint16_t)getleu16(buf, 4) - 1900;
1397
0
        unpacked_date.tm_mon = (uint8_t)getub(buf, 6) - 1;
1398
0
        unpacked_date.tm_mday = (uint8_t)getub(buf, 7);
1399
0
        unpacked_date.tm_hour = (uint8_t)getub(buf, 8);
1400
0
        unpacked_date.tm_min = (uint8_t)getub(buf, 9);
1401
0
        unpacked_date.tm_sec = (uint8_t)getub(buf, 10);
1402
0
        unpacked_date.tm_isdst = 0;
1403
0
        unpacked_date.tm_wday = 0;
1404
0
        unpacked_date.tm_yday = 0;
1405
0
        session->newdata.time.tv_sec = mkgmtime(&unpacked_date);
1406
        // field 9, nano, can be negative! So normalize
1407
0
        session->newdata.time.tv_nsec = getles32(buf, 12);
1408
0
        TS_NORM(&session->newdata.time);
1409
0
        mask |= TIME_SET | NTPTIME_IS | GOODTIME_IS;
1410
0
    }
1411
1412
0
    session->newdata.longitude = 1e-7 * getles32(buf, 20);
1413
0
    session->newdata.latitude = 1e-7 * getles32(buf, 24);
1414
    // altitude WGS84
1415
0
    session->newdata.altHAE = (double)1e-3 * getles32(buf, 28);
1416
    // altitude MSL, double to prevent promotion to (long double)
1417
0
    session->newdata.altMSL = (double)1e-3 * getles32(buf, 32);
1418
    // Let gpsd_error_model() deal with geoid_sep
1419
1420
    // gSpeed (2D)
1421
0
    session->newdata.speed = 1e-3 * (int32_t)getles32(buf, 36);
1422
    // offset 40,  Speed (3D) do what with it?
1423
    // u-blox calls this headMot (Heading of motion 2-D)
1424
0
    session->newdata.track = 1e-5 * (int32_t)getles32(buf, 44);
1425
    // offset 48, headVeh (Heading of Vehicle 2-D)
1426
0
    mask |= LATLON_SET | ALTITUDE_SET | SPEED_SET | TRACK_SET;
1427
1428
    /* u-blox does not document the basis for the following "accuracy"
1429
     * estimates.  Maybe CEP(50), one sigma, two sigma, CEP(99), etc. */
1430
1431
    // Horizontal Accuracy estimate, in mm
1432
0
    session->newdata.eph = (double)(getles32(buf, 52) / 1000.0);
1433
    // Vertical Accuracy estimate, in mm
1434
0
    session->newdata.epv = (double)(getles32(buf, 56) / 1000.0);
1435
    // Speed Accuracy estimate, in mm/s
1436
0
    session->newdata.eps = (double)(getles32(buf, 60) / 1000.0);
1437
    // headAcc (Heading Accuracy)
1438
0
    session->newdata.epd = (double)getles32(buf, 64) * 1e-5;
1439
    // let gpsd_error_model() do the rest
1440
1441
    // 4 final bytes reserved
1442
1443
0
    mask |= HERR_SET | SPEEDERR_SET | VERR_SET;
1444
    // HNR-PVT interleaves with the normal cycle, so cycle end is a mess
1445
0
    mask |= REPORT_IS;
1446
1447
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1448
0
         "UBX: HNR-PVT: iTOW %lld flags %02x time %s lat %.2f lon %.2f "
1449
0
         "altHAE %.2f track %.2f speed %.2f climb %.2f mode %d status %d "
1450
0
         "used %d\n",
1451
0
         (long long)iTOW, flags,
1452
0
         timespec_str(&session->newdata.time, ts_buf, sizeof(ts_buf)),
1453
0
         session->newdata.latitude,
1454
0
         session->newdata.longitude,
1455
0
         session->newdata.altHAE,
1456
0
         session->newdata.track,
1457
0
         session->newdata.speed,
1458
0
         session->newdata.climb,
1459
0
         session->newdata.mode,
1460
0
         session->newdata.status,
1461
0
         session->gpsdata.satellites_used);
1462
0
    GPSD_LOG(LOG_IO, &session->context->errout,
1463
0
             "UBX: HNR-PVT: gpsFix:%s flags:%s valid:%s\n",
1464
0
             val2str(gpsFix, vpvt_fixType),
1465
0
             flags2str(flags, fhnr_pvt_flags, buf2, sizeof(buf2)),
1466
0
             flags2str(valid, fpvt_valid, buf3, sizeof(buf3)));
1467
1468
0
    return mask;
1469
0
}
1470
1471
/* UBX-INF-*
1472
 *
1473
 * Present in:
1474
 *   protVer 13 (6-series)
1475
 *   to
1476
 *   protVer 34 (10-series)
1477
 */
1478
static gps_mask_t ubx_msg_inf(struct gps_device_t *session,
1479
                              unsigned char *buf, size_t data_len)
1480
0
{
1481
0
    unsigned msgid = getbes16(buf, 2);
1482
1483
    // No minimum payload length
1484
1485
0
    if (data_len > MAX_PACKET_LENGTH - 1) {
1486
0
        data_len = MAX_PACKET_LENGTH - 1;
1487
0
    }
1488
0
    if (INT_MAX < data_len) {
1489
0
        data_len = INT_MAX;
1490
0
    }
1491
1492
0
    GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: %s: %.*s\n",
1493
0
             val2str(msgid, vinf_ids),
1494
0
             (int)data_len, (char *)buf + UBX_PREFIX_LEN);
1495
0
    return 0;
1496
0
}
1497
1498
/**
1499
 * UBX-LOG-BATCH entry only part of UBX protocol
1500
 * Used for GPS standalone operation (internal batch retrieval)
1501
 */
1502
static gps_mask_t ubx_msg_log_batch(struct gps_device_t *session,
1503
                                    unsigned char *buf UNUSED, size_t data_len)
1504
0
{
1505
0
    struct tm unpacked_date = {0};
1506
0
    unsigned char contentValid, timeValid, flags, psmState;
1507
0
    bool gnssFixOK, diffSoln;
1508
0
    char ts_buf[TIMESPEC_LEN];
1509
0
    gps_mask_t mask = 0;
1510
1511
0
    gps_clear_log(&session->gpsdata.log);
1512
    // u-blox 8 100 bytes payload
1513
0
    if (100 > data_len) {
1514
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1515
0
                 "UBX: LOG-BATCH: runt len %zd", data_len);
1516
0
        return 0;
1517
0
    }
1518
0
    timeValid = getub(buf, 15);
1519
0
    if (3 != (timeValid & 3)) {
1520
        // No time, pointless...
1521
0
        return 0;
1522
0
    }
1523
1524
0
    unpacked_date.tm_year = getleu16(buf, 8) - 1900;
1525
0
    unpacked_date.tm_mon = getub(buf, 10) - 1;
1526
0
    unpacked_date.tm_mday = getub(buf, 11);
1527
0
    unpacked_date.tm_hour = getub(buf, 12);
1528
0
    unpacked_date.tm_min = getub(buf, 13);
1529
0
    unpacked_date.tm_sec = getub(buf, 14);
1530
1531
0
    contentValid = getub(buf, 1);
1532
0
    session->gpsdata.log.index_cnt = getleu16(buf, 2);
1533
1534
0
    session->gpsdata.log.then.tv_sec = mkgmtime(&unpacked_date);
1535
0
    session->gpsdata.log.then.tv_nsec = getles32(buf, 20);
1536
0
    TS_NORM(&session->gpsdata.log.then);
1537
1538
0
    session->gpsdata.log.fixType = getub(buf, 24);
1539
0
    flags = getub(   buf, 25);
1540
0
    gnssFixOK = flags & 1;
1541
0
    diffSoln = flags & 2;
1542
0
    psmState = ((flags >> 2) & 7);
1543
1544
    // flags2 undocumented
1545
    // flags2 = getub(   buf, 26);
1546
1547
0
    if ((gnssFixOK &&
1548
0
         2 <= session->gpsdata.log.fixType)) {
1549
        // good 2D fix
1550
0
        session->gpsdata.log.lon = 1.0e-7 * getles32(buf, 28);
1551
0
        session->gpsdata.log.lat = 1.0e-7 * getles32(buf, 32);
1552
0
        session->gpsdata.log.gSpeed = 1.0e-3 * getles32(buf, 64);
1553
        // seems to be true heading
1554
0
        session->gpsdata.log.heading = 1.0e-5 * getles32(buf, 68);
1555
0
        if (diffSoln) {
1556
0
            session->gpsdata.log.status = STATUS_DGPS;
1557
0
        } else {
1558
0
            session->gpsdata.log.status = STATUS_GPS;
1559
0
        }
1560
0
        if (3 <= session->gpsdata.log.fixType) {
1561
            // good 3D fix
1562
0
            session->gpsdata.log.altHAE = 1.0e-3 * getles32(buf, 36);
1563
0
        }
1564
0
    }
1565
0
    session->gpsdata.log.hAcc = 1.0e-3 * getleu32(buf, 44);
1566
1567
0
    GPSD_LOG(LOG_INF, &session->context->errout,
1568
0
            "UBX: LOG-BATCH: time=%s index_cnt=%u fixType=%u lon=%.7f lat=%.7f"
1569
0
             " gSpeed=%.3f heading=%.5f altHae=%.3f psmState=%u hAcc=%.3f\n",
1570
0
             timespec_str(&session->gpsdata.log.then, ts_buf, sizeof(ts_buf)),
1571
0
             session->gpsdata.log.index_cnt, session->gpsdata.log.fixType,
1572
0
             session->gpsdata.log.lon, session->gpsdata.log.lat,
1573
0
             session->gpsdata.log.gSpeed, session->gpsdata.log.heading,
1574
0
             session->gpsdata.log.altHAE, psmState,
1575
0
             session->gpsdata.log.hAcc);
1576
1577
1578
0
    if (1 == (contentValid & 1)) {
1579
        // extraPVT valid
1580
        //  iTOW = getleu32(buf, 4);
1581
0
        session->gpsdata.log.tAcc = (double)getleu32(buf, 16);
1582
0
        session->gpsdata.log.numSV = getub(buf, 27);
1583
0
        session->gpsdata.log.altMSL = 1.0e-3 * getles32(buf, 40);
1584
0
        session->gpsdata.log.vAcc = 1.0e-3 * getleu32(buf, 48);
1585
0
        session->gpsdata.log.velN = 1.0e-3 * getles32(buf, 52);
1586
0
        session->gpsdata.log.velE = 1.0e-3 * getles32(buf, 56);
1587
0
        session->gpsdata.log.velD = 1.0e-3 * getles32(buf, 60);
1588
0
        session->gpsdata.log.sAcc = 1.0e-3 * getleu32(buf, 72);
1589
0
        session->gpsdata.log.headAcc = 1.0e-5 * getleu32(buf, 76);
1590
0
        session->gpsdata.log.pDOP = 1.0e-2 * getleu32(buf, 80);
1591
0
        GPSD_LOG(LOG_INF, &session->context->errout,
1592
0
                "UBX: LOG-BATCH extraPVT: time=%s index_cnt=%d"
1593
0
                 " tAcc=%.2f numSV=%d altMSL=%.3f hAcc=%.2f vAcc=%.3f"
1594
0
                 " velN=%.3f velE=%.3f velD=%.3f sAcc=%.3f headAcc=%.5f"
1595
0
                 " pDOP=%.5f\n",
1596
0
                 timespec_str(&session->gpsdata.log.then, ts_buf,
1597
0
                              sizeof(ts_buf)),
1598
0
                 session->gpsdata.log.index_cnt,
1599
0
                 session->gpsdata.log.tAcc, session->gpsdata.log.numSV,
1600
0
                 session->gpsdata.log.altMSL, session->gpsdata.log.hAcc,
1601
0
                 session->gpsdata.log.vAcc, session->gpsdata.log.velN,
1602
0
                 session->gpsdata.log.velE, session->gpsdata.log.velD,
1603
0
                 session->gpsdata.log.sAcc, session->gpsdata.log.headAcc,
1604
0
                 session->gpsdata.log.pDOP);
1605
0
    }
1606
1607
0
    if (2 == (contentValid & 2)) {
1608
0
        session->gpsdata.log.distance = getleu32(buf, 84);
1609
0
        session->gpsdata.log.totalDistance = getleu32(buf, 88);
1610
0
        session->gpsdata.log.distanceStd = getleu32(buf, 92);
1611
0
        GPSD_LOG(LOG_INF, &session->context->errout,
1612
0
                 "UBX: LOG-BATCH extraOdo: time=%s index_cnt=%d distance=%.0f"
1613
0
                 " totalDistance=%.0f distanceStd=%.0f\n",
1614
0
                 timespec_str(&session->gpsdata.log.then, ts_buf,
1615
0
                              sizeof(ts_buf)),
1616
0
                 session->gpsdata.log.index_cnt, session->gpsdata.log.distance,
1617
0
                 session->gpsdata.log.totalDistance,
1618
0
                 session->gpsdata.log.distanceStd);
1619
0
    }
1620
1621
0
    mask |= LOG_SET;
1622
0
    return mask;
1623
0
}
1624
1625
/**
1626
 * UBX-LOG-INFO info of log status
1627
 * u-blox 7,8,9.  protVer 14 to 29
1628
 * WIP: Initial decode, log only.
1629
 *
1630
 */
1631
static gps_mask_t ubx_msg_log_info(struct gps_device_t *session,
1632
                                   unsigned char *buf UNUSED, size_t data_len)
1633
0
{
1634
0
    struct tm oldest_date = {0}, newest_date = {0};
1635
0
    timespec_t oldest = {0, 0};
1636
0
    timespec_t newest = {0, 0};
1637
0
    unsigned char version, status;
1638
0
    unsigned long filestoreCapacity;
1639
0
    unsigned long currentMaxLogSize;
1640
0
    unsigned long currentLogSize;
1641
0
    unsigned long entryCount;
1642
0
    char ts_buf[TIMESPEC_LEN];
1643
0
    char ts_buf1[TIMESPEC_LEN];
1644
0
    gps_mask_t mask = 0;
1645
1646
0
    gps_clear_log(&session->gpsdata.log);
1647
    // u-blox 7/8/9 48 bytes payload
1648
0
    if (48 > data_len) {
1649
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1650
0
                 "UBX: LOG-INFO: runt len %zd", data_len);
1651
0
        return 0;
1652
0
    }
1653
    // u-blox 7/8/9 version 1
1654
0
    version = getub(buf, 0);
1655
0
    filestoreCapacity = getleu32(buf, 4);
1656
0
    currentMaxLogSize = getleu32(buf, 16);
1657
0
    currentLogSize = getleu32(buf, 20);
1658
0
    entryCount = getleu32(buf, 24);
1659
0
    status = getub(buf, 44);
1660
1661
0
    oldest_date.tm_year = getleu16(buf, 28);
1662
0
    if (0 != oldest_date.tm_year) {
1663
0
        oldest_date.tm_year -= 1900;
1664
0
        oldest_date.tm_mon = getub(buf, 30) - 1;
1665
0
        oldest_date.tm_mday = getub(buf, 31);
1666
0
        oldest_date.tm_hour = getub(buf, 32);
1667
0
        oldest_date.tm_min = getub(buf, 33);
1668
0
        oldest_date.tm_sec = getub(buf, 34);
1669
0
        oldest.tv_sec = mkgmtime(&oldest_date);
1670
0
        oldest.tv_nsec = 0;
1671
0
        TS_NORM(&oldest);
1672
0
    }
1673
1674
0
    newest_date.tm_year = getleu16(buf, 36);
1675
0
    if (0 != newest_date.tm_year) {
1676
0
        newest_date.tm_year -= 1900;
1677
0
        newest_date.tm_mon = getub(buf, 38) - 1;
1678
0
        newest_date.tm_mday = getub(buf, 39);
1679
0
        newest_date.tm_hour = getub(buf, 40);
1680
0
        newest_date.tm_min = getub(buf, 41);
1681
0
        newest_date.tm_sec = getub(buf, 42);
1682
0
        newest.tv_sec = mkgmtime(&newest_date);
1683
0
        newest.tv_nsec = 0;
1684
0
        TS_NORM(&newest);
1685
0
    }
1686
1687
0
    GPSD_LOG(LOG_INF, &session->context->errout,
1688
0
             "UBX: LOG-INFO: version=%u status=x%x Cap=%lu MaxSize=%lu "
1689
0
             "Size=%lu cnt=%lu oldest=%s newest=%s\n",
1690
0
             version, status,
1691
0
             filestoreCapacity,
1692
0
             currentMaxLogSize,
1693
0
             currentLogSize,
1694
0
             entryCount,
1695
0
             timespec_str(&oldest, ts_buf, sizeof(ts_buf)),
1696
0
             timespec_str(&newest, ts_buf1, sizeof(ts_buf1)));
1697
1698
    // mask |= LOG_SET;
1699
0
    return mask;
1700
0
}
1701
1702
/*
1703
 * UBX-LOG-RETRIEVEPOS (Indexed PVT entry)
1704
 * Used for GPS standalone operation and host saved logs
1705
 * u-blox 7,8,9.  protVer 14 to 29
1706
 */
1707
static gps_mask_t ubx_msg_log_retrievepos(struct gps_device_t *session,
1708
                                          unsigned char *buf UNUSED,
1709
                                          size_t data_len)
1710
0
{
1711
0
    struct tm unpacked_date = {0};
1712
0
    unsigned char fixType;
1713
0
    gps_mask_t mask = 0;
1714
1715
0
    gps_clear_log(&session->gpsdata.log);
1716
    // u-blox 40 bytes payload
1717
0
    if (40 > data_len) {
1718
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1719
0
                 "UBX: LOG-RETRIEVEPOS: runt len %zd", data_len);
1720
0
        return 0;
1721
0
    }
1722
0
    unpacked_date.tm_year = getleu16(buf, 30);
1723
0
    if (1900 > unpacked_date.tm_year) {
1724
        // useless, no date
1725
0
        return 0;
1726
0
    }
1727
0
    unpacked_date.tm_year -= 1900;
1728
0
    unpacked_date.tm_mon = getub(buf, 32) - 1;
1729
0
    unpacked_date.tm_mday = getub(buf, 33);
1730
0
    unpacked_date.tm_hour = getub(buf, 34);
1731
0
    unpacked_date.tm_min = getub(buf, 35);
1732
0
    unpacked_date.tm_sec = getub(buf, 36);
1733
0
    session->gpsdata.log.then.tv_sec = mkgmtime(&unpacked_date);
1734
1735
0
    session->gpsdata.log.index_cnt = getleu32(buf, 0);
1736
0
    session->gpsdata.log.lon = getleu32(buf, 4) * 1.0e-7;
1737
0
    session->gpsdata.log.lat = getleu32(buf, 8) * 1.0e-7;
1738
0
    session->gpsdata.log.altMSL = getleu32(buf, 12) * 1.0e-3;
1739
    // hAcc CEP() unspecified...
1740
0
    session->gpsdata.log.hAcc = getleu32(buf, 16) * 1.0e-3;
1741
0
    session->gpsdata.log.gSpeed = getleu32(buf, 20) * 1.0e-3;
1742
    // seems to be true heading
1743
0
    session->gpsdata.log.heading = getleu32(buf, 24) * 1.0e-5;
1744
0
    fixType = getub(buf, 29);
1745
0
    session->gpsdata.log.numSV = getub(buf, 38);
1746
1747
0
    switch (fixType) {
1748
0
    case 1:
1749
        // doc is unclear: 2D or 3D?
1750
0
        session->gpsdata.log.fixType = MODE_3D;
1751
0
        session->gpsdata.log.status = STATUS_DR;
1752
0
        break;
1753
0
    case 2:
1754
0
        session->gpsdata.log.fixType = MODE_2D;
1755
0
        session->gpsdata.log.status = STATUS_GPS;
1756
0
        break;
1757
0
    case 3:
1758
0
        session->gpsdata.log.fixType = MODE_3D;
1759
0
        session->gpsdata.log.status = STATUS_GPS;
1760
0
        break;
1761
0
    case 4:
1762
        // doc is unclear: 2D or 3D?
1763
0
        session->gpsdata.log.fixType = MODE_3D;
1764
0
        session->gpsdata.log.status = STATUS_GNSSDR;
1765
0
        break;
1766
1767
0
    case 0:
1768
0
        FALLTHROUGH
1769
0
    default:
1770
        // huh?
1771
0
        session->gpsdata.log.fixType = MODE_NO_FIX;
1772
0
        session->gpsdata.log.status = STATUS_UNK;
1773
0
        break;
1774
0
    }
1775
1776
    // (long long) because of time_t
1777
0
    GPSD_LOG(LOG_INF, &session->context->errout,
1778
0
             "UBX: LOG-RETRIEVEPOS: time=%lld entryIndex=%d"
1779
0
             " lon=%.7f lat=%.7f altMSL=%.3f hAcc=%.3f"
1780
0
             " gspeed=%.3f heading=%.5f fixType=%d numSV=%d\n",
1781
0
             (long long)session->gpsdata.log.then.tv_sec,
1782
0
             session->gpsdata.log.index_cnt, session->gpsdata.log.lon,
1783
0
             session->gpsdata.log.lat, session->gpsdata.log.altMSL,
1784
0
             session->gpsdata.log.hAcc, session->gpsdata.log.gSpeed,
1785
0
             session->gpsdata.log.heading, session->gpsdata.log.fixType,
1786
0
             session->gpsdata.log.numSV);
1787
1788
1789
0
    mask |= LOG_SET;
1790
0
    return mask;
1791
0
}
1792
1793
/*
1794
 * UBX-LOG-RETRIEVEPOSEXTRA (Indexed Odometry entry)
1795
 * Used for GPS standalone operation and host saved logs
1796
 * u-blox 7,8,9.  protVer 14 to 29
1797
 */
1798
static gps_mask_t ubx_msg_log_retrieveposextra(struct gps_device_t *session,
1799
                                               unsigned char *buf UNUSED,
1800
                                               size_t data_len)
1801
0
{
1802
0
    struct tm unpacked_date = {0};
1803
0
    gps_mask_t mask = 0;
1804
1805
0
    gps_clear_log(&session->gpsdata.log);
1806
    // u-blox 32 bytes payload
1807
0
    if (32 > data_len) {
1808
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1809
0
                 "UBX: LOG-RETRIEVEPOSEXTRA: runt len %zd", data_len);
1810
0
        return 0;
1811
0
    }
1812
1813
0
    unpacked_date.tm_year = getleu16(buf, 6);
1814
0
    if (1900 > unpacked_date.tm_year) {
1815
        // useless, no date
1816
0
        return 0;
1817
0
    }
1818
0
    unpacked_date.tm_year -= 1900;
1819
0
    unpacked_date.tm_mon = getub(buf, 8) - 1;
1820
0
    unpacked_date.tm_mday = getub(buf, 9);
1821
0
    unpacked_date.tm_hour = getub(buf, 10);
1822
0
    unpacked_date.tm_min = getub(buf, 11);
1823
0
    unpacked_date.tm_sec = getub(buf, 12);
1824
1825
0
    session->gpsdata.log.then.tv_sec = mkgmtime(&unpacked_date);
1826
0
    session->gpsdata.log.index_cnt = getleu32(buf, 0);
1827
    // distance units undocumented!  Assume meters, as in UBX-LOG-BATCH
1828
0
    session->gpsdata.log.distance = (double)getleu32(buf, 16);
1829
1830
    // (long long) because of time_t
1831
0
    GPSD_LOG(LOG_INF, &session->context->errout,
1832
0
             "UBX: LOG-RETRIEVEPOSEXTRA:"
1833
0
             " time=%lld entryindex=%u distance=%.0f\n",
1834
0
             (long long)session->gpsdata.log.then.tv_sec,
1835
0
             session->gpsdata.log.index_cnt, session->gpsdata.log.distance);
1836
1837
0
    mask |= LOG_SET;
1838
0
    return mask;
1839
0
}
1840
1841
/*
1842
 * UBX-LOG-RETRIEVESTRING
1843
 * Used for GPS standalone operation and host saved logs
1844
 * u-blox 7,8,9.  protVer 14 to 29
1845
 */
1846
static gps_mask_t ubx_msg_log_retrievestring(struct gps_device_t *session,
1847
                                             unsigned char *buf UNUSED,
1848
                                             size_t data_len)
1849
0
{
1850
0
    struct tm unpacked_date = {0};
1851
0
    unsigned int byteCount;
1852
0
    gps_mask_t mask = 0;
1853
1854
0
    gps_clear_log(&session->gpsdata.log);
1855
    // u-blox 16+ bytes payload
1856
0
    if (16 > data_len) {
1857
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1858
0
                 "UBX: LOG-RETRIEVESTRING: runt len %zd", data_len);
1859
0
        return 0;
1860
0
    }
1861
1862
0
    unpacked_date.tm_year = getleu16(buf, 6);
1863
0
    if (1900 > unpacked_date.tm_year) {
1864
        // useless, no date
1865
0
        return 0;
1866
0
    }
1867
0
    unpacked_date.tm_year -= 1900;
1868
0
    unpacked_date.tm_mon = getub(buf, 8) - 1;
1869
0
    unpacked_date.tm_mday = getub(buf, 9);
1870
0
    unpacked_date.tm_hour = getub(buf, 10);
1871
0
    unpacked_date.tm_min = getub(buf, 11);
1872
0
    unpacked_date.tm_sec = getub(buf, 12);
1873
1874
0
    session->gpsdata.log.then.tv_sec = mkgmtime(&unpacked_date);
1875
0
    session->gpsdata.log.index_cnt = getleu32(buf, 0);
1876
0
    byteCount = getleu16(buf, 14);
1877
1878
    // string could be 0 to 256 bytes, plus NUL
1879
0
    (void)strlcpy(session->gpsdata.log.string, (const char*)&buf[16],
1880
0
                  sizeof(session->gpsdata.log.string));
1881
    // (long long) because of time_t
1882
0
    GPSD_LOG(LOG_INF, &session->context->errout,
1883
0
             "UBX: LOG-RETRIEVESTRING:"
1884
0
             " time=%lld entryindex=%u byteCount=%u string=%s\n",
1885
0
             (long long)session->gpsdata.log.then.tv_sec,
1886
0
             session->gpsdata.log.index_cnt,
1887
0
             byteCount, session->gpsdata.log.string);
1888
1889
0
    mask |= LOG_SET;
1890
0
    return mask;
1891
0
}
1892
1893
/* UBX-MON-COMMS
1894
 * Replacement for MON-RXBUF and MON-TXBUF
1895
 */
1896
static gps_mask_t ubx_msg_mon_comms(struct gps_device_t *session,
1897
                                    unsigned char *buf, size_t data_len)
1898
0
{
1899
0
    gps_mask_t mask = 0;
1900
0
    char buf2[80];
1901
0
    unsigned i;
1902
0
    unsigned version;
1903
0
    unsigned nPorts;
1904
0
    unsigned txErrors;
1905
0
    unsigned protIds[4];
1906
1907
0
    if (8 > data_len) {
1908
        // 8 + (nPorts * 40)
1909
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1910
0
                 "UBX: MON-COMMS: runt payload len %zd\n", data_len);
1911
0
        return 0;
1912
0
    }
1913
0
    version = getub(buf, 0);
1914
0
    if (0 != version) {
1915
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1916
0
                 "UBX: MON-COMMS unkwnown version %u\n", version);
1917
0
        return 0;
1918
0
    }
1919
0
    nPorts = getub(buf, 1);
1920
0
    if ((8 + (nPorts * 40)) > data_len) {
1921
        // 8 + (nPorts * 40)
1922
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
1923
0
                 "UBX: MON-COMMS unkwnown runt %zd\n", data_len);
1924
0
        return 0;
1925
0
    }
1926
0
    txErrors = getub(buf, 2);
1927
0
    for (i = 0; i < 4; i++) {
1928
0
        protIds[i] = getub(buf, 3 + i);
1929
0
    }
1930
1931
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
1932
0
             "UBX: MON-COMMS: version %u, nPorts %u txErrors x%x  "
1933
0
             "protIds %u %u %u %u\n",
1934
0
             version, nPorts, txErrors, protIds[0], protIds[1], protIds[2],
1935
0
             protIds[3]);
1936
0
    GPSD_LOG(LOG_IO, &session->context->errout,
1937
0
             "UBX: MON-COMMS: txErrors:%s protIds %s %s %s %s\n",
1938
0
             flags2str(txErrors, vmon_comms_txerrors, buf2, sizeof(buf2)),
1939
0
             val2str(protIds[0], vprotIds),
1940
0
             val2str(protIds[1], vprotIds),
1941
0
             val2str(protIds[2], vprotIds),
1942
0
             val2str(protIds[3], vprotIds));
1943
1944
0
    for (i = 0; i < nPorts; i++) {
1945
0
        unsigned portId = getleu16(buf, 8 + (i * 40));
1946
0
        unsigned txPending = getleu16(buf, 10 + (i * 40));
1947
0
        unsigned long txBytes = getleu32(buf, 12 + (i * 40));
1948
0
        unsigned txUsage = getub(buf, 16 + (i * 40));
1949
0
        unsigned txPeakUsage = getub(buf, 17 + (i * 40));
1950
0
        unsigned rxPending = getleu16(buf, 18 + (i * 40));
1951
0
        unsigned long rxBytes = getleu32(buf, 20 + (i * 40));
1952
0
        unsigned rxUsage = getub(buf, 24 + (i * 40));
1953
0
        unsigned rxPeakUsage = getub(buf, 25 + (i * 40));
1954
0
        unsigned overrunErrs = getleu16(buf, 26 + (i * 40));
1955
0
        unsigned long msgs = getleu32(buf, 28 + (i * 40));
1956
0
        unsigned long skipped = getleu32(buf, 44 + (i * 40));
1957
1958
0
        GPSD_LOG(LOG_IO, &session->context->errout,
1959
0
                 "UBX: MON-COMMS: portId:%s\n",
1960
0
                 val2str(portId, vtarget));
1961
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
1962
0
                 "UBX: MON-COMMS: portId x%x, "
1963
0
                 "txPending %u txBytes %lu txUsage %u%% txPeakUsage %u%% "
1964
0
                 "rxPending %u rxBytes %lu rxUsage %u%% rxPeakUsage %u%% "
1965
0
                 "overrunErrs %u msgs %lu skipped %lu\n",
1966
0
                 portId,
1967
0
                 txPending, txBytes, txUsage, txPeakUsage,
1968
0
                 rxPending, rxBytes, rxUsage, rxPeakUsage,
1969
0
                 overrunErrs, msgs, skipped);
1970
0
    }
1971
0
    return mask;
1972
0
}
1973
1974
/* UBX-MON-HW
1975
 * 68 bytes in protVer 12 ( 6-series)
1976
 *    Present from Antaris (4-series)
1977
 * 60 bytes in 8-series and 9-series
1978
 *    Deprecated in protVer 32. M9 and 10-series, use MON-HW and MON-RF
1979
 * 56 bytes in protVer 34 (10-series)
1980
 *    Deprecated. and undocumented,  on M10, use MON-HW and MON-RF
1981
 *
1982
 * Oddly, UBX-MON-HW is output after NAV-EOE.  So too lare for the one
1983
 * TPV for that epoch, and too early for the next epoch.
1984
 */
1985
static gps_mask_t ubx_msg_mon_hw(struct gps_device_t *session,
1986
                                 unsigned char *buf, size_t data_len)
1987
0
{
1988
0
    char buf2[80];
1989
0
    unsigned int noisePerMs;
1990
0
    unsigned int agcCnt;
1991
0
    unsigned int aStatus;
1992
0
    unsigned int aPower;
1993
0
    unsigned int flags;
1994
0
    unsigned int jamInd;
1995
0
    gps_mask_t mask = 0;
1996
1997
0
    if (60 > data_len) {
1998
        // Doc says 68, but 8-series can have 60
1999
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2000
0
                 "UBX: MON-HW: runt payload len %zd\n", data_len);
2001
0
        return 0;
2002
0
    }
2003
2004
0
    noisePerMs = getleu16(buf, 16);
2005
0
    agcCnt = getleu16(buf, 18);         // 0 to 8191
2006
0
    aStatus = getub(buf, 20);
2007
0
    aPower = getub(buf, 21);
2008
    /* flags:
2009
     * 5 only has rtcCalib
2010
     * 6 (6.03) adds safeBoot
2011
     * 6 (7.03) adds jammingState
2012
     * 9 adds xtalAbsent
2013
     */
2014
0
    flags = getub(buf, 22);
2015
    // VP, 17 bytes on protVer 15+
2016
    // VP, 25 bytes on u-blox 6
2017
    // jamInd, on 5 this is reserved
2018
0
    if (68 == data_len) {
2019
0
        jamInd = getub(buf, 53);
2020
0
    } else if (60 == data_len) {
2021
0
        jamInd = getub(buf, 45);
2022
0
    } else {
2023
        // probably 56 == data_len, undocuemted in M10
2024
0
        jamInd = 0;   // WTF?
2025
0
    }
2026
0
    session->newdata.jam = jamInd;
2027
2028
0
    switch (aStatus) {
2029
0
    case 2:
2030
0
        session->newdata.ant_stat = ANT_OK;
2031
0
        break;
2032
0
    case 3:
2033
0
        session->newdata.ant_stat = ANT_SHORT;
2034
0
        break;
2035
0
    case 4:
2036
0
        session->newdata.ant_stat = ANT_OPEN;
2037
0
        break;
2038
0
    case 0:
2039
        // Init
2040
0
        FALLTHROUGH
2041
0
    case 1:
2042
        // Unknown
2043
0
        FALLTHROUGH
2044
0
    default:
2045
        // Dunno...
2046
0
        break;
2047
0
    }
2048
0
    if (0 < jamInd ||
2049
0
        ANT_OK <= session->newdata.ant_stat) {
2050
0
        mask |= REPORT_IS;           // force a new, extra, TPV.
2051
0
    }
2052
2053
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2054
0
             "UBX: MON-HW: noisePerMs %u, agcCmt %u aStatus %u aPower %u "
2055
0
             "flags x%x jamInd %u\n",
2056
0
             noisePerMs, agcCnt, aStatus, aPower, flags, jamInd);
2057
0
    GPSD_LOG(LOG_IO, &session->context->errout,
2058
0
             "UBX: MON-HW:aStatus:%s aPower:%s flags:%s\n",
2059
0
             val2str(aStatus, vaStatus),
2060
0
             val2str(aPower, vaPower),
2061
0
             flags2str(flags, vmon_hw_flags, buf2, sizeof(buf2)));
2062
0
    return mask;
2063
0
}
2064
2065
/* UBX-MON-RF
2066
 * Present in protVer 27+ (9-series)
2067
 * Partially replaces MON-HW
2068
 *
2069
 * Oddly, UBX-MON-RF is output after NAV-EOE.  So too lare for the one
2070
 * TPV for that epoch, and too early for the next epoch.
2071
 */
2072
static gps_mask_t ubx_msg_mon_rf(struct gps_device_t *session,
2073
                                 unsigned char *buf, size_t data_len)
2074
0
{
2075
0
    unsigned i;
2076
0
    gps_mask_t mask = 0;
2077
0
    unsigned version = getub(buf, 0);
2078
0
    unsigned nBlocks = getub(buf, 1);
2079
2080
0
    if (4 > data_len) {
2081
        // 4 + (nBlocks * 24)
2082
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2083
0
                 "UBX: MON-RF: runt payload len %zd\n", data_len);
2084
0
        return 0;
2085
0
    }
2086
0
    if (0 != version) {
2087
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2088
0
                 "UBX: MON-RF unkwnown version %u\n", version);
2089
0
        return 0;
2090
0
    }
2091
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2092
0
             "UBX: MON-RF: version %u, nblocks %u\n", version, nBlocks);
2093
0
    for (i = 0; (i < nBlocks) && ((4 + (i * 24)) < data_len); i++){
2094
        /* ZED-F9N 1 == nBlock
2095
         * ZED-F9P 2 == nBlock
2096
         * what to do with with two jamInd and two antStatus? */
2097
0
        unsigned off = i * 24;
2098
0
        unsigned blockId = getub(buf, 4 + off);
2099
0
        unsigned flags =  getub(buf, 5 + off);
2100
0
        unsigned jammingState = flags & 3;
2101
0
        unsigned antStatus = getub(buf, 6 + off);
2102
0
        unsigned antPower = getub(buf, 7 + off);
2103
0
        unsigned long postStatus = getleu32(buf, 8 + off);
2104
0
        unsigned agcCnt = getleu16(buf, 18 + off);         // 0 to 8191
2105
0
        unsigned jamInd = getub(buf, 20 + off);
2106
0
        int ofsI = getsb(buf, 21 + off);
2107
0
        unsigned magI = getub(buf, 22 + off);
2108
0
        int ofsQ = getsb(buf, 23 + off);
2109
0
        unsigned magQ = getub(buf, 24 + off);
2110
2111
        // use the highest ant_stat and jamInd
2112
0
        if ((unsigned)session->newdata.ant_stat < antStatus) {
2113
0
            session->newdata.ant_stat = antStatus;
2114
0
        }
2115
0
        if ((unsigned)session->newdata.jam < jamInd) {
2116
0
            session->newdata.jam = jamInd;
2117
0
        }
2118
2119
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
2120
0
                 "UBX: MON-RF: blk %u flags x%x jammingState %u antStatus %u "
2121
0
                 "antPower %u\n"
2122
0
                 "MON-RF: postStatus %lu ageCnt %u jamInd %u "
2123
0
                 "ofsI %d magI %u ofsI %d magQ %u\n",
2124
0
                 blockId, flags, jammingState, antStatus, antPower,
2125
0
                 postStatus, agcCnt, jamInd,
2126
0
                 ofsI, magI, ofsQ, magQ);
2127
0
        GPSD_LOG(LOG_IO, &session->context->errout,
2128
0
                 "UBX: MON-RF:      antStatus:%s antPower:%s flags:%s\n",
2129
0
                 val2str(antStatus, vaStatus),
2130
0
                 val2str(antPower, vaPower),
2131
0
                 val2str(flags, vmon_rf_flags));
2132
0
    }
2133
0
    if (0 < session->newdata.jam ||
2134
0
        ANT_OK <= session->newdata.ant_stat) {
2135
0
        mask |= REPORT_IS;           // force a new, extra, TPV.
2136
0
    }
2137
0
    return mask;
2138
0
}
2139
2140
/* UBX-MON-RXBUF
2141
 * Present in u-blox 5+ through at least protVer 23.01
2142
 * Supported but deprecated in M9P protVer 27.11, use MON-COMMS
2143
 * Supported but deprecated in M9N protVer 32.00 */
2144
static gps_mask_t ubx_msg_mon_rxbuf(struct gps_device_t *session,
2145
                                    unsigned char *buf, size_t data_len)
2146
0
{
2147
0
    int i;
2148
2149
0
    if (24 != data_len) {
2150
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2151
0
                 "UBX: MON-RXBUF: runt payload len %zd\n", data_len);
2152
0
        return 0;
2153
0
    }
2154
2155
0
    for (i = 0; i < 6; i++) {
2156
0
        unsigned int pending = getleu16(buf, i * 2);
2157
0
        unsigned int usage =  getub(buf, 12 + i);
2158
0
        unsigned int peakUsage = getub(buf, 18 + i);
2159
2160
0
        GPSD_LOG(LOG_IO, &session->context->errout,
2161
0
                 "UBX: MON-RXBUF: tgt:%s\n",
2162
0
                 val2str(i, vtarget));
2163
0
        GPSD_LOG(LOG_INF, &session->context->errout,
2164
0
                 "UBX: MON-RXBUF: tgt%d pending %4u usage %3u%% peakUsage %3d%%\n",
2165
0
                 i, pending, usage, peakUsage);
2166
0
    }
2167
0
    return 0;
2168
0
}
2169
2170
/* UBX-MON-TXBUF
2171
 * Present in u-blox 5+ through at least protVer 23.01
2172
 * Supported but deprecated in M9P protVer 27.11
2173
 * Supported but deprecated in M9N protVer 32.00 */
2174
static gps_mask_t ubx_msg_mon_txbuf(struct gps_device_t *session,
2175
                                    unsigned char *buf, size_t data_len)
2176
0
{
2177
0
    char buf2[80];
2178
0
    unsigned tUsage, tPeakusage;
2179
0
    unsigned errors, limit, reserved1;
2180
0
    int i;
2181
2182
0
    if (28 != data_len) {
2183
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2184
0
                 "UBX: MON-TXBUF: runt payload len %zd\n", data_len);
2185
0
        return 0;
2186
0
    }
2187
2188
0
    errors = limit = getub(buf, 26);
2189
2190
0
    for (i = 0; i < 6; i++) {
2191
0
        unsigned int pending = getleu16(buf, i * 2);
2192
0
        unsigned int usage =  getub(buf, 12 + i);
2193
0
        unsigned int peakUsage = getub(buf, 18 + i);
2194
2195
0
        GPSD_LOG(LOG_IO, &session->context->errout,
2196
0
                 "UBX: MON-TXBUF: tgt:%s\n",
2197
0
                 val2str(i, vtarget));
2198
0
        GPSD_LOG(LOG_INF, &session->context->errout,
2199
0
                 "UBX: MON-TXBUF: tgt %d limit %u pending %4u "
2200
0
                 "usage %3u%% peakUsage %3d%%\n",
2201
0
                 i, limit & 1, pending, usage, peakUsage);
2202
0
        limit = limit >> 1;
2203
0
    }
2204
0
    tUsage = getub(buf, 24);
2205
0
    tPeakusage = getub(buf, 25);
2206
0
    reserved1 = getub(buf, 27);
2207
2208
0
    GPSD_LOG(LOG_INF, &session->context->errout,
2209
0
             "UBX: MON-TXBUF: tUsage %3u%%, tPeakusage %3u%%, errors 0x%02x, "
2210
0
             "reserved1 0x%02x\n",
2211
0
             tUsage, tPeakusage, errors, reserved1);
2212
2213
0
    GPSD_LOG(LOG_IO, &session->context->errout,
2214
0
             "UBX: MON-TXBUF: errors:%s\n",
2215
0
             flags2str(errors, vmon_txbuf_errors, buf2, sizeof(buf2)));
2216
0
    return 0;
2217
0
}
2218
2219
/**
2220
 * Receiver/Software Version
2221
 * UBX-MON-VER
2222
 *
2223
 * sadly more info than fits in session->swtype for now.
2224
 * so squish the data hard.
2225
 */
2226
static gps_mask_t ubx_msg_mon_ver(struct gps_device_t *session,
2227
                                  unsigned char *buf,
2228
                                  size_t data_len)
2229
0
{
2230
0
    int n = 0;                           // extended info counter
2231
0
    int num_ext = (data_len - 40) / 30;  // number of extensions
2232
0
    char obuf[128];                      // temp version string buffer
2233
0
    char *cptr;
2234
2235
0
    if (40 > data_len) {
2236
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2237
0
                 "UBX: MON-VER: runt payload len %zd", data_len);
2238
0
        return 0;
2239
0
    }
2240
2241
    // save SW and HW Version as subtype
2242
0
    (void)snprintf(obuf, sizeof(obuf),
2243
0
                   "SW %.30s,HW %.10s",
2244
0
                   (char *)buf,
2245
0
                   (char *)(buf + 30));
2246
2247
    // save what we can
2248
0
    (void)strlcpy(session->subtype, obuf, sizeof(session->subtype));
2249
2250
0
    obuf[0] = '\0';
2251
    // extract Extended info strings.
2252
0
    for (n = 0; n < num_ext; n++) {
2253
0
        int start_of_str = 40 + (30 * n);
2254
2255
0
        if (0 < n) {
2256
            // commas between elements
2257
0
            (void)strlcat(obuf, ",", sizeof(obuf));
2258
0
        }
2259
0
        (void)strlcat(obuf, (char *)&buf[start_of_str], sizeof(obuf));
2260
0
    }
2261
2262
    // save what we can in subtype1
2263
0
    (void)strlcpy(session->subtype1, obuf, sizeof(session->subtype1));
2264
2265
    // find PROTVER literal, followed by single separator character
2266
0
    cptr = strstr(obuf, "PROTVER=");     // protVer 18 and above
2267
0
    if (NULL == cptr) {
2268
0
        cptr = strstr(obuf, "PROTVER "); // protVer 17 and below
2269
0
    }
2270
0
    if (NULL != cptr) {
2271
0
        int protver = atoi(cptr + 8);
2272
0
        if (7 < protver) {
2273
            /* protver 8, u-blox Antaris, is the oldest we know, but never
2274
             * used explicitly.  protver 15, u-blox 8, is oldest seen. */
2275
0
            session->driver.ubx.protver = protver;
2276
0
        }
2277
0
    }
2278
2279
    /* MON-VER did not contain PROTVER in any extension field (typical for
2280
     * protVer < 15), so use mapping table to try to derive protVer from
2281
     * firmware revision number carried in swVersion field */
2282
0
    if (0 == session->driver.ubx.protver) {
2283
0
        for (n = 0; NULL != fw_protver_map[n].fw_string; n++) {
2284
            // skip "SW " prefix in session->subtype
2285
0
            cptr = strstr(session->subtype + 3, fw_protver_map[n].fw_string);
2286
            // use only when swVersion field starts with fw_string
2287
0
            if (cptr == (session->subtype + 3)) {
2288
0
                session->driver.ubx.protver =
2289
0
                    (unsigned char)fw_protver_map[n].protver;
2290
0
                break;
2291
0
            }
2292
0
        }
2293
0
        if (0 == session->driver.ubx.protver) {
2294
            // Still not found, old chip.  Set to one so we know we tried.
2295
0
            session->driver.ubx.protver = 1;
2296
0
        }
2297
0
    }
2298
2299
    // output SW and HW Version at LOG_INF
2300
0
    GPSD_LOG(LOG_INF, &session->context->errout,
2301
0
             "UBX: MON-VER: %s %s PROTVER %u\n",
2302
0
             session->subtype, session->subtype1,
2303
0
             session->driver.ubx.protver);
2304
2305
2306
0
    return 0;
2307
0
}
2308
2309
/**
2310
 * Clock Solution UBX-NAV-CLOCK
2311
 *
2312
 * Present in:
2313
 *     protVer 8 to 34 (Antaris 4 to M10)
2314
 */
2315
static gps_mask_t ubx_msg_nav_clock(struct gps_device_t *session,
2316
                                    unsigned char *buf, size_t data_len)
2317
0
{
2318
0
    unsigned long tAcc, fAcc;
2319
2320
0
    if (20 > data_len) {
2321
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2322
0
                 "UBX: NAV-CLOCK: runt payload len %zd", data_len);
2323
0
        return 0;
2324
0
    }
2325
2326
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2327
    // u-bloc 6 sets clockbias and clockdrift to 0
2328
0
    session->gpsdata.fix.clockbias = getles32(buf, 4);
2329
0
    session->gpsdata.fix.clockdrift = getles32(buf, 8);
2330
0
    tAcc = getleu32(buf, 12);
2331
0
    fAcc = getleu32(buf, 16);
2332
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2333
0
             "UBX: NAV-CLOCK: iTOW=%lld clkB %ld clkD %ld tAcc %lu fAcc %lu\n",
2334
0
             (long long)session->driver.ubx.iTOW,
2335
0
             session->gpsdata.fix.clockbias,
2336
0
             session->gpsdata.fix.clockdrift,
2337
0
             tAcc, fAcc);
2338
0
    return 0;
2339
0
}
2340
2341
/**
2342
 * DGPS Data Used for NAV
2343
 *
2344
 * May be good cycle ender
2345
 *
2346
 * Present in u-blox 7
2347
 */
2348
static gps_mask_t ubx_msg_nav_dgps(struct gps_device_t *session,
2349
                                   unsigned char *buf, size_t data_len)
2350
0
{
2351
0
    long age;
2352
2353
0
    if (16 > data_len) {
2354
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2355
0
                 "UBX: NAV-DGPS: runt payload len %zd", data_len);
2356
0
        return 0;
2357
0
    }
2358
2359
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2360
0
    age = getleu32(buf, 4);
2361
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2362
0
             "NAV-DGPS: iTOW=%lld age %ld\n",
2363
0
             (long long)session->driver.ubx.iTOW, age);
2364
0
    return 0;
2365
0
}
2366
2367
/**
2368
 * UBX-NAV-DOP, Dilution of precision message
2369
 *
2370
 * Present in all u-blox (4 to 10)
2371
 */
2372
static gps_mask_t ubx_msg_nav_dop(struct gps_device_t *session,
2373
                                  unsigned char *buf, size_t data_len)
2374
0
{
2375
0
    unsigned u;
2376
0
    gps_mask_t mask = 0;
2377
2378
0
    if (18 > data_len) {
2379
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2380
0
                 "UBX: NAV-DOP: runt payload len %zd", data_len);
2381
0
        return 0;
2382
0
    }
2383
2384
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2385
    /*
2386
     * We make a deliberate choice not to clear DOPs from the
2387
     * last skyview here, but rather to treat this as a supplement
2388
     * to our calculations from the visibility matrix, trusting
2389
     * the firmware algorithms over ours.
2390
     */
2391
0
    u = getleu16(buf, 4);
2392
0
    if (9999 > u) {
2393
0
        session->gpsdata.dop.gdop = (double)(u / 100.0);
2394
0
        mask |= DOP_SET;
2395
0
    }
2396
0
    u = getleu16(buf, 6);
2397
0
    if (9999 > u) {
2398
0
        session->gpsdata.dop.pdop = (double)(u / 100.0);
2399
0
        mask |= DOP_SET;
2400
0
    }
2401
0
    u = getleu16(buf, 8);
2402
0
    if (9999 > u) {
2403
0
        session->gpsdata.dop.tdop = (double)(u / 100.0);
2404
0
        mask |= DOP_SET;
2405
0
    }
2406
0
    u = getleu16(buf, 10);
2407
0
    if (9999 > u) {
2408
0
        session->gpsdata.dop.vdop = (double)(u / 100.0);
2409
0
        mask |= DOP_SET;
2410
0
    }
2411
0
    u = getleu16(buf, 12);
2412
0
    if (9999 > u) {
2413
0
        session->gpsdata.dop.hdop = (double)(u / 100.0);
2414
0
        mask |= DOP_SET;
2415
0
    }
2416
    // Northing DOP
2417
0
    u = getleu16(buf, 14);
2418
0
    if (9999 > u) {
2419
0
        session->gpsdata.dop.ydop = (double)(u / 100.0);
2420
0
        mask |= DOP_SET;
2421
0
    }
2422
    // Easting DOP
2423
0
    u = getleu16(buf, 16);
2424
0
    if (9999 > u) {
2425
0
        session->gpsdata.dop.xdop = (double)(u / 100.0);
2426
0
        mask |= DOP_SET;
2427
0
    }
2428
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2429
0
             "UBX: NAV-DOP: gdop=%.2f pdop=%.2f "
2430
0
             "hdop=%.2f vdop=%.2f tdop=%.2f ydop=%.2f xdop=%.2f\n",
2431
0
             session->gpsdata.dop.gdop,
2432
0
             session->gpsdata.dop.pdop,
2433
0
             session->gpsdata.dop.hdop,
2434
0
             session->gpsdata.dop.vdop,
2435
0
             session->gpsdata.dop.tdop,
2436
0
             session->gpsdata.dop.ydop,
2437
0
             session->gpsdata.dop.xdop);
2438
0
    return mask;
2439
0
}
2440
2441
/**
2442
 * Position error ellipse parameters
2443
 * protVer 19.1 and up
2444
 * Not in u-blox 5, 6 or 7
2445
 * Present in some u-blox 8, 9 and 10 (ADR, HPS)
2446
 */
2447
static gps_mask_t ubx_msg_nav_eell(struct gps_device_t *session,
2448
                                   unsigned char *buf, size_t data_len)
2449
0
{
2450
0
    unsigned version;
2451
0
    unsigned errEllipseOrient;
2452
0
    unsigned long errEllipseMajor, errEllipseMinor;
2453
2454
0
    if (16 > data_len) {
2455
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2456
0
                 "UBX: NAV-EELL: runt payload len %zd", data_len);
2457
0
        return 0;
2458
0
    }
2459
2460
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2461
0
    version = getub(buf, 4);
2462
0
    errEllipseOrient = getleu16(buf, 6);
2463
0
    errEllipseMajor = getleu32(buf, 8);
2464
0
    errEllipseMinor = getleu32(buf, 12);
2465
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2466
0
             "UBX: NAV-EELL: iTOW %lld version %u errEllipseOrient %u "
2467
0
             "errEllipseMajor %lu errEllipseMinor %lu\n",
2468
0
             (long long)session->driver.ubx.iTOW, version, errEllipseOrient,
2469
0
             errEllipseMajor, errEllipseMinor);
2470
0
    return 0;
2471
0
}
2472
2473
/**
2474
 * End of Epoch
2475
 * Not in u-blox 5, 6 or 7
2476
 * Present in:
2477
 *    protVer 18 (8-series, 9)
2478
 */
2479
static gps_mask_t ubx_msg_nav_eoe(struct gps_device_t *session,
2480
                                  unsigned char *buf, size_t data_len)
2481
0
{
2482
0
    if (4 > data_len) {
2483
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2484
0
                 "UBX: NAV-EOE: runt payload len %zd", data_len);
2485
0
        return 0;
2486
0
    }
2487
2488
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2489
0
    GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-EOE: iTOW=%lld\n",
2490
0
             (long long)session->driver.ubx.iTOW);
2491
    // nothing to report, but the iTOW for cycle ender is good
2492
0
    return 0;
2493
0
}
2494
2495
/*
2496
 * UBX-NAV-HPPOSECEF - High Precision Position Solution in ECEF
2497
 *
2498
 * Present in u-blox 8 and above, protVwer 20.00 and up.
2499
 * Only with High Precision firmware.
2500
 */
2501
static gps_mask_t ubx_msg_nav_hpposecef(struct gps_device_t *session,
2502
                                        unsigned char *buf, size_t data_len)
2503
0
{
2504
0
    gps_mask_t mask = ECEF_SET;
2505
0
    int version;
2506
2507
0
    if (28 > data_len) {
2508
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2509
0
                 "UBX: NAV-HPPOSECEF: runt payload len %zd", data_len);
2510
0
        return 0;
2511
0
    }
2512
2513
0
    version = getub(buf, 0);
2514
0
    session->driver.ubx.iTOW = getleu32(buf, 4);
2515
0
    session->newdata.ecef.x = getles32x100s8d(buf, 8, 20, 1e-4);
2516
0
    session->newdata.ecef.y = getles32x100s8d(buf, 12, 21, 1e-4);
2517
0
    session->newdata.ecef.z = getles32x100s8d(buf, 16, 22, 1e-4);
2518
2519
0
    session->newdata.ecef.pAcc = getleu32(buf, 24) / (double)10000.0;
2520
    // (long long) cast for 32-bit compat
2521
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2522
0
        "UBX: NAV-HPPOSECEF: version %d iTOW=%lld ECEF x=%.4f y=%.4f z=%.4f "
2523
0
        "pAcc=%.4f\n",
2524
0
        version,
2525
0
        (long long)session->driver.ubx.iTOW,
2526
0
        session->newdata.ecef.x,
2527
0
        session->newdata.ecef.y,
2528
0
        session->newdata.ecef.z,
2529
0
        session->newdata.ecef.pAcc);
2530
0
    return mask;
2531
0
}
2532
2533
 /**
2534
 * High Precision Geodetic Position Solution
2535
 * UBX-NAV-HPPOSLLH, Class 1, ID x14
2536
 *
2537
 * No mode, so limited usefulness.
2538
 *
2539
 * Present in u-blox 8 and above, protVwer 20.00 and up.
2540
 * Only with High Precision firmware.
2541
 */
2542
static gps_mask_t ubx_msg_nav_hpposllh(struct gps_device_t *session,
2543
                                       unsigned char *buf, size_t data_len)
2544
0
{
2545
0
    int version;
2546
0
    gps_mask_t mask = 0;
2547
2548
0
    if (36 > data_len) {
2549
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2550
0
                 "UBX: NAV-HPPOSLLH: runt payload len %zd", data_len);
2551
0
        return mask;
2552
0
    }
2553
2554
0
    mask = ONLINE_SET | HERR_SET | VERR_SET | LATLON_SET | ALTITUDE_SET;
2555
2556
0
    version = getub(buf, 0);
2557
0
    session->driver.ubx.iTOW = getles32(buf, 4);
2558
0
    session->newdata.longitude = getles32x100s8d(buf, 8, 24, 1e-9);
2559
0
    session->newdata.latitude = getles32x100s8d(buf, 12, 25, 1e-9);
2560
    // altitude WGS84
2561
0
    session->newdata.altHAE = getles32x100s8d(buf, 16, 26, 1e-5);
2562
    // altitude MSL
2563
0
    session->newdata.altMSL = getles32x100s8d(buf, 20, 27, 1e-5);
2564
    // Let gpsd_error_model() deal with geoid_sep
2565
2566
    // Horizontal accuracy estimate in .1 mm, unknown est type
2567
0
    session->newdata.eph = getleu32(buf, 28) * (double)1e-4;
2568
    // Vertical accuracy estimate in .1 mm, unknown est type
2569
0
    session->newdata.epv = getleu32(buf, 32) * (double)1e-4;
2570
2571
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2572
0
        "UBX: NAV-HPPOSLLH: version %d iTOW=%lld lat=%.4f lon=%.4f "
2573
0
        "altHAE=%.4f\n",
2574
0
        version,
2575
0
        (long long)session->driver.ubx.iTOW,
2576
0
        session->newdata.latitude,
2577
0
        session->newdata.longitude,
2578
0
        session->newdata.altHAE);
2579
0
    return mask;
2580
0
}
2581
2582
/*
2583
 * Navigation Position ECEF message
2584
 *
2585
 * This message does not bother to tell us if it is valid.
2586
 */
2587
static gps_mask_t ubx_msg_nav_posecef(struct gps_device_t *session,
2588
                                      unsigned char *buf, size_t data_len)
2589
0
{
2590
0
    gps_mask_t mask = ECEF_SET;
2591
2592
0
    if (20 > data_len) {
2593
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2594
0
                 "UBX: NAV-POSECEF: runt payload len %zd", data_len);
2595
0
        return 0;
2596
0
    }
2597
2598
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2599
    // all in cm
2600
0
    session->newdata.ecef.x = getles32(buf, 4) * 1e-2;
2601
0
    session->newdata.ecef.y = getles32(buf, 8) * 1e-2;
2602
0
    session->newdata.ecef.z = getles32(buf, 12) * 1e-2;
2603
0
    session->newdata.ecef.pAcc = getleu32(buf, 16) * 1e-2;
2604
2605
    // (long long) cast for 32-bit compat
2606
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2607
0
        "UBX: NAV-POSECEF: iTOW=%lld ECEF x=%.2f y=%.2f z=%.2f pAcc=%.2f\n",
2608
0
        (long long)session->driver.ubx.iTOW,
2609
0
        session->newdata.ecef.x,
2610
0
        session->newdata.ecef.y,
2611
0
        session->newdata.ecef.z,
2612
0
        session->newdata.ecef.pAcc);
2613
0
    return mask;
2614
0
}
2615
2616
 /**
2617
 * Geodetic position solution message
2618
 * UBX-NAV-POSLLH, Class 1, ID 2
2619
 *
2620
 * This message does not bother to tell us if it is valid.
2621
 * No mode, so limited usefulness
2622
 */
2623
static gps_mask_t ubx_msg_nav_posllh(struct gps_device_t *session,
2624
                                     unsigned char *buf,
2625
                                     size_t data_len UNUSED)
2626
0
{
2627
0
    gps_mask_t mask = 0;
2628
2629
0
    if (28 > data_len) {
2630
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2631
0
                 "UBX: NAV-POSLLH: runt payload len %zd", data_len);
2632
0
        return 0;
2633
0
    }
2634
2635
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2636
0
    session->newdata.longitude = 1e-7 * getles32(buf, 4);
2637
0
    session->newdata.latitude = 1e-7 * getles32(buf, 8);
2638
    // altitude WGS84
2639
0
    session->newdata.altHAE = 1e-3 * getles32(buf, 12);
2640
    // altitude MSL
2641
0
    session->newdata.altMSL = 1e-3 * getles32(buf, 16);
2642
    // Let gpsd_error_model() deal with geoid_sep
2643
2644
    // Horizontal accuracy estimate in mm, unknown type
2645
0
    session->newdata.eph = getleu32(buf, 20) * 1e-3;
2646
    // Vertical accuracy estimate in mm, unknown type
2647
0
    session->newdata.epv = getleu32(buf, 24) * 1e-3;
2648
2649
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2650
0
        "UBX: NAV-POSLLH: iTOW=%lld lat=%.3f lon=%.3f altHAE=%.3f "
2651
0
        "eph %.3f epv %.3f\n",
2652
0
        (long long)session->driver.ubx.iTOW,
2653
0
        session->newdata.latitude,
2654
0
        session->newdata.longitude,
2655
0
        session->newdata.altHAE,
2656
0
        session->newdata.eph,
2657
0
        session->newdata.epv);
2658
2659
0
    mask = ONLINE_SET | HERR_SET | VERR_SET | LATLON_SET | ALTITUDE_SET;
2660
0
    return mask;
2661
0
}
2662
2663
/**
2664
 * Navigation Position Velocity Time solution message
2665
 * UBX-NAV-PVT Class 1, ID 7
2666
 *
2667
 * Present in:
2668
 *   protver 14  (6-series w/ GLONASS, 7-series)
2669
 *
2670
 * Not present in:
2671
 *    u-blox 5 or 6
2672
 */
2673
static gps_mask_t ubx_msg_nav_pvt(struct gps_device_t *session,
2674
                                  unsigned char *buf, size_t data_len)
2675
0
{
2676
0
    char buf2[80];
2677
0
    char buf3[80];
2678
0
    char buf4[80];
2679
0
    char buf5[80];
2680
0
    unsigned dgps_age;
2681
0
    unsigned fixType;
2682
0
    unsigned flags;
2683
0
    unsigned flags2;
2684
0
    unsigned flags3;
2685
0
    unsigned valid;
2686
0
    struct tm unpacked_date;
2687
0
    int *status = &session->newdata.status;
2688
0
    int *mode = &session->newdata.mode;
2689
0
    gps_mask_t mask = 0;
2690
0
    char ts_buf[TIMESPEC_LEN];
2691
2692
    // u-blox 6 and 7 are 84 bytes, u-blox 8 and 9 are 92 bytes
2693
0
    if (84 > data_len) {
2694
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2695
0
                 "UBX: NAV-PVT: runt payload len %zd", data_len);
2696
0
        return 0;
2697
0
    }
2698
2699
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2700
0
    valid = getub(buf, 11);
2701
0
    fixType = getub(buf, 20);
2702
0
    flags = getub(buf, 21);
2703
0
    flags2 = getub(buf, 22);
2704
0
    flags3 = getleu16(buf, 78);
2705
2706
0
    switch (fixType) {
2707
0
    case UBX_MODE_TMONLY:
2708
        // 5 - Surveyed-in, so a precise 3D.
2709
0
        *mode = MODE_3D;
2710
0
        *status = STATUS_TIME;
2711
0
        mask |= STATUS_SET | MODE_SET;
2712
0
        break;
2713
2714
0
    case UBX_MODE_3D:
2715
        // 3
2716
0
        FALLTHROUGH
2717
0
    case UBX_MODE_GPSDR:
2718
        // 4
2719
0
        if (*mode != MODE_3D) {
2720
0
            *mode = MODE_3D;
2721
0
            mask |= MODE_SET;
2722
0
        }
2723
0
        *status = STATUS_GPS;
2724
0
        mask |= STATUS_SET | LATLON_SET;
2725
0
        break;
2726
2727
0
    case UBX_MODE_2D:
2728
        // 2
2729
0
        FALLTHROUGH
2730
0
    case UBX_MODE_DR:           // consider this too as 2D
2731
        // 1
2732
0
        if (MODE_2D != *mode) {
2733
0
            *mode = MODE_2D;
2734
0
            mask |= MODE_SET;
2735
0
        };
2736
0
        if (STATUS_GPS != *status) {
2737
            // FIXME: Set DR if this is DR
2738
0
            *status = STATUS_GPS;
2739
0
            mask |= STATUS_SET;
2740
0
        }
2741
0
        mask |= LATLON_SET | SPEED_SET;
2742
0
        break;
2743
2744
0
    case UBX_MODE_NOFIX:
2745
        // 0
2746
0
        FALLTHROUGH
2747
0
    default:
2748
        // huh?
2749
0
        if (*mode != MODE_NO_FIX) {
2750
0
            *mode = MODE_NO_FIX;
2751
0
            mask |= MODE_SET;
2752
0
        };
2753
0
        if (*status != STATUS_UNK) {
2754
0
            *status = STATUS_UNK;
2755
0
            mask |= STATUS_SET;
2756
0
        }
2757
0
        break;
2758
0
    }
2759
2760
0
    if (UBX_NAV_PVT_FLAG_DGPS == (flags & UBX_NAV_PVT_FLAG_DGPS)) {
2761
        // RTK flags not before protoVer 20.
2762
0
        if (UBX_NAV_PVT_FLAG_RTK_FIX == (flags & UBX_NAV_PVT_FLAG_RTK_FIX)) {
2763
0
            *status = STATUS_RTK_FIX;
2764
0
        } else if (UBX_NAV_PVT_FLAG_RTK_FLT ==
2765
0
                   (flags & UBX_NAV_PVT_FLAG_RTK_FLT)) {
2766
0
            *status = STATUS_RTK_FLT;
2767
0
        } else {
2768
0
            *status = STATUS_DGPS;
2769
0
        }
2770
2771
0
        dgps_age = (flags3 >> 1) & 0x0f;
2772
0
        if (0 < dgps_age) {
2773
0
            if (ROWS(pvt_dgps_age) <= dgps_age) {
2774
0
                dgps_age = ROWS(pvt_dgps_age) - 1;
2775
0
            }
2776
0
            session->newdata.dgps_age = pvt_dgps_age[dgps_age];
2777
0
        }
2778
0
        mask |= STATUS_SET;
2779
0
    }
2780
2781
0
    if ((valid & UBX_NAV_PVT_VALID_DATE_TIME) == UBX_NAV_PVT_VALID_DATE_TIME) {
2782
0
        unpacked_date.tm_year = (uint16_t)getleu16(buf, 4) - 1900;
2783
0
        unpacked_date.tm_mon = (uint8_t)getub(buf, 6) - 1;
2784
0
        unpacked_date.tm_mday = (uint8_t)getub(buf, 7);
2785
0
        unpacked_date.tm_hour = (uint8_t)getub(buf, 8);
2786
0
        unpacked_date.tm_min = (uint8_t)getub(buf, 9);
2787
0
        unpacked_date.tm_sec = (uint8_t)getub(buf, 10);
2788
0
        unpacked_date.tm_isdst = 0;
2789
0
        unpacked_date.tm_wday = 0;
2790
0
        unpacked_date.tm_yday = 0;
2791
0
        session->newdata.time.tv_sec = mkgmtime(&unpacked_date);
2792
        // field 16, nano, can be negative! So normalize
2793
0
        session->newdata.time.tv_nsec = getles32(buf, 16);
2794
0
        TS_NORM(&session->newdata.time);
2795
0
        mask |= TIME_SET | NTPTIME_IS | GOODTIME_IS;
2796
0
    }
2797
2798
0
    session->newdata.longitude = 1e-7 * getles32(buf, 24);
2799
0
    session->newdata.latitude = 1e-7 * getles32(buf, 28);
2800
    // altitude WGS84
2801
0
    session->newdata.altHAE = 1e-3 * getles32(buf, 32);
2802
    // altitude MSL
2803
0
    session->newdata.altMSL = 1e-3 * getles32(buf, 36);
2804
    // Let gpsd_error_model() deal with geoid_sep
2805
2806
0
    session->newdata.speed = 1e-3 * (int32_t)getles32(buf, 60);
2807
    // u-blox calls this Heading of motion (2-D)
2808
0
    session->newdata.track = 1e-5 * (int32_t)getles32(buf, 64);
2809
0
    mask |= LATLON_SET | ALTITUDE_SET | SPEED_SET | TRACK_SET;
2810
2811
    /* u-blox does not document the basis for the following "accuracy"
2812
     * estimates.  Maybe CEP(50), one sigma, two sigma, CEP(99), etc. */
2813
2814
    // Horizontal Accuracy estimate, in mm
2815
0
    session->newdata.eph = (double)(getles32(buf, 40) / 1000.0);
2816
    // Vertical Accuracy estimate, in mm
2817
0
    session->newdata.epv = (double)(getles32(buf, 44) / 1000.0);
2818
    // Speed Accuracy estimate, in mm/s
2819
0
    session->newdata.eps = (double)(getles32(buf, 68) / 1000.0);
2820
    // let gpsd_error_model() do the rest
2821
2822
0
    mask |= HERR_SET | SPEEDERR_SET | VERR_SET;
2823
    // if cycle ender worked, could get rid of this REPORT_IS.
2824
    // mask |= REPORT_IS;
2825
2826
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2827
0
         "UBX: NAV-PVT: flags %02x time=%s lat %.2f lon %.2f altHAE=%.2f "
2828
0
         "track=%.2f speed=%.2f mode=%d status=%d used=%d dgps_age %.0f\n",
2829
0
         flags,
2830
0
         timespec_str(&session->newdata.time, ts_buf, sizeof(ts_buf)),
2831
0
         session->newdata.latitude,
2832
0
         session->newdata.longitude,
2833
0
         session->newdata.altHAE,
2834
0
         session->newdata.track,
2835
0
         session->newdata.speed,
2836
0
         session->newdata.mode,
2837
0
         session->newdata.status,
2838
0
         session->gpsdata.satellites_used,
2839
0
        session->newdata.dgps_age);
2840
0
    GPSD_LOG(LOG_IO, &session->context->errout,
2841
0
             "UBX: NAV-PVT: fixType:%s flags:%s flags2:%s flags3:%s "
2842
0
             "valid:%s\n",
2843
0
             val2str(fixType, vpvt_fixType),
2844
0
             flags2str(flags, fnav_pvt_flags, buf2, sizeof(buf2)),
2845
0
             flags2str(flags2, fpvt_flags2, buf3, sizeof(buf3)),
2846
0
             flags2str(flags3, fpvt_flags3, buf4, sizeof(buf4)),
2847
0
             flags2str(valid, fpvt_valid, buf5, sizeof(buf5)));
2848
0
    if (92 <= data_len) {
2849
        // u-blox 8 and 9 extended
2850
0
        double magDec = NAN;
2851
0
        double magAcc = NAN;
2852
#ifdef __UNUSED
2853
        if (flags & UBX_NAV_PVT_FLAG_HDG_OK) {
2854
            /* u-blox calls this Heading of vehicle (2-D)
2855
             * why is it different than earlier track? */
2856
            session->newdata.track = (double)(getles32(buf, 84) * 1e-5);
2857
        }
2858
#endif  // __UNUSED
2859
0
        if (valid & UBX_NAV_PVT_VALID_MAG) {
2860
0
            magDec = (double)(getles16(buf, 88) * 1e-2);
2861
0
            magAcc = (double)(getleu16(buf, 90) * 1e-2);
2862
0
        }
2863
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
2864
0
             " UBX: NAV-PVT: headVeh %.5f magDec %.2f magAcc %.2f\n",
2865
0
             session->newdata.track, magDec, magAcc);
2866
0
    }
2867
0
    return mask;
2868
0
}
2869
2870
 /**
2871
 * High Precision Relative Positioning Information in NED frame
2872
 * UBX-NAV-RELPOSNED, Class 1, ID x3c
2873
 * HP GNSS only, protver 20+
2874
 */
2875
static gps_mask_t ubx_msg_nav_relposned(struct gps_device_t *session,
2876
                                        unsigned char *buf, size_t data_len)
2877
0
{
2878
0
    int version;
2879
0
    unsigned flags;
2880
0
    double accN = NAN, accE = NAN, accD = NAN, accL = NAN, accH = NAN;
2881
0
    gps_mask_t mask = 0;
2882
2883
0
    if (40 > data_len) {
2884
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
2885
0
                 "UBX: NAV-RELPOSNED:0: runt payload len %zd",
2886
0
                 data_len);
2887
0
        return mask;
2888
0
    }
2889
0
    version = getub(buf, 0);
2890
    /* WTF?  u-blox did not make this sentence upward compatible
2891
     * 40 bytes in Version 0, protVer 20 to 27
2892
     * 64 bytes in Version 1, protVer 27.11+ */
2893
2894
0
    session->newdata.dgps_station = getleu16(buf, 2);          // 0 to 4095
2895
0
    session->driver.ubx.iTOW = getleu32(buf, 4);
2896
0
    if (1 > version) {
2897
        // version 0
2898
0
        flags = getleu32(buf, 36);
2899
0
        if (1 != (1 & flags)) {
2900
            // not gnssFixOK
2901
0
            GPSD_LOG(LOG_PROG, &session->context->errout,
2902
0
                     "UBX: NAV-RELPOSNED:0 no fix");
2903
0
            return mask;
2904
0
        }
2905
0
        if (4 & flags) {
2906
            // rePosValid
2907
0
            session->newdata.NED.relPosN = getles32x100s8d(buf, 8, 20, 1e-4);
2908
0
            session->newdata.NED.relPosE = getles32x100s8d(buf, 12, 21, 1e-4);
2909
0
            session->newdata.NED.relPosD = getles32x100s8d(buf, 16, 22, 1e-4);
2910
2911
0
            accN = 1e-4 * getles32(buf, 24);
2912
0
            accE = 1e-4 * getles32(buf, 28);
2913
0
            accD = 1e-4 * getles32(buf, 32);
2914
0
            mask |= NED_SET;
2915
0
        }
2916
0
    } else {
2917
        // assume version 1
2918
0
        if (64 > data_len) {
2919
0
            GPSD_LOG(LOG_WARN, &session->context->errout,
2920
0
                     "UBX: NAV-RELPOSNED:1: runt payload len %zd",
2921
0
                     data_len);
2922
0
            return mask;
2923
0
        }
2924
0
        flags = getleu32(buf, 60);
2925
0
        if (1 != (1 & flags)) {
2926
            // not gnssFixOK
2927
0
            GPSD_LOG(LOG_PROG, &session->context->errout,
2928
0
                     "UBX: NAV-RELPOSNED:1 no fix");
2929
0
            return mask;
2930
0
        }
2931
0
        if (4 & flags) {
2932
            // rePosValid
2933
0
            session->newdata.NED.relPosN = getles32x100s8d(buf, 8, 32, 1e-4);
2934
0
            session->newdata.NED.relPosE = getles32x100s8d(buf, 12, 33, 1e-4);
2935
0
            session->newdata.NED.relPosD = getles32x100s8d(buf, 16, 34, 1e-4);
2936
0
            session->newdata.NED.relPosL = getles32x100s8d(buf, 20, 35, 1e-4);
2937
2938
0
            accN = 1e-4 * getles32(buf, 36);
2939
0
            accE = 1e-4 * getles32(buf, 40);
2940
0
            accD = 1e-4 * getles32(buf, 44);
2941
0
            accL = 1e-4 * getles32(buf, 48);
2942
0
            accH = 1e-4 * getles32(buf, 52);
2943
0
            if (0x100 & flags) {
2944
                // relPosHeadingValid
2945
0
                session->newdata.NED.relPosH = 1e-5 * getles32(buf, 24);
2946
0
            }
2947
0
            mask |= NED_SET;
2948
            // FIXME: RTK flags?
2949
0
        }
2950
0
    }
2951
2952
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
2953
0
        "UBX: NAV-RELPOSNED: version %d iTOW=%lld refStationId %u flags x%x\n"
2954
0
        "UBX: NAV-RELPOSNED: relPos N=%.4f E=%.4f D=%.4f\n"
2955
0
        "UBX: NAV-RELPOSNED: acc N=%.4f E=%.4f D=%.4f L=%.4f H=%.4f\n",
2956
0
        version,
2957
0
        (long long)session->driver.ubx.iTOW,
2958
0
        session->newdata.dgps_station,
2959
0
        flags,
2960
0
        session->newdata.NED.relPosN,
2961
0
        session->newdata.NED.relPosE,
2962
0
        session->newdata.NED.relPosD,
2963
0
        accN, accE, accD, accL, accH);
2964
2965
0
    if (5 != (flags & 5)) {
2966
        // gnssFixOK or relPosValid are false, no fix
2967
0
        return 0;
2968
0
    }
2969
0
    return mask;
2970
0
}
2971
2972
/**
2973
 * GPS Satellite Info -- new style UBX-NAV-SAT
2974
 * Not present in:
2975
 *     u-blox 5
2976
 *     protVer 12  5 and 6-series
2977
 * Present in:
2978
 *    protVer 15_  8-series
2979
 *    protVer 27   (ZED-F9P)
2980
 */
2981
static gps_mask_t ubx_msg_nav_sat(struct gps_device_t *session,
2982
                                  unsigned char *buf, size_t data_len)
2983
0
{
2984
0
    char buf2[80];
2985
0
    unsigned int i, nchan, nsv, st, ver;
2986
0
    timespec_t ts_tow;
2987
2988
0
    if (8 > data_len) {
2989
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
2990
0
                 "UBX: NAV-SAT runt datalen %zd\n", data_len);
2991
0
        return 0;
2992
0
    }
2993
2994
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
2995
0
    MSTOTS(&ts_tow, session->driver.ubx.iTOW);
2996
0
    session->gpsdata.skyview_time =
2997
0
        gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
2998
2999
0
    ver = (unsigned int)getub(buf, 4);
3000
0
    if (1 != ver) {
3001
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3002
0
                 "UBX: NAV-SAT unknown version %d", ver);
3003
0
        return 0;
3004
0
    }
3005
0
    nchan = (unsigned int)getub(buf, 5);
3006
0
    if (nchan > MAXCHANNELS) {
3007
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3008
0
                 "UBX: NAV-SAT: runt >%d reported visible",
3009
0
                 MAXCHANNELS);
3010
0
        return 0;
3011
0
    }
3012
3013
0
    gpsd_zero_satellites(&session->gpsdata);
3014
0
    nsv = 0;
3015
0
    for (i = st = 0; i < nchan; i++) {
3016
0
        unsigned int off = 8 + 12 * i;
3017
0
        short nmea_PRN = 0;
3018
0
        uint8_t gnssId = getub(buf, off + 0);
3019
0
        uint8_t svId = getub(buf, off + 1);
3020
0
        uint8_t cno = getub(buf, off + 2);
3021
        // health data in flags
3022
0
        unsigned long flags = getleu32(buf, off + 8);
3023
0
        bool used = (bool)(flags  & 0x08);
3024
0
        int tmp;
3025
0
        int prRes;
3026
        // Notice NO sigid!
3027
3028
0
        nmea_PRN = ubx2_to_prn(gnssId, svId);
3029
0
        session->gpsdata.skyview[st].gnssid = gnssId;
3030
0
        session->gpsdata.skyview[st].svid = svId;
3031
0
        session->gpsdata.skyview[st].PRN = nmea_PRN;
3032
3033
0
        session->gpsdata.skyview[st].ss = (double)cno;
3034
0
        tmp = getsb(buf, off + 3);
3035
0
        if (90 >= abs(tmp)) {
3036
0
            session->gpsdata.skyview[st].elevation = (double)tmp;
3037
0
        }
3038
0
        tmp = getles16(buf, off + 4);
3039
0
        if (359 > tmp && 0 <= tmp) {
3040
0
            session->gpsdata.skyview[st].azimuth = (double)tmp;
3041
0
        }
3042
0
        session->gpsdata.skyview[st].used = used;
3043
0
        prRes = getles16(buf, off + 4);
3044
0
        session->gpsdata.skyview[st].prRes = prRes / 10.0;
3045
        // by some coincidence, our health flags matches u-blox's
3046
0
        session->gpsdata.skyview[st].health = (flags >> 4) & 3;
3047
0
        session->gpsdata.skyview[st].qualityInd = flags & 7;
3048
        // sbas_in_use is not same as used
3049
0
        if (used) {
3050
0
            nsv++;
3051
0
            session->gpsdata.skyview[st].used = true;
3052
0
        }
3053
        // FIXME: sigid?
3054
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3055
0
                 "UBX: NAV-SAT gnssid %u, svid %u PRN %d "
3056
0
                 "prRes %d cno %u qual %d flags x%lx\n",
3057
0
                 gnssId, svId, nmea_PRN, prRes, cno,
3058
0
                 session->gpsdata.skyview[st].qualityInd,
3059
0
                 flags);
3060
0
        GPSD_LOG(LOG_IO, &session->context->errout,
3061
0
                 "UBX: NAV-SAT: gnssId:%s flags:%s quality:%s\n",
3062
0
                 val2str(gnssId, vgnssId),
3063
0
                 flags2str(flags, fsat_flags, buf2, sizeof(buf2)),
3064
0
                 val2str(flags & 7, vquality));
3065
3066
0
        st++;
3067
0
    }
3068
3069
0
    session->gpsdata.satellites_visible = (int)st;
3070
0
    session->gpsdata.satellites_used = (int)nsv;
3071
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3072
0
             "UBX: NAV-SAT: visible=%d used=%d mask={SATELLITE|USED}\n",
3073
0
             session->gpsdata.satellites_visible,
3074
0
             session->gpsdata.satellites_used);
3075
0
    return SATELLITE_SET | USED_IS;
3076
0
}
3077
3078
/*
3079
 * SBAS Info UBX-NAV-SBAS
3080
 * in u-blox 4_
3081
 * in NEO-M9N
3082
 * Not in some u-blox 9
3083
 * Decode looks good, but data only goes to log.
3084
 */
3085
static gps_mask_t ubx_msg_nav_sbas(struct gps_device_t *session,
3086
                                   unsigned char *buf, size_t data_len)
3087
0
{
3088
0
    unsigned i, cnt;
3089
0
    unsigned ubx_PRN;
3090
0
    short nmea_PRN;
3091
0
    unsigned char gnssid = 0;
3092
0
    unsigned char svid = 0;
3093
3094
0
    if (12 > data_len) {
3095
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3096
0
                 "UBX: NAV-SBAS: runt payload len %zd", data_len);
3097
0
        return 0;
3098
0
    }
3099
3100
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3101
0
    ubx_PRN = getub(buf, 4);
3102
0
    cnt = getub(buf, 8);
3103
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3104
0
             "UBX: NAV-SBAS iTOW %lu geo %u mode %u sys %u service x%x "
3105
0
             "cnt %u\n",
3106
0
             (unsigned long)session->driver.ubx.iTOW,
3107
0
             ubx_PRN, (unsigned)getub(buf, 5),
3108
0
             (unsigned)getub(buf, 6), (unsigned)getub(buf, 7),
3109
0
             cnt);
3110
3111
0
    if (MAXCHANNELS < cnt) {
3112
        // too many sats for us, pacify coverity
3113
0
        cnt = MAXCHANNELS;
3114
0
    }
3115
0
    if (data_len < (12 + (12 * cnt))) {
3116
        // length check, pacify coverity
3117
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3118
0
                 "UBX: NAV-SBAS: bad length %zd", data_len);
3119
0
    }
3120
0
    for (i = 0; i < cnt; i++) {
3121
0
        int off = 12 + (12 * i);
3122
0
        unsigned svID = getub(buf, off);
3123
0
        unsigned flags = getub(buf, off + 1);
3124
        // User Differential Range Error (udre)
3125
0
        unsigned udre = getub(buf, off + 2);
3126
0
        int svSys = getsb(buf, off + 3);
3127
0
        unsigned svService = getub(buf, off + 4);
3128
0
        int prc = getles16(buf, off + 6);
3129
0
        int ic = getles16(buf, off + 10);
3130
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3131
0
                 "UBX: NAV-SBAS SV%3u flags x%02x udre %u svSys %2d "
3132
0
                 "svService x%x prc %d ic %d\n",
3133
0
                 svID, flags, udre, svSys, svService, prc, ic);
3134
0
    }
3135
    /* really 'in_use' depends on the sats info, EGNOS is still
3136
     * in test.  In WAAS areas one might also check for the type of
3137
     * corrections indicated
3138
     */
3139
3140
0
    nmea_PRN = ubx_to_prn(ubx_PRN, &gnssid, &svid);
3141
#ifdef __UNUSED
3142
    // debug
3143
    GPSD_LOG(LOG_ERROR, &session->context->errout,
3144
             "UBX: NAV-SBAS ubx_prn %d gnssid %d, svid %d nmea_PRN %d\n",
3145
             ubx_PRN, gnssid, svid, nmea_PRN);
3146
#endif  // __UNUSED
3147
0
    session->driver.ubx.sbas_in_use = nmea_PRN;
3148
0
    return 0;
3149
0
}
3150
3151
/**
3152
 * Satellite Info -- UBX-NAV-SIG
3153
 *
3154
 * Like NAV-SAT, but NAV-SIG has no elevation and azimuth!  So we need both.
3155
 * Assume NAV-SAT was sent in this epoch before NAV-SIG.
3156
 * Seems like NAV-SAT always sent just before NAV-SIG.
3157
 *
3158
 * Present in:
3159
 *    protVer 27 (9-series and 10)
3160
 * Not present in:
3161
 *    protVer 12 6-eries
3162
 *    before protVer 27
3163
 */
3164
static gps_mask_t ubx_msg_nav_sig(struct gps_device_t *session,
3165
                                  unsigned char *buf, size_t data_len)
3166
0
{
3167
0
    unsigned int i, nchan, nsv, st, ver;
3168
0
    timespec_t ts_tow;
3169
    // saved skyview, hopefully from NAV-SAT
3170
0
    struct satellite_t skyview_old[MAXCHANNELS];
3171
3172
0
    if (8 > data_len) {
3173
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3174
0
                 "UBX: NAV-SIG runt datalen %zd\n", data_len);
3175
0
        return 0;
3176
0
    }
3177
3178
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3179
0
    MSTOTS(&ts_tow, session->driver.ubx.iTOW);
3180
0
    session->gpsdata.skyview_time =
3181
0
        gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
3182
3183
0
    ver = getub(buf, 4);
3184
0
    if (0 != ver) {
3185
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3186
0
                 "UBX: NAV-SIG unknown version %d s/b 0", ver);
3187
0
        return 0;
3188
0
    }
3189
0
    nchan = (unsigned int)getub(buf, 5);
3190
0
    if (nchan > MAXCHANNELS) {
3191
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3192
0
                 "UBX: NAV-SIG: runt >%d reported visible",
3193
0
                 MAXCHANNELS);
3194
0
        return 0;
3195
0
    }
3196
    // two "unused" bytes at buf[6:7]
3197
3198
    /* elevation and azimuth are in NAV-SAT, make a copy of any NAV-SAT
3199
     * data before initializiing it. */
3200
0
    memcpy(skyview_old, session->gpsdata.skyview, sizeof(skyview_old));
3201
3202
0
    gpsd_zero_satellites(&session->gpsdata);
3203
0
    nsv = 0;
3204
0
    for (i = st = 0; i < nchan; i++) {
3205
        // like NAV-SAT, but 16 bytes instead of 12, no elevation or azimuth
3206
0
        char buf2[80];
3207
0
        int sat_old;
3208
0
        unsigned off = 8 + 16 * i;
3209
0
        short nmea_PRN = 0;
3210
0
        uint8_t gnssId = getub(buf, off + 0);
3211
0
        uint8_t svId = getub(buf, off + 1);
3212
0
        uint8_t sigId = getub(buf, off + 2);
3213
0
        uint8_t freqid = getub(buf, off + 3);
3214
0
        int16_t prRes = getles16(buf, off + 4);     // 0.1 m
3215
0
        uint8_t cno = getub(buf, off + 6);          // dBHz
3216
0
        uint8_t qualityInd = getub(buf, off + 7);   // quality indicator
3217
0
        uint8_t corrSource = getub(buf, off + 8);   // correlation source
3218
0
        uint8_t ionoModel = getub(buf, off + 9);    // Ionospheric model used:
3219
0
        unsigned sigFlags = getleu16(buf, off + 10);
3220
        // not exactly right...
3221
0
        bool used = 4 <= qualityInd ? true : false;
3222
3223
        // last 4 vytes, reserved
3224
0
        uint32_t reserved = getleu32(buf, 12);
3225
3226
0
        nmea_PRN = ubx2_to_prn(gnssId, svId);
3227
3228
0
        session->gpsdata.skyview[st].gnssid = gnssId;
3229
0
        session->gpsdata.skyview[st].svid = svId;
3230
0
        session->gpsdata.skyview[st].sigid = sigId;
3231
0
        session->gpsdata.skyview[st].freqid = freqid;
3232
0
        session->gpsdata.skyview[st].PRN = nmea_PRN;
3233
0
        session->gpsdata.skyview[st].prRes = prRes / 10.0;
3234
0
        session->gpsdata.skyview[st].qualityInd = qualityInd;
3235
3236
0
        session->gpsdata.skyview[st].ss = (double)cno;
3237
0
        session->gpsdata.skyview[st].used = used;
3238
        // by some coincidence, our health flags matches u-blox's
3239
0
        session->gpsdata.skyview[st].health = sigFlags & 3;
3240
        // sbas_in_use is not same as used
3241
0
        if (used) {
3242
0
            nsv++;
3243
0
            session->gpsdata.skyview[st].used = true;
3244
0
        }
3245
        // try to keep elevation and azimuth from NAV-SAT
3246
0
        for (sat_old = 0; sat_old < MAXCHANNELS; sat_old++) {
3247
0
            if (0 >= skyview_old[sat_old].PRN) {
3248
                // end of list, not found
3249
0
                break;
3250
0
            }
3251
0
            if (nmea_PRN != skyview_old[sat_old].PRN) {
3252
                // not this one
3253
0
                continue;
3254
0
            }
3255
            // found it, grab the data
3256
0
            session->gpsdata.skyview[st].elevation =
3257
0
                skyview_old[sat_old].elevation;
3258
0
            session->gpsdata.skyview[st].azimuth =
3259
0
                skyview_old[sat_old].azimuth;
3260
0
            break;
3261
0
        }
3262
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3263
0
                 "UBX: NAV-SIG gnssid %u, svid %u sigid %u PRN %d freqid %u "
3264
0
                 "prRes %d cno %u qual %u corr %u, iono %u flags x%x res x%x\n",
3265
0
                 gnssId, svId, sigId, nmea_PRN, freqid, prRes, cno,
3266
0
                 qualityInd, corrSource, ionoModel, sigFlags, reserved);
3267
0
        GPSD_LOG(LOG_IO, &session->context->errout,
3268
0
                 "UBX: NAV-SAT: gnssId:%s flags:%s courrSource:%s "
3269
0
                 "ionoModel:%s\n",
3270
0
                 val2str(gnssId, vgnssId),
3271
0
                 flags2str(sigFlags, fsig_sigFlags, buf2, sizeof(buf2)),
3272
0
                 val2str(corrSource, vsig_corrsource),
3273
0
                 val2str(ionoModel, vsig_ionomodel));
3274
3275
0
        st++;
3276
0
    }
3277
3278
0
    session->gpsdata.satellites_visible = (int)st;
3279
0
    session->gpsdata.satellites_used = (int)nsv;
3280
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3281
0
             "UBX: NAV-SIG: visible=%d used=%d mask={SATELLITE|USED}\n",
3282
0
             session->gpsdata.satellites_visible,
3283
0
             session->gpsdata.satellites_used);
3284
0
    return SATELLITE_SET | USED_IS;
3285
0
}
3286
3287
/**
3288
 * Navigation solution message: UBX-NAV-SOL
3289
 *
3290
 * Present in:
3291
 *    protVer 7 ( Antaris)
3292
 *    protVer up to 23,01
3293
 *
3294
 * Deprecated in:
3295
 *    protVer 13 (6-series)
3296
 *
3297
 * Not present in:
3298
 *    protVer 27 (9-series)
3299
 *    Use UBX-NAV-PVT instead
3300
 *
3301
 * UBX-NAV-SOL has ECEF and VECEF, so no need for UBX-NAV-POSECEF and
3302
 * UBX-NAV-VELECEF
3303
 */
3304
static gps_mask_t ubx_msg_nav_sol(struct gps_device_t *session,
3305
                                  unsigned char *buf, size_t data_len)
3306
0
{
3307
0
    char buf2[80];
3308
0
    unsigned flags, pdop;
3309
0
    unsigned gpsFix;
3310
0
    gps_mask_t mask = 0;
3311
0
    char ts_buf[TIMESPEC_LEN];
3312
3313
0
    if (52 > data_len) {
3314
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3315
0
                 "UBX: NAV-SOL: runt payload len %zd", data_len);
3316
0
        return 0;
3317
0
    }
3318
3319
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3320
0
    gpsFix = getub(buf, 10);
3321
0
    flags = getub(buf, 11);
3322
0
    mask = 0;
3323
0
#define DATE_VALID      (UBX_SOL_VALID_WEEK | UBX_SOL_VALID_TIME)
3324
0
    if ((flags & DATE_VALID) == DATE_VALID) {
3325
0
        unsigned short week;
3326
0
        timespec_t ts_tow;
3327
3328
0
        MSTOTS(&ts_tow, session->driver.ubx.iTOW);
3329
0
        ts_tow.tv_nsec += (long)getles32(buf, 4);
3330
0
        TS_NORM(&ts_tow);
3331
0
        week = (unsigned short)getles16(buf, 8);
3332
0
        session->newdata.time = gpsd_gpstime_resolv(session, week, ts_tow);
3333
0
        mask |= TIME_SET | NTPTIME_IS | GOODTIME_IS;
3334
0
    }
3335
0
#undef DATE_VALID
3336
3337
0
    session->newdata.ecef.x = getles32(buf, 12) / 100.0;
3338
0
    session->newdata.ecef.y = getles32(buf, 16) / 100.0;
3339
0
    session->newdata.ecef.z = getles32(buf, 20) / 100.0;
3340
0
    session->newdata.ecef.pAcc = getleu32(buf, 24) / 100.0;
3341
0
    session->newdata.ecef.vx = getles32(buf, 28) / 100.0;
3342
0
    session->newdata.ecef.vy = getles32(buf, 32) / 100.0;
3343
0
    session->newdata.ecef.vz = getles32(buf, 36) / 100.0;
3344
0
    session->newdata.ecef.vAcc = getleu32(buf, 40) / 100.0;
3345
0
    mask |= ECEF_SET | VECEF_SET;
3346
3347
0
    session->newdata.eps = (double)(getles32(buf, 40) / 100.0);
3348
0
    mask |= SPEEDERR_SET;
3349
3350
0
    pdop = getleu16(buf, 44);
3351
0
    if (9999 > pdop) {
3352
0
        session->gpsdata.dop.pdop = (double)(pdop / 100.0);
3353
0
        mask |= DOP_SET;
3354
0
    }
3355
0
    session->gpsdata.satellites_used = (int)getub(buf, 47);
3356
3357
0
    switch (gpsFix) {
3358
0
    case UBX_MODE_TMONLY:
3359
        // Surveyed-in, better not have moved
3360
0
        session->newdata.mode = MODE_3D;
3361
0
        session->newdata.status = STATUS_TIME;
3362
0
        break;
3363
0
    case UBX_MODE_3D:
3364
0
        session->newdata.mode = MODE_3D;
3365
0
        session->newdata.status = STATUS_GPS;
3366
0
        break;
3367
0
    case UBX_MODE_2D:
3368
0
        session->newdata.mode = MODE_2D;
3369
0
        session->newdata.status = STATUS_GPS;
3370
0
        break;
3371
0
    case UBX_MODE_DR:           // consider this too as 2D
3372
0
        session->newdata.mode = MODE_2D;
3373
0
        session->newdata.status = STATUS_DR;
3374
0
        break;
3375
0
    case UBX_MODE_GPSDR:        // DR-aided GPS is valid 3D
3376
0
        session->newdata.mode = MODE_3D;
3377
0
        session->newdata.status = STATUS_GNSSDR;
3378
0
        break;
3379
0
    default:
3380
0
        session->newdata.mode = MODE_NO_FIX;
3381
0
        session->newdata.status = STATUS_UNK;
3382
0
        break;
3383
0
    }
3384
3385
0
    if (0 != (flags & UBX_SOL_FLAG_DGPS))
3386
0
        session->newdata.status = STATUS_DGPS;
3387
3388
0
    mask |= MODE_SET | STATUS_SET;
3389
    // older u-blox, cycle ender may be iffy
3390
    // so err o nthe side of over-reporting TPV
3391
0
    mask |= REPORT_IS;
3392
3393
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3394
0
             "UBX: NAV-SOL: time=%s ecef x:%.2f y:%.2f z:%.2f track=%.2f "
3395
0
             "speed=%.2f mode=%d status=%d used=%d\n",
3396
0
             timespec_str(&session->newdata.time, ts_buf, sizeof(ts_buf)),
3397
0
             session->newdata.ecef.x,
3398
0
             session->newdata.ecef.y,
3399
0
             session->newdata.ecef.z,
3400
0
             session->newdata.track,
3401
0
             session->newdata.speed,
3402
0
             session->newdata.mode,
3403
0
             session->newdata.status,
3404
0
             session->gpsdata.satellites_used);
3405
0
    GPSD_LOG(LOG_IO, &session->context->errout,
3406
0
             "UBX: NAV-SOL-PVT: gpsFix:%s flags:%s\n",
3407
0
             val2str(gpsFix, vpvt_fixType),
3408
0
             flags2str(flags, fhnr_pvt_flags, buf2, sizeof(buf2)));
3409
0
    return mask;
3410
0
}
3411
3412
3413
/**
3414
 * Receiver navigation status
3415
 * UBX-NAV-STATUS Class 1, ID 3
3416
 *
3417
 * Present in Antaris to 9-series
3418
 */
3419
static gps_mask_t
3420
ubx_msg_nav_status(struct gps_device_t *session, unsigned char *buf,
3421
                   size_t data_len)
3422
0
{
3423
0
    uint8_t gpsFix;
3424
0
    uint8_t flags;
3425
0
    uint8_t fixStat;
3426
0
    uint8_t flags2;
3427
0
    uint32_t ttff;
3428
0
    uint32_t msss;
3429
0
    int *status = &session->newdata.status;
3430
0
    int *mode = &session->newdata.mode;
3431
0
    gps_mask_t mask = 0;
3432
3433
0
    if (16 > data_len) {
3434
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3435
0
                 "UBX: NAV-STATUS: runt payload len %zd", data_len);
3436
0
        return 0;
3437
0
    }
3438
3439
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3440
0
    gpsFix = getub(buf, 4);
3441
0
    flags = getub(buf, 5);
3442
0
    fixStat = getub(buf, 6);
3443
0
    flags2 = getub(buf, 7);
3444
0
    ttff = getleu32(buf, 8);
3445
0
    msss = getleu32(buf, 12);
3446
3447
    // FIXME: how does this compare with other places ubx sets mode/status?
3448
0
    if (0 == (1 & flags)) {
3449
        // gpsFix not OK
3450
0
        *mode = MODE_NO_FIX;
3451
0
        *status = STATUS_UNK;
3452
0
    } else {
3453
0
        switch (gpsFix) {
3454
0
        case UBX_MODE_TMONLY:
3455
            // 5 - Surveyed-in, so a precise 3D.
3456
0
            *mode = MODE_3D;
3457
0
            *status = STATUS_TIME;
3458
0
            break;
3459
3460
0
        case UBX_MODE_3D:
3461
            // 3
3462
0
            FALLTHROUGH
3463
0
        case UBX_MODE_GPSDR:
3464
            // 4
3465
0
            *mode = MODE_3D;
3466
            // FIXME:  Set DR if this is DR
3467
0
            *status = STATUS_GPS;
3468
0
            break;
3469
3470
0
        case UBX_MODE_2D:
3471
            // 2
3472
0
            FALLTHROUGH
3473
0
        case UBX_MODE_DR:           // consider this too as 2D
3474
            // 1
3475
0
            *mode = MODE_2D;
3476
0
            if (2 == (2 & fixStat)) {
3477
0
                *status = STATUS_DGPS;
3478
0
            } else {
3479
                // FIXME:  Set DR if this is DR
3480
0
                *status = STATUS_GPS;
3481
0
            }
3482
0
            break;
3483
3484
0
        case UBX_MODE_NOFIX:
3485
            // 0
3486
0
            FALLTHROUGH
3487
0
        default:
3488
            // > 5
3489
0
            *mode = MODE_NO_FIX;
3490
0
            *status = STATUS_UNK;
3491
0
            break;
3492
0
        }
3493
0
        if (2 == (2 & fixStat)) {
3494
0
            if (0x40 == (0x40 & flags2)) {
3495
0
                *status = STATUS_RTK_FLT;
3496
0
            } else if (0x80 == (0x80 & flags2)) {
3497
0
                *status = STATUS_RTK_FIX;
3498
0
            }
3499
            // else ??
3500
0
        } else if (1 == (1 & fixStat)) {
3501
0
            *status = STATUS_DGPS;
3502
0
        }
3503
0
    }
3504
0
    mask |= STATUS_SET | MODE_SET;
3505
3506
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3507
0
         "UBX: NAV-STATUS: iTOW %lld gpsFix %u flags %02x fixStat %02x "
3508
0
         "flags2=%02x ttff=%llu msss=%llu mode=%u status=%u\n",
3509
0
         (long long)session->driver.ubx.iTOW,
3510
0
         gpsFix,
3511
0
         flags,
3512
0
         fixStat,
3513
0
         flags2,
3514
0
         (long long unsigned)ttff,
3515
0
         (long long unsigned)msss,
3516
0
         session->newdata.mode,
3517
0
         session->newdata.status);
3518
0
    return mask;
3519
0
}
3520
3521
/**
3522
 * Survey-in data - UBX-NAV-SVIN
3523
 * Time Sync products only
3524
 */
3525
static gps_mask_t ubx_msg_nav_svin(struct gps_device_t *session,
3526
                                   unsigned char *buf, size_t data_len UNUSED)
3527
0
{
3528
0
    gps_mask_t mask = ONLINE_SET;
3529
0
    unsigned version = getub(buf, 0);
3530
    // 3 reserved bytes
3531
0
    unsigned long iTOW = getleu32(buf, 4);
3532
0
    unsigned long dur = getleu32(buf, 0);
3533
0
    long long meanX = getles32(buf, 12);             // cm
3534
0
    long long meanY = getles32(buf, 16);             // cm
3535
0
    long long meanZ = getles32(buf, 20);             // cm
3536
0
    int meanXHP = getsb(buf, 24);                    // 0.1 mm
3537
0
    int meanYHP = getsb(buf, 25);                    // 0.1 mm
3538
0
    int meanZHP = getsb(buf, 26);                    // 0.1 mm
3539
    // 1 reserved byte
3540
0
    unsigned long meanAcc = getleu32(buf, 28);  // 0.1 mm
3541
0
    unsigned long obs = getleu32(buf, 32);
3542
0
    unsigned valid = getub(buf, 36);
3543
0
    unsigned active = getub(buf, 37);
3544
    // 2 reserved
3545
3546
    // Only version 0 is defined up to ub-blox 9
3547
0
    if (0 != version) {
3548
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3549
0
                 "UBX: NAV-SVIN: unknown version $u %u", version);
3550
0
        return 0;
3551
0
    }
3552
3553
0
    session->driver.ubx.iTOW = iTOW;
3554
0
    meanX = (meanX * 10) + meanXHP;
3555
0
    meanY = (meanY * 10) + meanYHP;
3556
0
    meanZ = (meanZ * 10) + meanZHP;
3557
3558
    // casts for 32 bit compatibility
3559
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3560
0
             "UBX: NAV-SVIN: iTOW %llu dur=%lu meanX=%lld meanY=%lld "
3561
0
             "meanZ=%lld meanAcc=%lu "
3562
0
             "obs=%lu valid=%u(%s) active=%u(%s)\n",
3563
0
             (long long)iTOW, dur, meanX, meanY, meanZ,
3564
0
             meanAcc, obs, valid, val2str(valid, vsvin_valid),
3565
0
             active, val2str(active, vsvin_active));
3566
0
    return mask;
3567
0
}
3568
3569
/**
3570
 * GPS Satellite Info -- deprecated - UBX-NAV-SVINFO
3571
 * Present in:
3572
 *    protver < 27
3573
 * Not present in:
3574
      protver >= 27 (9-series), use UBX-NAV-SAT instead
3575
 */
3576
static gps_mask_t ubx_msg_nav_svinfo(struct gps_device_t *session,
3577
                                     unsigned char *buf, size_t data_len)
3578
0
{
3579
0
    char buf2[80];
3580
0
    unsigned i, nchan, nsv, st;
3581
0
    unsigned chipGen;
3582
0
    unsigned globalFlags;
3583
0
    timespec_t ts_tow;
3584
    // chipGen to protVer, Antaris 4, u-blox 4, 5, 6, 7 and 8
3585
0
    static unsigned gen2ver[] = {8, 10, 12, 13, 15};
3586
3587
0
    if (8 > data_len) {
3588
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3589
0
                 "UBX: NAV-SVINFO runt datalen %zd\n", data_len);
3590
0
        return 0;
3591
0
    }
3592
3593
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3594
0
    MSTOTS(&ts_tow, session->driver.ubx.iTOW);
3595
0
    session->gpsdata.skyview_time =
3596
0
        gpsd_gpstime_resolv(session, session->context->gps_week, ts_tow);
3597
3598
0
    nchan = getub(buf, 4);
3599
0
    if (nchan > MAXCHANNELS) {
3600
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3601
0
                 "UBX: NAV SVINFO: runt >%d reported visible",
3602
0
                 MAXCHANNELS);
3603
0
        return 0;
3604
0
    }
3605
0
    globalFlags = getub(buf, 5);
3606
0
    chipGen = globalFlags & 0x07;
3607
0
    if (ROWS(gen2ver) > chipGen &&
3608
        // put a floor under protVer
3609
0
        gen2ver[chipGen] > session->driver.ubx.protver) {
3610
0
        session->driver.ubx.protver = gen2ver[chipGen];
3611
0
    }
3612
3613
0
    gpsd_zero_satellites(&session->gpsdata);
3614
0
    nsv = 0;
3615
0
    for (i = st = 0; i < nchan; i++) {
3616
0
        unsigned off = 8 + 12 * i;
3617
0
        short nmea_PRN;
3618
0
        unsigned chan = getub(buf, off);
3619
0
        unsigned ubx_PRN = getub(buf, off + 1);
3620
0
        unsigned flags = getub(buf, off + 2);
3621
0
        unsigned quality = getub(buf, off + 3);
3622
0
        unsigned cno = getub(buf, off + 4);
3623
0
        bool used = (bool)(flags & 0x01);
3624
0
        int el = getsb(buf, off + 5);
3625
0
        int az = getles16(buf, off + 6);
3626
0
        int prRes = getles16(buf, off + 7);
3627
3628
0
        nmea_PRN = ubx_to_prn(ubx_PRN,
3629
0
                              &session->gpsdata.skyview[st].gnssid,
3630
0
                              &session->gpsdata.skyview[st].svid);
3631
3632
0
        if (1 > nmea_PRN) {
3633
            // skip bad PRN
3634
0
            GPSD_LOG(LOG_PROG, &session->context->errout,
3635
0
                     "UBX: NAV-SVINFO bad NMEA PRN %d\n", nmea_PRN);
3636
0
            continue;
3637
0
        }
3638
0
        session->gpsdata.skyview[st].PRN = nmea_PRN;
3639
3640
0
        session->gpsdata.skyview[st].ss = (double)cno;
3641
0
        if (90 >= abs(el)) {
3642
0
            session->gpsdata.skyview[st].elevation = (double)el;
3643
0
        }
3644
0
        if (359 > az &&
3645
0
            0 <= az) {
3646
0
            session->gpsdata.skyview[st].azimuth = (double)az;
3647
0
        }
3648
0
        session->gpsdata.skyview[st].prRes = prRes / 100.0;
3649
0
        session->gpsdata.skyview[st].qualityInd = quality;
3650
0
        session->gpsdata.skyview[st].used = used;
3651
0
        if (0x10 == (0x10 & flags)) {
3652
0
           session->gpsdata.skyview[st].health = SAT_HEALTH_BAD;
3653
0
        } else {
3654
0
           session->gpsdata.skyview[st].health = SAT_HEALTH_OK;
3655
0
        }
3656
3657
        // sbas_in_use is not same as used
3658
0
        if (used) {
3659
            // not really 'used', just integrity data from there
3660
0
            nsv++;
3661
0
            session->gpsdata.skyview[st].used = true;
3662
0
        }
3663
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3664
0
                 "UBX: NAV-SVINFO chan %u  ubx_prn %d gnssid %d, svid %d "
3665
0
                 "nmea_PRN %d flags x%x az %.0f el %.0f cno %.0f prRes %.2f "
3666
0
                 "quality %u\n",
3667
0
                 chan, ubx_PRN,
3668
0
                 session->gpsdata.skyview[st].gnssid,
3669
0
                 session->gpsdata.skyview[st].svid, nmea_PRN, flags,
3670
0
                 session->gpsdata.skyview[st].azimuth,
3671
0
                 session->gpsdata.skyview[st].elevation,
3672
0
                 session->gpsdata.skyview[st].ss,
3673
0
                 session->gpsdata.skyview[st].prRes,
3674
0
                 session->gpsdata.skyview[st].qualityInd);
3675
0
        GPSD_LOG(LOG_IO, &session->context->errout,
3676
0
                 "UBX: NAV-SVINFO: flags:%s quality:%s\n",
3677
0
                 flags2str(flags, fsvinfo_flags, buf2, sizeof(buf2)),
3678
0
                 val2str(quality, vquality));
3679
3680
0
        st++;
3681
0
    }
3682
3683
0
    session->gpsdata.satellites_visible = (int)st;
3684
0
    session->gpsdata.satellites_used = (int)nsv;
3685
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3686
0
             "UBX: NAV-SVINFO: visible=%d used=%d mask={SATELLITE|USED} "
3687
0
             "gFlags x%x\n",
3688
0
             session->gpsdata.satellites_visible,
3689
0
             session->gpsdata.satellites_used,
3690
0
             globalFlags);
3691
0
    GPSD_LOG(LOG_IO, &session->context->errout,
3692
0
             "UBX: NAV-SVINFO: chipGen %s\n",
3693
0
             val2str(globalFlags & 7, vglobalFlags));
3694
0
    return SATELLITE_SET | USED_IS;
3695
0
}
3696
3697
/**
3698
 * GPS Leap Seconds - UBX-NAV-TIMEGPS
3699
 * Present in:
3700
 *     protVer 8 (Antaris 4)
3701
 *     protVer 27 (F9P)
3702
 *     protVer 34 (M10)
3703
 *
3704
 * Not in:
3705
 *     protVer 24 (NEO-D9S)
3706
 */
3707
static gps_mask_t ubx_msg_nav_timegps(struct gps_device_t *session,
3708
                                      unsigned char *buf, size_t data_len)
3709
0
{
3710
0
    char buf2[80];
3711
0
    uint8_t valid;         // Validity Flags
3712
0
    gps_mask_t mask = 0;
3713
0
    char ts_buf[TIMESPEC_LEN];
3714
3715
0
    if (16 > data_len) {
3716
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3717
0
                 "UBX: NAV-TIMEGPS: runt payload len %zd", data_len);
3718
0
        return 0;
3719
0
    }
3720
3721
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3722
0
    valid = getub(buf, 11);
3723
    // Valid leap seconds ?
3724
0
    if ((valid & UBX_TIMEGPS_VALID_LEAP_SECOND) ==
3725
0
        UBX_TIMEGPS_VALID_LEAP_SECOND) {
3726
0
        session->context->leap_seconds = (int)getub(buf, 10);
3727
0
        session->context->valid |= LEAP_SECOND_VALID;
3728
0
    }
3729
    // Valid GPS time of week and week number
3730
0
#define VALID_TIME (UBX_TIMEGPS_VALID_TIME | UBX_TIMEGPS_VALID_WEEK)
3731
0
    if ((valid & VALID_TIME) == VALID_TIME) {
3732
0
#undef VALID_TIME
3733
0
        uint16_t week;
3734
0
        double tAcc;      // Time Accuracy Estimate in ns
3735
0
        timespec_t ts_tow;
3736
3737
0
        week = getles16(buf, 8);
3738
0
        MSTOTS(&ts_tow, session->driver.ubx.iTOW);
3739
0
        ts_tow.tv_nsec += (long)getles32(buf, 4);
3740
0
        TS_NORM(&ts_tow);
3741
0
        session->newdata.time = gpsd_gpstime_resolv(session, week, ts_tow);
3742
3743
0
        tAcc = (double)getleu32(buf, 12);     // tAcc in ns
3744
0
        session->newdata.ept = tAcc / 1e9;
3745
0
        mask |= (TIME_SET | NTPTIME_IS);
3746
0
    }
3747
3748
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3749
0
             "UBX: NAV-TIMEGPS: time=%s mask={TIME} valid x%x\n",
3750
0
             timespec_str(&session->newdata.time, ts_buf, sizeof(ts_buf)),
3751
0
             valid);
3752
0
    GPSD_LOG(LOG_IO, &session->context->errout,
3753
0
             "UBX: NAV-TIMEGPS: valid %s\n",
3754
0
             flags2str(valid, vtimegps_valid, buf2, sizeof(buf2)));
3755
0
    return mask;
3756
0
}
3757
3758
/**
3759
 * Navigation time to leap second: UBX-NAV-TIMELS
3760
 *
3761
 * Sets leap_notify if leap second is < 23 hours away.
3762
 * Present in:
3763
 *     protVer 15 (8-series)
3764
 * Not in:
3765
 *     protVer 12 (5-series)
3766
 *     protVer 13 (6-series)
3767
 *     protVer 14 (6-series / GLONASS, 6-series)
3768
 */
3769
static gps_mask_t ubx_msg_nav_timels(struct gps_device_t *session,
3770
                                     unsigned char *buf, size_t data_len)
3771
0
{
3772
0
    char buf2[80];
3773
0
    unsigned version;
3774
0
    unsigned valid;
3775
0
    int valid_curr_ls;
3776
0
    int valid_time_to_ls_event;
3777
3778
0
#define UBX_TIMELS_VALID_CURR_LS 0x01
3779
0
#define UBX_TIMELS_VALID_TIME_LS_EVT 0x01
3780
3781
0
    if (24 > data_len) {
3782
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3783
0
                 "UBX: NAV-TIMELS: runt %zd, expecting 24\n",
3784
0
                 data_len);
3785
0
        return 0;
3786
0
    }
3787
3788
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3789
0
    version = getub(buf, 4);
3790
    // Only version 0 is defined up to ub-blox 9
3791
0
    if (0 != version) {
3792
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3793
0
                 "UBX: NAV-TIMELS: unknown version $u %u", version);
3794
0
        return 0;
3795
0
    }
3796
0
    valid = getub(buf, 23);
3797
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3798
0
             "UBX: NAV-TIMELS: valid x%x version %d\n", valid, version);
3799
0
    GPSD_LOG(LOG_INF, &session->context->errout,
3800
0
             "UBX: NAV-TIMELS: valid %s\n",
3801
0
             flags2str(valid, vtimels_valid, buf2, sizeof(buf2)));
3802
3803
0
    valid_curr_ls = valid & UBX_TIMELS_VALID_CURR_LS;
3804
0
    valid_time_to_ls_event = valid & UBX_TIMELS_VALID_TIME_LS_EVT;
3805
0
    if (valid_curr_ls) {
3806
0
        unsigned int src_of_curr_ls = getub(buf,8);
3807
0
        int curr_ls = getsb(buf,9);
3808
3809
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3810
0
                 "UBX: NAV-TIMELS: srcOfCurrLs %u(%s) curr_ls %d\n",
3811
0
                 src_of_curr_ls,
3812
0
                 val2str(src_of_curr_ls, vsrcOfCurrLs),
3813
0
                 curr_ls);
3814
0
        session->context->leap_seconds = curr_ls;
3815
0
        session->context->valid |= LEAP_SECOND_VALID;
3816
0
    }  // Valid current leap second
3817
3818
0
    if (valid_time_to_ls_event) {
3819
0
        unsigned int src_of_ls_change;
3820
0
        unsigned short dateOfLSGpsWn, dateOfLSGpsDn;
3821
0
        int lsChange = getsb(buf, 11);
3822
0
        int timeToLsEvent = getles32(buf, 12);
3823
3824
0
        src_of_ls_change = getub(buf,10);
3825
3826
0
        dateOfLSGpsWn = getles16(buf,16);
3827
0
        dateOfLSGpsDn = getles16(buf,18);
3828
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3829
0
                 "UBX: NAV-TIMELS: srcOfCurLsChange %u(%s) lsChange %d "
3830
0
                 "timeToLsEvent %d dateOfLSGpsWn %d dateOfLSGpsDn %d\n",
3831
0
                 src_of_ls_change,
3832
0
                 val2str(src_of_ls_change, vsrcOfLsChange),
3833
0
                 lsChange, timeToLsEvent,
3834
0
                 dateOfLSGpsWn,dateOfLSGpsDn);
3835
3836
0
        if ((0 != lsChange) && (0 < timeToLsEvent) &&
3837
0
            ((60 * 60 * 23) > timeToLsEvent)) {
3838
0
            if (1 == lsChange) {
3839
0
                session->context->leap_notify = LEAP_ADDSECOND;
3840
0
                GPSD_LOG(LOG_WARN, &session->context->errout,
3841
0
                         "UBX: NAV-TIMELS: leap_notify %d "
3842
0
                         "Positive leap second today\n",
3843
0
                         session->context->leap_notify);
3844
0
            } else if (-1 == lsChange) {
3845
0
                session->context->leap_notify = LEAP_DELSECOND;
3846
0
                GPSD_LOG(LOG_WARN, &session->context->errout,
3847
0
                         "UBX: NAV-TIMELS:leap_notify %d "
3848
0
                         " Negative leap second today\n",
3849
0
                         session->context->leap_notify);
3850
0
            }
3851
0
        } else {
3852
0
            session->context->leap_notify = LEAP_NOWARNING;
3853
0
            GPSD_LOG(LOG_PROG, &session->context->errout,
3854
0
                     "UBX: NAV-TIMELS: leap_notify %d, none today\n",
3855
0
                     session->context->leap_notify);
3856
0
        }
3857
0
    }
3858
0
    return 0;
3859
0
}
3860
3861
/**
3862
 * UBX-NAV-TIMEUTC
3863
 */
3864
static gps_mask_t ubx_msg_nav_timeutc(struct gps_device_t *session,
3865
                                      unsigned char *buf, size_t data_len)
3866
0
{
3867
0
    uint8_t valid;         // Validity Flags
3868
0
    gps_mask_t mask = 0;
3869
3870
0
    if (20 > data_len) {
3871
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3872
0
                 "UBX: NAV-TIMEUTC: runt payload len %zd", data_len);
3873
0
        return 0;
3874
0
    }
3875
3876
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3877
0
    valid = getub(buf, 19);
3878
0
    if (4 == (4 & valid)) {
3879
        // UTC is valid
3880
0
        struct tm date = {0};
3881
        // mask |= (TIME_SET | NTPTIME_IS);
3882
0
        uint32_t tAcc = getleu32(buf, 4);          // tAcc in ns
3883
        // nano can be negative, so this is not normalized UTC.
3884
0
        int32_t nano = getles32(buf, 8);           // fract sec in ns
3885
0
        date.tm_year = getleu16(buf, 12) - 1900;   // year, 1999..2099
3886
0
        date.tm_mon = getub(buf, 14) - 1;          // month 1..12
3887
0
        date.tm_mday = getub(buf, 15);             // day 1..31
3888
0
        date.tm_hour = getub(buf, 16);             // hour 0..23
3889
0
        date.tm_min = getub(buf, 17);              // min 0..59
3890
0
        date.tm_sec = getub(buf, 18);              // sec 0..60
3891
0
        session->newdata.time.tv_sec = mkgmtime(&date);
3892
0
        session->newdata.time.tv_nsec = nano;
3893
        // nano, can be negative! So normalize
3894
0
        TS_NORM(&session->newdata.time);
3895
        // other timestamped messages lack nano, so time will jump around...
3896
0
        mask |= TIME_SET | NTPTIME_IS | GOODTIME_IS;
3897
3898
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3899
0
                 "UBX: NAV-TIMEUTC: iTOW=%lld valid=%02x %04d-%02d-%02d "
3900
0
                 "%02d:%02d:%02d.%09d tAcc=%llu time %lld.%09lld\n",
3901
0
                 (long long)session->driver.ubx.iTOW,
3902
0
                 valid, date.tm_year + 1900, date.tm_mon + 1, date.tm_mday,
3903
0
                 date.tm_hour, date.tm_min, date.tm_sec, nano,
3904
0
                 (long long unsigned)tAcc,
3905
0
                 (long long)session->newdata.time.tv_sec,
3906
0
                 (long long)session->newdata.time.tv_nsec);
3907
0
    } else {
3908
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
3909
0
                 "UBX: NAV-TIMEUTC: iTOW=%lld valid=%02x\n",
3910
0
                 (long long)session->driver.ubx.iTOW,
3911
0
                 valid);
3912
0
    }
3913
0
    return mask;
3914
0
}
3915
3916
/*
3917
 * Velocity Position ECEF message, UBX-NAV-VELECEF
3918
 */
3919
static gps_mask_t ubx_msg_nav_velecef(struct gps_device_t *session,
3920
                                      unsigned char *buf, size_t data_len)
3921
0
{
3922
0
    gps_mask_t mask = VECEF_SET;
3923
3924
0
    if (20 > data_len) {
3925
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3926
0
                 "UBX: NAV-VELECEF: runt payload len %zd", data_len);
3927
0
        return 0;
3928
0
    }
3929
3930
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3931
0
    session->newdata.ecef.vx = getles32(buf, 4) / 100.0;
3932
0
    session->newdata.ecef.vy = getles32(buf, 8) / 100.0;
3933
0
    session->newdata.ecef.vz = getles32(buf, 12) / 100.0;
3934
0
    session->newdata.ecef.vAcc = getleu32(buf, 16) / 100.0;
3935
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3936
0
        "UBX: NAV-VELECEF: iTOW=%lld ECEF vx=%.2f vy=%.2f vz=%.2f vAcc=%.2f\n",
3937
0
        (long long)session->driver.ubx.iTOW,
3938
0
        session->newdata.ecef.vx,
3939
0
        session->newdata.ecef.vy,
3940
0
        session->newdata.ecef.vz,
3941
0
        session->newdata.ecef.vAcc);
3942
0
    return mask;
3943
0
}
3944
3945
/*
3946
 * Velocity NED message, UBX-NAV-VELNED
3947
 * protocol versions 15+
3948
 */
3949
static gps_mask_t ubx_msg_nav_velned(struct gps_device_t *session,
3950
                                     unsigned char *buf, size_t data_len)
3951
0
{
3952
0
    gps_mask_t mask = VNED_SET;
3953
3954
0
    if (36 > data_len) {
3955
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3956
0
                 "UBX: NAV-VELNED: runt payload len %zd", data_len);
3957
0
        return 0;
3958
0
    }
3959
3960
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
3961
0
    session->newdata.NED.velN = getles32(buf, 4) / 100.0;
3962
0
    session->newdata.NED.velE = getles32(buf, 8) / 100.0;
3963
0
    session->newdata.NED.velD = getles32(buf, 12) / 100.0;
3964
    // ignore speed for now
3965
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
3966
0
        "UBX: NAV-VELNED: iTOW=%lld NED velN=%.2f velE=%.2f velD=%.2f\n",
3967
0
         (long long)session->driver.ubx.iTOW,
3968
0
        session->newdata.NED.velN,
3969
0
        session->newdata.NED.velE,
3970
0
        session->newdata.NED.velD);
3971
0
    return mask;
3972
0
}
3973
3974
/*
3975
 * Multi-GNSS Raw measurement Data -- UBX-RXM-RAWX
3976
 * Not in u-blox 5, 6 or 7
3977
 * u-blox 9, message version 0 (but no version byte!)
3978
 * u-blox 9, message version 1
3979
 */
3980
static gps_mask_t ubx_msg_rxm_rawx(struct gps_device_t *session,
3981
                                   const unsigned char *buf,
3982
                                   size_t data_len)
3983
0
{
3984
0
    double rcvTow;
3985
0
    uint16_t week;
3986
0
    int8_t leapS;
3987
0
    uint8_t numMeas;
3988
0
    uint8_t recStat;
3989
0
    uint8_t version;
3990
0
    int i;
3991
0
    const char * obs_code;
3992
0
    timespec_t ts_tow;
3993
3994
0
    if (16 > data_len) {
3995
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
3996
0
                 "UBX: RXM-RAWX: runt payload len %zd", data_len);
3997
0
        return 0;
3998
0
    }
3999
4000
    // Note: this is "approximately" GPS TOW, this is not iTOW
4001
0
    rcvTow = getled64((const char *)buf, 0);   // time of week in seconds
4002
0
    week = getleu16(buf, 8);
4003
0
    leapS = getsb(buf, 10);
4004
0
    numMeas = getub(buf, 11);
4005
0
    recStat = getub(buf, 12);
4006
    /* byte 13 is version on u-blox 9, reserved on u-blox 8
4007
     * how is that supposed to work?? */
4008
0
    version = getub(buf, 13);
4009
4010
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4011
0
             "UBX: RXM-RAWX: rcvTow %f week %u leapS %d numMeas %u recStat %d"
4012
0
             " version %u\n",
4013
0
             rcvTow, week, leapS, numMeas, recStat, version);
4014
4015
0
    if (recStat & 1) {
4016
        // Valid leap seconds
4017
0
        session->context->leap_seconds = leapS;
4018
0
        session->context->valid |= LEAP_SECOND_VALID;
4019
0
    }
4020
    // RINEX 3 wants GPS time, not UTC time, do not add leap seconds.
4021
0
    DTOTS(&ts_tow, rcvTow);
4022
    // Do not set newdata.time.  set gpsdata.raw.mtime
4023
    // RINEX 3 "GPS time", not UTC, no leap seconds
4024
0
    session->gpsdata.raw.mtime = gpsd_gpstime(session, week, ts_tow);
4025
4026
    /* zero the measurement data
4027
     * so we can tell which meas never got set */
4028
0
    memset(session->gpsdata.raw.meas, 0, sizeof(session->gpsdata.raw.meas));
4029
4030
0
    if (numMeas > MAXCHANNELS) {
4031
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4032
0
                 "UBX: RXM-RAWX: too many measurements (%u)",
4033
0
                 numMeas);
4034
0
        return 0;
4035
0
    }
4036
0
    for (i = 0; i < numMeas; i++) {
4037
0
        int off = 32 * i;
4038
        // pseudorange in meters
4039
0
        double prMes = getled64((const char *)buf, off + 16);
4040
        // carrier phase in cycles
4041
0
        double cpMes = getled64((const char *)buf, off + 24);
4042
        // doppler in Hz, positive towards sat
4043
0
        double doMes = getlef32((const char *)buf, off + 32);
4044
0
        uint8_t gnssId = getub(buf, off + 36);
4045
0
        uint8_t svId = getub(buf, off + 37);
4046
        // reserved in u-blox 8, sigId in u-blox 9 (version 1)
4047
0
        uint8_t sigId = getub(buf, off + 38);
4048
        // GLONASS frequency slot
4049
0
        uint8_t freqId = getub(buf, off + 39);
4050
        // carrier phase locktime in ms, max 64500ms
4051
0
        uint16_t locktime = getleu16(buf, off + 40);
4052
        // carrier-to-noise density ratio dB-Hz
4053
0
        uint8_t cno = getub(buf, off + 42);
4054
0
        uint8_t prStdev = getub(buf, off + 43) & 0x0f;
4055
0
        uint8_t cpStdev = getub(buf, off + 44) & 0x0f;
4056
0
        uint8_t doStdev = getub(buf, off + 45) & 0x0f;
4057
        /* tracking stat
4058
         * bit 0 - prMes valid
4059
         * bit 1 - cpMes valid
4060
         * bit 2 - halfCycle valid
4061
         * bit 3 - halfCycle subtracted from phase
4062
         */
4063
0
        uint8_t trkStat = getub(buf, off + 46);
4064
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
4065
0
                 "UBX: RXM-RAWX: %u:%u:%u freqId %u prMes %f cpMes %f "
4066
0
                 "doMes %f locktime %u\n"
4067
0
                 "cno %u prStdev %u cpStdev %u doStdev %u rtkStat %u\n",
4068
0
                 gnssId, svId, sigId, freqId, prMes, cpMes, doMes, locktime,
4069
0
                 cno, prStdev, cpStdev, doStdev, trkStat);
4070
4071
0
        session->gpsdata.raw.meas[i].gnssid = gnssId;
4072
0
        session->gpsdata.raw.meas[i].sigid = sigId;
4073
4074
        /* some of these are GUESSES as the u-blox codes do not
4075
         * match RINEX codes */
4076
0
        switch (gnssId) {
4077
0
        case 0:       // GPS
4078
0
            switch (sigId) {
4079
0
            default:
4080
                // let PPP figure it out
4081
0
                obs_code = "XXX";
4082
0
                break;
4083
0
            case 0:       // L1C/A
4084
0
                obs_code = "L1C";
4085
0
                break;
4086
0
            case 3:       // L2 CL
4087
0
                obs_code = "L2C";
4088
0
                break;
4089
0
            case 4:       // L2 CM
4090
0
                obs_code = "L2X";
4091
0
                break;
4092
0
            }
4093
0
            break;
4094
0
        case 1:       // SBAS
4095
            /* sigId added on protVer 27, and SBAS gone in protVer 27
4096
             * so must be L1C/A */
4097
0
            svId -= 100;            // adjust for RINEX 3 svid
4098
4099
0
            obs_code = "L1C";       // u-blox calls this L1C/A
4100
            // SBAS can do L5I, but the code?
4101
0
            switch (sigId) {
4102
0
            default:
4103
                // let PPP figure it out
4104
0
                break;
4105
0
            case 0:       // L1C/A
4106
0
                obs_code = "L1C";
4107
0
                break;
4108
0
            }
4109
0
            break;
4110
0
        case 2:       // GALILEO
4111
0
            switch (sigId) {
4112
0
            default:
4113
                // let PPP figure it out
4114
0
                obs_code = "XXX";
4115
0
                break;
4116
0
            case 0:       //
4117
0
                obs_code = "L1C";       // u-blox calls this E1OS or E1C
4118
0
                break;
4119
0
            case 1:       //
4120
0
                obs_code = "L1B";       // u-blox calls this E1B
4121
0
                break;
4122
0
            case 5:       //
4123
0
                obs_code = "L7I";       // u-blox calls this E5bl
4124
0
                break;
4125
0
            case 6:       //
4126
0
                obs_code = "L7Q";       // u-blox calls this E5bQ
4127
0
                break;
4128
0
            }
4129
0
            break;
4130
0
        case 3:       // BeiDou, mappings to RINUEX are a guess.
4131
0
            switch (sigId) {
4132
0
            default:
4133
                // let PPP figure it out
4134
0
                obs_code = "XXX";
4135
0
                break;
4136
0
            case 0:       //
4137
0
                obs_code = "L2I";       // u-blox calls this B1I D1
4138
0
                break;
4139
0
            case 1:       //
4140
0
                obs_code = "L2Q";       // u-blox calls this B1I D2
4141
0
                break;
4142
0
            case 2:       //
4143
0
                obs_code = "L7Q";       // u-blox calls this B2I D1
4144
0
                break;
4145
0
            case 3:       //
4146
0
                obs_code = "L7Q";       // u-blox calls this B2I D2
4147
0
                break;
4148
0
            }
4149
0
            break;
4150
0
        default:      // huh?
4151
0
        case 4:       // IMES.  really?
4152
0
            obs_code = "";       // u-blox calls this L1
4153
0
            break;
4154
0
        case 5:       // QZSS
4155
0
            switch (sigId) {
4156
0
            default:
4157
                // let PPP figure it out
4158
0
                obs_code = "XXX";
4159
0
                break;
4160
0
            case 0:       //
4161
0
                obs_code = "L1C";       // u-blox calls this L1C/A
4162
0
                break;
4163
0
            case 4:       //
4164
0
                obs_code = "L2S";       // u-blox calls this L2CM
4165
0
                break;
4166
0
            case 5:       //
4167
0
                obs_code = "L2L";       // u-blox calls this L2CL
4168
0
                break;
4169
0
            }
4170
0
            break;
4171
0
        case 6:       // GLONASS
4172
0
            switch (sigId) {
4173
0
            default:
4174
                // let PPP figure it out
4175
0
                obs_code = "XXX";
4176
0
                break;
4177
0
            case 0:       //
4178
0
                obs_code = "L1C";       // u-blox calls this L1OF
4179
0
                break;
4180
0
            case 2:       //
4181
0
                obs_code = "L2C";       // u-blox calls this L2OF
4182
0
                break;
4183
0
            }
4184
0
            break;
4185
0
        }
4186
0
        (void)strlcpy(session->gpsdata.raw.meas[i].obs_code, obs_code,
4187
0
                      sizeof(session->gpsdata.raw.meas[i].obs_code));
4188
4189
0
        session->gpsdata.raw.meas[i].svid = svId;
4190
0
        session->gpsdata.raw.meas[i].freqid = freqId;
4191
0
        session->gpsdata.raw.meas[i].snr = cno;
4192
0
        session->gpsdata.raw.meas[i].satstat = trkStat;
4193
0
        if (trkStat & 1) {
4194
            // prMes valid
4195
0
            session->gpsdata.raw.meas[i].pseudorange = prMes;
4196
0
        } else {
4197
0
            session->gpsdata.raw.meas[i].pseudorange = NAN;
4198
0
        }
4199
0
        if ((trkStat & 2) && (5 >= cpStdev)) {
4200
            // cpMes valid, RTKLIB uses 5 < cpStdev
4201
0
            session->gpsdata.raw.meas[i].carrierphase = cpMes;
4202
0
        } else {
4203
0
            session->gpsdata.raw.meas[i].carrierphase = NAN;
4204
0
        }
4205
0
        session->gpsdata.raw.meas[i].doppler = doMes;
4206
0
        session->gpsdata.raw.meas[i].codephase = NAN;
4207
0
        session->gpsdata.raw.meas[i].deltarange = NAN;
4208
0
        session->gpsdata.raw.meas[i].locktime = locktime;
4209
0
        if (0 == locktime) {
4210
            // possible slip
4211
0
            session->gpsdata.raw.meas[i].lli = 2;
4212
0
        }
4213
0
    }
4214
4215
0
    return RAW_IS;
4216
0
}
4217
4218
/*
4219
 * Raw Subframes - UBX-RXM-SFRB
4220
 * In u-blox 7, only in raw firmware option
4221
 * Not in u-blox 8 or 9
4222
 */
4223
static gps_mask_t ubx_msg_rxm_sfrb(struct gps_device_t *session,
4224
                                   unsigned char *buf, size_t data_len)
4225
0
{
4226
0
    unsigned int i, chan, svid;
4227
0
    uint32_t words[10];
4228
4229
0
    if (42 > data_len) {
4230
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4231
0
                 "UBX: RXM-SFRB: runt payload len %zd", data_len);
4232
0
        return 0;
4233
0
    }
4234
4235
0
    chan = (unsigned int)getub(buf, 0);
4236
0
    svid = (unsigned int)getub(buf, 1);
4237
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4238
0
             "UBX: RXM-SFRB: %u %u\n", chan, svid);
4239
4240
    // UBX does all the parity checking, but still bad data gets through
4241
0
    for (i = 0; i < 10; i++) {
4242
        // bits 24 to 31 undefined, remove them.
4243
0
        words[i] = (uint32_t)getleu32(buf, 4 * i + 2) & 0x00ffffff;
4244
0
    }
4245
4246
    // probably GPS, could be SBAS
4247
0
    return gpsd_interpret_subframe(session, GNSSID_GPS, svid, words);
4248
0
}
4249
4250
/*
4251
 * Raw Subframes - UBX-RXM-SFRBX
4252
 * in u-blox 8, protver 17 and up, time sync firmware only
4253
 * in u-blox F9P and HPG only
4254
 * in u-blox F10N, protVer 27 and up
4255
 * not present  before u-blox8
4256
 */
4257
static gps_mask_t ubx_msg_rxm_sfrbx(struct gps_device_t *session,
4258
                                    unsigned char *buf, size_t data_len)
4259
0
{
4260
0
    unsigned i;
4261
0
    uint32_t words[17];
4262
0
    char *chn_s;
4263
4264
0
    unsigned gnssId = getub(buf, 0);
4265
0
    unsigned svId = getub(buf, 1);
4266
    // reserved in Version 1, and some Version2.  Valid in protVer 27.31 and up
4267
0
    unsigned sigId = getub(buf, 2);
4268
0
    unsigned freqId = getub(buf, 3);
4269
0
    unsigned numWords = getub(buf, 4);
4270
0
    unsigned chn = getub(buf, 5);
4271
0
    unsigned version = getub(buf, 6);
4272
4273
0
    if (1 < version) {
4274
        // receiver channel in version 2 and up.
4275
        // valid range 0 to 13?
4276
0
        chn_s = "chn";
4277
0
    } else {
4278
0
        chn_s = "reserved";
4279
0
    }
4280
4281
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4282
0
             "UBX: RXM-SFRBX: version %u gnssId %u %s %u svId %u "
4283
0
             "sigId %u freqId %u words %u\n",
4284
0
             version, gnssId, chn_s, chn, svId, sigId, freqId, numWords);
4285
0
    GPSD_LOG(LOG_IO, &session->context->errout,
4286
0
             "UBX: RXM-SFRBX:   %s\n",
4287
0
             val2str((gnssId << 8) | sigId, vgnss_sig_ids));
4288
4289
0
    if (!IN(1, version, 2)) {
4290
        // unknown ersion
4291
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4292
0
                 "UBX: RXM-SFRBX: unknown version %u", version);
4293
0
        return 0;
4294
0
    }
4295
0
    if (data_len != (size_t)(8 + (4 * numWords)) ||
4296
0
        16 < numWords) {
4297
        // test numwords directly to shut up Coverity
4298
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4299
0
                 "UBX: RXM-SFRBX: wrong payload len %zd, numwords %u "
4300
0
                 "s/b %u",
4301
0
                 data_len, 8 + (4 * numWords), numWords);
4302
0
        return 0;
4303
0
    }
4304
4305
0
    memset(words, 0, sizeof(words));
4306
0
    for (i = 0; i < numWords; i++) {
4307
        // grab the words, don't mangle them
4308
0
        words[i] = (uint32_t)getleu32(buf, 4 * i + 8);
4309
0
    }
4310
4311
    // do we need freqId or chn?
4312
0
    return gpsd_interpret_subframe_raw(session, gnssId, sigId,
4313
0
                                       svId, words, numWords);
4314
0
}
4315
4316
/**
4317
 * SV Status Info
4318
 *
4319
 * May be good cycle ender
4320
 *
4321
 * Present in u-blox 7
4322
 */
4323
static gps_mask_t ubx_msg_rxm_svsi(struct gps_device_t *session,
4324
                                   unsigned char *buf, size_t data_len)
4325
0
{
4326
0
    unsigned numVis, numSV;
4327
4328
0
    if (8 > data_len) {
4329
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4330
0
                 "UBX: RXM-SVSI: runt payload len %zd", data_len);
4331
0
        return 0;
4332
0
    }
4333
4334
0
    session->driver.ubx.iTOW = getleu32(buf, 0);
4335
0
    session->context->gps_week = getleu16(buf, 4);
4336
0
    numVis = getub(buf, 6);
4337
0
    numSV = getub(buf, 7);
4338
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4339
0
             "UBX: RXM-SVSI: iTOW=%lld week %d numVis %u numSV %u\n",
4340
0
             (long long)session->driver.ubx.iTOW,
4341
0
            session->context->gps_week, numVis, numSV);
4342
0
    return 0;
4343
0
}
4344
4345
/**
4346
 * Unique chip ID
4347
 * UBX-SEC-UNIQID
4348
 *
4349
 * grab the 5 byte serial number / chip id
4350
 */
4351
static gps_mask_t ubx_msg_sec_uniqid(struct gps_device_t *session,
4352
                                     unsigned char *buf,
4353
                                     size_t data_len)
4354
0
{
4355
0
    unsigned version;
4356
4357
0
    if (9 > data_len) {
4358
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4359
0
                 "UBX: SEC-UNIQID: runt payload len %zd\n", data_len);
4360
0
        return 0;
4361
0
    }
4362
4363
0
    version = getub(buf, 0);
4364
0
    switch (version) {
4365
0
    case 1:
4366
        /* string of length 10 bytes
4367
         * PROTVER 18 -> 23 has five bytes of unique id.
4368
         * F10 is PROTVER 34, still has 5 bytes */
4369
0
        (void)snprintf(session->gpsdata.dev.sernum,
4370
0
                       sizeof(session->gpsdata.dev.sernum),
4371
0
                       "%02x%02x%02x%02x%02x",
4372
0
                       getub(buf, 4),
4373
0
                       getub(buf, 5),
4374
0
                       getub(buf, 6),
4375
0
                       getub(buf, 7),
4376
0
                       getub(buf, 8));
4377
0
        break;
4378
0
    case 2:
4379
        /* string of length 12 bytes
4380
         * some PROTVER 34 and beyond (for now) have six bytes of unique id.
4381
         * Such as MAX-M10S. */
4382
0
        (void)snprintf(session->gpsdata.dev.sernum,
4383
0
                       sizeof(session->gpsdata.dev.sernum),
4384
0
                       "%02x%02x%02x%02x%02x%02x",
4385
0
                       getub(buf, 4),
4386
0
                       getub(buf, 5),
4387
0
                       getub(buf, 6),
4388
0
                       getub(buf, 7),
4389
0
                       getub(buf, 8),
4390
0
                       getub(buf, 9));
4391
0
        break;
4392
0
    default:
4393
        // unknown version
4394
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4395
0
                 "UBX: SEC-UNIQID bad version\n");
4396
0
        return 0;
4397
0
    }
4398
4399
    // output chip id at LOG_INF
4400
0
    GPSD_LOG(LOG_INF, &session->context->errout,
4401
0
             "UBX: SEC-UNIQID: %s\n",
4402
0
             session->gpsdata.dev.sernum);
4403
0
    return 0;
4404
0
}
4405
4406
/**
4407
 * Survey-in data - UBX-TIM-SVIN
4408
 * Time Sync products only
4409
 */
4410
static gps_mask_t ubx_msg_tim_svin(struct gps_device_t *session,
4411
                                   unsigned char *buf, size_t data_len UNUSED)
4412
0
{
4413
0
    gps_mask_t mask = ONLINE_SET;
4414
0
    unsigned long dur = getleu32(buf, 0);
4415
0
    long meanX = getles32(buf, 4);
4416
0
    long meanY = getles32(buf, 8);
4417
0
    long meanZ = getles32(buf, 12);
4418
0
    unsigned long meanV = getleu32(buf, 16);
4419
0
    unsigned long obs = getleu32(buf, 20);
4420
0
    unsigned valid = getub(buf, 24);
4421
0
    unsigned active = getub(buf, 25);
4422
    // two reserved bytes
4423
4424
    // casts for 32 bit compatibility
4425
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4426
0
             "UBX: TIM-SVIN: dur=%lu meanX=%ld meanY=%ld meanZ=%ld meanV=%lu "
4427
0
             "obs=%lu valid=%u(%s) active=%u(%s)\n",
4428
0
             dur, meanX, meanY, meanZ, meanV, obs,
4429
0
             valid, val2str(valid, vsvin_valid),
4430
0
             active, val2str(active, vsvin_active));
4431
0
    return mask;
4432
0
}
4433
4434
/**
4435
 * Time Pulse Timedata - UBX-TIM-TP
4436
 */
4437
static gps_mask_t ubx_msg_tim_tp(struct gps_device_t *session,
4438
                                 unsigned char *buf, size_t data_len)
4439
0
{
4440
0
    gps_mask_t mask = ONLINE_SET;
4441
0
    uint32_t towMS;
4442
0
    uint32_t towSubMS;
4443
0
    int32_t qErr;
4444
0
    uint16_t week;
4445
0
    uint8_t flags;
4446
0
    uint8_t refInfo;
4447
0
    timespec_t ts_tow;
4448
4449
0
    if (16 > data_len) {
4450
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4451
0
                 "UBX: TIM-TP: runt payload len %zd", data_len);
4452
0
        return 0;
4453
0
    }
4454
4455
0
    towMS = getleu32(buf, 0);
4456
    // towSubMS always seems zero, which will match the PPS
4457
0
    towSubMS = getleu32(buf, 4);
4458
0
    qErr = getles32(buf, 8);
4459
0
    week = getleu16(buf, 12);
4460
0
    flags = buf[14];
4461
0
    refInfo = buf[15];
4462
4463
    // are we UTC, and towSubMs is zero?
4464
0
    if (3 == (flags & 0x03) &&
4465
0
        0 == towSubMS) {
4466
4467
        // leap already added!?!?
4468
0
        int saved_leap = session->context->leap_seconds;
4469
        // remove it!
4470
0
        session->context->leap_seconds = 0;
4471
4472
        // good, save qErr and qErr_time
4473
0
        session->gpsdata.qErr = qErr;
4474
0
        MSTOTS(&ts_tow, towMS);
4475
0
        session->gpsdata.qErr_time = gpsd_gpstime_resolv(session, week, ts_tow);
4476
4477
        // restore leap
4478
0
        session->context->leap_seconds = saved_leap;
4479
4480
#ifdef __UNUSED
4481
        {
4482
         struct gps_device_t *ppsonly;
4483
         // FIXME!! should be up a layer so other drivers can use it
4484
         // FIXME!! this qErr can only apply to one PPS!
4485
         // propagate this in-band-time to all PPS-only devices
4486
         for (ppsonly = devices; ppsonly < devices + MAX_DEVICES; ppsonly++)
4487
             if (SOURCE_PPS == ppsonly->sourcetype) {
4488
                 pps_thread_qErrin(&ppsonly->pps_thread, qErr,
4489
                                   session->gpsdata.qErr_time);
4490
             }
4491
        }
4492
#endif  // __UNUSED
4493
4494
0
    }
4495
4496
    // cast for 32 bit compatibility
4497
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
4498
0
             "UBX: TIM-TP: towMS %lu, towSubMS %lu, qErr %ld week %u "
4499
0
             "flags %#x, refInfo %#x\n",
4500
0
             (unsigned long)towMS, (unsigned long)towSubMS, (long)qErr,
4501
0
              week, flags, refInfo);
4502
0
    return mask;
4503
0
}
4504
4505
static gps_mask_t ubx_parse(struct gps_device_t * session, unsigned char *buf,
4506
                            size_t len)
4507
0
{
4508
0
    size_t data_len;
4509
0
    unsigned short msgid;
4510
0
    gps_mask_t mask = 0;
4511
0
    unsigned char min_protver = 0;
4512
4513
    // the packet at least contains a head long enough for an empty message
4514
0
    if (UBX_PREFIX_LEN > len) {
4515
0
        return 0;
4516
0
    }
4517
4518
0
    session->cycle_end_reliable = true;
4519
0
    session->driver.ubx.iTOW = -1;        // set by decoder
4520
4521
    // extract message id and length
4522
0
    msgid = getbes16(buf, 2);
4523
0
    data_len = (size_t) getles16(buf, 4);
4524
4525
    /* FIXME: make each case just call one function.
4526
     / then this switch can be turned into a table. */
4527
0
    switch (msgid) {
4528
0
    case UBX_ACK_ACK:
4529
0
        FALLTHROUGH
4530
0
    case UBX_ACK_NAK:
4531
0
        mask = ubx_msg_ack(session, buf, data_len);
4532
0
        break;
4533
4534
    /* UBX-AID-*
4535
     * removed in protVer 32 */
4536
0
    case UBX_CFG_NAV5:
4537
        // deprecated in u-blox 10
4538
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: CFG-NAV5\n");
4539
0
        break;
4540
0
    case UBX_CFG_NAVX5:
4541
        // deprecated in u-blox 10
4542
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: CFG-NAVX5\n");
4543
0
        break;
4544
0
    case UBX_CFG_PRT:
4545
        // deprecated in u-blox 10
4546
0
        if (session->driver.ubx.port_id != buf[UBX_PREFIX_LEN + 0] ) {
4547
0
            session->driver.ubx.port_id = buf[UBX_PREFIX_LEN + 0];
4548
0
            GPSD_LOG(LOG_INF, &session->context->errout,
4549
0
                     "UBX: CFG-PRT: port %d\n", session->driver.ubx.port_id);
4550
0
        }
4551
0
        break;
4552
0
    case UBX_CFG_RATE:
4553
        // deprecated in u-blox 10
4554
0
        mask = ubx_msg_cfg_rate(session, &buf[UBX_PREFIX_LEN], data_len);
4555
0
        break;
4556
0
    case UBX_CFG_VALGET:
4557
0
        min_protver = 24;
4558
0
        mask = ubx_msg_cfg_valget(session, &buf[UBX_PREFIX_LEN], data_len);
4559
0
        break;
4560
4561
0
    case UBX_ESF_ALG:
4562
0
        mask = ubx_msg_esf_alg(session, &buf[UBX_PREFIX_LEN], data_len);
4563
0
        break;
4564
0
    case UBX_ESF_INS:
4565
0
        mask = ubx_msg_esf_ins(session, &buf[UBX_PREFIX_LEN], data_len);
4566
0
        break;
4567
0
    case UBX_ESF_MEAS:
4568
0
        mask = ubx_msg_esf_meas(session, &buf[UBX_PREFIX_LEN], data_len);
4569
0
        break;
4570
0
    case UBX_ESF_RAW:
4571
0
        mask = ubx_msg_esf_raw(session, &buf[UBX_PREFIX_LEN], data_len);
4572
0
        break;
4573
0
    case UBX_ESF_STATUS:
4574
0
        mask = ubx_msg_esf_status(session, &buf[UBX_PREFIX_LEN], data_len);
4575
0
        break;
4576
4577
0
    case UBX_HNR_ATT:
4578
0
        min_protver = 19;       // actually 19.2
4579
0
        mask = ubx_msg_hnr_att(session, &buf[UBX_PREFIX_LEN], data_len);
4580
0
        break;
4581
0
    case UBX_HNR_INS:
4582
0
        min_protver = 19;       // actually 19.1
4583
0
        mask = ubx_msg_hnr_ins(session, &buf[UBX_PREFIX_LEN], data_len);
4584
0
        break;
4585
0
    case UBX_HNR_PVT:
4586
0
        min_protver = 19;
4587
0
        mask = ubx_msg_hnr_pvt(session, &buf[UBX_PREFIX_LEN], data_len);
4588
0
        break;
4589
4590
0
    case UBX_INF_DEBUG:
4591
0
        FALLTHROUGH
4592
0
    case UBX_INF_ERROR:
4593
0
        FALLTHROUGH
4594
0
    case UBX_INF_NOTICE:
4595
0
        FALLTHROUGH
4596
0
    case UBX_INF_TEST:
4597
0
        FALLTHROUGH
4598
0
    case UBX_INF_USER:
4599
0
        FALLTHROUGH
4600
0
    case UBX_INF_WARNING:
4601
0
        min_protver = 13;
4602
0
        mask = ubx_msg_inf(session, buf, data_len);
4603
0
        break;
4604
4605
0
    case UBX_LOG_BATCH:
4606
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: LOG-BATCH\n");
4607
0
        mask = ubx_msg_log_batch(session, &buf[UBX_PREFIX_LEN], data_len);
4608
0
        break;
4609
0
    case UBX_LOG_INFO:
4610
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: LOG-INFO\n");
4611
0
        mask = ubx_msg_log_info(session, &buf[UBX_PREFIX_LEN], data_len);
4612
0
        break;
4613
0
    case UBX_LOG_RETRIEVEPOS:
4614
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: LOG-RETRIEVEPOS\n");
4615
0
        mask = ubx_msg_log_retrievepos(session, &buf[UBX_PREFIX_LEN], data_len);
4616
0
        break;
4617
0
    case UBX_LOG_RETRIEVEPOSEXTRA:
4618
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
4619
0
                 "UBX: LOG-RETRIEVEPOSEXTRA\n");
4620
0
        mask = ubx_msg_log_retrieveposextra(session, &buf[UBX_PREFIX_LEN],
4621
0
                                            data_len);
4622
0
        break;
4623
0
    case UBX_LOG_RETRIEVESTRING:
4624
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
4625
0
                 "UBX: LOG-RETRIEVESTRING\n");
4626
0
        mask = ubx_msg_log_retrievestring(session, &buf[UBX_PREFIX_LEN],
4627
0
                                          data_len);
4628
0
        break;
4629
4630
0
    case UBX_MON_BATCH:
4631
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-BATCH\n");
4632
0
        break;
4633
0
    case UBX_MON_COMMS:
4634
0
        mask = ubx_msg_mon_comms(session, &buf[UBX_PREFIX_LEN], data_len);
4635
0
        break;
4636
0
    case UBX_MON_EXCEPT:
4637
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-EXCEPT\n");
4638
0
        break;
4639
0
    case UBX_MON_GNSS:
4640
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-GNSS\n");
4641
0
        break;
4642
0
    case UBX_MON_HW:
4643
0
        min_protver = 12;
4644
0
        mask = ubx_msg_mon_hw(session, &buf[UBX_PREFIX_LEN], data_len);
4645
0
        break;
4646
0
    case UBX_MON_HW2:
4647
         // Deprecated in protVer 32 (9-series, 10-series)
4648
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-HW2\n");
4649
0
        break;
4650
0
    case UBX_MON_HW3:
4651
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-HW3\n");
4652
0
        break;
4653
0
    case UBX_MON_IO:
4654
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-IO\n");
4655
0
        break;
4656
0
    case UBX_MON_IPC:
4657
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-IPC\n");
4658
0
        break;
4659
0
    case UBX_MON_MSGPP:
4660
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-MSGPP\n");
4661
0
        break;
4662
0
    case UBX_MON_PATCH:
4663
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-PATCH\n");
4664
0
        break;
4665
0
    case UBX_MON_RF:
4666
0
        mask = ubx_msg_mon_rf(session, &buf[UBX_PREFIX_LEN], data_len);
4667
0
        break;
4668
0
    case UBX_MON_RXBUF:
4669
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-RXBUF\n");
4670
0
        mask = ubx_msg_mon_rxbuf(session, &buf[UBX_PREFIX_LEN], data_len);
4671
0
        break;
4672
0
    case UBX_MON_RXR:
4673
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-RXR\n");
4674
0
        break;
4675
0
    case UBX_MON_SCHED:
4676
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-SCHED\n");
4677
0
        break;
4678
0
    case UBX_MON_SMGR:
4679
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-SMGR\n");
4680
0
        break;
4681
0
    case UBX_MON_SPAN:
4682
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-SPAN\n");
4683
0
        break;
4684
0
    case UBX_MON_TXBUF:
4685
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-TXBUF\n");
4686
0
        mask = ubx_msg_mon_txbuf(session, &buf[UBX_PREFIX_LEN], data_len);
4687
0
        break;
4688
0
    case UBX_MON_USB:
4689
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MON-USB\n");
4690
0
        break;
4691
0
    case UBX_MON_VER:
4692
0
        mask = ubx_msg_mon_ver(session, &buf[UBX_PREFIX_LEN], data_len);
4693
0
        break;
4694
4695
0
    case UBX_NAV_AOPSTATUS:
4696
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-AOPSTATUS\n");
4697
0
        break;
4698
0
    case UBX_NAV_ATT:
4699
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-ATT\n");
4700
0
        break;
4701
0
    case UBX_NAV_CLOCK:
4702
0
        mask = ubx_msg_nav_clock(session, &buf[UBX_PREFIX_LEN], data_len);
4703
0
        break;
4704
0
    case UBX_NAV_DGPS:
4705
0
        mask = ubx_msg_nav_dgps(session, &buf[UBX_PREFIX_LEN], data_len);
4706
0
        break;
4707
0
    case UBX_NAV_DOP:
4708
        // DOP seems to be the last NAV sent in a cycle, unless NAV-EOE
4709
0
        mask = ubx_msg_nav_dop(session, &buf[UBX_PREFIX_LEN], data_len);
4710
0
        break;
4711
0
    case UBX_NAV_EELL:
4712
0
        min_protver = 18;
4713
0
        mask = ubx_msg_nav_eell(session, &buf[UBX_PREFIX_LEN], data_len);
4714
0
        break;
4715
0
    case UBX_NAV_EKFSTATUS:
4716
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-EKFSTATUS\n");
4717
0
        break;
4718
0
    case UBX_NAV_EOE:
4719
0
        min_protver = 18;
4720
0
        mask = ubx_msg_nav_eoe(session, &buf[UBX_PREFIX_LEN], data_len);
4721
0
        break;
4722
0
    case UBX_NAV_GEOFENCE:
4723
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-GEOFENCE\n");
4724
0
        break;
4725
0
    case UBX_NAV_HPPOSECEF:
4726
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-HPPOSECEF\n");
4727
0
        mask = ubx_msg_nav_hpposecef(session, &buf[UBX_PREFIX_LEN], data_len);
4728
0
        break;
4729
0
    case UBX_NAV_HPPOSLLH:
4730
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-HPPOSLLH\n");
4731
0
        mask = ubx_msg_nav_hpposllh(session, &buf[UBX_PREFIX_LEN], data_len);
4732
0
        break;
4733
0
    case UBX_NAV_ODO:
4734
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-ODO\n");
4735
0
        break;
4736
0
    case UBX_NAV_ORB:
4737
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-ORB\n");
4738
0
        break;
4739
0
    case UBX_NAV_POSECEF:
4740
0
        mask = ubx_msg_nav_posecef(session, &buf[UBX_PREFIX_LEN], data_len);
4741
0
        break;
4742
0
    case UBX_NAV_POSLLH:
4743
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-POSLLH\n");
4744
0
        mask = ubx_msg_nav_posllh(session, &buf[UBX_PREFIX_LEN], data_len);
4745
0
        break;
4746
0
    case UBX_NAV_POSUTM:
4747
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-POSUTM\n");
4748
0
        break;
4749
0
    case UBX_NAV_PVT:
4750
0
        min_protver = 14;
4751
0
        mask = ubx_msg_nav_pvt(session, &buf[UBX_PREFIX_LEN], data_len);
4752
0
        break;
4753
0
    case UBX_NAV_RELPOSNED:
4754
0
        min_protver = 20;
4755
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-RELPOSNED\n");
4756
0
        mask = ubx_msg_nav_relposned(session, &buf[UBX_PREFIX_LEN], data_len);
4757
0
        break;
4758
0
    case UBX_NAV_RESETODO:
4759
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-RESETODO\n");
4760
0
        break;
4761
0
    case UBX_NAV_SAT:
4762
0
        min_protver = 15;
4763
0
        mask = ubx_msg_nav_sat(session, &buf[UBX_PREFIX_LEN], data_len);
4764
0
        break;
4765
0
    case UBX_NAV_SBAS:
4766
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-SBAS\n");
4767
0
        mask = ubx_msg_nav_sbas(session, &buf[UBX_PREFIX_LEN], data_len);
4768
0
        break;
4769
0
    case UBX_NAV_SIG:
4770
0
        min_protver = 27;
4771
0
        mask = ubx_msg_nav_sig(session, &buf[UBX_PREFIX_LEN], data_len);
4772
0
        break;
4773
0
    case UBX_NAV_SOL:
4774
        /* UBX-NAV-SOL deprecated in u-blox 6,
4775
         * removed in protVer 32 (9 and 10 series).
4776
         * Use UBX-NAV-PVT instead */
4777
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-SOL\n");
4778
0
        mask = ubx_msg_nav_sol(session, &buf[UBX_PREFIX_LEN], data_len);
4779
0
        break;
4780
0
    case UBX_NAV_STATUS:
4781
0
        mask = ubx_msg_nav_status(session, &buf[UBX_PREFIX_LEN], data_len);
4782
0
        break;
4783
0
    case UBX_NAV_SVIN:
4784
0
        if (40 > data_len) {
4785
0
            GPSD_LOG(LOG_WARN, &session->context->errout,
4786
0
                     "UBX: NAV-SVIN: runt payload len %zd", data_len);
4787
0
            break;
4788
0
        }
4789
0
        mask = ubx_msg_nav_svin(session, &buf[UBX_PREFIX_LEN], data_len);
4790
0
        break;
4791
0
    case UBX_NAV_SVINFO:
4792
0
        mask = ubx_msg_nav_svinfo(session, &buf[UBX_PREFIX_LEN], data_len);
4793
0
        break;
4794
0
    case UBX_NAV_TIMEBDS:
4795
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-TIMEBDS\n");
4796
0
        break;
4797
0
    case UBX_NAV_TIMEGAL:
4798
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-TIMEGAL\n");
4799
0
        break;
4800
0
    case UBX_NAV_TIMEGLO:
4801
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-TIMEGLO\n");
4802
0
        break;
4803
0
    case UBX_NAV_TIMEGPS:
4804
0
        mask = ubx_msg_nav_timegps(session, &buf[UBX_PREFIX_LEN], data_len);
4805
0
        break;
4806
0
    case UBX_NAV_TIMELS:
4807
0
        mask = ubx_msg_nav_timels(session, &buf[UBX_PREFIX_LEN], data_len);
4808
0
        break;
4809
0
    case UBX_NAV_TIMEQZSS:
4810
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-TIMEQZSS\n");
4811
0
        break;
4812
0
    case UBX_NAV_TIMEUTC:
4813
0
        mask = ubx_msg_nav_timeutc(session, &buf[UBX_PREFIX_LEN], data_len);
4814
0
        break;
4815
0
    case UBX_NAV_VELECEF:
4816
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-VELECEF\n");
4817
0
        mask = ubx_msg_nav_velecef(session, &buf[UBX_PREFIX_LEN], data_len);
4818
0
        break;
4819
0
    case UBX_NAV_VELNED:
4820
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: NAV-VELNED\n");
4821
0
        mask = ubx_msg_nav_velned(session, &buf[UBX_PREFIX_LEN], data_len);
4822
0
        break;
4823
4824
0
    case UBX_MGA_ACK:
4825
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MGA-ACK\n");
4826
0
        break;
4827
0
    case UBX_MGA_DBD:
4828
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: MGA-DBD\n");
4829
0
        break;
4830
4831
0
    case UBX_RXM_ALM:
4832
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-ALM\n");
4833
0
        break;
4834
0
    case UBX_RXM_EPH:
4835
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-EPH\n");
4836
0
        break;
4837
0
    case UBX_RXM_IMES:
4838
        // Removed in protVer 32 (9-series)
4839
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-IMES\n");
4840
0
        break;
4841
0
    case UBX_RXM_MEASX:
4842
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-MEASX\n");
4843
0
        break;
4844
0
    case UBX_RXM_PMREQ:
4845
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-PMREQ\n");
4846
0
        break;
4847
0
    case UBX_RXM_POSREQ:
4848
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-POSREQ\n");
4849
0
        break;
4850
0
    case UBX_RXM_RAW:
4851
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-RAW\n");
4852
0
        break;
4853
0
    case UBX_RXM_RAWX:
4854
0
        mask = ubx_msg_rxm_rawx(session, &buf[UBX_PREFIX_LEN], data_len);
4855
0
        break;
4856
0
    case UBX_RXM_RLM:
4857
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-RLM\n");
4858
0
        break;
4859
0
    case UBX_RXM_RTCM:
4860
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: RXM-RTCM\n");
4861
0
        break;
4862
0
    case UBX_RXM_SFRB:
4863
0
        mask = ubx_msg_rxm_sfrb(session, &buf[UBX_PREFIX_LEN], data_len);
4864
0
        break;
4865
0
    case UBX_RXM_SFRBX:
4866
0
        min_protver = 17;
4867
0
        if (8 > data_len) {
4868
0
            GPSD_LOG(LOG_WARN, &session->context->errout,
4869
0
                     "UBX: RXM-SFRBX: runt payload len %zd", data_len);
4870
0
            break;
4871
0
        }
4872
0
        mask = ubx_msg_rxm_sfrbx(session, &buf[UBX_PREFIX_LEN], data_len);
4873
0
        break;
4874
0
    case UBX_RXM_SVSI:
4875
        // Removed in protVer 32 (9-series)
4876
        // Use UBX-NAV-ORB instead
4877
0
        mask = ubx_msg_rxm_svsi(session, &buf[UBX_PREFIX_LEN], data_len);
4878
0
        break;
4879
4880
    // undocumented
4881
    // case UBX_SEC_SESSID:
4882
    //     GPSD_LOG(LOG_PROG, &session->context->errout, "UBX-SEC-SESSID\n");
4883
    //     break;
4884
0
    case UBX_SEC_SIGN:
4885
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: SEC_SIGN\n");
4886
0
        break;
4887
0
    case UBX_SEC_UNIQID:
4888
0
        mask = ubx_msg_sec_uniqid(session, &buf[UBX_PREFIX_LEN], data_len);
4889
0
        break;
4890
0
    case UBX_TIM_DOSC:
4891
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-DOSC\n");
4892
0
        break;
4893
0
    case UBX_TIM_FCHG:
4894
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-FCHG\n");
4895
0
        break;
4896
0
    case UBX_TIM_HOC:
4897
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-HOC\n");
4898
0
        break;
4899
0
    case UBX_TIM_SMEAS:
4900
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-SMEAS\n");
4901
0
        break;
4902
0
    case UBX_TIM_SVIN:
4903
0
        if (28 > data_len) {
4904
0
            GPSD_LOG(LOG_WARN, &session->context->errout,
4905
0
                     "UBX: TIM-SVIN: runt payload len %zd", data_len);
4906
0
            break;
4907
0
        }
4908
0
        mask = ubx_msg_tim_svin(session, &buf[UBX_PREFIX_LEN], data_len);
4909
0
        break;
4910
0
    case UBX_TIM_TM:
4911
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-TM\n");
4912
0
        break;
4913
0
    case UBX_TIM_TM2:
4914
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-TM2\n");
4915
0
        break;
4916
0
    case UBX_TIM_TP:
4917
0
        mask = ubx_msg_tim_tp(session, &buf[UBX_PREFIX_LEN], data_len);
4918
0
        break;
4919
0
    case UBX_TIM_TOS:
4920
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-TOS\n");
4921
0
        break;
4922
0
    case UBX_TIM_VCOCAL:
4923
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-VCOCAL\n");
4924
0
        break;
4925
0
    case UBX_TIM_VRFY:
4926
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX: TIM-VRFY\n");
4927
0
        break;
4928
4929
0
    default:
4930
0
        GPSD_LOG(LOG_WARN, &session->context->errout,
4931
0
                 "UBX: unknown packet id x%04hx (length %zd)\n",
4932
0
                 msgid, len);
4933
0
    }
4934
#ifdef __UNUSED
4935
    // debug
4936
    GPSD_LOG(LOG_PROG, &session->context->errout,
4937
             "UBX: msgid x%04x end x%04x last x%04x iTOW %lld last %lld\n",
4938
             msgid,
4939
             session->driver.ubx.end_msgid,
4940
             session->driver.ubx.last_msgid,
4941
             (long long)session->driver.ubx.iTOW,
4942
             (long long)session->driver.ubx.last_iTOW);
4943
#endif
4944
4945
    // iTOW drives the cycle start/end detection
4946
    // iTOW is in ms, can go forward or backward
4947
0
    if (-1 < session->driver.ubx.iTOW) {
4948
0
        int64_t iTOW_diff;
4949
4950
        // this sentence has a (maybe good) time
4951
        // end of cycle ?
4952
0
        if (session->driver.ubx.end_msgid == msgid) {
4953
            // got known cycle ender.  Assume end of cycle, report it
4954
0
            GPSD_LOG(LOG_PROG, &session->context->errout,
4955
0
                     "UBX: cycle end x%04x iTOW %lld\n",
4956
0
                     msgid, (long long)session->driver.ubx.iTOW);
4957
0
            mask |= REPORT_IS;
4958
0
        }
4959
4960
        // start of cycle?  Start can equal end if only one message per epoch
4961
        // u-blox iTOW can have ms jitter in the same epoch!
4962
0
        iTOW_diff = session->driver.ubx.last_iTOW - session->driver.ubx.iTOW;
4963
0
        if (10 < llabs(iTOW_diff)) {
4964
            // time changed more than 10 ms (100 Hz), cycle start
4965
4966
0
            if (session->driver.ubx.end_msgid !=
4967
0
                session->driver.ubx.last_msgid) {
4968
                // new cycle ender
4969
0
                GPSD_LOG(LOG_PROG, &session->context->errout,
4970
0
                         "UBX: new ender x%04x was x%04x iTOW %lld was %lld\n",
4971
0
                         session->driver.ubx.last_msgid,
4972
0
                         session->driver.ubx.end_msgid,
4973
0
                         (long long)session->driver.ubx.iTOW,
4974
0
                         (long long)session->driver.ubx.last_iTOW);
4975
0
                session->driver.ubx.end_msgid = session->driver.ubx.last_msgid;
4976
0
            }
4977
0
            session->driver.ubx.last_iTOW = session->driver.ubx.iTOW;
4978
0
            mask |= CLEAR_IS;
4979
0
        }
4980
4981
0
        session->driver.ubx.last_msgid = msgid;
4982
        // FIXME: last_time never used...
4983
0
        session->driver.ubx.last_time = session->newdata.time;
4984
0
    } else {
4985
        // no time
4986
        /* debug
4987
        GPSD_LOG(LOG_ERROR, &session->context->errout,
4988
                 "UBX: No time, msgid %x\n", msgid);
4989
         */
4990
0
    }
4991
4992
    // Did protver change?
4993
0
    if (min_protver > session->driver.ubx.protver) {
4994
        // this GPS is at least min_protver
4995
0
        session->driver.ubx.protver = min_protver;
4996
0
    }
4997
0
    if (session->driver.ubx.last_protver != session->driver.ubx.protver) {
4998
        /* Assumption: we just did init, but did not have
4999
         * protver then, so init is not complete.  Finish now.
5000
         * unless user requested passive mode */
5001
0
        if (session->mode == O_OPTIMIZE &&
5002
0
            !session->context->passive) {
5003
0
            ubx_mode(session, MODE_BINARY);
5004
0
        }
5005
0
        GPSD_LOG(LOG_PROG, &session->context->errout,
5006
0
                 "UBX: new PROTVER %u was %u\n",
5007
0
                 session->driver.ubx.protver,
5008
0
                 session->driver.ubx.last_protver);
5009
0
        session->driver.ubx.last_protver = session->driver.ubx.protver;
5010
        // restart init queue
5011
0
        session->queue = 0;
5012
0
    }
5013
5014
0
    if (!session->context->readonly &&
5015
0
        0 <= session->queue &&
5016
0
        100 > session->queue &&
5017
0
        0 < session->driver.ubx.protver) {
5018
0
        unsigned char msg[4] = {0};
5019
5020
0
        GPSD_LOG(LOG_DATA, &session->context->errout,
5021
0
                 "UBX: queue %d\n", session->queue);
5022
5023
        /* handle the init queue.  Some u-blox parts get cranky when they
5024
         * get too many configuration changes at once.
5025
         */
5026
5027
0
        if (50 <= session->queue &&
5028
0
            !session->context->passive) {
5029
            // turn off common NMEA, every 3rd queue turn.
5030
0
            int i = session->queue - 50;
5031
0
            if (0 == (i % 3)) {
5032
0
                int j = i / 3;
5033
0
                if (j < (int)sizeof(nmea_off)) {
5034
0
                    msg[0] = 0xf0;          // class, NMEA
5035
0
                    msg[2] = 0x00;          // rate, off
5036
0
                    msg[1] = nmea_off[j];    // msg id to turn off
5037
0
                    (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5038
0
                }
5039
0
            }
5040
0
        }
5041
5042
0
        switch (session->queue) {
5043
0
        case 0:
5044
            /* need to doi this right away, so there are UBX message
5045
            * to push this queue forward */
5046
0
            if (!session->context->passive) {
5047
                // turn on common UBX-NAV
5048
0
                unsigned i;
5049
5050
0
                msg[0] = 0x01;          // class, UBX-NAV
5051
0
                msg[2] = 0x01;          // rate, one
5052
0
                for (i = 0; i < ROWS(ubx_nav_on); i++) {
5053
0
                    msg[1] = ubx_nav_on[i];          // msg id to turn on
5054
0
                    (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5055
0
                }
5056
0
            }
5057
0
            break;
5058
0
        case 10:
5059
            /* Older u-blox (6-series) may have ignored earlier requests
5060
             * for UBX-MON-VER.  Try again if needed. */
5061
0
            if ('\0' == session->subtype[0]) {
5062
                // request UBX-MON-VER, for  SW and HW Versions
5063
0
                (void)ubx_write(session, UBX_CLASS_MON, 0x04, NULL, 0);
5064
0
            }
5065
0
            break;
5066
0
        case 20:
5067
0
            if (!session->context->passive) {
5068
0
                unsigned i;
5069
5070
0
                msg[0] = 0x01;          // class, UBX-NAV
5071
0
                msg[2] = 0x01;          // rate, one
5072
0
                if (15 > session->driver.ubx.protver) {
5073
                    /* protver 14 or less, or unknown version,
5074
                     * We should have a version now.
5075
                     * Turn on pre-15 UBX-NAV stuff */
5076
5077
0
                    for (i = 0; i < ROWS(ubx_14_nav_on); i++) {
5078
                        // msg id to turn on
5079
0
                        msg[1] = ubx_14_nav_on[i];
5080
0
                        (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5081
0
                    }
5082
0
                } else {
5083
                    /* must be 15 <= session->driver.ubx.protver
5084
                     * turn on 15+ UBX-NAV */
5085
0
                    for (i = 0; i < ROWS(ubx_15_nav_on); i++) {
5086
                        // msg id to turn on
5087
0
                        msg[1] = ubx_15_nav_on[i];
5088
0
                        (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5089
0
                    }
5090
0
                }
5091
0
            }
5092
0
            break;
5093
0
        case 71:
5094
0
            if (!session->context->passive &&
5095
0
                15 <= session->driver.ubx.protver) {
5096
                // good cycle ender, except when it is not the ender...
5097
0
                msg[0] = 0x01;          // class
5098
0
                msg[1] = 0x61;          // msg id  = UBX-NAV-EOE
5099
0
                msg[2] = 0x01;          // every cycle
5100
0
                (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5101
0
            }
5102
0
            break;
5103
0
        case 75:
5104
0
            if (!session->context->passive &&
5105
0
                15 <= session->driver.ubx.protver) {
5106
0
                msg[0] = 0x01;          // class
5107
0
                msg[1] = 0x26;          // msg id  = UBX-NAV-TIMELS
5108
0
                msg[2] = 0xff;          // about every 4 mins if nav rate is 1Hz
5109
0
                (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5110
0
            }
5111
0
            break;
5112
0
        case 80:
5113
0
            if (18 <= session->driver.ubx.protver) {
5114
                // No UNIQ-ID before PROTVER 18
5115
                // UBX-SEC-UNIQID: query for uniq id
5116
0
                (void)ubx_write(session, UBX_CLASS_SEC, 0x03, NULL, 0);
5117
0
            }
5118
0
            break;
5119
0
        case 83:
5120
0
            if (session->context->passive) {
5121
                // do nothing
5122
0
            } else if (27 > session->driver.ubx.protver) {
5123
0
                msg[0] = 0x0a;          // class, UBX-MON
5124
0
                msg[1] = 0x09;          // MON-HW
5125
0
                msg[2] = 0x04;          // every 4
5126
0
                (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5127
0
            } else {
5128
0
                msg[0] = 0x0a;          // class, UBX-MON
5129
0
                msg[1] = 0x38;          // MON-RF
5130
0
                msg[2] = 0x04;          // every 4
5131
0
                (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5132
0
            }
5133
0
            break;
5134
0
        case 87:
5135
0
            if (15 > session->driver.ubx.protver) {
5136
0
                unsigned i;
5137
5138
                /* protver 14 or less
5139
                 * turn off 15 and above UBX-NAV.  Do we need to? */
5140
0
                msg[0] = 0x01;          // class, UBX-NAV
5141
0
                msg[2] = 0x00;          // rate, off
5142
0
                for (i = 0; i < ROWS(ubx_15_nav_on); i++) {
5143
0
                    msg[1] = ubx_15_nav_on[i];          // msg id to turn off
5144
0
                    (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5145
0
                }
5146
0
            }
5147
0
            break;
5148
0
        case 90:
5149
            // Turn off some clutter, no need to do it early
5150
0
            if (!session->context->passive &&
5151
0
                15 <= session->driver.ubx.protver &&
5152
0
                27 > session->driver.ubx.protver) {
5153
                /* protver 15 or more, and less than 27
5154
                 * Soturn off 14 and below UBX-NAV */
5155
0
                unsigned i;
5156
5157
0
                msg[0] = 0x01;          // class, UBX-NAV
5158
0
                msg[2] = 0x00;          // rate, off
5159
0
                for (i = 0; i < ROWS(ubx_14_nav_on); i++) {
5160
0
                    msg[1] = ubx_14_nav_on[i];          // msg id to turn off
5161
0
                    (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5162
0
                }
5163
0
            }
5164
0
            break;
5165
0
        case 93:
5166
            /* finish up by checking if we overflowed the input buffer
5167
             * request MON-RXBUF/TXBUFF, or MON-COMMS */
5168
0
            if (27 > session->driver.ubx.protver) {
5169
                // MON-RXBUF and MON-TXBUF
5170
0
                (void)ubx_write(session, UBX_CLASS_MON, 0x08, NULL, 0);
5171
0
                (void)ubx_write(session, UBX_CLASS_MON, 0x07, NULL, 0);
5172
0
            } else {
5173
                // MON-COMMS
5174
0
                (void)ubx_write(session, UBX_CLASS_MON, 0x36, NULL, 0);
5175
0
            }
5176
0
            break;
5177
0
        default:
5178
0
            break;
5179
0
        }
5180
0
        session->queue++;
5181
0
    }
5182
0
    return mask | ONLINE_SET;
5183
0
}
5184
5185
static gps_mask_t parse_input(struct gps_device_t *session)
5186
0
{
5187
0
    if (UBX_PACKET == session->lexer.type) {
5188
0
        return ubx_parse(session, session->lexer.outbuffer,
5189
0
                         session->lexer.outbuflen);
5190
0
    }
5191
0
    return generic_parse_input(session);
5192
0
}
5193
5194
// not used by gpsd, it's for gpsctl and friends
5195
static ssize_t ubx_control_send(struct gps_device_t *session, char *msg,
5196
                                size_t data_len)
5197
0
{
5198
0
    return ubx_write(session, (unsigned int)msg[0], (unsigned int)msg[1],
5199
0
                     (unsigned char *)msg + 2,
5200
0
                     (size_t)(data_len - 2)) ? ((ssize_t) (data_len + 7)) : -1;
5201
0
}
5202
5203
static void ubx_init_query(struct gps_device_t *session)
5204
0
{
5205
    // UBX-MON-VER: query for version information
5206
0
    (void)ubx_write(session, UBX_CLASS_MON, 0x04, NULL, 0);
5207
5208
    /* We can't get query for UBX-SEC-UNIQID as we need the protver first.
5209
     * Plus, we want to chain requests so as not to  overflow the receiver
5210
     * inbuffers. */
5211
0
}
5212
5213
static void ubx_event_hook(struct gps_device_t *session, event_t event)
5214
0
{
5215
0
    if (session->context->readonly) {
5216
0
        return;
5217
0
    }
5218
0
    if (event == EVENT_IDENTIFIED) {
5219
0
        GPSD_LOG(LOG_PROG, &session->context->errout, "UBX identified\n");
5220
5221
        // no longer set UBX-CFG-SBAS here, u-blox 9 and 10 do not have it
5222
5223
0
        if (session->context->passive) {
5224
            /* passive mode, do no autoconfig
5225
             * but we really want MON-VER. */
5226
0
            (void)ubx_write(session, UBX_CLASS_MON, 0x04, NULL, 0);
5227
0
        } else if (O_OPTIMIZE == session->mode) {
5228
            // Turn off UBX output, turn on NMEA on this port.
5229
0
            ubx_mode(session, MODE_BINARY);
5230
0
        } else {
5231
            //* Turn off NMEA output, turn on UBX on this port.
5232
0
            ubx_mode(session, MODE_NMEA);
5233
0
        }
5234
0
    } else if (event == EVENT_DEACTIVATE) {
5235
        /* There used to be a hotstart/reset here.
5236
         * That caused u-blox USB to re-enumerate.
5237
         * Sometimes to a new device name.
5238
         * Bad.  Don't do that anymore...
5239
         */
5240
0
    }
5241
0
}
5242
5243
// generate and send a configuration block
5244
static gps_mask_t ubx_cfg_prt(struct gps_device_t *session, speed_t speed,
5245
                              const char parity,
5246
                              const int stopbits, const int mode)
5247
0
{
5248
0
    unsigned long usart_mode = 0;
5249
0
    unsigned char buf[UBX_CFG_LEN];
5250
0
    unsigned long i;
5251
5252
0
    memset(buf, '\0', UBX_CFG_LEN);
5253
5254
    /*
5255
     * When this is called from gpsd, the initial probe for UBX should
5256
     * have picked up the device's port number from the CFG_PRT response.
5257
     */
5258
    // FIXME!  Bad test, port_id == 0 is valid too.  DDC (I2X) = port 0
5259
0
    if (session->driver.ubx.port_id != 0) {
5260
0
        buf[0] = session->driver.ubx.port_id;
5261
0
    }
5262
    /*
5263
     * This default can be hit if we haven't sent a CFG_PRT query yet,
5264
     * which can happen in gpsmon because it doesn't autoprobe.
5265
     *
5266
     * What we'd like to do here is dispatch to USART1_ID or
5267
     * USB_ID intelligently based on whether this is a USB or RS232
5268
     * source.  Unfortunately the GR601-W screws that up by being
5269
     * a USB device with port_id 1.  So we bite the bullet and
5270
     * default to port 1.
5271
     *
5272
     * Without further logic, this means gpsmon wouldn't be able to
5273
     * change the speed on the EVK 6H's USB port.  But! To pick off
5274
     * the EVK 6H on Linux as a special case, we notice that its
5275
     * USB device name is /dev/ttyACMx - it presents as a USB modem.
5276
     *
5277
     * This logic will fail on any USB u-blox device that presents
5278
     * as an ordinary USB serial device (/dev/ttyUSB*) and actually
5279
     * has port ID 3 the way it "ought" to.
5280
     */
5281
0
    else if (strstr(session->gpsdata.dev.path, "/ttyACM") != NULL) {
5282
        // using the built in USB port
5283
        // FIXME!!  USB port has no speed!
5284
        // FIXME!!  maybe we know the portid already?
5285
0
        session->driver.ubx.port_id = buf[0] = USB_ID;
5286
0
    } else {
5287
        // A guess.  Could be UART2, or SPI, or DDC port
5288
0
        session->driver.ubx.port_id = buf[0] = USART1_ID;
5289
0
    }
5290
5291
0
    putle32(buf, 8, speed);
5292
5293
    /*
5294
     * u-blox tech support explains the default contents of the mode
5295
     * field as follows:
5296
     *
5297
     * D0 08 00 00     mode (LSB first)
5298
     *
5299
     * re-ordering bytes: 000008D0
5300
     * dividing into fields: 000000000000000000 00 100 0 11 0 1 0000
5301
     * nStopbits = 00 = 1
5302
     * parity = 100 = none
5303
     * charLen = 11 = 8-bit
5304
     * reserved1 = 1
5305
     *
5306
     * The protocol reference further gives the following subfield values:
5307
     * 01 = 1.5 stop bits (?)
5308
     * 10 = 2 stopbits
5309
     * 000 = even parity
5310
     * 001 = odd parity
5311
     * 10x = no parity
5312
     * 10 = 7 bits
5313
     *
5314
     * Some UBX reference code amplifies this with:
5315
     *
5316
     *   prtcfg.mode = (1<<4) | // compatibility with ANTARIS 4
5317
     *                 (1<<7) | // charLen = 11 = 8 bit
5318
     *                 (1<<6) | // charLen = 11 = 8 bit
5319
     *                 (1<<11); // parity = 10x = none
5320
     */
5321
0
    usart_mode |= (1<<4);       // reserved1 Antaris 4 compatibility bit
5322
0
    usart_mode |= (1<<7);       // high bit of charLen
5323
5324
    // u-blox 5+ binary only supports 8N1
5325
0
    switch (parity) {
5326
0
    case (int)'E':
5327
0
    case 2:
5328
0
        usart_mode |= (1<<7);           // 7E
5329
0
        break;
5330
0
    case (int)'O':
5331
0
    case 1:
5332
0
        usart_mode |= (1<<9) | (1<<7);  // 7O
5333
0
        break;
5334
0
    case (int)'N':
5335
0
    case 0:
5336
0
    default:
5337
0
        usart_mode |= (1<<11) | (3<<6); // 8N
5338
0
        break;
5339
0
    }
5340
5341
0
    if (2 == stopbits) {
5342
0
        usart_mode |= (1<<13);
5343
0
    }
5344
5345
0
    putle32(buf, 4, usart_mode);
5346
5347
    // enable all input protocols by default
5348
    // RTCM3 is protver 20+
5349
0
    buf[12] = NMEA_PROTOCOL_MASK | UBX_PROTOCOL_MASK | RTCM_PROTOCOL_MASK |
5350
0
              RTCM3_PROTOCOL_MASK;
5351
5352
    /* enable all input protocols by default
5353
     * no u-blox has RTCM2 out
5354
     * RTCM3 is protver 20+ */
5355
0
    buf[outProtoMask] = NMEA_PROTOCOL_MASK | UBX_PROTOCOL_MASK |
5356
0
                        RTCM3_PROTOCOL_MASK;
5357
    // FIXME: use VALGET if protver  24+
5358
0
    (void)ubx_write(session, UBX_CLASS_CFG, 0x00, buf, sizeof(buf));
5359
5360
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
5361
0
             "UBX ubx_cfg_prt mode %d port %d PROTVER %d\n", mode, buf[0],
5362
0
             session->driver.ubx.protver);
5363
5364
    // selectively enable output protocols
5365
0
    if (mode == MODE_NMEA) {
5366
        /*
5367
         * We have to club the GR601-W over the head to make it stop emitting
5368
         * UBX after we've told it to start.  But do not mung the
5369
         * protocol out mask, that breaks things.
5370
         */
5371
5372
0
        unsigned char msg[3];
5373
        /* nmea to turn on at rate one (multiplier on measurement rate)
5374
         * u-blox 8 default: RMC, VTG, GGA, GSA GSV, GLL
5375
         * who wanted GST? */
5376
0
        const unsigned char nmea_on[] = {
5377
0
            0x00,          // msg id  = GGA
5378
            // 0x01,          // msg id  = GLL, only need RMC
5379
0
            0x02,          // msg id  = GSA
5380
0
            0x03,          // msg id  = GSV
5381
0
            0x04,          // msg id  = RMC
5382
0
            0x05,          // msg id  = VTG
5383
0
            0x07,          // msg id  = GST, GNSS pseudorange error statistics
5384
0
            0x08,          // msg id  = ZDA, for UTC year
5385
0
            0x09,          // msg id  = GBS, for RAIM errors
5386
0
        };
5387
5388
0
        const unsigned char ubx_nav_off[] = {
5389
0
            0x01,          // msg id = NAV-POSECEF
5390
0
            0x04,          // msg id = UBX-NAV-DOP
5391
0
            0x06,          // msg id = NAV-SOL, deprecated in 6, gone in 9
5392
0
            0x07,          // msg id = NAV-PVT, in u-blox 6 and on
5393
0
            0x11,          // msg id = NAV-VELECEF
5394
0
            0x20,          // msg id = UBX-NAV-TIMEGPS
5395
            // 0x26;       // msg id  = UBX-NAV-TIMELS, allow as low rate
5396
0
            0x30,          // msg id = NAV-SVINFO, in 4 to 8, not 9
5397
0
            0x32,          // msg id = NAV-SBAS, in u-blox 4 to 8, not all 9
5398
0
            0x35,          // msg id = NAV-SAT, in u-blox 8 and up
5399
0
            0x43,          // msg id = NAV-SIG, in u-blox 9 and up
5400
0
            0x61,          // msg id = NAV-EOE
5401
0
        };
5402
5403
        // turn off init queue
5404
0
        session->queue = 0;
5405
5406
        // enable NMEA first, in case we over-run receiver input buffer.
5407
5408
        // turn on rate one NMEA
5409
0
        msg[0] = 0xf0;          // class, NMEA
5410
0
        msg[2] = 0x01;          // rate, one
5411
0
        for (i = 0; i < sizeof(nmea_on); i++) {
5412
0
            msg[1] = nmea_on[i];          // msg id to turn on
5413
0
            (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5414
0
        }
5415
5416
        // Now turn off UBX-NAV, one at a time.
5417
0
        msg[0] = 0x01;          // class, UBX-NAV
5418
0
        msg[2] = 0x00;          // rate off
5419
0
        for (i = 0; i < sizeof(ubx_nav_off); i++) {
5420
0
            msg[1] = ubx_nav_off[i];          // msg id to turn on
5421
0
            (void)ubx_write(session, UBX_CLASS_CFG, 0x01, msg, 3);
5422
0
        }
5423
5424
0
    } else {    // MODE_BINARY
5425
5426
        /*
5427
         * Just enabling the UBX protocol for output is not enough to
5428
         * actually get UBX output; the sentence mix is initially empty.
5429
         * Fix that...
5430
         */
5431
5432
        /* Beware sending too many messages without waiting
5433
         * for u-blox ACK, over running its input buffer.
5434
         *
5435
         * For example, the UBX-MON-VER may fail here, but works in other
5436
         * contexts.
5437
         *
5438
         * Need UBX-MON-VER for protver.  Need protver to properly configure
5439
         * the message set.
5440
         */
5441
0
        unsigned char msg[3] = {0, 0, 0};
5442
        // request SW and HW Versions, prolly already requested at detection
5443
        // ask again as older u-blox are hard of hearing
5444
0
        (void)ubx_write(session, UBX_CLASS_MON, 0x04, msg, 0);
5445
5446
0
        GPSD_LOG(LOG_IO, &session->context->errout, "UBX: init protVer %u\n",
5447
0
                 session->driver.ubx.protver);
5448
5449
        // turn on init queue
5450
0
        session->queue = 1;
5451
0
    }
5452
0
    return 0;
5453
0
}
5454
5455
static void ubx_mode(struct gps_device_t *session, int mode)
5456
0
{
5457
0
    ubx_cfg_prt(session,
5458
0
                gpsd_get_speed(session),
5459
0
                gpsd_get_parity(session),
5460
0
                gpsd_get_stopbits(session),
5461
0
                mode);
5462
0
}
5463
5464
static bool ubx_speed(struct gps_device_t *session,
5465
                      speed_t speed, char parity, int stopbits)
5466
0
{
5467
0
    ubx_cfg_prt(session,
5468
0
                speed,
5469
0
                parity,
5470
0
                stopbits,
5471
0
                (session->lexer.type == UBX_PACKET) ? MODE_BINARY : MODE_NMEA);
5472
0
    return true;
5473
0
}
5474
5475
/* change the sample rate of the GPS */
5476
static bool ubx_rate(struct gps_device_t *session, double cycletime)
5477
0
{
5478
    /* Minimum measurement cycle time currently known from documentation
5479
     * for fastest devices, here in milli seconds. Maintained in
5480
     * struct gps_type_t driver_ubx.
5481
     */
5482
0
    const int64_t min_cycle = TSTOMS(&session->device_type->min_cycle);
5483
    // cycletime in milli seconds
5484
0
    int64_t measRate = (int64_t)(cycletime * MS_IN_SEC);
5485
    // Message to be sent to device
5486
0
    unsigned char msg[6] = {
5487
0
        0x00, 0x00,     // U2: Measurement rate (ms), will be set below
5488
0
        0x01, 0x00,     // U2: Navigation rate (cycles), set to 1
5489
0
        0x00, 0x00,     // U2: Alignment to reference time: 0 = UTC
5490
0
    };
5491
5492
    // check max
5493
0
    if (65535 < measRate) {
5494
0
        measRate = 65535;   // milli seconds
5495
0
    } else if (min_cycle > measRate) {
5496
        /* Clamp cycle time to lowest bound given in documentation.
5497
         * protVer >= 24 has 25 ms min.
5498
         * protVer < 24 has min of 50ms or more.
5499
         */
5500
0
        measRate = min_cycle;
5501
0
    }
5502
    // we now know measRate fits in a U2
5503
5504
0
    GPSD_LOG(LOG_PROG, &session->context->errout,
5505
0
             "UBX rate change, measRate %lld millisecs\n",
5506
0
             (long long) measRate);
5507
0
    msg[0] = (unsigned char)(measRate & 0xff);
5508
0
    msg[1] = (unsigned char)(measRate >> 8);
5509
5510
    // UBX-CFG-RATE deprecated in u-blox 10
5511
0
    return ubx_write(session, UBX_CLASS_CFG, 0x08, msg, 6); // CFG-RATE
5512
0
}
5513
5514
// This is everything we export
5515
// *INDENT-OFF*
5516
const struct gps_type_t driver_ubx = {
5517
    .type_name         = "u-blox",       // Full name of type
5518
    .packet_type       = UBX_PACKET,     // associated lexer packet type
5519
    .flags             = DRIVER_STICKY,  // remember this
5520
    .trigger           = NULL,
5521
    // Number of satellite channels supported by the device
5522
    // ZED-F0T supports 60, ZED-F0P supports 184
5523
    .channels          = 184,
5524
    .probe_detect      = NULL,           // Startup-time device detector
5525
    // Packet getter (using default routine)
5526
    .get_packet        = packet_get1,
5527
    .parse_packet      = parse_input,    // Parse message packets
5528
    // RTCM handler (using default routine)
5529
    .rtcm_writer       = gpsd_write,
5530
    .init_query        = ubx_init_query, // non-perturbing initial query
5531
    .event_hook        = ubx_event_hook, // Fire on various lifetime events
5532
    .speed_switcher    = ubx_speed,      // Speed (baudrate) switch
5533
    .mode_switcher     = ubx_mode,       // Mode switcher
5534
    .rate_switcher     = ubx_rate,       // Message delivery rate switcher
5535
    /* Minimum measurement cycle time currently known from documentation
5536
     * for fastest devices.
5537
     */
5538
    .min_cycle.tv_sec  = 0,
5539
    .min_cycle.tv_nsec = 25000000,          // Maximum 40Hz sample rate
5540
    .control_send      = ubx_control_send,  // how to send a control string
5541
    .time_offset       = NULL,              // no method for NTP fudge factor
5542
};
5543
// *INDENT-ON*
5544
5545
// vim: set expandtab shiftwidth=4