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 0000000000..cc803656aa Binary files /dev/null and b/docs/assets/config/actuators/pwm_center_output.png differ diff --git a/docs/assets/config/actuators/servo_pwm_center.png b/docs/assets/config/actuators/servo_pwm_center.png new file mode 100644 index 0000000000..c1d92b7676 Binary files /dev/null and b/docs/assets/config/actuators/servo_pwm_center.png differ diff --git a/docs/assets/config/actuators/servo_pwm_trim.png b/docs/assets/config/actuators/servo_pwm_trim.png deleted file mode 100644 index 20ab3e7945..0000000000 Binary files a/docs/assets/config/actuators/servo_pwm_trim.png and /dev/null differ diff --git a/docs/assets/config/actuators/trim_GS.png b/docs/assets/config/actuators/trim_GS.png deleted file mode 100644 index 1d1dcdc5b5..0000000000 Binary files a/docs/assets/config/actuators/trim_GS.png and /dev/null differ diff --git a/docs/en/config/actuators.md b/docs/en/config/actuators.md index 80e0f49488..49bc5e6f85 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. Do not use for PWM servos. - (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. @@ -538,18 +538,18 @@ If a high rate servo is _really_ needed, DShot offers better value. ##### 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_trim.png) +![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/trim_GS.png) + ![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 position. This is usually around `1500` for PWM servos (near the center of the servo range). -![Control Surface Trimming](../../assets/config/actuators/control_surface_trim.png) +![Control Surface Trimming](../../assets/config/actuators/pwm_center_output.png) 2. Gradualy increase the `Maximum` for each servo, while checking the deflection with the sliders or manual input with [`COM_PREARM_MODE`](../advanced_config/parameter_reference.md#COM_PREARM_MODE) parameter to `Always` until the desired deflection is reached. 3. Gradualy decrease the `Minimum` for each servo, until the desired deflection is reached. diff --git a/validation/module_schema.yaml b/validation/module_schema.yaml index 9dbd39c492..1f17bf5fb2 100644 --- a/validation/module_schema.yaml +++ b/validation/module_schema.yaml @@ -352,21 +352,21 @@ actuator_output: # ui only shows the param if this condition is true type: string regex: *condition_regex - trim: + center: type: dict schema: min: - # Minimum trim value + # Minimum center value type: integer min: 0 max: 65536 max: - # Maximum trim value + # Maximum center value type: integer min: 0 max: 65536 default: - # Default trim value + # Default center value type: integer min: 0 max: 65536