src/main/fc/controlrate_profile.h

   1 /*
   2  * This file is part of Cleanflight and Betaflight.
   3  *
   4  * Cleanflight and Betaflight are free software. You can redistribute
   5  * this software and/or modify this software under the terms of the
   6  * GNU General Public License as published by the Free Software
   7  * Foundation, either version 3 of the License, or (at your option)
   8  * any later version.
   9  *
  10  * Cleanflight and Betaflight are distributed in the hope that they
  11  * will be useful, but WITHOUT ANY WARRANTY; without even the implied
  12  * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  13  * See the GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this software.
  17  *
  18  * If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 #pragma once
  22
  23 #include <stdint.h>
  24
  25 #include "pg/pg.h"
  26
  27 typedef enum {
  28     RATES_TYPE_BETAFLIGHT = 0,
  29     RATES_TYPE_RACEFLIGHT,
  30     RATES_TYPE_KISS,
  31     RATES_TYPE_ACTUAL,
  32     RATES_TYPE_QUICK,
  33     RATES_TYPE_COUNT    // must be the final entry
  34 } ratesType_e;
  35
  36 typedef struct ratesSettingsLimits_s {
  37     uint8_t rc_rate_limit;
  38     uint8_t srate_limit;
  39     uint8_t expo_limit;
  40 } ratesSettingsLimits_t;
  41
  42 typedef enum {
  43     THROTTLE_LIMIT_TYPE_OFF = 0,
  44     THROTTLE_LIMIT_TYPE_SCALE,
  45     THROTTLE_LIMIT_TYPE_CLIP,
  46     THROTTLE_LIMIT_TYPE_COUNT   // must be the last entry
  47 } throttleLimitType_e;
  48
  49 #define MAX_RATE_PROFILE_NAME_LENGTH 8u
  50
  51 typedef struct controlRateConfig_s {
  52     uint8_t thrMid8;
  53     uint8_t thrExpo8;
  54     uint8_t rates_type;
  55     uint8_t rcRates[3];
  56     uint8_t rcExpo[3];
  57     uint8_t rates[3];
  58     uint8_t throttle_limit_type;            // Sets the throttle limiting type - off, scale or clip
  59     uint8_t throttle_limit_percent;         // Sets the maximum pilot commanded throttle limit
  60     uint16_t rate_limit[3];                 // Sets the maximum rate for the axes
  61     char profileName[MAX_RATE_PROFILE_NAME_LENGTH + 1]; // Descriptive name for rate profile
  62     uint8_t quickRatesRcExpo;               // Sets expo on rc command for quick rates
  63 } controlRateConfig_t;
  64
  65 PG_DECLARE_ARRAY(controlRateConfig_t, CONTROL_RATE_PROFILE_COUNT, controlRateProfiles);
  66
  67 extern controlRateConfig_t *currentControlRateProfile;
  68 extern const ratesSettingsLimits_t ratesSettingLimits[RATES_TYPE_COUNT];
  69
  70 void loadControlRateProfile(void);
  71 void changeControlRateProfile(uint8_t controlRateProfileIndex);
  72
  73 void copyControlRateProfile(const uint8_t dstControlRateProfileIndex, const uint8_t srcControlRateProfileIndex);