Usage

Feixiao ships with rtw88ctl, a command-line utility for controlling the driver. Prefer a GUI? Install Starskiff.

Check status

Confirm the driver initialized your card:

./build/out/rtw88ctl status

Scan for networks

# Trigger a hardware scan
./build/out/rtw88ctl scan

# List the discovered access points
./build/out/rtw88ctl list

Connect to a network

./build/out/rtw88ctl connect "Your_SSID" "Your_Password"

Viewing logs

OpenCore (pre-link inject)kextload / kmutil

dmesg | grep -i rtw88

log stream --predicate 'process == "kernel" and (eventMessage contains "rtw88" or message contains "rtw88")' --info

Troubleshooting

Kernel panics or connection failures

Ensure you are using the latest commit and that your specific card's PCI ID is bound to the driver.

If your card's chipset is listed under Supported Hardware but it isn't being picked up, double-check the PCI ID binding and rebuild from the latest source.