Guides
These docs are for v20160720. Click to read the latest docs for v20170213.

Common Flight Controller Peripherals

So you've got your aircraft flying, and you want to hook other stuff to it? OK.

dRonin flight controllers have ports allowing you to connect a wide variety of "stuff" to it. This page offers a brief treatment of what you might attach and how.

🚧

Note for F1 flight controllers...

Ensure that the autotune module is turned off before enabling any other modules on F1 flight controllers (like Naze32 or CC3D). The STM32F103 microprocessor has limited memory and it is unable to successfully start up with autotune and other modules enabled at the same time.

Battery monitoring

dRonin can monitor battery voltage, current, and expected remaining life, and prevent arming when a low battery is attached. This battery data can also be reported over an on-screen display or radio receiver telemetry.

Most flight controllers have voltage and current sense pins, which can be used with an external battery monitoring board like the UberDistro, AmpWings, or AttoPilot.

After reading the documentation for your battery monitoring board, and attaching the sensor's current and voltage sense leads to the flight controller's ADC lines, enable the battery module on the modules pane in GCS.

See this wiki page for additional details.

Radio receiver telemetry

dRonin supports sending telemetry data to FrSky and other radios. Information about the flight, such as remaining battery, flight mode, position, and attitude can then be displayed on a Taranis.

There are a few different radio telemetry protocols (Wiki documentation is linked):

dRonin also speaks these protocols which are not typically used for receiver telemetry

  • MSP (used for on-screen display / MWOSD)
  • UAVTalk (the protocol used to speak to GCS)
  • Mavlink (used for legacy on-screen display)

To use a telemetry protocol, first wire it to a flight controller port. On STM32F3, you can usually wire the telemetry wires directly to the port. On other flight controllers, an inverter is generally required. Then, configure the specific port on the hardware pane to the protocol, save, and reset your flight controller.

External on-screen display

It's recommended that you use MWOSD. MWOSD is an on-screen display that runs on multiple types of hardware, including MiniMOSD, Micro-MiniMOSD, and OSDoge.

MWOSD speaks a protocol called Multiwii Serial Protocol (MSP), that dRonin also supports. MSP was introduced by MultiWii and is also used by Baseflight and Cleanflight.

🚧

MWOSD and Naze32

Naze32 has limited serial ports and as a result there are some nuances to using MWOSD. Detailed instructions on using MWOSD with Naze32 are on the Using Naze32 page.

First, install MWOSD onto your OSD (per the procedure in Configuring MWOSD for dRonin. Next, go to the hardware pane in GCS. Set the specific port on the hardware pane to "MSP", save, and reset the flight controller.

With luck, information on flight status is now on the on-screen display!

OpenLog

dRonin F3 and F4 flight controllers support logging detailed information about flight status and the internal workings of the system. They can log this information to onboard flash or to an external OpenLog / OpenLager peripheral.

1000
Onboard FlashOpenLogOpenLager
Pros:
Already onboard many flight controllers; no additional hardware required
Relatively fast
Pros:
* Commonly available logging peripheral logs to SD card
Pros:
Really fast
Logs to SD card
* Same form factor as OpenLog
Cons:
Not all FCs have it
Downloading logs over USB can be very slow
* Onboard flash storage is very limited in size
Cons:
Relatively slow interface and small buffers limits limits log rates
Consumes a flight controller serial port
Cons:
Availability is presently limited
Cost is a little higher than OpenLog because fancier parts are used in the design.

To use logging, first enable the logging module in the modules configuration.

Next, if you are using OpenLog or OpenLager, go to the hardware pane, and assign the device to a serial port. Save, and return to the modules configuration.

On the logging sub-pane, you can adjust various parameters. The default 'LogOnArm' and 'FullBore' logging profiles are generally what you want. If you are using a serial logger, select the baud rate. Generally OpenLog defaults to 115200 or 250000 bits per second, and OpenLager defaults to 2000000 bits per second.

If you are using OpenLager, feel free to turn up the logging rate. This is the maximum number of times per second to log any of the data objects on the system (motor commands, gyro data, manual control input). You can generally choose at least 250 without any problems.

πŸ“˜

Viewing logs

The dRonin development environment contains a Python API and associated tools to do heavy lifting and analysis of recorded logs.

There's a lot of work underway on end-user log viewing and analysis tools. In the meantime, there's an initial preview of a log viewing environment for Windows at http://jar.lyle.org/~mlyle/logview-20160910.zip