Getting started
Guide on setting up the DroneBridge system
Content
Basic hardware & Installation
Hardware to GND & AIR side:
Two Raspberry Pis (Pi Zero W should work but Pi 2 or 3 are recommended)
Two SD cards with min. 16GB storage
A Pi camera module (v1 or v2)
Two WiFi sticks (Supported WiFi adapters)
>2A 5V power supply/BEC
Write the image onto the SD cards using e.g. Win32 Disk Imager (Windows) or your favourite Linux tool (e.g. dd or some GUI tools). Connect the Pi camera module to the raspberry pi that will be on the UAV. Make sure your power supply for both Pis provides min. 2A current and stable 5V!
Wiring
First the FCs UART must be wired to the AirPis UART. The UART of the Raspberry Pi is 3.3V only! In case your FC uses 5V on the UART you will need a logic level converter.
The Raspberry Pis UART is on GPIO 14 (TX) & 15 (RX). Connect the TX to RX and vise versa. There are many tutorials on how to connect a UART.
If you want to use RC over DroneBridge it is recommended to connect the Pi to the FC with an additional UART connection. This connection will transmit the SUMD RC messages to the FC. To get a second UART on the Pi you will need a FTDI adapter connected via USB on the AirPi.
Configuration
DroneBridge is pre-configured to work out of the box with MAVLink based systems like the Pixhawk or Ardupilot. Then configuration options must be matched. This can be done via DroneBridge for Android or by manually editing the configuration files.
In this guide we will focus on the configuration files since not all functions are accessible via the DroneBridge for Android app.
The configuration files are located on the SD card at /DroneBridge/DroneBridgeConfig.ini
All settings in the COMMON
section must match on AIR & GND!
Configuration files for the OSD are located at /DroneBridge/osdconfig.txt
MAVLink based flight controller
MAVLink messages are read by the control module on the AirPi and sent to the proxy module on the GndPi. Following settings must be set inside the configuration files:
On the GndPi inside the OSD configuration file:
On the AirPi inside the[AIR]
section:
iNAV
Support for MultiWii based flight controllers is discontinued by the base project. DroneBridge will continue to support bi-directional MSPv1 & MSPv2 as part of a legacy support.
On the GndPi inside the OSD configuration file:
On the AirPi inside the[AIR]
section:
EXPERIMENTAL - Connecting an RC transmitter
You can use DroneBridge to control your UAV. Currently the FrSky i6S and all OpenTX based RCs are supported. Custom hardware can easily be integrated with just a few lines of code. Please take the OpenTX implementation as a reference.
Connect the RC via USB to the ground station
If possible: Disable the built-in transmitter of the RC to reduce RF noise
RC commands are sent to the UAV using lower bit rates then the video stream. This means that your RC range should be significantly higher than your video range. That way you are/should be able to control the UAV even when your video feed is already down. As of release v0.5 the RC implementation is not much tested. Please use with caution!
If you decide to switch the current RC hardware (hot swap) you need to reboot the ground station. Connecting and then disconnecting hardware #1 followed by connecting hardware #2 is not possible without reboot. If both RCs run on the same firmware a hot swap is possible without reboot.
Advantages of RC via DroneBridge over the transmitter built into the RC:
DroneBridge set-ups generally offer a lot more range
Notes to SUMD and UART
If you need more than the one UART that the Raspberry Pi offers you can also connect a FTDI adapter to your AirPi. This is recommended if you want to use SUMD as RC link to FC. SUMD output with DroneBridge Beta v0.3 is untested!
Using multiple wifi cards
As of release v0.6 DroneBridge supports diversity transmission on all built in modules
By default all connected WiFi adapters will be used for transmission. They are set to the same frequency.
In the DroneBridge configuration files you can specify interface_selection
. Set it to auto
and one wifi adapter is automatically selected for all modules.
Set interface_selection
to manual
and you can specify an interface for every module. So you can e.g. use one wifi stick for video and telemetry and the other one for RC. You can even set them to different frequencies to avoid packet loss and bad video. To change the interface for the control module e.g. set interface_control=18a6f716a511
where 18a6f716a511
is the MAC address of the interface to be used. To change the frequency you need to edit the settings.
Last updated