MU-2 KLN 90B modification

[Altimutater]

If you've ever looked at a Garmin GNS530 and thought "that's just a bit too mid-2000s modern for me"... today I've successfully integrated Todor Radonov / Todir's KLN 90B plugin with the MU-2:

The outline of the installation process is:

• install the KLN90B plugin
• place the GPS and MD41 panels in the 3D cockpit in PlaneMaker
• customise where the GPS screen gets drawn on the MU-2's panel texture, along with the UV mapping for the GPS object - don't worry, I've done this step
• use a utility that comes with the plugin to add manipulators for the GPS and MD41 to the MU-2's cockpit

Steps:

1. Download Todir's KLN90B - get the latest .zip: https://github.com/todirbg/kln90b/releases (at time of writing this was 0.99.1b)
2. Copy the `objects` and `plugins` folder into your MU-2 directory - don't copy `cockpit_3d`
3. Replace the `kln90b_click_regions.obj` file in MU2/objects/kln90b with the attached version (this has the updated UV mapping)
4. Make a backup of your 4B OEM acf file e.g. `xsMU2B60_4B_OEM.ackbak`
5. Open the 4B OEM acf (not the backup!) in PlaneMaker
6. Standard > Objects > Add:
   1. select `kln90b.obj` from MU2/objects/kln90b
   2. set its coordinates to 6.94, 0.10, 0.71
   3. set lighting to Inside, shadow mode Interior Only, hi-res Yes/ticked/green/selected
7. Add `MD41_V.obj` in the same way, coordinates 6.94, -1.68, 0.56, same parameters
   
8. Save the .acf - leave PlaneMaker open for now
   At this point, you can test your progress by launching the MU-2. You will see the KLN90B and the MD41 mode controller on the panel, albeit with a blank screen and no clickspots.
9. Edit MU2/plugins/KLN90B/data/modules/main.lua (in Notepad++ or VS Code or some other sensible editor):
   1. line 28ish, the KLN90_panel component, change `position = {814, 0, size[1], size[2]}` to `position = {0, 1138, size[1], size[2]}`
      (this determines where on the MU-2's panel texture the GPS screen is drawn. I've picked a spot which appears unused.)
      
      The next three steps are to accommodate a bug in the installer utility
10. Copy MU2/objects/Cockpit_3D/Cockpit_3D_OEM.obj to the MU2 folder
11. Make a temporary copy of `xsMU2B60_4B_OEM.acf`
12. Edit the temporary copy in Notepad++ or similar:
    1. search for kln90b. you should find where the KLN90B object is specified, and just below it the MD41 mode controller
    2. search for Cockpit_3D_OEM.obj - you will probably find it just below the MD41
    3. note the objects are identified with a number e.g. _obja/27/, _obja/28/
    4. cut all the lines for the KLN90B and MD41 objects and paste after the Cockpit_3D_OEM.obj - for me they were numbered 27, 28 and 4 respectively. (cursed alphabetic number ordering strikes again)
    5. change "Cockpit_32/Cockpit_3D_OEM.obj" to just "Cockpit_3D_OEM.obj"
       
    6. Save the changes to the temporary copy .acf
13. Run MU2/objects/kln_installer.exe:
    1. select your temporary .acf copy
    2. select Cockpit_3D_OEM.obj
    3. it should generate a new file in MU2/objects/kln90b: Cockpit_3D_OEM_kln90b.obj - this is the existing cockpit object with extra clickspots and the screen all in the right places
       
14. Move MU2/objects/kln90b/Cockpit_3D_OEM_kln90b.obj into MU2/objects/Cockpit_3D
15. In PlaneMaker, under Standard > Objects, find Cockpit_3D_OEM.obj, click the box to the left of its name and change the file to Cockpit_3D_OEM_kln90b.obj
16. Save the plane in PlaneMaker

To undo all of this:

1. Replace xsMU2B60_4B_OEM.acf with xsMU2B60_4B_OEM.acfbak

Steps 10-12 are a workaround for a couple of bugs with kln_installer.exe, which doesn't expect files to be in certain locations or for a numbered sequence to go 27, 28, 3, 4... they might become unnecessary with a future version of the KLN90B

If you'd like to position the KLN90B instruments elsewhere, use the Visualisation settings in PlaneMaker to hide most of the exterior and interior objects, and make adjustments. Then run kln_installer.exe again to regenerate the _kln90b.obj cockpit object.

Snags:

1. MD41 buttons don't seem to light up properly in the 3D cockpit. You can click on the annunciators to get a 2D popup - but I'd rather the 3D instrument worked correctly and I never see the 2D popup
2. KLN90B overlaps slightly with the top of the weather radar
3. Autopilot / FD / HSI mapping not figured out just yet
4. Powered by the default battery bus (or battery switch?) - you can give it a dataref representing a voltage bus but there's none available currently representing the radio bus voltages. This could be modded in though.

Happy flying folks!

kln90b_click_regions.obj

Edited December 31, 2023 by Altimutater

[Altimutater]

Bit of experimentation but `sim/cockpit2/radios/actuators/gps_power` is good for the KLN 90B power supply dataref.

[Juan Ponce]

Great job, thank you for publishing this. It definitely gives a more interesting operation to the MU