This page has moved to

Click here if you are not redirected.


如果你想要去控制一个装在飞机上带相机的云台(或者是其他的挂载设备),你需要配置使用什么去控制它和 PX4 怎样才能命令它。 本页内容就是讲解这些设置。

PX4 contains a generic mount/gimbal control driver with different input and output methods.

  • The input defines how you control the gimbal: via RC or via MAVLink commands (for example in missions or surveys).
  • The output defines how the gimbal is connected: either via MAVLink commands or using the Flight Controller AUX PWM port. Any input method can be selected to drive any output, and both input and output have to be configured via parameters.


The Mount parameters are used to setup the mount driver.

The most important ones are the input (MNT_MODE_IN) and the output (MNT_MODE_OUT) mode. By default, the input is disabled and the driver does not run. After selecting the input mode, reboot the vehicle so that the mount driver starts.

If the input mode is set to AUTO, the mode will automatically be switched based on the latest input. To switch from MAVLink to RC, a large stick motion is required.

To enable a MAVLink gimbal, first set parameter MNT_MODE_IN to MAVLINK_DO_MOUNT and MNT_MODE_OUT to MAVLINK.

The gimbal can be connected to any free serial port using the instructions in [MAVLink Peripherals (GCS/OSD/Companion)( (also see Serial Port Configuration).

A common configuration is to have a serial connection to the gimbal from the Flight Controller TELEM2 port (assuming TELEM2 is free). For this configuration you would set:

  • MAV_1_CONFIG to TELEM2 (if MAV_1_CONFIG is already used for a companion computer (say), use MAV_2_CONFIG).
  • SER_TEL2_BAUD to manufacturer recommended baude rate.

This will enable the user to command the gimbal using MAV_CMD_DO_MOUNT_CONTROL and MAV_CMD_DO_MOUNT_CONFIGURE.

Gimbal on Flight Controller (MNT_MODE_OUT=AUX)

The gimbal can be connected to the Flight controller AUX ports by setting the ouptut mode to MNT_MODE_OUT=AUX.

A mixer file is required to define the mapping for the output pins and the mount mixer is automatically selected (this overrides any AUX mixer provided by the airframe configuration).

The output assignment is as following:

  • AUX1: Pitch
  • AUX2: Roll
  • AUX3: Yaw
  • AUX4: Shutter/retract


Read Mixing and Actuators for an explanation of how mixers work and the format of the mixer file.

The outputs can be customized by creating a mixer file on the SD card named etc/mixers/mount.aux.mix.

A basic basic mixer configuration for a mount is shown below.

# roll
M: 1
O:      10000  10000      0 -10000  10000
S: 2 0  10000  10000      0 -10000  10000

# pitch
M: 1
O:      10000  10000      0 -10000  10000
S: 2 1  10000  10000      0 -10000  10000

# yaw
M: 1
O:      10000  10000      0 -10000  10000
S: 2 2  10000  10000      0 -10000  10000


The Typhoon H480 model comes with a preconfigured simulated gimbal.

To run it, use:

make px4_sitl gazebo_typhoon_h480

To just test the mount driver on other models or simulators, make sure the driver runs (using vmount start), then configure its parameters.


The driver provides a simple test command - it needs to be stopped first with vmount stop. The following describes testing in SITL, but the commands also work on a real device.

Start the simulation with (no parameter needs to be changed for that):

make px4_sitl gazebo_typhoon_h480

Make sure it's armed, eg. with commander takeoff, then use the following command to control the gimbal (for example):

vmount test yaw 30

Note that the simulated gimbal stabilizes itself, so if you send MAVLink commands, set the stabilize flags to false.

Gazebo Gimbal Simulation

results matching ""

    No results matching ""