ams-OSRAM Manufacturer Skill

Manufacturer Overview

ams-OSRAM (formerly Austria Microsystems, merged with OSRAM Opto Semiconductors) is a global leader in optical solutions, including:

Spectral Sensors - Multi-channel spectral sensing (AS72xx, AS73xx, AS6xxx)
Light Sensors - Ambient light and light-to-digital sensors (TSL2xxx)
Proximity Sensors - Proximity and gesture detection (TMD2xxx, APDS-9xxx)
Color Sensors - RGB and XYZ color sensing (TCS3xxx)
Position Sensors - Magnetic rotary encoders (AS5xxx)
Environmental Sensors - Air quality, humidity, temperature (ENSxxx)
LED Drivers - Constant current LED drivers (AS3xxx)

Note: OSRAM LEDs are handled by the separate OSRAMHandler. This handler covers ams sensor products and ICs.

MPN Structure

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)

| Part | Description | Channels | Wavelengths | |------|-------------|----------|-------------| | AS7261 | Spectral ID sensor | 6 | XYZ + NIR | | AS7262 | 6-channel visible | 6 | 450-650nm | | AS7263 | 6-channel NIR | 6 | 610-860nm | | AS7265x | 18-channel combo | 18 | 410-940nm (3 chips) |

AS73xx - Spectral Sensors (Advanced)

| Part | Description | Channels | |------|-------------|----------| | AS7341 | 11-channel spectral | 11 | | AS7343 | 14-channel spectral | 14 |

TSL2xxx - Light-to-Digital Sensors

| Part | Description | Dynamic Range | |------|-------------|---------------| | TSL2561 | Light sensor | 1:1,000,000 | | TSL2591 | High-DR light sensor | 1:600,000,000 |

TMD2xxx - Proximity/ALS Sensors

| Part | Description | Features | |------|-------------|----------| | TMD2671 | Proximity sensor | IR LED driver | | TMD2772 | Prox + ALS combo | IR proximity | | TMD26721 | Enhanced proximity | Improved sensitivity |

TCS3xxx - Color Sensors

| Part | Description | Features | |------|-------------|----------| | TCS3400 | Color sensor | IR blocking filter | | TCS3472 | RGB color light | Clear channel | | TCS34725 | Color sensor | Enhanced IR block |

APDS-9xxx - Proximity/Gesture Sensors

| Part | Description | Features | |------|-------------|----------| | APDS-9930 | Prox + ALS | Digital ambient light | | APDS-9960 | Gesture + Prox + RGB | 4-way gesture detection |

AS3xxx - LED Drivers

| Part | Description | Channels | |------|-------------|----------| | AS3935 | Lightning sensor IC | - | | AS3933 | LF wake-up receiver | 3 |

AS5xxx - Position Sensors (Magnetic Encoders)

| Part | Description | Resolution | |------|-------------|------------| | AS5047 | Rotary encoder | 14-bit | | AS5048 | Rotary encoder | 14-bit | | AS5600 | Rotary encoder | 12-bit |

ENSxxx - Environmental Sensors

| Part | Description | Measurements | |------|-------------|--------------| | ENS160 | Air quality sensor | VOC, CO2 equivalent | | ENS210 | Humidity/temp sensor | RH + temperature | | ENS220 | Barometric pressure | Pressure + temp |

Package Codes

Suffix Patterns (After Hyphen)

| Suffix | Package | Description | |--------|---------|-------------| | BLGT | BGA | BGA Lead-free Green/Tape | | BGA | BGA | Ball Grid Array | | FN | QFN | Quad Flat No-leads | | QFN | QFN | Quad Flat No-leads | | LGA | LGA | Land Grid Array | | TSL | DFN | Special TSL suffix (typically DFN) | | ASIL | (varies) | Automotive Safety Integrity Level variant | | ASOM | MODULE | Module variant | | TR | TAPE_REEL | Tape and Reel packaging |

Direct Suffixes (No Hyphen)

| Suffix | Package | Example | |--------|---------|---------| | FN | QFN | TMD26721FN, TCS34725FN | | LGA | LGA | AS7262LGA |

Supported Component Types

The AMSHandler supports these ComponentType values:

| ComponentType | Product Families | |---------------|------------------| | SENSOR | All sensor families (AS72xx, AS73xx, TSL2xxx, TMD2xxx, TCS3xxx, APDS-9xxx, AS5xxx, AS6xxx, ENSxxx) | | SENSOR_PROXIMITY | TMD2xxx, APDS-9xxx | | HUMIDITY_SENSOR | ENSxxx | | LED_DRIVER | AS3xxx | | IC | All families (base type) |

Series Extraction Rules

The handler extracts series using these rules:

| Pattern | Extracted Series | Example | |---------|------------------|---------| | APDS-?9xxx | APDS | APDS-9960 -> APDS | | TSLxxxx | TSL | TSL2591 -> TSL | | TMDxxxx | TMD | TMD2772 -> TMD | | TCSxxxx | TCS | TCS34725 -> TCS | | ENSxxx | ENS | ENS160 -> ENS | | ASnnxx | ASnn (4 chars) | AS7262 -> AS72, AS5600 -> AS56 |

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:

| Suffix | Interface | |--------|-----------| | -I2C or I | I2C | | -SPI or S | SPI | | -ANA or A | Analog |

Example MPNs with Full Decoding

| MPN | Family | Type | Package | Notes | |-----|--------|------|---------|-------| | AS7262-BLGT | AS72xx | Spectral Sensor | BGA | 6-ch visible, lead-free tape | | AS7341 | AS73xx | Spectral Sensor | (default) | 11-channel spectral | | TSL2591FN | TSL2xxx | Light Sensor | QFN | High dynamic range | | TMD26721FN | TMD2xxx | Proximity Sensor | QFN | Enhanced proximity | | TCS34725FN | TCS3xxx | Color Sensor | QFN | RGB with IR block | | APDS-9960 | APDS-9xxx | Gesture Sensor | (default) | 4-way gesture | | APDS-9960-ASIL | APDS-9xxx | Gesture Sensor | QFN | Automotive variant | | AS5600-ASOM | AS5xxx | Position Sensor | MODULE | 12-bit magnetic encoder | | ENS160-BLGT | ENSxxx | Air Quality | BGA | VOC/CO2 sensor | | ENS210-LQFN | ENSxxx | Humidity Sensor | QFN | Humidity + temp |

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.