User:Callahanp: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
I am a flight simulation hobbyist currently working on building instruments, gauges, radios and controls for a C172.  
I am a flight simulation hobbyist currently working on developing skills needed for  building instruments, gauges, radios and controls for a C172 and for contributing to flightgear's development.


== What I'm doing: ==
== What I'm doing: ==
While I participate very marginally in flightgear-devel, I'm ramping up my C++11 skills, learning more about git, getting to know a few editors, IDEs, Build and Debugging tools.  I hope to eventually be able 24-7 to build and effectively debug flightgear on any operating system, and to be able to support anyone else wishing to do so.


===[http://wiki.flightgear.org/User:Callahanp/fg-from-scratch Flightgear From Scratch]===
At the same time, I'm trying to form a coherent view of Flightgear's structure as an application.  Not as a user, but as a developer.  This involves gaining knowledge of the various subsystems that make up flightgear, the underlying technologies each subsystem uses and the flow of control and data  between these subsystems.


===[http://wiki.flightgear.org/User:Callahanp/FlightgearWorkingGroups Flightgear Working Groups]===


==== [[https://github.com/c172p-team/c172p C172P Team on Github ]] ====
[http://wiki.flightgear.org/User:Callahanp/Flightgear_Technical_Manual| Flightgear Technical Manual]
 
Proposed:
 
* Subsystem Management Group
* Property Tree Dwellers
* Vulcanologists
* Plib Janitors
* FDM Dev
* Flightgear Dev Onboarding
* Flightgear Dev Scenery
* Flightgear Dev Core
* Flightgear Dev Aircraft
* Flightgear Dev Airports
* Cockpit Builders
 
===[http://wiki.flightgear.org/User:Callahanp/Flightgear_and_Simgear_Code Flightgear and Simgear Code]===


Several years ago I began the effort to fully understand the skills needed to contribute to the Flightgear project's codebase. I started to look through various parts of the Flightgear code-base to understand how the parts fit together and how supporting libraries are used in the project.
[http://wiki.flightgear.org/User:Callahanp/fg-from-scratch Flightgear From Scratch]


This is an ongoing effort hampered by lack of time, my obsolete C++ training obtained in the early 1990's.
[http://wiki.flightgear.org/User:Callahanp/FlightgearWorkingGroups Flightgear Working Groups]


There's a LOT of code. Where do you start?
[[https://github.com/c172p-team/c172p C172P Team on Github ]]


{| class="wikitable"
[http://wiki.flightgear.org/User:Callahanp/Flightgear_and_Simgear_Code Flightgear and Simgear Code]
|-
! Component !! cxx Files !! hxx files !! cxx lines !! hxx lines
|-
| Flightgear || 583 || 548 || 218192 || 104251
|-
| Simgear || 352 || 396 || 114001 || 64718
|-
|}




Line 50: Line 26:
[[User:Callahanp/Flightgear_and_Simgear_Code/From_Command_Line_to_Holding_Short|From Command Line to Holding Short]]. A look at what gets called when you start Flightgear from the command line until you are on the runway.  This is a work in progress, somewhat stalled after Eduard Auvergne's initial work on subsystems.  It needs a re-vamp to make it current and publishable.
[[User:Callahanp/Flightgear_and_Simgear_Code/From_Command_Line_to_Holding_Short|From Command Line to Holding Short]]. A look at what gets called when you start Flightgear from the command line until you are on the runway.  This is a work in progress, somewhat stalled after Eduard Auvergne's initial work on subsystems.  It needs a re-vamp to make it current and publishable.


==== Flightgear Application Outline ====
I'm trying to come up with an outline of Flightgear's structure as an application.  
[http://wiki.flightgear.org/User:Callahanp/Flightgear_Technical_Manual| Flightgear Technical Manual]


First Steps:  


===== RTFM =====
===== RTFM =====
Line 74: Line 44:
Once they're read, is there a way to organize them so the result is an overview?
Once they're read, is there a way to organize them so the result is an overview?


Sure there is. Just write a book: working title: [Flightgear_Technical_Manual|Flightgear Technical Manual]
Sure there is. Just write a book:  
 
=====It's Data Driven - So Where's the data? =====
 
I've realized that much of the application is data driven, and that data is found in various places. These include files in one or another imaging format .ac files and configuration files of various types including xml files.  Each of these references will involve a path of some kind creating a relationship between material in one file with material in another.  There are path like structures to be found in data structures constructed within the application itself. This happens most notably in the property tree, but also in other independent data structures such as the  structure controlling subsystem initialization, ongoing processing, removal and re-initiialzation. 
To uncover some of these relationships and to locate and characterize the various processes involved, a close look at similar code fragments in a large number of files will enable you to uncover patterns that might otherwise elude you.
The basic technique will be o use an editor such as Atom, capable of doing a recursive global search through a set of files using a series of regular expressions.  Using regular expressions allows us to go from a more general search to one that is more specific.  All the following examples use atom's find in project - regex - case insensitive search.
 
A Question:  What are the major flows of data within the application between components.
 
The code fragments to search for To get a list of 
the include= vs <path> dichotomy is a distinction I'd like to investigate and describe further and the handlers for each of these "types" 
I thought it might be worth going down the rabbit hole to explore a bit. 
 
Keep in mind I'm looking for important concepts that I don't yet have in my outline.  The key to finding them is recognizing the variety of tags found in xml files.  For the moment, I'm looking for tags and other structural identifiers that refer to materials in other files.  
 
I'm also adding other concepts driven by data from xml files such as  animation, interpolation and the various types of tags with xml files found in the files for the C172p such as checklists, tutorials, instrument and signals.  examples of these are easy to find in an editor capable of text searching an entire project:
 
Try the following in atom and you'll see what I mean 
 
cd next/install 
atom . 
 
Use the atom FindInProject->Find All with any of the following.  Be sure to click on the regex button for the search
 
* include=
* <path>
* <path>.*\.xml
* <path>.*\.png
* <path>.*\.ac
 
etc.
Scanning the results of the search for include= reveals that they're all found in fgdata. 
 
* All include references to .xml files and the references themselves are found in xml files.
* There are 2117 of them in 1274 files.
* AI/Aircraft alone contains about 75% of the includes.  These are for individual liveries.
* Aircraft/c172p gives you a preview of the kind of xml strucures you'll find in any aircraft.  
* Aircraft/Generic contains about 5% of the includes. They include items for specific instruments, the walker, a logo,  
* ATC  contains a few files with xml includes related to ATIS.Compositor contains several xml includes. This one is likely to be important. 
* defaults.xml is likely to be a high level module and therefore important 
* Docs contains a number of README.xxxxx files, likely to be informative. Some have xml includes referenced in them. As I've mentioned, you should read every single one.
* Instruments contains about 5% of the includes. They include items for specific instruments, the walker, a logo,  
* Environment has two files one with filter tags related to xml files describing clouds and the other with tags for cloudLayers and volcanos. 
* Input has xml related to joysticks.  there's also a top level file  fgdata/joystics.xml 
* Materials makes up the remaining 15% of xml. it includes xml data related to runway textures and effects, buildings, geographic region textures and groups of objects.  
 
Scanning for <path> reveals a similar pattern, but <path> is used for more than just .xml files.
 
The total of 5067 <path> instances in 1745 files breaks down this way:
* .ac files with 1868 instances of <path> in  1509 files
* .rgb files with 798 in 108 files.
* .png files with 55 in 14 files
* .jpg 19 in 6 files
* .wav 113 in 9 files 
* .xsl 2 in 1 file 
* .http or .html 3 in 3 files
* .xml  with 2138 in 279 files 
 
The xml paths have a similar distribution pattern to the include= xml references, but further investigation is needed to discern how they are different.
 
Finally, <path> appears in Comments in 6 files, and is mentioned in 6 readme files.
 
<path> appears in one file 43 times with an <fgproperties> tag
 
==== Flightgear and Simgear Directory Descriptions and File Counts ====
 
[[User:Callahanp/Flightgear_and_Simgear_Files |Descriptions and file counts of flightgear/src and simgear/simgear subdirectories]]  What's where, What the heck is it anyway?
 
==== Flightgear/Simgear Code Exploration Project ====
 
see [http://wiki.flightgear.org/User:Callahanp/Flightgear_and_Simgear_Code Flightgear and Simgear Code]
 
==== Why I'm reading code ====
 
I'll be working on the interface between Flightgear and low level hardware in a panel or cockpit.  It is my understanding that others, including core Flightgear developers are also working on this and my efforts will  follow, derive from, depend on and I hope contribute in some small way to their work.  While I could just focus on the property tree and network interfaces, I still want a basic understanding of all areas of flightgear.
 
=== IDEs ===
=== IDEs ===


Working on Configurations for Eclipse and QTCreator IDEs
Working on Configurations for Visual Studio, Visual Studio Code, Atom, Eclipse and QTCreator IDEs




=== Figuring out how to contribute to FlightGear ===
=== Figuring out how to contribute to FlightGear ===
[http://wiki.flightgear.org/User:Callahanp/Flightgear_and_Simgear_Code/Onboarding Onboarding: Getting up to speed]


[[Getting things done in Flightgear]]
[[Getting things done in Flightgear]]


=== Progress on Cockpit Building ===
As of Feb 1, 2018:
* I've done only a few prototype circuits
* have been working to develop skills I'll need to produce a realistic cockpit. 
* Developing skills in Fusion 360 to support 3d Printing and 3d machine tools.
* Working on tests for a cluster based on Raspberry Pi Zeros
* Beginning to use a 3d Router
* Milling into thin prisms and hand polishing disks of plexiglass for illuminating dials in Sim Instruments


As part of my Cockpit Building efforts, I'm also working on
As part of my Cockpit Building efforts, I'm also working on
Line 183: Line 65:
  '''[[Special:EmailUser/Callahanp | Email Callahanp through the wiki]]'''
  '''[[Special:EmailUser/Callahanp | Email Callahanp through the wiki]]'''


I show up occasionally on #flightgear on irc.flightgear.org and am a member of several public forums related to cockpit building.
I show up occasionally on discord, #flightgear on irc.flightgear.org and am a member of several public forums related to cockpit building.


[[User:Callahanp|Callahanp]] ([[User talk:Callahanp|talk]]) 09:45, 11 November 2017 (EST)
[[User:Callahanp|Callahanp]] ([[User talk:Callahanp|talk]]) 09:45, 11 November 2017 (EST)
=== My Skills ===
* Programming in whatever language is available
* Databases
* Making the following list of chips do what they do:
* MCP23XXX Multiplexer
* MAX7219 Serially Interfaced, 8-Digit LED Display Driver
* Designing a few types of circuits that work on a breadboard (see electronics below)
===== My Developing Skills -- Beginner =====
* Grokking Flightgear's code base.
* Very basic machining on a lathe or mill - no significant experience
* Electronics - Basics - DC, High & Low speed digital circuits, motor control, emi suppression and mitigation
* Soldering - Learn to deal with small components
* Designing circuits that make it from breadboard to cockpit.
* Getting a cokpit project off the ground
* C++ - Updating coding skills from an early version of C++
* Avoiding Writing Howtos
===== My Developing Skills -- Making Good Progress =====
* Fusion 360 3dCad
* 3d Router
* Tormach 1100 CNC Mill
=== My Projects ===
==== [[ C172P Cockpit ]] ====
==== [[ Cockpit Inteface for Flightgear ]] ====
==== [[ Flightgear Editable Orthographic Views ]] ====
==== [[ Up to speed coding C++ for Flightgear ]] ====
===UFO? You decide...  ===
Flightgear of the Future.
There's been recent discussion of what it would take to write Flightgear from scratch today.
I think a better question is how to go about undertaking any major restructuring of Flightgear's codebase to take advantage of modern tools and techniques.  And I think we already have an answer to that.
In fact, there's an excellent example happening right now in the Spring of 2018. It's Edward's work on unit testing and the restructuring of the subsystem manager.  If you're interested in how big changes come about I'd suggest reading everything related to this effort rather closely and following the ongoing discussion over the need to refactor the way flightgear subsystem dependencies are handled.  Look not just for the technical details, but for the way Edward limited the scope of his current activity and for the quality of the interactions between the interested parties.  I think its a model for anything major anyone wants to undertake in Flightgear.  In fact this kind of interaction is nothing new in the flightgear project.  Other examples abound. Everything from the adoption of OSG to QT has gone through a similar process.
Those of us who want to be involved in ''big changes'' need to know this process well.  So read the mailing list entries in detail and notice the choices people are making and the reasons why.  The last thing anyone wants is divisive discussion over direction or choices already made. Especially where the root of the discussion is a misunderstanding or refusal to recognize how the project actually works over a period of time.
So now here's my take on what would be a big Flightgear code change - [[Multicore Processing and Clusters]].  The changes in play today lay the groundwork for this.
References:
* [https://sourceforge.net/p/flightgear/mailman/search/?q=If+you+were+to+write+FlightGear+today... If you were to write FlightGear today... ]
* [https://sourceforge.net/p/flightgear/mailman/search/?q=Designs+for+the+subsystem+manager%2Ffactory. Designs for the subsystem manager factory ]
* [https://sourceforge.net/p/flightgear/mailman/search/?q=Code+formatting+for+the+whole+FlightGear+codebase Code formatting for the whole FlighGear codebase ]
* [https://sourceforge.net/p/flightgear/mailman/search/?q=Questions+about+TestSuite Questions about the TestSuite ]
* [https://sourceforge.net/p/flightgear/mailman/search/?q=CppUnit+branches+for+merging%2C+and+an+event+manager+timer+queue+rewri CppUnit branches for merging ]


=== The Howtos ===
=== The Howtos ===
Line 252: Line 77:
Current Projects:
Current Projects:
* [[Howto:C172P Panel Project]]
* [[Howto:C172P Panel Project]]
* [[Howto:Build your own Panel or Cockpit]]  
* [[Howto:Build your own Panel or Cockpit]]
 
See below for the my personal rules about these howtos going forward.  I had to write these because it was becoming a morass and time waster.
 
'''The following is yet another work in progress'''
 
Writing Advice to Callahanp from Callahanp  or How to write a Howto.
 
Rule 1. Brevity.
 
Rule 2. Real Hardware & Software.  If I haven't done it yet I'll talk about it on my personal wiki page.  That's where stuff like that belongs. 
 
Rule 3. Project Planning, Building Teams, and anything else about developing a hobby project belong elsewhere.  If you want to write about these things, go ahead, but don't do it in a Howto on building something specific like a cockpit.  If you haven't done the project yet you'll get it wrong. Plus, you'll sound like a...
 
Rule 4. Grand visions, Vaporware, Abstract thinking, Advice and other nonsense  don't belong anywhere. 
 
Rule 5. Get rid of your darlings.  Those witty turns of phrase, that elegant prose, the puns, jokes and asides.  Fun to write maybe but not so fun to read.  They're distractions.  These are things a skillful writer can weave into an uninterrupted smooth train of thought but you're not that good a writer. Don't even try,
 
'nuff said.

Revision as of 17:56, 18 April 2020

I am a flight simulation hobbyist currently working on developing skills needed for building instruments, gauges, radios and controls for a C172 and for contributing to flightgear's development.

What I'm doing:

While I participate very marginally in flightgear-devel, I'm ramping up my C++11 skills, learning more about git, getting to know a few editors, IDEs, Build and Debugging tools.  I hope to eventually be able 24-7 to build and effectively debug flightgear on any operating system, and to be able to support anyone else wishing to do so.

At the same time, I'm trying to form a coherent view of Flightgear's structure as an application.  Not as a user, but as a developer.  This involves gaining knowledge of the various subsystems that make up flightgear, the underlying technologies each subsystem uses and the flow of control and data  between these subsystems.


Flightgear Technical Manual

Flightgear From Scratch

Flightgear Working Groups

[C172P Team on Github ]

Flightgear and Simgear Code


Tools

Tools for a Flightgear Developer (see also Tools of the Trade)

From Command Line to Holding Short

From Command Line to Holding Short. A look at what gets called when you start Flightgear from the command line until you are on the runway. This is a work in progress, somewhat stalled after Eduard Auvergne's initial work on subsystems. It needs a re-vamp to make it current and publishable.


RTFM
  • http://wiki.flightgear.org/FlightGear_Manual
  • fgdata/doc/img Look at each image in, noting the name of the image and what the image is trying to say
  • fgdata/doc/keyboard/map.pdf Note that key bindings can be specific to an aircraft. Note that the pdf was produced from a .tex file.
  • fgdata/Docs/model-combined.eff/README.model-combined.eff Read and not What's "rembrandt" - Key terms can be pulled from this document
  • fgdata/Serial/nmeafaq.txt Garmin - Key terms can be pulled from this document. This document describes a data protocol
  • AI_doc.html
  • FGShortRef.html
  • http://flightgear.org/Docs/FlightGear-FAQ.html
  • fgdata/Docs/fschool_0.0.3.pdf
  • fgdata/Docs/index.html
  • fgdata/Docs/model-howto.html
  • and lots of others - point is you have to read them all

Once they're read, is there a way to organize them so the result is an overview?

Sure there is. Just write a book:

IDEs

Working on Configurations for Visual Studio, Visual Studio Code, Atom, Eclipse and QTCreator IDEs


Figuring out how to contribute to FlightGear

Getting things done in Flightgear


As part of my Cockpit Building efforts, I'm also working on

Contact

 Email Callahanp through the wiki

I show up occasionally on discord, #flightgear on irc.flightgear.org and am a member of several public forums related to cockpit building.

Callahanp (talk) 09:45, 11 November 2017 (EST)

The Howtos

-- Oh yeah... those...

I'm working on these along side building my cockpit. Some of the early attempts were not that useful. My current approach is to build and document actual hardware. I hope this will be more helpful.

Current Projects:

Retrieved from "https://wiki.flightgear.org/w/index.php?title=User:Callahanp&oldid=123933"