convez.ai
PluginDevOps & InfraestruturaAvançado
lvalen91

Driver t6evdi para Adaptadores USB DisplayLink MCT Trigger 6

lvalen91/JUA254H---Fedora

Driver nativo Linux para adaptadores DisplayLink MCT Trigger 6 via USB

Ver no GitHub
InicialPluginScore · de 0 a 100

Daemon systemd em Python/C que controla adaptadores USB DisplayLink (como j5create JUA254H) em Linux, implementando o protocolo USB via engenharia reversa. Cria uma saída DRM virtual, captura framebuffer, codifica JPEG e transmite pela USB, integrando-se nativamente com GDM e GNOME sem configuração por usuário.

Instalação

$npx convez-ai lvalen91/JUA254H---Fedora

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
v0.4.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Usar monitores USB DisplayLink em Fedora/Linux sem drivers proprietários
  • Estender display em notebooks/desktops com adaptadores j5create JUA254H
  • Integração transparente com GDM e sessões GNOME no login

Veredito

Driver de qualidade produção via engenharia reversa, bem testado em Fedora 43. Ideal para entusiastas Linux que precisam usar adaptadores DisplayLink sem vendor blobs. Requer conhecimento de systemd, libusb e compilação de kernel modules.

README

A tradução para o português deste README ainda está na fila.

t6evdi

Linux userspace driver daemon for MCT Trigger 6 USB display adapters (e.g. j5create JUA254H, VID 0x0711, PID range 0x5600–0x569F).

Implementation derived from independent reverse engineering of the adapter's USB protocol (vendor control transfers, bulk frame submission, interrupt events) and the OEM driver behaviour. No proprietary source was used. Released into the public domain — see LICENSE.

Status: v0.4, Milestone 3 polish complete. Validated on Fedora 43 Workstation with a JUA254H adapter at 1080p60. Packaged as an RPM.

What it is

A root systemd service that:

  1. Opens the T6 adapter over libusb.
  2. Queries chip capabilities, computes the PLL, and sets 1080p60.
  3. Creates a virtual DRM output via evdi (DisplayLink's kernel shim).
  4. Captures the evdi framebuffer, encodes JPEG 4:2:0 with libjpeg-turbo, and streams frames over USB bulk.
  5. Handles DPMS, mode-changed, and hotplug events.

GDM and user GNOME sessions see the evdi node as a normal DRM card; no per-user setup is required.

Build & install (from source)

Build deps on Fedora:

sudo dnf install meson ninja-build gcc pkgconfig \
  libusb1-devel libjpeg-turbo-devel
# evdi headers + lib (install by hand or via RPMFusion akmod-evdi):
# /usr/include/evdi_lib.h and /usr/lib64/libevdi.so must be present.

Build:

meson setup build
meson compile -C build
sudo meson install -C build
sudo systemctl daemon-reload
sudo udevadm control --reload-rules
sudo modprobe evdi
sudo systemctl enable --now t6evdi.service

Build & install (as RPM — recommended for workstations)

tar --transform='s|^t6evdi|t6evdi-0.4.0|' \
    -czf ~/rpmbuild/SOURCES/t6evdi-0.4.0.tar.gz \
    --exclude=build t6evdi
cp t6evdi.spec ~/rpmbuild/SPECS/
rpmbuild -bb ~/rpmbuild/SPECS/t6evdi.spec
sudo dnf install ~/rpmbuild/RPMS/x86_64/t6evdi-0.4.0-1.fc43.x86_64.rpm

The RPM owns four files:

PathPurpose
/usr/bin/t6evdiddaemon binary
/usr/lib/systemd/system/t6evdi.servicesystemd unit
/usr/lib/udev/rules.d/99-mct-trigger.ruleshotplug auto-start
/usr/lib/modules-load.d/evdi.confauto-load evdi.ko at boot

After install, rpm -V t6evdi detects drift. dnf remove t6evdi is clean.

Runtime behavior

  • Boot with adapter attached: service starts before GDM → extended display present at the login screen.
  • Boot without adapter: service retries indefinitely (StartLimitIntervalSec=0); udev rule (re)triggers the service on hotplug.
  • Mid-session unplug: worker detects LIBUSB_ERROR_NO_DEVICE, daemon exits 5, systemd restarts, ExecStopPost=t6evdid --off blanks the chip so no stale frame remains.
  • Replug: t6_open retry loop (≤30 s) or udev trigger reconnects.
  • Crash / SIGKILL: ExecStopPost fires → blank → restart.

Layout

t6evdi/
├── src/                 Daemon source (C, ~44 KB)
│   ├── t6_proto.h         wire-format constants and structs
│   ├── t6_usb.{h,c}       USB control/bulk/interrupt helpers
│   ├── t6_evdi.{h,c}      libevdi integration + worker pipeline
│   └── t6_main.c          entry + signal handlers + --off mode
├── systemd/t6evdi.service
├── udev/99-mct-trigger.rules
├── modules-load/evdi.conf
├── meson.build / meson_options.txt / t6evdi.spec
├── probes/              Python probe scripts used during RE
└── doc/                 Design + RE notes
    ├── ARCHITECTURE.md
    ├── PROTOCOL.md
    └── re/              Pre-implementation gap analyses

See also

  • cyrozap/mct-usb-display-adapter-re — upstream RE that seeded this project.
  • Internal RE reports of the Windows/macOS/Ubuntu OEM drivers (not included here; MCT proprietary).

License

Released into the public domain under The Unlicense. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados