PX4 自动驾驶用户指南 (v1.12)

# 睿思凯（FrSky）数传功能

睿思凯遥测功能允许你在兼容的遥控器发射机上访问载具的 遥测或状态信息。

有效的 遥测信息如下所示，包括：飞行模式、电池信息、遥控信号强度、速度、高度等。 某些型号的发射机还可以提供声音和震动的反馈，这对于低电量和其他故障安全警告特别有用。

PX4平台支持睿思凯的 S.port（新）和D.port（旧）两种类型的遥测数据接口。

# 硬件安装

FrSky telemetry requires:

First connect the receiver for RC channels, e.g. connect the S.Bus ports on the reciever and the flight controller.

Then set up FrSky telemetry by separately connecting the SPort on the receiver to any free UART on the flight controller, and then configure PX4 to run FrSky telemetry on that UART.

This is done slightly differently, depending on whether the SPort receiver has a pin for an uninverted output, and/or the Pixhawk version.

# Pixhawk FMUv4 (and prior)

For Pixhawk FMUv4 and earlier, UART ports and receiver telemetry ports are typically incompatible (with the exception of Pixracer).

Generally SPort receivers have an inverted S.Port signal and you have to use a converter cable to split the S.Port into uninverted TX and RX for connecting to the Pixhawk UART. An example is shown below.

FrSky-Taranis-遥测

提示

When connecting to an inverted S.Port it is usually cheaper and easier to buy a ready made cable that contains this adapter and has the appropriate connectors for the autopilot and receiver. Creating a DIY cable requires electronics assembly expertise.

If using an S.Port receiver with a pin for uninverted output you can simply attach one of the UART's TX pins.

Then configure PX4.

# Pixhawk FMUv5/STM32F7 and later

For Pixhawk FMUv5 and later PX4 can read either inverted (or uninverted) S.Port signals directly - no special cable is required.

注解

More generally this is true on autopilots with STM32F7 or later (e.g. Durandal has a STM32H7 and can read inverted or uninverted S.Port signals directly).

Simply attach one of the UART's TX pins to the SPort inverted or uninverted pin (PX4 will auto-detect and handle either type). Then configure PX4.

# PX4配置

Configure the serial port on which FrSky will run using TEL_FRSKY_CONFIG. There is no need to set the baud rate for the port, as this is configured by the driver.

注解

You can use any free UART, but typically TELEM 2 is used for FrSky telemetry (except for Pixracer, which is pre-configured to use the FrSky port by default).

提示

If the configuration parameter is not available in QGroundControl then you may need to add the driver to the firmware:

drivers/telemetry/frsky_telemetry

No further configuration is required; FrSky telemetry auto-starts when connected and detects D or S mode.

# 兼容遥控发射机

You will need an RC transmitter that can receive the telemetry stream (and that is bound to the FrSky receiver).

Popular alternatives include:

  • FrSky Taranis X9D Plus (推荐)
  • FrSky Taranis X9D
  • FrSky Taranis X9E
  • FrSky Taranis Q X7
  • Turnigy 9XR Pro

The above transmitters can display telemetry data without any further configuration. The following section(s) explain how you can customise telemetry display (for example, to create a better UI/UX).

# Taranis脚本设置(LuaPilot)

Compatible Taranis receivers (e.g. X9D Plus) running OpenTX 2.1.6 or newer can use the LuaPilot script to modify the displayed telemetry (as shown in the screenshot below).

Telemetry Screen on the Taranis

Instructions for installing the script can be found here: LuaPilot Taranis Telemetry script > Taranis Setup OpenTX 2.1.6 or newer (opens new window)

If you open the LuaPil.lua script with a text editor, you can edit the configuration. Suggested modifications include:

  • local BattLevelmAh = -1 使用载机计算的电池信息；
  • local SayFlightMode = 0没有可供PX4飞行模式使用的WAV音频文件 遥测信息

# 遥测信息

FrySky Telemetry can transmit most of the more useful status information from PX4. S-Port and D-Port receivers transmit different sets of messages, as listed in the following sections.

# S-Port

S-Port receivers transmit the following messages from PX4 (from here (opens new window)):

  • **AccX, accy, accz:**加速度计数值。
  • **Alt:**基于气压计的高度, 初始化水平为零。
  • **Curr:**实际电流消耗 (安培)。
  • **Fuel:**当电池容量参数和 smartport_fuel_percent = on</1 >参数设置好了, 则剩余电池剩余容量百分比，否则显示电池消耗容量时, 。
  • Alt:基于气压计的高度, 初始化水平为零。
  • GPS:gps 坐标。
  • GSpd:当前相对水平地面速度, 由 gps 计算。
  • Hdg:机头朝向 (正北为 0°)。
  • VFAS:实际电池电压值 (电压 frsky 安培传感器)。
  • Vspd:垂直速度 (cm/s)。
  • Tmp1: Flight mode, sent as an integer: 18 - Manual, 23 - Altitude, 22 - Position, 27 - Mission, 26 - Hold, 28 - Return, 19 - Acro, 24 0 Offboard, 20 - Stabilized, 25 - Takeoff, 29 - Land, 30 - Follow Me.
  • Tmp2:gps 信息。 最右边的数字是 gps 定位类型 (0 = 无, 2 = 2d, 3 = 3d)。 其他数字是卫星的数量。

:::note The following "standard" S-Port messages are not supported by PX4: ASpd, A4. :::

D-port

D-Port receivers transmit the following messages (from here):

  • AccX, accy, accz:加速度计数值。
  • Alt:基于气压计的高度, 初始化水平为零。
  • Cels:平均电池电压值 (电池电压除以电池片数)。
  • Curr:实际电流消耗 (安培)。
  • Fuel:如果设置了容量, 则剩余电池百分比, 否则显示消耗电量。
  • Date:通电后运行时间。
  • Alt:基于气压计的高度, 初始化水平为零。
  • GPS:gps 坐标。
  • GSpd:当前速度, 由 gps 计算。
  • Hdg:机头朝向 (正北为 0°)。
  • RPM:解锁后为油门数值, 否则为电池容量。 请注意, 在Taranis上，电池片数需要设置为12。
  • Tmp1:飞行模式 (适用于 s-port)。
  • Tmp2:gps 信息 (适用于 s-port)。
  • VFAS:实际电池电压值 (电压 frsky 安培传感器)。
  • Vspd:垂直速度 (cm/s)。

睿思凯遥测接收机

Pixhawk/PX4 supports D (old) and S (new) FrSky telemetry. The table belows all FrSky receivers that support telemetry via a D/S.PORT (in theory all of these should work).

:::tip Note that the X series receivers listed below are recommended (e.g. XSR, X8R). The R and G series have not been tested/validated by the test team, but should work. :::

接收机 范围 集成输出 数字遥测输入 尺寸 重量
D4R-II 1.5km CPPM (8) D.Port 40x22.5x6mm 5.8g
D8R-XP 1.5km CPPM (8) D.Port 55x25x14mm 12.4g
D8R-II Plus 1.5km 否 D.Port 55x25x14mm 12.4g
X4R 1.5km CPPM (8) Smart Port 40x22.5x6mm 5.8g
X4R-SB 1.5km S.Bus (16) Smart Port 40x22.5x6mm 5.8g
X6R / S6R 1.5km S.Bus (16) Smart Port 47.42×23.84×14.7mm 15.4g
X8R / S8R 1.5km S.Bus (16) Smart Port 46.25 x 26.6 x 14.2mm 16.6g
XSR / XSR-M 1.5km S.Bus (16) / CPPM (8) Smart Port 26x19.2x5mm 3.8g
RX8R 1.5km S.Bus (16) Smart Port 46.25x26.6x14.2mm 12.1g
RX8R PRO 1.5km S.Bus (16) Smart Port 46.25x26.6x14.2mm 12.1g
R-XSR 1.5km S.Bus (16) / CPPM (8) Smart Port 16x11x5.4mm 1.5g
G-RX8 1.5km S.Bus (16) Smart Port + integrated vario 55.26178mm 5.8g
R9 10km S.Bus (16) Smart Port 43.3x26.8x13.9mm 15.8g
R9 slim 10km S.Bus (16) Smart Port 43.3x26.8x13.9mm 15.8g

:::note The above table originates from http://www.redsilico.com/frsky-receiver-chart and FrSky product documentation. :::

成品转接线缆

Ready-made cables for use with Pixhawk FMUv4 and earlier (except for Pixracer) are available from:

  • Craft and Theory. 以下版本是可用的，DF-13 兼容PicoBlade 接头 (for FMUv2/3DR Pixhawk, FMUv2/HKPilot32) 和JST-GH 接头 (for FMUv3/Pixhawk 2 "The Cube" /FMUv4/PixRacer v1).

    从 Craft and Theory 购买转接线材。

自制转接线缆

It is possible to create your own adapter cables. You will need connectors that are appropriate for your autopilot (e.g. JST-GH connectors for FMUv3/Pixhawk 2 "The Cube" and FMUv4/PixRacer v1, and DF-13 compatible PicoBlade connectors for older autopilots).

The Pixracer includes electronics for converting between S.PORT and UART signals, but for other boards you will need a UART to S.PORT adapter. These can be sourced from:

More information about the connections for different boards is given below.

Pixracer to S-port 接收机

Connect the Pixracer FrSky TX and RX lines together (solder the wires together) to the X series receiver's S.port pin. GND need not be attached as this will have been done when attaching to S.Bus (normal RC connection).

The S-port connection is shown below (using the provided I/O Connector).

Grau b Pixracer FrSkyS.Port Connection

Pixracer FrSkyS.Port Connection

Pixracer to D-port 接收机

:::tip The vast majority of users now prefer to use S.PORT. :::

Connect the Pixracer FrSky TX line (FS out) to the receiver's RX line. Connect the Pixracer FrSky RX line (FS in) to the receivers TX line. GND need not be connected as this will have been done when attaching to RC/SBus (for normal RC).

<!-- Image would be nice -->

Pixhawk Pro

Pixhawk 3 Pro can be connected to TELEM4 (no additional software configuration is needed). You will need to connect via a UART to S.PORT adapter board, or a ready-made cable.

Pixhawk FMUv5 and later

Simply attach one of the UART's TX pins to the SPort inverted or uninverted pin (PX4 will auto-detect and handle either type).

其他飞控板

Most other boards connect to the receiver for FrSky telemetry via the TELEM2 UART. This includes, for example: Pixhawk 1, mRo Pixhawk, Pixhawk2.

You will need to connect via a UART to S.PORT adapter board, or a ready-made cable.

<!-- ideally add diagram here -->

附加信息

For additional information, see the following links:

← CUAV HV pm →