Telemetry / Serial Port Setup

This article shows how to configure the telemetry ports (aka serial ports) on the flight controller. The instructions use the Pixhawk but they apply for most flight controllers.

Overview

On a Pixhawk there are a total of 5 serial ports. The default use of each port is:

  • The micro USB port (aka Serial0) is used to connect to the ground station using a USB cable. This should not be connected in flight because the flight code assumes that if it is receiving power through this port that it is on the bench and some failsafes (i.e. battery failsafe) are disabled.
  • Telem1 (aka Serial1) is for MAVLink communication and supports flow control. This should be used especially for high power devices (up to 1 amp) But NOT the RFD900 telemetry radio
  • Telem2 (aka Serial2) is for MAVLink communication and supports flow control.
  • GPS (aka Serial3) is for connecting a GPS
  • Serial 4/5 contains two serial connections on a single port. Serial4 is normally used for a second GPS. Serial5 is a debug connection.
../_images/PixhawkTelem.jpg

More details of the exact pins on each port can be found here.

Set-up through the Ground Station

The telemetry ports can be configured through the ground station by setting the parameters listed below. If you are using the Mission Planner open the Config/Tuning | Full Parameter List page.

  • SERIALx_PROTOCOL parameters (where “x” is a number from 0 to 4, i.e. SERIAL1_PROTOCOL) control the protocol or purpose of the serial port. You will see on wiki pages including the Lightware Lidar page instructions for choosing the appropriate protocol.
  • SERIALx_BAUD (i.e. SERIAL1_BAUD) sets the baud rate or speed of the serial port.
  • BRD_SER1_RTSCTS and BRD_SER2_RTSCTS parameters allow enabling or disabling flow control on Telem1 and Telem2.
../_images/MP-Serial2_protocol.png

MAVLink1, MAVLink2 and Stream Rates

For telemetry ports used for MAVLink communication you may select to use MAVLink1 by setting the SERIALx_PROTOCOL to “1” or MAVLink2 by setting SERIALx_PROTOCOL to “2”.

MAVLink2 supports “signing” of packets which improves security and flexible length messages so it should be used when possible but some older telemetry radios do not understand MAVLink2 so the default is MAVLink1.

As mentioned on the Telemetry Logs page the rate messages are sent from the vehicle can be controlled using the SRx_* parameters (i.e. SR1_POSITION).

The Mission Planner’s Config/Tuning |Planner screen’s Telemetry Rates drop-downs allow a convenient way to set these parameters.

../_images/mp_telemetry_rate.png

Due to CPU or bandwidth limitations, the actual rate of the data sent may be lower than the rate requested.

Note

Most ground stations set the desired stream rate by sending the REQUEST_DATA_STREAM MAVLink message to the vehicle instead of directly settting the parameters mentioned above. If done this way, Copter DOES NOT save the rate changes to eeprom meaning they will not persist over a reboot.

In practice users may notice that if the vehicle is rebooted but the telemetry connection is not disconnected and reconnected that the data from the vehicle may be much slower or missing. I.e. the vehicle’s position on the map may not update. Normally disconnecting/reconnecting with the ground station will resolve this.