iwmbtfw(8)

iwmbtfw8

Load firmware for intel wireless ac bluetooth usb devices

Usage

iwmbtfw [-DI] -d device_name [-f firmware_path]

iwmbtfw -h

Overview

The iwmbtfw utility downloads the specified firmware file to the specified ugen(4) device.

This utility will only work with Intel Wireless 7260/8260/9260 and newer chip based Bluetooth USB devices, including AX and BE series wireless adapters. The identification is currently based on USB vendor ID/product ID pair and result of HCI queries. The vendor ID should be 0x8087 (USB_VENDOR_INTEL2) and the product ID should be one of the supported devices.

Firmware files are available in the comms/iwmbt-firmware port.

The iwmbtfw utility will query the device to determine which firmware image and board configuration to load in at runtime.

The options are as follows:

-I

Enable informational debugging.

-D

Enable verbose debugging.

-d device_name

Specify ugen(4) device name.

-f firmware_path

Specify the directory containing the firmware files to search and upload.

-h

Display usage message and exit.

-p

Use only USB vendor ID/product ID pair for device model identification.

Exit status

The iwmbtfw utility exits 0 on success, and >0 if an error occurs.

Releases

19 releases since FreeBSD 12.1-RELEASE; the text changed 10 times.

  1. 12.1
  2. 12.2
  3. 12.3
  4. 12.4
  5. 13.0
  6. 13.1–13.2
  7. 13.3–14.1
  8. 14.2
  9. 14.3
  10. 14.4–15.0
  11. 15.1–16.0

-p since FreeBSD 15.1-RELEASE.

Authors

iwmbtfw is based on ath3kfw(8) utility used as firmware downloader template and on Linux btintel driver source code. It is written by Vladimir Kondratyev ⟨[email protected]⟩.

Support for the 7260 card added by Philippe Michaud-Boudreault ⟨[email protected]⟩.

Bugs

Most likely. Please report if found.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.