#! /usr/bin/env python # -*- coding: utf-8 -*- # copyright 2014 Hamilton Kibbe # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import os import re from collections import namedtuple from .excellon import ExcellonFile from .ipc356 import IPCNetlist Hint = namedtuple('Hint', 'layer ext name regex content') hints = [ Hint(layer='top', ext=['gtl', 'cmp', 'top', ], name=['art01', 'top', 'GTL', 'layer1', 'soldcom', 'comp', 'F.Cu', ], regex='', content=[] ), Hint(layer='bottom', ext=['gbl', 'sld', 'bot', 'sol', 'bottom', ], name=['art02', 'bottom', 'bot', 'GBL', 'layer2', 'soldsold', 'B.Cu', ], regex='', content=[] ), Hint(layer='internal', ext=['in', 'gt1', 'gt2', 'gt3', 'gt4', 'gt5', 'gt6', 'g1', 'g2', 'g3', 'g4', 'g5', 'g6', ], name=['art', 'internal', 'pgp', 'pwr', 'gnd', 'ground', 'gp1', 'gp2', 'gp3', 'gp4', 'gt5', 'gp6', 'In1.Cu', 'In2.Cu', 'In3.Cu', 'In4.Cu', 'group3', 'group4', 'group5', 'group6', 'group7', 'group8', 'copper_top_l1', 'copper_inner_l2', 'copper_inner_l3', 'copper_bottom_l4', ], regex='', content=[] ), Hint(layer='topsilk', ext=['gto', 'sst', 'plc', 'ts', 'skt', 'topsilk'], name=['sst01', 'topsilk', 'silk', 'slk', 'sst', 'F.SilkS', 'silkscreen_top'], regex='', content=[] ), Hint(layer='bottomsilk', ext=['gbo', 'ssb', 'pls', 'bs', 'skb', 'bottomsilk'], name=['bsilk', 'ssb', 'botsilk', 'bottomsilk', 'B.SilkS', 'silkscreen_bottom'], regex='', content=[] ), Hint(layer='topmask', ext=['gts', 'stc', 'tmk', 'smt', 'tr', 'topmask', ], name=['sm01', 'cmask', 'tmask', 'mask1', 'maskcom', 'topmask', 'mst', 'F.Mask', 'soldermask_top'], regex='', content=[] ), Hint(layer='bottommask', ext=['gbs', 'sts', 'bmk', 'smb', 'br', 'bottommask', ], name=['sm', 'bmask', 'mask2', 'masksold', 'botmask', 'bottommask', 'msb', 'B.Mask', 'soldermask_bottom'], regex='', content=[] ), Hint(layer='toppaste', ext=['gtp', 'tm', 'toppaste', ], name=['sp01', 'toppaste', 'pst', 'F.Paste', 'solderpaste_top'], regex='', content=[] ), Hint(layer='bottompaste', ext=['gbp', 'bm', 'bottompaste', ], name=['sp02', 'botpaste', 'bottompaste', 'psb', 'B.Paste', 'solderpaste_bottom'], regex='', content=[] ), Hint(layer='outline', ext=['gko', 'outline', ], name=['BDR', 'border', 'out', 'outline', 'Edge.Cuts', 'profile'], regex='', content=[] ), Hint(layer='ipc_netlist', ext=['ipc'], name=[], regex='', content=[] ), Hint(layer='drawing', ext=['fab'], name=['assembly drawing', 'assembly', 'fabrication', 'fab drawing', 'fab'], regex='', content=[] ), ] def layer_signatures(layer_class): for hint in hints: if hint.layer == layer_class: return hint.ext + hint.name return [] def load_layer(filename): return PCBLayer.from_cam(common.read(filename)) def load_layer_data(data, filename=None): return PCBLayer.from_cam(common.loads(data, filename)) def guess_layer_class(filename): try: layer = guess_layer_class_by_content(filename) if layer: return layer except: pass try: directory, filename = os.path.split(filename) name, ext = os.path.splitext(filename.lower()) for hint in hints: if hint.regex: if re.findall(hint.regex, filename, re.IGNORECASE): return hint.layer patterns = [r'^(\w*[.-])*{}([.-]\w*)?$'.format(x) for x in hint.name] if ext[1:] in hint.ext or any(re.findall(p, name, re.IGNORECASE) for p in patterns): return hint.layer except: pass return 'unknown' def guess_layer_class_by_content(filename): try: file = open(filename, 'r') for line in file: for hint in hints: if len(hint.content) > 0: patterns = [r'^(.*){}(.*)$'.format(x) for x in hint.content] if any(re.findall(p, line, re.IGNORECASE) for p in patterns): return hint.layer except: pass return False def sort_layers(layers, from_top=True): layer_order = ['outline', 'toppaste', 'topsilk', 'topmask', 'top', 'internal', 'bottom', 'bottommask', 'bottomsilk', 'bottompaste'] append_after = ['drill', 'drawing'] output = [] drill_layers = [layer for layer in layers if layer.layer_class == 'drill'] internal_layers = list(sorted([layer for layer in layers if layer.layer_class == 'internal'])) for layer_class in layer_order: if layer_class == 'internal': output += internal_layers elif layer_class == 'drill': output += drill_layers else: for layer in layers: if layer.layer_class == layer_class: output.append(layer) if not from_top: output = list(reversed(output)) for layer_class in append_after: for layer in layers: if layer.layer_class == layer_class: output.append(layer) return output class PCBLayer(object): """ Base class for PCB Layers Parameters ---------- source : CAMFile CAMFile representing the layer Attributes ---------- filename : string Source Filename """ @classmethod def from_cam(cls, camfile): filename = camfile.filename layer_class = guess_layer_class(filename) if isinstance(camfile, ExcellonFile) or (layer_class == 'drill'): return DrillLayer.from_cam(camfile) elif layer_class == 'internal': return InternalLayer.from_cam(camfile) if isinstance(camfile, IPCNetlist): layer_class = 'ipc_netlist' return cls(filename, layer_class, camfile) def __init__(self, filename=None, layer_class=None, cam_source=None, **kwargs): super(PCBLayer, self).__init__(**kwargs) self.filename = filename self.layer_class = layer_class self.cam_source = cam_source self.surface = None self.primitives = cam_source.primitives if cam_source is not None else [] @property def bounds(self): if self.cam_source is not None: return self.cam_source.bounds else: return None def __repr__(self): return ''.format(self.layer_class) class DrillLayer(PCBLayer): @classmethod def from_cam(cls, camfile): return cls(camfile.filename, camfile) def __init__(self, filename=None, cam_source=None, layers=None, **kwargs): super(DrillLayer, self).__init__(filename, 'drill', cam_source, **kwargs) self.layers = layers if layers is not None else ['top', 'bottom'] class InternalLayer(PCBLayer): @classmethod def from_cam(cls, camfile): filename = camfile.filename try: order = int(re.search(r'\d+', filename).group()) except AttributeError: order = 0 return cls(filename, camfile, order) def __init__(self, filename=None, cam_source=None, order=0, **kwargs): super(InternalLayer, self).__init__(filename, 'internal', cam_source, **kwargs) self.order = order def __eq__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order == other.order) def __ne__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order != other.order) def __gt__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order > other.order) def __lt__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order < other.order) def __ge__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order >= other.order) def __le__(self, other): if not hasattr(other, 'order'): raise TypeError() return (self.order <= other.order) class PCB: @classmethod def from_directory(cls, directory, board_name=None, verbose=False): layers = [] names = set() # Validate directory = os.path.abspath(directory) if not os.path.isdir(directory): raise TypeError('{} is not a directory.'.format(directory)) # Load gerber files for filename in os.listdir(directory): try: camfile = gerber_read(os.path.join(directory, filename)) layer = PCBLayer.from_cam(camfile) layers.append(layer) name = os.path.splitext(filename)[0] if len(os.path.splitext(filename)) > 1: _name, ext = os.path.splitext(name) if ext[1:] in layer_signatures(layer.layer_class): name = _name if layer.layer_class == 'drill' and 'drill' in ext: name = _name names.add(name) if verbose: print('[PCB]: Added {} layer <{}>'.format(layer.layer_class, filename)) except ParseError: if verbose: print('[PCB]: Skipping file {}'.format(filename)) except IOError: if verbose: print('[PCB]: Skipping file {}'.format(filename)) # Try to guess board name if board_name is None: if len(names) == 1: board_name = names.pop() else: board_name = os.path.basename(directory) # Return PCB return cls(layers, board_name) def __init__(self, layers, name=None): self.layers = sort_layers(layers) self.name = name def __len__(self): return len(self.layers) @property def top_layers(self): board_layers = [l for l in reversed(self.layers) if l.layer_class in ('topsilk', 'topmask', 'top')] drill_layers = [l for l in self.drill_layers if 'top' in l.layers] # Drill layer goes under soldermask for proper rendering of tented vias return [board_layers[0]] + drill_layers + board_layers[1:] @property def bottom_layers(self): board_layers = [l for l in self.layers if l.layer_class in ('bottomsilk', 'bottommask', 'bottom')] drill_layers = [l for l in self.drill_layers if 'bottom' in l.layers] # Drill layer goes under soldermask for proper rendering of tented vias return [board_layers[0]] + drill_layers + board_layers[1:] @property def drill_layers(self): return [l for l in self.layers if l.layer_class == 'drill'] @property def copper_layers(self): return list(reversed([layer for layer in self.layers if layer.layer_class in ('top', 'bottom', 'internal')])) @property def outline_layer(self): for layer in self.layers: if layer.layer_class == 'outline': return layer @property def layer_count(self): """ Number of *COPPER* layers """ return len([l for l in self.layers if l.layer_class in ('top', 'bottom', 'internal')]) @property def board_bounds(self): for layer in self.layers: if layer.layer_class == 'outline': return layer.bounding_box for layer in self.layers: if layer.layer_class == 'top': return layer.bounding_box