Make sure the unbind method is called for all registered subsystems proir to deleting...

[flightgear.git] / docs-mini / README.IO

diff --git a/docs-mini/README.IO b/docs-mini/README.IO
index 6e838c6e9ce47911aa950c25d2a9215c81282969..3d6c4a1707649b9f3fda80915947db089422ca8a 100644 (file)
--- a/docs-mini/README.IO
+++ b/docs-mini/README.IO
@@ -5,6 +5,7 @@ to "speak" any supported protocol over any supported medium.  The IO
 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,...
@@ -15,6 +16,24 @@ The general form of the command line option is as follows:
     hz = number of times to process channel per second (floating
          point values are ok.
 
+
+Generic Communication:
+
+    --generic=params
+
+    With this option it is possible to output a pre-configured
+    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
+    i/o to a file:                file,dir,hz,filename,protocol
+
+    See README.protocol for how to define a generic protocol.
+
+
 Serial Port Communication:
 
     --nmea=serial,dir,hz,device,baud
@@ -26,7 +45,8 @@ 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:
 
@@ -65,6 +85,14 @@ File I/O:
 
     --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:
 
@@ -111,3 +139,9 @@ HTTP Server 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
+