hardware

name	hardware
description	Diagnose and resolve hardware issues on Bluefin — GPU, WiFi, Bluetooth, peripherals.
domain	troubleshooting

Hardware Troubleshooting

Bluefin runs on a stock Fedora kernel with firmware from linux-firmware. Most hardware works out of the box. This skill covers diagnosing common hardware issues.

Load with: point your agent at this file.

When to Use

• GPU not detected or wrong driver loaded
• WiFi or Bluetooth not connecting or not detected
• External displays not recognized
• Audio devices not appearing
• USB peripherals behaving unexpectedly

When NOT to Use

• Software-level app crashes — check journalctl -b -p err and rpm-ostree status to verify the current image is healthy
• BIOS/UEFI firmware issues — consult your hardware manufacturer

Diagnostic Commands

# List all PCI devices with driver info
lspci -nnk

# List USB devices
lsusb

# Check kernel messages for hardware errors
journalctl -b -p err | grep -v systemd

# Check firmware loaded for a device
journalctl -b | grep -i firmware

# GPU info (AMD/Intel)
lspci -nnk | grep -A3 VGA

# NVIDIA GPU (if using nvidia variant)
nvidia-smi

# WiFi / network interfaces
ip link show
nmcli device status

# Bluetooth
bluetoothctl show
journalctl -b -u bluetooth.service

GPU Issues

AMD: Bluefin uses the open-source amdgpu driver. Check lspci -nnk | grep -A3 VGA. If amdgpu is not in "Kernel driver in use", file a bug — it should be automatic.

Intel: Uses i915 or xe. Same diagnostic: lspci -nnk | grep -A3 VGA.

NVIDIA: Use the nvidia or aurora-nvidia image variant. Check that nvidia-smi works after reboot. If not, verify you're on the correct image: bootc status | grep image.

WiFi Issues

# Check if driver loaded
lspci -nnk | grep -A3 -i network

# Restart NetworkManager
sudo systemctl restart NetworkManager

# List available networks
nmcli device wifi list

Broadcom WiFi (14e4:*): Not supported in stock Bluefin (no wl driver). Consider a USB WiFi adapter with better Linux support.

Audio Issues

# List audio devices (PipeWire)
wpctl status

# Restart PipeWire
systemctl --user restart pipewire pipewire-pulse wireplumber