Skip to content

lib-electronic-components

No description provided.

Field Value
GitHub https://github.com/Cantara/lib-electronic-components
Language Java
Stars 2
Last updated 2026-03-10

README

GitHub tag (latest SemVer) Build Status GitHub commit activity Project Status: Active – The project has reached a stable, usable state and is being actively developed. Known Vulnerabilities

lib-electronic-components

A start of a library to make it a bit more meaningful to work digitally with electronic components.

Features

  • Component Validation: Verify specifications and requirements
  • Standardization: Normalize component data across manufacturers
  • Alternative Finding: Identify compatible component alternatives
  • Similarity Analysis: Find similar components based on specifications
  • Categorization: Organize components by type and characteristics
  • Type Detection: Automatic component classification
  • Manufacturer Data: Standard component data structures

Installation

Add the following dependency to your pom.xml:

<dependency>
    <groupId>no.cantara.electronic</groupId>
    <artifactId>lib-electronic-components</artifactId>
    <version>[latest version]</version>
</dependency>

Using the Electronics BOM System

Core Classes

BOMEntry

Basic building block for components: 

// Creating a basic component
BOMEntry entry = new BOMEntry();
entry.setMpn("LTC7132");  // Manufacturer Part Number
entry.setDescription("Power Distribution Controller");
entry.addSpec("power_type", "Marine grade");
entry.addSpec("redundant_power", "yes");

PCBABOM & MechanicalBOM

Assemblies for electronic and mechanical components: 

// Creating a PCBA assembly
List<BOMEntry> pcbaEntries = new ArrayList<>();
// ... add entries ...
PCBABOM pcba = new PCBABOM("PWR-MAIN-01", "Power Management Board", "R1.0", pcbaEntries);

// Creating a mechanical assembly
List<BOMEntry> mechEntries = new ArrayList<>();
// ... add entries ...
MechanicalBOM mech = new MechanicalBOM();
mech.setBomEntries(mechEntries);
mech.setProductionNo("PWR-MECH-01");

PlannedProductionBatch

Container for complete systems: 

// Creating a production batch
PlannedProductionBatch batch = new PlannedProductionBatch(
    "BATCH-2024-001",  // Batch ID
    "SUBMARINE-V1",    // Product ID
    "R1.0",           // Revision
    1                 // Quantity
);

// Adding assemblies
batch.addPCBA(powerBoard);
batch.addMechanical(powerMechanicals);

Example: Complete System Creation

See full example as JUnit test 

// Create entries with required specs
BOMEntry powerIC = new BOMEntry()
    .setMpn("BQ40Z80RSMR")
    .setDescription("Battery Management IC")
    .addSpec("power_type", "Marine grade")
    .addSpec("redundant_power", "yes")
    .addSpec("waterproof", "yes")
    .addSpec("protection_rating", "IP68");

// Create PCBA with entries
List<BOMEntry> entries = new ArrayList<>();
entries.add(powerIC);
PCBABOM powerBoard = new PCBABOM("PWR-01", "Power Board", "R1.0", entries);

// Create production batch
PlannedProductionBatch batch = new PlannedProductionBatch(
    "BATCH-2024-001",
    "SUBMARINE-V1",
    "R1.0",
    1
);
batch.addPCBA(powerBoard);

// Validate the batch
SubmarineSystemValidator validator = new SubmarineSystemValidator();
validator.validate(batch);
if (!validator.getValidationErrors().isEmpty()) {
    // Handle validation errors
    validator.getValidationErrors().forEach(System.out::println);
}

MPNUtils

MPNUtils is a utility class for handling Manufacturer Part Numbers (MPNs) in electronic component management. It provides functionality for normalization, type detection, similarity comparison, and manufacturer identification.

Key Features

  • MPN normalization
  • Component type detection
  • Similarity calculation between MPNs
  • Manufacturer detection
  • MOSFET and IC type validation

Usage Examples

// Normalize MPNs by removing special characters and converting to uppercase
String normalized1 = MPNUtils.normalize("LM358-N");     // Returns "LM358N"
String normalized2 = MPNUtils.normalize("2N2222A/TO");  // Returns "2N2222ATO"
String normalized3 = MPNUtils.normalize("GRM188R71H104KA93D"); // Returns "GRM188R71H104KA93D"

// Parse and standardize MPNs
String standardizedMpn = MPNUtils.standardize("LM317-T");  // Returns "LM317T"
boolean isValid = MPNUtils.isValidMpn("LM317T");          // Basic MPN validation

// Check if an MPN matches a specific component type
boolean isOpAmp = MPNUtils.matchesType("LM358N", ComponentType.OPAMP);  // true
boolean isResistor = MPNUtils.matchesType("RC0603FR-0710KL", ComponentType.RESISTOR);  // true
boolean isMosfet = MPNUtils.matchesType("IRF530N", ComponentType.MOSFET);  // true

// Compare similar components
double similarity;
// Op-amps from different manufacturers
similarity = MPNUtils.calculateSimilarity("LM358", "MC1458");  // 0.9 (equivalent parts)

// MOSFETs
similarity = MPNUtils.calculateSimilarity("IRF530", "IRF530N");  // 0.9 (same family)
similarity = MPNUtils.calculateSimilarity("IRF530", "IRF540");   // 0.3 (different ratings)

// Resistors
similarity = MPNUtils.calculateSimilarity(
    "CRCW060310K0FKEA",  // Vishay 10kΩ 0603
            "RC0603FR-0710KL"    // Yageo 10kΩ 0603
);  // 0.8 (equivalent parts)

// Capacitors
similarity = MPNUtils.calculateSimilarity(
    "GRM188R71H104KA93D",  // Murata 0.1µF 50V 0603
            "C0603C104K5RACTU"     // KEMET 0.1µF 50V 0603
);  // 0.9 (equivalent parts)

// Identify manufacturer from MPN
ComponentManufacturer mfr1 = MPNUtils.getManufacturer("STM32F103C8T6");  // STMicroelectronics
ComponentManufacturer mfr2 = MPNUtils.getManufacturer("ATMEGA328P-PU");  // Atmel
ComponentManufacturer mfr3 = MPNUtils.getManufacturer("GRM188R71H104KA93D");  // Murata

// Check if MPN is from specific manufacturer
boolean isSTMicro = MPNUtils.isFromManufacturer("STM32F103", ComponentManufacturer.ST);  // true
boolean isTI = MPNUtils.isFromManufacturer("LM358", ComponentManufacturer.TI);  // true

// Compare MPNs
boolean areEqual = MPNUtils.compareMpn("LM317-T", "LM317T");  // True
String normalized = MPNUtils.normalizeMpn("LM317-T");         // Removes special chars

// MOSFET validation
boolean isMosfet1 = MPNUtils.isMosfet("IRF530N");  // true
boolean isMosfet2 = MPNUtils.isMosfet("2N2222");   // false

// Analog IC detection
boolean isAnalog1 = MPNUtils.isAnalogIC("LM358");   // true (op-amp)
boolean isAnalog2 = MPNUtils.isAnalogIC("74HC00");  // false (digital IC)

// Digital IC detection
boolean isDigital1 = MPNUtils.isDigitalIC("74LS00");  // true
boolean isDigital2 = MPNUtils.isDigitalIC("LM317");   // false

Similarity System

Metadata-Driven Architecture (January 2026)

The similarity system uses a metadata-driven architecture with configurable, type-specific rules. 15 of 17 calculators (88%) have been converted to this approach:

Converted Calculators: - ✅ ResistorSimilarityCalculator (pre-existing) - Resistance value, package, tolerance comparison - ✅ CapacitorSimilarityCalculator (pre-existing) - Capacitance value, voltage rating, dielectric type, package - ✅ TransistorSimilarityCalculator (pre-existing) - Polarity (NPN/PNP), voltage/current ratings, hFE, package - ✅ DiodeSimilarityCalculator (pre-existing) - Diode type, voltage/current ratings, package - ✅ MosfetSimilarityCalculator (pre-existing) - Channel (N/P), voltage/current ratings, RdsOn, package - ✅ VoltageRegulatorSimilarityCalculator (pre-existing) - Regulator type, output voltage, polarity, current rating - ✅ OpAmpSimilarityCalculator (PR #116) - Configuration, family, package comparison - ✅ MemorySimilarityCalculator (PR #117) - Memory type, capacity, interface, package - ✅ LEDSimilarityCalculator (PR #118) - Color, family, brightness, package - ✅ ConnectorSimilarityCalculator (pre-existing) - Pin count, pitch, family, mounting - ✅ LogicICSimilarityCalculator (PR #119) - Function, series, technology, package - ✅ SensorSimilarityCalculator (PR #120) - Sensor type, family, interface, package - ✅ MCUSimilarityCalculator (PR #123) - Family, series, features weighted comparison - ✅ MicrocontrollerSimilarityCalculator (PR #123) - Manufacturer registry with metadata weights - ✅ PassiveComponentCalculator (PR #123) - Generic value, size code, tolerance comparison

Core Components: - ComponentTypeMetadata: Defines critical specs, importance levels, and tolerance rules per component type - SpecImportance: 5 levels (CRITICAL, HIGH, MEDIUM, LOW, OPTIONAL) with base weights - ToleranceRule: 5 comparison strategies (ExactMatch, Percentage, MinRequired, MaxAllowed, Range) - SimilarityProfile: 5 context-aware profiles (DESIGN_PHASE, REPLACEMENT, COST_OPTIMIZATION, PERFORMANCE_UPGRADE, EMERGENCY_SOURCING) - Pre-registered types: RESISTOR, CAPACITOR, MOSFET, TRANSISTOR, DIODE, OPAMP, MICROCONTROLLER, MEMORY, LED, CONNECTOR

// Get metadata for a component type
ComponentTypeMetadataRegistry registry = ComponentTypeMetadataRegistry.getInstance();
Optional<ComponentTypeMetadata> metadata = registry.getMetadata(ComponentType.RESISTOR);

// Check if spec is critical
boolean critical = metadata.get().isCritical("resistance"); // true

// Use context-aware profiles
SimilarityProfile profile = SimilarityProfile.REPLACEMENT;
boolean passes = profile.meetsThreshold(0.78); // threshold: 0.75

// Converted calculators use weighted scoring
// similarity = totalScore / maxPossibleScore
// where totalScore = Σ(specScore × effectiveWeight)

Key Benefits: - More accurate similarity scores (e.g., LM358 vs MC1458: 0.9 → 1.0) - Short-circuit checks for critical mismatches (e.g., dual vs quad op-amps) - Configurable importance weights per spec - Context-aware thresholds for different use cases - Better documentation of comparison logic

Similarity Calculators

The library includes 17 specialized similarity calculators that compare components based on electrical characteristics rather than just string matching:

Calculator Component Type Key Matching Criteria
ResistorSimilarityCalculator Resistors Value, package (0603, 0805), tolerance
CapacitorSimilarityCalculator Capacitors Capacitance (104=100nF), voltage, dielectric (X7R)
TransistorSimilarityCalculator BJT Transistors Polarity (NPN/PNP), equivalent groups (2N2222≈PN2222)
DiodeSimilarityCalculator Diodes Type (signal/rectifier/zener), voltage, equivalents (1N4148≈1N914)
MosfetSimilarityCalculator MOSFETs Channel type (N/P), voltage/current ratings, IRF families
OpAmpSimilarityCalculator Op-Amps Channel count (single/dual/quad), manufacturer families
MCUSimilarityCalculator Microcontrollers Family (50%), series (30%), features (20%) weighted
MemorySimilarityCalculator Memory ICs Interface (I2C/SPI), density, package
SensorSimilarityCalculator Sensors Sensor type, interface, measurement range
LEDSimilarityCalculator LEDs Color bin, brightness bin, package
ConnectorSimilarityCalculator Connectors Pin count (must match), pitch, mounting type
VoltageRegulatorSimilarityCalculator Regulators Fixed (78xx) vs adjustable (LM317), voltage
LogicICSimilarityCalculator Logic ICs Function (NAND/NOR), technology (LS/HC/HCT)

Similarity Thresholds

// Common thresholds used by calculators
HIGH_SIMILARITY = 0.9;    // Equivalent/interchangeable parts
MEDIUM_SIMILARITY = 0.7;  // Compatible, same family
LOW_SIMILARITY = 0.3;     // Same type, different specs

Usage Examples

// Cross-manufacturer transistor equivalents
double sim = MPNUtils.calculateSimilarity("2N2222A", "PN2222A");  // 0.9

// Same op-amp family
sim = MPNUtils.calculateSimilarity("LM358N", "MC1458");  // 0.9

// Rectifier diode equivalents (same voltage rating)
sim = MPNUtils.calculateSimilarity("1N4007", "RL207");   // 0.9

// Logic IC - same function, different technology
sim = MPNUtils.calculateSimilarity("74LS00", "74HC00"); // 0.9

// MCU - same family, different series
sim = MPNUtils.calculateSimilarity("STM32F103C8T6", "STM32F407VGT6"); // ~0.7

// Connector - different pin counts = incompatible
sim = MPNUtils.calculateSimilarity("10-pin", "20-pin"); // 0.3

ComponentType

ComponentType type = ComponentType.INTEGRATED_CIRCUIT;
ComponentType.Category category = type.getCategory();  // ACTIVE

// Component classification
boolean isActive = type.isActiveComponent();     // True
boolean isPassive = type.isPassiveComponent();   // False
boolean isDiscrete = type.isDiscreteComponent(); // False

// Grouping and categorization
List<ComponentType> activeTypes = ComponentType.getTypesByCategory(Category.ACTIVE);

ComponentTypeDetector

ComponentTypeDetector detector = new ComponentTypeDetector();

// Detect component types
boolean isProcessor = detector.isProcessorComponent(component);
boolean isPower = detector.isPowerComponent(component);
boolean isSensor = detector.isSensorComponent(component);

// Get detailed classification
ComponentType detectedType = detector.detectType(component);
String category = detector.getComponentCategory(component);

ElectronicComponentManufacturer

Represents and manages manufacturer information: 

ElectronicComponentManufacturer manufacturer = new ElectronicComponentManufacturer();
manufacturer.setName("Texas Instruments");
manufacturer.setPrefix("TI");
manufacturer.setMpnPattern("^(LM|TPS|TMS|CC)\\d+.*");

// Validate manufacturer-specific MPNs
boolean isValidMpn = manufacturer.isValidMpn("TPS65281");

// Get standardized manufacturer names
String stdName = manufacturer.getStandardizedName();

Manufacturer Coverage

The library supports 135+ manufacturers with dedicated handlers for MPN parsing, type detection, and component matching:

Category Manufacturers
MCUs & Processors TI, ST, Microchip, Atmel, NXP, Renesas, Silicon Labs, Espressif, Nordic, Cypress, Infineon, Nuvoton, Holtek, WCH, Artery
Analog & Power Analog Devices, Maxim, ON Semi, Toshiba, ROHM, Richtek, Silergy, Torex, ABLIC, SGMicro, 3PEAK, MPS, Vicor, Power Integrations
Discrete Semiconductors Vishay, Nexperia, Alpha & Omega, Fairchild, Good-Ark, Yangjie, Panjit
Memory Micron, Winbond, ISSI, Macronix, GigaDevice, Alliance Memory, Puya, XMC, ESMT
Passives Murata, KEMET, Samsung, TDK, Panasonic, AVX, Nichicon, Vishay, Yageo, Bourns, Lelon, Rubycon, Elna, Nippon Chemi-Con, Viking Tech
Inductors Coilcraft, Sumida, Pulse Electronics, Sunlord, Chilisin, Cyntec
Connectors TE, Amphenol, Wurth, Molex, Hirose, JST, Jinling, Phoenix Contact, Harting, Samtec, Mill-Max, Sullins
RF & Wireless Qorvo, Skyworks, Nordic, Qualcomm, Semtech, Airoha, Beken, Telink
Sensors Bosch, InvenSense, Melexis, Sensirion, Honeywell, ams-OSRAM
Audio Cirrus Logic, Realtek, ESS Technology, C-Media
Interface ICs FTDI, Genesys Logic, ASMedia, Prolific, JMicron, VIA Labs
Display/LED Drivers Macroblock, Chipone, Sitronix, Raydium, Novatek
Crystals & Timing Epson, NDK, Abracon, IQD, SiTime, TXC, Kyocera, KDS
LEDs Cree, OSRAM, Lumileds, Kingbright, Seoul Semi, Everlight
Motor Control Trinamic
Optocouplers Isocom, Cosmo Electronics
Circuit Protection Littelfuse, ProTek Devices

Each handler provides: - MPN pattern matching and validation - Package code extraction - Series identification - Replacement/equivalent detection

As the market changes daily, this will never be 100% - but we believe that it should bring value to systems dealing with electronic components.