Le ZKV1000

Sébastien MARQUE adds type highlighted
Latest commit fc6306e 7 years ago
README.md

ZKV1000, just after boot ZKV1000 just after booting, installed in the Lancair 235 (all other instruments removed)
other pictures available here

Thanks

Thanks to the modeller of the GDU104X project "Farmin/G1000"(can't remember who, if he/she can tell me...) I can continue the work began many years ago with a nicer (and working) 3D model instrument. Thanks to him/her for the SVG basis file too.
Thanks to Hooray's nice efforts, and some examples ans snipsets of code here and there from the Canvas team.
Thanks to all FlightGear community for the funny project I let too many years off side...

Origin

The first ZKV1000, which was completly XML animated, was completly abandonned. Moreover the Nasal code became unmaintanable from my point of view. Not sure this one is better, but I think it is at least more modulable.

The origin is to simulate a Garmin Primus 1000, as near as possible of the documentation found.

But as we are in a simulation, the zkv1000 is definitly not a replica of the well-known G1000, as it takes the liberty to be integrated with some features that doesn't exit in the real device, as well as some real features aren't scheduled to be implemented. But, it should be easy to add or remove features in order to get the real device. This is GPL-2 license though :)

Objectives

There is no intention to provide a fully qualified G1000 in order to train or so, but this should be possible to be done from the zkv1000.

I'm particulary looking at these points:

  1. easy to implement new features
  2. optimized code (from my non-dev point of view...)
  3. easy to integrate in every cockpit with only few lines, and with easy use for the pilot
  4. near from the G1000 documentation but with some neat features added, and some unrelevant features in a sim removed

Progress

Note: this is not because the progress bar show 100% that it means it is 100% bug free :) Please report bug at seb.marque@free.fr.

    • Basic Flight Instrumentation: AI, IAS, ALT, HDG
    • Wind data widget
    • trends for altitude and speed (6s prevision)
    • TAS and Ground Speed display
    • VSI
    • 3D knobs rotate
    • map display on inflight page (with online maps downloading and caching)
    • display of NavAids on map
    • XPDR from SoftKeys and knob, with respect of delays from the manual
    • Selected altitude bug (widget off if IA within 100ft)
    • baro settings
    • SoftKeys menus navigation for PFD and MFD: not yet implemented function are logged in console , softkeys colorized when active , alerts with white backgroud and black text available
    • CDI
    • OMI
    • Slipskid animation
    • Radio stack, including ID for NAV
    • windows management: selectable items , modifiable items , scrolling
    • display of V-speeds in ruler: Vx, Vy, Vr and Vglide (specific for aircraft, see installation instruction)
    • some aircraft specific data to retrieve from aircraft XML files (VNE, etc)
    • possibility to add a copilot's PFD, and other displays
    • EIS: separation for aircraft specifics (selected by the zkv1000 config)
    • TMR/REF Timer , Vspeeds , minimums (don't understand the role of this)
    • Bearing needs some checks to be sure it shows the correct information
    • XPDR: emergency code depending of the country (eg.: 1200 for US, 7700 for Europe), should be set in settings
    • single-prop EIS: texts displayed , animations for fuel
    • make booting animation visible
    • EIS: animations for temperature for YaSim and JSBSim
    • multikey for every part of the device (actually only power on)
  • (TODO list, unsorted)
    • CDI/GPS: scale depending of the flight phase
    • recenter the MFD depending of EIS width
    • angle of attack display
    • Alerts
    • Flight planning (MFD)
    • Setting pages (MFD)
    • Inset Map (PFD)
    • PFD settings
    • texture for some MFD buttons
    • rotation and zooming of online maps in-flight
    • VS guidance
    • VNAV
    • scrolling lift in menus
    • tutorials
    • many more...

Installation

Somewhere in the XML configuration of your aircraft, put only few lines

Create the zkv1000 Nasal namespace

In the <nasal> place of your aircraft configuration

    <zkv1000>
        <file>Aircraft/Instruments-3d/zkv1000/zkv1000.nas</file>
    </zkv1000>

Actually this is where everything begins, please have a look at this code, it would help you to follow the script.

Set specific values for your aircraft

Specifics values for aircraft can be set via the aircraft configuration, in the <instrumentation> section, just add a section <zkv1000> and set here the needed values.

Vspeeds

To see the Vspeeds bugs or the IAS background color change (Vne), set the corresponding V-speeds in knots by adding in your <instrumentation><zkv1000> section the following lines (here are the numbers for the Lancair-235, values are not to be used in real life). If not set, defaults to 999 knots

    <alerts>
      <Vx>99</Vx>
      <Vy>110</Vy>
      <Vr>65</Vr>
      <Vglide>80</Vglide>
      <Vne>170</Vne>
    </alerts>

EIS

To tells the zkv1000 which kind of engines equip your aircraft, and the associated EIS

    <eis>
      <type>single-prop</type>
    </eis>

Defaults to none, available entries are the .nas files located in Nasal/EIS/ directory. If you want to add yours, just copy the Systems/EIS/single-engine.svg, modify it to fit your needs, and refer to it in a function named displayClass.showEIS, another very important function is displayClass.updateEIS (example in zkv1000/Nasal/EIS/single-engine.nas)

3D models

In the definition of your flightdeck (here are the values for the installation in the Lancair 235 in which I develop the device) put it everywhere you want to

    <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>

You can put as many devices as wanted, but generally they are two (PFD+MFD) or three (2 PFD+ 1 PFD), can be only one which is useful when you just want the PFD or the MFD in your cockpit. The device are identified by a name, which should be unique unless they won't be independant. This name is set by one of the property in the XML model file (instrumentation/zkv1000/<NAME>/status), which is a property telling if the device is switched off or not (or in reversionnary mode, later). Actually there are only two "types of display": MFD or PFD, which is known by the first 3 letters of the name (case sensitive!) Other devices as keyboard or non-display can also exists, as long as they don't have a status property... Not sur I'm clear on this point though :)

Switch it up

You can use the multikey (souvenirs, thanks to Melchior having that much expended this feature years ago :)) service by typing: :zo

The :z will be the multikey entry for all multikeys of the zkv1000.

  1. If you see a single red dot under the ZKV100O xxx init message (xxx = MFD or PFD), this is likely the sim is paused (press p by default to stop the pause).
  2. If you see multiple dots under the ZKV1000 xxx init message, something wrong happened, time to check console
  3. If you see only black screen on one of the screen, something really wrong happened, time to check console

Documentation