/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2017 Jean_Pierre Charras * Copyright (C) 2015 SoftPLC Corporation, Dick Hollenbeck * Copyright (C) 1992-2020 KiCad Developers, see AUTHORS.txt for contributors. * * 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, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #include #include #include #include #include #include /* Helper function for sorting hole list. * Compare function used for sorting holes type type (plated then not plated) * then by increasing diameter value and X value */ static bool CmpHoleSorting( const HOLE_INFO& a, const HOLE_INFO& b ) { if( a.m_Hole_NotPlated != b.m_Hole_NotPlated ) return b.m_Hole_NotPlated; if( a.m_Hole_Diameter != b.m_Hole_Diameter ) return a.m_Hole_Diameter < b.m_Hole_Diameter; // At this point (same diameter), sort by X then Y position. if( a.m_Hole_Pos.x != b.m_Hole_Pos.x ) return a.m_Hole_Pos.x < b.m_Hole_Pos.x; return a.m_Hole_Pos.y < b.m_Hole_Pos.y; } void GENDRILL_WRITER_BASE::buildHolesList( DRILL_LAYER_PAIR aLayerPair, bool aGenerateNPTH_list ) { HOLE_INFO new_hole; m_holeListBuffer.clear(); m_toolListBuffer.clear(); wxASSERT( aLayerPair.first < aLayerPair.second ); // fix the caller // build hole list for vias if( ! aGenerateNPTH_list ) // vias are always plated ! { for( VIA* via = GetFirstVia( m_pcb->m_Track ); via; via = GetFirstVia( via->Next() ) ) { int hole_sz = via->GetDrillValue(); if( hole_sz == 0 ) // Should not occur. continue; new_hole.m_ItemParent = via; new_hole.m_Tool_Reference = -1; // Flag value for Not initialized new_hole.m_Hole_Orient = 0; new_hole.m_Hole_Diameter = hole_sz; new_hole.m_Hole_NotPlated = false; new_hole.m_Hole_Size.x = new_hole.m_Hole_Size.y = new_hole.m_Hole_Diameter; new_hole.m_Hole_Shape = 0; // hole shape: round new_hole.m_Hole_Pos = via->GetStart(); via->LayerPair( &new_hole.m_Hole_Top_Layer, &new_hole.m_Hole_Bottom_Layer ); // LayerPair() returns params with m_Hole_Bottom_Layer > m_Hole_Top_Layer // Remember: top layer = 0 and bottom layer = 31 for through hole vias // Any captured via should be from aLayerPair.first to aLayerPair.second exactly. if( new_hole.m_Hole_Top_Layer != aLayerPair.first || new_hole.m_Hole_Bottom_Layer != aLayerPair.second ) continue; m_holeListBuffer.push_back( new_hole ); } } if( aLayerPair == DRILL_LAYER_PAIR( F_Cu, B_Cu ) ) { // add holes for thru hole pads for( MODULE* module = m_pcb->m_Modules; module; module = module->Next() ) { for( auto& pad : module->Pads() ) { if( !m_merge_PTH_NPTH ) { if( !aGenerateNPTH_list && pad->GetAttribute() == PAD_ATTRIB_HOLE_NOT_PLATED ) continue; if( aGenerateNPTH_list && pad->GetAttribute() != PAD_ATTRIB_HOLE_NOT_PLATED ) continue; } if( pad->GetDrillSize().x == 0 ) continue; new_hole.m_ItemParent = pad; new_hole.m_Hole_NotPlated = (pad->GetAttribute() == PAD_ATTRIB_HOLE_NOT_PLATED); new_hole.m_Tool_Reference = -1; // Flag is: Not initialized new_hole.m_Hole_Orient = pad->GetOrientation(); new_hole.m_Hole_Shape = 0; // hole shape: round new_hole.m_Hole_Diameter = std::min( pad->GetDrillSize().x, pad->GetDrillSize().y ); new_hole.m_Hole_Size.x = new_hole.m_Hole_Size.y = new_hole.m_Hole_Diameter; if( pad->GetDrillShape() != PAD_DRILL_SHAPE_CIRCLE ) new_hole.m_Hole_Shape = 1; // oval flag set new_hole.m_Hole_Size = pad->GetDrillSize(); new_hole.m_Hole_Pos = pad->GetPosition(); // hole position new_hole.m_Hole_Bottom_Layer = B_Cu; new_hole.m_Hole_Top_Layer = F_Cu; // pad holes are through holes m_holeListBuffer.push_back( new_hole ); } } } // Sort holes per increasing diameter value (and for each dimater, by position) sort( m_holeListBuffer.begin(), m_holeListBuffer.end(), CmpHoleSorting ); // build the tool list int last_hole = -1; // Set to not initialized (this is a value not used // for m_holeListBuffer[ii].m_Hole_Diameter) bool last_notplated_opt = false; DRILL_TOOL new_tool( 0, false ); unsigned jj; for( unsigned ii = 0; ii < m_holeListBuffer.size(); ii++ ) { if( m_holeListBuffer[ii].m_Hole_Diameter != last_hole || m_holeListBuffer[ii].m_Hole_NotPlated != last_notplated_opt ) { new_tool.m_Diameter = m_holeListBuffer[ii].m_Hole_Diameter; new_tool.m_Hole_NotPlated = m_holeListBuffer[ii].m_Hole_NotPlated; m_toolListBuffer.push_back( new_tool ); last_hole = new_tool.m_Diameter; last_notplated_opt = new_tool.m_Hole_NotPlated; } jj = m_toolListBuffer.size(); if( jj == 0 ) continue; // Should not occurs m_holeListBuffer[ii].m_Tool_Reference = jj; // Tool value Initialized (value >= 1) m_toolListBuffer.back().m_TotalCount++; if( m_holeListBuffer[ii].m_Hole_Shape ) m_toolListBuffer.back().m_OvalCount++; } } std::vector GENDRILL_WRITER_BASE::getUniqueLayerPairs() const { wxASSERT( m_pcb ); static const KICAD_T interesting_stuff_to_collect[] = { PCB_VIA_T, EOT }; PCB_TYPE_COLLECTOR vias; vias.Collect( m_pcb, interesting_stuff_to_collect ); std::set< DRILL_LAYER_PAIR > unique; DRILL_LAYER_PAIR layer_pair; for( int i = 0; i < vias.GetCount(); ++i ) { VIA* v = (VIA*) vias[i]; v->LayerPair( &layer_pair.first, &layer_pair.second ); // only make note of blind buried. // thru hole is placed unconditionally as first in fetched list. if( layer_pair != DRILL_LAYER_PAIR( F_Cu, B_Cu ) ) { unique.insert( layer_pair ); } } std::vector ret; ret.push_back( DRILL_LAYER_PAIR( F_Cu, B_Cu ) ); // always first in returned list for( std::set< DRILL_LAYER_PAIR >::const_iterator it = unique.begin(); it != unique.end(); ++it ) ret.push_back( *it ); return ret; } const std::string GENDRILL_WRITER_BASE::layerName( PCB_LAYER_ID aLayer ) const { // Generic names here. switch( aLayer ) { case F_Cu: return "front"; case B_Cu: return "back"; default: return StrPrintf( "in%d", aLayer ); } } const std::string GENDRILL_WRITER_BASE::layerPairName( DRILL_LAYER_PAIR aPair ) const { std::string ret = layerName( aPair.first ); ret += '-'; ret += layerName( aPair.second ); return ret; } const wxString GENDRILL_WRITER_BASE::getDrillFileName( DRILL_LAYER_PAIR aPair, bool aNPTH, bool aMerge_PTH_NPTH ) const { wxASSERT( m_pcb ); wxString extend; if( aNPTH ) extend = "-NPTH"; else if( aPair == DRILL_LAYER_PAIR( F_Cu, B_Cu ) ) { if( !aMerge_PTH_NPTH ) extend = "-PTH"; // if merged, extend with nothing } else { extend += '-'; extend += layerPairName( aPair ); } wxFileName fn = m_pcb->GetFileName(); fn.SetName( fn.GetName() + extend ); fn.SetExt( m_drillFileExtension ); wxString ret = fn.GetFullName(); return ret; } void GENDRILL_WRITER_BASE::CreateMapFilesSet( const wxString& aPlotDirectory, REPORTER * aReporter ) { wxFileName fn; wxString msg; std::vector hole_sets = getUniqueLayerPairs(); // append a pair representing the NPTH set of holes, for separate drill files. if( !m_merge_PTH_NPTH ) hole_sets.push_back( DRILL_LAYER_PAIR( F_Cu, B_Cu ) ); for( std::vector::const_iterator it = hole_sets.begin(); it != hole_sets.end(); ++it ) { DRILL_LAYER_PAIR pair = *it; // For separate drill files, the last layer pair is the NPTH drill file. bool doing_npth = m_merge_PTH_NPTH ? false : ( it == hole_sets.end() - 1 ); buildHolesList( pair, doing_npth ); // The file is created if it has holes, or if it is the non plated drill file // to be sure the NPTH file is up to date in separate files mode. // Also a PTH drill file is always created, to be sure at least one plated hole drill file // is created (do not create any PTH drill file can be seen as not working drill generator). if( getHolesCount() > 0 || doing_npth || pair == DRILL_LAYER_PAIR( F_Cu, B_Cu ) ) { fn = getDrillFileName( pair, doing_npth, m_merge_PTH_NPTH ); fn.SetPath( aPlotDirectory ); fn.SetExt( wxEmptyString ); // Will be added by GenDrillMap wxString fullfilename = fn.GetFullPath() + wxT( "-drl_map" ); fullfilename << wxT(".") << GetDefaultPlotExtension( m_mapFileFmt ); bool success = genDrillMapFile( fullfilename, m_mapFileFmt ); if( ! success ) { if( aReporter ) { msg.Printf( _( "** Unable to create %s **\n" ), GetChars( fullfilename ) ); aReporter->Report( msg ); } return; } else { if( aReporter ) { msg.Printf( _( "Create file %s\n" ), GetChars( fullfilename ) ); aReporter->Report( msg ); } } } } } const wxString GENDRILL_WRITER_BASE::BuildFileFunctionAttributeString( DRILL_LAYER_PAIR aLayerPair, bool aIsNpth, bool aCompatNCdrill ) const { // Build a wxString containing the .FileFunction attribute for drill files. // %TF.FileFunction,Plated[NonPlated],layer1num,layer2num,PTH[NPTH][Blind][Buried],Drill[Route][Mixed]*% wxString text; if( aCompatNCdrill ) text = "; #@! "; else text = "%"; text << "TF.FileFunction,"; if( aIsNpth ) text << "NonPlated,"; else text << "Plated,"; int layer1 = aLayerPair.first; int layer2 = aLayerPair.second; // In Gerber files, layers num are 1 to copper layer count instead of F_Cu to B_Cu // (0 to copper layer count-1) // Note also for a n copper layers board, gerber layers num are 1 ... n layer1 += 1; if( layer2 == B_Cu ) layer2 = m_pcb->GetCopperLayerCount(); else layer2 += 1; text << layer1 << ","; text << layer2 << ","; // Now add PTH or NPTH or Blind or Buried attribute int toplayer = 1; int bottomlayer = m_pcb->GetCopperLayerCount(); if( aIsNpth ) text << "NPTH"; else if( layer1 == toplayer && layer2 == bottomlayer ) text << "PTH"; else if( layer1 == toplayer || layer2 == bottomlayer ) text << "Blind"; else text << "Buried"; // In NC drill file, these previous parameters should be enough: if( aCompatNCdrill ) return text; // Now add Drill or Route or Mixed: // file containing only round holes have Drill attribute // file containing only oblong holes have Routed attribute // file containing both holes have Mixed attribute bool hasOblong = false; bool hasDrill = false; for( unsigned ii = 0; ii < m_holeListBuffer.size(); ii++ ) { const HOLE_INFO& hole_descr = m_holeListBuffer[ii]; if( hole_descr.m_Hole_Shape ) // m_Hole_Shape not 0 is an oblong hole) hasOblong = true; else hasDrill = true; } if( hasOblong && hasDrill ) text << ",Mixed"; else if( hasDrill ) text << ",Drill"; else if( hasOblong ) text << ",Route"; // else: empty file. // End of .FileFunction attribute: text << "*%"; return text; }