FlightControls plugin for X-Plane 12
====================================

Connects Raspberry Pi Pico based cockpit panels (radio, transponder, audio
panel, autopilot) to X-Plane over USB HID.

Install
-------
Copy the whole "FlightControls" folder into

    X-Plane 12/Resources/plugins/

so you end up with

    X-Plane 12/Resources/plugins/FlightControls/mac_x64/FlightControls.xpl
    X-Plane 12/Resources/plugins/FlightControls/win_x64/FlightControls.xpl
    X-Plane 12/Resources/plugins/FlightControls/lin_x64/FlightControls.xpl

X-Plane picks the file for your platform; the others are ignored.
If you have an older copy of this plugin in a "TeensyControls" folder,
remove it so only one copy is installed.

macOS
-----
mac_x64/FlightControls.xpl is a universal binary (Intel and Apple Silicon)
and needs macOS 11 or later.  If macOS says the plugin is not trusted, or
X-Plane's Log.txt shows a dlopen error for it, the downloaded file is
quarantined.  Clear the flag once in Terminal:

    xattr -dr com.apple.quarantine "/path/to/X-Plane 12/Resources/plugins/FlightControls"

Windows
-------
No driver needed.  The panels are standard HID devices.

Linux
-----
Needs glibc 2.34 or later (Ubuntu 22.04 or newer).  Copy
udev/99-flightcontrols.rules to /etc/udev/rules.d/ so the plugin can open
the panels without root, then run

    sudo udevadm control --reload-rules && sudo udevadm trigger

or unplug and replug the panels.

Checking
--------
X-Plane's Log.txt shows lines prefixed "FlightControls:" for plugin start,
each panel attached, and every command / dataref the panel registered.
The menu Plugins > FlightControls > Show Communication shows live traffic.
