QWX(4) - Device Drivers Manual #

QWX(4) - Device Drivers Manual

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.

OpenBSD 7.5 - February 21, 2024