/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2004-2020 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 /* Miscellaneous tests: - DRCE_DISABLED_LAYER_ITEM, ///< item on a disabled layer - DRCE_INVALID_OUTLINE, ///< invalid board outline - DRCE_UNRESOLVED_VARIABLE, TODO: - if grows too big, split into separate providers */ class DRC_TEST_PROVIDER_MISC : public DRC_TEST_PROVIDER { public: DRC_TEST_PROVIDER_MISC() : m_board( nullptr ) { m_isRuleDriven = false; } virtual ~DRC_TEST_PROVIDER_MISC() { } virtual bool Run() override; virtual const wxString GetName() const override { return "miscellaneous"; }; virtual const wxString GetDescription() const override { return "Misc checks (board outline, missing textvars)"; } virtual std::set GetConstraintTypes() const override; int GetNumPhases() const override; private: void testOutline(); void testDisabledLayers(); void testTextVars(); BOARD* m_board; }; void DRC_TEST_PROVIDER_MISC::testOutline() { SHAPE_POLY_SET dummyOutline; bool errorHandled = false; OUTLINE_ERROR_HANDLER errorHandler = [&]( const wxString& msg, BOARD_ITEM* itemA, BOARD_ITEM* itemB, const wxPoint& pt ) { std::shared_ptr drcItem = DRC_ITEM::Create( DRCE_INVALID_OUTLINE ); drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + msg ); drcItem->SetItems( itemA, itemB ); reportViolation( drcItem, pt ); errorHandled = true; }; // Use a really tight chaining epsilon here so that we report errors that might affect // other tools (such as STEP export). constexpr int chainingEpsilon = Millimeter2iu( 0.02 ) / 100; if( !BuildBoardPolygonOutlines( m_board, dummyOutline, m_board->GetDesignSettings().m_MaxError, chainingEpsilon, &errorHandler ) ) { if( errorHandled ) { // if there is an invalid outline, then there must be an outline } else { std::shared_ptr drcItem = DRC_ITEM::Create( DRCE_INVALID_OUTLINE ); m_msg.Printf( _( "(no edges found on Edge.Cuts layer)" ) ); drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + m_msg ); drcItem->SetItems( m_board ); reportViolation( drcItem, m_board->GetBoundingBox().Centre() ); } } } void DRC_TEST_PROVIDER_MISC::testDisabledLayers() { LSET disabledLayers = m_board->GetEnabledLayers().flip(); // Perform the test only for copper layers disabledLayers &= LSET::AllCuMask(); auto checkDisabledLayers = [&]( BOARD_ITEM* item ) -> bool { LSET refLayers ( item->GetLayer() ); if( ( disabledLayers & refLayers ).any() ) { std::shared_ptrdrcItem = DRC_ITEM::Create( DRCE_DISABLED_LAYER_ITEM ); m_msg.Printf( _( "(layer %s)" ), item->GetLayerName() ); drcItem->SetErrorMessage( drcItem->GetErrorText() + wxS( " " ) + m_msg ); drcItem->SetItems( item ); reportViolation( drcItem, item->GetPosition() ); } return true; }; // fixme: what about graphical items? forEachGeometryItem( { PCB_TRACE_T, PCB_ARC_T, PCB_VIA_T, PCB_ZONE_T, PCB_PAD_T }, LSET::AllLayersMask(), checkDisabledLayers ); } void DRC_TEST_PROVIDER_MISC::testTextVars() { auto checkUnresolvedTextVar = [&]( EDA_ITEM* item ) -> bool { if( m_drcEngine->IsErrorLimitExceeded( DRCE_UNRESOLVED_VARIABLE ) ) return false; EDA_TEXT* text = dynamic_cast( item ); if( text && text->GetShownText().Matches( wxT( "*${*}*" ) ) ) { std::shared_ptrdrcItem = DRC_ITEM::Create( DRCE_UNRESOLVED_VARIABLE ); drcItem->SetItems( item ); reportViolation( drcItem, item->GetPosition() ); } return true; }; forEachGeometryItem( { PCB_FP_TEXT_T, PCB_TEXT_T }, LSET::AllLayersMask(), checkUnresolvedTextVar ); DS_PROXY_VIEW_ITEM* drawingSheet = m_drcEngine->GetDrawingSheet(); DS_DRAW_ITEM_LIST drawItems; if( !drawingSheet || m_drcEngine->IsErrorLimitExceeded( DRCE_UNRESOLVED_VARIABLE ) ) return; drawItems.SetMilsToIUfactor( IU_PER_MILS ); drawItems.SetPageNumber( "1" ); drawItems.SetSheetCount( 1 ); drawItems.SetFileName( "dummyFilename" ); drawItems.SetSheetName( "dummySheet" ); drawItems.SetSheetLayer( "dummyLayer" ); drawItems.SetProject( m_board->GetProject() ); drawItems.BuildDrawItemsList( drawingSheet->GetPageInfo(), drawingSheet->GetTitleBlock() ); for( DS_DRAW_ITEM_BASE* item = drawItems.GetFirst(); item; item = drawItems.GetNext() ) { if( m_drcEngine->IsErrorLimitExceeded( DRCE_UNRESOLVED_VARIABLE ) ) break; DS_DRAW_ITEM_TEXT* text = dynamic_cast( item ); if( text && text->GetShownText().Matches( wxT( "*${*}*" ) ) ) { std::shared_ptr drcItem = DRC_ITEM::Create( DRCE_UNRESOLVED_VARIABLE ); drcItem->SetItems( text ); reportViolation( drcItem, text->GetPosition() ); } } } bool DRC_TEST_PROVIDER_MISC::Run() { m_board = m_drcEngine->GetBoard(); if( !m_drcEngine->IsErrorLimitExceeded( DRCE_INVALID_OUTLINE ) ) { if( !reportPhase( _( "Checking board outline..." ) ) ) return false; // DRC cancelled testOutline(); } if( !m_drcEngine->IsErrorLimitExceeded( DRCE_DISABLED_LAYER_ITEM ) ) { if( !reportPhase( _( "Checking disabled layers..." ) ) ) return false; // DRC cancelled testDisabledLayers(); } if( !m_drcEngine->IsErrorLimitExceeded( DRCE_UNRESOLVED_VARIABLE ) ) { if( !reportPhase( _( "Checking text variables..." ) ) ) return false; // DRC cancelled testTextVars(); } return true; } int DRC_TEST_PROVIDER_MISC::GetNumPhases() const { return 3; } std::set DRC_TEST_PROVIDER_MISC::GetConstraintTypes() const { return {}; } namespace detail { static DRC_REGISTER_TEST_PROVIDER dummy; }