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)