Ams

ams MPNs follow this general structure:

[PREFIX][SERIES][VARIANT][-][PACKAGE/QUALIFIER]
   |       |       |     |        |
   |       |       |     |        +-- Package code, automotive grade, or tape/reel
   |       |       |     +-- Optional hyphen separator
   |       |       +-- Variant digit (channel count, version)
   |       +-- Series number (2-3 digits)
   +-- Family prefix (AS, TSL, TMD, TCS, APDS, ENS)

Example Decodings

AS7262-BLGT
|  |   |  |
|  |   |  +-- GT = Green/Tape (RoHS)
|  |   +-- BL = BGA Lead-free
|  +-- 62 = 6-channel visible spectral sensor
+-- AS72 = Spectral sensor family

TSL2591FN
|   |   |
|   |   +-- FN = QFN package
|   +-- 591 = High-dynamic-range light sensor
+-- TSL2 = Light-to-digital sensor family

APDS-9960
|    |  |
|    |  +-- 60 = Gesture-enabled variant
|    +-- 99 = Proximity/gesture series
+-- APDS = Advanced Proximity Detection System

TCS34725FN
|   |   |
|   |   +-- FN = QFN package
|   +-- 725 = Color sensor with IR blocking filter
+-- TCS3 = Color sensor family

ENS160-BLGT
|   |  |
|   |  +-- BLGT = BGA Lead-free Green/Tape
|   +-- 160 = Metal oxide gas sensor (VOC/CO2)
+-- ENS = Environmental sensor family

Product Families

AS72xx - Spectral Sensors (Visible)

AS73xx - Spectral Sensors (Advanced)

TSL2xxx - Light-to-Digital Sensors

TMD2xxx - Proximity/ALS Sensors

TCS3xxx - Color Sensors

APDS-9xxx - Proximity/Gesture Sensors

AS3xxx - LED Drivers

AS5xxx - Position Sensors (Magnetic Encoders)

ENSxxx - Environmental Sensors

Package Codes

Suffix Patterns (After Hyphen)

Direct Suffixes (No Hyphen)

Supported Component Types

The AMSHandler supports these ComponentType values:

Series Extraction Rules

The handler extracts series using these rules:

Package Code Extraction Rules

// 1. Check for hyphenated suffix
int lastHyphen = mpn.lastIndexOf('-');
if (lastHyphen >= 0) {
    String suffix = mpn.substring(lastHyphen + 1);
    // Skip numeric-only suffixes (model numbers like APDS-9960)
    if (!suffix.matches("^[0-9]+$")) {
        // Map known package codes
        switch (suffix) {
            case "BLGT": return "BGA";
            case "FN", "QFN": return "QFN";
            case "LGA": return "LGA";
            case "ASOM": return "MODULE";
            // Check for embedded indicators
            if (suffix.endsWith("FN")) return "QFN";
        }
    }
}

// 2. Check for direct suffix (no hyphen)
if (mpn.endsWith("FN")) return "QFN";
if (mpn.endsWith("LGA")) return "LGA";

Compatible Replacement Rules

The handler defines these compatibility groups:

AS72xx Spectral Sensors

• AS7261, AS7262, AS7263 are compatible (same interface, different wavelengths)
• AS7265x variants are compatible with each other

TSL Light Sensors

• TSL2561 and TSL2591 are compatible (same family, different specs)

TCS Color Sensors

• TCS3472x variants are compatible (TCS3472, TCS34725)

APDS Proximity/Gesture

• APDS-99xx variants are compatible within the series

AS5xxx Position Sensors

• AS50xx variants are compatible (same interface, different resolution)
• AS56xx variants are compatible with each other

ENS Environmental Sensors

• ENS sensors are NOT interchangeable (different measurements)

Interface Extraction

Some ams parts indicate interface type in the MPN:

Example MPNs with Full Decoding

Related Files

• Handler: manufacturers/AMSHandler.java
• Component types: SENSOR, SENSOR_PROXIMITY, HUMIDITY_SENSOR, LED_DRIVER, IC
• Note: No manufacturer-specific ComponentTypes (e.g., SENSOR_AMS) defined

Handler Implementation Notes

Pattern Matching

The handler uses pre-compiled patterns for performance:

private static final Pattern AS72XX_PATTERN = Pattern.compile("^AS72[0-9]{2}.*", Pattern.CASE_INSENSITIVE);
private static final Pattern APDS9XXX_PATTERN = Pattern.compile("^APDS-?9[0-9]{3}.*", Pattern.CASE_INSENSITIVE);

matches() Override

The handler explicitly overrides matches() to avoid cross-handler pattern matching issues:

@Override
public boolean matches(String mpn, ComponentType type, PatternRegistry patterns) {
    // Each family explicitly checked
    if (AS72XX_PATTERN.matcher(upperMpn).matches()) {
        return type == ComponentType.SENSOR || type == ComponentType.IC;
    }
    // ... etc for each family
}

getSupportedTypes() Uses Set.of()

The handler correctly uses immutable Set.of():

@Override
public Set<ComponentType> getSupportedTypes() {
    return Set.of(
        ComponentType.SENSOR,
        ComponentType.SENSOR_PROXIMITY,
        ComponentType.HUMIDITY_SENSOR,
        ComponentType.LED_DRIVER,
        ComponentType.IC
    );
}

Learnings & Quirks

• APDS hyphen handling: The APDS family uses a hyphen in the name (APDS-9960), which complicates package extraction. The handler correctly skips numeric-only suffixes after the hyphen.

• Multiple sensor types: Many ams sensors are registered under both SENSOR (generic) and more specific types like SENSOR_PROXIMITY or HUMIDITY_SENSOR. Always check for the most specific type first.

• No manufacturer-specific ComponentTypes: Unlike TI or ST, ams does not have manufacturer-specific component types (e.g., SENSOR_AMS). All types are generic.

• ENS sensors not interchangeable: Unlike other families where variants are compatible, ENS160 (air quality), ENS210 (humidity), and ENS220 (pressure) measure different things and are NOT replacements for each other.

• AS5xxx resolution differences: Position sensors in the same sub-family (AS50xx, AS56xx) are compatible but have different resolutions (12-bit vs 14-bit). Consider application requirements when substituting.

• OSRAM LED separation: LED products from OSRAM are handled by OSRAMHandler, not AMSHandler. This handler focuses on ams sensor products only.

• BLGT suffix decoding: BLGT = BGA Lead-free Green/Tape - a common packaging designation for RoHS-compliant BGA parts on tape for pick-and-place.