===============
  TITLE
===============

The document describes how to support Realtek Bluetooth UART and USB driver in Linux system.

===============
  REQUIREMENT
===============

The supported kernel version is 2.6.32 - 6.5.5 or later

=============================
  QUICKLY INSTALL AUTOMATICALLY
=============================

  $ sudo make install INTERFACE=all
or
  $ sudo make install INTERFACE=usb
or
  $ sudo make install INTERFACE=uart
or
  $ sudo make install INTERFACE=sdio

  Note: Please install RTK WIFI driver before RTK BTSDIO driver installed.
        If you would run BT along, please edit the Makefile as the following.
        ---

        // ccflags-y += -DCONFIG_COMBO_MULTISDIO_EXPORT_FROM_RTW
        // KBUILD_EXTRA_SYMBOLS=/lib/firmware/Module.symvers

        ---

or
  $ sudo make install  // for the specific chip model only

===============
  FOR UART I/F
===============

-The default serial protocol of Realtek Bluetooth chip is Three-wire (H5) protocol.

-The default initial baud rate is 115200.

-Installation

  To support Three-wire (H5) protocol, you need to install Realtek hci_uart driver
  and rtk_hciattach tool.

  1. Make sure your UART setting is correct.
     host tx  - controller rx
     host rx  - controller tx
     host rts - controller cts
     host cts - ground
   ( host cts - controller rts )
   (      NC  - controller rts )  // for the older chips, such as RTL8761A, RTL8723B, RTL8821A, RTL8822B, RTL8723D, RTL8821C

  2. Install Bluetooth kernel driver and rtk_hciattach tool
   $ cd uart
   $ sudo make install

  3. Copy the right FW file and config file to the correct path.
   $ sudo mkdir -p /lib/firmware/rtlbt/
   $ sudo cp rtkbt-firmware/lib/firmware/rtlbt/rtl8xxxx_fw /lib/firmware/rtlbt/
   $ sudo cp rtkbt-firmware/lib/firmware/rtlbt/rtl8xxxx_config /lib/firmware/rtlbt/

   NOTE: PLEASE REFER THE FORWARD SECTION OF FILENAME LIST TO CORRESPONDE THE FW FILENAME AND THE CONFIG FILENAME WITH THE CHIP.

  3. Initialize Realtek Bluetooth chip by rtk_hciattach
   $ sudo rtk_hciattach -n -s 115200 ttyUSB0 rtk_h5

    Tips: ttyUSB0 is serial port name in your system, you should change it
    according to hardware such as ttyS0.

-Uninstallation
   $ sudo make uninstall

- If you want to change the parameter such as baud rate and pcm settings, you
should modify rtl8xxx_config file.

===============
  FOR USB I/F
===============

-Installation

  1. Build and install USB driver, change to the driver direcotory
   $ cd usb
   $ sudo make install

  2. Copy the right FW file and config file to the correct path.
   $ sudo cp rtkbt-firmware/lib/firmware/rtl8xxxxx_fw /lib/firmware/
   $ sudo cp rtkbt-firmware/lib/firmware/rtl8xxxxx_config /lib/firmware/

   NOTE: PLEASE REFER THE FORWARD SECTION OF FILENAME LIST TO CORRESPONDE THE FW FILENAME AND THE CONFIG FILENAME WITH THE CHIP.
	   
  3. Insert Realtek Bluetooth dongle
    Check LMP subversion by the following command
    $ hciconfig -a

    Now RTK chip can be recognized by the system and bluetooth function can be used.

-Uninstallation
   $ sudo make uninstall

===============
  FOR SDIO I/F
===============

-Installation

  Note: Please install RTK WIFI driver before RTK BTSDIO driver installed.
        If you would run BT along, please edit the Makefile as the following.
        ---

        // ccflags-y += -DCONFIG_COMBO_MULTISDIO_EXPORT_FROM_RTW
        // KBUILD_EXTRA_SYMBOLS=/lib/firmware/Module.symvers

        ---

  1. Build and install SDIO driver, change to the driver direcotory
   $ cd sdio
   $ sudo make install

  2. Copy the right FW file and config file to the correct path.
   $ sudo cp rtkbt-firmware/lib/firmware/rtl_bt/rtl8xxxxx_fw /lib/firmware/rtl_bt/
   $ sudo cp rtkbt-firmware/lib/firmware/rtl_bt/rtl8xxxxx_config /lib/firmware/rtl_bt/

   NOTE: PLEASE REFER THE FORWARD SECTION OF FILENAME LIST TO CORRESPONDE THE FW FILENAME AND THE CONFIG FILENAME WITH THE CHIP.

 3. Insert Realtek Bluetooth module
    Check LMP subversion by the following command
    $ hciconfig -a

    Now RTK chip can be recognized by the system and bluetooth function can be used.

-Uninstallation
   $ sudo make uninstall

===============	
  FILENAME LIST
===============
	
Chip		I/F 		FW/Config Path		FW Filename		Config Filename
		for
		BT driver
------------------------------------------------------------------------------------------------
RTL8761AUV	USB		/lib/firmware/		rtl8761au_fw		rtl8761a_config

RTL8761AW 	USB		/lib/firmware/		rtl8761aw_fw		rtl8761aw_config
(RTL8761AW 
+RTL8192EU)	

RTL8761AUV      USB		/lib/firmware/		rtl8761au8192ee_fw	rtl8761a_config
+RTL8192EE
 
RTL8761AUV	USB		/lib/firmware/		rtl8761au8192ee_fw	rtl8761a_config
+RTL8812AE
 
RTL8761ATV	UART		/lib/firmware/rtlbt/	rtl8761a_fw		rtl8761a_config

RTL8761ATV
+RTL8192EE	UART		/lib/firmware/rtlbt/	rtl8761at8192ee_fw	rtl8761a_config
 
-----------------------------------------------------------------------------------------------

RTL8761BUV	USB		/lib/firmware/		rtl8761bu_fw		rtl8761bu_config

RTL8761BTV	UART		/lib/firmware/rtlbt/	rtl8761b_fw		rtl8761b_config

-----------------------------------------------------------------------------------------------

RTL8725AU	USB		/lib/firmware/		rtl8725au_fw		rtl8725au_config

RTL8725AS	UART		/lib/firmware/rtlbt/	rtl8725as_fw		rtl8725as_config

-----------------------------------------------------------------------------------------------

RTL8723BU	USB		/lib/firmware/		rtl8723b_fw		rtl8723b_config
RTL8723BE

RTL8723BS	UART		/lib/firmware/rtlbt/	rtl8723b_fw		rtl8723b_config

-----------------------------------------------------------------------------------------------

RTL8723CU       USB             /lib/firmware/          rtl8723cu_fw            rtl8723cu_config

RTL8723CS       UART            /lib/firmware/rtlbt/    rtl8723cs_0_fw          rtl8723cs_0_config

-----------------------------------------------------------------------------------------------

RTL8821AU	USB		/lib/firmware/		rtl8821a_fw		rtl8821a_config
RTL8821AE

RTL8821AS	UART		/lib/firmware/rtlbt/	rtl8821a_fw		rtl8821a_config

-----------------------------------------------------------------------------------------------

RTL8822BU	USB		/lib/firmware/		rtl8822bu_fw		rtl8822bu_config
RTL8822BE

RTL8822BS	UART		/lib/firmware/rtlbt/	rtl8822b_fw		rtl8822b_config

-----------------------------------------------------------------------------------------------

RTL8723DU	USB		/lib/firmware/		rtl8723du_fw		rtl8723du_config
RTL8723DE

RTL8723DS	UART		/lib/firmware/rtlbt/	rtl8723d_fw		rtl8723d_config

-----------------------------------------------------------------------------------------------

RTL8821CU	USB		/lib/firmware/		rtl8821cu_fw		rtl8821cu_config
RTL8821CE

RTL8821CS	UART		/lib/firmware/rtlbt/	rtl8821c_fw		rtl8821c_config

-----------------------------------------------------------------------------------------------

RTL8822CU	USB		/lib/firmware/		rtl8822cu_fw		rtl8822cu_config
RTL8822CE

RTL8822CS	UART		/lib/firmware/rtlbt/	rtl8822cs_fw		rtl8822cs_config

-----------------------------------------------------------------------------------------------

RTL8821DU	USB		/lib/firmware/		rtl8821du_fw		rtl8821du_config

RTL8821DS	SDIO		/lib/firmware/rtl_bt/	rtl8821ds_fw		rtl8821ds_config

-----------------------------------------------------------------------------------------------

RTL8733BU	USB		/lib/firmware/		rtl8733bu_fw		rtl8733bu_config
RTL8733BE

RTL8733BS	UART		/lib/firmware/rtlbt/	rtl8733bs_fw		rtl8733bs_config

RTL8723FS-VS	SDIO		/lib/firmware/rtl_bt/	rtl8723fs_fw		rtl8723fs_config

-----------------------------------------------------------------------------------------------

RTL8852AU	USB		/lib/firmware/		rtl8852au_fw		rtl8852au_config
RTL8852AE

RTL8852AS	UART    	/lib/firmware/rtlbt/	rtl8852as_fw		rtl8852as_config

-----------------------------------------------------------------------------------------------

RTL8852BU	USB		/lib/firmware/		rtl8852bu_fw		rtl8852bu_config
RTL8852BE

RTL8852BS	UART		/lib/firmware/rtlbt/	rtl8852bs_fw		rtl8852bs_config

RTL8852BSA	SDIO		/lib/firmware/rtl_bt/	rtl8852bsa_fw		rtl8852bsa_config

-----------------------------------------------------------------------------------------------

RTL8851AU	USB		/lib/firmware/		rtl8851au_fw		rtl8851au_config

RTL8851ASA	SDIO		/lib/firmware/rtl_bt/	rtl8851asa_fw		rtl8851asa_config

-----------------------------------------------------------------------------------------------

RTL8852CU	USB		/lib/firmware/		rtl8852cu_fw		rtl8852cu_config
RTL8852CE

RTL8852CS	UART		/lib/firmware/rtlbt/	rtl8852cs_fw		rtl8852cs_config

-----------------------------------------------------------------------------------------------

RTL8822EU	USB		/lib/firmware/		rtl8822eu_fw		rtl8822eu_config
RTL8822EE
RTL8822CU-VE

RTL8822ES	UART		/lib/firmware/rtlbt/	rtl8822es_fw		rtl8822es_config
RTL8822CS-VE

-----------------------------------------------------------------------------------------------

RTL8852BPS	UART		/lib/firmware/rtlbt/	rtl8852bps_fw		rtl8852bps_config

-----------------------------------------------------------------------------------------------

RTL8851BU	USB		/lib/firmware/		rtl8851bu_fw		rtl8851bu_config
RTL8851BE

RTL8851BS	UART		/lib/firmware/rtlbt/	rtl8851bs_fw		rtl8851bs_config

-----------------------------------------------------------------------------------------------

RTL8852DU	USB             /lib/firmware/          rtl8852du_fw            rtl8852du_config
RTL8852DE

RTL8852DS	UART		/lib/firmware/rtlbt/	rtl8852ds_fw		rtl8852ds_config
RTL8852DE-VR

-----------------------------------------------------------------------------------------------

RTL8761CUV	USB		/lib/firmware/		rtl8761cu_mx_fw		rtl8761cu_mx_config

RTL8761CTV	UART		/lib/firmware/rtlbt/	rtl8761c_mx_fw		rtl8761c_mx_config

-----------------------------------------------------------------------------------------------

RTL8852BTU	USB		/lib/firmware/		rtl8852btu_fw		rtl8852btu_config
RTL8852BTE

RTL8852BTS	UART		/lib/firmware/rtlbt/	rtl8852bts_fw		rtl8852bts_config
RTL8852BTE-VR
-----------------------------------------------------------------------------------------------
