NAME

       UGsmooth - send UGear-formatted GPS data to a FlightGear instance

SYNOPSIS

       UGsmooth --help
           | --infile infile_name [options]...
           | --flight flight_dir [options]...
           | --serial dev_name --outfile outfile_name [options]...

DESCRIPTION

       UGsmooth  is  a  utility that reads GPS data in UGear format from a text file, a directory
       containing flight data or from a device connected to the serial port, parses it and  sends
       it to a FlightGear instance for replaying.

OPTIONS

       --help Display usage information and exit.

       --infile infile_name
              Read GPS data from infile_name.

       --flight flight_dir
              Read GPS data from the flight directory named flight_dir.

       --serial dev_name
              Read GPS data from the serial device named dev_name.

       --outfile outfile_name
              Save the data retrieved from the device to outfile_name.

       --hertz frequency
              Specify  the  frequency  to  use  for  sending data to the FlightGear instance.  By
              default, events are sent at a frequency of 60 Hz.

       --host hostname
              Send the data to the FlightGear instance running on hostname.

              If --host is not specified, the default is to send the data to localhost.

       --broadcast
              Send flight data model and control data as broadcast packets.

       --opengc-port port
              Set the port OpenGC data should be sent to. By default, data is sent to port 6000.

       --fdm-port port
              Set the port flight data model data should be sent to. By default, data is sent  to
              port 5505.

       --ctrls-port port
              Set the port control data should be sent to. By default, data is sent to port 5506.

       --groundtrack-heading
              Calculate  the  aircraft  heading  from  the  GPS velocity instead of using the raw
              heading recorded by the device.

       --ground-speed
              Calculate the ground speed from the GPS velocity instead of  using  the  raw  speed
              recorded by the device.

       --estimate-control-deflections
              Estimate  control  deflections from the angular velocities instead of using the raw
              deflections recorded by the device.

       --altitude-offset meters
              Add the specified offset (in meters) to the altitude sent to FlightGear.

       --skip-seconds seconds
              Do not transmit the first seconds seconds of data.

              This option is ignored when reading GPS data from a serial device.

       --no-real-time
              Do not update the elapsed time.

       --ignore-checksum
              Do not discard data with invalid checksums.

              This option is ignored when reading GPS data from a flight directory.

       --sg-swap
              Activate the special double swap  logic  for  the  (non-standard)  stargate  double
              format.

EXIT STATUS

       UGsmooth  exits  with 0 on success, with -1 if the syntax of the command-line arguments is
       wrong or an error occurs.

SEE ALSO

       fgfs(1), GPSsmooth(1), MIDGsmooth(1)