2010-09-06 17:16:50 -03:00
|
|
|
// -*- tab-width: 4; Mode: C++; c-basic-offset: 4; indent-tabs-mode: t -*-
|
2010-09-06 19:31:18 -03:00
|
|
|
//
|
|
|
|
// u-blox UBX GPS driver for ArduPilot and ArduPilotMega.
|
|
|
|
// Code by Michael Smith, Jordi Munoz and Jose Julio, DIYDrones.com
|
|
|
|
//
|
|
|
|
// This library is free software; you can redistribute it and / or
|
|
|
|
// modify it under the terms of the GNU Lesser General Public
|
|
|
|
// License as published by the Free Software Foundation; either
|
|
|
|
// version 2.1 of the License, or (at your option) any later version.
|
|
|
|
//
|
2010-09-06 17:16:50 -03:00
|
|
|
#ifndef AP_GPS_UBLOX_h
|
|
|
|
#define AP_GPS_UBLOX_h
|
|
|
|
|
2011-04-30 23:05:17 -03:00
|
|
|
#include "GPS.h"
|
2010-09-06 17:16:50 -03:00
|
|
|
|
2010-10-17 03:06:04 -03:00
|
|
|
#define UBLOX_SET_BINARY "$PUBX,41,1,0003,0001,38400,0*26"
|
|
|
|
|
2010-09-06 17:16:50 -03:00
|
|
|
class AP_GPS_UBLOX : public GPS
|
|
|
|
{
|
2010-09-06 19:31:18 -03:00
|
|
|
public:
|
2010-09-06 17:16:50 -03:00
|
|
|
// Methods
|
2011-10-28 15:52:50 -03:00
|
|
|
AP_GPS_UBLOX(Stream *s);
|
2012-06-10 03:34:13 -03:00
|
|
|
virtual void init(enum GPS_Engine_Setting nav_setting = GPS_ENGINE_NONE);
|
2011-10-28 15:52:50 -03:00
|
|
|
virtual bool read();
|
2010-09-06 19:31:18 -03:00
|
|
|
|
|
|
|
private:
|
2011-10-28 15:52:50 -03:00
|
|
|
// u-blox UBX protocol essentials
|
2011-05-04 16:12:27 -03:00
|
|
|
// XXX this is being ignored by the compiler #pragma pack(1)
|
2012-06-10 03:34:13 -03:00
|
|
|
struct ubx_header {
|
|
|
|
uint8_t preamble1;
|
|
|
|
uint8_t preamble2;
|
|
|
|
uint8_t msg_class;
|
|
|
|
uint8_t msg_id;
|
|
|
|
uint16_t length;
|
|
|
|
};
|
|
|
|
struct ubx_cfg_nav_rate {
|
|
|
|
uint16_t measure_rate_ms;
|
|
|
|
uint16_t nav_rate;
|
|
|
|
uint16_t timeref;
|
|
|
|
};
|
|
|
|
struct ubx_cfg_msg_rate {
|
|
|
|
uint8_t msg_class;
|
|
|
|
uint8_t msg_id;
|
|
|
|
uint8_t rate;
|
|
|
|
};
|
|
|
|
struct ubx_cfg_nav_settings {
|
|
|
|
uint16_t mask;
|
|
|
|
uint8_t dynModel;
|
|
|
|
uint8_t fixMode;
|
|
|
|
int32_t fixedAlt;
|
|
|
|
uint32_t fixedAltVar;
|
|
|
|
int8_t minElev;
|
|
|
|
uint8_t drLimit;
|
|
|
|
uint16_t pDop;
|
|
|
|
uint16_t tDop;
|
|
|
|
uint16_t pAcc;
|
|
|
|
uint16_t tAcc;
|
|
|
|
uint8_t staticHoldThresh;
|
|
|
|
uint8_t res1;
|
|
|
|
uint32_t res2;
|
|
|
|
uint32_t res3;
|
|
|
|
uint32_t res4;
|
|
|
|
};
|
|
|
|
|
2011-10-28 15:52:50 -03:00
|
|
|
struct ubx_nav_posllh {
|
|
|
|
uint32_t time; // GPS msToW
|
|
|
|
int32_t longitude;
|
|
|
|
int32_t latitude;
|
|
|
|
int32_t altitude_ellipsoid;
|
|
|
|
int32_t altitude_msl;
|
|
|
|
uint32_t horizontal_accuracy;
|
|
|
|
uint32_t vertical_accuracy;
|
|
|
|
};
|
|
|
|
struct ubx_nav_status {
|
|
|
|
uint32_t time; // GPS msToW
|
|
|
|
uint8_t fix_type;
|
|
|
|
uint8_t fix_status;
|
|
|
|
uint8_t differential_status;
|
|
|
|
uint8_t res;
|
|
|
|
uint32_t time_to_first_fix;
|
|
|
|
uint32_t uptime; // milliseconds
|
|
|
|
};
|
|
|
|
struct ubx_nav_solution {
|
|
|
|
uint32_t time;
|
|
|
|
int32_t time_nsec;
|
|
|
|
int16_t week;
|
|
|
|
uint8_t fix_type;
|
|
|
|
uint8_t fix_status;
|
|
|
|
int32_t ecef_x;
|
|
|
|
int32_t ecef_y;
|
|
|
|
int32_t ecef_z;
|
|
|
|
uint32_t position_accuracy_3d;
|
|
|
|
int32_t ecef_x_velocity;
|
|
|
|
int32_t ecef_y_velocity;
|
|
|
|
int32_t ecef_z_velocity;
|
|
|
|
uint32_t speed_accuracy;
|
|
|
|
uint16_t position_DOP;
|
|
|
|
uint8_t res;
|
|
|
|
uint8_t satellites;
|
|
|
|
uint32_t res2;
|
|
|
|
};
|
|
|
|
struct ubx_nav_velned {
|
|
|
|
uint32_t time; // GPS msToW
|
|
|
|
int32_t ned_north;
|
|
|
|
int32_t ned_east;
|
|
|
|
int32_t ned_down;
|
|
|
|
uint32_t speed_3d;
|
|
|
|
uint32_t speed_2d;
|
|
|
|
int32_t heading_2d;
|
|
|
|
uint32_t speed_accuracy;
|
|
|
|
uint32_t heading_accuracy;
|
|
|
|
};
|
2011-05-04 16:12:27 -03:00
|
|
|
// // #pragma pack(pop)
|
2011-10-28 15:52:50 -03:00
|
|
|
enum ubs_protocol_bytes {
|
|
|
|
PREAMBLE1 = 0xb5,
|
|
|
|
PREAMBLE2 = 0x62,
|
2012-06-10 03:34:13 -03:00
|
|
|
CLASS_NAV = 0x01,
|
|
|
|
CLASS_ACK = 0x05,
|
|
|
|
CLASS_CFG = 0x06,
|
|
|
|
MSG_ACK_NACK = 0x00,
|
|
|
|
MSG_ACK_ACK = 0x01,
|
2011-10-28 15:52:50 -03:00
|
|
|
MSG_POSLLH = 0x2,
|
|
|
|
MSG_STATUS = 0x3,
|
|
|
|
MSG_SOL = 0x6,
|
2012-06-10 03:34:13 -03:00
|
|
|
MSG_VELNED = 0x12,
|
|
|
|
MSG_CFG_RATE = 0x08,
|
|
|
|
MSG_CFG_SET_RATE = 0x01,
|
|
|
|
MSG_CFG_NAV_SETTINGS = 0x24
|
2011-10-28 15:52:50 -03:00
|
|
|
};
|
|
|
|
enum ubs_nav_fix_type {
|
|
|
|
FIX_NONE = 0,
|
|
|
|
FIX_DEAD_RECKONING = 1,
|
|
|
|
FIX_2D = 2,
|
|
|
|
FIX_3D = 3,
|
|
|
|
FIX_GPS_DEAD_RECKONING = 4,
|
|
|
|
FIX_TIME = 5
|
|
|
|
};
|
|
|
|
enum ubx_nav_status_bits {
|
|
|
|
NAV_STATUS_FIX_VALID = 1
|
|
|
|
};
|
2010-09-06 19:31:18 -03:00
|
|
|
|
2011-10-28 15:52:50 -03:00
|
|
|
// Packet checksum accumulators
|
|
|
|
uint8_t _ck_a;
|
|
|
|
uint8_t _ck_b;
|
2010-09-06 19:31:18 -03:00
|
|
|
|
2011-10-28 15:52:50 -03:00
|
|
|
// State machine state
|
|
|
|
uint8_t _step;
|
|
|
|
uint8_t _msg_id;
|
|
|
|
uint16_t _payload_length;
|
|
|
|
uint16_t _payload_counter;
|
2010-09-06 19:31:18 -03:00
|
|
|
|
2012-06-10 03:34:13 -03:00
|
|
|
uint8_t _class;
|
|
|
|
|
2012-06-08 03:39:12 -03:00
|
|
|
// do we have new position information?
|
|
|
|
bool _new_position;
|
|
|
|
|
|
|
|
// do we have new speed information?
|
|
|
|
bool _new_speed;
|
|
|
|
|
2012-06-10 03:34:13 -03:00
|
|
|
uint8_t _disable_counter;
|
|
|
|
|
2011-10-28 15:52:50 -03:00
|
|
|
// Receive buffer
|
|
|
|
union {
|
|
|
|
ubx_nav_posllh posllh;
|
|
|
|
ubx_nav_status status;
|
|
|
|
ubx_nav_solution solution;
|
|
|
|
ubx_nav_velned velned;
|
2012-06-10 03:34:13 -03:00
|
|
|
ubx_cfg_nav_settings nav_settings;
|
2011-10-28 15:52:50 -03:00
|
|
|
uint8_t bytes[];
|
|
|
|
} _buffer;
|
2010-09-06 19:31:18 -03:00
|
|
|
|
2011-10-28 15:52:50 -03:00
|
|
|
// Buffer parse & GPS state update
|
|
|
|
bool _parse_gps();
|
2012-06-04 01:47:58 -03:00
|
|
|
|
|
|
|
// used to update fix between status and position packets
|
|
|
|
bool next_fix;
|
2012-06-10 03:34:13 -03:00
|
|
|
|
|
|
|
void _send_pubx(const char *msg);
|
|
|
|
void _configure_message_rate(uint8_t msg_class, uint8_t msg_id, uint8_t rate);
|
|
|
|
void _configure_gps(void);
|
|
|
|
void _update_checksum(uint8_t *data, uint8_t len, uint8_t &ck_a, uint8_t &ck_b);
|
|
|
|
void _send_message(uint8_t msg_class, uint8_t msg_id, void *msg, uint8_t size);
|
|
|
|
|
2010-09-06 17:16:50 -03:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|