Android FrSky Dashboard - User Manual

This page describes the functionality of version 1.0 and 1.1 of the application. Visit User Manual v2 for more information on v2.0 of this application.

This application requires BlueTooth bridge to already work with the FrSky Tx module.

Dashboard

dashboard_not_connected.png
When you start the application. You will arrive on the Dashboard page. This page has the following features:
  • Status for
    • Bluetooth (Red when down, Green Blinking when connecting, Green when connected)
    • Connection to FrSky Tx Module (Green when connected to a FrSky Tx module)
    • Connection to FrSky Rx (Green when receiving data from a FrSky Rx)
  • Status values
    • RSSItx (dBm)
    • RSSIrx (dBm)
    • FPS (Frames pr second from Rx)
  • FrSky Analog Channel 1 (Configure by clicking the "..." button, see ChannelConfig)
  • FrSky Analog Channel 2 (Configure by clicking the "..." button, see ChannelConfig)
  • Cyclic Speaker Toggle Button, used to turn the cyclic readout of channels on and off

The application is designed so that it can run in the background. Typically by locking the phone, or by clicking your phone's "Home" key.

You exit the application by clicking the "Back" button on your phone.

Menu

dashboard_menu.png

If you hit the "Menu" key on your phone, you will get access to the following menu:
  • Settings...
  • Module Settings...
  • Connect...
  • Simulator...
  • About...

Settings... Application Settings

application_settings.png
The Application settings page controls the operation of the application and preferences. You get access to the following options:
  • Audio Settings: Settings controlling the audible aspects of the application
    • Set minimum volume upon startup: You can force the application to change the volume if it is below a certain level upon startup. The slider below is used to set the volume level. This option has no effect when not set.
    • Speaker Interval (sek): How often should the cyclic readout of channels happen
  • Logger Settings: Settings controlling what gets logged to file (Location: SDCard/Android/data/biz.onomato.frskydash/files)
    • Binary: Incoming frames is logged directly to binary file
    • Human readable: Incoming frames is logged as an ASCII representation of the hex values. This is for debugging only, and has limited value.
    • CSV: Channel Values will be logged to a CSV file that can be read by other programs.
  • Bluetooth Settings: Settings controlling the Bluetooth functionality
    • Auto-enable: If toggled, the application will automatically enable bluetooth if it is currently disabled. If not set, it will request the user to enable bluetooth when not enabled.
    • Auto-connect: If this option is set, the Application will attempt to automatically connect to the previously connected device.
  • Commands
    • Save: Save settings
    • Delete all logfiles: will remove all logfiles from SDCard/Android/data/biz.onomato.frskydash/files

Connect... Connect to Bluetooth device

ConnectToList.png
From here you can connect to a previously paired device, or scan for new devices. A pairing dialog will come up if you try to connect to a paired device.

dashboard_connected.png
When you have connected to a bluetooth device, the Bt status indicator will turn green. The application will then attempt to communicate with the FrSky Tx module.

dashboard_connected_2.png
When the application receives frames from a Rx. The Rx status indicator will turn green.

Channel Settings

channel_settings.png
By clicking the "..." button for a channel in the dashboard, you can define various settings for the channel:
  • Description: Shown on dashboard, and used while reading
  • Unit: e.g. "Volt", used when reading, and in CSV file
  • Short Unit, e.g. "V", shown on dashboard
  • Offset, Used for scaling, see below
  • Factor, Used for scaling, see below
  • Precision: Number of decimals after decimal point
  • Moving Average: Used to "smooth" the numbers. Number of frames being averaged. Set to -1 to disable Moving average
  • Spoken Cyclic: Include this channel in the readout when set
  • Save: Save the channel settings

Scaling

The application allows scaling of the incoming values to user desired unit. The formula used is:

Y: Shown Value
x: Incoming Value
f: Factor
o: Offset
Y = (x*f)+o

I typically need to set offset to 0, and tune the factor until i get the desired result. E.g. Cell Voltage to 4.17V at fully charged battery.
These numbers will also affect the Threshold values for the Internal FrSky alarms.

Module Settings... - FrSky Tx Module settings

module_settings.png
This page allows you to see and program the internal FrSky alarms.
Note! the Application can not read the current state of the RSSI alarms. These will therefore always show the default FrSky settings

For each alarm, you can set if the alarm should trigger when the current value is "Lower than" or "Greater than" the threshold. You can also set the alarmtype/volume of the alarm.
The threshold will show you the threshold in the proper unit if you have already set up the channel in the Channel Configuration.

Simulator...

simulator.png
This page is primarily used for debugging. It allows the user to send either single frames, or cyclic frames to the main application. Limited value for a user, but might assist in setting up scaling of a channel.

About... About the Application

about.png
Shows some information about the application

dashboard_connected_2.png (29.1 KB) Espen Solbu, 11/28/2011 11:23 am

dashboard_menu.png (34.1 KB) Espen Solbu, 11/28/2011 11:23 am

dashboard_not_connected.png (28.5 KB) Espen Solbu, 11/28/2011 11:23 am

module_settings.png (159 KB) Espen Solbu, 11/28/2011 11:23 am

about.png (37.1 KB) Espen Solbu, 11/28/2011 11:23 am

application_settings.png (80.2 KB) Espen Solbu, 11/28/2011 11:23 am

channel_settings.png (63.6 KB) Espen Solbu, 11/28/2011 11:23 am

simulator.png (29.3 KB) Espen Solbu, 11/28/2011 11:23 am

dashboard_connected.png (28.8 KB) Espen Solbu, 11/28/2011 11:23 am

ConnectToList.png (73.4 KB) Espen Solbu, 11/28/2011 12:44 pm