Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RTLBTFW(8)		    System Manager's Manual		    RTLBTFW(8)

NAME
       rtlbtfw	--  firmware download utility for Realtek 87XX/88XX chip based
       Bluetooth USB devices

SYNOPSIS
       rtlbtfw -d device_name -f firmware_path
       rtlbtfw -h

DESCRIPTION
       The rtlbtfw utility downloads the specified firmware file to the	speci-
       fied ugen(4) device.

       This utility will only work with	Realtek	87XX/88XX chip based Bluetooth
       USB devices and some of their successors.  The identification  is  cur-
       rently based on USB vendor ID/product ID	pair and interface class.  For
       Realtek devices the vendor ID should be 0x0bda (USB_VENDOR_REALTEK) and
       the  0-th  interface  class/subclass/protocol  should be	a Bluetooth RF
       Wireless	Controller.  Non-Realtek devices are identified	based  on  USB
       vendor ID/product ID pair.

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

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

       The options are as follows:

       -D      Enable verbose debugging.

       -d device_name
	       Specify ugen(4) device name.

       -I      Enable informational debugging.

       -f firmware_path
	       Specify the directory containing	the firmware files  to	search
	       and upload.

       -h      Display usage message and exit.

EXIT STATUS
       The rtlbtfw utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
       libusb(3), ng_ubt(4), ugen(4), devd(8)

AUTHORS
       rtlbtfw is based	on ath3kfw(8) utility used as firmware downloader tem-
       plate and on Linux btrtl	driver source code.  It	is written by Vladimir
       Kondratyev <wulf@FreeBSD.org> under sponsorship from Future Crew	LLC.

BUGS
       Most likely.  Please report if found.

FreeBSD	14.3			 July 19, 2023			    RTLBTFW(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rtlbtfw&sektion=8&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help