telemetry_transparent_frsky_x module

Telemetry using pprzlink protocol over FrSky X SmartPort serial link

Downlink messages are sent on dataID 0x5015. Uplink is not implemented yet.

Use the sw/tools/opentx-lua/sp2ser.lua script to receive these messages on the TX and forward them to the USB port. The 'datalink' script can read the pprzlink stream as a regular serial port.

The data rate is very limited (max ~160 bytes/s). The limitation comes from the FrSky X protocol which can send at most 4 bytes of telemetry every 9ms. Set CC2500_TELEMETRY_SENSORS (from radio_control_cc2500_frsky) to SENSOR_NONE to maximize pprzlink throughput. Use a suitable telemetry conf for this low data rate.

Example for airframe file

Add to your firmware section:

<module name="telemetry_transparent_frsky_x"/>

Module functions

Init Functions

These initialization functions are called once on startup.

• datalink_frsky_x_init()
• pprz_dl_init()

Event Functions

These event functions are called in each cycle of the module event loop.

• pprz_dl_event()

Files

Header Files

The following headers are automatically included in modules.h

• pprz_dl.h
• frsky_x.h

Source Files

• modules/datalink/frsky_x.c
• modules/datalink/pprz_dl.c
• pprzlink/src/pprz_transport.c
• modules/datalink/frsky_x.c

Raw telemetry_transparent_frsky_x.xml file:

<!DOCTYPE module SYSTEM "module.dtd">
 
<module name="telemetry_transparent_frsky_x" dir="datalink" task="datalink">
  <doc>
    <description>
      Telemetry using pprzlink protocol over FrSky X SmartPort serial link
      
      Downlink messages are sent on dataID 0x5015.
      Uplink is not implemented yet.
      
      Use the sw/tools/opentx-lua/sp2ser.lua script to receive these messages
      on the TX and forward them to the USB port. The 'datalink' script can
      read the pprzlink stream as a regular serial port.
      
      The data rate is very limited (max ~160 bytes/s). The limitation comes
      from the FrSky X protocol which can send at most 4 bytes of telemetry
      every 9ms. Set CC2500_TELEMETRY_SENSORS (from radio_control_cc2500_frsky)
      to SENSOR_NONE to maximize pprzlink throughput. Use a suitable telemetry
      conf for this low data rate.
    </description>
  </doc>
  <dep>
    <depends>datalink_common</depends>
    <provides>datalink,telemetry</provides>
  </dep>
  <header>
    <file name="pprz_dl.h"/>
    <file name="frsky_x.h"/>
  </header>
  <init fun="datalink_frsky_x_init()"/>
  <init fun="pprz_dl_init()"/>
  <event fun="pprz_dl_event()"/>
  <makefile>
    <file name="frsky_x.c"/>
  </makefile>
  
  <makefile target="!sim|nps">
    <define name="USE_FRSKY_X_SERIAL"/>
    <define name="DOWNLINK_DEVICE" value="frsky_x_serial"/>
    <define name="PPRZ_UART" value="frsky_x_serial"/>
    <define name="DOWNLINK_TRANSPORT" value="pprz_tp"/>
    <define name="DATALINK" value="PPRZ"/>
    <file name="pprz_dl.c"/>
    <file name="pprz_transport.c" dir="pprzlink/src"/>
    <file name="frsky_x.c"/>
    <test>
      <define name="DOWNLINK_DEVICE" value="frsky_x_serial"/>
      <define name="USE_FRSKY_X_SERIAL"/>
    </test>
  </makefile>
</module>