Quick Start Guide: Difference between revisions

From STorM32-BGC Wiki V1
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
Below I (OlliW) will briefly list the steps which are required to correctly set up the STorM32-BGC, as a kind of prestart check list.
On this page, I (OlliW) briefly describe the inital steps which are required to set up the STorM32-BGC to function correctly.
<!--
A personal note first: That I'm sitting here and writing this guide is slightly disappointing. The STorM32 project is my hobby, and I share it for free because I do it in my spare time, which is limited. Documentation I consider thus the user's job, but essentially noone except one brave soul (yang/wdaehn) has contributed significantly to it. The firmware and GUI however progresses, and several pieces of the wiki ran out of date. So I'm sitting here and am writing this guide. :)
-->


The setup is completed in three major steps:
'''Ultra-Quick Start Guide:'''
* '''Preparation:''' Learn the basics.
* Use the "Calibrate Acc" tab to calibrate the imus.
* '''Calibration:''' Learn how and why to do a calibration of your IMU(s).
* Use the "Configure Gimbal Tool" to set the Imu1 Orientation, Imu2 Orientation, and the Motor Poles correctly, and to set the Motor Directions to "auto".
* '''Basic Controller Configuration:''' Adjust those controller parameters, which are absolutely crucial for a correct working.
* Use the "Get Current Motor Directions" tool to set the Motor Directions.
* Use the "Get Current Pitch and Roll Motor Positions" tool to set the Startup Motor Pos parameters for pitch and roll.
* Use the "Adjust Yaw Startup Motor Pos Parameter Tool" to align the yaw axis to point forward at startup.


The Basic Controller Configuration can be further distinguished into two major steps:
Below a somewhat less quick Quick Start guide follows. It tells you what you need to know and to do.
* Some parameters need to be set BEFORE the motors are enabled for the first time.
* The remaining parameters need to be set AFTER the gimbal was started the first time with the motors enabled.
 
The chapters below guide you (very) briefly through what you need to know and what you need to do.


== Supported Gimbals ==
== Supported Gimbals ==
Line 37: Line 32:


== Basic Controller Configuration ==
== Basic Controller Configuration ==
The algorithms used in the STorM32 controller need to know some aspects of your gimbal in order to work correctly. If any of this info is wrong, the controller will misbehave. Unfortunately, an incorrect setup will not always reveal itself immediately, but will lead to misbehavior at a later stage, when a new function is activated, and you might not associate it to the earlier incorrect setup. So, accept this:
The algorithms used in the STorM32 controller need to know some aspects of your gimbal in order to work correctly. If any of this info is wrong, the controller will misbehave. Unfortunately, an incorrect setup will not always reveal itself immediately, but will lead to misbehavior at a later stage, when a new function is activated, and you might not associate it to the earlier faulty setup. So, accept this:


  Just because a setting seems to work correctly doesn't mean that it is correct!
  Just because a setting seems to work correctly doesn't mean that it is correct!
Line 54: Line 49:
The Imu1 and Imu2 orientations and motor poles should be adjusted before the motors are activated, and the motor direction settings prepared properly.
The Imu1 and Imu2 orientations and motor poles should be adjusted before the motors are activated, and the motor direction settings prepared properly.


This is most easily done by using the "Gimbal Configuration Tool", which is started by hitting on the respective button in the tab. Just follow it step by step.  
This is most easily done by using the "Configure Gimbal Tool", which is started by hitting on the respective button in the tab. Just follow it step by step.  


It will guide you through a simple procedure which determines the Imu1 and Imu2 orientations. It then will ask you to enter the number of poles of your motor. The motor pole number you should find in the data sheet of the motors. For instance, a 12N14P motor has 14 poles. The number of poles corresponds to the number of magnets, which you can see in the inner side of the motor bell. So, in case of doubt you can easily determine the number by just counting the magnets. Finally, the motor direction parameters are set to "auto".
It will guide you through a simple procedure which determines the Imu1 and Imu2 orientations. It then will ask you to enter the number of poles of your motor. The motor pole number you should find in the data sheet of the motors. For instance, a 12N14P motor has 14 poles. The number of poles corresponds to the number of magnets, which you can see in the inner side of the motor bell. So, in case of doubt you can easily determine the number by just counting the magnets. Finally, the motor direction parameters are set to "auto".


=== After motors were enabled first time ===
=== After motors were enabled first time ===
== Summary ==
* Use the "Calibrate Acc" tab to calibrate the imus.
* Use the "Configure Gimbal Tool" to set the Imu1 Orientation, Imu2 Orientation, and the Motor Poles correctly, and to set the Motor Directions to "auto".
* Use the "Get Current Motor Directions" tool to set the Motor Directions.
* Use the "Get Current Pitch and Roll Motor Positions" tool to set the Startup Motor Pos parameters for pitch and roll.
* Use the "Adjust Yaw Startup Motor Pos Parameter Tool" to align the yaw axis to point forward at startup.

Revision as of 00:12, 2 December 2014

On this page, I (OlliW) briefly describe the inital steps which are required to set up the STorM32-BGC to function correctly.

Ultra-Quick Start Guide:

  • Use the "Calibrate Acc" tab to calibrate the imus.
  • Use the "Configure Gimbal Tool" to set the Imu1 Orientation, Imu2 Orientation, and the Motor Poles correctly, and to set the Motor Directions to "auto".
  • Use the "Get Current Motor Directions" tool to set the Motor Directions.
  • Use the "Get Current Pitch and Roll Motor Positions" tool to set the Startup Motor Pos parameters for pitch and roll.
  • Use the "Adjust Yaw Startup Motor Pos Parameter Tool" to align the yaw axis to point forward at startup.

Below a somewhat less quick Quick Start guide follows. It tells you what you need to know and to do.

Supported Gimbals

The STorM32 controller can currently be used for the following setups:

  • 3-Axis with single IMU: Only one IMU, connected to the I2C port and mounted to the camera, is used.
  • 3-Axis with on-board IMU: In addition to the camera IMU the on-board IMU is used as 2nd IMU. The board must be mounted on the gimbal support (above the yaw motor).
  • 3-Axis with separate 2nd IMU: In addition to the camera IMU a further IMU connected to the I2C#2 port is used as 2nd IMU. The board can be mounted anywhere, but the 2nd IMU must be mounted on the gimbal support (above the yaw motor).
  • 2-Axis: This is not "officially" supported but users figured out that the controller can be set up to work also fine for a 2-axis gimbal. Only one IMU attached to the I2C port and mounted to the camera can be used. The usage of a 2nd IMU is not supported.

The 3-Axis with single IMU and 2-Axis applications are obviously easier to set up, since one doesn't need to care about the 2nd IMU and what's required to get it working correctly. The following focuses on the dual-IMU setups.

Preparation

Before one starts, one should know this:

  • Comprehend the Dos and Dont's.
  • Understand the importance of a proper gimbal mechanics, read The Gimbal.
  • Get familiar with the board, inspect the Pins and Connectors.
  • Use the latest firmware and GUI. For downloading the latest firmware package see Downloads. For flashing the firmware to the board see How to flash firmware. Read the update and install instructions in the respective post in the rcgroups thread, and check this post for known bugs.
  • Check that your setup matches one of the supported setups mentioned before.

Finally, an advice: Take any recommendation given in these links seriously!

Calibration

Basic Controller Configuration

The algorithms used in the STorM32 controller need to know some aspects of your gimbal in order to work correctly. If any of this info is wrong, the controller will misbehave. Unfortunately, an incorrect setup will not always reveal itself immediately, but will lead to misbehavior at a later stage, when a new function is activated, and you might not associate it to the earlier faulty setup. So, accept this: 

Just because a setting seems to work correctly doesn't mean that it is correct!

One implication is that adjusting the fundamental parameters by trial-and-error is the best approach to produce all sorts of non-obvious problems. Fortunately, a straight-forward setup procedure is available, which guarantees correct settings, if followed. So, the above could be rephrased also as "Don't try to be smart, just shut up and follow the recipe". That's in fact the best advice possible here.

The parameters we are talking about are those centralized in the GUI's "Gimbal Configuration" tab:

  • Imu1 Orientation
  • Imu2 Orientation
  • Motor Poles
  • Motor Directions
  • Motor Startup Positions

Some of them should be adjusted before the motors are activated, some of them can only be adjusted with the motors enabled.

Before motors are enabled first time

The Imu1 and Imu2 orientations and motor poles should be adjusted before the motors are activated, and the motor direction settings prepared properly.

This is most easily done by using the "Configure Gimbal Tool", which is started by hitting on the respective button in the tab. Just follow it step by step.

It will guide you through a simple procedure which determines the Imu1 and Imu2 orientations. It then will ask you to enter the number of poles of your motor. The motor pole number you should find in the data sheet of the motors. For instance, a 12N14P motor has 14 poles. The number of poles corresponds to the number of magnets, which you can see in the inner side of the motor bell. So, in case of doubt you can easily determine the number by just counting the magnets. Finally, the motor direction parameters are set to "auto".

After motors were enabled first time

Summary

  • Use the "Calibrate Acc" tab to calibrate the imus.
  • Use the "Configure Gimbal Tool" to set the Imu1 Orientation, Imu2 Orientation, and the Motor Poles correctly, and to set the Motor Directions to "auto".
  • Use the "Get Current Motor Directions" tool to set the Motor Directions.
  • Use the "Get Current Pitch and Roll Motor Positions" tool to set the Startup Motor Pos parameters for pitch and roll.
  • Use the "Adjust Yaw Startup Motor Pos Parameter Tool" to align the yaw axis to point forward at startup.
Retrieved from "http:///storm32bgc-v1-wiki/index.php?title=Quick_Start_Guide&oldid=1615"