Qualcomm

Example Decoding

SM8550-AB
│  │   │
│  │   └── AB = Package/variant designation
│  └── 8550 = Snapdragon 8 Gen 2 series
└── SM = Snapdragon Mobile platform

QCA6390-FCBGA
│   │    │
│   │    └── FCBGA = Flip-Chip BGA package
│   └── 6390 = Wi-Fi 6E / Bluetooth 5.2 combo chip
└── QCA = Qualcomm Connectivity/Atheros (Wi-Fi/BT)

PM8550
│  │
│  └── 8550 = Power management IC for SM8550 platform
└── PM = Power Management IC

Product Family Prefixes

Mobile Platforms (Snapdragon)

IoT/Embedded Platforms

RF Front-End

Wireless Connectivity

Power Management

Audio

Package Codes

Package codes appear after a hyphen in the MPN.

Package Extraction Logic

The handler extracts package codes from the suffix after the last hyphen:

// Direct match
"BGA" -> "BGA"
"CSP" -> "CSP"
"POP" or "PoP" -> "Package-on-Package"
"QFN" -> "QFN"
"PQFN" -> "Power QFN"
"LFCSP" -> "Lead Frame CSP"
"WLCSP" -> "Wafer Level CSP"
"FCBGA" -> "Flip-Chip BGA"

// Contains check (fallback)
Contains "BGA" -> "BGA"
Contains "CSP" -> "CSP"
Contains "QFN" -> "QFN"

Series Extraction Logic

The handler extracts series by collecting letters and digits before any hyphen:

// Algorithm: collect alphanumerics until hyphen or end of letter+digit pattern
SM8550-AB → SM8550
QCA6390 → QCA6390
PM8550 → PM8550
MDM9650 → MDM9650

The extraction stops when:

1. A hyphen is encountered
2. Letters and digits have both been found, and a non-alphanumeric appears

Snapdragon Naming Evolution

Modern Naming (2021+)

Legacy Naming

Performance Tiers (Suffix Keywords)

Generation (Suffix Keywords)

Supported ComponentTypes

The handler registers all patterns under ComponentType.IC and declares:

getSupportedTypes() → { WIFI_IC_QUALCOMM }

Known Issue: The handler registers patterns for many IC categories (SoCs, modems, PMICs, etc.) but only declares WIFI_IC_QUALCOMM in getSupportedTypes(). Consider adding IC to getSupportedTypes() for completeness.

Replacement Compatibility Logic

The handler implements sophisticated replacement checking via isOfficialReplacement():

Compatible Series Pairs

Category-Specific Checks

Snapdragon SoCs (SM, SD, QSD, MSM):

• Generation compatibility (higher gen can replace lower)
• Performance tier compatibility (Elite > Plus > Pro > Standard)

Wireless Modules (QCA, WCN, MDM, FSM):

• Wi-Fi version compatibility (WiFi-6 > WiFi-5 > WiFi-4)
• Bluetooth version compatibility (5.2 > 5.1 > 5.0 > 4.2)

Power Management (PM, PMI, SMB):

• Voltage rating compatibility (within 5% tolerance)
• Current rating compatibility (higher can replace lower)

Example MPNs

Mobile SoCs

IoT Platforms

RF Front-End

Wireless Connectivity

Power Management

Audio

Handler Implementation Notes

Pattern Matching

All patterns are registered under ComponentType.IC:

// Mobile Platforms
"^SM[0-9]{3}.*"       // SM8550, SM7450
"^SD[0-9]{3}.*"       // SD888, SD865
"^QSD[0-9]{4}.*"      // QSD8250
"^MSM[0-9]{4}.*"      // MSM8996

// IoT/Embedded
"^QCS[0-9]{3}.*"      // QCS603
"^QCM[0-9]{3}.*"      // QCM2150
"^APQ[0-9]{4}.*"      // APQ8064
"^IPQ[0-9]{4}.*"      // IPQ8074

// RF Front-End
"^QM[0-9]{4}.*"       // QM42195
"^QPM[0-9]{4}.*"      // QPM5677
"^QAT[0-9]{4}.*"      // QAT3555
"^QET[0-9]{4}.*"      // QET6100

// Wireless
"^QCA[0-9]{4}.*"      // QCA6390
"^WCN[0-9]{4}.*"      // WCN6855
"^MDM[0-9]{4}.*"      // MDM9650
"^FSM[0-9]{4}.*"      // FSM9955

// Power Management
"^PM[0-9]{4}.*"       // PM8550
"^PMI[0-9]{4}.*"      // PMI8998
"^SMB[0-9]{3}.*"      // SMB1360

// Audio
"^WCD[0-9]{4}.*"      // WCD9380
"^WSA[0-9]{4}.*"      // WSA8810

Known Issues

1. HashSet in getSupportedTypes(): Uses HashSet instead of Set.of() - should be updated for consistency
2. IC type not in getSupportedTypes(): Handler registers patterns for ComponentType.IC but only declares WIFI_IC_QUALCOMM - may cause matches() to return true but type not in supported set
3. Commented-out code: Line 54 has commented-out WIFI_IC type

Related Files

• Handler: manufacturers/QualcommHandler.java
• Component types: WIFI_IC_QUALCOMM
• Tests: (None currently - handler needs test coverage)

Learnings & Quirks

• PMIC naming convention: PM/PMI part numbers often match the SoC they're designed for (PM8550 pairs with SM8550)
• Atheros heritage: QCA prefix comes from Qualcomm Atheros acquisition (2011) - Wi-Fi/Bluetooth expertise
• Package suffix variability: Many Qualcomm parts are sold without explicit package suffix in MPN
• Generation extraction: The handler extracts generation from 3-digit numeric portions (first digit = generation, second digit = tier)
• Wi-Fi capability keywords: Some MPNs include "ax", "ac", "n" to indicate Wi-Fi version
• BT version in MPN: Bluetooth version may appear as "BT5.2", "BT5.1", etc. in some variants