ams

# 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 ```java // 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: ```java 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: ```java @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 }