Standard Modules
Information on all standard modules on what they do and their inputs & outputs
All modules use the common library to send & receive data via the long range link. Some modules exist in different implementations depending where they are running (UAV, GND station). All modules log to RSysLog.
Capable of transmitting a continuous stream of data that is protected by forward error correction (FEC). Any kind of data can be fed to the UAV module and is stream to the ground.
UAV
Input of data stream via STDIN. FEC packets are computed and sent to GND interleaved with data packets. FEC parameters and packet size can be set via config/command line parameters.
-n Name of a network interface that should be used to receive the stream.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
-d Number of data packets in a block (default 8). Needs to match with RX
-r Number of FEC packets per block (default 4). Needs to match with RX
-f Bytes per packet (default 1024. max 1500). This is also the FEC block size.
Needs to match with RX
-b bit rate in Mbps [1|2|5|6|9|11|12|18|24|36|48|54]
(bitrate option only supported with Ralink chipsets)
-t [1|2] DroneBridge v2 raw protocol packet/frame type:
1=RTS, 2=DATA (CTS protection)
-a [0|1] disable/enable. Offsets the payload by some bytes so that it sits outside
the 802.11 header. Set this to 1 if you are using a non DB-Rasp Kernel!
Example: Send data received via STDIN.
cat mydatasource | video_air -n wlx185 -n wlx185 -c 200 -t 2GND
Data from the UAV module is received and FEC decoded. Depending on the configuration the decoded data is sent to specified outputs. UDP endpoints can register with the module by sending a >0 length UDP packet. This will change the UDP receiver to the senders IP. Destination port is
5000.-n Name of a network interface that should be used to receive the stream.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
-d Number of data packets in a block (default 8). Needs to match with tx
-r Number of FEC packets per block (default 4). Needs to match with tx
-f Bytes per packet (default 1024. max 1500). This is also the FEC block size.
Needs to match with TX
-u [Y|N] to enable or disable UDP forwarding of decoded data
-i UDP DST IP overwrite: Send data to this IP
-p [Y|N] to enable/disable pass through of encoded FEC packets via UDP to
port: 5001
-v Destination port of video stream when set via UDP (IP checker address) or TCP
-o Send to output to unix domain socket at /tmp/db_video_out so that DroneBridge
USBBridge can forward it
-s Disable decoded output to stdout
Example call: Receive and forward STDOUT to a video player
video_gnd -n wlx185 -n wlx185 -c 200 -u N | MyVideoPlayer -supportsH264The control module is responsible for RC & telemetry on the UAV.
UAV
On the UAV the control module operates the serial connections to the flight controller.
- Receive RC messages & forward them to the FC (SUMD)
- Receive messages from proxy module and forward them to the FC
- Receive data from the FC, parse data if configured and forward to proxy module
- Send status messages to status module (CPU temp, RC packet-loss)
-n Name of a network interface that should be used to send & receive data.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-u [MSP/MAVLink_Interface_TO_FC] - UART or VCP interface that is connected to FC
-v Protocol over serial port [1|2|3|4]:"
1 = MSPv1 [Betaflight/Cleanflight]"
2 = MSPv2 [iNAV] (default)"
3 = MAVLink v1 (RC unsupported)"
4 = MAVLink v2"
5 = MAVLink (plain) pass through (-l <chunk size>) - recommended with MAVLink,
FC needs to support MAVLink v2 for RC
-l Only relevant with -v 5 option. Telemetry bytes per packet over long range
(default: %i)
-e [Y|N] enable/disable RC over SUMD. If disabled -v & -u options are used for RC.
-s Specify a serial port for use with SUMD. Ignored if SUMD is deactivated. Must be
different from one specified with -u
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
-r Baud rate of the serial interface -u (MSP/MAVLink)
2400, 4800, 9600, 19200, 38400, 57600, 115200 (default: 115200))
-b bit rate in Mbps [1|2|5|6|9|11|12|18|24|36|48|54]
(bitrate option only supported with Ralink chipsets)
-a [0|1] disable/enable. Offsets the payload by some bytes so that it sits outside
the 802.11 header. Set this to 1 if you are using a non DB-Rasp Kernel!
GND
Read values from connected RC hardware and forward the channel data to the UAV module using the defined method/protocol.
Depending on the protocol (
-v argument) the data is sent to the DB-RC raw port of the control module or to its transparent pass through raw port (forward to serial port). In case of -v [1-4] the final serial message for the flight controller is generated on the ground station by the control module. The finished message is then sent to the Air module (to same raw port the proxy module uses) and forwarded to the flight controller via the serial connection. In case of -v 5 the final serial message (RC protocol) is generated on the Air side. In that case the more efficient DB-RC message is used on the long range link.-n Name of a network interface that should be used to send & receive data.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-j Index of joystick interface of RC (e.g. 0 for /dev/input/js0)
-v Protocol [1|2|4|5]:
1 = MSPv1 [Betaflight/Cleanflight]
2 = MSPv2 [iNAV]
3 = MAVLink v1
4 = MAVLink v2
5 = DB-RC (default)
-o [Y|N] enable/disable RC overwrite
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
-t [1|2] DroneBridge v2 raw protocol packet/frame type:
1=RTS
2=DATA (CTS protection)
-r RC frequency in Hz (default 60 Hz)
-b bit rate in Mbps [1|2|5|6|9|11|12|18|24|36|48|54]
(bitrate option only supported with Ralink chipsets)
-a [0|1] disable/enable. Offsets the payload by some bytes so that it sits outside
the 802.11 header. Set this to 1 if you are using a non DB-Rasp Kernel!
Example: Read from RC connected to
/dev/input/js0 and send to control module on Air sidecontrol_ground -n wlx684864 -c 200 -j 0 -v 5 -t 5 -r 70Runs on the ground station computer.
- Receives any kind of data via the long range link
- Forwards received data to all connected TCP clients
- Bi-Directional: Forwarding of TCP data via long range link to control module raw port
- Fully transparent
- Writes data received via long range link to
/root/telemetryfifo1for further processing by the OSD
-n Name of a network interface that should be used to send & receive data.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
-o [Y|N] Write telemetry to /root/telemetryfifo1 FIFO (default: Y)
-l Path to store the telemetry log files. Default /DroneBridge/log/
-b bit rate in Mbps [1|2|5|6|9|11|12|18|24|36|48|54]
(bitrate option only supported with Ralink chipsets)
-t [1|2] DroneBridge v2 raw protocol packet/frame type:
1=RTS, 2=DATA (CTS protection)
-a [0|1] disable/enable. Offsets the payload by some bytes so that it sits outside
the 802.11 header. Set this to 1 if you are using a non DB-Rasp Kernel!
Example: Wifi to DroneBridge long range link bridge:
db_proxy -n wlx785 -c 200 -o N -t 2Receives and processes status messages like CPU load and temperature of the Air-Unit. Used for information with higher update rates (>5Hz)
-n Name of a network interface that should be used to send & receive data.
Must be in monitor mode. Multiple interfaces supported by calling this
option multiple times (-n inter1 -n inter2 -n interx)
-c [communication id] Choose a number from 0-255. Same on ground station and UAV!
Used to forward TCP/UDP messages transparently between and android device and the DroneBridge modules. Implements the Android Open Accessory Protocol and the DroneBridge USB message.
Runs on the ground station. Creates an OSD overlay based on telemetry received via the proxy module (FIFO:
/root/telemetryfifo1).Only compiles on the Raspberry Pi. Used OpenVG with some transparency mods.
Receives messages from RSysLog and forwards them to all connected TCP clients.