https://github.com/schenlap/XSchenFly

https://github.com/schenlap/XSchenFly

Last synced: 18 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/schenlap/XSchenFly
• Owner: schenlap
• License: gpl-3.0
• Created: 2025-06-15T07:48:59.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-03-09T20:00:23.000Z (4 months ago)
• Last Synced: 2026-03-10T01:35:47.343Z (4 months ago)
• Language: Python
• Homepage:
• Size: 8.1 MB
• Stars: 9
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/funding.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-osxp - XSchenFly

README

          
# XSchenFly

Use cockpit hardware devices on Linuc and Mac for X-Plane 12 Toliss Airbus.

It combines the functionality of https://github.com/schenlap/winwing_mcdu  and https://github.com/schenlap/winwing_fcu and adds new devices. You only have to start one script now to get all supported devices working.

## Status

All buttons, leds and lcd displays work the same way as in X-Plane.


Tested with:

 * XP12 under linux (debian trixie)

 * XP12 under MacOs (Sequoia 15.0.1)

 * Toliss A319, A320Neo, A321Neo, A339, A340-600

Supported Hardware:

 * Rowsfire A107: mostly supported

   * APU GEN button - I did not find the correct dataref yet

   * APU Bleed Fault indication - I did not find the correct dataref yet

   * APU Fire Button - I did not find the correct dataref yet

   * Special features for not used buttons

     * IR1-3 switches: autobrakes (min, med, max) can be set

     * ADIRS ON BAT switch: master warning can be cleared

 * Winwing MCDU: fully supported

   * Special features for not used buttons

     * blank button1: Toliss ISCS screen

     * blank button2: call cabine

 * Winwing FCU: fully supported

 * Winwing EFIS-R: fully supported

 * Winwing EFIS-L: fully supported

 * Winwing Uras Minor 32 Throllte with flaps and speedbrakes

   * only testes on linux. may not work in mac and widnwos because of virtual joysticks!

    * Throttle without speedbrake and flaps is untested

    * Throttle and speedbrakes axis must be configured in X-Plane

    * Fire 1 & 2 and rudder trim push button can be configured as buttons in X-Plane

 * Winctrl 32 APG: fully supported

 * Winctrl 32 ECAM: fully supported

 * Wingflex RMP: is on todo list

![A107 image](./documentation/A107.png)

![fcu demo image](./documentation/fcu_demo.gif)

Change brightness with the two brightness knobs in the cockpit.

![fcu demo image](./documentation/xplane_fcu_brightness.png)

![mcdu demo image](./documentation/A319MCDU1.jpg)

For Discussions use https://forums.x-plane.org/forums/topic/324813-winwing-mcdu-on-x-plane-for-mac-studio-and-linux/

## Installation

#### Debian based system

1. clone the repo where you want

2. copy `udev/71-winwing.rules` to `/etc/udev/rules.d`  

`sudo cp udev/71-winwing.rules /etc/udev/rules.d/`

3. install dependencies (on debian based systems)  

`sudo aptitide install python3-hid python3-serial libhidapi-hidraw0 python3-websockets`

5. start script (with udev rule no sudo needed): `python3 ./XSchenFly.py` when X-Plane with Toliss aircraft is loaded.

#### MAC-OS

1. clone the repo where you want

2. change into the directory `cd XSchenFly`

3. install homebrew

4. install dependencies

`python3 -m pip install hid`

`python3 -m pip install requests`

`python3 -m pip install websockets`

`python3 -m pip install serial`

6. brew install hidapi

7. let hid find hidapi: `ln -s /opt/homebrew/lib/libhidapi.dylib .`

8. start script with: `python3 ./XSchenFly.py` when X-Plane with Toliss aircraft is loaded.

### Configuration of rowsfire devices (mobiflight)

1. on first start you will see something like:

```

   find mobiflight devices:

   /dev/ttyUSB0: None 6790:29987

testing /dev/ttyUSB0 - USB Serial

   received serial number: SN-08B-DB1

   Not using mobiflight device SN-08B-DB1, expected SN-XXX-XXX

 [A107] No compatible rawsfire device found, quit

```

because it does not know which serial number it should use.

2. Change `MOBIFLIGHT_SERIAL = "SN-XXX-XXX"` in devices/rawsfire_a107.py to `MOBIFLIGHT_SERIAL = "SN-08B-DB1"` (use your serial that was printed under `Not using mobiflight device SN-08B-DB1`)

### Configuration of Ursa Minor 32 Throttle

1. No not calibrate your device in simapp pro

2. for throttle and speedbrake a virtual joystick is created. Configure this XSchenfly-Stick in X-Plane 


![configure joystick in x-plane](./documentation/throttle_joystick_config.png)

3. calibrate joystick in X-Plane (move all up/down)

4. calibrate axis in toliss (to use reversers and set correct dents) 


![configure joystick in toliss](./documentation/toliss_throttle_calibration.png)

## Use

1. start X-Plane

2. enable incoming traffic in settings / network (at the very bottom of the page)

3. load Toliss A319

4. start script as written above

5. enjoy flying (and report bugs :-)  )

## developer documentation

See [documention](./documentation/README.md) for developers. TODO

## Notes

Use at your own risk. Updates to the winwing devices can make the script incompatible.

TODO: The data sent in the USB protocol by SimApp Pro has not yet been fully implemented, only to the extent that it currently works.

## Next steps

 * bring all devices to websockets communication

## Contact

 (without the two underscores!) or as pm in https://forums.x-plane.org, user memo5.

## Sponsoring

To sponsor you can ![buy_me_a_coffee](https://github.com/user-attachments/assets/d0a94d75-9ad3-41e4-8b89-876c0a2fdf36)

[http://buymeacoffee.com/schenlap](http://buymeacoffee.com/schenlap)