Confidential – Qualcomm Technologies, Inc. and/or its affiliated companies – May Contain Trade Secrets
NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to:
DocCtrlAgent@qualcomm.com.
Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm Technologies, Inc. or its
affiliated companies without the express approval of Qualcomm Configuration Management. Distribution to anyone who is not an
employee of either Qualcomm Incorporated or its affiliated companies is subject to applicable confidentiality agreements.
Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the
express written permission of Qualcomm Technologies, Inc.
All Qualcomm products mentioned herein are products of Qualcomm Technologies, Inc. and/or its subsidiaries.
Qualcomm is a trademark of Qualcomm Incorporated, registered in the United States and other countries. Other product and brand
names may be trademarks or registered trademarks of their respective owners.
This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S.
and international law is strictly prohibited.
Qualcomm Technologies, Inc.
5775 Morehouse Drive
San Diego, CA 92121
U.S.A.
© 2019-2022 Qualcomm Technologies, Inc. and/or its subsidiaries. All rights reserved.
Qualcomm® Product Configuration
Assistant Tool (PCAT)
User Guide
80-PR518-1 Rev.G
November 23, 2022
s
80-PR518-1 Rev.G Confidential – Qualcomm Technologies, Inc. and/or its affiliated companies – May Contain Trade Secrets 2
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Revision history
Revision
Date
Description
A
September 2019
Initial release
B
July 2020
Numerous changes were made to this document; it should be read in its
entirety
C
November 2020
◼ Added section 2.2 with Windows pre-requisites
◼ Added section 2.3 with Linux pre-requisites
◼ Added section 2.6 with install PCAT using Linux
◼ Updated section 2.1 with general pre-requisites
◼ Updated section 2.4 with hardware and software requirements
D
December 2020
◼ Added section 9.15 with meta build download using partition json
◼ Added section 9.16 with meta build download using Fastboot
◼ Added section 10.5 with Miscellaneous
E
July 2021
◼ Updated section 2.5 with PCAT Setup
◼ Added section 4.2, Download individual memory regions.
◼ Added section 4.3, Detect Subsystem restart
◼ Added section 9.17, Override subsystem image
◼ Added section 9.18, Download meta or flat build on secondary
memory slot
◼ Added section 4.3, Detect Subsystem restart
◼ Updated section 11.6 with PCAT CLI Software download
F
February 2022
◼ Updated section 9.8 with image validation download
◼ Updated section 11.1 with build digest generation
◼ Updated section 11.6 with image validation download
G
November 2022
◼ Updated section 11.6 with standalone erase support in CLI
80-PR518-1 Rev.G Confidential – Qualcomm Technologies, Inc. and/or its affiliated companies – May Contain Trade Secrets 3
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Contents
1 Introduction .................................................................................................... 10
1.1 Purpose .......................................................................................................10
1.2 Conventions .................................................................................................10
1.3 Technical assistance ....................................................................................11
2 Installation ...................................................................................................... 12
2.1 General pre-requistes ..................................................................................12
2.2 Windows pre-requisites ................................................................................12
2.3 Linux pre-requisites ......................................................................................12
2.4 Hardware and software requirements ..........................................................13
2.5 Setup PCAT .................................................................................................13
2.5.1 Windows ............................................................................................13
2.5.2 Linux ..................................................................................................15
3 Getting started ............................................................................................... 18
3.1 Connect device ............................................................................................19
3.2 Disconnect device ........................................................................................20
3.3 Reboot device ..............................................................................................21
3.4 Crash device ................................................................................................21
3.5 Collect functional logs ..................................................................................22
4 Crash collection ............................................................................................. 23
4.1 Download memory dumps............................................................................24
4.2 Download individual memory region .............................................................25
4.3 Detect Subsystem restart(SSR) ...................................................................25
5 xQCN Operations ........................................................................................... 27
5.1 Download [Backup] NV memory file .............................................................28
5.2 Upload [Restore] NV memory file .................................................................28
5.3 Create EFS golden copy ..............................................................................29
5.4 Upload multiple NV memory files .................................................................29
6 EFS explorer .................................................................................................. 32
6.1 Create EFS directory ....................................................................................32
6.2 Create file on phone .....................................................................................33
6.3 Copy file to phone ........................................................................................35
6.4 Delete file or directory ..................................................................................36
6.5 Copy file from phone ....................................................................................36
Qualcomm® Product Configuration Assistant Tool (PCAT) User Guide Contents
80-PR518-1 Rev.G Confidential – Qualcomm Technologies, Inc. and/or its affiliated companies – May Contain Trade Secrets 4
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
7 MBN download ............................................................................................... 38
7.1 Load carrier configuration ............................................................................39
7.2 Select carrier configuration ...........................................................................40
7.3 Activate carrier configuration ........................................................................41
7.4 Deactivate carrier configuration ....................................................................41
7.5 MBN storage information .............................................................................42
8 NV browser ..................................................................................................... 43
8.1 Search NV item ............................................................................................44
8.2 Display NV item list ......................................................................................44
8.3 Read NV item...............................................................................................45
8.4 Write NV item ...............................................................................................45
9 Software download ........................................................................................ 47
9.1 Configuration................................................................................................48
9.2 Download meta build ....................................................................................49
9.3 Flatten meta build ........................................................................................52
9.4 Download flat build .......................................................................................53
9.5 Download flashless (Sahara) build ...............................................................55
9.6 Validated image programming (VIP) Download ............................................57
9.6.1 Create digest table for VIP download .................................................58
9.7 Read software images from device ..............................................................59
9.8 Image validation during download ................................................................60
9.9 Backup and restore xQCN during download ................................................61
9.10 PCle Download ..........................................................................................63
9.11 Partition manager .......................................................................................65
9.11.1 Read partition data ...........................................................................66
9.11.2 Load partition data ...........................................................................67
9.11.3 Erase partition data ..........................................................................68
9.11.4 Erase entire partition data ................................................................69
9.12 Retrieve device flash information ...............................................................69
9.13 Force device to EDL state ..........................................................................70
9.14 UFS provisioning ........................................................................................71
9.15 Meta build download using partition json ....................................................72
9.16 Meta build download using Fastboot ..........................................................73
9.17 Override subsystem image .........................................................................74
9.18 Download meta or flat build on secondary memory slot .............................75
10 Service programming .................................................................................. 76
10.1 Device identifiers ........................................................................................77
10.1.1 Read IMEI ........................................................................................77
10.1.2 Write IMEI ........................................................................................78
10.1.3 Read MEID ......................................................................................78
10.1.4 Write MEID ......................................................................................79
10.1.5 Read ESN ........................................................................................79
10.1.6 Get Operating Mode ........................................................................80
10.1.7 Set Operating Mode .........................................................................80
Qualcomm® Product Configuration Assistant Tool (PCAT) User Guide Contents
80-PR518-1 Rev.G Confidential – Qualcomm Technologies, Inc. and/or its affiliated companies – May Contain Trade Secrets 5
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
10.1.8 Validate SPC ...................................................................................81
10.1.9 Provision SPC ..................................................................................81
10.2 WCNSS .....................................................................................................82
10.2.1 Read MAC address ..........................................................................82
10.2.2 Write MAC address ..........................................................................82
10.2.3 Backup BT/WLAN bin file .................................................................83
10.2.4 Restore BT/WLAN bin file ................................................................83
10.3 SIMLOCK ...................................................................................................84
10.3.1 CK lock process ...............................................................................85
10.3.2 HCK lock process ............................................................................86
10.4 Miscellaneous ............................................................................................87
10.4.1 Overview ..........................................................................................87
10.4.2 CDMA ..............................................................................................88
10.4.3 UMTS System ..................................................................................90
10.4.4 1x/HDR Security ..............................................................................91
10.4.5 NAS .................................................................................................92
10.4.6 SMS-CB ...........................................................................................93
10.4.7 Security ............................................................................................94
11 PCAT command line interface .................................................................... 95
11.1 Help ...........................................................................................................95
11.2 Crash Collection .........................................................................................98
11.3 xQCN Operations .......................................................................................99
11.4 EFS Explorer ............................................................................................ 101
11.5 MBN Download ........................................................................................ 103
11.6 Software download................................................................................... 106
11.7 NV browser .............................................................................................. 110
12 PCAT factory service ................................................................................ 112
12.1 Factory service types ............................................................................... 112
12.1.1 Subscription type ........................................................................... 112
12.1.2 WcnssMacLocation ........................................................................ 112
12.1.3 WcnssTechnology .......................................................................... 112
12.1.4 WcnssChipType ............................................................................. 113
12.1.5 WcnssOptions ................................................................................ 113
12.1.6 ImeiResponse ................................................................................ 113
12.1.7 MeidResponse ............................................................................... 114
12.1.8 ValidationMode .............................................................................. 114
12.1.9 ProductFlavor ................................................................................ 114
12.1.10 DownloadBuildOptions ................................................................. 114
12.1.11 FlattenResponse .......................................................................... 115
12.1.12 SimlockSlotPolicy ......................................................................... 115
12.1.13 SimlockSubscriptionPolicy ........................................................... 116
12.1.14 SimlockSlot .................................................................................. 117
12.1.15 SimlockStatus .............................................................................. 117
12.1.16 SimlockCategory .......................................................................... 117
12.1.17 SimlockType ................................................................................ 118
12.1.18 SimlockBlackList .......................................................................... 118
12.1.19 SimlockAutoLock ......................................................................... 119