simulator.h

Go to the documentation of this file.

/****************************************************************************
 *
 *   Copyright (c) 2015 Mark Charlebois. All rights reserved.
 *   Copyright (c) 2018 PX4 Development Team. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 * 3. Neither the name PX4 nor the names of its contributors may be
 *    used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 ****************************************************************************/


#pragma once

#include <px4_posix.h>
#include <px4_module_params.h>
#include <uORB/topics/manual_control_setpoint.h>
#include <uORB/topics/actuator_outputs.h>
#include <uORB/topics/vehicle_attitude.h>
#include <uORB/topics/vehicle_local_position.h>
#include <uORB/topics/vehicle_global_position.h>
#include <uORB/topics/vehicle_odometry.h>
#include <uORB/topics/vehicle_status.h>
#include <uORB/topics/battery_status.h>
#include <uORB/topics/irlock_report.h>
#include <uORB/topics/parameter_update.h>
#include <drivers/drv_accel.h>
#include <drivers/drv_gyro.h>
#include <drivers/drv_baro.h>
#include <drivers/drv_mag.h>
#include <drivers/drv_hrt.h>
#include <drivers/drv_rc_input.h>
#include <perf/perf_counter.h>
#include <battery/battery.h>
#include <uORB/uORB.h>
#include <uORB/topics/optical_flow.h>
#include <uORB/topics/distance_sensor.h>
#include <v2.0/mavlink_types.h>
#include <v2.0/common/mavlink.h>
#include <lib/ecl/geo/geo.h>

namespace simulator
{

#pragma pack(push, 1)
struct RawAccelData {
    float temperature;
    float x;
    float y;
    float z;
};
#pragma pack(pop)

#pragma pack(push, 1)
struct RawMagData {
    float temperature;
    float x;
    float y;
    float z;
};
#pragma pack(pop)

#pragma pack(push, 1)
struct RawMPUData {
    float   accel_x;
    float   accel_y;
    float   accel_z;
    float   temp;
    float   gyro_x;
    float   gyro_y;
    float   gyro_z;
};
#pragma pack(pop)

#pragma pack(push, 1)
struct RawBaroData {
    float pressure;
    float temperature;
};
#pragma pack(pop)

#pragma pack(push, 1)
struct RawAirspeedData {
    float temperature;
    float diff_pressure;
};
#pragma pack(pop)

#pragma pack(push, 1)
struct RawGPSData {
    uint64_t timestamp;
    int32_t lat;
    int32_t lon;
    int32_t alt;
    uint16_t eph;
    uint16_t epv;
    uint16_t vel;
    int16_t vn;
    int16_t ve;
    int16_t vd;
    uint16_t cog;
    uint8_t fix_type;
    uint8_t satellites_visible;
};
#pragma pack(pop)

template <typename RType> class Report
{
public:
    Report(int readers) :
        _readidx(0),
        _max_readers(readers),
        _report_len(sizeof(RType))
    {
        memset(_buf, 0, sizeof(_buf));
        px4_sem_init(&_lock, 0, _max_readers);
    }

    ~Report() {}

    bool copyData(void *outbuf, int len)
    {
        if (len != _report_len) {
            return false;
        }

        read_lock();
        memcpy(outbuf, &_buf[_readidx], _report_len);
        read_unlock();
        return true;
    }
    void writeData(void *inbuf)
    {
        write_lock();
        memcpy(&_buf[!_readidx], inbuf, _report_len);
        _readidx = !_readidx;
        write_unlock();
    }

protected:
    void read_lock() { px4_sem_wait(&_lock); }
    void read_unlock() { px4_sem_post(&_lock); }
    void write_lock()
    {
        for (int i = 0; i < _max_readers; i++) {
            px4_sem_wait(&_lock);
        }
    }
    void write_unlock()
    {
        for (int i = 0; i < _max_readers; i++) {
            px4_sem_post(&_lock);
        }
    }

    int _readidx;
    px4_sem_t _lock;
    const int _max_readers;
    const int _report_len;
    RType _buf[2];
};

} // namespace simulator


class Simulator : public ModuleParams
{
public:
    static Simulator *getInstance();

    enum sim_dev_t {
        SIM_GYRO,
        SIM_ACCEL,
        SIM_MAG
    };

    struct sample {
        float x;
        float y;
        float z;
        sample() : x(0), y(0), z(0) {}
        sample(float a, float b, float c) : x(a), y(b), z(c) {}
    };

    enum class InternetProtocol {
        TCP,
        UDP
    };

    static int start(int argc, char *argv[]);

    bool getAirspeedSample(uint8_t *buf, int len);
    bool getBaroSample(uint8_t *buf, int len);
    bool getGPSSample(uint8_t *buf, int len);
    bool getMagReport(uint8_t *buf, int len);
    bool getMPUReport(uint8_t *buf, int len);
    bool getRawAccelReport(uint8_t *buf, int len);

    void write_airspeed_data(void *buf);
    void write_accel_data(void *buf);
    void write_baro_data(void *buf);
    void write_gps_data(void *buf);
    void write_mag_data(void *buf);
    void write_MPU_data(void *buf);

    bool isInitialized() { return _initialized; }

    void set_ip(InternetProtocol ip);
    void set_port(unsigned port);

private:
    Simulator() :
        ModuleParams(nullptr)
    {
        simulator::RawGPSData gps_data{};
        gps_data.eph = UINT16_MAX;
        gps_data.epv = UINT16_MAX;

        _gps.writeData(&gps_data);

        _param_sub = orb_subscribe(ORB_ID(parameter_update));

        _battery_status.timestamp = hrt_absolute_time();
    }

    ~Simulator()
    {
        // Unsubscribe from uORB topics.
        orb_unsubscribe(_param_sub);

        // free perf counters
        perf_free(_perf_accel);
        perf_free(_perf_airspeed);
        perf_free(_perf_baro);
        perf_free(_perf_gps);
        perf_free(_perf_mag);
        perf_free(_perf_mpu);
        perf_free(_perf_sim_delay);
        perf_free(_perf_sim_interval);

        _instance = NULL;
    }

    // class methods
    void initialize_sensor_data();

    int publish_sensor_topics(const mavlink_hil_sensor_t *imu);
    int publish_flow_topic(const mavlink_hil_optical_flow_t *flow);
    int publish_odometry_topic(const mavlink_message_t *odom_mavlink);
    int publish_distance_topic(const mavlink_distance_sensor_t *dist);

    static Simulator *_instance;

    // simulated sensor instances
    simulator::Report<simulator::RawAirspeedData>   _airspeed{1};
    simulator::Report<simulator::RawAccelData>  _accel{1};
    simulator::Report<simulator::RawBaroData>   _baro{1};
    simulator::Report<simulator::RawGPSData>    _gps{1};
    simulator::Report<simulator::RawMagData>    _mag{1};
    simulator::Report<simulator::RawMPUData>    _mpu{1};

    perf_counter_t _perf_accel{perf_alloc_once(PC_ELAPSED, "sim_accel_delay")};
    perf_counter_t _perf_airspeed{perf_alloc_once(PC_ELAPSED, "sim_airspeed_delay")};
    perf_counter_t _perf_baro{perf_alloc_once(PC_ELAPSED, "sim_baro_delay")};
    perf_counter_t _perf_gps{perf_alloc_once(PC_ELAPSED, "sim_gps_delay")};
    perf_counter_t _perf_mag{perf_alloc_once(PC_ELAPSED, "sim_mag_delay")};
    perf_counter_t _perf_mpu{perf_alloc_once(PC_ELAPSED, "sim_mpu_delay")};
    perf_counter_t _perf_sim_delay{perf_alloc_once(PC_ELAPSED, "sim_network_delay")};
    perf_counter_t _perf_sim_interval{perf_alloc(PC_INTERVAL, "sim_network_interval")};

    // uORB publisher handlers
    orb_advert_t _accel_pub{nullptr};
    orb_advert_t _baro_pub{nullptr};
    orb_advert_t _battery_pub{nullptr};
    orb_advert_t _dist_pub{nullptr};
    orb_advert_t _flow_pub{nullptr};
    orb_advert_t _gyro_pub{nullptr};
    orb_advert_t _irlock_report_pub{nullptr};
    orb_advert_t _mag_pub{nullptr};
    orb_advert_t _visual_odometry_pub{nullptr};

    int _param_sub{-1};

    unsigned int _port{14560};

    InternetProtocol _ip{InternetProtocol::UDP};

    bool _initialized{false};

    double _realtime_factor{1.0};       

    hrt_abstime _last_sim_timestamp{0};
    hrt_abstime _last_sitl_timestamp{0};

    // Lib used to do the battery calculations.
    Battery _battery {};
    battery_status_s _battery_status{};

#ifndef __PX4_QURT

    mavlink_hil_actuator_controls_t actuator_controls_from_outputs(const actuator_outputs_s &actuators);

    void handle_message(const mavlink_message_t *msg);
    void handle_message_distance_sensor(const mavlink_message_t *msg);
    void handle_message_hil_gps(const mavlink_message_t *msg);
    void handle_message_hil_sensor(const mavlink_message_t *msg);
    void handle_message_hil_state_quaternion(const mavlink_message_t *msg);
    void handle_message_landing_target(const mavlink_message_t *msg);
    void handle_message_odometry(const mavlink_message_t *msg);
    void handle_message_optical_flow(const mavlink_message_t *msg);
    void handle_message_rc_channels(const mavlink_message_t *msg);
    void handle_message_vision_position_estimate(const mavlink_message_t *msg);

    void parameters_update(bool force);
    void poll_topics();
    void poll_for_MAVLink_messages();
    void request_hil_state_quaternion();
    void send();
    void send_controls();
    void send_heartbeat();
    void send_mavlink_message(const mavlink_message_t &aMsg);
    void set_publish(const bool publish = true);
    void update_sensors(const mavlink_hil_sensor_t *imu);
    void update_gps(const mavlink_hil_gps_t *gps_sim);

    static void *sending_trampoline(void *);

    // uORB publisher handlers
    orb_advert_t _attitude_pub{nullptr};
    orb_advert_t _gpos_pub{nullptr};
    orb_advert_t _lpos_pub{nullptr};
    orb_advert_t _rc_channels_pub{nullptr};

    // uORB subscription handlers
    int _actuator_outputs_sub{-1};
    int _vehicle_status_sub{-1};

    // hil map_ref data
    struct map_projection_reference_s _hil_local_proj_ref {};

    bool _hil_local_proj_inited{false};
    bool _publish{false};

    double _hil_ref_lat{0};
    double _hil_ref_lon{0};
    float _hil_ref_alt{0.0f};
    uint64_t _hil_ref_timestamp{0};

    // uORB data containers
    input_rc_s _rc_input {};
    manual_control_setpoint_s _manual {};
    vehicle_attitude_s _attitude {};
    vehicle_status_s _vehicle_status {};

    DEFINE_PARAMETERS(
        (ParamFloat<px4::params::SIM_BAT_DRAIN>) _param_sim_bat_drain, 
        (ParamInt<px4::params::MAV_TYPE>) _param_mav_type,
        (ParamInt<px4::params::MAV_SYS_ID>) _param_mav_sys_id,
        (ParamInt<px4::params::MAV_COMP_ID>) _param_mav_comp_id
    )

#endif
};