QUECTEL BC20 Module User Guide

June 12, 2024
QUECTEL

GENIE User Guide
BC20 &BC26&BC66 Module Series Version: 1.0
Date: 2022-12-01
Status: Released

BC20 Module

At Quested, our aim is to provide timely and comprehensive services to our customers. If you require any assistance, please contact our headquarters:
Quectel Wireless Solutions Co., Ltd.
Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianjin Road, Mishanga District,
Shanghai 200233, China
Tel: +86 21 5108 6236
Email: info@quectel.com
Or our local offices. For more information, please visit: http://www.quectel.com/support/sales.htm.
For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm.
Or email us at: support@quectel.com.
Legal Notices
We offer information as a service to you. The provided information is based on your requirements and we make every effort to ensure its quality. You agree that you are responsible for using independent analysis and evaluation in designing intended products, and we provide reference designs for illustrative purposes only. Before using any hardware, software or service guided by this document, please read this notice carefully. Even though we employ commercially reasonable efforts to provide the best possible experience, you hereby acknowledge and agree that this document and related services hereunder are provided to you on an “as available” basis. We may revise or restate this document from time to time at our sole discretion without any prior notice to you.

Use and Disclosure Restrictions

License Agreements
Documents and information provided by us shall be kept confidential, unless specific permission is granted. They shall not be accessed or used for any purpose except as expressly provided herein.
Copyright
Our and third-party products hereunder may contain copyrighted material. Such copyrighted material shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior written consent. We and the third party have exclusive rights over copyrighted material. No license shall be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for noncompliance with abovementioned requirements, unauthorized use, or other illegal or  malicious use of the material.
Trademarks
Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel or any third party in advertising, publicity, or other aspects.
Third-Party Rights
This document may refer to hardware, software and/or documentation owned by one or more third parties (“third-party materials”). Use of such third-party materials shall be governed by all restrictions and obligations applicable thereto.
We make no warranty or representation, either express or implied, regarding the third-party materials, including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular purpose, quiet  enjoyment, system integration, information accuracy, and non- infringement of any third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein constitutes a representation or warranty by  us to either develop, enhance, modify, distribute, market, sell, offer for sale, or otherwise maintain production of any our products or any other hardware, software, device, tool, information, or product. We moreover disclaim any and all  warranties arising from the course of dealing or usage of trade.

Privacy Policy
To implement module functionality, certain device data are uploaded to Quester’s or third-party’s servers, including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the relevant laws and regulations,  shall retain, use, disclose or otherwise process relevant data for the purpose of performing the service only or as permitted by applicable laws. Before data interaction with third parties, please be informed of their privacy and data security policy.
Disclaimer
a) We acknowledge no liability for any injury or damage arising from the reliance upon the information.
b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the information contained herein.
c) While we have made every effort to ensure that the functions and features under development are free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless otherwise provided by valid agreement, we make no warranties of any kind, either implied or express, and exclude all liability for any loss or damage suffered in connection with the use of features and functions under development, to the maximum extent permitted  by law, regardless of whether such loss or damage may have been foreseeable.
d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of information, advertising, commercial offers, products, services, and materials on third-party websites and third-party resources.
Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved.

About the Document
Revision History

Version Date Author Description
12/1/2022 Herbert Pan Creation of the document

Foreword

In this document, it illustrates how to capture DEBUG log on BC20/BC26/BC66 Series under LPWA modules. In addition, it can be available to capture DEBUG log of such above modules in a fast and effective way via this document. Finally, it can be implemented on relevant applicable analysis based on certain contents.

1.1. Scope

Tools Manufacturer Revision Applicable Module Type
Genie AT+CGMI/MTK_2625 BC20/BC26/BC66

1.2. Download

GENIE MT2625_nbiot_tools_20220930_exe_V1.2240.5.zip
Note: The tool has a validity period. If it has been expired when deploying, please feel no hesitation to contact with Quectel.
1.3. Device Connection
If the module has been welded or debugged separately, it is recommended to connect to the Genie and capture log as shown below.

Under the circumstance that the TE-B corresponding to MTK module is deployed, please select the second COM port in the “Port” under the drop-list of “Device Manager” , which means the “Silicon Labs Quad CP2108 USB to UART  Bridge: Interface 1” will be used to serve as GKI port. While the third COM port, Silicon Labs Quad CP2108 USB to UART Bridge: Interface 2, will serve as HSL port.

Installation

Being installation-free, the Genie can be used after being unzipped. Run Genie.exe in the directory of MT2625_nbiot_tools_20220211_exe_V1.2207.5\nbiot\tools\core\genie.

Connection

Click the genie icon above to start, the initial display is as shown below; Select “New Config” for related settings.

3.1. UART Connection
The GKI (mandatory one) corresponds to Debug port. While the HSL (optional, untick it if the AUX port is not induced) corresponds to AUX port. In addition, the .defile in the corresponding firmware file is imported into the Database.
As for configuring baud-rate, run the AT command “AT+EPORT=4” to query the supported UART port in current module and configure according to the returned value and corresponding table

If it is needed to modify the baud-rate of DEBUG port, please refer to following AT command and corresponding configuration list.
AT+EPORT=3,2, // To change the baud rate of DEBUG port by the AT command

+EPORT: 0 1 2 3 4 5
UART UART UART UART USB USB
variable 921600 (fixed)

Genie Baud-rate Configuration(AT+EPORT=4)


Baudrate_index| Baud-rate=| 0| 1| 2| 3| 4| 5|
| Baud-rate| 110| 300| 1200| 2400| 4800| 9600|
Baudrate_index| Baud-rate=| 6| 7| 8| 9| 10| 11| 12
| Baud-rate| 19200| 38400| 57600| 115200| 230400| 460800| 921600

3.2. USB Connection
If the USB is used to output Log, please execute AT commands and set as shown below; It is recommended to disable USB output via relevant commands after the log is outputted.
Open USB output
AT+EPORT=1,uls,5
AT+EPORT=1,emmi,4
Close USB output
AT+EPORT=1,uls,2
AT+EPORT=1,emmi,1
After above steps, power on or restart the device to take effect. The ports displayed in device Manager are as follows:

It is available to modify and save configuration parameters via corresponding icon in the toolbar as shown below, or by “New Config” / “Save Config” in the drop-list of “Config”.

Then, click the icon in the toolbar as shown below to start recording log;
Note: After the device is powered on, it is necessary to call POWERKEY to power on the module.

Subsequently, the window will display as follows.

As shown below, the engineering mode in Genie is enabled to facilitate the observation of the signal reference received by the terminal.

As shown below, open genie signaling window via the “RRC Decoder” in the drop- list of “Special”, it is convenient to observe the terminal signaling interaction;

Save Log

4.1. Manual Save
After the log is captured, save the log by “Save As” under the menu of “Log”.

Common Analytical Application

5.1. Import Log
It is available to open log via clicking the saved xxx.glp file or initiating Genie. See next figure for details.

5.2. Hue the Message
By using icons in the toolbar as shown below, different types of Log messages can be hued with various colours, which makes it easier to identify and query.

5.3. Filter Log
Open the Find/Search window shown via icons in the toolbar below, or the “Find” hidden in “Edit”. Please note the case options and search direction;

5.4. Data Analysis
Open following window via “RRC Decoder” in menu of “Special”, the message in NAS/AS layer can be decrypted.

5.5. Export Pcap
Open following window via “RRC Decoder” in menu of “Special”, select “Export” and refer to corresponding option to export Pcap file

Notes

  1. If the issue that debugging or analyzing can be attributed to the event of registration, please run AT command AT+CFUN=0/AT+CFUN=1or reboot module/terminal after connecting to Genie to capture the complete registration network process, which can be applied for the possible cause of the failure to current registration network.

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals