Skip to Content
DocumentaçãoReferênciaHardwareProblemas comuns de driver

Problemas comuns de driver

Fluxo de trabalho de solução de problemas de driver

Etapa 1: Identifique o Hardware

# Full hardware overview sudo lshw -short # PCI devices (graphics cards, network cards, sound cards, etc.) lspci -nn # USB devices lsusb # Detailed hardware report sudo lshw -html > hardware-report.html

Etapa 2: verificar os registros do kernel

# Current boot log sudo dmesg | less # Filter errors and warnings sudo dmesg --level=err,warn # Real-time monitoring (use when plugging in devices) sudo dmesg -w

Etapa 3: visualizar módulos carregados

# List all loaded kernel modules lsmod # View information about a specific module modinfo MODULE_NAME # View module dependencies modprobe --show-depends MODULE_NAME

Usando a ferramenta ubuntu-drivers

# Detect devices that need additional drivers sudo ubuntu-drivers devices # Automatically install recommended drivers sudo ubuntu-drivers autoinstall # Install a specific driver (use the version recommended by `ubuntu-drivers devices`, e.g. 580/590) sudo ubuntu-drivers install nvidia-driver-580

Gerenciamento de driver DKMS

DKMS (Dynamic Kernel Module Support) garante que drivers de terceiros sejam recompilados automaticamente após atualizações do kernel.

# View DKMS-managed modules dkms status # Manually rebuild modules sudo dkms autoinstall # If a module fails to build sudo dkms remove MODULE_NAME/VERSION --all sudo dkms install MODULE_NAME/VERSION

Problemas e soluções comuns

Driver para de funcionar após atualização do kernel

# Check DKMS status dkms status # Ensure build tools are installed sudo apt install build-essential dkms linux-headers-$(uname -r) # Rebuild all DKMS modules sudo dkms autoinstall

O módulo do driver está na lista negra

# Check blacklists grep -r "blacklist" /etc/modprobe.d/ # Temporarily load a blacklisted module sudo modprobe MODULE_NAME # Permanently remove blacklist entry sudo nano /etc/modprobe.d/blacklist.conf # Comment out the relevant line, then regenerate the initramfs (Ubuntu 26.04 uses Dracut by default): sudo dracut -f # On legacy initramfs-tools systems use instead: sudo update-initramfs -u

Arquivos de firmware ausentes

# Check for firmware missing warnings sudo dmesg | grep -i firmware # Install the full firmware package (all of Ubuntu's binary firmware lives in linux-firmware) sudo apt install linux-firmware
Note

O Ubuntu não possui pacotes divididos do Debian, como firmware-misc-nonfree; todo o firmware necessário está incluído em linux-firmware. Começando com 26.04, linux-firmware é dividido em subpacotes específicos do fornecedor, mas a instalação do pacote guarda-chuva ainda extrai todo o firmware.

Dispositivo não reconhecido

  1. Confirme se o dispositivo está fisicamente conectado corretamente
  2. Verifique se o dispositivo está habilitado em BIOS/UEFI
  3. Experimente uma porta ou cabo USB diferente
  4. Atualize a versão do kernel:
sudo apt install linux-generic-hwe-26.04

Compilando e instalando drivers manualmente

Quando nenhum pacote de driver pré-construído estiver disponível:

# Install build dependencies sudo apt install build-essential linux-headers-$(uname -r) git # Typical workflow git clone <DRIVER_REPOSITORY_URL> cd <DRIVER_DIRECTORY> make sudo make install sudo modprobe <MODULE_NAME> # Set up automatic loading at boot echo "MODULE_NAME" | sudo tee /etc/modules-load.d/MODULE_NAME.conf

Revertendo para um kernel mais antigo

Se um novo kernel causar problemas de hardware:

# View installed kernels dpkg --list | grep linux-image # Select an older kernel at the GRUB menu during boot # Hold Shift (BIOS) or Esc (UEFI) to enter the GRUB menu # Select "Advanced options for Ubuntu" > older kernel version # Pin a specific kernel version (use with caution) sudo apt-mark hold linux-image-7.x.x-xx-generic

Gerando um relatório de diagnóstico de hardware

Ao buscar ajuda da comunidade, forneça as seguintes informações:

# Generate a complete hardware report sudo apt install inxi inxi -Fxxxz # Or use hw-probe sudo apt install hw-probe sudo hw-probe -all -upload

O link de saída pode ser compartilhado diretamente com quem está ajudando você.