options are configured at runtime via command line options. You can
specify multiple entries if you like, one per command line option.
+
The general form of the command line option is as follows:
--protocol=medium,direction,hz,medium_options,...
hz = number of times to process channel per second (floating
point values are ok.
-Generic Communction:
+
+Generic Communication:
--generic=params
With this option it is possible to output a pre-configured
- ASCII string using a predefined seperator. The configuration is
- defined in an XML file located in the Protocol directiory of
- the base package.
+ ASCII string or binary sequence using a predefined separator.
+ The configuration is defined in an XML file located in the
+ Protocol directory of the base package.
params can be:
serial port communication: serial,dir,hz,device,baud,protocol
socket communication: socket,dir,hz,machine,port,style,protocol
- output to a file: file,dir,hz,filename,,protocol
-
-
- The confinfiguration file is defined as follows:
-
- <?xml version="1.0"?>
- <PropertyList>
-
- <generic>
- <output>
- <seperator>\n</seperator>
-
- <chunk>
- <name>speed</name> <!-- for readabillity -->
- <type>int</type> <!-- one of: bool,int,float,string -->
- <format>V=%d</format> <!-- output format string -->
- <node>/velocities/speed</node> <!-- location of the value -->
- <offset>0.0</offset> <!-- add this to the value -->
- <factor>1.0</factor> <!-- multiply by this value -->
- </chunk>
-
- <chunk>
- ...
- </chunk>
-
- ...
+ i/o to a file: file,dir,hz,filename,protocol
- </output>
- </generic>
- </PropertyList>
+ See README.protocol for how to define a generic protocol.
Serial Port Communication:
--nmea=serial,out,0.5,COM1,4800
- Note that for unix varients you might use a device name like "/dev/ttyS0"
+ Note that for unix variants you might use a device name like "/dev/ttyS0"
+
Socket Communication:
--native=file,in,10,flight1.fgfs --fdm=external
+ You can make the replay from a file loop back to the beginning
+ when it reaches the end of the file with the "repeat" flag:
+
+ --generic=file,in,20,flight.out,playback,repeat
+
+ With a numeric argument, FlightGear will exit after that number of repeats.
+ --generic=file,in,20,flight.out,playback,repeat,5
+
Moving Map Example:
When a value is displayed, you can click on it to bring up a form
to assign it a new value.
+
+
+ACMS flight data recorder playback
+
+ fgfs --fdm=acms --generic=file,in,1,<path_to_replay_file>,acms
+