STorM32 Parameters: Difference between revisions

From STorM32-BGC Wiki
Jump to navigation Jump to search
No edit summary
Line 16: Line 16:


== PID Tab ==
== PID Tab ==
=== In Conventional Mode: ===


{{PARAMNAMEDEF|Pitch P}}, {{PARAMNAMEDEF|Roll P}}, {{PARAMNAMEDEF|Yaw P}}: <br> Proportional term of the PID controller for the pitch, roll or yaw axis, respectively. See also [[Tuning_Recipe#Tuning_Procedure|Tuning Recipe: Tuning Procedure]].
{{PARAMNAMEDEF|Pitch P}}, {{PARAMNAMEDEF|Roll P}}, {{PARAMNAMEDEF|Yaw P}}: <br> Proportional term of the PID controller for the pitch, roll or yaw axis, respectively. See also [[Tuning_Recipe#Tuning_Procedure|Tuning Recipe: Tuning Procedure]].
Line 24: Line 26:


{{PARAMNAMEDEF|Pitch Motor Vmax}}, {{PARAMNAMEDEF|Roll Motor Vmax}}, {{PARAMNAMEDEF|Yaw Motor Vmax}}: <br> Maximal average voltage for the pitch, roll or yaw motor, respectively. See also [[Tuning_Recipe#Setting_Motor_Vmax|Tuning Recipe: Setting Motor Vmax]].  
{{PARAMNAMEDEF|Pitch Motor Vmax}}, {{PARAMNAMEDEF|Roll Motor Vmax}}, {{PARAMNAMEDEF|Yaw Motor Vmax}}: <br> Maximal average voltage for the pitch, roll or yaw motor, respectively. See also [[Tuning_Recipe#Setting_Motor_Vmax|Tuning Recipe: Setting Motor Vmax]].  
=== In T-STorM32 Mode: ===
{{PARAMNAMEDEF|Foc Pitch P}}, {{PARAMNAMEDEF|Foc Roll P}}, {{PARAMNAMEDEF|Foc Yaw P}}: <br> Proportional term of the PID controller for the pitch, roll or yaw axis, respectively.
{{PARAMNAMEDEF|Foc Pitch I}}, {{PARAMNAMEDEF|Foc Roll I}}, {{PARAMNAMEDEF|Foc Yaw I}}: <br> Integral term of the PID controller for the pitch, roll or yaw axis, respectively.
{{PARAMNAMEDEF|Foc Pitch D}}, {{PARAMNAMEDEF|Foc Roll D}}, {{PARAMNAMEDEF|Foc Yaw D}}: <br> Derivative term of the PID controller for the pitch, roll or yaw axis, respectively.
{{PARAMNAMEDEF|Foc Pitch K}}, {{PARAMNAMEDEF|Foc Roll K}}, {{PARAMNAMEDEF|Foc Yaw K}}: <br> Factor which multiplies the P, I, and D values.
=== In All Modes: ===


{{PARAMNAMEDEF|Gyro LPF}}: <br> Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values.
{{PARAMNAMEDEF|Gyro LPF}}: <br> Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values.

Revision as of 11:29, 19 July 2017

descriptions refer to firmware v2.29e

List of all STorM32 parameters, and some GUI features, with brief explanations and/or links to more comprehensive articles.

Comment: Which parameters are displayed and enabled depends on whether the GUI is in "conventional" or "T-STorM32" mode. The currently active mode can be inferred from the GUI's title. The mode will be set correctly upon a connection to a STorM32 controller.

Dashboard Tab

[Change Name]:
Opens a dialog, which allows to change the name of the board.

[Share Settings]: Opens a dialog, which presents all parameters comprehensively. Taking a screen shot provides a useful method to share parameter settings.

PID Tab

In Conventional Mode:

Pitch P, Roll P, Yaw P:
Proportional term of the PID controller for the pitch, roll or yaw axis, respectively. See also Tuning Recipe: Tuning Procedure.

Pitch I, Roll I, Yaw I:
Integral term of the PID controller for the pitch, roll or yaw axis, respectively. See also Tuning Recipe: Tuning Procedure.

Pitch D, Roll D, Yaw D:
Derivative term of the PID controller for the pitch, roll or yaw axis, respectively. See also Tuning Recipe: Tuning Procedure.

Pitch Motor Vmax, Roll Motor Vmax, Yaw Motor Vmax:
Maximal average voltage for the pitch, roll or yaw motor, respectively. See also Tuning Recipe: Setting Motor Vmax.

In T-STorM32 Mode:

Foc Pitch P, Foc Roll P, Foc Yaw P:
Proportional term of the PID controller for the pitch, roll or yaw axis, respectively.

Foc Pitch I, Foc Roll I, Foc Yaw I:
Integral term of the PID controller for the pitch, roll or yaw axis, respectively.

Foc Pitch D, Foc Roll D, Foc Yaw D:
Derivative term of the PID controller for the pitch, roll or yaw axis, respectively.

Foc Pitch K, Foc Roll K, Foc Yaw K:
Factor which multiplies the P, I, and D values.

In All Modes:

Gyro LPF:
Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values.

Imu2 FeedForward LPF:
Digital low pass filter applied to the attitude data before it enters the feedforward channel in the PID controller. Effective only when Imu2 Configuration is not “off”.

Voltage Correction:
Attempts to compensate the effects of a (slowly) varying battery voltage on the PID controller tuning, see Advanced Functions: Voltage Correction.

Roll Yaw PD Mixing:
Mixes the Roll P and D values with the Yaw P and D values depending on the pitch angles.

[Use simplified PID tuning]:
Toggles between the standard PID tuning, in which the P, I D values are adjusted, and a simplified mechanism, in which tuning is achieved by only two parameters, called Damping and Stability.

[Auto write PID changes]:
When checked, any change to the PID values (and only to the PID values) is written to the STorM32 board after ca. 1 sec.

Pan Tab

The parameters in the [GUI:Pan] tab are comprehensively described in the article Hold versus pan Mode.

Pan Mode Control:
Selects the input channel.

Pan Mode Default Setting, Pan Mode Setting #1, Pan Mode Setting #2, Pan Mode Setting #3:
Selects the pan states for each axis, for each state of the input channel.

Pitch Pan, Roll Pan, Yaw Pan:
Sets the pan speed for pitch, roll or yaw, respectively.

Pitch Pan Deadband, Roll Pan Deadband, Yaw Pan Deadband:
Sets the pan deadband for pitch, roll or yaw, respectively.

Pitch Pan Expo, Roll Pan Expo, Yaw Pan Expo:
Sets the pan expo for pitch, roll or yaw, respectively.

Yaw Pan Deadband LPF:
Sets the pan deadband LPF for the yaw axis. Do not use together with deadband hysteresis.

Yaw Pan Deadband Hysteresis:
Sets the pan deadband hysteresis for the yaw axis. Do not use together with deadband LPF.

Rc Inputs Tab

The parameters in the [GUI:Rc Inputs] tab are comprehensively described in the article Configure the RC Input.

Rc Deadband:

Rc Hysteresis:

Rc Pitch Trim, Rc Roll Trim, Rc Yaw Trim:

Rc Pitch, Rc Roll, Rc Yaw:

Rc Pitch Mode, Rc Roll Mode, Rc Yaw Mode:

Rc Pitch Min, Rc Roll Min, Rc Yaw Min:

Rc Pitch Max, Rc Roll Max, Rc Yaw Max:

Rc Pitch Speed Limit, Rc Roll Speed Limit, Rc Yaw Speed Limit:

Rc Pitch Accel Limit, Rc Roll Accel Limit, Rc Yaw Accel Limit:

[Auto Trim]:

Functions Tab

Standby:
See Advanced Functions: Standby.

Re-center Camera:
See Advanced Functions: Re-center Camera.

IR Camera Control, Camera Model, IR Camera Setting #1, IR Camera Setting #2, Time Interval:
See Advanced Functions: IR Camera Remote Control.

Pwm Out Control, Pwm Out Mid, Pwm Out Min, Pwm Out Max, Pwm Out Speed Limit:
See Advanced Functions: Pwm Out.

Scripts Tab

The parameters in the [GUI:Scripts] tab are comprehensively described in the article STorM32 Scripts.

Setup Tab

Imu2 Configuration:
Selects how a 2nd IMU is used. See also Using a 2nd IMU.

Virtual Channel Configuration:
Selects the physical source for the “Virtual-1”, ..., “Virtual-16” input values. See Inputs and Functions for understanding the STorM32's concept of inputs, and Configure the RC Input: Wiring for SUM-PPM Signals and Configure the RC Input: Wiring for Digital Signals for typical use cases.

Pwm Out Configuration:
Enables the pwm out function, see Advanced Functions: Pwm Out.

Esp Configuration:
Enables the ESP8266 Wifi support, see Using a ESP8266 Wifi Module.

Pitch Motor Usage, Roll Motor Usage, Yaw Motor Usage:
Selects the operation mode of the pitch, roll, or yaw motor, respectively. When “disabled” is selected, the motor does not receive any power.

Startup Mode:
Selects the startup algorithm, can be set to “fast” for invoking fast leveling.

Startup Delay:
Sets a startup delay time.

Imu AHRS:
Adjusts how strongly the accelerometer data is included in the data fusing for the attitude estimation. The shorter the time the stronger the accelerometer data is weighted (0 = accelerometer only, 20 = gyro only).

Rc Pitch Offset, Rc Roll Offset, Rc Yaw Offset:
Adds a permanent offset to the camera orientation.

Low Voltage Limit:
Voltage level at which the lipo-saver function is triggered, see Advanced Functions: Lipo Saver.

Beep with Motors:
Enables the emission of beeps by the motors, see Advanced Functions: Beeps.

NT Logging:
Adjusts which parameters are logged, see NT Data Logging: GUI Settings.

Gimbal Configuration Tab

Imu Orientation, Imu2 Orientation:
Orientation number of the Imu1 or Imu2, respectively.

Pitch Motor Poles, Roll Motor Poles, Yaw Motor Poles:
Number of magnet poles of the pitch, roll or yaw motor, respectively.

Pitch Motor Direction, Roll Motor Direction, Yaw Motor Direction:
Rotation direction of the pitch, roll or yaw motor, respectively.

Pitch Startup Motor Pos, Roll Startup Motor Pos, Yaw Startup Motor Pos:
Orientation of the pitch, roll or yaw motor at power up, respectively.

Pitch Offset, Roll Offset, Yaw Offset:
Coefficients to correct for slight inaccuracies inthe calibration of the Imu1 accelerometer.

Expert Tool Window

Motor Mapping:
Allows to modify the assignment of the pitch, roll and yaw motors to the motor ports MOT0, MOT1, MOT2 from the default assignment (which is pitch = MOT0, roll = MOT1, yaw = MOT2).

Imu Mapping:
Allows to swap Imu1 and Imu2.

ADC Calibration:
Calibration constant for voltage measurement.

Imu3 Configuration:
Selects which IMU is used as 3rd IMU, see Evaluating Vibrations and Optimizing Damper Systems: 3rd IMU.

Imu3 Orientation:
Orientation of a 3rd IMU.

Uart1 Configuration:
Will probably be deprecated.

The following parameters affect the AHRS, and should be set with understanding. These posts might be useful: [1], [2], [3].

Acc Compensation Method:
Sets the algorithm which is used for fusing the accelerometer and gyro data. Can be “standard” or “advanced”.

Imu Acc Threshold:
Maximal residual acceleration up to which the accelerometer data are taken into account in the attitude estimation. This parameter is effective only when Acc Compensation Method is set to “standard”.

Acc Noise Level:
Residual acceleration up to which the accelerometer data are taken into account with maximal weight in the attitude estimation. Effective only when Acc Compensation Method = “advanced”.

Acc Threshold:
Maximal residual acceleration up to which the accelerometer data are taken into account in the attitude estimation with non-zero weight. Effective only when Acc Compensation Method = “advanced”.

Acc Vertical Weight:
Weight of the vertical residual acceleration in determining the weight of the accelerometer data in the attitude estimation. Effective only when Acc Compensation Method = “advanced”.

Acc Zentrifugal Correction:
Weight of the centrifugal acceleration in determining the weight of the accelerometer data in the attitude estimation. Effective only when Acc Compensation Method = “advanced”.

Acc Recover Time:
Fall time for recovering from a reduced weight of the accelerometer data in the attitude estimation. The rise time is determined implicitly by the Acc LPF parameter value. Effective only when Acc Compensation Method = “advanced”.

BetaCopter Tool Window

Mavlink Configuration, Mavlink System ID, Mavlink Component ID:
Parameters for handling Mavlink messages, see Advanced Functions: MAVLink.

Uavcan Configuration, Uavcan Node ID:
Parameters for handling Uavcan messages, see Advanced Functions: Uavcan.

STorM32Link Configuration, STorM32Link Wait Time:
Parameters for handling the STorM32 Link, see Advanced Functions: STorM32 Link.