STorM32 Parameters: Difference between revisions
(147 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
<span style="font-size:88%">''The information on this page refers to firmware v2.67e.''</span> | |||
List of all STorM32 parameters, and some GUI features, with brief explanations and/or links to more comprehensive articles. | List of all STorM32 parameters, and some GUI features, with brief explanations and/or links to more comprehensive articles. | ||
{{COMMENT|The parameters are displayed and enabled in the GUI depending on whether the STorM32 gimbal is in "'''Conventional Mode'''" or "'''T-STorM32 Mode'''". The active mode can be inferred from the GUI's title, and is updated to the correct current mode upon a connection to a STorM32 controller.}} | |||
<div class="toclimit-2">__TOC__</div> | <div class="toclimit-2">__TOC__</div> | ||
Line 6: | Line 10: | ||
{{GUIFIELD|Change Name}}:<br> | {{GUIFIELD|Change Name}}:<br> | ||
Opens a dialog, which allows to change the name of the board. | Opens a dialog, which allows us to change the name of the board. | ||
{{GUIFIELD|Share Settings}}:<br> | |||
Opens a dialog, which presents all parameters comprehensively. Taking a screen shot by pressing one of the "Save Screenshot" buttons provides a useful method for sharing parameter settings. | |||
{{GUIFIELD| | {{GUIFIELD|Check for Updates}}:<br> | ||
Opens a dialog, which | Opens a dialog, which connects to the STorM32 github repository to check if a new firmware is available. | ||
== PID Tab == | == PID Tab == | ||
{{PARAMNAME|Pitch P}}, {{ | === In Conventional Mode: === | ||
{{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. Values relate to the time constant of the filter. | |||
{{PARAMNAMEDEF|Imu2 FeedForward LPF}}: <br> Digital low pass filter applied to the attitude data of the 2nd IMU before it enters the feedforward channel in the PID controller. Effective only when the 2nd IMU is enabled, i.e., when {{PARAMNAME|Imu2 Configuration}} is not {{PARAMVALUE|off}}. Values relate to the time constant of the filter. | |||
{{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 I}}, {{PARAMNAMEDEF|Roll I}}, {{PARAMNAMEDEF|Yaw I}}: <br> Integral 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 D}}, {{PARAMNAMEDEF|Roll D}}, {{PARAMNAMEDEF|Yaw D}}: <br> Derivative 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 Motor Vmax}}, {{PARAMNAMEDEF|Roll Motor Vmax}}, {{PARAMNAMEDEF|Yaw Motor Vmax}}: <br> Maximal average voltage for the pitch, roll or yaw motor, respectively. Range is 0 - 255. See also [[Tuning_Recipe#Setting_Motor_Vmax|Tuning Recipe: Setting Motor Vmax]]. | |||
{{PARAMNAMEDEF|Voltage Correction}}: <br> Attempts to compensate the effects of a (slowly) varying battery voltage on the PID controller tuning, see [[Advanced_Functions#Voltage_Correction|Advanced Functions: Voltage Correction]]. | |||
{{PARAMNAMEDEF|Controller}}: <br> Enables the model-based controller. The settings {{PARAMVALUE|default}} and {{PARAMVALUE|roll mixing}} are available, where the first corresponds to the "old" behavior, and the second enables improved roll mixing. | |||
{{GUIFIELD|Use simplified PID tuning}}: <br> 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. | |||
=== In T-STorM32 Mode: === | |||
{{ | {{PARAMNAMEDEF|Foc Gyro LPF}}: <br> Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values. Values relate to the time constant of the filter. | ||
{{ | {{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. | ||
{{ | {{PARAMNAMEDEF|Foc Controller}}: <br> Enables the model-based controller. The setting {{PARAMVALUE|default}} corresponds to the "old" behavior. | ||
=== All Modes: === | |||
{{ | {{PARAMNAMEDEF|D Source}}: <br> The settings “default” and “gyro” are available. "gyro" enables the "new" lag-free and lower-noise controller D-term calculation. This setting is enabled per default. "default" enables the "old" method of D-term calculation. This parameter may be removed in upcoming firmwares. | ||
{{GUIFIELD|Auto write PID changes}}:<br> | {{GUIFIELD|Auto write PID changes}}:<br> | ||
Line 39: | Line 65: | ||
The parameters in the {{GUI|Pan}} tab are comprehensively described in the article [[Hold_versus_Pan_Mode|Hold versus pan Mode]]. | The parameters in the {{GUI|Pan}} tab are comprehensively described in the article [[Hold_versus_Pan_Mode|Hold versus pan Mode]]. | ||
{{ | {{PARAMNAMEDEF|Pan Mode Control}}: <br> Selects the input channel used for changing the pan mode. | ||
{{ | {{PARAMNAMEDEF|Pan Mode Default Setting}}, {{PARAMNAMEDEF|Pan Mode Setting #1}}, {{PARAMNAMEDEF|Pan Mode Setting #2}}, {{PARAMNAMEDEF|Pan Mode Setting #3}}: <br> | ||
Selects the pan states for each axis, for each of the four possible states of the input channel. | |||
{{ | {{PARAMNAMEDEF|Pitch Pan}}, {{PARAMNAMEDEF|Roll Pan}}, {{PARAMNAMEDEF|Yaw Pan}}: <br> | ||
Sets the pan speed for pitch, roll and yaw, respectively. | |||
{{ | {{PARAMNAMEDEF|Pitch Pan Deadband}}, {{PARAMNAMEDEF|Roll Pan Deadband}}, {{PARAMNAMEDEF|Yaw Pan Deadband}}:<br> | ||
Sets the pan deadband for pitch, roll and yaw, respectively. | |||
{{ | {{PARAMNAMEDEF|Pitch Pan Expo}}, {{PARAMNAMEDEF|Roll Pan Expo}}, {{PARAMNAMEDEF|Yaw Pan Expo}}: <br> | ||
Sets the pan expo for pitch, roll and yaw, respectively. | |||
{{ | {{PARAMNAMEDEF|Pitch Pan Method}}, {{PARAMNAMEDEF|Roll Pan Method}}: <br> | ||
Sets the pan method for pitch and roll, respectively. Can be "normal" or "plane". | |||
{{ | {{PARAMNAMEDEF|Yaw Pan Deadband LPF}}: <br> | ||
Sets the pan deadband low-pass filter for the yaw axis. | |||
== Rc Inputs Tab == | == Rc Inputs Tab == | ||
Line 59: | Line 89: | ||
The parameters in the {{GUI|Rc Inputs}} tab are comprehensively described in the article [[Configure_the_RC_Input|Configure the RC Input]]. | The parameters in the {{GUI|Rc Inputs}} tab are comprehensively described in the article [[Configure_the_RC_Input|Configure the RC Input]]. | ||
{{ | {{PARAMNAMEDEF|Rc Dead Band}}: <br> Sets a deadband around zero input, to suppress noise on the input. Effective for all three axes. | ||
{{PARAMNAMEDEF|Rc Hysteresis}}: <br> Sets a hysteresis to value changes, to suppress noise on the input. Effective for all three axes. | |||
{{ | {{PARAMNAMEDEF|Rc Pitch Trim}}, {{PARAMNAMEDEF|Rc Roll Trim}}, {{PARAMNAMEDEF|Rc Yaw Trim}}: <br> Sets the mid position for teh pitch, roll and yaw axis, respectively. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch}}, {{PARAMNAMEDEF|Rc Roll}}, {{PARAMNAMEDEF|Rc Yaw}}: <br> Selects the input channel used for controlling the pitch, roll, and yaw axis, respectively. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Mode}}, {{PARAMNAMEDEF|Rc Roll Mode}}, {{PARAMNAMEDEF|Rc Yaw Mode}}: <br> Sets the mode for the pitch, roll, and yaw axis, respectively. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Min}}, {{PARAMNAMEDEF|Rc Roll Min}}, {{PARAMNAMEDEF|Rc Yaw Min}}: <br> Sets the minimum angle for the pitch, roll, and yaw axis, respectively. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Max}}, {{PARAMNAMEDEF|Rc Roll Max}}, {{PARAMNAMEDEF|Rc Yaw Max}}: <br> Sets the maximum angle for the pitch, roll, and yaw axis, respectively. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Speed Limit}}, {{PARAMNAMEDEF|Rc Roll Speed Limit}}, {{PARAMNAMEDEF|Rc Yaw Speed Limit}}: <br> Sets the maximum speed for the pitch, roll, and yaw axis, respectively. A value of 0 disables the speed limiter (it is not fully deactivated, the speed limit is set to 100 deg/s). | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Accel Limit}}, {{PARAMNAMEDEF|Rc Roll Accel Limit}}, {{PARAMNAMEDEF|Rc Yaw Accel Limit}}: <br> Sets the maximum acceleration for the pitch, roll, and yaw axis, respectively. A value of 0 disables the acceleration limiter (it is not fully deactivated, a small limit remains). | ||
{{ | {{GUIFIELD|Auto Trim}}:<br> Reads the current input values and adjusts the trim values such as to make them zero. | ||
== Functions Tab == | == Functions Tab == | ||
{{ | {{PARAMNAMEDEF|Standby}}: <br> See [[Advanced_Functions#Standby|Advanced Functions: Standby]]. | ||
{{ | {{PARAMNAMEDEF|Re-center Camera}}, {{PARAMNAMEDEF|Re-center Camera Axes}}: <br> See [[Advanced_Functions#Re-center_Camera|Advanced Functions: Re-center Camera]]. | ||
{{ | {{PARAMNAMEDEF|Camera Control}}, {{PARAMNAMEDEF|Camera Control2}}, {{PARAMNAMEDEF|Camera Model}}, {{PARAMNAMEDEF|Camera Control Mode}}, {{PARAMNAMEDEF|Time Interval}}, {{PARAMNAMEDEF|Camera ComPort}}: <br> See [[Advanced_Functions#Camera_Remote_Control|Advanced Functions: Camera Remote Control]]. | ||
{{ | {{PARAMNAMEDEF|Pwm Out Control}}, {{PARAMNAMEDEF|Pwm Out Mid}}, {{PARAMNAMEDEF|Pwm Out Min}}, {{PARAMNAMEDEF|Pwm Out Max}}, {{PARAMNAMEDEF|Pwm Out Speed Limit}}: <br> See [[Advanced_Functions#Pwm_Out|Advanced Functions: Pwm Out]]. | ||
== Scripts Tab == | == Scripts Tab == | ||
Line 93: | Line 125: | ||
== Setup Tab == | == Setup Tab == | ||
{{ | === In Conventional Mode: === | ||
{{PARAMNAMEDEF|Imu2 Configuration}}: <br> | |||
Selects how a 2nd IMU is used. See also [[Using a 2nd IMU]]. | Selects how a 2nd IMU is used. See also [[Using a 2nd IMU]]. | ||
{{ | {{PARAMNAMEDEF|Startup Mode}}: <br> | ||
Selects the startup algorithm. Can be set to {{PARAMVALUE|fast}} for invoking fast startup. For fast startup to be activated, additional conditions have to be met: IMU2 must be present, the motor directions and positions must have been configured, and IMU1 and IMU2 must have be calibrated. The gimbal should also have been tuned. | |||
=== All Modes: === | |||
{{PARAMNAMEDEF|Startup Delay}}: <br> | |||
Sets a startup delay time. | |||
{{PARAMNAMEDEF|Prearm Checks}}: <br> | |||
Bitmask to enable various pre-arming checks, i.e., conditions which need to be fulfilled before the STroM32 goes into NORMAL mode. | |||
{{PARAMNAMEDEF|Virtual Channel Configuration}}: <br> | |||
Selects the physical source for the {{PARAMVALUE|Virtual-1}}, ..., {{PARAMVALUE|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|Configure the RC Input: Wiring for SUM-PPM Signals]] and [[Configure_the_RC_Input#Wiring_for_Digital_Signals|Configure the RC Input: Wiring for Digital Signals]] for typical use cases. | Selects the physical source for the {{PARAMVALUE|Virtual-1}}, ..., {{PARAMVALUE|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|Configure the RC Input: Wiring for SUM-PPM Signals]] and [[Configure_the_RC_Input#Wiring_for_Digital_Signals|Configure the RC Input: Wiring for Digital Signals]] for typical use cases. | ||
{{ | {{PARAMNAMEDEF|Pwm Out Configuration}}: <br> | ||
Enables the pwm out function, see [[Advanced_Functions#Pwm_Out|Advanced Functions: Pwm Out]]. | Enables the pwm out function, see [[Advanced_Functions#Pwm_Out|Advanced Functions: Pwm Out]]. | ||
{{ | {{PARAMNAMEDEF|Rc Pitch Offset}}, {{PARAMNAMEDEF|Rc Roll Offset}}, {{PARAMNAMEDEF|Rc Yaw Offset}}: <br> | ||
Adds a permanent offset to the camera orientation. | |||
{{PARAMNAMEDEF|UartX Configuration}}: <br> | |||
Reconfigures the RC-0, RC-1 pins to work as UART, depending on the setting. Allows to enable the OLed display support on pin RC-1 (see [[Advanced_Functions#OLED_Display|Advanced Functions: OLED Display]]) or enables the UartX serial for the [[NT_Camera|NT Camera]]. | |||
{{ | {{PARAMNAMEDEF|Low Voltage Limit}}: <br> Voltage level at which the lipo-saver function is triggered, see [[Advanced_Functions#Lipo_Saver|Advanced Functions: Lipo Saver]]. | ||
{{ | {{PARAMNAMEDEF|Beep with Motors}}: <br> | ||
Enables the emission of beeps by the motors, see [[Advanced_Functions#Beeps|Advanced Functions: Beeps]]. | |||
{{ | {{PARAMNAMEDEF|NT Logging}}:<br> | ||
Adjusts which parameters are logged, see [[NT_Data_Logging#GUI_Settings|NT Data Logging: GUI Settings]]. | |||
{{ | {{PARAMNAMEDEF|Pitch Motor Usage}}, {{PARAMNAMEDEF|Roll Motor Usage}}, {{PARAMNAMEDEF|Yaw Motor Usage}}: <br> | ||
Selects the operation mode of the pitch, roll, or yaw motor, respectively. When {{PARAMVALUE|disabled}} is selected, the motor does not receive any power. | |||
== Gimbal Configuration Tab == | == Gimbal Configuration Tab == | ||
=== In Conventional Mode: === | |||
{{ | {{PARAMNAMEDEF|Pitch Motor Poles}}, {{PARAMNAMEDEF|Roll Motor Poles}}, {{PARAMNAMEDEF|Yaw Motor Poles}}:<br> | ||
Number of magnet poles of the pitch, roll or yaw motor, respectively. | Number of magnet poles of the pitch, roll or yaw motor, respectively. Range is 8 - 42. | ||
{{ | {{PARAMNAMEDEF|Pitch Motor Direction}}, {{PARAMNAMEDEF|Roll Motor Direction}}, {{PARAMNAMEDEF|Yaw Motor Direction}}:<br> | ||
Rotation direction of the pitch, roll or yaw motor, respectively. | Rotation direction of the pitch, roll or yaw motor, respectively. | ||
{{ | {{PARAMNAMEDEF|Pitch Startup Motor Pos}}, {{PARAMNAMEDEF|Roll Startup Motor Pos}}, {{PARAMNAMEDEF|Yaw Startup Motor Pos}}:<br> | ||
Orientation of the pitch, roll or yaw motor at power up, respectively. | Orientation of the pitch, roll or yaw motor at power up, respectively. | ||
{{ | === In T-STorM32 Mode: === | ||
Coefficients to correct for slight inaccuracies | |||
{{PARAMNAMEDEF|Foc Pitch Motor Direction}}, {{PARAMNAMEDEF|Foc Roll Motor Direction}}, {{PARAMNAMEDEF|Foc Yaw Motor Direction}}:<br> | |||
Rotation direction of the pitch, roll or yaw motor, respectively. | |||
{{PARAMNAMEDEF|Foc Pitch Zero Pos}}, {{PARAMNAMEDEF|Foc Roll Zero Pos}}, {{PARAMNAMEDEF|Foc Yaw Zero Pos}}:<br> | |||
Motor position at zero Imu angle for the pitch, roll or yaw axis, respectively. | |||
=== All Modes: === | |||
{{PARAMNAMEDEF|Imu Orientation}}, {{PARAMNAMEDEF|Imu2 Orientation}}:<br> | |||
Orientation number of the IMU1 or IMU2, respectively. | |||
{{PARAMNAMEDEF|Pitch Offset}}, {{PARAMNAMEDEF|Roll Offset}}, {{PARAMNAMEDEF|Yaw Offset}}:<br> | |||
Coefficients to correct for slight inaccuracies in the calibration of the IMU1 accelerometer. | |||
== Interfaces Tool Window == | |||
{{PARAMNAMEDEF|Mavlink Gimbal}}, {{PARAMNAMEDEF|Mavlink Gimbal Stream}}, {{PARAMNAMEDEF|Mavlink ComPort}}, {{PARAMNAMEDEF|Mavlink System ID}}, {{PARAMNAMEDEF|Mavlink Camera}}:<br> | |||
Parameters for handling Mavlink messages, see [[MAVLink Communication]]. | |||
{{PARAMNAMEDEF|STorM32Link Configuration}}<!--, {{PARAMNAMEDEF|STorM32Link AHRS Factor}}-->:<br> | |||
Parameters for handling the [[STorM32-Link|STorM32 Link]]. The setting {{PARAMNAMEDEF|STorM32Link Configuration}} = {{PARAMVALUE|yaw drift comp.}} enables the yaw drift compensation, but not horizon drift compensation. The setting {{PARAMNAMEDEF|STorM32Link Configuration}} = {{PARAMVALUE|v1}} enables both the yaw drift compensation and horizon drift compensation. For further info on the STorM32-Link see the article [[STorM32-Link]]. | |||
{{PARAMNAMEDEF|Uart Baudrate}}, {{PARAMNAMEDEF|Uart2 Baudrate}}, {{PARAMNAMEDEF|Usb Baudrate}}:<br> | |||
Baudrates used for the UART, USB, and UART2 ports. The default baudrates are 115200 bps. | |||
== Expert Tool Window == | == Expert Tool Window == | ||
{{ | === In Conventional Mode: === | ||
Allows to | |||
{{PARAMNAMEDEF|Motor Mapping}}:<br> | |||
Allows us to change the assignment of the pitch, roll and yaw motors to the ports MOT0, MOT1, MOT2. The default assignment is pitch = MOT0, roll = MOT1, yaw = MOT2. | |||
{{PARAMNAMEDEF|Imu2 Rotation}}: <br> | |||
Allows us to configure for different mounting options of the 2nd IMU. See also [[Using a 2nd IMU]]. | |||
{{PARAMNAMEDEF|Flip Gimbal Control}}: <br> | |||
Allows us to use an input signal to switch the configuration of the gimbal between "down-hanging" and "up-standing". | |||
=== All Modes: === | |||
{{PARAMNAMEDEF|Imu Mapping}}: <br> | |||
Allows us to swap IMU1 and IMU2 (this swaps NT IMU1 and NT IMU2, not the on-board IMU, which always will be IMU2 if used) . | |||
{{PARAMNAMEDEF|Lipo Cells}}: <br> | |||
Sets the number of cells of the battery. Default is {{PARAMVALUE|auto}}, which determines the number of cells from the battery voltage at power up. | |||
{{PARAMNAMEDEF|Lipo Voltage per Cell}}: <br> | |||
Full charge voltage of a battery cell. Default is 4.20 V, appropriate for a LIPO. | |||
{{PARAMNAMEDEF|ADC Calibration}}: <br> | |||
Calibration constant for voltage measurement. The default value {{PARAMVALUE|1550}} is slightly below the theoretically correct value of 1581. | |||
{{PARAMNAMEDEF|Imu AHRS}}: <br> | |||
Adjusts how strongly the accelerometer data are included in the data fusing for the attitude estimation. The shorter the time the stronger the accelerometer data are weighted (0 = accelerometer only, 20 = gyro only). | |||
{{PARAMNAMEDEF|Startup Gyro Calibration}}: <br> | |||
Sets the gyro calibration at startup. Default is {{PARAMVALUE|normal}}. | |||
==== The following parameters should be set with care. Normally, there should be no reason to modify them. ==== | |||
{{ | {{PARAMNAMEDEF|Acc LPF}}: <br> | ||
Digital low pass filter applied to the raw accelerometer data. It also affects the behavior of the AHRS. | |||
{{ | {{PARAMNAMEDEF|Rc Adc LPF}}: <br> | ||
Digital low pass filter applied to the Rc Input values. Might be helpful for very noisy RC transmitters. | |||
{{ | {{PARAMNAMEDEF|Pan Hold Transition Time}}, {{PARAMNAMEDEF|Pan Speed Limit}}, {{PARAMNAMEDEF|Pan Accel Limit}}: <br> | ||
These parameters are related to the pan-to-hold and hold-to-pan transition behavior. The parameter {{PARAMNAMEDEF|Pan Hold Transition Time}} determines for how long a trajectory filter is applied to smooth the transition. The two limit parameters determine the speed and acceleration limits of the trajectory filter. | |||
{{PARAMNAMEDEF|Foc Emergency}}: <br> | |||
Sets the level of the emergency detection mechanism. | |||
{{PARAMNAMEDEF|Acc Compensation Method}}:<br> | |||
Selects the algorithm which is used for fusing the accelerometer and gyro data. Can be {{PARAMVALUE|standard}} or {{PARAMVALUE|advanced}}. The parameter affects the AHRS, and should be set with understanding. These posts might be useful: [http://www.rcgroups.com/forums/showthread.php?t=2055844&page=27&pp=50#post29173129], [http://www.rcgroups.com/forums/showthread.php?t=2055844&page=27&pp=50#post29176384], [http://www.rcgroups.com/forums/showthread.php?t=2055844&page=27&pp=50#post29176832]. | |||
== Gimbal Model Tool Window == | |||
The parameters in the {{GUI|Gimbal Model}} tab are comprehensively described in the article [[Model-based_Control|Model-based Control]]. | |||
=== In T-STorM32 Mode: === | |||
{{PARAMNAMEDEF|T1 Pitch}}, {{PARAMNAMEDEF|T1 Roll}}, {{PARAMNAMEDEF|T1 Yaw}}:<br> | |||
Relative moments of inertia of the camera along the pitch, roll and yaw directions. | |||
{{PARAMNAMEDEF|T2 Roll}}, {{PARAMNAMEDEF|T2 Yaw}}:<br> | |||
Relative moments of inertia of the roll arm along the roll and yaw directions. | |||
== Servo Tool Window == | |||
=== In T-STorM32 Mode: === | |||
{{PARAMNAMEDEF|Servo Pitch P}}, {{PARAMNAMEDEF|Servo Pitch I}}, {{PARAMNAMEDEF|Servo Pitch D}}, {{PARAMNAMEDEF|Servo Pitch DLPF}}:<br> | |||
Parameters for the position PID controller in servo mode for the pitch axis. | |||
{{PARAMNAMEDEF|Servo Roll P}}, {{PARAMNAMEDEF|Servo Roll I}}, {{PARAMNAMEDEF|Servo Roll D}}, {{PARAMNAMEDEF|Servo Roll DLPF}}:<br> | |||
Parameters for the position PID controller in servo mode for the roll axis. | |||
{{PARAMNAMEDEF|Servo Yaw P}}, {{PARAMNAMEDEF|Servo Yaw I}}, {{PARAMNAMEDEF|Servo Yaw D}}, {{PARAMNAMEDEF|Servo Yaw DLPF}}:<br> | |||
Parameters for the position PID controller in servo mode for the yaw axis. | |||
<!-- | |||
{{PARAMNAMEDEF|Imu Acc Threshold}}:<br> | |||
Maximal residual acceleration up to which the accelerometer data are taken into account in the attitude estimation. This parameter is effective only when {{PARAMNAME|Acc Compensation Method}} is set to {{PARAMVALUE|standard}}. | |||
{{PARAMNAMEDEF|Acc Noise Level}}:<br> | |||
Residual acceleration up to which the accelerometer data are taken into account with maximal weight in the attitude estimation. Effective only when {{PARAMNAME|Acc Compensation Method}} = {{PARAMVALUE|advanced}}. | |||
{{PARAMNAMEDEF|Acc Threshold}}:<br> | |||
Maximal residual acceleration up to which the accelerometer data are taken into account in the attitude estimation with non-zero weight. Effective only when {{PARAMNAME|Acc Compensation Method}} = {{PARAMVALUE|advanced}}. | |||
{{ | {{PARAMNAMEDEF|Acc Vertical Weight}}:<br> | ||
Weight of the vertical residual acceleration in determining the weight of the accelerometer data in the attitude estimation. Effective only when {{PARAMNAME|Acc Compensation Method}} = {{PARAMVALUE|advanced}}. | |||
{{ | {{PARAMNAMEDEF|Acc Zentrifugal Correction}}:<br> | ||
Weight of the centrifugal acceleration in determining the weight of the accelerometer data in the attitude estimation. Effective only when {{PARAMNAME|Acc Compensation Method}} = {{PARAMVALUE|advanced}}. | |||
{{ | {{PARAMNAMEDEF|Acc Recover Time}}:<br> | ||
Fall time for recovering from a reduced weight of the accelerometer data in the attitude estimation. The rise time is determined implicitly by the {{PARAMNAME|Acc LPF}} parameter value. Effective only when {{PARAMNAME|Acc Compensation Method}} = {{PARAMVALUE|advanced}}. | |||
--> |
Latest revision as of 09:28, 16 October 2023
The information on this page refers to firmware v2.67e.
List of all STorM32 parameters, and some GUI features, with brief explanations and/or links to more comprehensive articles.
Comment: The parameters are displayed and enabled in the GUI depending on whether the STorM32 gimbal is in "Conventional Mode" or "T-STorM32 Mode". The active mode can be inferred from the GUI's title, and is updated to the correct current mode upon a connection to a STorM32 controller.
Dashboard Tab
[Change Name]:
Opens a dialog, which allows us to change the name of the board.
[Share Settings]:
Opens a dialog, which presents all parameters comprehensively. Taking a screen shot by pressing one of the "Save Screenshot" buttons provides a useful method for sharing parameter settings.
[Check for Updates]:
Opens a dialog, which connects to the STorM32 github repository to check if a new firmware is available.
PID Tab
In Conventional Mode:
Gyro LPF:
Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values. Values relate to the time constant of the filter.
Imu2 FeedForward LPF:
Digital low pass filter applied to the attitude data of the 2nd IMU before it enters the feedforward channel in the PID controller. Effective only when the 2nd IMU is enabled, i.e., when Imu2 Configuration is not “off”. Values relate to the time constant of the filter.
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. Range is 0 - 255. See also Tuning Recipe: Setting Motor Vmax.
Voltage Correction:
Attempts to compensate the effects of a (slowly) varying battery voltage on the PID controller tuning, see Advanced Functions: Voltage Correction.
Controller:
Enables the model-based controller. The settings “default” and “roll mixing” are available, where the first corresponds to the "old" behavior, and the second enables improved roll mixing.
[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.
In T-STorM32 Mode:
Foc Gyro LPF:
Digital low pass filter applied to the raw gyro data. Can help to avoid vibrations and/or reach higher PID values. Values relate to the time constant of the filter.
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.
Foc Controller:
Enables the model-based controller. The setting “default” corresponds to the "old" behavior.
All Modes:
D Source:
The settings “default” and “gyro” are available. "gyro" enables the "new" lag-free and lower-noise controller D-term calculation. This setting is enabled per default. "default" enables the "old" method of D-term calculation. This parameter may be removed in upcoming firmwares.
[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 used for changing the pan mode.
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 of the four possible states of the input channel.
Pitch Pan, Roll Pan, Yaw Pan:
Sets the pan speed for pitch, roll and yaw, respectively.
Pitch Pan Deadband, Roll Pan Deadband, Yaw Pan Deadband:
Sets the pan deadband for pitch, roll and yaw, respectively.
Pitch Pan Expo, Roll Pan Expo, Yaw Pan Expo:
Sets the pan expo for pitch, roll and yaw, respectively.
Pitch Pan Method, Roll Pan Method:
Sets the pan method for pitch and roll, respectively. Can be "normal" or "plane".
Yaw Pan Deadband LPF:
Sets the pan deadband low-pass filter for the yaw axis.
Rc Inputs Tab
The parameters in the [GUI:Rc Inputs] tab are comprehensively described in the article Configure the RC Input.
Rc Dead Band:
Sets a deadband around zero input, to suppress noise on the input. Effective for all three axes.
Rc Hysteresis:
Sets a hysteresis to value changes, to suppress noise on the input. Effective for all three axes.
Rc Pitch Trim, Rc Roll Trim, Rc Yaw Trim:
Sets the mid position for teh pitch, roll and yaw axis, respectively.
Rc Pitch, Rc Roll, Rc Yaw:
Selects the input channel used for controlling the pitch, roll, and yaw axis, respectively.
Rc Pitch Mode, Rc Roll Mode, Rc Yaw Mode:
Sets the mode for the pitch, roll, and yaw axis, respectively.
Rc Pitch Min, Rc Roll Min, Rc Yaw Min:
Sets the minimum angle for the pitch, roll, and yaw axis, respectively.
Rc Pitch Max, Rc Roll Max, Rc Yaw Max:
Sets the maximum angle for the pitch, roll, and yaw axis, respectively.
Rc Pitch Speed Limit, Rc Roll Speed Limit, Rc Yaw Speed Limit:
Sets the maximum speed for the pitch, roll, and yaw axis, respectively. A value of 0 disables the speed limiter (it is not fully deactivated, the speed limit is set to 100 deg/s).
Rc Pitch Accel Limit, Rc Roll Accel Limit, Rc Yaw Accel Limit:
Sets the maximum acceleration for the pitch, roll, and yaw axis, respectively. A value of 0 disables the acceleration limiter (it is not fully deactivated, a small limit remains).
[Auto Trim]:
Reads the current input values and adjusts the trim values such as to make them zero.
Functions Tab
Standby:
See Advanced Functions: Standby.
Re-center Camera, Re-center Camera Axes:
See Advanced Functions: Re-center Camera.
Camera Control, Camera Control2, Camera Model, Camera Control Mode, Time Interval, Camera ComPort:
See Advanced Functions: 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
In Conventional Mode:
Imu2 Configuration:
Selects how a 2nd IMU is used. See also Using a 2nd IMU.
Startup Mode:
Selects the startup algorithm. Can be set to “fast” for invoking fast startup. For fast startup to be activated, additional conditions have to be met: IMU2 must be present, the motor directions and positions must have been configured, and IMU1 and IMU2 must have be calibrated. The gimbal should also have been tuned.
All Modes:
Startup Delay:
Sets a startup delay time.
Prearm Checks:
Bitmask to enable various pre-arming checks, i.e., conditions which need to be fulfilled before the STroM32 goes into NORMAL mode.
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.
Rc Pitch Offset, Rc Roll Offset, Rc Yaw Offset:
Adds a permanent offset to the camera orientation.
UartX Configuration:
Reconfigures the RC-0, RC-1 pins to work as UART, depending on the setting. Allows to enable the OLed display support on pin RC-1 (see Advanced Functions: OLED Display) or enables the UartX serial for the NT Camera.
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.
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.
Gimbal Configuration Tab
In Conventional Mode:
Pitch Motor Poles, Roll Motor Poles, Yaw Motor Poles:
Number of magnet poles of the pitch, roll or yaw motor, respectively. Range is 8 - 42.
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.
In T-STorM32 Mode:
Foc Pitch Motor Direction, Foc Roll Motor Direction, Foc Yaw Motor Direction:
Rotation direction of the pitch, roll or yaw motor, respectively.
Foc Pitch Zero Pos, Foc Roll Zero Pos, Foc Yaw Zero Pos:
Motor position at zero Imu angle for the pitch, roll or yaw axis, respectively.
All Modes:
Imu Orientation, Imu2 Orientation:
Orientation number of the IMU1 or IMU2, respectively.
Pitch Offset, Roll Offset, Yaw Offset:
Coefficients to correct for slight inaccuracies in the calibration of the IMU1 accelerometer.
Interfaces Tool Window
Mavlink Gimbal, Mavlink Gimbal Stream, Mavlink ComPort, Mavlink System ID, Mavlink Camera:
Parameters for handling Mavlink messages, see MAVLink Communication.
STorM32Link Configuration:
Parameters for handling the STorM32 Link. The setting STorM32Link Configuration = “yaw drift comp.” enables the yaw drift compensation, but not horizon drift compensation. The setting STorM32Link Configuration = “v1” enables both the yaw drift compensation and horizon drift compensation. For further info on the STorM32-Link see the article STorM32-Link.
Uart Baudrate, Uart2 Baudrate, Usb Baudrate:
Baudrates used for the UART, USB, and UART2 ports. The default baudrates are 115200 bps.
Expert Tool Window
In Conventional Mode:
Motor Mapping:
Allows us to change the assignment of the pitch, roll and yaw motors to the ports MOT0, MOT1, MOT2. The default assignment is pitch = MOT0, roll = MOT1, yaw = MOT2.
Imu2 Rotation:
Allows us to configure for different mounting options of the 2nd IMU. See also Using a 2nd IMU.
Flip Gimbal Control:
Allows us to use an input signal to switch the configuration of the gimbal between "down-hanging" and "up-standing".
All Modes:
Imu Mapping:
Allows us to swap IMU1 and IMU2 (this swaps NT IMU1 and NT IMU2, not the on-board IMU, which always will be IMU2 if used) .
Lipo Cells:
Sets the number of cells of the battery. Default is “auto”, which determines the number of cells from the battery voltage at power up.
Lipo Voltage per Cell:
Full charge voltage of a battery cell. Default is 4.20 V, appropriate for a LIPO.
ADC Calibration:
Calibration constant for voltage measurement. The default value “1550” is slightly below the theoretically correct value of 1581.
Imu AHRS:
Adjusts how strongly the accelerometer data are included in the data fusing for the attitude estimation. The shorter the time the stronger the accelerometer data are weighted (0 = accelerometer only, 20 = gyro only).
Startup Gyro Calibration:
Sets the gyro calibration at startup. Default is “normal”.
The following parameters should be set with care. Normally, there should be no reason to modify them.
Acc LPF:
Digital low pass filter applied to the raw accelerometer data. It also affects the behavior of the AHRS.
Rc Adc LPF:
Digital low pass filter applied to the Rc Input values. Might be helpful for very noisy RC transmitters.
Pan Hold Transition Time, Pan Speed Limit, Pan Accel Limit:
These parameters are related to the pan-to-hold and hold-to-pan transition behavior. The parameter Pan Hold Transition Time determines for how long a trajectory filter is applied to smooth the transition. The two limit parameters determine the speed and acceleration limits of the trajectory filter.
Foc Emergency:
Sets the level of the emergency detection mechanism.
Acc Compensation Method:
Selects the algorithm which is used for fusing the accelerometer and gyro data. Can be “standard” or “advanced”. The parameter affects the AHRS, and should be set with understanding. These posts might be useful: [1], [2], [3].
Gimbal Model Tool Window
The parameters in the [GUI:Gimbal Model] tab are comprehensively described in the article Model-based Control.
In T-STorM32 Mode:
T1 Pitch, T1 Roll, T1 Yaw:
Relative moments of inertia of the camera along the pitch, roll and yaw directions.
T2 Roll, T2 Yaw:
Relative moments of inertia of the roll arm along the roll and yaw directions.
Servo Tool Window
In T-STorM32 Mode:
Servo Pitch P, Servo Pitch I, Servo Pitch D, Servo Pitch DLPF:
Parameters for the position PID controller in servo mode for the pitch axis.
Servo Roll P, Servo Roll I, Servo Roll D, Servo Roll DLPF:
Parameters for the position PID controller in servo mode for the roll axis.
Servo Yaw P, Servo Yaw I, Servo Yaw D, Servo Yaw DLPF:
Parameters for the position PID controller in servo mode for the yaw axis.