Lib-electronic-components seoulsemi
Seoul Semiconductor LED MPN encoding patterns, series identification, package extraction, and color decoding. Use when working with Seoul Semi LEDs or SeoulSemiHandler.
git clone https://github.com/Cantara/lib-electronic-components
T=$(mktemp -d) && git clone --depth=1 https://github.com/Cantara/lib-electronic-components "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/manufacturers/seoulsemi" ~/.claude/skills/cantara-lib-electronic-components-seoulsemi && rm -rf "$T"
.claude/skills/manufacturers/seoulsemi/SKILL.mdSeoul Semiconductor Manufacturer Skill
Overview
Seoul Semiconductor is a South Korean LED manufacturer producing a wide range of LED products for lighting, automotive, and specialty applications. The company is known for innovative LED technologies including:
- Acrich - AC-driven LED modules (no external driver needed)
- SunLike - Human-centric lighting LEDs with natural spectrum
- Z-Power - High-power LEDs for general illumination
- WICOP - Wafer-Level Integrated Chip on PCB (no wire bonding)
- MJT - Multi-Junction Technology for high-voltage LEDs
- UV/IR LEDs - Specialty LEDs for sterilization, sensing
MPN Structure
Seoul Semiconductor MPNs vary by product family, but follow these general patterns:
Z-Power Series (High-Power LEDs)
Z5-M0-W0-00 │ │ │ │ │ │ │ └── Options/variant │ │ └── W0 = White color code │ └── M0 = Power variant (M0, M1, M2) └── Z5 = Z-Power family, generation 5
Acrich Series (AC-Driven LED Modules)
SMJHA-3V1W1P0S0 │ │ │ │ │ │ │ │ │ │ │ └── Options │ │ │ │ └── P0 = Power factor │ │ │ └── W1 = Wattage │ │ └── V1 = Voltage variant │ └── 3 = Series number └── SMJHA = Acrich module prefix
SunLike Series (Human-Centric LEDs)
SPHWHTL3D50YE3KPH │ │ │ │ │ │ │ │ │ │ │ │ │ └── Options (PH=tape/reel) │ │ │ │ │ └── KP = Package variant │ │ │ │ └── E3 = Efficiency bin │ │ │ └── Y = Color bin │ │ └── 50 = CCT (5000K) │ └── HTL3D = Series variant └── SPH = SunLike prefix
Standard White LEDs (STW/STN Series)
STW9Q14C-W9 │ │ │ │ │ │ │ └── W9 = Color temperature bin │ │ └── C = Variant │ └── 9Q14 = Series identifier └── STW = Standard White prefix (STN = Neutral)
UV LEDs (CUD Series)
CUD6GF1B │ │││ │ │ │││ └── B = Bin/variant │ ││└── 1 = Generation │ │└── F = Package │ └── 6G = Power/wavelength class └── CUD = UV LED prefix
Product Family Prefixes
| Prefix | Product Family | Description |
|---|---|---|
| Z5, Z4 | Z-Power | High-power LEDs for general lighting |
| SMJHA | Acrich | AC-driven LED modules |
| SPH | SunLike | Human-centric spectrum LEDs |
| STW | Standard White | General purpose white LEDs |
| STN | Standard Neutral | Neutral white LEDs |
| CUD | UV LED | Ultraviolet LEDs (UVA, UVB, UVC) |
| SFH | Infrared | IR LEDs and emitters |
| W | WICOP | Wafer-level chip-scale package |
| MJT | MJT | Multi-Junction Technology |
| P4, P7 | P-Series | High-power LEDs |
| X | X-Series | Premium high-power LEDs |
| N | N-Series | Niche/specialty LEDs |
Package Codes
Standard SMD Packages
| Code | Package Size | Description |
|---|---|---|
| 2835 | 2.8 x 3.5mm | Mid-power SMD |
| 3014 | 3.0 x 1.4mm | Compact SMD |
| 3030 | 3.0 x 3.0mm | Mid-power SMD |
| 3528 | 3.5 x 2.8mm | Standard SMD |
| 3535 | 3.5 x 3.5mm | High-power SMD |
| 5050 | 5.0 x 5.0mm | High-power/RGB |
| 5630 | 5.6 x 3.0mm | High-power SMD |
Technology-Specific Packages
| Return Value | Description | Series |
|---|---|---|
| Ceramic | Ceramic substrate high-power | Z5-M0, Z5-M1, Z5-M2 |
| High-Power | Generic high-power package | Z-Power, P4, P7, X-series |
| Module | Complete LED module | Acrich (SMJHA) |
| CSP | Chip Scale Package | WICOP |
| MJT | Multi-Junction Package | MJT series |
| UV | UV LED package | CUD series |
| IR | Infrared LED package | SFH series |
| SMD | Generic surface mount | STW, STN, SunLike |
Color Codes
Color Code Extraction
Seoul Semi uses various conventions for color in MPNs:
| Code | Color | Examples |
|---|---|---|
| W, WH, WHT | White | , , |
| CW | Cool White | , |
| WW | Warm White | , |
| NW | Neutral White | , |
| R, RD | Red | , |
| G, GR | Green | , |
| B, BL | Blue | , |
| Y, YL | Yellow | , |
| A, AM | Amber | , |
| UV | Ultraviolet | prefix, in MPN |
| IR | Infrared | prefix |
Series Extraction Rules
The handler extracts series based on the product family:
| Pattern | Series Format | Example |
|---|---|---|
| Z-Power | , , | -> |
| Acrich | (constant) | -> |
| SunLike | (constant) | -> |
| UV LED | , , | -> |
| IR LED | , , | -> |
| WICOP | (constant) | -> |
| MJT | (constant) | -> |
| STW/STN | Series code | -> |
| N-Series | + digits | -> |
| P-Series | or | -> |
| X-Series | + digits | -> |
Supported Component Types
The handler supports:
| ComponentType | Description |
|---|---|
| Primary type for all LED products |
| Secondary registration for pattern matching |
Note: All patterns are registered under both
LED and IC types to ensure proper pattern matching in the registry.
Handler Implementation Notes
Package Code Extraction Priority
The handler checks patterns in a specific order to avoid false positives:
// 1. Check technology-specific patterns FIRST (before embedded size codes) if (Z_POWER_PATTERN.matches()) return "Ceramic" or "High-Power"; if (ACRICH_PATTERN.matches()) return "Module"; if (WICOP_PATTERN.matches()) return "CSP"; if (MJT_PATTERN.matches()) return "MJT"; if (UV_LED_PATTERN.matches()) return "UV"; if (IR_LED_PATTERN.matches()) return "IR"; if (P_SERIES_PATTERN.matches()) return "High-Power"; if (X_SERIES_PATTERN.matches()) return "High-Power"; // 2. Then check for embedded package sizes in SunLike/STW if (SUNLIKE_PATTERN.matches() || STW_STN_PATTERN.matches()) { // Extract 4-digit size code like "3030", "5050" return PACKAGE_CODES.getOrDefault(size, "SMD"); } // 3. Fallback: check for ANY embedded size code for (sizeCode : ["3030", "3535", "5050", ...]) { if (mpn.contains(sizeCode)) return sizeCode; }
Color Code Extraction Priority
Color extraction checks specific patterns before generic ones:
// 1. UV/IR first (based on prefix) if (mpn.startsWith("CUD") || mpn.contains("UV")) return "UV"; if (mpn.startsWith("SFH") || mpn.contains("IR")) return "IR"; // 2. White variants BEFORE generic white if (contains("-CW") || contains("CW-")) return "CW"; // Cool White if (contains("-WW") || contains("WW-")) return "WW"; // Warm White if (contains("-NW") || contains("NW-")) return "NW"; // Neutral White // 3. Generic white LAST if (contains("-W0") || contains("-W-") || contains("WHT")) return "W";
Replacement Detection
Two MPNs are considered official replacements if:
- Same series
- Same color (or at least one unknown)
- Same package (or at least one unknown)
Example MPN Decoding
Z-Power LED
Z5-M0-W0-00 ├── Series: Z5-M0 ├── Package: Ceramic (Z5-M0 variant) ├── Color: W (White) └── Technology: High-Power LED
Acrich AC Module
SMJHA-3V1W1P0S0 ├── Series: Acrich ├── Package: Module ├── Color: (not specified in MPN) └── Technology: AC-Driven
SunLike LED
SPHWHTL3D50YE3KPH ├── Series: SunLike ├── Package: SMD (default for SunLike) ├── Color: (encoded in spec fields) └── Technology: SunLike (Human-Centric)
Standard White LED
STW9Q14C-W9 ├── Series: STW9Q14C ├── Package: SMD (default) ├── Color: W (White, bin 9) └── Technology: Standard White
UV LED
CUD6GF1B ├── Series: CUD6 ├── Package: UV ├── Color: UV (Ultraviolet) └── Technology: UV LED
Infrared LED
SFH4550 ├── Series: SFH4 ├── Package: IR ├── Color: IR (Infrared) └── Technology: Infrared LED
Related Files
- Handler:
manufacturers/SeoulSemiHandler.java - Component types:
,ComponentType.LEDComponentType.IC - Similarity:
skill for LED comparison logic/similarity-led
Learnings & Edge Cases
- Hyphen variations: Some MPNs have optional hyphens (e.g.,
vsSMJHA3V1W1P0S0
). Patterns must handle both.SMJHA-3V1W1P0S0 - Z-Power variants: Z5-M0, Z5-M1, Z5-M2 are distinct power grades in the same family. M0 is typically lower power.
- SunLike spectrum: SunLike LEDs are designed to match natural sunlight spectrum for human-centric lighting.
- WICOP technology: No wire bonding or phosphor layer on LED chip - leads to smaller form factor and better thermal performance.
- Acrich modules: Self-contained AC LED modules that can run directly from mains voltage without external drivers.
- CUD UV series: Numbers after CUD (6, 8) typically indicate wavelength range (e.g., CUD6 = UVC ~275nm).
- Color code ordering: When extracting colors, check specific variants (CW, WW, NW) before generic white (W) to avoid false matches.
- Package embedded in MPN: SunLike and STW series may have 4-digit package codes embedded (e.g., 3030, 5050). Extract with regex.
- IC registration: Patterns are also registered under
to ensure proper pattern matching in the handler factory.ComponentType.IC