91 lines
3.5 KiB
Text
91 lines
3.5 KiB
Text
|
Dual control for FlightGear/CVS (copilot OSG only)
|
||
|
|
--------------------------------------------------
|
||
|
|
|
||
|
|
Anders Gidenstam (anders at gidenstam dot org)
|
||
|
|
|
||
|
|
This collection of Nasal code and instruments enables a pilot and
|
||
|
|
copilot to jointly fly an aircraft over the FlightGear multiplayer
|
||
|
|
network. Pilot and copilot can have shared control over primary
|
||
|
|
flight controls, throttle, mixture, elevator trim, flaps, brakes,
|
||
|
|
cockpit switches, part of the radio stack and instrument settings
|
||
|
|
and so on.
|
||
|
|
|
||
|
|
To use the system two "aircraft" needs to be created:
|
||
|
|
- The pilot uses the original aircraft (or a variant thereof).
|
||
|
|
The pilot need to specify the callsign of the copilot (other copilots
|
||
|
|
will be ignored).
|
||
|
|
|
||
|
|
Usage example:
|
||
|
|
fgfs --aircraft=ZLT-NT --prop:/sim/remote/pilot-callsign="copilot"
|
||
|
|
|
||
|
|
- The copilot uses a special "aircraft", <aircraft>-copilot, which
|
||
|
|
piggybacks on the designated pilot and captures the local control
|
||
|
|
inputs. A current limitation is that only the cockpit view
|
||
|
|
is jitter free. There is also a noticeable delay between control inputs
|
||
|
|
and effect, since they are passed via the the multiplayer protocol.
|
||
|
|
The severity of this delay depend on round trip time and some other
|
||
|
|
factors - the delay seems significantly longer than the round trip time
|
||
|
|
itself which is due to buffering in the MP protocol receiver.
|
||
|
|
That said, I have flown successfully as copilot in a setup with
|
||
|
|
100-120ms round trip time between both pilot and server and copilot and
|
||
|
|
server (total delay >500ms). Landing is a bit exciting in that
|
||
|
|
case, however.
|
||
|
|
|
||
|
|
Usage example:
|
||
|
|
fgfs --aircraft=ZLT-NT-copilot --prop:/sim/remote/pilot-callsign="pilot"
|
||
|
|
|
||
|
|
Visit http://www.gidenstam.org/FlightGear/DualControl/ for the latest
|
||
|
|
information.
|
||
|
|
|
||
|
|
|
||
|
|
Developer notes
|
||
|
|
---------------
|
||
|
|
|
||
|
|
The dual control mechanism is divided into to several parts:
|
||
|
|
- the generic core modules in DualControl/ ;
|
||
|
|
- the 3d instrument sharing wrappers in DualControl/instruments/ ; and
|
||
|
|
- the aircraft specific configuration in Systems/ZLT-NT-dual-control.nas
|
||
|
|
and the ZLT-NT/-set/-copilot-set files.
|
||
|
|
|
||
|
|
See the ZLT-NT aircraft for an example how everything come together.
|
||
|
|
|
||
|
|
aircraft_dual_control
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
The aircraft specific dual control Nasal module MUST be loaded as
|
||
|
|
aircraft_dual_control and MUST define the following variables and
|
||
|
|
functions:
|
||
|
|
|
||
|
|
pilot_connect_copilot(copilot) : returns a list of DCT components
|
||
|
|
Does whatever initialization needed to connect the copilot and
|
||
|
|
returns a list of dual-control-tools components whose update() method will
|
||
|
|
be called (in list order) once per frame.
|
||
|
|
copilot is the node hash for the base of the multiplayer tree for the
|
||
|
|
copilot user.
|
||
|
|
|
||
|
|
pilot_disconnect_copilot() : void
|
||
|
|
Does whatever cleanup needed when the copilot disconnects.
|
||
|
|
|
||
|
|
copilot_connect_pilot(pilot) : returns a list of DCT components
|
||
|
|
Does whatever initialization needed to connect to the pilot and
|
||
|
|
returns a list of dual-control-tools components whose update() method will
|
||
|
|
be called (in list order) once per frame.
|
||
|
|
pilot is the node hash for the base of the multiplayer tree for the
|
||
|
|
pilot user.
|
||
|
|
|
||
|
|
copilot_disconnect_pilot() :
|
||
|
|
Does whatever cleanup needed when the pilot disconnects.
|
||
|
|
|
||
|
|
|
||
|
|
pilot_type : string
|
||
|
|
The identifying string of the pilot aircraft is the path of the
|
||
|
|
3d model XML file of the pilot aircraft (as found in sim/model/path
|
||
|
|
under the multiplayer entry).
|
||
|
|
|
||
|
|
copilot_type : string
|
||
|
|
The identifying string of the copilot aircraft is the path of the
|
||
|
|
3d model XML file of the copilot aircraft (as found in sim/model/path
|
||
|
|
under the multiplayer entry).
|
||
|
|
|
||
|
|
|