/* APM_AHRS.cpp 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 . */ #include "AP_AHRS.h" #include "AP_AHRS_View.h" #include #include #include #include #include #include #include extern const AP_HAL::HAL& hal; void AP_AHRS_Backend::init() { } // return a smoothed and corrected gyro vector using the latest ins data (which may not have been consumed by the EKF yet) Vector3f AP_AHRS::get_gyro_latest(void) const { const uint8_t primary_gyro = get_primary_gyro_index(); return AP::ins().get_gyro(primary_gyro) + get_gyro_drift(); } // set_trim void AP_AHRS::set_trim(const Vector3f &new_trim) { const Vector3f trim { constrain_float(new_trim.x, ToRad(-AP_AHRS_TRIM_LIMIT), ToRad(AP_AHRS_TRIM_LIMIT)), constrain_float(new_trim.y, ToRad(-AP_AHRS_TRIM_LIMIT), ToRad(AP_AHRS_TRIM_LIMIT)), constrain_float(new_trim.z, ToRad(-AP_AHRS_TRIM_LIMIT), ToRad(AP_AHRS_TRIM_LIMIT)) }; _trim.set_and_save(trim); } // add_trim - adjust the roll and pitch trim up to a total of 10 degrees void AP_AHRS::add_trim(float roll_in_radians, float pitch_in_radians, bool save_to_eeprom) { Vector3f trim = _trim.get(); // add new trim trim.x = constrain_float(trim.x + roll_in_radians, ToRad(-AP_AHRS_TRIM_LIMIT), ToRad(AP_AHRS_TRIM_LIMIT)); trim.y = constrain_float(trim.y + pitch_in_radians, ToRad(-AP_AHRS_TRIM_LIMIT), ToRad(AP_AHRS_TRIM_LIMIT)); // set new trim values _trim.set(trim); // save to eeprom if( save_to_eeprom ) { _trim.save(); } } // Set the board mounting orientation from AHRS_ORIENTATION parameter void AP_AHRS::update_orientation() { const uint32_t now_ms = AP_HAL::millis(); if (now_ms - last_orientation_update_ms < 1000) { // only update once/second return; } // never update while armed - unless we've never updated // (e.g. mid-air reboot or ARMING_REQUIRED=NO on Plane): if (hal.util->get_soft_armed() && last_orientation_update_ms != 0) { return; } last_orientation_update_ms = now_ms; const enum Rotation orientation = (enum Rotation)_board_orientation.get(); AP::ins().set_board_orientation(orientation); AP::compass().set_board_orientation(orientation); } /* calculate sin and cos of roll/pitch/yaw from a body_to_ned rotation matrix */ void AP_AHRS::calc_trig(const Matrix3f &rot, float &cr, float &cp, float &cy, float &sr, float &sp, float &sy) const { Vector2f yaw_vector(rot.a.x, rot.b.x); if (fabsf(yaw_vector.x) > 0 || fabsf(yaw_vector.y) > 0) { yaw_vector.normalize(); } sy = constrain_float(yaw_vector.y, -1.0f, 1.0f); cy = constrain_float(yaw_vector.x, -1.0f, 1.0f); // sanity checks if (yaw_vector.is_inf() || yaw_vector.is_nan()) { sy = 0.0f; cy = 1.0f; } const float cx2 = rot.c.x * rot.c.x; if (cx2 >= 1.0f) { cp = 0; cr = 1.0f; } else { cp = safe_sqrt(1 - cx2); cr = rot.c.z / cp; } cp = constrain_float(cp, 0.0f, 1.0f); cr = constrain_float(cr, -1.0f, 1.0f); // this relies on constrain_float() of infinity doing the right thing sp = -rot.c.x; if (!is_zero(cp)) { sr = rot.c.y / cp; } if (is_zero(cp) || isinf(cr) || isnan(cr) || isinf(sr) || isnan(sr)) { float r, p, y; rot.to_euler(&r, &p, &y); cr = cosf(r); sr = sinf(r); } } // update_trig - recalculates _cos_roll, _cos_pitch, etc based on latest attitude // should be called after _dcm_matrix is updated void AP_AHRS::update_trig(void) { calc_trig(get_rotation_body_to_ned(), _cos_roll, _cos_pitch, _cos_yaw, _sin_roll, _sin_pitch, _sin_yaw); } /* update the centi-degree values */ void AP_AHRS::update_cd_values(void) { roll_sensor = degrees(roll) * 100; pitch_sensor = degrees(pitch) * 100; yaw_sensor = degrees(yaw) * 100; if (yaw_sensor < 0) yaw_sensor += 36000; } /* create a rotated view of AP_AHRS with optional pitch trim */ AP_AHRS_View *AP_AHRS::create_view(enum Rotation rotation, float pitch_trim_deg) { if (_view != nullptr) { // can only have one return nullptr; } _view = new AP_AHRS_View(*this, rotation, pitch_trim_deg); return _view; } /* * Update AOA and SSA estimation based on airspeed, velocity vector and wind vector * * Based on: * "On estimation of wind velocity, angle-of-attack and sideslip angle of small UAVs using standard sensors" by * Tor A. Johansen, Andrea Cristofaro, Kim Sorensen, Jakob M. Hansen, Thor I. Fossen * * "Multi-Stage Fusion Algorithm for Estimation of Aerodynamic Angles in Mini Aerial Vehicle" by * C.Ramprasadh and Hemendra Arya * * "ANGLE OF ATTACK AND SIDESLIP ESTIMATION USING AN INERTIAL REFERENCE PLATFORM" by * JOSEPH E. ZEIS, JR., CAPTAIN, USAF */ void AP_AHRS::update_AOA_SSA(void) { #if APM_BUILD_TYPE(APM_BUILD_ArduPlane) const uint32_t now = AP_HAL::millis(); if (now - _last_AOA_update_ms < 50) { // don't update at more than 20Hz return; } _last_AOA_update_ms = now; Vector3f aoa_velocity, aoa_wind; // get velocity and wind if (get_velocity_NED(aoa_velocity) == false) { return; } aoa_wind = wind_estimate(); // Rotate vectors to the body frame and calculate velocity and wind const Matrix3f &rot = get_rotation_body_to_ned(); aoa_velocity = rot.mul_transpose(aoa_velocity); aoa_wind = rot.mul_transpose(aoa_wind); // calculate relative velocity in body coordinates aoa_velocity = aoa_velocity - aoa_wind; const float vel_len = aoa_velocity.length(); // do not calculate if speed is too low if (vel_len < 2.0) { _AOA = 0; _SSA = 0; return; } // Calculate AOA and SSA if (aoa_velocity.x > 0) { _AOA = degrees(atanf(aoa_velocity.z / aoa_velocity.x)); } else { _AOA = 0; } _SSA = degrees(safe_asin(aoa_velocity.y / vel_len)); #endif } // rotate a 2D vector from earth frame to body frame Vector2f AP_AHRS::earth_to_body2D(const Vector2f &ef) const { return Vector2f(ef.x * _cos_yaw + ef.y * _sin_yaw, -ef.x * _sin_yaw + ef.y * _cos_yaw); } // rotate a 2D vector from earth frame to body frame Vector2f AP_AHRS::body_to_earth2D(const Vector2f &bf) const { return Vector2f(bf.x * _cos_yaw - bf.y * _sin_yaw, bf.x * _sin_yaw + bf.y * _cos_yaw); } #if HAL_LOGGING_ENABLED // log ahrs home and EKF origin void AP_AHRS::Log_Write_Home_And_Origin() { AP_Logger *logger = AP_Logger::get_singleton(); if (logger == nullptr) { return; } Location ekf_orig; if (get_origin(ekf_orig)) { Write_Origin(LogOriginType::ekf_origin, ekf_orig); } if (_home_is_set) { Write_Origin(LogOriginType::ahrs_home, _home); } } #endif // get apparent to true airspeed ratio float AP_AHRS_Backend::get_EAS2TAS(void) { return AP::baro()._get_EAS2TAS(); } // return current vibration vector for primary IMU Vector3f AP_AHRS::get_vibration(void) const { return AP::ins().get_vibration_levels(); } void AP_AHRS::set_takeoff_expected(bool b) { takeoff_expected = b; takeoff_expected_start_ms = AP_HAL::millis(); } void AP_AHRS::set_touchdown_expected(bool b) { touchdown_expected = b; touchdown_expected_start_ms = AP_HAL::millis(); } /* update takeoff/touchdown flags */ void AP_AHRS::update_flags(void) { const uint32_t timeout_ms = 1000; if (takeoff_expected && AP_HAL::millis() - takeoff_expected_start_ms > timeout_ms) { takeoff_expected = false; } if (touchdown_expected && AP_HAL::millis() - touchdown_expected_start_ms > timeout_ms) { touchdown_expected = false; } }