User:Zakharov/zkv1000 installation guide: Difference between revisions
(Created page with "left|caption|link=Howto:Aerial refueling<br clear=all> <!-- ITS AN TAG TO STOP THE TEXT FLOW AND START AGAIN UNDER THE IMAGE. OTHERWHISE THE NEXT HEAD...") |
No edit summary |
||
Line 1: | Line 1: | ||
[[ | [[Image:Routemanagerready.png|link=Route Manager]] | ||
[[Image:Rembrandtready.png|link=Rembrandt]] | |||
[[Image:Canvasready.png|link=Canvas]] | |||
<!--[[Image:Tutorialready.png|link=Tutorials]] | |||
[[Image:Checklistready.png|link=Aircraft Checklists]]--> | |||
== Get the sources == | == Get the sources == | ||
the whole zkv1000 can be retrieved from https://sebmarque.hd.free.fr/git/seb/zkv1000. You will have the choice with different ways (git, zip or tar.gz). | the whole zkv1000 can be retrieved from <tt>https://sebmarque.hd.free.fr/git/seb/zkv1000</tt>. You will have the choice with different ways (git, zip or tar.gz). | ||
You have the choice of the destination of the source (in order of recommandation) | You have the choice of the destination of the source (in order of recommandation) | ||
# in $FGHOME/Aircraft/Instruments-3d | # in <tt>$FGHOME/Aircraft/Instruments-3d</tt> | ||
# in your aircraft directory | # in your aircraft directory | ||
# in $FGDATA/Aircraft/Instruments-3d | # in <tt>$FGDATA/Aircraft/Instruments-3d</tt> | ||
We'll refer to the zkv1000 installation directory as <tt>$ZKV1000</tt> later in this document | |||
== Installation in the cockpit == | == Installation in the cockpit == | ||
The glass cockpit and the material around are included in the sources, but you can provide yours. Please see the advanced installation below. | The glass cockpit and the material around are included in the sources, but you can provide yours. Please see the advanced installation below. | ||
Line 20: | Line 26: | ||
! Configuration !! Files needed | ! Configuration !! Files needed | ||
|- | |- | ||
| PFD only || $ZKV1000/pfd-pilot.xml | | PFD only || <tt>$ZKV1000/pfd-pilot.xml</tt> | ||
|- | |- | ||
| MFD only || $ZKV1000/mfd.xml | | MFD only || <tt>$ZKV1000/mfd.xml</tt> | ||
|- | |- | ||
| 1 PFD + 1 MFD || $ZKV1000/pfd-pilot.xml + $ZKV1000/mfd.xml | | 1 PFD + 1 MFD || <tt>$ZKV1000/pfd-pilot.xml</tt> + <tt>$ZKV1000/mfd.xml</tt> | ||
|- | |- | ||
| 2 PFD + 1 MFD || $ZKV1000/pfd-pilot.xml + $ZKV1000/pfd-copilot.xml + $ZKV1000/mfd.xml | | 2 PFD + 1 MFD || <tt>$ZKV1000/pfd-pilot.xml</tt> + <tt>$ZKV1000/pfd-copilot.xml</tt> + <tt>$ZKV1000/mfd.xml</tt> | ||
|} | |} | ||
Line 83: | Line 89: | ||
! Category !! Option !! Meaning !! Values | ! Category !! Option !! Meaning !! Values | ||
|- | |- | ||
| alerts || Vx || default Vx speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | | <tt>alerts</tt> || <tt>Vx</tt> || default Vx speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | ||
|- | |- | ||
| alerts || Vy || default Vy speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | | <tt>alerts</tt> || <tt>Vy</tt> || default Vy speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | ||
|- | |- | ||
| alerts || Vr || default Vr speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | | <tt>alerts</tt> || <tt>Vr</tt> || default Vr speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | ||
|- | |- | ||
| alerts || Vglide || default Vglide speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | | <tt>alerts</tt> || <tt>Vglide</tt> || default Vglide speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value || a number | ||
|- | |- | ||
| alerts || stall-aoa || The stalling angle of attack, if defined it is displayed in AOA widget || a number | | <tt>alerts</tt> || <tt>stall-aoa</tt> || The stalling angle of attack, if defined it is displayed in AOA widget || a number | ||
|- | |- | ||
| alerts || approach-aoa || The expected angle of attack at approach phase, if defined it is displayed in AOA widget || a number | | <tt>alerts</tt> || <tt>approach-aoa</tt> || The expected angle of attack at approach phase, if defined it is displayed in AOA widget || a number | ||
|- | |- | ||
| eis || type || the type of EIS on MFD only, defaults to none || "none" means... none, the other possible values are the nasal definitions of file as in $ZKV1000/Nasal/eis (without the .nas extension) or the relative path to your definition specific to your aircarft | | <tt>eis</tt> || <tt>type</tt> || the type of EIS on MFD only, defaults to none || "none" means... none, the other possible values are the nasal definitions of file as in <tt>$ZKV1000/Nasal/eis</tt> (without the .nas extension) or the relative path to your definition specific to your aircarft | ||
|} | |} | ||
More options to come... | More options to come... | ||
The zkv1000 Nasal code is loaded at the end of the FDM initialization. Knowing that if you want to automagically switch on the zkv1000 there is a function named < | The zkv1000 Nasal code is loaded at the end of the FDM initialization. Knowing that if you want to automagically switch on the zkv1000 there is a function named <code>zkv1000.powerOn()</code>, otherwise there is a predefined multikey {{key press|:}}{{key press|z}}{{key press|o}} witch will call the <tt>powerOn()</tt> function | ||
This should work and you and your aircraft's users should enjoy the instrument :) | This should work and you and your aircraft's users should enjoy the instrument :) | ||
== Advanced installation == | == Advanced installation == | ||
The most important is to keep the name of the 3D object about | The most important is to keep the name of the 3D object about |
Revision as of 17:36, 20 July 2017
Get the sources
the whole zkv1000 can be retrieved from https://sebmarque.hd.free.fr/git/seb/zkv1000. You will have the choice with different ways (git, zip or tar.gz).
You have the choice of the destination of the source (in order of recommandation)
- in $FGHOME/Aircraft/Instruments-3d
- in your aircraft directory
- in $FGDATA/Aircraft/Instruments-3d
We'll refer to the zkv1000 installation directory as $ZKV1000 later in this document
Installation in the cockpit
The glass cockpit and the material around are included in the sources, but you can provide yours. Please see the advanced installation below.
The zkv1000 provides files in order to let you choose if you want a PFD, a MFP, both of them, or two PFDs and one PFD.
So the installation depends on what you want. Place in your cockpit the following files in the XML definition files of your aircraft
Configuration | Files needed |
---|---|
PFD only | $ZKV1000/pfd-pilot.xml |
MFD only | $ZKV1000/mfd.xml |
1 PFD + 1 MFD | $ZKV1000/pfd-pilot.xml + $ZKV1000/mfd.xml |
2 PFD + 1 MFD | $ZKV1000/pfd-pilot.xml + $ZKV1000/pfd-copilot.xml + $ZKV1000/mfd.xml |
Here's an example from the Lancair 235, configuration with a PFD in front of the pilot's seat and a MFD between the pilot's seat and the copilot's seat, a bit inclinated in direction of the pilot. These lines take place in the dedicated file about the cockpit definition.
<model>
<path>Aircraft/Instruments-3d/zkv1000/pfd-pilot.xml</path>
<offsets>
<x-m> -0.023 </x-m>
<y-m> -0.235 </y-m>
<z-m> -0.028 </z-m>
</offsets>
</model>
<model>
<path>Aircraft/Instruments-3d/zkv1000/mfd.xml</path>
<offsets>
<x-m> 0.03 </x-m>
<y-m> 0.06 </y-m>
<z-m> -0.028 </z-m>
<heading-deg> -15 </heading-deg>
</offsets>
</model>
make it work
Once your device is installed in your cockpit you may tell FligthGear where to find the underlying Nasal code. This is done in the <nasal> section of your aircraft definition. Obviously this is one of the manadatory step and value, the Nasal namespace must be zkv1000.
<zkv1000>
<file>Aircraft/Instruments-3d/zkv1000/zkv1000.nas</file>
</zkv1000>
You have other options you can pass to the device in the <instrumentation> section of your aircraft definition
<instrumentation>
...
<zkv1000>
<alerts>
<Vx>15</Vx>
<Vy>110</Vy>
<Vr>65</Vr>
<Vglide>80</Vglide>
<stall-aoa>12</stall-aoa>
<approach-aoa>4</approach-aoa>
</alerts>
<eis>
<type>single-prop</type>
</eis>
</zkv1000>
...
</instrumentation>
The available options are
Category | Option | Meaning | Values |
---|---|---|---|
alerts | Vx | default Vx speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value | a number |
alerts | Vy | default Vy speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value | a number |
alerts | Vr | default Vr speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value | a number |
alerts | Vglide | default Vglide speed, displayed with a mark in the PFD's speed tape, may be modified by user, no default value | a number |
alerts | stall-aoa | The stalling angle of attack, if defined it is displayed in AOA widget | a number |
alerts | approach-aoa | The expected angle of attack at approach phase, if defined it is displayed in AOA widget | a number |
eis | type | the type of EIS on MFD only, defaults to none | "none" means... none, the other possible values are the nasal definitions of file as in $ZKV1000/Nasal/eis (without the .nas extension) or the relative path to your definition specific to your aircarft |
More options to come...
The zkv1000 Nasal code is loaded at the end of the FDM initialization. Knowing that if you want to automagically switch on the zkv1000 there is a function named zkv1000.powerOn()
, otherwise there is a predefined multikey :zo witch will call the powerOn() function
This should work and you and your aircraft's users should enjoy the instrument :)
Advanced installation
The most important is to keep the name of the 3D object about