Oscilloscope addon

From FlightGear wiki
Jump to navigation Jump to search
WIP.png Work in progress
This article or section will be worked on in the upcoming hours or days.
Note: Although still incomplete, the information it contains is valid and available.
See history for the latest developments.
This screenshot shows the usual c172p "magnetos checking" Channel 1 (yellow) is rpm (100 rpm / div).Channel 2 (mauve) is magnetos (1 / div).Time sweep is 200 ms / div.[1]

This oscilloscope was created as an example of the use of 3 helpers included in the addon:

*  skinnable.nas to create Canvas GUI dialogs including multiple clickable layers.
*  graph.nas to create various types of Canvas instruments.[2]
*  plot2D.nas the very basic Canvas helpers.
But apart from that, the oscilloscope itself may be an useful tool for developers and coders. Although I do not know any aircraft that has this instrument in its panel, the on-board engineer will eventually appreciate having it on hand at some point. 

Background

Cquote1.png I was just thinking today that it might be cool to have a built in grapher for simple / quick graphing needs.

With the property system it would be trivial to pick an arbitrary property from the property tree and graph it over time -- superimposed on top of everything else. Things get a bit trickier if you want to control scaling, how much time history get's graphed, multiple values, etc., but even graphing a single value (or maybe just two values) over time could be of some use.

I thought I'd toss this out there in case someone thought it was worth while enough to tackle.[3]
— Curtis Olson
Cquote2.png

How to install

Note  This is the latest version (Jan 30, 2018)

If your FGFS version accepts Addons, you can download this feature from the Addons Repository. Download all the 11 files into the directory of your choice. Launch FlightGear including --addon argument, eg.:

 fgfs <usual args> --addon=/path/to/fgaddon/Oscilloscope
Note  From version 2017.4.0, the FG launcher accepts the --addon option in his Settings/Additional Settings tab.

Otherwise, you can install it as a submodule. Contact the author for further instructions.

How to use

Manual mode

Just pressing the o key the oscilloscope window appears:

Oscilloscope (default skin).png

Clicking the ? button you'll have a basic help about clickable areas and readings. (click ? again to close help)

Connecting Channel Sources

Channel Source input dialog.

Click any BNC connector (Channel 1 or Channel 2) to open the input dialog.
Enter a valid source as:

  • Numeric or boolean Property address
eg.: /position/altitude-agl-ft
  • Numeric Nasal expression
eg.: getprop("/engines/engine/rpm") /100 ; (do not forget the ;)
  • any number
eg.: 5.5 (only useful to adjust Offset (Vert. position)
  1. rleibner  (Jan 6th, 2018).  Re: Plot2D and graph helpers .
  2. rleibner  (Dec 27th, 2017).  Re: Spoken GCA .
  3. Curtis Olson (Fri, 08 Mar 2002 07:43:35 -0800). idea ... (?).