Agent skill
seoulsemi
Seoul Semiconductor LED MPN encoding patterns, series identification, package extraction, and color decoding. Use when working with Seoul Semi LEDs or SeoulSemiHandler.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/seoulsemi-cantara-lib-electronic-compo
SKILL.md
Seoul 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 | -W0, -W-, WHT |
| CW | Cool White | -CW, CW- |
| WW | Warm White | -WW, WW- |
| NW | Neutral White | -NW, NW- |
| R, RD | Red | -R0, RED |
| G, GR | Green | -G0, GRN |
| B, BL | Blue | -B0, BLU |
| Y, YL | Yellow | -Y0, YEL |
| A, AM | Amber | -A0, AMB |
| UV | Ultraviolet | CUD prefix, UV in MPN |
| IR | Infrared | SFH prefix |
Series Extraction Rules
The handler extracts series based on the product family:
| Pattern | Series Format | Example |
|---|---|---|
| Z-Power | Z5-M0, Z5-M1, Z5 |
Z5-M0-W0-00 -> Z5-M0 |
| Acrich | Acrich (constant) |
SMJHA3V1W1P0S0 -> Acrich |
| SunLike | SunLike (constant) |
SPHWHTL3D50YE3KPH -> SunLike |
| UV LED | CUD6, CUD8, CUD |
CUD6GF1B -> CUD6 |
| IR LED | SFH4, SFH5, SFH |
SFH4550 -> SFH4 |
| WICOP | WICOP (constant) |
W123456 -> WICOP |
| MJT | MJT (constant) |
MJT123 -> MJT |
| STW/STN | Series code | STW9Q14C-W9 -> STW9Q14C |
| N-Series | N + digits |
N20 -> N20 |
| P-Series | P4 or P7 |
P4ABC -> P4 |
| X-Series | X + digits |
X123 -> X123 |
Supported Component Types
The handler supports:
| ComponentType | Description |
|---|---|
LED |
Primary type for all LED products |
IC |
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.LED,ComponentType.IC - Similarity:
/similarity-ledskill for LED comparison logic
Learnings & Edge Cases
- Hyphen variations: Some MPNs have optional hyphens (e.g.,
SMJHA3V1W1P0S0vsSMJHA-3V1W1P0S0). Patterns must handle both. - 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
ComponentType.ICto ensure proper pattern matching in the handler factory.
Didn't find tool you were looking for?