OpenBSD manual page server

Manual Page Search Parameters

QWX(4) Device Drivers Manual QWX(4)

qwxQualcomm IEEE 802.11a/ac/ax/b/g/n wireless network device

qwx* at pci?

The qwx driver provides support for Qualcomm Technologies QCNFA765 802.11ax devices.

The qwx driver can be configured at runtime with ifconfig(8) or on boot with hostname.if(5).

The driver needs the following firmware files, which are loaded when an interface is brought up:

/etc/firmware/qwx-wcn6855-hw2.0-amss
 
/etc/firmware/qwx-wcn6855-hw2.0-board-2
 
/etc/firmware/qwx-wcn6855-hw2.0-m3
 
/etc/firmware/qwx-wcn6855-hw2.0-regdb
 
/etc/firmware/qwx-wcn6855-hw2.1-amss
 
/etc/firmware/qwx-wcn6855-hw2.1-board-2
 
/etc/firmware/qwx-wcn6855-hw2.1-m3
 
/etc/firmware/qwx-wcn6855-hw2.1-regdb
 

These firmware files are not free because Qualcomm refuses to grant distribution rights without contractual obligations. As a result, even though OpenBSD includes the driver, the firmware files cannot be included and users have to download these files on their own.

A prepackaged version of the firmware can be installed using fw_update(8).

The following example scans for available networks:

# ifconfig qwx0 scan

The following hostname.if(5) example configures qwx0 to join network “mynwid”, using WPA key “mywpakey”, obtaining an IP address using DHCP:

join mynwid wpakey mywpakey
inet autoconf

arp(4), ifmedia(4), intro(4), netintro(4), pci(4), hostname.if(5), ifconfig(8)

The qwx driver first appeared in OpenBSD 7.5.

The qwx driver does not support any of the 802.11n, 802.11ac, and 802.11ax capabilities offered by the hardware.

Broadcast and Multicast frames are only received on networks which do not use encryption or which use WPA2 with group cipher CCMP. This prevents ARP and IPv6 from working correctly on other types of networks.

June 3, 2024 OpenBSD-current