Example for airframe file

Add to your firmware section: This example contains all possible configuration options, not all of them are mandatory!

<module name="telemetry_nps">
  b'<configure name="MODEM_DEV" value="UDPx" />\n    '
  b'<configure name="MODEM_HOST" value="192.168.1.255" />\n    '
  b'<configure name="MODEM_PORT_OUT" value="4242" />\n    '
  b'<configure name="MODEM_PORT_IN" value="4243" />\n    '
  b'<configure name="MODEM_BROADCAST" value="TRUE|FALSE" />\n  '
</module>

Module configuration options

Configure Options

name: MODEM_DEV value: UDPx
Description: UDP port used for communication
name: MODEM_HOST value: 192.168.1.255
Description: IP address of the ground station (can be a broadcast address)
name: MODEM_PORT_OUT value: 4242
Description: output UDP port
name: MODEM_PORT_IN value: 4243
Description: input UDP port
name: MODEM_BROADCAST value: TRUE|FALSE
Description: UDP socket in broadcast mode

Module functions

Init Functions

These initialization functions are called once on startup.

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

Source Files

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

Raw telemetry_nps.xml file:

<!DOCTYPE module SYSTEM "module.dtd">
 
<module name="telemetry_nps" dir="datalink" task="datalink">
  <doc>
    <description>
      Telemetry module for NPS simalation
 
      Currently a simple copy of telemetry UDP but only for target nps
    </description>
    <configure name="MODEM_DEV" value="UDPx" description="UDP port used for communication"/>
    <configure name="MODEM_HOST" value="192.168.1.255" description="IP address of the ground station (can be a broadcast address)"/>
    <configure name="MODEM_PORT_OUT" value="4242" description="output UDP port"/>
    <configure name="MODEM_PORT_IN" value="4243" description="input UDP port"/>
    <configure name="MODEM_BROADCAST" value="TRUE|FALSE" description="UDP socket in broadcast mode"/>
  </doc>
  <dep>
    <depends>udp,datalink_common</depends>
    <provides>datalink,telemetry</provides>
  </dep>
  <header>
    <file name="pprz_dl.h"/>
  </header>
  <init fun="pprz_dl_init()"/>
  <event fun="pprz_dl_event()"/>
  <makefile target="sim|nps">
    <configure name="MODEM_DEV" default="UDP0" case="upper|lower"/>
    <configure name="MODEM_PORT_OUT" default="4242"/>
    <configure name="MODEM_PORT_IN" default="4243"/>
    <configure name="MODEM_BROADCAST" default="TRUE"/>
    <define name="USE_$(MODEM_DEV_UPPER)"/>
    <define name="$(MODEM_DEV_UPPER)_HOST" value="$(MODEM_HOST)"/>
    <define name="$(MODEM_DEV_UPPER)_PORT_OUT" value="$(MODEM_PORT_OUT)"/>
    <define name="$(MODEM_DEV_UPPER)_PORT_IN" value="$(MODEM_PORT_IN)"/>
    <define name="$(MODEM_DEV_UPPER)_BROADCAST" value="$(MODEM_BROADCAST)"/>
    <define name="DOWNLINK_DEVICE" value="$(MODEM_DEV_LOWER)"/>
    <define name="PPRZ_UART" value="$(MODEM_DEV_LOWER)"/>
    <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"/>
    <test>
      <define name="DOWNLINK_DEVICE" value="udp0"/>
      <define name="USE_UDP"/>
      <define name="USE_UDP0"/>
    </test>
  </makefile>
</module>
 