| 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
lspci -nnk
lsusb
journalctl -b -p err | grep -v systemd
journalctl -b | grep -i firmware
lspci -nnk | grep -A3 VGA
nvidia-smi
ip link show
nmcli device status
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
lspci -nnk | grep -A3 -i network
sudo systemctl restart NetworkManager
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
wpctl status
systemctl --user restart pipewire pipewire-pulse wireplumber