/**************************************************************************** * * Copyright (c) 2020 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. * ****************************************************************************/ #include "Gyroscope.hpp" #include "Utilities.hpp" #include using namespace matrix; using namespace time_literals; namespace calibration { Gyroscope::Gyroscope() { Reset(); } Gyroscope::Gyroscope(uint32_t device_id, bool external) { Reset(); set_device_id(device_id, external); } void Gyroscope::set_device_id(uint32_t device_id, bool external) { if (_device_id != device_id || _external != external) { set_external(external); _device_id = device_id; ParametersUpdate(); SensorCorrectionsUpdate(true); } } void Gyroscope::set_external(bool external) { // update priority default appropriately if not set if (_calibration_index < 0 || _priority < 0) { if ((_priority < 0) || (_priority > 100)) { _priority = external ? DEFAULT_EXTERNAL_PRIORITY : DEFAULT_PRIORITY; } else if (!_external && external && (_priority == DEFAULT_PRIORITY)) { // internal -> external _priority = DEFAULT_EXTERNAL_PRIORITY; } else if (_external && !external && (_priority == DEFAULT_EXTERNAL_PRIORITY)) { // external -> internal _priority = DEFAULT_PRIORITY; } } _external = external; } void Gyroscope::SensorCorrectionsUpdate(bool force) { // check if the selected sensor has updated if (_sensor_correction_sub.updated() || force) { // valid device id required if (_device_id == 0) { return; } sensor_correction_s corrections; if (_sensor_correction_sub.copy(&corrections)) { // find sensor_corrections index for (int i = 0; i < MAX_SENSOR_COUNT; i++) { if (corrections.gyro_device_ids[i] == _device_id) { switch (i) { case 0: _thermal_offset = Vector3f{corrections.gyro_offset_0}; return; case 1: _thermal_offset = Vector3f{corrections.gyro_offset_1}; return; case 2: _thermal_offset = Vector3f{corrections.gyro_offset_2}; return; case 3: _thermal_offset = Vector3f{corrections.gyro_offset_3}; return; } } } } // zero thermal offset if not found _thermal_offset.zero(); } } void Gyroscope::set_rotation(Rotation rotation) { _rotation_enum = rotation; _rotation = get_rot_matrix(rotation); } void Gyroscope::ParametersUpdate() { if (_device_id == 0) { Reset(); return; } _calibration_index = FindCalibrationIndex(SensorString(), _device_id); if (_calibration_index >= 0) { // CAL_GYROx_ROT int32_t rotation_value = GetCalibrationParam(SensorString(), "ROT", _calibration_index); if (_external) { if ((rotation_value >= ROTATION_MAX) || (rotation_value < 0)) { PX4_ERR("External %s %d (%d) invalid rotation %d, resetting to rotation none", SensorString(), _device_id, _calibration_index, rotation_value); rotation_value = ROTATION_NONE; SetCalibrationParam(SensorString(), "ROT", _calibration_index, rotation_value); } _rotation_enum = static_cast(rotation_value); _rotation = get_rot_matrix(_rotation_enum); } else { // internal, CAL_GYROx_ROT -1 if (rotation_value != -1) { PX4_ERR("Internal %s %d (%d) invalid rotation %d, resetting", SensorString(), _device_id, _calibration_index, rotation_value); SetCalibrationParam(SensorString(), "ROT", _calibration_index, -1); } _rotation = GetBoardRotation(); _rotation_enum = ROTATION_NONE; } // CAL_GYROx_PRIO _priority = GetCalibrationParam(SensorString(), "PRIO", _calibration_index); if ((_priority < 0) || (_priority > 100)) { // reset to default, -1 is the uninitialized parameter value int32_t new_priority = _external ? DEFAULT_EXTERNAL_PRIORITY : DEFAULT_PRIORITY; if (_priority != -1) { PX4_ERR("%s %d (%d) invalid priority %d, resetting to %d", SensorString(), _device_id, _calibration_index, _priority, new_priority); } SetCalibrationParam(SensorString(), "PRIO", _calibration_index, new_priority); _priority = new_priority; } bool calibration_changed = false; // CAL_GYROx_OFF{X,Y,Z} const Vector3f offset = GetCalibrationParamsVector3f(SensorString(), "OFF", _calibration_index); if (Vector3f(_offset - offset).norm_squared() > 0.001f * 0.001f) { calibration_changed = true; _offset = offset; } if (calibration_changed) { _calibration_count++; } } else { Reset(); } } void Gyroscope::Reset() { _rotation.setIdentity(); _rotation_enum = ROTATION_NONE; _offset.zero(); _thermal_offset.zero(); _priority = _external ? DEFAULT_EXTERNAL_PRIORITY : DEFAULT_PRIORITY; _calibration_index = -1; _calibration_count = 0; } bool Gyroscope::ParametersSave() { if (_calibration_index >= 0) { // save calibration bool success = true; success &= SetCalibrationParam(SensorString(), "ID", _calibration_index, _device_id); success &= SetCalibrationParam(SensorString(), "PRIO", _calibration_index, _priority); success &= SetCalibrationParamsVector3f(SensorString(), "OFF", _calibration_index, _offset); if (_external) { success &= SetCalibrationParam(SensorString(), "ROT", _calibration_index, (int32_t)_rotation_enum); } else { success &= SetCalibrationParam(SensorString(), "ROT", _calibration_index, -1); } return success; } return false; } void Gyroscope::PrintStatus() { PX4_INFO("%s %d EN: %d, offset: [%.4f %.4f %.4f]", SensorString(), device_id(), enabled(), (double)_offset(0), (double)_offset(1), (double)_offset(2)); if (_thermal_offset.norm() > 0.f) { PX4_INFO("%s %d temperature offset: [%.4f %.4f %.4f]", SensorString(), _device_id, (double)_thermal_offset(0), (double)_thermal_offset(1), (double)_thermal_offset(2)); } } } // namespace calibration