verticallongboard / xplane-vhf-helper

VR-Optimized ATC/Radio Plugin for X-Plane + FlyWithLua

VR Radio Helper (aka VHF Helper)

Overview

VR Radio Helper is a FlyWithLua plugin for X-Plane 11. It allows to change the two main COM frequencies of any X-Plane airplane in Virtual Reality via convenient touch pad number buttons in a multicrew environment. For many default airplanes, NAV, Transponder and Barometer can be changed as well.

Flying VR multicrew in X-Plane with ATC is a blast! Yet, the default X-Plane 11 VR knobs are horrible when trying to monitor/fly and dial in a new ATC frequency at the same time (takes up to 2 minutes for a 2-hour flight, just turning the knob and making sure that no turn got lost when using SmartCopilot).

VR Radio Helper:

• Makes tuning in a new ATC frequency a breeze!
  • It replaces most ATC/navigation-related knobs with a number panel, like COM, NAV, Transponder and Barometer settings.
• Works with SmartCopilot, synchronizing COM/NAV frequencies, transponder codes and barometer settings between two pilots
  • Both pilots need to install SmartCopilot
  • Required changes to an existing SmartCopilot installation are applied automatically.
• Works in VR (free positioning in 3D space)
• Integrates well with ATC networks (e.g. VATSIM), showing ATC station names and a Real-Time Radar

Installation

• Install FlyWithLua: https://forums.x-plane.org/index.php?/files/file/38445-flywithlua-ng-next-generation-edition-for-x-plane-11-win-lin-mac/
• Download latest release
• Use installer executable and specify your X-Plane installation folder or unzip manually (including subfolders):
  • Move dependencies from Modules to <X-Plane 11 Folder>/Resources/plugins/FlyWithLua/Modules
  • Move script files and data from Scripts to <X-Plane 11 Folder>/Resources/plugins/FlyWithLua/Scripts

To make it multicrew-ready (do that in BOTH pilot's airplanes):

• Install SmartCopilot: https://sky4crew.com/smartcopilot/ and install aircraft-specific smartcopilot.cfg

To see ATC station information and real-time radar positions:

• Install Vatsimbrief Helper: https://github.com/RedXi/vatsimbrief-helper

Usage

• Go to Plugins/FlyWithLua/FlyWithLua Macros/VR Radio Helper.
• Place and scale the panel wherever you like (in 2D and VR).
• Use the number buttons to enter the new VHF frequency. The last two digits do not need to be entered manually.
• Press NAV, TP or BARO to change to NAV, Transponder and Barometer panels.
• Press the corresponding switch button to tune in new frequencies, transponder codes or barometer pressures.
• Chat with ATC! :-)
• If you like, bind the toggle-panel command FlyWithLua/VR Radio Helper/TogglePanel to a key of your choice.

For ATC Station Names and Radar:

• Install Vatsimbrief Helper
• Check if Vatsim data transfer is available via clicking the > button
• As long as Vatsimbrief Helper is installed and able to access Vatsim Data, you will see:
  • ATC station names and short description for tuned-in or entered frequencies
  • All Vatsim clients close to your current location in Radar

For multicrew:

• Install SmartCopilot
• Check if multicrew support is available via clicking the > button
• Connect via SmartCopilot
• If SmartCopilot is installed and configured correctly for your current plane, entered freqencies, pressures and codes will be synchronized between two pilots

Plane Compatibility

VR Radio Helper uses the default X-Plane way of setting COM/NAV frequencies, barometer pressures and transponder codes. By default, all features are enabled. If you find that this does not work out-of-the-box in your plane, please use the integrated feedback collector (click the > button) to leave a description of the issues that you encountered. The plane compatibility reports automatically generate diagnostic information that is necessary to distinguish between different planes. Based on this information, a growing number of planes are detected automatically and settings adjusted / features disabled accordingly.

Dependencies

Additional dependencies besides X-Plane 11, SmartCopilot and FlyWithLua:

• LUA INI Parser
• LUA Event Bus

(All dependencies are bundled with each release)

Developer Notes

You want to integrate VR Radio Helper into other plugins? See VR Radio Helper Public Interface or Vatsimbrief Helper to see it in action.

Looking for a good starting point to write your own FlyWithLua plugins? Have a look at the A320 NORMAL CHECKLIST Developer Notes!

xplane-vhf-helper's Issues

Compatibility: FlightFactor A320

• COM works
• NAV doesn't work
• XPDR is read-only
• Transponder modes: 0: STBY, 1: AUTO, 3: ON

New VR Radio Helper Feedback

Please leave your feedback here.
Thanks for taking your time!

---YOUR FEEDBACK HERE---
I hope to switch the unit IN from HPA on Baro. Pilot2ATC tells IN only.

---

This diagnostic information helps making VR Radio Helper better, please keep it here:

• X-Plane Version: 11520
• System: IBM
• Plane Compatibility: ICAO:B738:TAILNUMBER:ZB738:ACF_FILE_NAME:b738_4k.acf:ACF_DESC:Boeing 737-800X:ACF_MANUFACTURER:Boeing:ACF_STUDIO:Laminar Research modified by Zibo and Twkster:ACF_AUTHOR:Alex Unruh:ACF_NAME:Boeing 737-800X (4k)

8.33 khz Vatsim spacing

As Vatsim is changing to 8.33Khz spacing I noticed that some frequencies can not be tuned.

The main problem is when you need to tune xxx.980 you can only tune xxx.975.

can you please look into this.

Yor utility is still great.

COM tuning doesn't work for many planes (including stock)

Tuning COM 1+2 doesn't work - after entering a frequency and clicking on any of the blinking green buttons no effect is seen on the radios.

When I set the dataref sim/cockpit/radios/com1_freq_hz manually via DRT it works and the change gets reflected back into the script UI - therefor IMO another addon/script interfering can be excluded. Besides, other COM tuner addons such as COM1 Radio Tuner or NavSearch work fine, too. And perhaps most importantly: I have the same issue with multiple planes such as Rotorsim's EC135 V5 and the stock Bell 206 Jetranger and Baron (didn't test other planes). So it looks like the issue is not model-specific...

All other functions such as NAV, TP and BARO work fine.

Tested with 1.1.8.

X-Plane log attached:
Log.txt

---

This diagnostic information helps making VR Radio Helper better, please keep it here:

• X-Plane Version: 11530
• System: IBM
• Plane Compatibility: ICAO:EC35:TAILNUMBER:D-HECH :ACF_FILE_NAME:ec135.acf:ACF_DESC:EC 135 T2 / T3:ACF_MANUFACTURER:Eurocopter:ACF_STUDIO:::ACF_AUTHOR:rotorsim.de

keyboard assignment improvement

Dear Sir love your VR-Radio-Helper.

Noticed a small mistake when assigning Keyboard shortcut from X Plane.
In module Singletons\loop.lua create command "FlyWithLua/" .. Globals.readableScriptName .. "/TogglePanel",
I have replaced it with "FlyWithLua/VR_Radio_Helper/TogglePanel", which sorts the problem.
// Added card -- Hotfix 1.1.8

A suggestion for both Com/Nav to have a button to swop Com1/Com2 and Nav1/Nav2 frequencies as on the Radio.
// Added card

Thanks for you efforts

Len