puya

name: puya description: Puya Semiconductor MPN encoding patterns, suffix decoding, and handler guidance. Use when working with Puya SPI NOR Flash memory components or PuyaHandler.

Puya Semiconductor Manufacturer Skill

MPN Structure

Puya MPNs follow this general structure:

[PREFIX][DENSITY][PACKAGE][-SUFFIX]
   |       |        |        |
   |       |        |        +-- Optional: Grade/Temperature (SSH, SUH)
   |       |        +-- Package code (H, U, SH, SU)
   |       +-- Memory density (80=8Mbit, 16, 32, 64, 128)
   +-- Series prefix (P25Q, P25D, PY25Q)

Example Decoding

P25Q80H
|  | ||
|  | |+-- H = SOIC-8 package
|  | +-- 80 = 8 Mbit density
|  +-- Q = Standard series
+-- P25 = Puya SPI Flash prefix

P25Q16H-SSH
|  |  | | |
|  |  | | +-- SSH = SOIC-8 (hyphenated suffix)
|  |  | +-- H = base package indicator
|  |  +-- 16 = 16 Mbit density
|  +-- Q = Standard series
+-- P25 = Puya SPI Flash prefix

PY25Q128HA
| | |  ||
| | |  |+-- A = Grade code (Automotive)
| | |  +-- H = SOIC-8 package
| | +-- 128 = 128 Mbit density
| +-- Y25Q = Automotive grade series
+-- P = Puya prefix

Series Prefixes

Density Codes

Note: Density code 80 represents 8 Mbit (not 80 Mbit).

Package Codes

Base Package Codes

Hyphenated Suffix Codes

Product Families

P25Q Series - Standard SPI NOR Flash

P25D Series - Low Power SPI NOR Flash

PY25Q Series - Automotive Grade SPI NOR Flash

Handler Implementation Notes

Pattern Matching

// P25Q series - Standard SPI NOR Flash
"^P25Q\\d+.*"

// P25D series - Low Power SPI NOR Flash
"^P25D\\d+.*"

// PY25Q series - Automotive Grade (check first as more specific)
"^PY25Q\\d+.*"

Package Code Extraction

// Handle hyphenated suffixes first
int hyphenIndex = upperMpn.indexOf('-');
if (hyphenIndex > 0) {
    String suffix = upperMpn.substring(hyphenIndex + 1);
    // Check against PACKAGE_CODES map
}

// Then extract trailing package code after density
// P25Q80H -> H (SOIC-8)
// Check longer suffixes before shorter ones (SU before U, SH before H)

Density Extraction

// Special case: 80 = 8Mbit, not 80Mbit
switch (densityCode) {
    case "80" -> "8";
    default -> densityCode;
}

Grade Extraction

// Check prefix to determine grade
if (upperMpn.startsWith("PY25Q")) return "Automotive";
if (upperMpn.startsWith("P25D")) return "Low Power";
if (upperMpn.startsWith("P25Q")) return "Standard";

Cross-References

Puya Flash is pin-compatible with other SPI NOR Flash manufacturers:

Related Files

• Handler: manufacturers/PuyaHandler.java
• Component types: MEMORY, MEMORY_FLASH, IC

Learnings & Edge Cases

• Density code 80: Represents 8 Mbit, not 80 Mbit - special handling required
• PY vs P prefix: PY25Q is automotive grade, must check before P25Q pattern
• Hyphenated suffixes: Some MPNs have package code after hyphen (P25Q16H-SSH)
• Grade indicators: Trailing 'A' often indicates automotive grade
• Pin compatibility: Puya Flash is generally pin-compatible with Winbond, GigaDevice, and Macronix equivalents