2016-02-24 08:48:55 +00:00
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
|
|
# (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
|
|
# MA 02110-1301, USA.
|
|
|
|
#
|
|
|
|
|
|
|
|
from __future__ import division
|
|
|
|
import pcbnew
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
import pcbnew
|
|
|
|
import FootprintWizardBase
|
2016-02-24 08:48:55 +00:00
|
|
|
import PadArray as PA
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
class QFNWizard(FootprintWizardBase.FootprintWizard):
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
def GetName(self):
|
|
|
|
return "QFN"
|
|
|
|
|
|
|
|
def GetDescription(self):
|
2017-01-03 15:01:47 +00:00
|
|
|
return "Quad Flat No-lead (QFN) footprint wizard"
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
def GenerateParameterList(self):
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
#TODO - Allow different number of pads in x and y directions
|
|
|
|
|
|
|
|
self.AddParam("Pads", "n", self.uInteger, 100, multiple=4, min_value=4)
|
2018-12-10 11:13:12 +00:00
|
|
|
self.AddParam("Pads", "pitch", self.uMM, 0.4, designator='e')
|
|
|
|
self.AddParam("Pads", "width", self.uMM, 0.2, designator='X1')
|
|
|
|
self.AddParam("Pads", "length", self.uMM, 0.75, designator='Y1')
|
2019-04-17 16:02:22 +00:00
|
|
|
self.AddParam("Pads", "offset", self.uMM, 0.0)
|
2016-02-24 08:48:55 +00:00
|
|
|
self.AddParam("Pads", "oval", self.uBool, True)
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
self.AddParam("EPad", "epad", self.uBool, True)
|
|
|
|
self.AddParam("EPad", "width", self.uMM, 10, designator="E2")
|
|
|
|
self.AddParam("EPad", "length", self.uMM, 10, designator="D2")
|
|
|
|
self.AddParam("EPad", "thermal vias", self.uBool, False)
|
|
|
|
self.AddParam("EPad", "thermal vias drill", self.uMM, 1, min_value=0.1)
|
2018-12-10 11:13:12 +00:00
|
|
|
self.AddParam("EPad", "x divisions", self.uInteger, 4, min_value=1)
|
|
|
|
self.AddParam("EPad", "y divisions", self.uInteger, 4, min_value=1)
|
|
|
|
self.AddParam("EPad", "paste margin", self.uMM, 0.75)
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
self.AddParam("Package", "width", self.uMM, 14, designator='E')
|
|
|
|
self.AddParam("Package", "height", self.uMM, 14, designator='D')
|
|
|
|
self.AddParam("Package", "margin", self.uMM, 0.25, minValue=0.2)
|
|
|
|
|
|
|
|
@property
|
|
|
|
def pads(self):
|
|
|
|
return self.parameters['Pads']
|
|
|
|
|
|
|
|
@property
|
|
|
|
def epad(self):
|
|
|
|
return self.parameters['EPad']
|
|
|
|
|
|
|
|
@property
|
|
|
|
def package(self):
|
|
|
|
return self.parameters['Package']
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
def CheckParameters(self):
|
2017-01-03 15:01:47 +00:00
|
|
|
pass
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
def GetValue(self):
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
return "QFN-{n}_{ep}{x:g}x{y:g}_Pitch{p:g}mm".format(
|
|
|
|
n = self.pads['n'],
|
|
|
|
ep = "EP_" if self.epad['epad'] else '',
|
|
|
|
x = pcbnew.ToMM(self.package['width']),
|
|
|
|
y = pcbnew.ToMM(self.package['height']),
|
|
|
|
p = pcbnew.ToMM(self.pads['pitch'])
|
|
|
|
)
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
def BuildThisFootprint(self):
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
pad_pitch = self.pads["pitch"]
|
|
|
|
pad_length = self.pads["length"]
|
2019-04-17 16:02:22 +00:00
|
|
|
# offset allows to define how much of the pad is outside of the package
|
2019-04-17 06:19:10 +00:00
|
|
|
pad_offset = self.pads["offset"]
|
2017-01-03 15:01:47 +00:00
|
|
|
pad_width = self.pads["width"]
|
2016-02-24 08:48:55 +00:00
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
v_pitch = self.package["height"]
|
|
|
|
h_pitch = self.package["width"]
|
2016-02-24 08:48:55 +00:00
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
pads_per_row = int(self.pads["n"] // 4)
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
row_len = (pads_per_row - 1) * pad_pitch
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
pad_shape = pcbnew.PAD_SHAPE_OVAL if self.pads["oval"] else pcbnew.PAD_SHAPE_RECT
|
2016-02-24 08:48:55 +00:00
|
|
|
|
2019-04-17 06:19:10 +00:00
|
|
|
h_pad = PA.PadMaker(self.module).SMDPad( pad_length, pad_width,
|
2016-02-24 08:48:55 +00:00
|
|
|
shape=pad_shape, rot_degree=90.0)
|
2019-04-17 06:19:10 +00:00
|
|
|
v_pad = PA.PadMaker(self.module).SMDPad( pad_length, pad_width, shape=pad_shape)
|
2018-10-19 13:15:16 +00:00
|
|
|
|
2019-04-17 16:02:22 +00:00
|
|
|
h_pitch = h_pitch / 2 - pad_length + pad_offset + pad_length/2
|
|
|
|
v_pitch = v_pitch / 2 - pad_length +pad_offset + pad_length/2
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
#left row
|
2018-10-19 13:15:16 +00:00
|
|
|
pin1Pos = pcbnew.wxPoint(-h_pitch, 0)
|
2016-02-24 08:48:55 +00:00
|
|
|
array = PA.PadLineArray(h_pad, pads_per_row, pad_pitch, True, pin1Pos)
|
|
|
|
array.SetFirstPadInArray(1)
|
|
|
|
array.AddPadsToModule(self.draw)
|
|
|
|
|
|
|
|
#bottom row
|
2018-10-19 13:15:16 +00:00
|
|
|
pin1Pos = pcbnew.wxPoint(0, v_pitch)
|
2016-02-24 08:48:55 +00:00
|
|
|
array = PA.PadLineArray(v_pad, pads_per_row, pad_pitch, False, pin1Pos)
|
|
|
|
array.SetFirstPadInArray(pads_per_row + 1)
|
|
|
|
array.AddPadsToModule(self.draw)
|
|
|
|
|
|
|
|
#right row
|
2018-10-19 13:15:16 +00:00
|
|
|
pin1Pos = pcbnew.wxPoint(h_pitch, 0)
|
2016-02-24 08:48:55 +00:00
|
|
|
array = PA.PadLineArray(h_pad, pads_per_row, -pad_pitch, True,
|
|
|
|
pin1Pos)
|
|
|
|
array.SetFirstPadInArray(2*pads_per_row + 1)
|
|
|
|
array.AddPadsToModule(self.draw)
|
|
|
|
|
|
|
|
#top row
|
2018-10-19 13:15:16 +00:00
|
|
|
pin1Pos = pcbnew.wxPoint(0, -v_pitch)
|
2016-02-24 08:48:55 +00:00
|
|
|
array = PA.PadLineArray(v_pad, pads_per_row, -pad_pitch, False,
|
|
|
|
pin1Pos)
|
|
|
|
array.SetFirstPadInArray(3*pads_per_row + 1)
|
|
|
|
array.AddPadsToModule(self.draw)
|
|
|
|
|
2017-01-03 15:01:47 +00:00
|
|
|
lim_x = self.package["width"] / 2
|
|
|
|
lim_y = self.package["height"] / 2
|
2016-02-24 08:48:55 +00:00
|
|
|
inner = (row_len / 2) + pad_pitch
|
|
|
|
|
|
|
|
# epad
|
2017-01-03 15:01:47 +00:00
|
|
|
epad_width = self.epad["width"]
|
|
|
|
epad_length = self.epad["length"]
|
|
|
|
|
|
|
|
epad_ny = self.epad["x divisions"]
|
|
|
|
epad_nx = self.epad["y divisions"]
|
|
|
|
|
|
|
|
epad_via_drill = self.epad["thermal vias drill"]
|
|
|
|
|
|
|
|
# Create a central exposed pad?
|
|
|
|
if self.epad['epad'] == True:
|
|
|
|
|
|
|
|
epad_num = self.pads['n'] + 1
|
|
|
|
|
|
|
|
epad_w = epad_length / epad_nx
|
|
|
|
epad_l = epad_width / epad_ny
|
|
|
|
|
|
|
|
# Create the epad
|
|
|
|
epad = PA.PadMaker(self.module).SMDPad( epad_w, epad_l, shape=pcbnew.PAD_SHAPE_RECT )
|
|
|
|
epad.SetLocalSolderPasteMargin( -1 * self.epad['paste margin'] )
|
|
|
|
# set pad layers
|
|
|
|
layers = pcbnew.LSET(pcbnew.F_Mask)
|
|
|
|
layers.AddLayer(pcbnew.F_Cu)
|
|
|
|
layers.AddLayer(pcbnew.F_Paste)
|
2017-08-11 09:22:13 +00:00
|
|
|
epad.SetName(epad_num)
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
array = PA.EPADGridArray( epad, epad_ny, epad_nx, epad_l, epad_w, pcbnew.wxPoint(0,0) )
|
|
|
|
array.SetFirstPadInArray(epad_num)
|
|
|
|
array.AddPadsToModule(self.draw)
|
|
|
|
|
|
|
|
if self.epad['thermal vias']:
|
|
|
|
|
|
|
|
# create the thermal via
|
|
|
|
via_diam = min(epad_w, epad_l) / 2
|
|
|
|
via_drill = min(via_diam / 2, epad_via_drill)
|
|
|
|
via = PA.PadMaker(self.module).THRoundPad(via_diam, via_drill)
|
|
|
|
layers = pcbnew.LSET.AllCuMask()
|
|
|
|
layers.AddLayer(pcbnew.B_Mask)
|
|
|
|
layers.AddLayer(pcbnew.F_Mask)
|
|
|
|
via.SetLayerSet(layers)
|
|
|
|
|
|
|
|
via_array = PA.EPADGridArray(via, epad_ny, epad_nx, epad_l, epad_w, pcbnew.wxPoint(0,0) )
|
|
|
|
via_array.SetFirstPadInArray(epad_num)
|
|
|
|
via_array.AddPadsToModule(self.draw)
|
|
|
|
|
|
|
|
# Draw the package outline on the F.Fab layer
|
|
|
|
bevel = min( pcbnew.FromMM(1.0), self.package['width']/2, self.package['height']/2 )
|
|
|
|
|
|
|
|
self.draw.SetLayer(pcbnew.F_Fab)
|
|
|
|
|
|
|
|
w = self.package['width']
|
|
|
|
h = self.package['height']
|
|
|
|
|
|
|
|
self.draw.BoxWithDiagonalAtCorner(0, 0, w, h, bevel)
|
|
|
|
|
|
|
|
# Silkscreen
|
2018-12-10 11:13:12 +00:00
|
|
|
self.draw.SetLayer( pcbnew.F_SilkS )
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
offset = self.draw.GetLineThickness()
|
|
|
|
clip = row_len / 2 + self.pads['pitch']
|
|
|
|
|
2018-12-10 11:13:12 +00:00
|
|
|
self.draw.SetLineThickness( pcbnew.FromMM( 0.12 ) ) #Default per KLC F5.1 as of 12/2018
|
2017-01-03 15:01:47 +00:00
|
|
|
self.draw.Polyline( [ [ clip, -h/2-offset], [ w/2+offset,-h/2-offset], [ w/2+offset, -clip] ] ) # top right
|
|
|
|
self.draw.Polyline( [ [ clip, h/2+offset], [ w/2+offset, h/2+offset], [ w/2+offset, clip] ] ) # bottom right
|
|
|
|
self.draw.Polyline( [ [-clip, h/2+offset], [-w/2-offset, h/2+offset], [-w/2-offset, clip] ] ) # bottom left
|
|
|
|
|
|
|
|
# Add pin-1 indication as per IPC-7351C
|
2018-12-10 11:13:12 +00:00
|
|
|
self.draw.Line( -clip, -h/2-offset, -w/2-pad_length/2, -h/2-offset )
|
|
|
|
self.draw.SetLineThickness( offset ) #Restore default
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
# Courtyard
|
2017-01-03 15:01:47 +00:00
|
|
|
cmargin = self.package["margin"]
|
2016-02-24 08:48:55 +00:00
|
|
|
self.draw.SetLayer(pcbnew.F_CrtYd)
|
2017-01-03 15:01:47 +00:00
|
|
|
|
|
|
|
sizex = (lim_x + cmargin) * 2 + pad_length
|
|
|
|
sizey = (lim_y + cmargin) * 2 + pad_length
|
|
|
|
|
2016-02-24 08:48:55 +00:00
|
|
|
# round size to nearest 0.1mm, rectangle will thus land on a 0.05mm grid
|
2017-01-03 15:01:47 +00:00
|
|
|
sizex = pcbnew.PutOnGridMM(sizex, 0.1)
|
|
|
|
sizey = pcbnew.PutOnGridMM(sizey, 0.1)
|
2016-02-24 08:48:55 +00:00
|
|
|
# set courtyard line thickness to the one defined in KLC
|
|
|
|
thick = self.draw.GetLineThickness()
|
|
|
|
self.draw.SetLineThickness(pcbnew.FromMM(0.05))
|
|
|
|
self.draw.Box(0, 0, sizex, sizey)
|
|
|
|
# restore line thickness to previous value
|
|
|
|
self.draw.SetLineThickness(pcbnew.FromMM(thick))
|
|
|
|
|
|
|
|
#reference and value
|
|
|
|
text_size = self.GetTextSize() # IPC nominal
|
2018-12-10 11:13:12 +00:00
|
|
|
text_offset = sizey / 2 + text_size
|
2016-02-24 08:48:55 +00:00
|
|
|
|
|
|
|
self.draw.Value(0, text_offset, text_size)
|
|
|
|
self.draw.Reference(0, -text_offset, text_size)
|
|
|
|
|
|
|
|
# set SMD attribute
|
|
|
|
self.module.SetAttributes(pcbnew.MOD_CMS)
|
|
|
|
|
|
|
|
QFNWizard().register()
|
|
|
|
|
|
|
|
|