/*
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
*/
/*
simulate GPS sensors
Usage example:
param set SERIAL5_PROTOCOL 5
sim_vehicle.py -D --console --map -A --serial5=sim:gps:2
*/
#pragma once
#include "SIM_config.h"
#if HAL_SIM_GPS_ENABLED
#include
#include "SIM_SerialDevice.h"
namespace SITL {
// for delay simulation:
struct GPS_Data {
uint32_t timestamp_ms;
double latitude;
double longitude;
float altitude;
double speedN;
double speedE;
double speedD;
double yaw_deg;
double roll_deg;
double pitch_deg;
bool have_lock;
float horizontal_acc;
float vertical_acc;
float speed_acc;
uint8_t num_sats;
// Get course over ground [rad], where 0 = North in WGS-84 coordinate system.
// Calculated from 2D velocity.
float ground_track_rad() const WARN_IF_UNUSED;
// Get 2D speed [m/s] in WGS-84 coordinate system
float speed_2d() const WARN_IF_UNUSED;
};
class GPS_Backend {
public:
CLASS_NO_COPY(GPS_Backend);
GPS_Backend(class GPS &front, uint8_t _instance);
virtual ~GPS_Backend() {}
// 0 baud means "unset" i.e. baud-rate checks should not apply
virtual uint32_t device_baud() const { return 0; }
ssize_t write_to_autopilot(const char *p, size_t size) const;
ssize_t read_from_autopilot(char *buffer, size_t size) const;
// read and process config from autopilot (e.g.)
virtual void update_read();
// writing fix information to autopilot (e.g.)
virtual void publish(const GPS_Data *d) = 0;
struct GPS_TOW {
// Number of weeks since midnight 5-6 January 1980
uint16_t week;
// Time since start of the GPS week [mS]
uint32_t ms;
};
static GPS_TOW gps_time();
protected:
uint8_t instance;
GPS &front;
class SIM *_sitl;
static void simulation_timeval(struct timeval *tv);
};
class GPS : public SerialDevice {
public:
CLASS_NO_COPY(GPS);
enum Type {
NONE = 0,
#if AP_SIM_GPS_UBLOX_ENABLED
UBLOX = 1,
#endif
#if AP_SIM_GPS_NMEA_ENABLED
NMEA = 5,
#endif
#if AP_SIM_GPS_SBP_ENABLED
SBP = 6,
#endif
#if AP_SIM_GPS_FILE_ENABLED
FILE = 7,
#endif
#if AP_SIM_GPS_NOVA_ENABLED
NOVA = 8,
#endif
#if AP_SIM_GPS_SBP2_ENABLED
SBP2 = 9,
#endif
#if AP_SIM_GPS_SBF_ENABLED
SBF = 10, //matches GPS_TYPE
#endif
#if AP_SIM_GPS_TRIMBLE_ENABLED
TRIMBLE = 11, // matches GPS1_TYPE
#endif
#if AP_SIM_GPS_MSP_ENABLED
MSP = 19,
#endif
};
GPS(uint8_t _instance);
// update state
void update();
ssize_t write_to_autopilot(const char *p, size_t size) const override;
uint32_t device_baud() const override; // 0 meaning unset
private:
uint8_t instance;
// The last time GPS data was written [mS]
uint32_t last_write_update_ms;
// last 20 samples, allowing for up to 20 samples of delay
GPS_Data _gps_history[20];
// state of jamming simulation
struct {
uint32_t last_jam_ms;
uint32_t jam_start_ms;
uint32_t last_sats_change_ms;
uint32_t last_vz_change_ms;
uint32_t last_vel_change_ms;
uint32_t last_pos_change_ms;
uint32_t last_acc_change_ms;
double latitude;
double longitude;
} jamming[2];
bool _gps_has_basestation_position;
GPS_Data _gps_basestation_data;
void simulate_jamming(GPS_Data &d);
// get delayed data
GPS_Data interpolate_data(const GPS_Data &d, uint32_t delay_ms);
uint8_t allocated_type;
GPS_Backend *backend;
void check_backend_allocation();
};
}
#endif // HAL_SIM_GPS_ENABLED