Skip to contentSkip to conversation

rtlwifi: v88 firmware files for rtl8192cu

PATCH Superseded Reto Schneider 4 participants 8 messages Mar 23, 2020 – Sep 20, 2020

v1 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 rtlwifi: v88 firmware files for rtl8192cu

The vendor driver v4.0.1_6911.20130308 includes new firmware files. These were extracted from data statements in that driver to form these files.

---
 WHENCE                       |  20 ++++++++++++++++++--
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 18 insertions(+), 2 deletions(-)
WHENCE +18 -2
index 6265e03..d5bde95 100644
@@ -2738,14 +2738,30 @@ Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
 
 --------------------------------------------------------------------------
 
-Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU
+Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU (fallback)
 
 File: rtlwifi/rtl8192cufw.bin
+
+Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
+
+--------------------------------------------------------------------------
+
+Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU
+
 File: rtlwifi/rtl8192cufw_A.bin
 File: rtlwifi/rtl8192cufw_B.bin
 File: rtlwifi/rtl8192cufw_TMSC.bin
+Info: From Vendor's rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 driver
+      All files extracted from driver/hal/rtl8192c/usb/Hal8192CUHWImg.c
+      Relevant variables (CONFIG_BT_COEXISTENCE not set):
+        - rtlwifi/rtl8192cufw_A.bin: Rtl8192CUFwUMCACutImgArray
+        - rtlwifi/rtl8192cufw_B.bin: Rtl8192CUFwUMCBCutImgArray
+        - rtlwifi/rtl8192cufw_TMSC.bin: Rtl8192CUFwTSMCImgArray
 
-Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
+Licence: Allegedly GPLv2, but no source visible.
+
+Found in hex form in kernel source, with the following comment:
+   Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
 
 --------------------------------------------------------------------------
 
rtlwifi/rtl8192cufw_A.bin binary +0 -0
index 9569d0a236ae57304fa814e04dcbe9254fe0fa69..fceafc922cc2118d8ead2a6f7faf241df0ea0d00 100644
GIT binary patch
rtlwifi/rtl8192cufw_B.bin binary +0 -0
index 96089c4c9e6e5a95d06ed6e5a93bf9a4478e156d..06569e7f60cd573936546b28f2530f4ccfe68161 100644
GIT binary patch
rtlwifi/rtl8192cufw_TMSC.bin binary +0 -0
index d1b84d4886d1864e7ada9ff175a1850d32061158..ec0a0d3e544af69e452f5d1054157b493ac847e3 100644
GIT binary patch
Signature · 1 line
2.20.1
#1 lore raw
Quoted 33 lines · Reto Schneider

The vendor driver v4.0.1_6911.20130308 includes new firmware files. These were extracted from data statements in that driver to form these files.

---
  WHENCE                       |  20 ++++++++++++++++++--
  rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
  rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
  rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
  4 files changed, 18 insertions(+), 2 deletions(-)
WHENCE +8 -1
index 6265e03..d5bde95 100644
@@ -2738,14 +2738,30 @@ Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
 
  --------------------------------------------------------------------------
 
-Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU
+Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU (fallback)
 
  File: rtlwifi/rtl8192cufw.bin
+
+Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
+
+--------------------------------------------------------------------------
+
+Driver: rtl8192cu - Realtek 802.11n WLAN driver for RTL8192CU
+
  File: rtlwifi/rtl8192cufw_A.bin
  File: rtlwifi/rtl8192cufw_B.bin

WHENCE Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details. · line 2761

Quoted 10 lines
WHENCE +7 -1
  File: rtlwifi/rtl8192cufw_TMSC.bin
+Info: From Vendor's rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 driver
+      All files extracted from driver/hal/rtl8192c/usb/Hal8192CUHWImg.c
+      Relevant variables (CONFIG_BT_COEXISTENCE not set):
+        - rtlwifi/rtl8192cufw_A.bin: Rtl8192CUFwUMCACutImgArray
+        - rtlwifi/rtl8192cufw_B.bin: Rtl8192CUFwUMCBCutImgArray
+        - rtlwifi/rtl8192cufw_TMSC.bin: Rtl8192CUFwTSMCImgArray
 
-Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
+Licence: Allegedly GPLv2, but no source visible.

No, do not change this line. The firmware is NOT GPLv2; however, it can be redistributed as LICENCE.rtlwiifi says.

NACK.

Larry

#2 lore raw

v2 cover Updating RTL8192CU firmware

In reply to Reto Schneider

Before this update, with version 80 of the firmware, the USB interface of the RTL8192CU WLAN controller often locked itself up:
usb 1-2: device descriptor read/64, error -110
usb 1-2: device not accepting address 4, error -110
usb 1-2: device not accepting address 5, error -110
usb usb1-port2: unable to enumerate USB device
usb 2-2: device descriptor read/64, error -110
usb 2-2: device descriptor read/64, error -110

On ARMv5 based GARDENA smart gateway running Linux 4.19.78, this can be reliably reproduced by rebooting (warm) the gateway multiple times (max. 50 attempts needed).
Unlike users having this issues on a USB Wi-Fi dongle, resetting of the chip by replugging is not an option on this gateway due to the lack of any power cut functionality. Therefore, a (cold) reboot of the whole gateway is needed.

Updating the firmware of the RTL8192CU WLAN controller from version v80.0 to v88.2 (as per output of rtl8xxxu, which was used temporarily) seems to resolve this issue. The problem did no show up anymore for 1000 restarts.
Please note that only rtl8192cufw_TMSC.bin has been tested.

Unrelated of this USB problem, another issue still remains: Using the rtl8192cu driver, scanning for available SSIDs yields no more results after a few hundred scans (iw wlan0 scan).

Also, the Realtek drivers containing v88.2 of the firmware (v4.0.1_6911.20130308 to v4.0.9_25039.20171107) have some changes compared to the version v3.4.2_3727.20120404, for which I am unsure of whether they need to be reflected in rtl8192cu and/or rtl8xxxu. What I could spot for sure however, is that some tables have been updated:
https://github.com/rettichschnidi/linux/commit/0c865ba26aba907b601b3b73c82111dd10e59ffe

I am unsure if this changes are relevant and how the best way would be to ensure that this commit does not break old drivers out there.

Reto Schneider (1):
rtlwifi: v88.2 firmware files for RTL8192CU

 WHENCE                       |   6 ++++++
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 6 insertions(+)
Signature · 1 line
2.20.1
#3 lore raw

PATCH v2 1/1 rtlwifi: v88.2 firmware files for RTL8192CU

The vendor driver rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 includes new firmware files. These were extracted from data statements in that driver to form these files.

---
 WHENCE                       |   6 ++++++
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 6 insertions(+)
WHENCE +6 -0
index 6265e03..ccacf4d 100644
@@ -2744,6 +2744,12 @@ File: rtlwifi/rtl8192cufw.bin
 File: rtlwifi/rtl8192cufw_A.bin
 File: rtlwifi/rtl8192cufw_B.bin
 File: rtlwifi/rtl8192cufw_TMSC.bin
+Info: From Vendor's rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 driver
+      All files extracted from driver/hal/rtl8192c/usb/Hal8192CUHWImg.c
+      Relevant variables (CONFIG_BT_COEXISTENCE not set):
+        - rtlwifi/rtl8192cufw_A.bin: Rtl8192CUFwUMCACutImgArray
+        - rtlwifi/rtl8192cufw_B.bin: Rtl8192CUFwUMCBCutImgArray
+        - rtlwifi/rtl8192cufw_TMSC.bin: Rtl8192CUFwTSMCImgArray
 
 Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
 
rtlwifi/rtl8192cufw_A.bin binary +0 -0
index 9569d0a236ae57304fa814e04dcbe9254fe0fa69..fceafc922cc2118d8ead2a6f7faf241df0ea0d00 100644
GIT binary patch
rtlwifi/rtl8192cufw_B.bin binary +0 -0
index 96089c4c9e6e5a95d06ed6e5a93bf9a4478e156d..06569e7f60cd573936546b28f2530f4ccfe68161 100644
GIT binary patch
rtlwifi/rtl8192cufw_TMSC.bin binary +0 -0
index d1b84d4886d1864e7ada9ff175a1850d32061158..ec0a0d3e544af69e452f5d1054157b493ac847e3 100644
GIT binary patch
Signature · 1 line
2.20.1
Tested-by on v2 1/1
#4 lore raw

Re: [PATCH v2 1/1] rtlwifi: v88.2 firmware files for RTL8192CU

Quoted 6 lines · Reto Schneider

The vendor driver rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 includes new firmware files. These were extracted from data statements in that driver to form these files.

Quoted 1,110 lines
---
 WHENCE                       |   6 ++++++
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 6 insertions(+)
WHENCE +6 -0
index 6265e03..ccacf4d 100644
@@ -2744,6 +2744,12 @@ File: rtlwifi/rtl8192cufw.bin
 File: rtlwifi/rtl8192cufw_A.bin
 File: rtlwifi/rtl8192cufw_B.bin
 File: rtlwifi/rtl8192cufw_TMSC.bin
+Info: From Vendor's rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 driver
+      All files extracted from driver/hal/rtl8192c/usb/Hal8192CUHWImg.c
+      Relevant variables (CONFIG_BT_COEXISTENCE not set):
+        - rtlwifi/rtl8192cufw_A.bin: Rtl8192CUFwUMCACutImgArray
+        - rtlwifi/rtl8192cufw_B.bin: Rtl8192CUFwUMCBCutImgArray
+        - rtlwifi/rtl8192cufw_TMSC.bin: Rtl8192CUFwTSMCImgArray
 
 Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
 
rtlwifi/rtl8192cufw_A.bin binary +0 -0
index 9569d0a236ae57304fa814e04dcbe9254fe0fa69..fceafc922cc2118d8ead2a6f7faf241df0ea0d00 100644
GIT binary patch
rtlwifi/rtl8192cufw_B.bin binary +0 -0
index 96089c4c9e6e5a95d06ed6e5a93bf9a4478e156d..06569e7f60cd573936546b28f2530f4ccfe68161 100644
GIT binary patch
rtlwifi/rtl8192cufw_TMSC.bin binary +0 -1
index d1b84d4886d1864e7ada9ff175a1850d32061158..ec0a0d3e544af69e452f5d1054157b493ac847e3 100644
GIT binary patch
 
--

2.20.1

#5 lore raw

Re: [PATCH v2 1/1] rtlwifi: v88.2 firmware files for RTL8192CU

Quoted 4 lines · Chris Chiu
Quoted 2 lines · Reto Schneider

The vendor driver rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 includes

Where can one get that driver? It's unclear to me what the terms and conditions around its usage are, and therefore I can't tell if deriving values from this driver are permitted.

If you can get an Ack from someone from Realtek, or someone that normally maintains the upstream drivers, that would go a long way.

josh

Quoted 1,115 lines
Quoted 4 lines

new firmware files. These were extracted from data statements in that driver to form these files.

Quoted 1,110 lines
---
 WHENCE                       |   6 ++++++
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 6 insertions(+)
WHENCE +6 -0
index 6265e03..ccacf4d 100644
@@ -2744,6 +2744,12 @@ File: rtlwifi/rtl8192cufw.bin
 File: rtlwifi/rtl8192cufw_A.bin
 File: rtlwifi/rtl8192cufw_B.bin
 File: rtlwifi/rtl8192cufw_TMSC.bin
+Info: From Vendor's rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 driver
+      All files extracted from driver/hal/rtl8192c/usb/Hal8192CUHWImg.c
+      Relevant variables (CONFIG_BT_COEXISTENCE not set):
+        - rtlwifi/rtl8192cufw_A.bin: Rtl8192CUFwUMCACutImgArray
+        - rtlwifi/rtl8192cufw_B.bin: Rtl8192CUFwUMCBCutImgArray
+        - rtlwifi/rtl8192cufw_TMSC.bin: Rtl8192CUFwTSMCImgArray
 
 Licence: Redistributable. See LICENCE.rtlwifi_firmware.txt for details.
 
rtlwifi/rtl8192cufw_A.bin binary +0 -0
index 9569d0a236ae57304fa814e04dcbe9254fe0fa69..fceafc922cc2118d8ead2a6f7faf241df0ea0d00 100644
GIT binary patch
rtlwifi/rtl8192cufw_B.bin binary +0 -0
index 96089c4c9e6e5a95d06ed6e5a93bf9a4478e156d..06569e7f60cd573936546b28f2530f4ccfe68161 100644
GIT binary patch
rtlwifi/rtl8192cufw_TMSC.bin binary +0 -1
index d1b84d4886d1864e7ada9ff175a1850d32061158..ec0a0d3e544af69e452f5d1054157b493ac847e3 100644
GIT binary patch
 
--

2.20.1

#6 lore raw

Re: [PATCH v2 1/1] rtlwifi: v88.2 firmware files for RTL8192CU

Quoted 7 lines · Josh Boyer
Quoted 3 lines · Reto Schneider
Quoted 2 lines

The vendor driver rtl8188C_8192C_usb_linux_v4.0.1_6911.20130308 includes

Where can one get that driver? It's unclear to me what the terms and conditions around its usage are, and therefore I can't tell if deriving values from this driver are permitted.

This driver was available on the official Realtek servers before they prevented accessing their FTP servers [0][1]. Luckly, someone mirrored its content on GitHub [2], which is also where I got the driver from [3].

Quoted 1 line

If you can get an Ack from someone from Realtek, or someone that

I have no contacts to anyone at Realtek. Not sure if "cold" e-mailing random people there would be helpful.

Quoted 1 line

normally maintains the upstream drivers, that would go a long way.

Jes Sorensen, the maintainer of rtl8xxxu redirected me to Chris Chiu in order to get (paid) work done on rtl8xxxu (which includes testing this FW). Does this help?

Kind regards,
Reto

[0]
https://forums.mydigitallife.net/threads/ftp3-realtek-com-tw.72385/#post-1581267
[1] https://github.com/lwfinger/rtl8188eu/issues/275
[2] https://github.com/XAIOThaifeng/realtek-linux
[3]
https://github.com/XAIOThaifeng/realtek-linux/tree/370738ceb9efa42c31ecdcb4db90ee0d6d064004/RTL8188C_8192C/USB/v4.0

#7 lore raw

Re: [PATCH v2 0/1] Updating RTL8192CU firmware

In reply to Reto Schneider
Quoted 38 lines · Reto Schneider

Before this update, with version 80 of the firmware, the USB interface of the RTL8192CU WLAN controller often locked itself up:
usb 1-2: device descriptor read/64, error -110
usb 1-2: device not accepting address 4, error -110
usb 1-2: device not accepting address 5, error -110
usb usb1-port2: unable to enumerate USB device
usb 2-2: device descriptor read/64, error -110
usb 2-2: device descriptor read/64, error -110

On ARMv5 based GARDENA smart gateway running Linux 4.19.78, this can be reliably reproduced by rebooting (warm) the gateway multiple times (max. 50 attempts needed).
Unlike users having this issues on a USB Wi-Fi dongle, resetting of the chip by replugging is not an option on this gateway due to the lack of any power cut functionality. Therefore, a (cold) reboot of the whole gateway is needed.

Updating the firmware of the RTL8192CU WLAN controller from version v80.0 to v88.2 (as per output of rtl8xxxu, which was used temporarily) seems to resolve this issue. The problem did no show up anymore for 1000 restarts.
Please note that only rtl8192cufw_TMSC.bin has been tested.

Unrelated of this USB problem, another issue still remains: Using the rtl8192cu driver, scanning for available SSIDs yields no more results after a few hundred scans (iw wlan0 scan).

Also, the Realtek drivers containing v88.2 of the firmware (v4.0.1_6911.20130308 to v4.0.9_25039.20171107) have some changes compared to the version v3.4.2_3727.20120404, for which I am unsure of whether they need to be reflected in rtl8192cu and/or rtl8xxxu. What I could spot for sure however, is that some tables have been updated:
https://github.com/rettichschnidi/linux/commit/0c865ba26aba907b601b3b73c82111dd10e59ffe

I am unsure if this changes are relevant and how the best way would be to ensure that this commit does not break old drivers out there.

Quoted 9 lines

Reto Schneider (1):
rtlwifi: v88.2 firmware files for RTL8192CU

 WHENCE                       |   6 ++++++
 rtlwifi/rtl8192cufw_A.bin    | Bin 16116 -> 16126 bytes
 rtlwifi/rtl8192cufw_B.bin    | Bin 16096 -> 16096 bytes
 rtlwifi/rtl8192cufw_TMSC.bin | Bin 16116 -> 16126 bytes
 4 files changed, 6 insertions(+)

Is there anything left I need to do in order to get this patch merged?

Reto