Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 32 Next »

work in progress

LP2Go is currently in a closed alpha test state. If you want to participate, refer to the official forum for more information.

 

Introduction

LP2Go is a leightweight app to use LibrePilot in the field. It's purpose is not to be a GCS for android, but it focusses on functionality needed while flying.

Connection

USB

USB is used to attach the phone via cable to the flight controller, or to use an OPLink mini to receive data via OPLINK.

Set the connection in the settings dialog.

Your Phone needs to support USB OTG, not all phones support this. To check general USB OTG support, check http://www.gsmarena.com. Under COMMS, USB the entry USB-Host has to be present. 

 

 

You need a special cable. Search amazon for "otg", for example.

Bluetooth

With this connection, the android device connects directly to a Bluetooth serial telemetry link on the flight controller or to an OPLink module.

Read this article to set up Bluetooth telemetry for your board: Setup a bluetooth for telemetry. Set the connection in the settings dialog. 

Be sure to use 57600 baud or less. If you use Bluetooth and Oplink, use 38400 baud or less.

You have to pair your device with the normal settings of your android phone before you use Bluetooth. After that, you can choose the device in the settings dialog.

On leaving the settings dialog, the app tries to connect. This may take up to a minute.

For further inforamtion about Bluetooth and OPLink usage, refer to OPLinkConfiguration-Telemetry+RemoteControl+Bluetooth

Views

General

Menu

Toolbar

Local App Settings

If this button is visible, there are local settings available,
like changing the look and feel of the current view.

Flight Controller SettingsIf this button is visible, there are settings on the flight
controller available, like setting the fusion algorithm or
setting the battery capacity.


UAVO CheckLP2Go checks if the loaded UAVO are matching the flight
controller firmware. If this icon is green, everything is ok.
If it is red and doing crazy stuff, there is something wrong.
Click it to see further information. 


Serial ConnectionShows the current connection, either Bluetooth or USB.
While red and/or flashing, connection is being established.

UAVO Handshake

Both symbols need to be green for the UAVO handshake to
be successful. If unsuccessful, only explicitly requested objects are send from the flight controller.

If this is often turning red on Bluetooth, consider reducing the baud rate of the telemetry port and/or the Bluetooth module.

Health

System Health Panel

The system health panel is a representation of the health widget in the GCS. Details about the fields can be found on the SystemHealth wiki page.

There are some slight changes to the Panel, but it is basically the same as in GCS.

Error rendering macro 'multimedia' : com.atlassian.renderer.v2.macro.MacroException: Cannot find attachment 'system_health.swf'

The current communication with the flight controller is depicted on the health panel. Usually, there should not be a lot of bad packets, and a constant stream of sent  and received  packets.

Additional Info Panel

The following info is presented on the additional info panel:

  • Arming state (also avaliable as Text2Speech)
  • Flight Time = time span the flight controller is powered
  • Flight Battery Volt
  • Current Ampere drawn from the Flight Battery
  • Flight Battery mAh
  • Flight Time left (as calculated by the flight controller)
  • Current Altitude (tap to reset to zero)
  • Vertical Speed in meters/second
  • Current Flight Mode

To use the flight battery displays, you need to Configure a Current-Voltage sensor.

Local Settings

You can set if Text2Speech should be available in the health screen.

Flight Settings

You can set flight battery capacity and flight battery cells here, as well as the fusion algorithm used by the flight controller.

Map

The Map shows the last 5 positions of your librepilot device. The marker is rotated in the direction the GPS thought it was heading. On the top of the page, you can see the current GPS state.

Objects

Initially this view displays a list of all loaded UAVO.

After tapping a specific UAVO, the app tries to load the UAVO from the flight controller and displays it.

If it is a settings UAVO, you can edit the value by tapping on the pencil icon.

The dialog allows to save the settings, which means the object is saved persitent on the flight controllor, or to just upload it, meaning that it will be discarded on powering off the flight controller.

PID Tuning & Altitude Hold PID

To read about PID-Tuning, check Stabilization Configuration.

PID Tuning always loads the PID for the currently selected bank. Bank number is indicated to the lower right.

Vertical PID are global and not bank dependent.

After changing the bank via flightmode, you have to press the download button to get the new PID. Wait for the bank indicator to change and for at least some numbers to become red, then press download. Numbers are red if the currently shown numbers and the numbers on the FC differ. This happens if the bank on the FC changes, and therefore the PID, or if you change numbers locally. If the numbers on all banks are equal, no number will turn red.

To change a number, tap on it. A popup will appear where you can change it via slider, buttons or direct entry.

Tap the Upload Button to send the PID to the FC. After sending, red numbers should turn black again. Tap the Save Button to make the PID persistent. It will save the currently uploaded values and disregard any local changes.

Logs

Press  to start logging. Everything the App receives from now on will be logged. Any old log will be overwritten.
Press  to stop logging. The file is closed, nothing else happens. You can start a new log or share the saved log.
Press  to stop logging (if not yet done by pressing stop) and share the file. You can share it via Google Drive, WhatsApp, or whatever app is accepting "application/octet-stream".

I tested sharing with GDrive and Telegram Ultra. Telegram changes the filename to something strange, but content is ok.

The first size number is the size of the received UAV Objects, the second the size of the logs (UAVO + OPL Header)

Settings

You can set your serial connection type, as described in the "Connection" section.

With UAVO Source you can select a different Librepilot release. At the moment the 15.09 release UAVO's are shipped.

Loading new UAVO files is only needed if you are using a self compiled version of Librepilot, most notably "next"!

To load new UAVO's copy the UAVO file to your device and load it via load button. To clear all custom UAVO's, press the clear button.

Some UAVO files for different releases are generated at https://bintray.com/marcproe/LP2Go-UAVO/uavo/view/files/zip .

To generate your own UAVO file, zip all xml files in shared/uavobjectdefinition and use this zipfile.

You can use the following command in your windows build environment to create the uavo zipfile: 

cd shared/uavobjectdefinition && ../../tools/bin/7za a -tzip ../../next.zip *.xml && cd ../..

About

View Information and Licenses.

  • No labels