nocscienceat.WinWingMcdu 1.0.0

nocscienceat.WinWingMcdu

WinWing MCDU panel driver for X-Plane, built on the nocscienceat.XPlanePanel / nocscienceat.XPlaneWebConnector framework.

Drives the WinWing MCDU hardware (Captain, First Officer, Observer) via USB HID � reads 74 key presses, renders the 14�24 color character LCD display with dual font sizes, and controls 9 LED annunciators plus backlight brightness. All display content and button commands bridge to X-Plane via the ToLiss AirbusFBW plugin datarefs and commands.

Features

• Full keyboard � all 74 keys (LSK, page, numeric, alpha, special) with begin/end command pairs for hold-timing support (e.g. CLR long-press)
• Color LCD display � 14 lines � 24 characters, 9 colors, large/small font, per-character color from overlapping ToLiss dataref layers
• Symbol decoding � brackets, arrows, and box characters with per-symbol color mapping
• Captain/FO auto-detection � automatically switches between MCDU1 and MCDU2 datarefs based on the connected device PID
• Dual MCDU support � register a second handler instance with panelName: "MCDU2" for simultaneous Captain + First Officer operation
• USB disconnect/reconnect � automatic recovery with display restore from cached dataref state
• Teleport detection � re-initializes the display after aircraft reloads
• Display throttling � coalesces rapid dataref updates to prevent display controller overflow
• Dataref pre-caching � resolves all dataref IDs in parallel before subscribing for fast initial page display

Installation

dotnet add package nocscienceat.WinWingMcdu

Usage

Basic Setup

using nocscienceat.WinWingMcdu.Panels;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using nocscienceat.XPlanePanel;

var builder = Host.CreateApplicationBuilder(args);

builder.Configuration
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables("XP_");

builder.Services.AddXPlaneWebConnector(builder.Configuration);
builder.Services.AddXPlanePanel();

// Captain MCDU (auto-detect or force PID via config)
builder.Services.AddSingleton<IPanelHandler, McduPanelHandler>();

// Optional: First Officer MCDU
// builder.Services.AddSingleton<IPanelHandler>(sp =>
//     new McduPanelHandler(
//         sp.GetRequiredService<IXPlaneWebConnector>(),
//         sp.GetRequiredService<IConfiguration>(),
//         sp.GetRequiredService<ILogger<McduPanelHandler>>(),
//         panelName: "MCDU2"));

builder.Logging.ClearProviders();
builder.Logging.AddConsole();

var host = builder.Build();
await host.RunAsync();

Configuration

{
  "Panels": {
    "MCDU": {
      "Enabled": true
    },
    "MCDU2": {
      "Enabled": false,
      "ProductId": 47934
    }
  }
}

Supported Devices

Architecture

• McduPanelHandler � main panel handler with lifecycle, reconnect, and display throttling
• McduPanelHandlerRegDataRefCommand.cs � dataref/command registration and button dispatch table
• McduPanelHandlerWireDataRefCommand.cs � subscription wiring, pre-caching, and teleport detection
• McduDisplayComposer � merges per-color ToLiss dataref layers into a single display page
• McduPage � 14�24 character model with dirty tracking and wire-format encoding
• WinWingMcduHidDevice � USB HID I/O (read loop, write channel, LED control, display protocol)

Protocol Documentation

See docs/MCDU-Protocol-Analysis.md for the full USB HID protocol specification.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.

Attribution

This project is a C# port derived from XSchenFly by memo5@gmx.at, originally released under the GPL-3.0 license. Hardware protocol derived from reverse engineering by memo5@gmx.at.

C# port and modifications by Klemens Urban (klemens.urban@outlook.com, https://github.com/klemensurban).

Dependencies

This project depends on the nocscienceat.XPlanePanel framework and the nocscienceat.XPlaneWebConnector, which are licensed separately under the MIT License by Klemens Urban.