/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2004-2022 KiCad Developers. * * 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 #include #include #include /* Drilled hole size test. scans vias/through-hole pads and checks for min drill sizes Errors generated: - DRCE_DRILL_OUT_OF_RANGE - DRCE_MICROVIA_DRILL_OUT_OF_RANGE - DRCE_PADSTACK */ class DRC_TEST_PROVIDER_HOLE_SIZE : public DRC_TEST_PROVIDER { public: DRC_TEST_PROVIDER_HOLE_SIZE() { } virtual ~DRC_TEST_PROVIDER_HOLE_SIZE() { } virtual bool Run() override; virtual const wxString GetName() const override { return wxT( "hole_size" ); }; virtual const wxString GetDescription() const override { return wxT( "Tests sizes of drilled holes (via/pad drills)" ); } private: void checkViaHole( PCB_VIA* via, bool aExceedMicro, bool aExceedStd ); void checkPadHole( PAD* aPad ); }; bool DRC_TEST_PROVIDER_HOLE_SIZE::Run() { if( !m_drcEngine->IsErrorLimitExceeded( DRCE_DRILL_OUT_OF_RANGE ) ) { if( !reportPhase( _( "Checking pad holes..." ) ) ) return false; // DRC cancelled for( FOOTPRINT* footprint : m_drcEngine->GetBoard()->Footprints() ) { for( PAD* pad : footprint->Pads() ) { if( !m_drcEngine->IsErrorLimitExceeded( DRCE_DRILL_OUT_OF_RANGE ) ) checkPadHole( pad ); } } } for( FOOTPRINT* footprint : m_drcEngine->GetBoard()->Footprints() ) { footprint->CheckPads( [&]( const PAD* pad, int errorCode, const wxString& msg ) { if( m_drcEngine->IsErrorLimitExceeded( errorCode ) ) return; std::shared_ptr drcItem = DRC_ITEM::Create( errorCode ); if( !msg.IsEmpty() ) drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + msg ); drcItem->SetItems( pad ); reportViolation( drcItem, pad->GetPosition(), UNDEFINED_LAYER ); } ); } if( !m_drcEngine->IsErrorLimitExceeded( DRCE_MICROVIA_DRILL_OUT_OF_RANGE ) || !m_drcEngine->IsErrorLimitExceeded( DRCE_DRILL_OUT_OF_RANGE ) ) { if( !m_drcEngine->IsErrorLimitExceeded( DRCE_DRILL_OUT_OF_RANGE ) ) { if( !reportPhase( _( "Checking via holes..." ) ) ) return false; // DRC cancelled } else { if( !reportPhase( _( "Checking micro-via holes..." ) ) ) return false; // DRC cancelled } for( PCB_TRACK* track : m_drcEngine->GetBoard()->Tracks() ) { if( track->Type() == PCB_VIA_T ) { bool exceedMicro = m_drcEngine->IsErrorLimitExceeded( DRCE_MICROVIA_DRILL_OUT_OF_RANGE ); bool exceedStd = m_drcEngine->IsErrorLimitExceeded( DRCE_DRILL_OUT_OF_RANGE ); if( exceedMicro && exceedStd ) break; checkViaHole( static_cast( track ), exceedMicro, exceedStd ); } } } reportRuleStatistics(); return !m_drcEngine->IsCancelled(); } void DRC_TEST_PROVIDER_HOLE_SIZE::checkPadHole( PAD* aPad ) { int holeMinor = std::min( aPad->GetDrillSize().x, aPad->GetDrillSize().y ); int holeMajor = std::max( aPad->GetDrillSize().x, aPad->GetDrillSize().y ); if( holeMinor == 0 ) return; auto constraint = m_drcEngine->EvalRules( HOLE_SIZE_CONSTRAINT, aPad, nullptr, UNDEFINED_LAYER /* holes are not layer-specific */ ); bool fail_min = false; bool fail_max = false; int constraintValue; if( constraint.GetSeverity() == RPT_SEVERITY_IGNORE ) return; if( constraint.Value().HasMin() && holeMinor < constraint.Value().Min() ) { fail_min = true; constraintValue = constraint.Value().Min(); } if( constraint.Value().HasMax() && holeMajor > constraint.Value().Max() ) { fail_max = true; constraintValue = constraint.Value().Max(); } if( fail_min || fail_max ) { std::shared_ptr drcItem = DRC_ITEM::Create( DRCE_DRILL_OUT_OF_RANGE ); wxString msg; if( fail_min ) { msg.Printf( _( "(%s min width %s; actual %s)" ), constraint.GetName(), MessageTextFromValue( userUnits(), constraintValue ), MessageTextFromValue( userUnits(), holeMinor ) ); } else { msg.Printf( _( "(%s max width %s; actual %s)" ), constraint.GetName(), MessageTextFromValue( userUnits(), constraintValue ), MessageTextFromValue( userUnits(), holeMajor ) ); } drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + msg ); drcItem->SetItems( aPad ); drcItem->SetViolatingRule( constraint.GetParentRule() ); reportViolation( drcItem, aPad->GetPosition(), UNDEFINED_LAYER ); } } void DRC_TEST_PROVIDER_HOLE_SIZE::checkViaHole( PCB_VIA* via, bool aExceedMicro, bool aExceedStd ) { int errorCode; if( via->GetViaType() == VIATYPE::MICROVIA ) { if( aExceedMicro ) return; errorCode = DRCE_MICROVIA_DRILL_OUT_OF_RANGE; } else { if( aExceedStd ) return; errorCode = DRCE_DRILL_OUT_OF_RANGE; } auto constraint = m_drcEngine->EvalRules( HOLE_SIZE_CONSTRAINT, via, nullptr, UNDEFINED_LAYER /* holes are not layer-specific */ ); bool fail_min = false; bool fail_max = false; int constraintValue; if( constraint.GetSeverity() == RPT_SEVERITY_IGNORE ) return; if( constraint.Value().HasMin() && via->GetDrillValue() < constraint.Value().Min() ) { fail_min = true; constraintValue = constraint.Value().Min(); } if( constraint.Value().HasMax() && via->GetDrillValue() > constraint.Value().Max() ) { fail_max = true; constraintValue = constraint.Value().Max(); } if( fail_min || fail_max ) { std::shared_ptr drcItem = DRC_ITEM::Create( errorCode ); wxString msg; if( fail_min ) { msg.Printf( _( "(%s min width %s; actual %s)" ), constraint.GetName(), MessageTextFromValue( userUnits(), constraintValue ), MessageTextFromValue( userUnits(), via->GetDrillValue() ) ); } else { msg.Printf( _( "(%s max width %s; actual %s)" ), constraint.GetName(), MessageTextFromValue( userUnits(), constraintValue ), MessageTextFromValue( userUnits(), via->GetDrillValue() ) ); } drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + msg ); drcItem->SetItems( via ); drcItem->SetViolatingRule( constraint.GetParentRule() ); reportViolation( drcItem, via->GetPosition(), UNDEFINED_LAYER ); } } namespace detail { static DRC_REGISTER_TEST_PROVIDER dummy; }