Using STorM32 with ArduPilot: Difference between revisions
No edit summary |
No edit summary |
||
| Line 9: | Line 9: | ||
<div class="toclimit-3">__TOC__</div> | <div class="toclimit-3">__TOC__</div> | ||
= STorM32 - ArduPilot Support = | == STorM32 - ArduPilot Support == | ||
'''''ArduPilot''''' offers two mount types, which can be used with the STorM32 controller: | '''''ArduPilot''''' offers two mount types, which can be used with the STorM32 controller: | ||
| Line 28: | Line 28: | ||
A comparison of the different techniques to connect the STorM32 controller with the flight controller is given in the feature matrix below. | A comparison of the different techniques to connect the STorM32 controller with the flight controller is given in the feature matrix below. | ||
= Virtual Channel Configuration = | == Virtual Channel Configuration == | ||
The virtual channel feature relies on receiving RC_CHANNELS MAVLink messages, which ArduPilot does not emit by default. | The virtual channel feature relies on receiving RC_CHANNELS MAVLink messages, which ArduPilot does not emit by default. | ||
| Line 36: | Line 36: | ||
For more details on the feature see [[Using_STorM32_with_BetaPilot#Virtual_Channel_Configuration|Virtual Channel Configuration]]. | For more details on the feature see [[Using_STorM32_with_BetaPilot#Virtual_Channel_Configuration|Virtual Channel Configuration]]. | ||
= Feature Matrix = | == Feature Matrix == | ||
(to the best of the authors knowledge) | (to the best of the authors knowledge) | ||
{| class="wikitable" style="text-align: center;" | {| class="wikitable" style="text-align: center;" | ||
| Line 98: | Line 98: | ||
{{COMMENT|Note that some of the listed features only need BetaPilot but do not require that also the STorM32 MAVLink2 mount (MNT_TYPE 83) is enabled; this is so since they are standard MAVLink.}}--> | {{COMMENT|Note that some of the listed features only need BetaPilot but do not require that also the STorM32 MAVLink2 mount (MNT_TYPE 83) is enabled; this is so since they are standard MAVLink.}}--> | ||
= Testing the Connection = | == Testing the Connection == | ||
The serial MAVLink connection can be tested in several ways. Suggestions (which may or may not be valid for ArduPilot) are given in [[Using_STorM32_with_BetaPilot#Testing_the_Connection | Using STorM32 with BetaPilot: Testing the Connection]]. | The serial MAVLink connection can be tested in several ways. Suggestions (which may or may not be valid for ArduPilot) are given in [[Using_STorM32_with_BetaPilot#Testing_the_Connection | Using STorM32 with BetaPilot: Testing the Connection]]. | ||
Revision as of 18:53, 13 May 2021
The information on this page refers to firmware v2.52, and higher.
The STorM32 gimbal controller can communicate with an ArduPilot flight controller via a serial UART data link. The serial communication allows for a much richer data transmission and accordingly richer set of features than possible with the traditional connections such as PWM, PPM, SBUS, and alike.
If you only need the range of functionality possible with the conventional tilt & pan control, then you may not need anything of the below. Some of the basic features can also be accomplished by workarounds in traditional ways. Decide yourself which approach fits your needs best. :)
If you want to make best use of your STorM32 gimbal and want 2020-ish capabilities, then you may want to chose BetaPilot (BetaCopter/BetaPlane), which is described in Using STorM32 with BetaPilot.
STorM32 - ArduPilot Support
ArduPilot offers two mount types, which can be used with the STorM32 controller:
- SToRM32 MAVLink: MNT_TYPE = 4
- SToRM32 Serial: MNT_TYPE = 5
For further details and instructions on how to use these mounts, please visit ArduPilot Docs > Copter > Optional Hardware > Camera&Gimbals > SToRM32 Gimbal Controller.
Comment: Unfortunately, ArduPilot's gimbal support is partially flawed. That is, many features you will find to work fine, but some you will find to not work well. STorM32 can't do anything about it, it's ArduPilot. Also the ArduPilot documentation can be out-of-date. Please note that the STorM32 firmware author is neither responsible for the implementation of ArduPilot's mount types nor for ArduPilot's documentation.
The BetaPilot fork of ArduPilot additionally offers the '83' mount type:
- STorM32 MAVLink2: MNT_TYPE = 83
This mount type is specifically designed for the STorM32 gimbal controller, and provides the best range of functions. For details see Using STorM32 with BetaPilot.
A comparison of the different techniques to connect the STorM32 controller with the flight controller is given in the feature matrix below.
Virtual Channel Configuration
The virtual channel feature relies on receiving RC_CHANNELS MAVLink messages, which ArduPilot does not emit by default.
It can be activated by setting the SRx_RC_CHAN parameter to a non-zero value, there the 'x' refers to the serial which is used for the MAVLink communication.
For more details on the feature see Virtual Channel Configuration.
Feature Matrix
(to the best of the authors knowledge)
| Feature | Traditional PWM, PPM, SBUS, ... |
SToRM32 MAVLink (MNT_TYPE = 4) |
SToRM32 Serial (MNT_TYPE = 5) |
BetaPilot STorM32 MAVLink2 (MNT_TYPE = 83) |
|---|---|---|---|---|
| Gimbal Angle Control | x | x (?) | x | x |
| MOUNT_STATUS message | - | x (1) | x (2) | x |
| ATTITUDE message | - | - | - | x |
| Camera Trigger | x | x | - | x |
| Gimbal Point in MP | - | x | x (2) | x |
| Solo Smart Shots | x (3) | - | - | x (3) |
| Camera Manager in QGC | - | x (4) | - | x |
| MAVLink Parameters | - | x | - | x |
| Video Control in Missions | - | x | - | x |
| 360° Gimbal with Free Look | x | - | - | x |
| STorM32 Functions | x | - | - | x |
| STorM32 Scripts | x | - | - | x |
| STorM32-Link: Horizon Drift Comp. | - | - | - | x |
| STorM32-Link: Yaw Drift Comp. | - | - | - | x |
| MAVLink Passthrough Configuration | - | - | - | x |
| MAVLink Camera Microservice | - | x (4) | - | x |
| MAVLink Advanced Features | - | - | - | x |
| MAVLink Statustext messages | - | - | - | x |
| STorM32 Gimbal Protocol | - | - | - | x |
| Prearm Checks | - | - | - | x |
(?) Many but not all features work in the latest ArduPilot releases. Please check with the ArduPilot community.
(1) The message reports the last set point, not the actual gimbal/camera orientation.
(2) Works only for deprecated v0.9x firmwares.
(3) Only up to ArduCopter 3.6. ArduCopter 4.0 has introduced two bugs which the STorM32 controller cannot work around.
(4) Only basic features.
Testing the Connection
The serial MAVLink connection can be tested in several ways. Suggestions (which may or may not be valid for ArduPilot) are given in Using STorM32 with BetaPilot: Testing the Connection.