← Back to team overview

kicad-lib-committers team mailing list archive

Re: Fwd: Re: About library naming conventions

 

About pin length, what about using SI units?

Here is something yet more elaborated, which I think covers most cases.

General Rules:

1. Writing uses C-style naming with the first letter of each word being
capitalized. Ex: "Socket_Strip_Straight_2x06"
2. Every acronym has all of its letters capitalized.
3. Manufacturer name is capitalized as usual. Ex: NEC, Microchip
4. Component name must match its filename
5. When dimensions are used in part name, they are in millimeters and unit
is not capitalized. Ex: "Cap_10x13mm_RM5"
6. Filename is the same as the part name

Symbols:

1. A pin length of 4mm is used, except for components without pin numbers
which use 2.5mm.
2. Usual symbol is used if there is one
3. Black-box components group pins logically, for example by function set,
and ports in counter-clockwise position. Ex:

Footprints:

1. Follows datasheet recommendation unless intentional variation, for
example longer pads for hand soldering
2. Pad 1 is placed at the top left corner
3. For through-hole components, origin is set on pad 1.
4. For surface-mount devices, origin is placed in the middle of the chip.

Names for Surface-Mount Devices (SMD):

1. Specific package feature first, not separated by anything.
2. Package name, numbers separated from letters using hyphen Ex: "SOT-89"
3. Variation of package, separated by another hyphen. Ex: "SOT-23-5"
4. If it's a manufacturer-specific package, name can be appended, separated
by an underscore.
5. Any modification to the original footprint, indicated by appending the
reason. Ex: longer pads are used to facilitate hand soldering of a QFN
component: "QFN-52_HandSoldering"

Names for common devices, such as resistors, capacitors, etc:

1. Name of part, may be shortened for common components. ex: "Cap",
"Socket_Strip", etc.
2. Dimension, which may include at its end the positioning. Ex:
"TO-220_Horiz", "1x02_Angled"
3. Pad distance, in the form of an RM rating.
4. Any modification to the original footprint, indicated by appending the
reason.

Names for devices that have their own footprint

1. Name of part.
2. Part number. Ex: "Oscillator_SI570"
4. Any modification to the original footprint, indicated by appending the
reason.

I would like to hear any concerns and comments.

Regards,

Carl

On Tue, Mar 25, 2014 at 1:30 AM, Kerusey Karyu <keruseykaryu@xxxxx> wrote:
>
> In 24.03.2014 20:12, Carl Poirier wrote:
>
>>
>> I would like to avoid the "variable" rule in your suggestion, so what do
>> you think about this ?
>>
> Well. It's possible if we assume that max pin length is 150mil started
from an invisible bounding box for fancy symbols. Everything inside and the
missing portion of the line we draw as graphics.
>
>
> Kerusey Karyu
>
>
> --
> Mailing list: https://launchpad.net/~kicad-lib-committers
> Post to     : kicad-lib-committers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-lib-committers
> More help   : https://help.launchpad.net/ListHelp

Follow ups

References