Hi fellow wiki editors!

To help newly registered users get more familiar with the wiki (and maybe older users too) there is now a {{Welcome to the wiki}} template. Have a look at it and feel free to add it to new users discussion pages (and perhaps your own).

I have tried to keep the template short, but meaningful. /Johan G

Difference between revisions of "FG1000"

From FlightGear wiki
Jump to: navigation, search
(Commits)
(Commits)
Line 443: Line 443:
 
* {{fgdata commit|d0203549e833b32b719697b3a2c2a63e16fcef16|text=Add AirportInfo and template pages for FG1000}} (12/2017)
 
* {{fgdata commit|d0203549e833b32b719697b3a2c2a63e16fcef16|text=Add AirportInfo and template pages for FG1000}} (12/2017)
 
* {{fgdata commit|3d31775ff36bf3aa08a929992b70f32f2a525509|text=Initial commit of FG1000 MFD}} (11/2017)
 
* {{fgdata commit|3d31775ff36bf3aa08a929992b70f32f2a525509|text=Initial commit of FG1000 MFD}} (11/2017)
 +
 +
MapStructure related:
 +
 
* {{fgdata commit|4bd57492f454a05f725e6fe5a80dc246cb5e5e0f|text=GRID layer}} (10/2017)
 
* {{fgdata commit|4bd57492f454a05f725e6fe5a80dc246cb5e5e0f|text=GRID layer}} (10/2017)
 
* {{fgdata commit|d84c527ca747dd6bbd9634507f0664ff3631bdef|text=RWY, TAXI, TWR, PARKING}} (10/2017)
 
* {{fgdata commit|d84c527ca747dd6bbd9634507f0664ff3631bdef|text=RWY, TAXI, TWR, PARKING}} (10/2017)

Revision as of 12:30, 7 January 2018

PUI-canvas FG1000 early prototype using PUI dialog to speed up development
FG1000
Started in 07/2017
Description G1000-based MFD emulation
Contributor(s) Stuart, Richard (via Emesary)
Status Under active development as of 07/2017
Folders https://sourceforge.net/p/flightgear/fgdata/ci/next/tree/Aircraft/Instruments-3d/FG1000/
Changelog https://sourceforge.net/p/flightgear/fgdata/ci/cc152b67ada5820d6c8de96ac59799b71e267150/log/?path=/Aircraft/Instruments-3d/FG1000


Current Status

As per the original plan, Stuart has been in contact with the author (Sébastien MARQUE) of the ZKV-1000. While he himself doesn't plan to implement a G1000, he's very happy for it to be developed in that direction. Stuart's broad plan is to make a copy of this in fgdata or fgaddon, and use it as the basis for a G1000, taking the opportunity to use Richard's MFD code and making as generic pages as possible for other glass cockpit applications.[1]

As of 01/2018, an initial implementation of the MFD is available on git/next from the Debug Menu->FG1000. It includes a PUI-based surround, Engine Information System (EIS), page group selection using the FMS control.

Most of the underlying Canvas MapStructure layers are now written (though they require styling, and/or would benefit from replacement with vector data).

Stuart has been doing some further work on the FG1000 implementation over the christmas break 2017. Key changes are:

  1. Using Richard's Emesary IPC frame to link between the MFD and underlying simulation state. This should make it easy to run the MFD on a separate FG instance, and provides a good demarkation between the individual aircraft systems and the FG1000 itself.
  2. Create various underlying classes to support UI features - highlighting, editing. The idea here is that one can create the UI as an SVG file, and these are used to control it. For an example of this in use, see the Airport Information page. Press the CRSR knob to create a cursor on the ICAO airport ID, then use the inside FMS knob to start editing the ID. This should make creating most of the rest of the pages far easier. See Canvas MFD Framework for details of the elements now supported.

There's still a huge number of pages to write, and the pages around route planning will likely be particular "fun", but it should be far faster now these blocks are in place.

The FG1000 wiki page shows the pages that have been created so far (4 out of 28!). Stuart is pretty happy with the overall architecture now, so if anyone wants to create some of the pages they are very welcome to do so![2]

Next steps:

  • Writing the remaining (large) number of pages
  • Styling the pages - making the iconography match Garmin exactly.

This is the current status of the individual pages. "Done" indicates that they are functionally complete, though the iconography is not correct.

Page Reference Status Notes
Navigation Map Done See Layers below
Traffic Map Done Zoom controls unclear
Stormscope Not Started
Weather Data Link Not Started
TAWS-B Not Started
Stormscope Not Started
Airport Information Done Needs additional page of AOPA information, which we don't have
Intersection Information Not Started
NDB Information Not Started
VOR Information Not Started
User WPT Information Not Started
Trip Planning Not Started
Utility Not Started
GPS Status Not Started
XM Radio Not Started
System Status Not Started
Intersection Information Not Started
Active Flightplan Not Started
Flight Plan Catalog Not Started
Stored Flight Plan Not Started
Checklist 1-5 Not Started
Nearest Airports Done
Nearest Intersections Not Started
Nearest NDB Not Started
Nearest VOR Not Started
Nearest User Waypoints Not Started
Nearest Frequencies Not Started
Nearest Airspaces Not Started

This is the current status of the major functional elements

Area Status Notes
Navigation - FMS Complete
Softkeys Complete
MENU key Not started
Header (COM/NAV/GPS Started NAV/COMM state is pushed from standard properties, but the fascia buttons are not yet connected.

Motivation

1rightarrow.png See Canvas_News#Moving_map.2FRNAV_discussion for the main article about this subject.

The enormous variety in current glass flight decks means we really need to think of a new way of defining glass cockpit layouts.[3]


The airspace system is in the process of changing drastically [...] this isn't just a matter of throwing up a canvas showing some GPS waypoints and a magenta line. Modern navigators are astoundingly-complex devices — probably an order of magnitude more lines of code than FlightGear itself — and even their basic flight planning algorithms and databases (e.g. fly-by waypoints vs fly-over waypoints, open vs closed approach procedures, transitions into RNAV approaches, etc.) are far beyond the scope of anything we've tried, and we'd also need an up-to-date database far more complex than the ones we have now. Once you get to the extra features, like FIS-B weather or TIS-B traffic info over ADS-B, or TAWS (terrain alerting), we're probably in way over our heads trying to emulate even the simplest general-aviation IFR GPS.

This may help folks understand what the G1000 is all about: http://static.garmincdn.com/pumac/190-00498-07_0A_Web.pdf Writing a G1000 isn't that hard. Writing a feature complete G1000 is a ton of work. [4]


Depending on how we deal with this challenge, the question is whether that means that the usefulness of FlightGear will also gradually taper off. [5]

Instead of just making one-off tweaks like the consumer sims did, we (as a team) emulated entire systems like the vacuum, pitot-static, and electrical systems, so that failures would be realistic. In the RNAV age, we need to do the same thing; it's just that it's a bigger job. FlightGear will still be great for people who want to practice the mechanical parts of flying (e.g. crosswind wheel landings in a Cub), but will slip further and further behind for people who want to use it for real IFR practice.[6]

Background

1rightarrow.png See Complex Canvas Avionics for the main article about this subject.

Challenges

Performance

Nasal as such is fast, and compared with the cost of rendering the terrain, rendering a canvas display is fast on the GPU (you can test by rendering but not updating a canvas display), and unless you're doing something very inefficient, calculating a display but not writing it to the property tree is fast (you can test this by disabling the write commands). It's the property I/O which you need to structure well, and then canvas will run fast. And of course the complexity of your underlying simulation costs - if you run a thermal model underneath to get real temperature reading, it costs more than inventing the numbers. But that has nothing to do with canvas. [7]


it's a lot of work to code all these displays which someone has to do, but there's no reason to assume it'd be hopeless performance-wise.[8]

we need to be realistic here: The G1000 is a fairly significant piece of computer hardware that we're going to emulate. It's not going to be "free" particularly for those on older hardware that's already struggling. However, hopefully we can offload a chunk of the logic (route management, autopilot/flight director) to the core, and do things like offline generation of terrain maps to minimie the impact.[9]

Route Manager

that's exactly the kind of device James hopes the new code can support. He's read the G1000 pilot's manual, and *thinks* that nearly all the functions can be provided by the current GPS code It would be great if people could look over the current GPS features and indicate any pieces you think might be missing - additional commands, additional search features, extra data, or anything really. [10]

tile servers

Please keep in mind that most tile servers discourage bulk downloads. For the whole planet,oomlevel 8 is approx. 67k files, at zoomlevel 9 you have 265k, level 10 has a little over one million tiles. And one would probably want to go up to level 15 (roughly 1e9 files)[11]

Offline mode

would it be possible to provide an offline tool to pre-fetch a region, like TerraMaster, or terrasync.py? Call me old-fashioned or paranoid, but I don't want FG to go online and do stuff automatically, I prefer downloading what I need manually so that I know what gets onto my harddisk. Also - think of all the people with poor home internet which might have larger bandwidth only in a library elsewhere.[12]

that would certainly be possible - the code retrieving the data is pretty trivial and porting the Nasal code to python or some other script should be straightforward.[13]

Navdata

we need some better data sources, especially with direct routing replacing airways in many areas, and having airspace data would help the map displays, but the current API is specifically designed to support G430, G1000 and similar class devices. Adding RNAV approaches is eminently doable, see the the RNavController base class which the GPS/FMS layer uses to allow new waypoint / route segments to define how they are flown and drive CDIs [14]


Getting the algorithms right, and keeping the data up to date every 7 weeks (we have only a tiny sliver of that data currently), is going to be much more of a challenge. I expect that it's probably an order of magnitude more complicated than our current flight dynamics (etc.), so we'd have to grow our contributor base, and find funding to pay at least Curt (and maybe a couple of others) full time to manage the project. Note that that's what has happened for other complex FOSS projects, like office suites and browsers, which generally end up working through a foundation, rather than our current relaxed circle-of-friends arrangement. The reason it's so much harder now is that the software *is* the product for GPS navigators, FMSs, etc. (unlike with older avionics, where the hardware was the main thing). That means that emulating even a simple unit like the GTN 650 or GNS 430W is almost difficult as building one, so we're trying to keep up with armies of full-time software developers at Garmin, Avidyne, etc.[15]


According to the Route Manager wiki page, we already have support for SID/STAR data provided from Navigraph, which is released on the AIRAC cycle, and costs a pretty small amount (9 EUR for a single download of FMS data, or 90 EUR per year) Given the relatively low cost, I don't think that we as an organiation want to get into trying to digitize data ourselves just to make it open-source or public domain. Particularly given the low cost of a download. We might want to digitize the STAR/SIDs for the default airport with each release so there are some approaches available for those who don't want to purchase the data.[16]

Vector Data

everyone agrees we would like to add airspace data - what we’re missing is a suitable data source with the correct license. Torsten found a raster-based source but for wider use in the sim we really need vector data, so we can render it ourselves directly. [17]

Airport Data (US - only )

At least for the US, all required information is available in the form of regularly updated UDFF files:

It would seem relatively straightforward to provide a scripted parser to create the corresponding charts procedurally. As a matter of fact, this could even be done in a background thread or using a separate Python script, i.e. if we wanted to ship pre-created imagery as part of fgdata.

However, if the built-in Canvas system is extended to provide these charts, Phi could also be entirely self-contained by rendering the same airport charts without having to depend on external data sources.


Layers

Following is the list of layers displayed by the G1000 system (see page 153 of the 190-00498-07 Rev. A), and mapping to the equivalent MapStructure Layer. Many of these would also be good to have for other avionics/GUI dialogs, including the NavDisplay framework, which is currently re-implementing this functionality separately, i.e. not yet using MapStructure.

Following is the list of layers displayed by the G1000 system, based on the Garmin G1000 Integrated Flight Deck Pilot's Guide for the Cessna Nav III Garmin Site Wayback machine, page 153, and the mapping to the equivalent MapStructure Layer.

Richard mentioned that if he were to implement approach plates in the EFB he'd probably use raster images provided via http and provide an http service within FG to do this, or to allow the EFB to use any other external web service. Other content for the EFB could be also provided as SVG via http.[18]

Layer MapStructure Layer Status Page Notes
Flight Plan Route Lines RTE Requires styling p.190
Flight Plan Route Waypoints WPT Requires styling p.190
Rivers/Lakes VFRChart p.148 Currently using downloaded raster from web. Perhaps generate similarly to Atlas[19], or could be vector data from scenery. Tom originally suggested to render an ortographic view of the scenery/terrain to the canvas, thus the atlas-based approach should also work using Icecode GL's recent camview element.
Topography Data VFRChart Synthetic p.145 Height-map at chart-resolution. Perhaps generate similarly to Atlas? Tom originally suggested to render an ortographic view of the scenery/terrain to the canvas, thus the atlas-based approach should also work using Icecode GL's recent camview element.
International Borders p.148 Vector data from scenery?
Track Vector p.156 Forward looking display of track. Look-ahead time selectable.
Navigation Range Ring p.159 Straightforward extension of APS.
Fuel Range Ring 159 Straightforward extension of APS.
Terrain Data 364 Should be straightforward, with exception of obstacles. Profile view also required.
Traffic TFC 394,423 Various options, each with different iconography and data displayed.
Airways VFRChart 154 Needs to be replaced with vector data
NEXRAD 282 Heaps of weather data with complex symbology.
XM Lightning Data WXR Change to symbol for lightning? 294 Optional
Airports APT, RWY Require re-style based on size 149, 163
Runway Labels RWY 148 Needs to be added to RWY. Should be straightforward
Restricted OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
MOA (Military) OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
User Waypoints
Latitude/Longitude Grid GRID
NAVAIDs APT, VOR, FIX, NDB Requires styling 162
Class B Airspaces/TMA OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
Class C Airspaces/TCA OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
Class D Airspaces OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
Other Airspaces/ADIZ OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
TFRs 310
Obstacles OpenAIP 182 Currently using downloaded rasters. Would be better replaced with vector data, see original plans at Canvas_Maps#Vector_data.
Land/Country Text 148 Currently using raster data from web. Replace with POI?
Cities VFRChart 148 Currently using raster data from web. Perhaps generate similarly to Atlas, or could be vector data from scenery. Tom originally suggested to render an ortographic view of the scenery/terrain to the canvas, thus the atlas-based approach should also work using Icecode GL's recent camview element.
Roads VFRChart 148 Currently using raster data from web. Requires vector data from scenery
Railroads VFRChart 148 Currently using raster data from web. Requires vector data from scenery
State/Province Boundaries VFRChart 148 Currently using raster data from web. Requires vector data from scenery
River/Lake Names VFRChart 148 Currently using raster data from web. Replace with POI?
Selected Altitude Intercept Arc 161 Simple extention to APS
SafeTaxi (Optional) RWY, TAXI 493 We don't currently have the data to display taxiway identifier or holding points
ChartView (Optional) 503 Rendering of PDFs. Might be possible to integrate with NaviGraph chart data?
FliteChart (Optional) 521 Rendering of PDFs. Might be possible to integrate with NaviGraph chart data?

Existing work

Avionics / Cockpits

Nasal / Canvas

C++

  • Atlas map creation
  • Synthetic Vision element for rendering viewmgr views to a Canvas
  • Canvas PDF element - for rendering PDF files (think EFB functionality)

Possible Work

The layers table shown above mentions a few limitations and ideas, such as:

Nasal/Canvas

C++

  • fix up projection issues, and adopt Gijs' projection handling code for the hard-coded PUI Map, to get rid of the standard Sanson-Flamsteed projection
  • adding a profile view, probably in conjunction with terrain sampling
  • using atlas code to generate heightmaps/topography
  • adding ESRI shapefile support to the Canvas system
  • adding PDF rendering support the Canvas system

Design

The broad structure of the Nasal files in Aircaft/Instruments-3d/FG1000/Nasal is as follows:

  • MFD.nas - top level MFD device, loads the other Nasal files (likely to be moved elsewhere later) and pages.
  • PageGroupControllers.nas - controller for the Page Group display in the bottom right of the MFD, controlled by the FMS knob, and which allows selection between different page groups and individual pages.
  • [PageName]/[PageName].nas - MFD page, inheriting from the MDF_Generic.PFD_Page. Creates any required MapStructure and hierarchy of softkeys.
  • [PageName]/[PageName]Controller.nas - Controller for the MFD page and the MapStructure layers.
  • [PageName]/[PageName]Style.nas - Style controls for the MapStructure layers for the give Page.
  • [PageName]/[PageName]Options.nas - Options for the MapStructure layers for the give Page.

Resources

Related

Commits

This section is intended to help keep track of related fgdata commits, so that if/when the project should stall, people can more easily look up related changes.


MapStructure related:

References

References
  1. Stuart Buchanan  (Aug 1st, 2017).  [Flightgear-devel] G1000 (was Re: Nasal property lookup performance) .
  2. Stuart Buchanan  (Jan 5th, 2018).  Re: [Flightgear-devel] FG1000 Status Update .
  3. Robin van Steenbergen  (Oct 2nd, 2007).  Re: [Flightgear-devel] Glass cockpit and external gauges. .
  4. geneb  (Jul 3rd, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  5. David Megginson  (Jul 3rd, 2017).  [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  6. David Megginson  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  7. Thorsten Renk  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  8. Thorsten Renk  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  9. Stuart Buchanan  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  10. James Turner  (Oct 22nd, 2009).  Re: [Flightgear-devel] ZKV500 GPS instrument; (New?) GPS code bug .
  11. Torsten Dreyer  (Sep 29th, 2017).  Re: [Flightgear-devel] Canvas MapLayer for OpenStreetMap, OpenAIP, VFR Sectionals .
  12. Thorsten Renk  (Sep 29th, 2017).  Re: [Flightgear-devel] Canvas MapLayer for OpenStreetMap, OpenAIP, VFR Sectionals .
  13. Stuart Buchanan  (Sep 29th, 2017).  Re: [Flightgear-devel] Canvas MapLayer for OpenStreetMap, OpenAIP, VFR Sectionals .
  14. James Turner  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  15. David Megginson  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  16. Stuart Buchanan  (Jul 4th, 2017).  Re: [Flightgear-devel] RFD: FlightGear and the changing state of air navigation .
  17. James Turner  (Jan 5th, 2018).  Re: [Flightgear-devel] [flightgear/simgear] Nasal regex patch .
  18. Richard  (Sep 29th, 2015).  Re: .
  19. Torsten  (Mar 17th, 2014).  Re: Atlas still in use ? .