QWX(4)

NAME
qwx - Qualcomm IEEE 802.11a/ac/ax/b/g/n wireless network device

SYNOPSIS
qwx* at pci?

DESCRIPTION
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).

FILES
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).

EXAMPLES
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

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

HISTORY
The qwx driver first appeared in OpenBSD 7.5.

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

BUGS
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.