/**************************************************************************** * * 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 "Magnetometer.hpp" #include "Utilities.hpp" #include using namespace matrix; using namespace time_literals; namespace calibration { Magnetometer::Magnetometer() { Reset(); } Magnetometer::Magnetometer(uint32_t device_id, bool external) { Reset(); set_device_id(device_id, external); } void Magnetometer::set_device_id(uint32_t device_id, bool external) { if (_device_id != device_id || _external != external) { set_external(external); _device_id = device_id; ParametersUpdate(); } } void Magnetometer::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; } bool Magnetometer::set_offset(const Vector3f &offset) { if (Vector3f(_offset - offset).longerThan(0.001f)) { _offset = offset; _calibration_count++; return true; } return false; } bool Magnetometer::set_scale(const Vector3f &scale) { if (Vector3f(_scale.diag() - scale).longerThan(0.001f)) { _scale(0, 0) = scale(0); _scale(1, 1) = scale(1); _scale(2, 2) = scale(2); _calibration_count++; return true; } return false; } bool Magnetometer::set_offdiagonal(const Vector3f &offdiagonal) { if (Vector3f(Vector3f{_scale(0, 1), _scale(0, 2), _scale(1, 2)} - offdiagonal).longerThan(0.001f)) { _scale(0, 1) = offdiagonal(0); _scale(1, 0) = offdiagonal(0); _scale(0, 2) = offdiagonal(1); _scale(2, 0) = offdiagonal(1); _scale(1, 2) = offdiagonal(2); _scale(2, 1) = offdiagonal(2); _calibration_count++; return true; } return false; } void Magnetometer::set_rotation(Rotation rotation) { _rotation_enum = rotation; // always apply board level adjustments _rotation = Dcmf(GetSensorLevelAdjustment()) * get_rot_matrix(rotation); } void Magnetometer::ParametersUpdate() { if (_device_id == 0) { Reset(); return; } _calibration_index = FindCalibrationIndex(SensorString(), _device_id); if (_calibration_index >= 0) { // CAL_MAGx_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); } set_rotation(static_cast(rotation_value)); } else { // internal mag, CAL_MAGx_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); } // internal sensors follow board rotation set_rotation(GetBoardRotation()); } // CAL_MAGx_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; } // CAL_MAGx_OFF{X,Y,Z} set_offset(GetCalibrationParamsVector3f(SensorString(), "OFF", _calibration_index)); // CAL_MAGx_SCALE{X,Y,Z} set_scale(GetCalibrationParamsVector3f(SensorString(), "SCALE", _calibration_index)); // CAL_MAGx_ODIAG{X,Y,Z} set_offdiagonal(GetCalibrationParamsVector3f(SensorString(), "ODIAG", _calibration_index)); // CAL_MAGx_COMP{X,Y,Z} _power_compensation = GetCalibrationParamsVector3f(SensorString(), "COMP", _calibration_index); } else { Reset(); } } void Magnetometer::Reset() { _rotation.setIdentity(); _rotation_enum = ROTATION_NONE; _offset.zero(); _scale.setIdentity(); _power_compensation.zero(); _power = 0.f; _priority = _external ? DEFAULT_EXTERNAL_PRIORITY : DEFAULT_PRIORITY; _calibration_index = -1; _calibration_count = 0; } bool Magnetometer::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); const Vector3f scale{_scale.diag()}; success &= SetCalibrationParamsVector3f(SensorString(), "SCALE", _calibration_index, scale); const Vector3f off_diag{_scale(0, 1), _scale(0, 2), _scale(1, 2)}; success &= SetCalibrationParamsVector3f(SensorString(), "ODIAG", _calibration_index, off_diag); success &= SetCalibrationParamsVector3f(SensorString(), "COMP", _calibration_index, _power_compensation); 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 Magnetometer::PrintStatus() { if (external()) { PX4_INFO("%s %d EN: %d, offset: [% 05.3f % 05.3f % 05.3f], scale: [% 05.3f % 05.3f % 05.3f], External ROT: %d", SensorString(), device_id(), enabled(), (double)_offset(0), (double)_offset(1), (double)_offset(2), (double)_scale(0, 0), (double)_scale(1, 1), (double)_scale(2, 2), rotation_enum()); } else { PX4_INFO("%s %d EN: %d, offset: [% 05.3f % 05.3f % 05.3f], scale: [% 05.3f % 05.3f % 05.3f], Internal", SensorString(), device_id(), enabled(), (double)_offset(0), (double)_offset(1), (double)_offset(2), (double)_scale(0, 0), (double)_scale(1, 1), (double)_scale(2, 2)); } #if defined(DEBUG_BUILD) _scale.print() #endif // DEBUG_BUILD } } // namespace calibration