Jinling

Total Length: 15 characters (fixed)

2. JILN Distributor Format (15-18 characters)

Used on LCSC, JLCPCB, and other distributor platforms.

321010MG0CBK00A02
│││││││││││││││└┴─ Suffix codes (variant/packaging)
││││││││││││└┴──── Additional encoding
│││││││││││└────── K = Black color
││││││││││└─────── B = Material/housing
│││││││││└──────── C = Series/family code
││││││││└───────── 0 = Placeholder
│││││││└────────── G = Gold plating
││││││└─────────── M = SMT mounting
││││└┴──────────── 10 = Pin count (2x5=10)
│││└───────────── 1 = Rows
││└────────────── 2 = Pitch indicator (2.54mm)
└┴─────────────── 32 = Family/series (IDC)

Elprint Format Reference Tables

Family Codes (Positions 0-1)

Plastics Height (Positions 2-3)

Encoded as height in mm × 10:

• 31 = 3.1mm
• 35 = 3.5mm
• 85 = 8.5mm

Formula: height_mm = parseInt(positions[2:4]) * 0.1

House Count (Position 4)

Always 0 for current Jinling products.

Rows (Position 5)

• 1 = Single row
• 2 = Dual row
• 3 = Triple row

Pins Per Row (Positions 6-7)

MUST be numeric (e.g., 02, 10, 20, 40).

Pin count calculation: rows × pinsPerRow

Examples:

• 1 row × 40 pins = 40 total
• 2 rows × 20 pins = 40 total
• 2 rows × 02 pins = 4 total

Insulator Material (Position 8)

Post (Position 9)

Contact Plating (Positions 10-11)

Connector Type (Position 12)

Contact Type (Position 13)

Packing (Position 14)

Example MPN Decoding

Example 1: 27310202ANG3SUT

27 31 0 2 02 A N G3 S U T
│  │  │ │ │  │ │ │  │ │ └─ T = Tube packing
│  │  │ │ │  │ │ │  │ └─── U = U-Type contact
│  │  │ │ │  │ │ │  └───── S = Straight THT
│  │  │ │ │  │ │ └─────── G3 = 10µin Gold
│  │  │ │ │  │ └────────── N = No post
│  │  │ │ │  └─────────── A = PBT material
│  │  │ │ └──────────── 02 = 2 pins per row
│  │  │ └────────────── 2 = Dual row
│  │  └──────────────── 0 = No houses
│  └─────────────────── 31 = 3.1mm height
└────────────────────── 27 = Female Header (2.54mm pitch)

Decoded: 2.54mm female header, 2 rows × 2 pins = 4 total, 3.1mm height, PBT, no post, 10µin gold plating, straight THT, U-type contacts, tube packing

Example 2: 17310140ANSNSUT

17 31 0 1 40 A N SN S U T

Decoded: 2.54mm pin header (male), 1 row × 40 pins = 40 total, 3.1mm height, PBT, no post, tin plating, straight THT, U-type contacts, tube packing

Distributor Format Examples

Real Jinling part numbers from LCSC:

Handler Implementation Notes

Pattern Matching

Elprint format requires:

• Exactly 15 characters
• Family code: 13, 16, 17, 26, or 27
• Positions 2-7 must be numeric

// Elprint pattern (15 chars)
^(?:13|16|17|26|27)[0-9]{4}[0-9]{2}[A-Z][A-Z]{2}[A-Z]{3}$

// Distributor patterns
^32[0-9]{4}[A-Z]{2}[0-9][A-Z]{3}[0-9]{2}[A-Z][0-9]{2}  // IDC
^1[0-9]{4}[0-9]{3,4}[A-Z]{3}[0-9][A-Z][0-9]{6,7}       // Pin headers (12xxx)
^22[0-9]{3}[0-9]{3,4}[A-Z]{3}[0-9][A-Z]{3}[A-Z][0-9]{2} // Female headers

Position-Based Extraction

CRITICAL: Always validate MPN length before substring operations!

private boolean isElprintFormat(String mpn) {
    if (mpn == null || mpn.length() < 15) return false;

    String family = mpn.substring(0, 2);
    boolean isKnownFamily = "13".equals(family) || "16".equals(family) ||
                           "17".equals(family) || "26".equals(family) ||
                           "27".equals(family);

    // Positions 2-7 must be numeric
    boolean hasNumericPrefix = mpn.substring(2, 6).matches("[0-9]+") &&
                              mpn.substring(6, 8).matches("[0-9]+");

    return isKnownFamily && hasNumericPrefix;
}

Pin Count Calculation

public int extractPinCount(String mpn) {
    if (!isElprintFormat(mpn)) return 0;

    try {
        int rows = Character.getNumericValue(mpn.charAt(5));
        int pinsPerRow = Integer.parseInt(mpn.substring(6, 8));
        return rows * pinsPerRow;
    } catch (NumberFormatException e) {
        return 0;
    }
}

Package Code Extraction

public String extractPackageCode(String mpn) {
    if (!isElprintFormat(mpn) || mpn.length() < 13) return "";

    String typeCode = mpn.substring(12, 13);
    return CONNECTOR_TYPES.getOrDefault(typeCode, typeCode);
}

Official Replacement Logic

Components are interchangeable if:

1. Same family (e.g., both 27)
2. Same pin count
3. Compatible mounting types (both SMT or both THT)

Different plating, material, or packing are acceptable variations.

Related Files

• Handler: src/main/java/no/cantara/electronic/component/lib/manufacturers/JinlingHandler.java (~560 lines)
• Tests: src/test/java/no/cantara/electronic/component/lib/handlers/JinlingHandlerTest.java (~550 lines, 131 tests)
• Component Types: CONNECTOR, CONNECTOR_JINLING
• Manufacturer Enum: ComponentManufacturer.JINLING

Known Issues & Edge Cases

Test MPN Format Issue (RESOLVED)

Problem: Initial test MPNs used 13-17 character format instead of required 15 characters.

Example:

• ❌ Wrong: 273102NSNSUXT (13 chars with non-numeric positions)
• ❌ Wrong: 27310202ASNSUTT (17 chars)
• ❌ Wrong: 17310110AG3SUT (14 chars - missing post indicator)
• ✅ Correct: 27310202ANG3SUT (15 chars, all numeric in positions 2-7)

Resolution: All 131 tests now use proper 15-character elprint format. Handler pattern enforces exact length validation with length() != 15 check.

Handler Pattern Conflicts

The handler registers patterns for both encoding systems:

• Elprint: Families 13/16/17/26/27
• Distributor: Families 12/22/32/35

Ensure ComponentManufacturer.JINLING pattern covers both:

JINLING("(?:1[2367]|2[267]|3[25])[0-9]{4,}", "Shenzhen Jinling Electronics", new JinlingHandler())

Position-Based Extraction Gotchas

1. Always check MPN length before substring - prevents IndexOutOfBoundsException
2. Positions 6-7 MUST be numeric - test MPNs with letters like "NS" will fail
3. Position 14 is single character for packing, not two
4. Default to 0/empty when extraction fails - graceful degradation

Cross-Handler Pattern Matching

Jinling patterns (^13..., ^17...) could conflict with other manufacturers using similar prefixes. The matches() method includes explicit family checks to prevent false positives.

Test Examples

Stable Pattern Matching Tests

@Test
void shouldMatchElprintFormat() {
    assertTrue(handler.matches("27310202ANG3SUT", ComponentType.CONNECTOR, registry));
    assertTrue(handler.matches("17310140ANSNSUT", ComponentType.CONNECTOR, registry));
}

@Test
void shouldMatchDistributorFormat() {
    assertTrue(handler.matches("321010MG0CBK00A02", ComponentType.CONNECTOR, registry));
    assertTrue(handler.matches("12251140CNG0S115001", ComponentType.CONNECTOR, registry));
}

Extraction Tests

@Test
void shouldExtractPinCount() {
    assertEquals(4, handler.extractPinCount("27310202ANG3SUT"));   // 2×2=4
    assertEquals(40, handler.extractPinCount("17310140ANSNSUT"));  // 1×40=40
    assertEquals(80, handler.extractPinCount("27310240ANSNSUT"));  // 2×40=80
}

@Test
void shouldExtractPackageCode() {
    assertEquals("SMT", handler.extractPackageCode("27310202MNSNSUT"));
    assertEquals("Straight THT", handler.extractPackageCode("27310202ANSNSUT"));
    assertEquals("Right Angle THT", handler.extractPackageCode("27310202ARSNRUT"));
}

Future Improvements

1. Test MPN Format: Update all test MPNs to proper 15-character elprint format ✓ COMPLETED
2. Distributor MPN Decoding: Implement full parsing for LCSC/JLCPCB format MPNs (partially done - pin count extraction works)
3. Layout Variants: Add support for optional [15-16] layout codes (TYPE 01, TYPE 02)
4. IDC Connector Family (32): Expand handler to include full IDC connector support (basic pattern matching works)
5. Validation: Add MPN format validator to detect malformed part numbers

Learnings & Quirks

• Two Encodings: Jinling uses both internal (elprint) and external (distributor) MPN formats
• Fixed Length: Elprint format is exactly 15 characters, not variable length
• Numeric Pins: Positions 6-7 must be numeric digits, not letters
• Family Determines Type: Family code determines gender (13/16/17=male, 26/27=female) and pitch
• Position 12 Critical: Connector type (M/S/R/W/Z) determines mounting style and orientation
• Gold Plating Grades: G0-G5 represent different gold thicknesses (flash to 30µin)
• Real-World MPNs: LCSC uses distributor format (18 chars), not elprint format (15 chars)
• Position Misalignment: Test failures often indicate wrong position encoding (e.g., connector type at pos 8 instead of 12)
• Missing Characters: 14-char MPNs usually missing post indicator 'N' at position 9
• Pattern Validation: Use length() != 15 not length() < 15 to catch both too short AND too long MPNs
• Substring Safety: Always validate length before substring(6,8) operations to prevent IndexOutOfBoundsException