Adaptador generico Linux HDMI/USB en español & ingles

[G7-Enterprise]

1. DIAGNÓSTICO
   Si compraste un adaptador USB barato (generalmente de color negro o metalizado) que usa el chip MacroSilicon MS912x, y al conectarlo en Ubuntu tu pantalla se queda negra o el ratón deja una estela (lag), este es tu manual.
   El problema es que el fabricante dejó de actualizar el driver y los sistemas Linux nuevos (Kernel 6.2 en adelante) rechazan el código antiguo.

2. REQUISITOS PREVIOS (OBLIGATORIO)
   Antes de tocar la terminal, debes configurar tu ordenador para que acepte el driver. Si no haces esto, nada funcionará.

   1. DESACTIVAR SECURE BOOT:
      ◦ Entra en la BIOS de tu ordenador (teclas F10, F2 o Esc al encender).
      ◦ Busca la opción "Secure Boot" y cámbiala a "Disabled".
      ◦ ¿Por qué? Porque este driver es "casero" y el bloqueo de seguridad de Windows/HP no lo deja pasar.
   2. USAR MODO GRÁFICO "XORG":
      ◦ En la pantalla de inicio de sesión de Ubuntu (donde pones la contraseña), haz clic en tu usuario.
      ◦ Busca una rueda dentada ⚙️ abajo a la derecha.
      ◦ Selecciona "Ubuntu on Xorg".
      ◦ ¿Por qué? El modo moderno (Wayland) hace que estos adaptadores parpadeen o vayan lentos.

3. LA SOLUCIÓN (Paso a Paso)
   Abre la terminal (Ctrl + Alt + T) y sigue estos tres bloques de instrucciones.
   FASE 1: Limpieza y Herramientas
   Preparamos el terreno para que no haya conflictos con intentos anteriores. Copia y pega:
   Bash
   sudo apt update
   sudo apt install git build-essential linux-headers-$(uname -r)
   cd ~
   sudo rm -rf ms912x
   FASE 2: Descarga y "Cirugía" del Código
   Aquí está el truco. Descargamos el driver y aplicamos automáticamente los parches para que el sistema moderno no dé error. Copia y pega todo este bloque junto:
   Bash

1. Descargar el código original

git clone https://github.com/rhgndf/ms912x.git
cd ms912x

2. PARCHE 1: Eliminar fecha obsoleta (Error '.date')

sed -i '/.date =/d' ms912x_drv.c

3. PARCHE 2: Eliminar funciones gráficas antiguas que ya no existen

(Esto soluciona el error fatal "drm_fbdev_generic_setup undefined")

sed -i '/drm_fbdev_ttm_setup/d' ms912x_drv.c
sed -i '/drm_fbdev_generic_setup/d' ms912x_drv.c
sed -i '/void drm_fbdev_generic_setup/d' ms912x_drv.c

echo "¡Código parcheado correctamente!"
FASE 3: Compilación e Instalación
Fabricamos el driver ignorando las advertencias leves y lo instalamos.
Bash

1. Compilar (Ignorando warnings para que no se detenga)

make KCFLAGS="-Wno-error"

2. Instalar en el sistema

sudo make install
sudo depmod -a

4. ENCENDIDO
   Una vez terminada la Fase 3, conecta tu adaptador USB. Si no enciende automáticamente, escribe esto en la terminal:
   Bash
   sudo modprobe ms912x
   Si la pantalla enciende pero el ratón va lento:
   1. Ve a Configuración > Pantallas.
   2. Selecciona el monitor USB.
   3. Baja la resolución a 1280x720 (o 1366x768).
   4. Esto elimina el "lag" y las estelas del ratón.

NOTA FINAL
Guarda la carpeta ms912x que se ha creado en tu usuario. Si alguna vez actualizas el sistema y deja de funcionar, solo tienes que entrar en esa carpeta y repetir la FASE 3.

RESCUE GUIDE: USB to HDMI/VGA Adapter (Chip MS912x) on Modern Linux
Author: Carlos & Gemini (Linux Community) Date: January 2026 Issue: Black screen, flickering, or compilation errors on modern Ubuntu versions (Kernel 6.x).

1. DIAGNOSIS
   If you purchased a budget USB adapter (usually black or metallic) using the MacroSilicon MS912x chip, and your screen remains black or the mouse lags heavily on Ubuntu, this guide is for you.
   The manufacturer stopped updating the driver, and modern Linux systems (Kernel 6.2+) reject the old code. We need to manually patch it.

2. PREREQUISITES (MANDATORY)
   Before opening the terminal, you must configure your computer to accept the driver. If you skip this, it will not work.

   1. DISABLE SECURE BOOT:
      ◦ Enter your BIOS (keys F10, F2, or Esc during startup).
      ◦ Find the "Secure Boot" option and set it to "Disabled".
      ◦ Why? This is a custom "home-cooked" driver, and the Secure Boot feature will block it.
   2. USE "XORG" GRAPHICS MODE:
      ◦ On the Ubuntu login screen (where you enter your password), click your username.
      ◦ Look for a gear icon ⚙️ (usually bottom right).
      ◦ Select "Ubuntu on Xorg".
      ◦ Why? The modern mode (Wayland) causes these adapters to flicker or lag significantly.

3. THE SOLUTION (Step-by-Step)
   Open your terminal (Ctrl + Alt + T) and follow these three blocks of instructions.
   PHASE 1: Cleanup & Tools
   We prepare the ground to avoid conflicts with previous attempts. Copy and paste:
   Bash
   sudo apt update
   sudo apt install git build-essential linux-headers-$(uname -r)
   cd ~
   sudo rm -rf ms912x
   PHASE 2: Download & Code "Surgery"
   This is the trick. We download the driver and automatically apply patches so the modern system doesn't reject it. Copy and paste this entire block:
   Bash

1. Download original code

git clone https://github.com/rhgndf/ms912x.git
cd ms912x

2. PATCH 1: Remove obsolete date function (Fixes '.date' error)

sed -i '/.date =/d' ms912x_drv.c

3. PATCH 2: Remove old graphic functions that no longer exist

(This fixes the fatal error "drm_fbdev_generic_setup undefined")

sed -i '/drm_fbdev_ttm_setup/d' ms912x_drv.c
sed -i '/drm_fbdev_generic_setup/d' ms912x_drv.c
sed -i '/void drm_fbdev_generic_setup/d' ms912x_drv.c

echo "Code patched successfully!"
PHASE 3: Compile & Install
We build the driver while ignoring minor warnings, then install it.
Bash

1. Compile (Ignoring warnings so it doesn't stop)

make KCFLAGS="-Wno-error"

2. Install into the system

sudo make install
sudo depmod -a

4. ACTIVATION
   Once Phase 3 is done, connect your USB adapter. If it doesn't turn on automatically, type this in the terminal:
   Bash
   sudo modprobe ms912x
   If the screen turns on but the mouse is slow/laggy:
   1. Go to Settings > Displays.
   2. Select the USB monitor.
   3. Lower the resolution to 1280x720 (or 1366x768).
   4. This eliminates the mouse trail and lag.

FINAL NOTE
Keep the ms912x folder that was created in your user directory safe. If you ever update your system and it stops working, simply enter that folder and repeat PHASE 3.