Electro Grammar 
This is a parser using Nearley that defines a grammar for describing generic electronic components such as surface mount resistors, capacitors and LEDs. A function to match the result to parts in the Common Parts Library is also provided.
const {parse, matchCPL} = require('electro-grammar')Parsing
Capacitors
Parses capacitance, package size, characteristic, tolerance and voltage rating for capacitors.
> parse('100nF 0603 C0G 10% 25V')
{ type: 'capacitor',
capacitance: 1e-7,
size: '0603',
characteristic: 'C0G',
tolerance: 10,
voltage_rating: 25 }For class 1 ceramic names and EIA letter codes are understood. For class 2 only EIA letter codes are understood. In both cases only EIA letter codes are returned.
> parse('10pF C0G/NP0')
{ type: 'capacitor', capacitance: 1e-11, characteristic: 'C0G' }
> parse('10pF NP0')
{ type: 'capacitor', capacitance: 1e-11, characteristic: 'C0G' }
> parse('10pF X7R')
{ type: 'capacitor', capacitance: 1e-11, characteristic: 'X7R' }Resistors
Parses resistance, package size, tolerance and power rating for resistors.
> parse('1k 0805 5% 125mW')
{ type: 'resistor',
resistance: 1000,
size: '0805',
tolerance: 5,
power_rating: 0.125 }Electro-grammar supports several different ways to express resistance.
> parse('1.5k')
{ type: 'resistor', resistance: 1500 }
> parse('1k5')
{ type: 'resistor', resistance: 1500 }
> parse('500R')
{ type: 'resistor', resistance: 500 }
> parse('1500 ohm')
{ type: 'resistor', resistance: 1500 }
> parse('1500.0 ohm')
{ type: 'resistor', resistance: 1500 }
> parse('1500 Ω')
{ type: 'resistor', resistance: 1500 }LEDs
LEDs need to include the word 'LED' or 'led'.
> parse('LED red')
{ color: 'red', type: 'led' }
> parse('LED 0603')
{ size: '0603', type: 'led' }
> parse('green led 1206')
{ color: 'green', type: 'led', size: '1206' }Parsing Details
Converts all units to floating point numbers.
> parse('100nF')
{ type: 'capacitor', capacitance: 1e-7 }
> parse('0.1uF')
{ type: 'capacitor', capacitance: 1e-7 }The order of the terms doesn't matter.
> parse('1% 0603 1uF')
{ type: 'capacitor'
capacitance: 0.000001,
tolerance: 1,
size: "0603" }
> parse('0603 1% 1uF')
{ type: 'capacitor',
capacitance: 0.000001,
tolerance: 1,
size: "0603" }If no match is found and empty object is returned.
> parse('')
{}
> parse('NE555P')
{}But invalid input types will throw.
> parse({})
TypeError: str.split is not a functionText that is not part of the grammar is simply ignored.
> parse('NE555P 1uF')
{ type: 'capacitor', capacitance: 0.000001 }
> parse('these words 1k are ignored 0805')
{ type: 'resistor', resistance: 1000, size: '0805' }You can use metric package sizes as long as you make it clear by using the metric keyword.
Output for package sizes is always in imperial.
> parse('1k metric 0603')
{ type: 'resistor', resistance: 1000, size: '0201' }
> parse('1k 0603 metric')
{ type: 'resistor', resistance: 1000, size: '0201' }CPL Matching
matchCPL tries to find as many matches as it can from the Common Parts Library and returns an array of CPL IDs.
You could match these against CPL data or search for them on Octopart to get exact part numbers.
If no matches are found or the function is given invalid input an empty array is returned.
> c = parse('0.1uF 0805 25V')
{ type: 'capacitor',
capacitance: 1e-7,
size: '0805',
voltage_rating: 25 }
> matchCPL(c)
[ 'CPL-CAP-X7R-0805-100NF-50V' ]
> r = parse('10k 0603')
{ type: 'resistor', resistance: 10000, size: '0603' }
> matchCPL(r)
[ 'CPL-RES-0603-10K-0.1W' ]
> // I don't think it's possible to make such a resistor
> r = parse('1k 1000000W')
{ type: 'resistor', resistance: 1000, power_rating: 1000000 }
> matchCPL(r)
[]
> matchCPL({invalid: 'input'})
[]
> matchCPL(null)
[]License
Electro Grammar is currently licensed under the AGPLv3. See the LICENSE.md file for details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent