RC Adjustments - rotorflight/rotorflight GitHub Wiki

:exclamation: This page is outdated

Rotorflight Wiki is replaced by www.rotorflight.org.


With RC Adjustments it's possible to assign RC channels to configuration parameters

The RC Adjustments feature can be configured with the Configurator in the Adjustments tab.

There are total 32 adjustment slots, each assigning an AUX channel to a configuration parameter or a special function. An adjustment slot consist of an enabling condition, an adjustment function, and parameter limits.

The enabling condition is an AUX channel, which must be within the configured range for the slot to be active. Once active, a control AUX channel will cause a parameter value adjustment, based on the selected adjustment function.

Any changes are taking effect immediately, and are saved in the configuration.

Example - Select a Profile In-Flight

Being able to switch between profiles in-flight allows you to use different headspeeds with differently tuned PIDs. It can also help with PID tuning, since it makes A/B testing possible with the flick of a switch.

Simple example

Here we use only one channel -AUX2- for Profile Selection. Assign AUX2 to a 3-position switch on the TX, so that the switch outputs 1000/1500/2000us.

adjust-pid-profile

The minimum value for Profile Selection is 1 (profile 1). Since we're using a 3-postition switch, the maximum value is set to 3 (profile 3). Step size isn't used here, so that's set to 0.

You can test Profile Selection by going to the Profiles tab in the Configurator and use the 3-position switch. You should now be able to switch the profile tab using the 3-position switch.

If you would like to switch between profile 4/5/6 using the 3-position switch, specify 4 for the minimum value and 6 for the maximum value.

Note that the Profile Selection function is always active, since the range is from 900us to 2100us.

You can find step by step instructions for this setup in the profile switching walk-through.

Advanced example

In this example AUX2 activates the PID Profile Selection function when it's between 1000us and 1100us. If the function is active, AUX3 defines which PID profile should be selected: 1, 2 or 3.

adjust-pid-profile

In OpenTX, a Special Function can be assigned to a switch to output 1050us on AUX2 when flying. AUX3 is controlled by a 3 position switch and outputs 1000/1500/2000us for selecting PID profile 1/2/3.

Adjustment Types

There are two ways the how the control AUX channel is affecting the configuration parameter.

Step Adjustment

The control AUX channel can be a three position switch or a trim switch on the transmitter. While in up position, it will cause the adjustment to increase by step size, and vice versa. The min and max limits are adhered.

Step adjustment is enabled by setting the step size to non-zero value.

Continuous Adjustment

The control AUX channel is a full resolution RC channel, and is controlling the configuration parameter directly. The RC channel range 1000us..2000us is stretched to cover the parameter range min..max.

Continuous adjustment is enabled by setting the step size to zero.

Adjustment Functions

The adjustment function assigns the control AUX channel to a configuration parameter or a special function. The supported functions are listed below. The last four are special functions for changing selected profiles.

PITCH_RATE
ROLL_RATE
YAW_RATE
PITCH_RC_RATE
ROLL_RC_RATE
YAW_RC_RATE
PITCH_RC_EXPO
ROLL_RC_EXPO
YAW_RC_EXPO
PITCH_P_GAIN
PITCH_I_GAIN
PITCH_D_GAIN
PITCH_F_GAIN
ROLL_P_GAIN
ROLL_I_GAIN
ROLL_D_GAIN
ROLL_F_GAIN
YAW_P_GAIN
YAW_I_GAIN
YAW_D_GAIN
YAW_F_GAIN
YAW_CENTER
YAW_CW_GAIN
YAW_CCW_GAIN
YAW_CYCLIC_FF
YAW_COLLECTIVE_FF
YAW_IMPULSE_FF
RESCUE_COLLECTIVE
RESCUE_COLLECTIVE_BOOST
ANGLE_LEVEL_GAIN
HORIZON_LEVEL_GAIN
ACRO_TRAINER_GAIN
GOV_GAIN
GOV_P_GAIN
GOV_I_GAIN
GOV_D_GAIN
GOV_F_GAIN
GOV_TTA_GAIN
GOV_CYCLIC_FF
GOV_COLLECTIVE_FF
RATE_PROFILE
PID_PROFILE
OSD_PROFILE
LED_PROFILE

Parameter Change Functions

The parameter change functions are adjusting the associated configuration parameters, taking effect immediately. This allows changing the fundamental tuning parameter inflight.

Each parameter has a min and max limit that the user can set to safeguard against unreasonable or unsafe values. In addition, the system has absolute limits for each parameter.

Profile Change Functions

The special functions to change configuration profiles works exactly the same as the parameter functions, except that the possible values are limited to the number of profiles. Both step and continuous adjustments can be used.

For example, there are six Rate Profiles available, thus the parameter limits should be min = 0 and max = 5. Narrower range is also possible, if so desired.