Product Info

ManualsBrandsShenzhen KTC Commercial Display Technology ManualsElectronicsWIFI Module

Table Of Contents

RTL8822CE

RTL8822CU

RTL8822CS

COB

MP FLOW

R12

This document is subject to change without notice. The document

contains Realtek confidential information and must not be disclosed

to any third party without appropriate NDA.

Summary of content (96 pages)

PAGE 1
RTL8822CE RTL8822CU RTL8822CS COB MP FLOW R12 This document is subject to change without notice. The document contains Realtek confidential information and must not be disclosed to any third party without appropriate NDA.
PAGE 2
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Table of Contents 1. DUT MP Flow ........................................................................................................................... 7 2. Environment setup .................................................................................................................... 8 3. 2.1. Test platform ................................................................................................................................. 8 2.2.
PAGE 3
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.3.2. Calibration Tx flatness K ........................................................................................................................ 42 4.3.3. Shift Tx Level.......................................................................................................................................... 43 4.3.4. Calibration thermal meter ..........................................................................................................
PAGE 4
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 6.2. 7. Software Rx parameters ............................................................................................................. 65 Bluetooth MP flow appendix .................................................................................................. 66 7.1. Bluetooth MP tool command usage ........................................................................................ 67 7.1.1. Bluetooth start , exit and help command .........
PAGE 5
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW List of Tables Table 1: Crystal calibration offset in eFuse ..................................................................... 17 Table 2: Tx index and Thermal meter offset in eFuse ..................................................... 18 Table 3: The default target power .................................................................................... 19 Table 4: The recommended measured channel for Tx power calibration .......................
PAGE 6
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW List of Figures Figure 1: Brief diagram about test environment setup of DUT ......................................... 8 Figure 2: Connect PC to Android/Linux device ................................................................ 9 Figure 3: Check the connection between PC & Android/Linux device............................. 9 Figure 4: Enter Android/Linux device command line .......................................................
PAGE 7
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Revision History: Revision Date Changes Author R12 2020/03/12 Re-write from COB flow R11 6 DeanKu ©2019 Realtek Semiconductor Corp.
PAGE 8
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 1. DUT MP Flow The below diagram shows a global view of Mass-Production-Flow, please refer to the following sub-section to get the detail description of each step.
PAGE 9
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 2. Environment setup 2.1. Test platform The calibration flow described in following sections are based on WiFi tester. Realtek had qualified tester is listed below: Include 802.11ac Test Only 802.
PAGE 10
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 2.2. CMD environment setup Step1 : Use USB cable to connect PC and Android/Linux devices as Figure 3. Connect with USB Figure 2: Connect PC to Android/Linux device Step2 : Use adb command as below: adb devices How to check whether the Android/Linux devices were connected or not? Figure 4 shows a result if the PC connects to Android/Linux devices successfully.
PAGE 11
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3. WiFi Mass Production Flow 3.1. WiFi calibration The WiFi calibration steps are shown as Figure 6: WiFi initialize Pre-heating Dump result to HW eFuse Tx index calibration Load default map to fake Crystal calibration WiFi calibration Figure 5: WiFi calibration flow 3.1.1. WiFi initialize Refer to Section 2.2, PC can connect to Android/Linux devices with USB port and ADB command.
PAGE 12
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.2. Pre-heating Pre-heating is an one-time experiment to grab essential setup, it made DUT closed to the usual temperature and improved the stability of mass production. It will pre-heat the DUT for seconds before mass production. Step 1 : Read and record thermal value THERRX at steady Rx status which lasts 5 minutes at room temperature. rtwpriv wlan0 mp_start //Enter WiFi MP mode Wait for 5 minute.
PAGE 13
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Example : rtwpriv wlan0 mp_start //Enter WiFi MP mode Wait for 5 minute. rtwpriv wlan0 mp_ther //MP feedback the thermal value = 2d Record the THERRX = 2d rtwpriv wlan0 6 1 a HTMCS7 1 200 1000 Example : Use HW Tx, HT40 HTMCS7 channel 6, TxPacketInterval = 200, TxPacketLength = 1000 to pre-heat DUT. 5 seconds past.
PAGE 14
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.3. Load default map to fake map from eFuse/Mask map files. Load external eFuse map file to driver fake map rtwpriv wlan0 efuse_file /../../efuse.map Load external mask map file to driver fake map : rtwpriv wlan0 efuse_mask /xx/xx/xxmask.txt 13 ©2019 Realtek Semiconductor Corp.
PAGE 15
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.4. Crystal calibration Start to Find Index Set Index = InitIndex Set MCS7 40M Tx Set Index = Index + (TargetCFOffset – MeasuredCFOsset) / Step No Measure Carrier Frequency (Hz) Abs. Value of MeasuredCFOffset < 2ppm YES Have Found Index Figure 6: Finding Crystal Cap. Index Flow InitIndex: the default value is 0x40. Index range is 0x0 to 0x7F. MeasuredCFOffset: Carrier frequency measured by instrument - ideal carrier frequency target range Abs.
PAGE 16
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Command is as below: Step 1 : rtwpriv wlan0 mp_setrfpath 1 //WiFi MP driver will set RF path automatically, too. rtwpriv wlan0 7 1 a HTMCS7 1 2000 //start HW Tx Step 2 : 1. To measure frequency error (ppm), Freq_Err. 2. Freq_Err should be limited to ±2ppm. 3. If Freq_Err is between ±2ppm, it means the Index_cry is correct. 4. If the Freq_Err is out of ±2ppm, try the algorithm below to find next index_cry_next until Freq_Err is between ±2ppm.
PAGE 17
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW rtwpriv wlan0 stop //stop HW Tx 16 ©2019 Realtek Semiconductor Corp.
PAGE 18
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Crystal calibration eFuse offset and notice : The values must be well-calibrated and filled in the correct eFuse location. Crystal Calibration 0xB9, 0x110, 0x111 Table 1: Crystal calibration offset in eFuse 1. 0xB9, 0x110, 0x111 should be the same value as each other. 2. For the situation of K-free flow ,the eFuse content may be loaded from an external file in the system.
PAGE 19
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Tx index location in EFuse of Antenna B MCS7 B40 CCK MCS7 B40 MCS7 B40 MCS7 B40 Group 1 Group 2 Group 3 Group 4 Group 5 Group 6 CH1 – CH2 CH3 – CH5 CH6 – CH8 CH9 – CH11 CH12 – CH13 CH14 0x40[7:0] 0x41[7:0] 0x42[7:0] 0x43[7:0] 0x44[7:0] 0x3A[7:0] 0x3B[7:0] 0x3C[7:0] 0x3D[7:0] 0x3E[7:0] 0x3F[7:0] Group 7 Group 8 Group 9 Group 10 CH36 – CH40 CH44 – CH48 CH52 – CH56 CH60 – CH64 0x4C[7:0] 0x4D[7:0] 0x4E[7:0] 0x4F[7:0] Group 1
PAGE 20
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.5.2. Defined target power According to EMI/EMC regulatory IEEE TX EVM / Spectrum Mask requirement, the target power of each channel group and PHY data rate can be defined.
PAGE 21
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.5.3. Tx index calibration flow Start Calibration Set Data Rate = MCS7-B40 Set Above Channels sequentially Find the relation between index and power level. The found index is Index_MCS7_B40 If the channel measuring of the path have not completed. Set Antenna = A All the path and channel measuring had been done. The channel measuring had been done.
PAGE 22
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.5.4. Tx index calibration command and sample Step 1 : Switch the Tx power tracking state to the Tx index calibration state. insmod 8822c.ko rtw_RFE_type=X Tx index for each channel group with PHY data rate in path a, path b should be calibrated. The following command take “ Path A, Channel 7, HT40, HTMCS7” as example. Step 2 : MP start and enter Tx index calibration mode.
PAGE 23
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.5.4.1. Interpolation for finding Tx index Theoretically, we need to measure all value defined in eFuse to calibrate the Tx power level. But since it needs too much time, we only measure several channels with MCS7-B40 signal and figure out the other non-measured value by interpolation method.
PAGE 24
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.5.4.2. The Tx power difference The power value difference are between +7 and -8. The value 0x0 ~ 0x7 in eFuse means 0 ~ +7 and the value 0x8 ~ 0xF in eFuse means -8 ~ -1. The +1 power difference will plus 0.5dB power.
PAGE 25
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Power Difference Location in EFuse of Antenna A 2G Band 5G Band 54M-1T to MCS7-B40 0x1B[3:0] MCS7-B20 to MCS7-B40 0x1B[7:4] MCS15-B40 to MCS7-B40 0x1C[7:4] MCS15-B20 to MCS7-B20 0x1C[3:0] 54M-2T to 54M-1T 0x1D[7:4] CCK-2T to CCK-1T 0x1D[3:0] 54M-1T to MCS7-B40 0x30[3:0] MCS7-B20 to MCS7-B40 0x30[7:4] MCS7-Nss1-B80 to MCS7-B40 0x36[7:4] MCS15-B40 to MCS7-B40 0x31[7:4] MCS15-B20 to MCS7-B20 0x31[3:0] 54M-2T to 54M-1T 0x34[7:4] MCS7-Nss
PAGE 26
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.1.6. Thermal meter Normal driver will load thermal meter to do power-tracking, so the value must be filled in correct eFuse location. Use the below MP API function to get thermal meter value: Read Path A thermal vaule : rtwpriv wlan0 mp_ther 0 Read Path B thermal vaule : rtwpriv wlan0 mp_ther 1 And the feedback information would show like below, 29 is the thermal value. wlan0 mp_ther:29 Write the thermal value into efuse. PathA writes to 0xD0.
PAGE 27
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.2. WiFi performance verification Tx performance verification WiFi performance verification Rx performance verification 3.2.1. Tx performance verification The following flow will show the Tx performance verification flow, criterion, and sample command. 3.2.1.1. Tx performance verification criterion Use the calibrated Tx index in previous step and measure Tx power, EVM, frequency offset and LO leakage to check Tx performance is ok or not.
PAGE 28
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Data Rate Antenna Channel CH42 MCS7-Nss1-B80 Antenna A CH58 Antenna B CH138 CH155 MCS7-B40 OFDM 54M Antenna A Antenna B Antenna A Antenna B CH118 CH100 Item Criterion Power Typical: 16dBm, Acceptable Range: +1.5/-2dB EVM < -28dB Freq. Err. ±10ppm Leakage < -25dBtotal Mask IEEE spec. defined Power Typical: 16dBm, Acceptable Range: +1.5/-2dB EVM < -28dB Freq. Err. ±10ppm Leakage < -20dBtotal Mask IEEE spec.
PAGE 29
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW If the instrument supports true MIMO, switch MIMO or composite EVM analysis method, the VHT and HT items (OFDM is as same as above) criterion can be changed to below table: Data Rate Antenna Channel CH42 MCS7-Nss2-B80 Antenna AB CH58 CH138 CH155 MCS15-B40 MCS15-B40 Antenna AB Antenna AB CH118 CH10 Item Criterion Power Typical: 15dBm, Acceptable Range: +1.5/-2dB EVM < -28dB Freq. Err. ±10ppm Leakage < -25dBtotal Mask IEEE spec.
PAGE 30
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.2.1.2. Verify Tx performance The following steps are the Tx performance verify command sample : Step 1 : Enter WL MP mode. rtwpriv wlan0 mp_start Step 2 : Set HW Tx and Tx index to the case which is going to do the verification.
PAGE 31
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.2.2. Rx performance verification The following flow will show the Rx performance verification flow, criterion, and sample command. 3.2.2.1. Rx performance verification criterion Measure the DUT Rx sensitivity to check Rx performance is ok or not.
PAGE 32
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 3.2.2.2. Verify Rx performance Set the instrument to Tx packets, and DUT MP Rx the packets. Then parsing the error rate to verify Rx performance. The following steps are the Rx performance verify command sample : Step 1 : Start SW(Software) Rx Example : Verify path A, MCS7, bandwidth 40, CH10 Rx.
PAGE 33
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Step 3 : Calculate packet-error-rate Calculate packet-error-rate with step2 result. The recommended packet-error-rate is < 10%(MCS, OFDM), < 8% (CCK). Example : (1) Instrument Tx 1000 packets at MCS7, bandwidth 40, CH10. (2) Step 2 reports DUT had Rx 920 packets which Tx from instrument and its input power < -61dBm successfully.
PAGE 34
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4. Bluetooth Mass Production Flow The below diagram shows a global view of Bluetooth mass production flow. Bluetooth device environment setup Change RF path Bluetooth initial Bluetooth reset Calibration Tx gain K Calibration Tx flatness K Shift Tx level Bluetooth device initial Bluetooth calibration Calibration thermal meter Verify BDR/EDR Verify BLE 1M/2M Bluetooth verify Exit Bluetooth Set Tx power Note: 1.
PAGE 35
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.1. Bluetooth device environment setup To do BT RF test, “rtlbtmp” is a necessary tool. 4.1.1. Android OS MP tool package is provided to customers in binary format: MP ADB tool  rtlbtmp MP library  btmp.default.so Customers should copy these binary files to respective directories on target production: rtlbtmp  save to  /system/bin/ chmod rtlbtmp  chmod 755 /system/bin/rtlbtmp btmp.default.
PAGE 36
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.1.2.
PAGE 37
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.2. Bluetooth device initial In the initial stage, the Bluetooth device must set to factory default and set antenna patch . The Initial command list as : Step1 : Change BT RF path ifconfig wlan0 up sleep 1 rtwpriv wlan0 mp_start rtwpriv wlan0 mp_setrfpath 0 // 0 or 1 rtwpriv wlan0 mp_ant_tx a // a or b Step2 : Bluetooth initial Start MP CMD Tool rtlbtmp Enable MP Stack Check Bluetooth stack HCI interface first, then run the enable MP stack CMD.
PAGE 38
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Step3 : Bluetooth reset Disable Thermal power tracking bt_mp_SetParam 18,0,0 bt_mp_Exec 42 Set Tx gain K to 0 to “ Reset Tx Gain K “ bt_mp_SetParam 18,1,0x00 // set ;The value (2's complement) is TX Gain k value bt_mp_Exec 45 Set Flatness K to 0 to ” Reset Flatness K ” bt_mp_SetParam 18,1,0,0 bt_mp_Exec 46 Set antenna path bt_mp_SetParam 18,0 //The value is antenna path : 0:S0 1:S1 bt_mp_Exec 40 37 ©2019 Realtek Semiconductor Corp.
PAGE 39
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.3. Bluetooth calibration The flow show as below: Bluetooth calibration Calibration Tx gain K Calibration Tx flatness K Shift Tx level Calibration thermal meter The schematic diagram of this Tx gain K, flatness K and shift Tx level is as follows : Figure 9: Bluetooth TxPower/TxGainK/TxFlatnessK relationship 38 ©2019 Realtek Semiconductor Corp.
PAGE 40
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Now ,We should control the bluetooth device then to enter 2 or 3 command : Set parameters Execute commands Report result Step1 : Set parameters : bt_mp_SetParam The Format is : bt_mp_SetParam Index0,value0; Index1,..
PAGE 41
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Step2 : Execute commands To execute the parameters/command set in Step1 : bt_mp_Exec ACTION_INDEX Example: To run “ PACKET_TX_START ” and “PACKET_TX_STOP” actions, please use : bt_mp_Exec 12 //PACKET_TX_STRAT bt_mp_Exec 14 //PACKET_Tx_STOP For the detail parameters/indexs/command-IDs, please refer to appendix “7.1.4. : Bluetooth MP mode execute commands”.
PAGE 42
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.3.1. Calibration Tx gain K Here demonstrate the flow about calibrating Tx power to target power. We supposed to use desired target power as calibration power in this step. This Tx gain K is a signed value. Tx gain K value value 12 0x0C … … 4 0x04 3 0x03 2 0x02 1 0x01 0 0 (Default) -1 0xFF -2 0xFE -3 0xFD -4 0xFC … … -12 0xF4 Table 12: Tx gain K mapping table Step 1 : Begin 2DH5 packet Tx in channel “0x27”.
PAGE 43
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.3.2. Calibration Tx flatness K Let's correct the flatness of the channel. The step by step commands are in the below.
PAGE 44
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.3.3. Shift Tx Level After finished “Calibrate Tx power to target power” and “Calibrate Tx power flatness”, then use the table below to set the target Tx power for different antenna paths. Please refer “7.4. : Bluetooth Tx power table”.
PAGE 45
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4. Bluetooth verify The flow show as: Verify BDR/EDR Verify BLE 1M/2M Bluetooth verify 4.4.1. Verify Bluetooth BDR/EDR The verify need to verify Tx and RX. 4.4.1.1. Verify Bluetooth BDR/EDR Tx If the device is UART interface, use below commands at android and Linux platform. Please refer the “7.5. : Verify Bluetooth BDR/EDR Tx SPEC” to check performance SPEC.
PAGE 46
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Step 3 : Set Parameter : For example , Only show some settings for DH1 and 3DH5.
PAGE 47
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.1.2. Verify Bluetooth BDR/EDR Rx For android and Linux ,you can use below command to test. Please refer the “7.6. : Verify Bluetooth BDR/EDR Rx SPEC” to check performance SPEC. The below command only shows some settings for DH1 and 3DH1.
PAGE 48
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Step 3 : Run Packe Rx (FW_PACKET_RX_START=32) Step 4 : To setting parameter with the Bluetooth test instrument. Bluetooth test instrument begin transmit. bt_mp_Exec 32 Step 5 : Report Received Result. -- “bt_mp_Report 3” should be executed every 1s. Step 6 : Stop Packet Rx (FW_PACKET_RX_STOP=33) bt_mp_Exec 33 Step 7 : Exit MP Mode 47 ©2019 Realtek Semiconductor Corp.
PAGE 49
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.2. Verify Bluetooth BLE This BLE RF performance includes spec for BT4.0 and BT5.0. This test item contains the following items:    Verify Bluetooth BLE 1M TX Verify Bluetooth BLE 2M TX Verify Bluetooth BLE 1M RX  Verify Bluetooth BLE 2M RX 48 ©2019 Realtek Semiconductor Corp.
PAGE 50
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.2.1. Verify Bluetooth BLE 1M Tx (BT4.0) To measure the DUT BLE TX power and modulation index to check whether BLE TX performance is fine or not. The steps shows the adb commands for UART interface device at Android/Linux platform. Step 1 : Enter MP Mode and download patch code Step 2 : Set Parameter : INDEX VALUE 1 ChannelNumber Value Range (BLE 5.
PAGE 51
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Channel Test item Command 0 Avg_power bt_mp_SetParam 1,0x00;3,0x00;15,0xff;16,1 19 Avg_power bt_mp_SetParam 1,0x13;3,0x00;15,0xff;16,1 39 Avg_power bt_mp_SetParam 1,0x27;3,0x00;15,0xff;16,1 0 Delta F1 bt_mp_SetParam 1,0x00;3,0x01;15,0xff;16,1 0 Delta F2 bt_mp_SetParam 1,0x00;3,0x02;15,0xff;16,1 Step 3 : LE TX TEST bt_mp_Exec 22 Step 4 : LE TEST END bt_mp_Exec 24 Please refer “7.7. : Verify Bluetooth BLE Tx Performance (BLE 1M)”.
PAGE 52
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.2.2. Verify Bluetooth BLE 2M Tx(BT5.0) If need to verify BLE 5.
PAGE 53
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.2.3. Verify Bluetooth BLE 1M Rx(BT4.0) For android and Linux ,you can use below command to test. Step 1 : Set Parameter INDEX VALUE 1 ChannelNumber Value Range (BLE 5.
PAGE 54
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.4.2.4. Verify Bluetooth BLE 2M Rx(BT5.0) The Command step by step list below : Step 1 : Enter Hci reset to reset the DUT.
PAGE 55
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 4.5. Bluetooth MP Exit Disable MP Stack disable Exit MP Tool quit 54 ©2019 Realtek Semiconductor Corp.
PAGE 56
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5. Dump result to HW efuse Read default eFuse file to driver fake area In this step Checkout the driver fake map WiFi : MAC Addr./Thermal /Power index/Tx index/Crystal calibration value Modify the specific offset of the fake map BT : MAC Addr./Thermal /Tx gain/Flatness/LBT calibration value Update HW eFuse from fake map These values should be check-in to fake area. Check the HW eFuse content 55 ©2019 Realtek Semiconductor Corp.
PAGE 57
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.1. WiFi MP results eFuse check-in flow 5.1.1. Read default eFuse file to driver fake area If the default map have already loaded in section 3.1.3., please skip 5.1.1.. Load external eFuse map file to driver fake map : rtwpriv wlan0 efuse_file /../../efuse.map Load external mask map file to driver fake map : rtwpriv wlan0 efuse_mask /xx/xx/xxmask.txt 5.1.2.
PAGE 58
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.1.3.1. Write WiFi MAC address to driver fake map EFuse offset address : WiFi MAC address 0x120 ~ 0x125 Table 13: RTL8822CE WiFi MAC address offset in eFuse WiFi MAC address 0x157 ~ 0x15c Table 14: RTL8822CU WiFi MAC address offset in eFuse WiFi MAC address 0x16a ~ 0x16f Table 15: RTL8822CS WiFi MAC address offset in eFuse Example : To write RTL8822CE MAC address to driver fake map.
PAGE 59
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.1.3.3. Write calibrated crystal value to driver fake map EFuse offset address : Refer to section 3.1.4. : Crystal calibration. RTL8822C crystal calibration value should be filled in 0xB9, 0x110, 0x111. rtwpriv wlan0 efuse_set wlwfake,Addr,Crystal_value(Hex) Example : If the calibrated crystal value = 0x40. rtwpriv wlan0 efuse_set wlwfake,B9,40 rtwpriv wlan0 efuse_set wlwfake,110,40 rtwpriv wlan0 efuse_set wlwfake,111,40 5.1.3.4.
PAGE 60
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.1.4.
PAGE 61
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.2. Bluetooth MP result eFuse check-in flow 5.2.1. Read Default E-fuse-File to Driver-Fake-Area Load external eFuse map file to driver fake map : rtwpriv wlan0 bt_efuse_file /../../bt_efuse.map Load external mask map file to driver fake map : rtwpriv wlan0 efuse_bt_mask /xx/xx/xx_bt_mask.txt 5.2.2.
PAGE 62
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 5.2.3.1. Write BT MAC address to driver fake map: EFuse offset address : BT MAC address 0x30 Table 16: Bluetooth MAC address offset in eFuse Example : To write RTL8822CE BT MAC address to driver fake map. (Ex : MAC Addr. = 00E04CAABBCC) rtwpriv wlan0 efuse_set btwfake, 30,CCBBAA4CE000 5.2.3.2. Write thermal value to driver fake map EFuse offset address : Refer to 7.2. : Bluetooth eFuse definition about calibrates of Tx power.
PAGE 63
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Example : If both of Tx gain K result = 0, Tx flatness K result = 0, and no LBT. rtwpriv wlan0 efuse_set btwfake,278,6 rtwpriv wlan0 efuse_set btwfake,279,0 rtwpriv wlan0 efuse_set btwfake,27a,0 rtwpriv wlan0 efuse_set btwfake,27b,0 5.2.4.
PAGE 64
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 6. WiFi MP flow appendix 6.1.
PAGE 65
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW VHT2MCS7 VHT2MCS8 VHT2MCS9 After measuring, use the below command to stop Tx. rtwpriv wlan0 stop //stop HW Tx 64 ©2019 Realtek Semiconductor Corp.
PAGE 66
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 6.2. Software Rx parameters rtwpriv wlan0 mp_start //Start MP mode rtwpriv wlan0 mp_channel [Channel] //Set Rx channel rtwpriv wlan0 mp_ant_rx [ANT_Path] //Set path rtwpriv wlan0 mp_bandwidth 40M=[Bandwidth], shortGI=[GI] //Set bandwidth rtwpriv wlan0 mp_arx start //Start SW Rx rtwpriv wlan0 mp_reset_stats //Reset the Rx report rtwpriv wlan0 mp_arx phy //Get Rx phy packet count. rtwpriv wlan0 mp_query //Get Tx/Rx packet counter.
PAGE 67
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7. Bluetooth MP flow appendix    Contains the following Tx gain K mapping table Tx flatness K mapping table Bluetooth Tx power table 66 ©2019 Realtek Semiconductor Corp.
PAGE 68
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1. Bluetooth MP tool command usage     Bluetooth start , exit and help command Bluetooth MP initialize commands at Linux/Android platform Bluetooth control parameters commands Bluetooth execute commands  Bluetooth report commands 67 ©2019 Realtek Semiconductor Corp.
PAGE 69
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1.1. Bluetooth start , exit and help command Bluetooth start MP CMD tool example chmod 755 /system/bin/rtlbtmp rtlbtmp Enable MP stack Check Bluetooth stack HCI interface first, then run the enable MP stack CMD. enable usb:/dev/rtk_btusb // USB I/F enable uart:/dev/ttyS0 // UART I/F, device node specified by vendor (platform) Disable MP Stack disable 68 ©2019 Realtek Semiconductor Corp.
PAGE 70
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Exit MP Tool quit Lookup MP CMDs help 69 ©2019 Realtek Semiconductor Corp.
PAGE 71
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1.2. Bluetooth MP initialize commands at Linux/Android platform These commands used to initialize Bluetooth DUT in MP mode are listed as below: MP Command Parameters Return rtlbtmp None [success] Description Start the MP CMD tool. Enable USB I/F Bluetooth MP stack USB: [success] enable usb:/dev/rtk_btusb and download FW code. Device node is fixed as /dev/rtk_btusb. Enable Uart I/F Bluetooth MP stack enable UART5: and download FW code.
PAGE 72
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1.3. Bluetooth MP mode control parameters commands These commands used to set/get Bluetooth DUT parameters. MP Command Parameters Return bt_mp_SetParam Index0,value0;Index1,value1;...
PAGE 73
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Default tx gain 9 PacketHeader 4 0x0~0x3FFFF Refer to PACKET_HEADER 0 : Disable 10 HoppingFixChannel 1 1 : Enable fix None (for Hopping mode) Channel 11 HitTarget 6 6 bytes 14 Xtal 4 0~0x7F None Depend on chip serials. (Not support Combo Chip WIFI+BT series ) BT4.0 : 15 0x00~0x25 LEDataLen 1 BLE TX Data Length BT5.0 : 0x00~0xFF 16 PHY 1 1~4 17 ModulationIndex 1 0,1 Refer to BLE5.0_TX_PKT_TYPE and BLE5.0_RX_PKT_TYPE Refer to BLE5.
PAGE 74
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW BT PKT_TYPE NAME INDEX Payload Length in bits BT_PKT_DH1 0 0~27*8 BT_PKT_DH3 1 0~183*8 BT_PKT_DH5 2 0~339*8 BT_PKT_2DH1 3 0~54*8 BT_PKT_2DH3 4 0~367*8 BT_PKT_2DH5 5 0~679*8 BT_PKT_3DH1 6 0~83*8 BT_PKT_3DH3 7 0~552*8 BT_PKT_3DH5 8 0~1021*8 BT_PKT_LE 9 0~39*8 Table 20: BT PKT_TYPE BLE5.0_Tx_PKT_TYPE NAME INDEX BLE5_TX_1M_PHY 1 BLE5_TX_2M_PHY 2 LE5_TX_CODED_PHY_S8 3 LE5_TX_CODED_PHY_S2 4 Table 21: BT BLE5.
PAGE 75
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW The payload types are defined in Table PAYLOAD_TYPE.
PAGE 76
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Bluetooth TxPacketCount parameter TxPacketCount is used to set how many Tx packets will be transmitted. The range of TxPacketCount is from 0 to 0xFFF. If TxPacketCount value set to “0”, it means to send Tx packet counts continuously. Bluetooth WhiteningCoeffValue parameter The range of WhiteningCoeffValue is from 0 to 0x7F. it means to disable whitening.
PAGE 77
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1.4. Bluetooth MP mode execute commands Using this command to control bt mp action, and get current report. MP Command bt_mp_Exec Parameters Return Action Return Action Return Status You can use bt_mp_Exec ACTION_INDEX The definition of ACTION_INDEX can refer to “BT_ACTIONCONTROL_TAG” Table.
PAGE 78
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Command /define Index Support Chip RTL8761B HCI_RESET 0 ▓ TEST_MODE_ENABLE 1 ▓ WRITE_EFUSE_DATA 2 ▓ SET_TX_GAIN_TABLE 3 ▓ SET_TX_DAC_TABLE 4 ▓ SET_DEFAULT_TX_GAIN_TABLE 5 ▓ SET_DEFAULT_TX_DAC_TABLE 6 ▓ SET_POWER_GAIN_INDEX 7 ▓ SET_POWER_GAIN 8 ▓ SET_POWER_DAC 9 ▓ SET_XTAL 10 ▓ REPORT_CLEAR 11 ▓ PACKET_TX_START 12 PACKET_TX_UPDATE 13 PACKET_TX_STOP 14 CONTINUE_TX_START 15 CONTINUE_TX_UPDATE 16 CONTINUE_TX_STOP 1
PAGE 79
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW FW_LE_CONTINUE_TX_STOP 37 ▓ FW_READ_TX_POWER_INFO 38 ▓ SET_GPIO3_0 39 SET_ANT_INFO 40 SET_ANT_DIFF_S0S1 41 TX_POWER_TRACKING 42 ▓ SET_K_TX_CH_PWR 43 ▓ WRITE_FLASH_CONFIG 44 ▓ TX_POWER_GAIN_K 45 ▓ TX_POWER_FLATNESS 46 ▓ TX_PATH_LOSS_MODULE 47 ▓ CONFIG_EXTEND 48 READ_FLASH_CONFIG 49 UNLOCK_8822C 50 SetTxPower_8822C_8761B 51 ▓ Table 27: BT_ACTIONCONTROL_TAG 78 ©2019 Realtek Semiconductor Corp.
PAGE 80
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.1.5.
PAGE 81
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW REPORT_MP_TXCAL_IN FO REPORT_FLASH_CONFI G REPORT_XTALBOUNDA RY REPORT_XTALNORMA L 7.2. TxGainK Flatness(LSB) 24 DIV_int DIV_frac(LSB) 25 NewXtalIndex 22 Flatness TXPathLos (MSB) s 23 DIV_frac (MSB) Bluetooth eFuse definition about calibrates of Tx power First, view the eFuse (config file) content about setting of power index and channel adjust value. Normal driver will load this value in initial step.
PAGE 82
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Efuse notification: Default Tx setting of efuse map release by RTK is set to 5 dBm which the setting is shown below as Fig A. If customer need to adopt other Tx target power for their own product please following the power table listed in “7.4.Bluetooth Tx power table” and revise the efuse map by themselves. For example 4 dBm setting is shown in Fig B. This efuse map file need to burn in DUT after passing through Tx calibration flow.
PAGE 83
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.3.
PAGE 84
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.4. Bluetooth Tx power table For S1 GFSK/BLE EDR config GFSK/BLE EDR config power (dBm) power (dBm) power (dBm) power (dBm) 0x20 -7 -10.5 0x3C 7 3.5 0x21 -6.5 -10 0x3D 7.5 4 0x22 -6 -9.5 0x3E 8 4.5 0x23 -5.5 -9 0x3F 8.5 5 0x24 -5 -8.5 0x40 9 5.5 0x25 -4.5 -8 0x41 9.5 6 0x26 -4 -7.5 0x42 10 6.5 0x27 -3.5 -7 0x43 10.5 7 0x28 -3 -6.5 0x44 11 7.5 0x29 -2.5 -6 0x45 11.
PAGE 85
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW For S0 GFSK/BLE EDR config GFSK/BLE EDR config power (dBm) power (dBm) power (dBm) power (dBm) 0x18 -7.5 -11 0x3A 9.5 6 0x19 -7 -10.5 0x3B 10 6.5 0x1A -6.5 -10 0x3C 10.5 7 0x1B -6 -9.5 0x3D 11 7.5 0x1C -5.5 -9 0x3E 11.5 8 0x1D -5 -8.5 0x3F 12 8.5 0x1E -4.5 -8 0x40 12.5 9 0x1F -4 -7.5 0x41 13 9.5 0x20 -3.5 -7 0x42 13.5 10 0x21 -3 -6.5 0x22 -2.5 -6 0x23 -2 -5.5 0x24 -1.
PAGE 86
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.5. Verify Bluetooth BDR/EDR Tx SPEC To measure the DUT Bluetooth legacy Tx power/initial Carrier offset/modulation characteristics to check whether Tx performance is fine or not. Bluetooth legacy Tx criterion is shown as below. Below SPEC is defined by using 5 dBm as target power at normal temperature 25 degree C. For vender’s Tx verification, please adapt target power value as your own SPEC.
PAGE 87
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Verify Bluetooth Tx EDR 2M Test Item Sub Test item Channel Packet Type Payload Type SPEC < 9 dBm Peak Power NOTE: Max variation = target power value +/- 4dB* Output Power 3 dBm ~ 7 dBm Average Power NOTE: Max variation = target power value +/- 2 dB* 0 Relative Transmit Power -4 ~ 1 6 (PGFSK - PDPSK) 2DH1 39 Omega I 2DH3 abs. < 20KHz PRBS9 42 Omega 0 2DH5 abs. < 10KHz 70 Omega I + abs. < 20KHz 78 RMS < 0.
PAGE 88
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW Verify Bluetooth Tx EDR 3M Test Item Sub Test item Channel Packet Payload Type Type SPEC < 9 dBm Peak Power NOTE: Max variation = target power value + / - 4dB* Output Power 3 dBm ~ 7 dBm Average Power NOTE: Max variation = target power value +/- 2 dB* Relative Transmit Power (PGFSK - PDPSK) 0 -4.00dB - 1.00dB 6 3DH1 39 Omega I 3DH3 PRBS9 abs. < 20KHz 42 Omega 0 Omega I + 3DH5 abs. < 10KHz 70 abs.
PAGE 89
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.6. Verify Bluetooth BDR/EDR Rx SPEC To Measure the DUT Rx sensitivity to check whether Rx performance is fine or not. The Rx performance test can be measured in signaling mode (ex: Anritsu 8852B, Agilent N4010A) or non-signaling mode (ex: LitePoint IQNxN). Bluetooth Rx criterion is shown as below : Criterion Channel Payload Type Legacy sensitivity limit 0/6/39/42/70/78 PRBS9 EDR1M_BER < 0.01% < -85 dBm 0/6/39/42/70/78 PRBS9 EDR2M/3M_BER < 0.
PAGE 90
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.7. Verify Bluetooth BLE Tx Performance (BLE 1M) To measure the DUT BLE Tx power and modulation index to check whether BLE Tx performance is fine or not. Bluetooth BLE Tx criterion is shown as below. Below Spec is defined by using 5 dBm as target power at normal temperature 25 degree C. For vender’s Tx verification, please adapt target power value as your own SPEC.
PAGE 91
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.8. Verify Bluetooth BLE 5.0 Tx Performance To measure the DUT BLE 5.0 Tx power and modulation index to check whether BLE Tx performance fine or not. Bluetooth BLE 5.0 Tx criterion is shown as below. Below SPEC is defined by using 5 dBm as target power at normal temperature 25 degree C. For vender’s Tx verification, please adapt target power value as your own spec.
PAGE 92
RTL8822CE RTL8822CU RTL8822CS COB TSSI MP FLOW 7.9. Verify Bluetooth BLE Rx Performance To calculate the Packet Error Rate (PER) PER%= 100*(1-(Packets Received /Packets Send) To measure the DUT BLE Rx sensitivity to check whether Rx performance is fine or not. The Bluetooth Rx criterion is shown as below: Channel SPEC Criterion Payload Type BLE sensitivity limit 1M PRBS9 PER<= 30.800 % < -85 dBm 2M PRBS9 PER<= 30.800 % < -85 dBm LRS2 PRBS9 PER<= 30.800 % < -85 dBm LRS8 PRBS9 PER<= 30.
PAGE 93
Requirement per KDB996369 D03 2.2 List of applicable FCC rules List the FCC rules that are applicable to the modular transmitter. These are the rules that specifically establish the bands of operation, the power, spurious emissions, and operating fundamental frequencies. DO NOT list compliance to unintentional-radiator rules (Part 15 Subpart B) since that is not a condition of a module grant that is extended to a host manufacturer. See also Section 2.
PAGE 94
2.5 Trace antenna designs For a modular transmitter with trace antenna designs, see the guidance in Question 11 of KDB Publication 996369 D02 FAQ – Modules for Micro-Strip Antennas and traces. The integration information shall include for the TCB review the integration instructions for the following aspects: layout of trace design, parts list (BOM), antenna, connectors, and isolation requirements. a) Information that includes permitted variances (e.g.
PAGE 95
2.7 Antennas A list of antennas included in the application for certification must be provided in the instructions. For modular transmitters approved as limited modules, all applicable professional installer instructions must be included as part of the information to the host product manufacturer. The antenna list shall also identify the antenna types (monopole, PIFA, dipole, etc. (note that for example an “omni-directional antenna” is not considered to be a specific “antenna type”)).
PAGE 96
2.10 Additional testing, Part 15 Subpart B disclaimer The grantee should include a statement that the modular transmitter is only FCC authorized for the specific rule parts (i.e., FCC transmitter rules) listed on the grant, and that the host product manufacturer is responsible for compliance to any other FCC rules that apply to the host not covered by the modular transmitter grant of certification.