From da89d5e939d299e48e96239b373151b5b0b0e04c Mon Sep 17 00:00:00 2001 From: Nick <145654544+ttechnick@users.noreply.github.com> Date: Wed, 26 Nov 2025 18:12:25 +0100 Subject: [PATCH] PWM: Add servo center setting & asymetric deflection (#25897) Add PWM_*_CENTERx for each servo. Use a bilinear transform to map actuator_servos to PWM signals. This solution only works for PWM based servos. Other types of servos are not affected. * PWM: Add servo trim option * PWM: Improve documentation of PWM trim feature * PWM: cleaner clamping and docs typo * update documentation & safety * add migration formula * rename param from trim to center * docs with center instead of trim * move clamping and reorder values * improve documentation * adress failing range check * improve documentation * CA: add event for setting CENTER with TRIM Signed-off-by: Silvan --------- Signed-off-by: Silvan Co-authored-by: Silvan --- .../generate_actuators_metadata.py | 1 + Tools/module_config/generate_params.py | 8 +++ .../config/actuators/pwm_center_output.png | Bin 0 -> 114494 bytes .../config/actuators/servo_pwm_center.png | Bin 0 -> 18291 bytes .../config/actuators/servo_pwm_linear.png | Bin 0 -> 29247 bytes docs/en/config/actuators.md | 53 ++++++++++++++++-- src/drivers/pwm_out/module.yaml | 1 + src/lib/mixer_module/mixer_module.cpp | 47 ++++++++++++++-- src/lib/mixer_module/mixer_module.hpp | 5 ++ src/lib/mixer_module/mixer_module_tests.cpp | 6 ++ .../ActuatorEffectivenessControlSurfaces.cpp | 49 ++++++++++++++++ src/modules/control_allocator/module.yaml | 6 +- validation/module_schema.yaml | 22 ++++++++ 13 files changed, 187 insertions(+), 11 deletions(-) create mode 100644 docs/assets/config/actuators/pwm_center_output.png create mode 100644 docs/assets/config/actuators/servo_pwm_center.png create mode 100644 docs/assets/config/actuators/servo_pwm_linear.png diff --git a/Tools/module_config/generate_actuators_metadata.py b/Tools/module_config/generate_actuators_metadata.py index 196119259b..5d38ecf499 100755 --- a/Tools/module_config/generate_actuators_metadata.py +++ b/Tools/module_config/generate_actuators_metadata.py @@ -238,6 +238,7 @@ def get_actuator_output(yaml_config, output_functions, timer_config_file, verbos ( 'disarmed', 'Disarmed', 'DIS', False ), ( 'min', 'Minimum', 'MIN', False ), ( 'max', 'Maximum', 'MAX', False ), + ( 'center', 'Center\n(for Servos)', 'CENT', False ), ( 'failsafe', 'Failsafe', 'FAIL', True ), ] for key, label, param_suffix, advanced in standard_params_array: diff --git a/Tools/module_config/generate_params.py b/Tools/module_config/generate_params.py index 92b2593656..ecc29a4519 100755 --- a/Tools/module_config/generate_params.py +++ b/Tools/module_config/generate_params.py @@ -284,6 +284,9 @@ Note that non-motor outputs might already be active in prearm state if COM_PREAR ''' minimum_description = \ '''Minimum output value (when not disarmed). +''' + center_description = \ +'''Servo Center output value (when not disarmed). ''' maximum_description = \ '''Maxmimum output value (when not disarmed). @@ -296,6 +299,7 @@ When set to -1 (default), the value depends on the function (see {:}). standard_params_array = [ ( 'disarmed', 'Disarmed', 'DIS', disarmed_description ), ( 'min', 'Minimum', 'MIN', minimum_description ), + ( 'center', 'Center', 'CENT', center_description ), ( 'max', 'Maximum', 'MAX', maximum_description ), ( 'failsafe', 'Failsafe', 'FAIL', failsafe_description ), ] @@ -312,6 +316,10 @@ When set to -1 (default), the value depends on the function (see {:}). standard_params[key]['default'] = -1 standard_params[key]['min'] = -1 + if key == 'center': + standard_params[key]['default'] = -1 + standard_params[key]['min'] = -1 + param = { 'description': { 'short': channel_label+' ${i} '+label+' Value', diff --git a/docs/assets/config/actuators/pwm_center_output.png b/docs/assets/config/actuators/pwm_center_output.png new file mode 100644 index 0000000000000000000000000000000000000000..ef83e96d88c7d089494ba0eb64a4e4578402604f GIT binary patch literal 114494 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�y9-_K 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 PQo!jGddIUht?vCF&0^t! literal 0 HcmV?d00001 diff --git a/docs/assets/config/actuators/servo_pwm_linear.png b/docs/assets/config/actuators/servo_pwm_linear.png new file mode 100644 index 0000000000000000000000000000000000000000..176beab77ecc96339bdab25e48a78502cd4d58af GIT binary patch literal 29247 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�%Wh*d6nIUP+vugaRgbmNpXz*E5)t&^l`1N9 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 R_8Xi%t&4gWa?jm(@E;N=i8cTL literal 0 HcmV?d00001 diff --git a/docs/en/config/actuators.md b/docs/en/config/actuators.md index 3eec8f2dd2..56af61c737 100644 --- a/docs/en/config/actuators.md +++ b/docs/en/config/actuators.md @@ -159,7 +159,7 @@ The fields are: - `Yaw Torque`: Effectiveness of actuator around yaw axis (normalised: -1 to 1). [Generally you should use the default actuator value](#actuator-roll-pitch-and-yaw-scaling). - `Trim`: An offset added to the actuator so that it is centered without input. - This might be determined by trial and error. + This might be determined by trial and error. Prefer using the improved `PWM_CENT` instead: [PWM control surfaces](./actuators.md#pwm-control-surfaces-that-move-both-directions-about-a-neutral-point) - (Advanced) `Slew Rate`: Limits the minimum time in which the motor/servo signal is allowed to pass through its full output range, in seconds. - The setting limits the rate of change of an actuator (if not specified then no rate limit is applied). It is intended for actuators that may be damaged or cause flight disturbance if they move too fast — such as the tilting actuators on a tiltrotor VTOL vehicle, or fast moving flaps, respectively. @@ -535,12 +535,40 @@ If you're using PWM servos, PWM50 is far more common. If a high rate servo is _really_ needed, DShot offers better value. ::: -#### Control surfaces that move both directions about a neutral point +##### PWM: Control surfaces that move both directions about a neutral point + +To facilitate setting the neutral point of the servos, a bilinear curve function can be defined using the following parameters `PWM_MAIM_CENTx` / `PWM_AUX_CENTx` for each servo. This allows for unequal deflections in the positive and negative direction: +![Asymetric Servo Deflections](../../assets/config/actuators/servo_pwm_center.png) + +To set this up: + +1. Set all surface `Trim` to `0.00` for all surfaces: + + ![PWM Trimming](../../assets/config/actuators/control_surface_trim.png) + +1. Set the `PWM_MAIN_CENTx` / `PWM_AUX_CENTx` value so that the surface will stay at the neutral (aligned with airfoil) position. +This is usually around `1500` for PWM servos (near the center of the servo range). + +![Control Surface Trimming](../../assets/config/actuators/pwm_center_output.png) + +2. Gradualy increase the `Maximum` for each servo until the desired deflection is reached. Check the deflection with a remote manual mode while [`COM_PREARM_MODE`](../advanced_config/parameter_reference.md#COM_PREARM_MODE) is set to `Always` or use the sliders. +3. Gradualy decrease the `Minimum` for each servo, until the desired deflection is reached. +4. Set `Disarmed` value to the desired value. It is usually desirable to have it the same as the `Center` value. + +::: info +If you want to retain the linear behaviour of the servo after setting the `Center`, make sure to adjust the `Minimum` or `Maximum`, such that both invervals (`min` to `cent` & `cent` to `max`) are equally lare. + +![Linear PWM Adjustment](../../assets/config/actuators/servo_pwm_linear.png) +::: + +#### Non-PWM: Control surfaces that move both directions about a neutral point Control surfaces that move either direction around a neutral point include: ailerons, elevons, V-tails, A-tails, and rudders. To set these up: +0. Set all `PWM_MAIN_CENTx` and `PWM_AUX_CENTx` to default (-1), or trimming will not be possible. + 1. Set the `Disarmed` value so that the surfaces will stay at neutral position when disarmed. This is usually around `1500` for PWM servos (near the centre of the servo range). @@ -559,14 +587,20 @@ To set these up: 3. Move the slider again to the middle and check if the Control Surfaces are aligned in the neutral position of the wing. - If it is not aligned, you can set the **Trim** value for the control surface. - ::: info - This is done in the `Trim` setting of the Geometry panel, usually by "trial and error". - ![Control Surface Trimming](../../assets/config/actuators/control_surface_trim.png) - ::: + ::: info + This is done in the `Trim` setting of the Geometry panel, usually by "trial and error". + ![Control Surface Trimming](../../assets/config/actuators/control_surface_trim.png) + ::: - After setting the trim for a control surface, move its slider away from the centre, release, and then back into disarmed (middle) position. Confirm that surface is in the neutral position. + + +::: tip +If any servo has a `PWM_MAIN_CENTx` or `PWM_AUX_CENTx` not set to default (-1), the system will automatically remove `Trim` from all surfaces. This is done to prevent mixing of old and new trimming tools. +::: + ::: info Another way to test without using the sliders would be to set the [`COM_PREARM_MODE`](../advanced_config/parameter_reference.md#COM_PREARM_MODE) parameter to `Always`: @@ -575,6 +609,8 @@ Another way to test without using the sliders would be to set the [`COM_PREARM_M ::: + + #### Control surfaces that move from neutral to full deflection Control surfaces that move only one direction from neutral include: airbrakes, spoilers, and flaps. @@ -585,6 +621,7 @@ For a flap, that is when the flap is fully retracted and flush with the wing. One approach for setting these up is: +0. Set all `PWM_MAIN_CENTx` and `PWM_AUX_CENTx` to default (-1), or trimming will not be possible. 1. Set values `Disarmed` to `1500`, `Min` to `1200`, `Max` to `1700` so that the values are around the centre of the servo range. 2. Move the corresponding slider up and check the control moves and that it is extending (moving away from the disarmed position). If not, click on the `Rev Range` checkbox to reverse the range. @@ -594,6 +631,7 @@ One approach for setting these up is: - If the value was increased towards `Max`, then set `Max` to match `Disarmed`. 4. The value that you did _not_ set to match `Disarmed` controls the maximum amount that the control surface can extend. Set the slider to the top of the control, then change the value (`Max` or `Min`) so that the control surface is fully extended when the slider is at top. +5. (Only PWM servos) Set the `Center` value to the middle between `Min` and `Max`. ::: info Special note for flaps In some vehicle builds, flaps may be configured such that both flaps are controlled from a single output. @@ -631,6 +669,9 @@ For each of the tilt servos: - Standard VTOL : Motors defined as multicopter motors will be turned off - Tiltrotors : Motors that have no associated tilt servo will turn off - Tailsitters do not turn off any motors in fixed-wing flight +- The following formula can be used to migrate from surface trim to PWM trim: + + `PWM_MAIN_CENTx = ((PWM_MAX - PWM_MIN) / 2) * CA_SV_CSx_TRIM + PWM_MIN + ((PWM_MAX - PWM_MIN) / 2)` ### Reversing Motors diff --git a/src/drivers/pwm_out/module.yaml b/src/drivers/pwm_out/module.yaml index 8c2049cceb..2c5e54e83d 100644 --- a/src/drivers/pwm_out/module.yaml +++ b/src/drivers/pwm_out/module.yaml @@ -8,6 +8,7 @@ actuator_output: disarmed: { min: 800, max: 2200, default: 1000 } min: { min: 800, max: 1400, default: 1000 } max: { min: 1600, max: 2200, default: 2000 } + center: { min: 800, max: 2200} failsafe: { min: 800, max: 2200 } extra_function_groups: [ pwm_fmu ] pwm_timer_param: diff --git a/src/lib/mixer_module/mixer_module.cpp b/src/lib/mixer_module/mixer_module.cpp index b038268d84..fe1b818f86 100644 --- a/src/lib/mixer_module/mixer_module.cpp +++ b/src/lib/mixer_module/mixer_module.cpp @@ -120,6 +120,8 @@ void MixingOutput::initParamHandles(const uint8_t instance_start) _param_handles[i].disarmed = param_find(param_name); snprintf(param_name, sizeof(param_name), "%s_%s%d", _param_prefix, "MIN", i + instance_start); _param_handles[i].min = param_find(param_name); + snprintf(param_name, sizeof(param_name), "%s_%s%d", _param_prefix, "CENT", i + instance_start); + _param_handles[i].center = param_find(param_name); snprintf(param_name, sizeof(param_name), "%s_%s%d", _param_prefix, "MAX", i + instance_start); _param_handles[i].max = param_find(param_name); snprintf(param_name, sizeof(param_name), "%s_%s%d", _param_prefix, "FAIL", i + instance_start); @@ -142,9 +144,9 @@ void MixingOutput::printStatus() const PX4_INFO_RAW("Channel Configuration:\n"); for (unsigned i = 0; i < _max_num_outputs; i++) { - PX4_INFO_RAW("Channel %i: func: %3i, value: %i, failsafe: %d, disarmed: %d, min: %d, max: %d\n", i, + PX4_INFO_RAW("Channel %i: func: %3i, value: %i, failsafe: %d, disarmed: %d, min: %d, max: %d, center: %d\n", i, (int)_function_assignment[i], _current_output_value[i], - actualFailsafeValue(i), _disarmed_value[i], _min_value[i], _max_value[i]); + actualFailsafeValue(i), _disarmed_value[i], _min_value[i], _max_value[i], _center_value[i]); } } @@ -173,6 +175,10 @@ void MixingOutput::updateParams() _min_value[i] = val; } + if (_param_handles[i].center != PARAM_INVALID && param_get(_param_handles[i].center, &val) == 0) { + _center_value[i] = val; + } + if (_param_handles[i].max != PARAM_INVALID && param_get(_param_handles[i].max, &val) == 0) { _max_value[i] = val; } @@ -183,6 +189,7 @@ void MixingOutput::updateParams() _max_value[i] = tmp; } + if (_param_handles[i].failsafe != PARAM_INVALID && param_get(_param_handles[i].failsafe, &val) == 0) { _failsafe_value[i] = val; } @@ -372,6 +379,14 @@ void MixingOutput::setAllMinValues(uint16_t value) } } +void MixingOutput::setAllCenterValues(uint16_t value) +{ + for (unsigned i = 0; i < MAX_ACTUATORS; i++) { + _param_handles[i].center = PARAM_INVALID; + _center_value[i] = value; + } +} + void MixingOutput::setAllMaxValues(uint16_t value) { for (unsigned i = 0; i < MAX_ACTUATORS; i++) { @@ -528,10 +543,34 @@ uint16_t MixingOutput::output_limit_calc_single(int i, float value) const value = -1.f * value; } - const float output = math::interpolate(value, -1.f, 1.f, - static_cast(_min_value[i]), static_cast(_max_value[i])); + float output = _disarmed_value[i]; + + if (_function_assignment[i] >= OutputFunction::Servo1 + && _function_assignment[i] <= OutputFunction::ServoMax + && _param_handles[i].center != PARAM_INVALID + && _center_value[i] >= 800 + && _center_value[i] <= 2200) { + + /* bi-linear interpolation */ + if (value < 0.0f) { + output = math::interpolate(value, -1.f, 0.0f, + static_cast(_min_value[i]), static_cast(_center_value[i])); + + } else { + output = math::interpolate(value, 0.0f, 1.0f, + static_cast(_center_value[i]), static_cast(_max_value[i])); + } + + } + + // Everything except servos, or if center is not set + else { + output = math::interpolate(value, -1.f, 1.f, + static_cast(_min_value[i]), static_cast(_max_value[i])); + } return math::constrain(lroundf(output), 0L, static_cast(UINT16_MAX)); + } void diff --git a/src/lib/mixer_module/mixer_module.hpp b/src/lib/mixer_module/mixer_module.hpp index 7ed8ed8a73..4fdc0f2904 100644 --- a/src/lib/mixer_module/mixer_module.hpp +++ b/src/lib/mixer_module/mixer_module.hpp @@ -167,16 +167,19 @@ public: void setAllFailsafeValues(uint16_t value); void setAllDisarmedValues(uint16_t value); void setAllMinValues(uint16_t value); + void setAllCenterValues(uint16_t value); void setAllMaxValues(uint16_t value); /** Disarmed values: disarmedValue < minValue needs to hold */ uint16_t &disarmedValue(int index) { return _disarmed_value[index]; } uint16_t &minValue(int index) { return _min_value[index]; } + uint16_t ¢erValue(int index) { return _center_value[index]; } uint16_t &maxValue(int index) { return _max_value[index]; } param_t functionParamHandle(int index) const { return _param_handles[index].function; } param_t disarmedParamHandle(int index) const { return _param_handles[index].disarmed; } param_t minParamHandle(int index) const { return _param_handles[index].min; } + param_t centerParamHandle(int index) const { return _param_handles[index].center; } param_t maxParamHandle(int index) const { return _param_handles[index].max; } /** @@ -228,6 +231,7 @@ private: param_t function{PARAM_INVALID}; param_t disarmed{PARAM_INVALID}; param_t min{PARAM_INVALID}; + param_t center{PARAM_INVALID}; param_t max{PARAM_INVALID}; param_t failsafe{PARAM_INVALID}; }; @@ -240,6 +244,7 @@ private: uint16_t _failsafe_value[MAX_ACTUATORS] {}; uint16_t _disarmed_value[MAX_ACTUATORS] {}; uint16_t _min_value[MAX_ACTUATORS] {}; + uint16_t _center_value[MAX_ACTUATORS] {}; uint16_t _max_value[MAX_ACTUATORS] {}; uint16_t _current_output_value[MAX_ACTUATORS] {}; ///< current output values (reordered) uint16_t _reverse_output_mask{0}; ///< reverses the interval [min, max] -> [max, min], NOT motor direction diff --git a/src/lib/mixer_module/mixer_module_tests.cpp b/src/lib/mixer_module/mixer_module_tests.cpp index 7db9a8c513..7f3a6feede 100644 --- a/src/lib/mixer_module/mixer_module_tests.cpp +++ b/src/lib/mixer_module/mixer_module_tests.cpp @@ -54,6 +54,7 @@ static constexpr int MAX_NUM_OUTPUTS = 8; static constexpr int DISARMED_VALUE = 900; static constexpr int FAILSAFE_VALUE = 800; static constexpr int MIN_VALUE = 1000; +static constexpr int CENTER_VALUE = 1500; static constexpr int MAX_VALUE = 2000; class MixerModuleTest : public ::testing::Test @@ -188,6 +189,7 @@ TEST_F(MixerModuleTest, basic) mixing_output.setAllDisarmedValues(DISARMED_VALUE); mixing_output.setAllFailsafeValues(FAILSAFE_VALUE); mixing_output.setAllMinValues(MIN_VALUE); + mixing_output.setAllCenterValues(CENTER_VALUE); mixing_output.setAllMaxValues(MAX_VALUE); EXPECT_EQ(test_module.num_updates, 0); @@ -281,6 +283,7 @@ TEST_F(MixerModuleTest, arming) mixing_output.setAllDisarmedValues(DISARMED_VALUE); mixing_output.setAllFailsafeValues(FAILSAFE_VALUE); mixing_output.setAllMinValues(MIN_VALUE); + mixing_output.setAllCenterValues(CENTER_VALUE); mixing_output.setAllMaxValues(MAX_VALUE); test_module.sendMotors({1.f, 1.f, 1.f, 1.f, 1.f, 1.f, 1.f, 1.f}); @@ -488,6 +491,7 @@ TEST_F(MixerModuleTest, OutputLimitCalcSingle) mixing_output.setAllMinValues(MIN_VALUE); // default range [1000,2000] mixing_output.setAllMaxValues(MAX_VALUE); + mixing_output.setAllCenterValues(CENTER_VALUE); // Set center to middle value EXPECT_EQ(mixing_output.output_limit_calc_single(0, -1.f), 1000); // In range EXPECT_EQ(mixing_output.output_limit_calc_single(0, -.5f), 1250); EXPECT_EQ(mixing_output.output_limit_calc_single(0, 0.f), 1500); @@ -503,6 +507,7 @@ TEST_F(MixerModuleTest, OutputLimitCalcSingle) mixing_output.setAllMinValues(0); // lower range [0,20] mixing_output.setAllMaxValues(20); + mixing_output.setAllCenterValues(10); // Set center to middle value EXPECT_EQ(mixing_output.output_limit_calc_single(0, -1.f), 0); // In range EXPECT_EQ(mixing_output.output_limit_calc_single(0, -.5f), 5); EXPECT_EQ(mixing_output.output_limit_calc_single(0, 0.f), 10); @@ -518,6 +523,7 @@ TEST_F(MixerModuleTest, OutputLimitCalcSingle) mixing_output.setAllMinValues(20); // inverted range [20,0] mixing_output.setAllMaxValues(0); + mixing_output.setAllCenterValues(10); // Set center to middle value EXPECT_EQ(mixing_output.output_limit_calc_single(0, -1.f), 20); // In range EXPECT_EQ(mixing_output.output_limit_calc_single(0, -.5f), 15); EXPECT_EQ(mixing_output.output_limit_calc_single(0, 0.f), 10); diff --git a/src/modules/control_allocator/VehicleActuatorEffectiveness/ActuatorEffectivenessControlSurfaces.cpp b/src/modules/control_allocator/VehicleActuatorEffectiveness/ActuatorEffectivenessControlSurfaces.cpp index 46fea5f33e..f6e216b855 100644 --- a/src/modules/control_allocator/VehicleActuatorEffectiveness/ActuatorEffectivenessControlSurfaces.cpp +++ b/src/modules/control_allocator/VehicleActuatorEffectiveness/ActuatorEffectivenessControlSurfaces.cpp @@ -32,6 +32,7 @@ ****************************************************************************/ #include +#include #include "ActuatorEffectivenessControlSurfaces.hpp" @@ -74,6 +75,40 @@ void ActuatorEffectivenessControlSurfaces::updateParams() return; } + // Helper to check if a PWM center parameter is enabled, and clamp it to valid range + auto check_pwm_center = [](const char *prefix, int channel) -> bool { + char param_name[20]; + snprintf(param_name, sizeof(param_name), "%s_CENT%d", prefix, channel); + param_t param = param_find(param_name); + + if (param != PARAM_INVALID) + { + int32_t value; + + if (param_get(param, &value) == PX4_OK && value != -1) { + // Clamp PWM center to valid range [800, 2200] + if (value < 800 || value > 2200) { + int32_t clamped = (value < 800) ? 800 : 2200; + PX4_WARN("%s_CENT%d (%d) out of range, clamping to %d", prefix, channel, (int)value, (int)clamped); + param_set(param, &clamped); + } + + return true; + } + } + + return false; + }; + + // Check if any PWM_MAIN or PWM_AUX center is configured + bool pwm_center_set = false; + + for (int i = 1; i <= 8; i++) { + if (check_pwm_center("PWM_MAIN", i) || check_pwm_center("PWM_AUX", i)) { + pwm_center_set = true; + } + } + for (int i = 0; i < _count; i++) { param_get(_param_handles[i].type, (int32_t *)&_params[i].type); @@ -84,6 +119,20 @@ void ActuatorEffectivenessControlSurfaces::updateParams() } param_get(_param_handles[i].trim, &_params[i].trim); + + // If PWM center is set and CA_SV_CS trim is non-zero, warn and reset to 0 + if (pwm_center_set && fabsf(_params[i].trim) > FLT_EPSILON) { + /* EVENT + * @description Display warning in GCS when TRIM settings were present and now CENTER are set. + */ + events::send(events::ID("control_surfaces_reset_trim"), events::Log::Warning, + "CA_SV_CS{1}_TRIM ({2}) is reset to 0 as PWM CENTER is used", i, _params[i].trim); + + _params[i].trim = 0.0f; + // Update the parameter storage + param_set(_param_handles[i].trim, &_params[i].trim); + } + param_get(_param_handles[i].scale_flap, &_params[i].scale_flap); param_get(_param_handles[i].scale_spoiler, &_params[i].scale_spoiler); diff --git a/src/modules/control_allocator/module.yaml b/src/modules/control_allocator/module.yaml index 99d0d5ed85..dd36a2d070 100644 --- a/src/modules/control_allocator/module.yaml +++ b/src/modules/control_allocator/module.yaml @@ -312,7 +312,11 @@ parameters: CA_SV_CS${i}_TRIM: description: short: Control Surface ${i} trim - long: Can be used to add an offset to the servo control. + long: | + Can be used to add an offset to the servo control. + + NOTE: Do not use for PWM servos. Use the PWM CENTER parameters instead (e.g., PWM_MAIN_CENT, PWM_AUX_CENT) instead. + This parameter can only be set if all PWM Center parameters are set to default. type: float decimal: 2 min: -1.0 diff --git a/validation/module_schema.yaml b/validation/module_schema.yaml index 1e1baa1037..1f17bf5fb2 100644 --- a/validation/module_schema.yaml +++ b/validation/module_schema.yaml @@ -352,6 +352,28 @@ actuator_output: # ui only shows the param if this condition is true type: string regex: *condition_regex + center: + type: dict + schema: + min: + # Minimum center value + type: integer + min: 0 + max: 65536 + max: + # Maximum center value + type: integer + min: 0 + max: 65536 + default: + # Default center value + type: integer + min: 0 + max: 65536 + show_if: + # ui only shows the param if this condition is true + type: string + regex: *condition_regex failsafe: type: dict schema: