/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2019-2021 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 #include #include #include #include #include #include #include #include "board_inspection_tool.h" #include #include #include #include BOARD_INSPECTION_TOOL::BOARD_INSPECTION_TOOL() : PCB_TOOL_BASE( "pcbnew.InspectionTool" ), m_frame( nullptr ) { m_probingSchToPcb = false; m_dynamicData = nullptr; } class NET_CONTEXT_MENU : public ACTION_MENU { public: NET_CONTEXT_MENU() : ACTION_MENU( true ) { SetIcon( BITMAPS::show_ratsnest ); SetTitle( _( "Net Tools" ) ); Add( PCB_ACTIONS::showNet ); Add( PCB_ACTIONS::hideNet ); Add( PCB_ACTIONS::highlightNetSelection ); Add( PCB_ACTIONS::clearHighlight ); } private: ACTION_MENU* create() const override { return new NET_CONTEXT_MENU(); } }; bool BOARD_INSPECTION_TOOL::Init() { PCB_SELECTION_TOOL* selectionTool = m_toolMgr->GetTool(); auto netSubMenu = std::make_shared(); netSubMenu->SetTool( this ); static KICAD_T connectedTypes[] = { PCB_TRACE_T, PCB_VIA_T, PCB_ARC_T, PCB_PAD_T, PCB_ZONE_T, EOT }; CONDITIONAL_MENU& menu = selectionTool->GetToolMenu().GetMenu(); selectionTool->GetToolMenu().AddSubMenu( netSubMenu ); menu.AddMenu( netSubMenu.get(), SELECTION_CONDITIONS::OnlyTypes( connectedTypes ), 200 ); menu.AddItem( PCB_ACTIONS::inspectClearance, SELECTION_CONDITIONS::Count( 2 ), 200 ); return true; } void BOARD_INSPECTION_TOOL::Reset( RESET_REASON aReason ) { m_frame = getEditFrame(); } int BOARD_INSPECTION_TOOL::ShowStatisticsDialog( const TOOL_EVENT& aEvent ) { DIALOG_BOARD_STATISTICS dialog( m_frame ); dialog.ShowModal(); return 0; } wxString BOARD_INSPECTION_TOOL::getItemDescription( BOARD_ITEM* aItem ) { // Null items have no description if( !aItem ) return wxString(); wxString s = aItem->GetSelectMenuText( m_frame->GetUserUnits() ); if( aItem->IsConnected() ) { BOARD_CONNECTED_ITEM* cItem = static_cast( aItem ); s += wxS( " " ) + wxString::Format( _( "[netclass %s]" ), cItem->GetNetClass()->GetName() ); } return s; }; void reportCompileError( REPORTER* r ) { r->Report( "" ); r->Report( _( "Report incomplete: could not compile custom design rules. " ) + wxT( "" ) + _( "Show design rules." ) + wxT( "" ) ); } void BOARD_INSPECTION_TOOL::reportClearance( DRC_CONSTRAINT_T aClearanceType, PCB_LAYER_ID aLayer, BOARD_ITEM* aA, BOARD_ITEM* aB, REPORTER* r ) { r->Report( "" ); DRC_ENGINE drcEngine( m_frame->GetBoard(), &m_frame->GetBoard()->GetDesignSettings() ); try { drcEngine.InitEngine( m_frame->GetDesignRulesPath() ); } catch( PARSE_ERROR& ) { reportCompileError( r ); return; } for( ZONE* zone : m_frame->GetBoard()->Zones() ) zone->CacheBoundingBox(); for( FOOTPRINT* footprint : m_frame->GetBoard()->Footprints() ) { for( ZONE* zone : footprint->Zones() ) zone->CacheBoundingBox(); footprint->BuildPolyCourtyards(); } DRC_CONSTRAINT constraint = drcEngine.EvalRules( aClearanceType, aA, aB, aLayer, r ); int clearance = constraint.m_Value.Min(); wxString clearanceStr = StringFromValue( r->GetUnits(), clearance, true ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), clearanceStr ) ); } void BOARD_INSPECTION_TOOL::InspectDRCError( const std::shared_ptr& aDRCItem ) { BOARD_ITEM* a = m_frame->GetBoard()->GetItem( aDRCItem->GetMainItemID() ); BOARD_ITEM* b = m_frame->GetBoard()->GetItem( aDRCItem->GetAuxItemID() ); PCB_LAYER_ID layer = m_frame->GetActiveLayer(); if( !a || !b ) return; if( m_inspectClearanceDialog == nullptr ) { m_inspectClearanceDialog = std::make_unique( m_frame ); m_inspectClearanceDialog->SetTitle( _( "Clearance Report" ) ); m_inspectClearanceDialog->Connect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onInspectClearanceDialogClosed ), nullptr, this ); } WX_HTML_REPORT_BOX* r = m_inspectClearanceDialog->AddPage( _( "Clearance" ) ); switch( aDRCItem->GetErrorCode() ) { case DRCE_EDGE_CLEARANCE: r->Report( wxT( "" ) + _( "Edge clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s
  • %s
" ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); reportClearance( EDGE_CLEARANCE_CONSTRAINT, layer, a, b, r ); break; case DRCE_CLEARANCE: if( a->Type() == PCB_TRACE_T || a->Type() == PCB_ARC_T ) { layer = a->GetLayer(); } else if( b->Type() == PCB_TRACE_T || b->Type() == PCB_ARC_T ) { layer = b->GetLayer(); } else if( a->Type() == PCB_PAD_T && static_cast( a )->GetAttribute() == PAD_ATTRIB::SMD ) { PAD* pad = static_cast( a ); if( pad->IsOnLayer( F_Cu ) ) layer = F_Cu; else layer = B_Cu; } else if( b->Type() == PCB_PAD_T && static_cast( a )->GetAttribute() == PAD_ATTRIB::SMD ) { PAD* pad = static_cast( b ); if( pad->IsOnLayer( F_Cu ) ) layer = F_Cu; else layer = B_Cu; } r->Report( wxT( "" ) + _( "Clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); reportClearance( CLEARANCE_CONSTRAINT, layer, a, b, r ); break; default: return; } r->Flush(); m_inspectClearanceDialog->Raise(); m_inspectClearanceDialog->Show( true ); } int BOARD_INSPECTION_TOOL::InspectClearance( const TOOL_EVENT& aEvent ) { PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool(); const PCB_SELECTION& selection = selTool->GetSelection(); if( selection.Size() != 2 ) { m_frame->ShowInfoBarError( _( "Select two items for a clearance resolution report." ) ); return 0; } BOARD_ITEM* a = static_cast( selection.GetItem( 0 ) ); BOARD_ITEM* b = static_cast( selection.GetItem( 1 ) ); wxCHECK( a && b, 0 ); if( a->Type() == PCB_GROUP_T ) { PCB_GROUP* ag = static_cast( a ); if( ag->GetItems().empty() ) { m_frame->ShowInfoBarError( _( "Cannot generate clearance report on empty group." ) ); return 0; } a = *ag->GetItems().begin(); } if( b->Type() == PCB_GROUP_T ) { PCB_GROUP* bg = static_cast( b ); if( bg->GetItems().empty() ) { m_frame->ShowInfoBarError( _( "Cannot generate clearance report on empty group." ) ); return 0; } b = *bg->GetItems().begin(); } // a and b could be null after group tests above. wxCHECK( a && b, 0 ); if( m_inspectClearanceDialog == nullptr ) { m_inspectClearanceDialog = std::make_unique( m_frame ); m_inspectClearanceDialog->SetTitle( _( "Clearance Report" ) ); m_inspectClearanceDialog->Connect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onInspectClearanceDialogClosed ), nullptr, this ); } WX_HTML_REPORT_BOX* r = nullptr; EDA_UNITS units = m_frame->GetUserUnits(); m_inspectClearanceDialog->DeleteAllPages(); if( a->Type() != PCB_ZONE_T && b->Type() == PCB_ZONE_T ) std::swap( a, b ); else if( !a->IsConnected() && b->IsConnected() ) std::swap( a, b ); PCB_LAYER_ID active = m_frame->GetActiveLayer(); LSET layerIntersection = a->GetLayerSet() & b->GetLayerSet(); LSET copperIntersection = layerIntersection & LSET::AllCuMask(); BOARD_CONNECTED_ITEM* ac = dynamic_cast( a ); BOARD_CONNECTED_ITEM* bc = dynamic_cast( b ); ZONE* zone = dynamic_cast( a ); PAD* pad = dynamic_cast( b ); FOOTPRINT* aFP = dynamic_cast( a ); FOOTPRINT* bFP = dynamic_cast( b ); DRC_ENGINE drcEngine( m_frame->GetBoard(), &m_frame->GetBoard()->GetDesignSettings() ); bool compileError = false; DRC_CONSTRAINT constraint; int clearance = 0; try { drcEngine.InitEngine( m_frame->GetDesignRulesPath() ); } catch( PARSE_ERROR& ) { compileError = true; } for( ZONE* z : m_frame->GetBoard()->Zones() ) z->CacheBoundingBox(); for( FOOTPRINT* f : m_frame->GetBoard()->Footprints() ) { for( ZONE* z : f->Zones() ) z->CacheBoundingBox(); f->BuildPolyCourtyards(); } auto hasHole = []( BOARD_ITEM* aItem ) { PAD* tmpPad = dynamic_cast( aItem ); if( tmpPad && tmpPad->GetDrillSizeX() > 0 && tmpPad->GetDrillSizeY() > 0 ) return true; PCB_VIA* via = dynamic_cast( aItem ); if( via ) return true; return false; }; if( copperIntersection.any() && zone && pad && zone->GetNetCode() == pad->GetNetCode() ) { PCB_LAYER_ID layer = active; wxString source; if( !zone->IsOnLayer( active ) ) layer = zone->GetLayerSet().Seq().front(); r = m_inspectClearanceDialog->AddPage( _( "Zone" ) ); r->Report( wxT( "" ) + _( "Zone connection resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); ZONE_CONNECTION zoneConnection = zone->GetPadConnection( pad ); if( zoneConnection == ZONE_CONNECTION::THERMAL ) { int gap = zone->GetThermalReliefGap(); r->Report( "" ); r->Report( wxString::Format( _( "Zone thermal relief: %s." ), StringFromValue( r->GetUnits(), gap, true ) ) ); gap = zone->GetThermalReliefGap( pad, &source ); if( source != _( "zone" ) ) { r->Report( wxString::Format( _( "Overridden by %s; thermal relief: %s." ), source, StringFromValue( r->GetUnits(), gap, true ) ) ); } } else if( zoneConnection == ZONE_CONNECTION::NONE ) { clearance = zone->GetLocalClearance(); r->Report( "" ); r->Report( wxString::Format( _( "Zone clearance: %s." ), StringFromValue( r->GetUnits(), clearance, true ) ) ); if( zone->GetThermalReliefGap( pad ) > clearance ) { clearance = zone->GetThermalReliefGap( pad, &source ); if( source != _( "zone" ) ) { r->Report( wxString::Format( _( "Overridden by larger thermal relief from %s;" "clearance: %s." ), source, StringFromValue( r->GetUnits(), clearance, true ) ) ); } } if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Clearance: %s." ), StringFromValue( units, 0, true ) ) ); } else { if( compileError ) reportCompileError( r ); // Report a 0 clearance for solid connections r->Report( "" ); r->Report( wxString::Format( _( "Clearance: %s." ), StringFromValue( units, 0, true ) ) ); } r->Flush(); } else if( copperIntersection.any() && !aFP && !bFP ) { PCB_LAYER_ID layer = active; if( !copperIntersection.test( layer ) ) layer = copperIntersection.Seq().front(); r = m_inspectClearanceDialog->AddPage( m_frame->GetBoard()->GetLayerName( layer ) ); r->Report( wxT( "" ) + _( "Clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); if( ac && bc && ac->GetNetCode() > 0 && ac->GetNetCode() == bc->GetNetCode() ) { // Same nets.... r->Report( _( "Items belong to the same net. Clearance is 0." ) ); } else { // Different nets (or one or both unconnected).... constraint = drcEngine.EvalRules( CLEARANCE_CONSTRAINT, a, b, layer, r ); clearance = constraint.m_Value.Min(); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), StringFromValue( units, clearance, true ) ) ); } r->Flush(); } for( PCB_LAYER_ID layer : { F_SilkS, B_SilkS } ) { PCB_LAYER_ID correspondingMask = IsFrontLayer( layer ) ? F_Mask : B_Mask; if( ( a->IsOnLayer( layer ) && b->IsOnLayer( layer ) ) || ( a->IsOnLayer( layer ) && b->IsOnLayer( correspondingMask ) ) || ( b->IsOnLayer( layer ) && a->IsOnLayer( correspondingMask ) ) ) { r = m_inspectClearanceDialog->AddPage( m_frame->GetBoard()->GetLayerName( layer ) ); r->Report( wxT( "" ) + _( "Silkscreen clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); constraint = drcEngine.EvalRules( SILK_CLEARANCE_CONSTRAINT, a, b, layer, r ); clearance = constraint.m_Value.Min(); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), StringFromValue( units, clearance, true ) ) ); r->Flush(); } } for( PCB_LAYER_ID layer : { F_CrtYd, B_CrtYd } ) { bool aCourtyard = aFP && !aFP->GetPolyCourtyard( layer ).IsEmpty(); bool bCourtyard = bFP && !bFP->GetPolyCourtyard( layer ).IsEmpty(); if( aCourtyard && bCourtyard ) { r = m_inspectClearanceDialog->AddPage( m_frame->GetBoard()->GetLayerName( layer ) ); r->Report( wxT( "" ) + _( "Courtyard clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); constraint = drcEngine.EvalRules( COURTYARD_CLEARANCE_CONSTRAINT, a, b, layer, r ); clearance = constraint.m_Value.Min(); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), StringFromValue( units, clearance, true ) ) ); r->Flush(); } } if( hasHole( a ) || hasHole( b ) ) { PCB_LAYER_ID layer = UNDEFINED_LAYER; if( hasHole( a ) && b->IsOnLayer( active ) && IsCopperLayer( active ) ) layer = active; else if( hasHole( b ) && a->IsOnLayer( active ) && IsCopperLayer( active ) ) layer = active; else if( hasHole( a ) && IsCopperLayer( b->GetLayer() ) ) layer = b->GetLayer(); else if( hasHole( b ) && IsCopperLayer( a->GetLayer() ) ) layer = a->GetLayer(); if( layer >= 0 ) { r = m_inspectClearanceDialog->AddPage( _( "Hole" ) ); r->Report( wxT( "" ) + _( "Hole clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); constraint = drcEngine.EvalRules( HOLE_CLEARANCE_CONSTRAINT, a, b, layer, r ); clearance = constraint.m_Value.Min(); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), StringFromValue( units, clearance, true ) ) ); r->Flush(); } } for( PCB_LAYER_ID edgeLayer : { Edge_Cuts, Margin } ) { PCB_LAYER_ID layer = UNDEFINED_LAYER; if( a->IsOnLayer( edgeLayer ) && b->IsOnLayer( active ) && IsCopperLayer( active ) ) layer = active; else if( b->IsOnLayer( edgeLayer ) && a->IsOnLayer( active ) && IsCopperLayer( active ) ) layer = active; else if( a->IsOnLayer( edgeLayer ) && IsCopperLayer( b->GetLayer() ) ) layer = b->GetLayer(); else if( b->IsOnLayer( edgeLayer ) && IsCopperLayer( a->GetLayer() ) ) layer = a->GetLayer(); if( layer >= 0 ) { wxString layerName = m_frame->GetBoard()->GetLayerName( edgeLayer ); r = m_inspectClearanceDialog->AddPage( layerName + wxS( " " ) + _( "Clearance" ) ); r->Report( wxT( "" ) + _( "Edge clearance resolution for:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s %s
  • %s
  • %s
" ), _( "Layer" ), EscapeHTML( m_frame->GetBoard()->GetLayerName( layer ) ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); constraint = drcEngine.EvalRules( EDGE_CLEARANCE_CONSTRAINT, a, b, layer, r ); clearance = constraint.m_Value.Min(); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Resolved clearance: %s." ), StringFromValue( units, clearance, true ) ) ); r->Flush(); } } if( m_inspectClearanceDialog->GetPageCount() == 0 ) { r = m_inspectClearanceDialog->AddPage( _( "Clearance" ) ); r->Report( wxT( "" ) + _( "Items share no relevant layers:" ) + wxT( "" ) ); r->Report( wxString::Format( wxT( "
  • %s
  • %s
" ), EscapeHTML( getItemDescription( a ) ), EscapeHTML( getItemDescription( b ) ) ) ); r->Flush(); } m_inspectClearanceDialog->Raise(); m_inspectClearanceDialog->Show( true ); return 0; } wxString reportMin( EDA_UNITS aUnits, DRC_CONSTRAINT& aConstraint ) { if( aConstraint.m_Value.HasMin() ) return StringFromValue( aUnits, aConstraint.m_Value.Min(), true ); else return wxT( "" ) + _( "undefined" ) + wxT( "" ); } wxString reportOpt( EDA_UNITS aUnits, DRC_CONSTRAINT& aConstraint ) { if( aConstraint.m_Value.HasOpt() ) return StringFromValue( aUnits, aConstraint.m_Value.Opt(), true ); else return wxT( "" ) + _( "undefined" ) + wxT( "" ); } wxString reportMax( EDA_UNITS aUnits, DRC_CONSTRAINT& aConstraint ) { if( aConstraint.m_Value.HasMax() ) return StringFromValue( aUnits, aConstraint.m_Value.Max(), true ); else return wxT( "" ) + _( "undefined" ) + wxT( "" ); } int BOARD_INSPECTION_TOOL::InspectConstraints( const TOOL_EVENT& aEvent ) { #define EVAL_RULES( constraint, a, b, layer, r ) drcEngine.EvalRules( constraint, a, b, layer, r ) PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool(); const PCB_SELECTION& selection = selTool->GetSelection(); if( selection.Size() != 1 ) { m_frame->ShowInfoBarError( _( "Select an item for a constraints resolution report." ) ); return 0; } if( m_inspectConstraintsDialog == nullptr ) { m_inspectConstraintsDialog = std::make_unique( m_frame ); m_inspectConstraintsDialog->SetTitle( _( "Constraints Report" ) ); m_inspectConstraintsDialog->Connect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onInspectConstraintsDialogClosed ), nullptr, this ); } m_inspectConstraintsDialog->DeleteAllPages(); BOARD_ITEM* item = static_cast( selection.GetItem( 0 ) ); DRC_ENGINE drcEngine( m_frame->GetBoard(), &m_frame->GetBoard()->GetDesignSettings() ); DRC_CONSTRAINT constraint; bool courtyardError = false; bool compileError = false; try { drcEngine.InitEngine( m_frame->GetDesignRulesPath() ); } catch( PARSE_ERROR& ) { compileError = true; } for( ZONE* zone : m_frame->GetBoard()->Zones() ) zone->CacheBoundingBox(); for( FOOTPRINT* footprint : m_frame->GetBoard()->Footprints() ) { for( ZONE* zone : footprint->Zones() ) zone->CacheBoundingBox(); footprint->BuildPolyCourtyards(); if( ( footprint->GetFlags() & MALFORMED_COURTYARDS ) != 0 ) courtyardError = true; } WX_HTML_REPORT_BOX* r = nullptr; if( item->Type() == PCB_TRACE_T ) { r = m_inspectConstraintsDialog->AddPage( _( "Track Width" ) ); r->Report( wxT( "" ) + _( "Track width resolution for:" ) + wxT( "" ) ); r->Report( wxT( "
  • " ) + EscapeHTML( getItemDescription( item ) ) + wxT( "
" ) ); r->Report( "" ); constraint = EVAL_RULES( TRACK_WIDTH_CONSTRAINT, item, nullptr, item->GetLayer(), r ); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Width constraints: min %s; opt %s; max %s." ), reportMin( r->GetUnits(), constraint ), reportOpt( r->GetUnits(), constraint ), reportMax( r->GetUnits(), constraint ) ) ); r->Flush(); } if( item->Type() == PCB_VIA_T ) { r = m_inspectConstraintsDialog->AddPage( _( "Via Diameter" ) ); r->Report( wxT( "" ) + _( "Via diameter resolution for:" ) + wxT( "" ) ); r->Report( wxT( "
  • " ) + EscapeHTML( getItemDescription( item ) ) + wxT( "
" ) ); r->Report( "" ); // PADSTACKS TODO: once we have padstacks we'll need to run this per-layer.... constraint = EVAL_RULES( VIA_DIAMETER_CONSTRAINT, item, nullptr, UNDEFINED_LAYER, r ); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Diameter constraints: min %s; opt %s; max %s." ), reportMin( r->GetUnits(), constraint ), reportOpt( r->GetUnits(), constraint ), reportMax( r->GetUnits(), constraint ) ) ); r->Flush(); r = m_inspectConstraintsDialog->AddPage( _( "Via Annular Width" ) ); r->Report( wxT( "" ) + _( "Via annular width resolution for:" ) + wxT( "" ) ); r->Report( wxT( "
  • " ) + EscapeHTML( getItemDescription( item ) ) + wxT( "
" ) ); r->Report( "" ); // PADSTACKS TODO: once we have padstacks we'll need to run this per-layer.... constraint = EVAL_RULES( ANNULAR_WIDTH_CONSTRAINT, item, nullptr, UNDEFINED_LAYER, r ); if( compileError ) reportCompileError( r ); r->Report( "" ); r->Report( wxString::Format( _( "Annular width constraints: min %s; opt %s; max %s." ), reportMin( r->GetUnits(), constraint ), reportOpt( r->GetUnits(), constraint ), reportMax( r->GetUnits(), constraint ) ) ); r->Flush(); } if( ( item->Type() == PCB_PAD_T && static_cast( item )->GetDrillSize().x > 0 ) || item->Type() == PCB_VIA_T ) { r = m_inspectConstraintsDialog->AddPage( _( "Hole Size" ) ); r->Report( wxT( "" ) + _( "Hole diameter resolution for:" ) + wxT( "" ) ); r->Report( wxT( "
  • " ) + EscapeHTML( getItemDescription( item ) ) + wxT( "
" ) ); r->Report( "" ); // PADSTACKS TODO: once we have padstacks we'll need to run this per-layer.... constraint = EVAL_RULES( HOLE_SIZE_CONSTRAINT, item, nullptr, UNDEFINED_LAYER, r ); if( compileError ) reportCompileError( r ); wxString min = _( "undefined" ); if( constraint.m_Value.HasMin() ) min = StringFromValue( r->GetUnits(), constraint.m_Value.Min(), true ); r->Report( "" ); r->Report( wxString::Format( _( "Hole constraint: min %s." ), min ) ); r->Flush(); } r = m_inspectConstraintsDialog->AddPage( _( "Keepouts" ) ); r->Report( wxT( "" ) + _( "Keepout resolution for:" ) + wxT( "" ) ); r->Report( wxT( "
  • " ) + EscapeHTML( getItemDescription( item ) ) + wxT( "
" ) ); r->Report( "" ); constraint = EVAL_RULES( DISALLOW_CONSTRAINT, item, nullptr, item->GetLayer(), r ); if( compileError ) reportCompileError( r ); if( courtyardError ) { r->Report( "" ); r->Report( _( "Report may be incomplete: some footprint courtyards are malformed." ) + wxT( " " ) + _( "Run DRC for a full analysis." ) + wxT( "" ) ); } r->Report( "" ); if( constraint.m_DisallowFlags ) r->Report( _( "Item disallowed at current location." ) ); else r->Report( _( "Item allowed at current location." ) ); r->Flush(); m_inspectConstraintsDialog->FinishInitialization(); m_inspectConstraintsDialog->Raise(); m_inspectConstraintsDialog->Show( true ); return 0; } int BOARD_INSPECTION_TOOL::CrossProbePcbToSch( const TOOL_EVENT& aEvent ) { // Don't get in an infinite loop PCB -> SCH -> PCB -> SCH -> ... if( m_probingSchToPcb ) return 0; PCB_SELECTION_TOOL* selTool = m_toolMgr->GetTool(); const PCB_SELECTION& selection = selTool->GetSelection(); if( selection.Size() == 1 ) m_frame->SendMessageToEESCHEMA( static_cast( selection.Front() ) ); else m_frame->SendMessageToEESCHEMA( nullptr ); // Update 3D viewer highlighting m_frame->Update3DView( false, frame()->GetDisplayOptions().m_Live3DRefresh ); return 0; } int BOARD_INSPECTION_TOOL::HighlightItem( const TOOL_EVENT& aEvent ) { BOARD_ITEM* item = aEvent.Parameter(); m_probingSchToPcb = true; // recursion guard { m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); if( item ) m_toolMgr->RunAction( PCB_ACTIONS::selectItem, true, (void*) item ); } m_probingSchToPcb = false; bool request3DviewRedraw = frame()->GetDisplayOptions().m_Live3DRefresh; if( item && item->Type() != PCB_FOOTPRINT_T ) request3DviewRedraw = false; // Update 3D viewer highlighting if( request3DviewRedraw ) m_frame->Update3DView( false, true ); return 0; } bool BOARD_INSPECTION_TOOL::highlightNet( const VECTOR2D& aPosition, bool aUseSelection ) { BOARD* board = static_cast( m_toolMgr->GetModel() ); KIGFX::RENDER_SETTINGS* settings = getView()->GetPainter()->GetSettings(); PCB_SELECTION_TOOL* selectionTool = m_toolMgr->GetTool(); int net = -1; bool enableHighlight = false; if( aUseSelection ) { const PCB_SELECTION& selection = selectionTool->GetSelection(); std::set netcodes; for( EDA_ITEM* item : selection ) { if( BOARD_CONNECTED_ITEM* ci = dynamic_cast( item ) ) netcodes.insert( ci->GetNetCode() ); } enableHighlight = !netcodes.empty(); if( enableHighlight && netcodes.size() > 1 ) { // If we are doing a multi-highlight, cross-probing back and other stuff is not // yet supported settings->SetHighlight( netcodes ); board->ResetNetHighLight(); for( int multiNet : netcodes ) board->SetHighLightNet( multiNet, true ); board->HighLightON(); m_toolMgr->GetView()->UpdateAllLayersColor(); m_currentlyHighlighted = netcodes; return true; } else if( enableHighlight ) { net = *netcodes.begin(); } } // If we didn't get a net to highlight from the selection, use the cursor if( net < 0 ) { GENERAL_COLLECTORS_GUIDE guide = m_frame->GetCollectorsGuide(); guide.SetIgnoreZoneFills( false ); PCB_LAYER_ID activeLayer = static_cast( view()->GetTopLayer() ); guide.SetPreferredLayer( activeLayer ); GENERAL_COLLECTOR collector; collector.Collect( board, GENERAL_COLLECTOR::PadsOrTracks, (wxPoint) aPosition, guide ); if( collector.GetCount() == 0 ) collector.Collect( board, GENERAL_COLLECTOR::Zones, (wxPoint) aPosition, guide ); // Apply the active selection filter, except we want to allow picking locked items for // highlighting even if the user has disabled them for selection SELECTION_FILTER_OPTIONS& filter = selectionTool->GetFilter(); bool saved = filter.lockedItems; filter.lockedItems = true; selectionTool->FilterCollectedItems( collector, true ); filter.lockedItems = saved; // Clear the previous highlight m_frame->SendMessageToEESCHEMA( nullptr ); bool highContrast = settings->GetHighContrast(); PCB_LAYER_ID contrastLayer = settings->GetPrimaryHighContrastLayer(); for( int i = collector.GetCount() - 1; i >= 0; i-- ) { LSET itemLayers = collector[i]->GetLayerSet(); if( ( itemLayers & LSET::AllCuMask() ).none() || ( highContrast && !itemLayers.Contains( contrastLayer ) ) ) { collector.Remove( i ); continue; } } enableHighlight = ( collector.GetCount() > 0 ); // Obtain net code for the clicked item if( enableHighlight ) { BOARD_CONNECTED_ITEM* targetItem = static_cast( collector[0] ); if( targetItem->Type() == PCB_PAD_T ) m_frame->SendMessageToEESCHEMA( targetItem ); net = targetItem->GetNetCode(); } } auto& netcodes = settings->GetHighlightNetCodes(); // Toggle highlight when the same net was picked if( net > 0 && netcodes.count( net ) ) enableHighlight = !settings->IsHighlightEnabled(); if( enableHighlight != settings->IsHighlightEnabled() || !netcodes.count( net ) ) { if( !netcodes.empty() ) m_lastHighlighted = netcodes; settings->SetHighlight( enableHighlight, net ); m_toolMgr->GetView()->UpdateAllLayersColor(); } // Store the highlighted netcode in the current board (for dialogs for instance) if( enableHighlight && net >= 0 ) { m_currentlyHighlighted = netcodes; board->SetHighLightNet( net ); board->HighLightON(); NETINFO_ITEM* netinfo = board->FindNet( net ); if( netinfo ) { std::vector items; netinfo->GetMsgPanelInfo( m_frame, items ); m_frame->SetMsgPanel( items ); m_frame->SendCrossProbeNetName( netinfo->GetNetname() ); } } else { m_currentlyHighlighted.clear(); board->ResetNetHighLight(); m_frame->SetMsgPanel( board ); m_frame->SendCrossProbeNetName( "" ); } return true; } int BOARD_INSPECTION_TOOL::HighlightNet( const TOOL_EVENT& aEvent ) { int netcode = aEvent.Parameter(); KIGFX::RENDER_SETTINGS* settings = m_toolMgr->GetView()->GetPainter()->GetSettings(); const std::set& highlighted = settings->GetHighlightNetCodes(); if( netcode > 0 ) { m_lastHighlighted = highlighted; settings->SetHighlight( true, netcode ); m_toolMgr->GetView()->UpdateAllLayersColor(); m_currentlyHighlighted.clear(); m_currentlyHighlighted.insert( netcode ); } else if( aEvent.IsAction( &PCB_ACTIONS::highlightNetSelection ) ) { // Highlight selection (cursor position will be ignored) highlightNet( getViewControls()->GetMousePosition(), true ); } else if( aEvent.IsAction( &PCB_ACTIONS::toggleLastNetHighlight ) ) { std::set temp = highlighted; settings->SetHighlight( m_lastHighlighted ); m_toolMgr->GetView()->UpdateAllLayersColor(); m_currentlyHighlighted = m_lastHighlighted; m_lastHighlighted = temp; } else if( aEvent.IsAction( &PCB_ACTIONS::toggleNetHighlight ) ) { bool turnOn = highlighted.empty() && !m_currentlyHighlighted.empty(); settings->SetHighlight( m_currentlyHighlighted, turnOn ); m_toolMgr->GetView()->UpdateAllLayersColor(); } else // Highlight the net belonging to the item under the cursor { highlightNet( getViewControls()->GetMousePosition(), false ); } return 0; } int BOARD_INSPECTION_TOOL::ClearHighlight( const TOOL_EVENT& aEvent ) { BOARD* board = static_cast( m_toolMgr->GetModel() ); KIGFX::RENDER_SETTINGS* settings = m_toolMgr->GetView()->GetPainter()->GetSettings(); m_currentlyHighlighted.clear(); m_lastHighlighted.clear(); board->ResetNetHighLight(); settings->SetHighlight( false ); m_toolMgr->GetView()->UpdateAllLayersColor(); m_frame->SetMsgPanel( board ); m_frame->SendCrossProbeNetName( "" ); return 0; } #if 0 int BOARD_INSPECTION_TOOL::HighlightNetTool( const TOOL_EVENT& aEvent ) { std::string tool = aEvent.GetCommandStr().get(); PCB_PICKER_TOOL* picker = m_toolMgr->GetTool(); // Deactivate other tools; particularly important if another PICKER is currently running Activate(); // If the keyboard hotkey was triggered and we are already in the highlight tool, behave // the same as a left-click. Otherwise highlight the net of the selected item(s), or if // there is no selection, then behave like a ctrl-left-click. if( aEvent.IsAction( &PCB_ACTIONS::highlightNetSelection ) ) { bool use_selection = m_frame->IsCurrentTool( PCB_ACTIONS::highlightNetTool ); highlightNet( getViewControls()->GetMousePosition(), use_selection ); } picker->SetClickHandler( [this] ( const VECTOR2D& pt ) -> bool { highlightNet( pt, false ); return true; } ); picker->SetLayerSet( LSET::AllCuMask() ); picker->SetSnapping( false ); m_toolMgr->RunAction( ACTIONS::pickerTool, true, &tool ); return 0; } #endif int BOARD_INSPECTION_TOOL::LocalRatsnestTool( const TOOL_EVENT& aEvent ) { std::string tool = aEvent.GetCommandStr().get(); PCB_PICKER_TOOL* picker = m_toolMgr->GetTool(); BOARD* board = getModel(); // Deactivate other tools; particularly important if another PICKER is currently running Activate(); picker->SetClickHandler( [this, board]( const VECTOR2D& pt ) -> bool { const PCB_DISPLAY_OPTIONS& opt = displayOptions(); PCB_SELECTION_TOOL* selectionTool = m_toolMgr->GetTool(); m_toolMgr->RunAction( PCB_ACTIONS::selectionClear, true ); m_toolMgr->RunAction( PCB_ACTIONS::selectionCursor, true, EDIT_TOOL::PadFilter ); PCB_SELECTION& selection = selectionTool->GetSelection(); if( selection.Empty() ) { m_toolMgr->RunAction( PCB_ACTIONS::selectionCursor, true, EDIT_TOOL::FootprintFilter ); selection = selectionTool->GetSelection(); } if( selection.Empty() ) { // Clear the previous local ratsnest if we click off all items for( FOOTPRINT* fp : board->Footprints() ) { for( PAD* pad : fp->Pads() ) pad->SetLocalRatsnestVisible( opt.m_ShowGlobalRatsnest ); } } else { for( EDA_ITEM* item : selection ) { if( PAD* pad = dyn_cast( item) ) { pad->SetLocalRatsnestVisible( !pad->GetLocalRatsnestVisible() ); } else if( FOOTPRINT* fp = dyn_cast( item) ) { if( !fp->Pads().empty() ) { bool enable = !fp->Pads()[0]->GetLocalRatsnestVisible(); for( PAD* childPad : fp->Pads() ) childPad->SetLocalRatsnestVisible( enable ); } } } } m_toolMgr->GetView()->MarkTargetDirty( KIGFX::TARGET_OVERLAY ); return true; } ); picker->SetFinalizeHandler( [this, board]( int aCondition ) { const PCB_DISPLAY_OPTIONS& opt = displayOptions(); if( aCondition != PCB_PICKER_TOOL::END_ACTIVATE ) { for( FOOTPRINT* fp : board->Footprints() ) { for( PAD* pad : fp->Pads() ) pad->SetLocalRatsnestVisible( opt.m_ShowGlobalRatsnest ); } } } ); m_toolMgr->RunAction( ACTIONS::pickerTool, true, &tool ); return 0; } int BOARD_INSPECTION_TOOL::UpdateSelectionRatsnest( const TOOL_EVENT& aEvent ) { VECTOR2I delta; // If we have passed the simple move vector, we can update without recalculation if( aEvent.Parameter() ) { delta = *aEvent.Parameter(); delete aEvent.Parameter(); } else { // We can delete the existing map to force a recalculation delete m_dynamicData; m_dynamicData = nullptr; } auto selectionTool = m_toolMgr->GetTool(); auto& selection = selectionTool->GetSelection(); auto connectivity = getModel()->GetConnectivity(); if( selection.Empty() ) { connectivity->ClearDynamicRatsnest(); delete m_dynamicData; m_dynamicData = nullptr; } else { calculateSelectionRatsnest( delta ); } return 0; } int BOARD_INSPECTION_TOOL::HideDynamicRatsnest( const TOOL_EVENT& aEvent ) { getModel()->GetConnectivity()->ClearDynamicRatsnest(); delete m_dynamicData; m_dynamicData = nullptr; return 0; } void BOARD_INSPECTION_TOOL::calculateSelectionRatsnest( const VECTOR2I& aDelta ) { PCB_SELECTION_TOOL* selectionTool = m_toolMgr->GetTool(); SELECTION& selection = selectionTool->GetSelection(); std::shared_ptr connectivity = board()->GetConnectivity(); std::vector items; std::deque queued_items( selection.begin(), selection.end() ); for( std::size_t i = 0; i < queued_items.size(); ++i ) { BOARD_ITEM* item = static_cast( queued_items[i] ); if( item->Type() == PCB_FOOTPRINT_T ) { for( PAD* pad : static_cast( item )->Pads() ) { if( pad->GetLocalRatsnestVisible() || displayOptions().m_ShowModuleRatsnest ) items.push_back( pad ); } } else if( item->Type() == PCB_GROUP_T ) { PCB_GROUP *group = static_cast( item ); group->RunOnDescendants( [ &queued_items ]( BOARD_ITEM *aItem ) { queued_items.push_back( aItem ); } ); } else if( BOARD_CONNECTED_ITEM* boardItem = dyn_cast( item ) ) { if( boardItem->GetLocalRatsnestVisible() || displayOptions().m_ShowModuleRatsnest ) items.push_back( boardItem ); } } if( items.empty() || std::none_of( items.begin(), items.end(), []( const BOARD_ITEM* aItem ) { return( aItem->Type() == PCB_TRACE_T || aItem->Type() == PCB_PAD_T || aItem->Type() == PCB_ARC_T || aItem->Type() == PCB_ZONE_T || aItem->Type() == PCB_FOOTPRINT_T || aItem->Type() == PCB_VIA_T ); } ) ) { return; } if( !m_dynamicData ) { m_dynamicData = new CONNECTIVITY_DATA( items, true ); connectivity->BlockRatsnestItems( items ); } else { m_dynamicData->Move( aDelta ); } connectivity->ComputeDynamicRatsnest( items, m_dynamicData ); } int BOARD_INSPECTION_TOOL::ListNets( const TOOL_EVENT& aEvent ) { if( m_listNetsDialog == nullptr ) { m_listNetsDialog = std::make_unique( m_frame, m_listNetsDialogSettings ); m_listNetsDialog->Connect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onListNetsDialogClosed ), nullptr, this ); m_listNetsDialog->Connect( wxEVT_BUTTON, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onListNetsDialogClosed ), nullptr, this ); } m_listNetsDialog->Raise(); m_listNetsDialog->Show( true ); return 0; } void BOARD_INSPECTION_TOOL::onListNetsDialogClosed( wxCommandEvent& event ) { m_listNetsDialogSettings = m_listNetsDialog->Settings(); m_listNetsDialog->Disconnect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onListNetsDialogClosed ), nullptr, this ); m_listNetsDialog->Disconnect( wxEVT_BUTTON, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onListNetsDialogClosed ), nullptr, this ); m_listNetsDialog->Destroy(); m_listNetsDialog.release(); } void BOARD_INSPECTION_TOOL::onInspectClearanceDialogClosed( wxCommandEvent& event ) { m_inspectClearanceDialog->Disconnect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onInspectClearanceDialogClosed ), nullptr, this ); m_inspectClearanceDialog->Destroy(); m_inspectClearanceDialog.release(); } void BOARD_INSPECTION_TOOL::onInspectConstraintsDialogClosed( wxCommandEvent& event ) { m_inspectConstraintsDialog->Disconnect( wxEVT_CLOSE_WINDOW, wxCommandEventHandler( BOARD_INSPECTION_TOOL::onInspectConstraintsDialogClosed ), nullptr, this ); m_inspectConstraintsDialog->Destroy(); m_inspectConstraintsDialog.release(); } int BOARD_INSPECTION_TOOL::HideNet( const TOOL_EVENT& aEvent ) { doHideNet( aEvent.Parameter(), true ); return 0; } int BOARD_INSPECTION_TOOL::ShowNet( const TOOL_EVENT& aEvent ) { doHideNet( aEvent.Parameter(), false ); return 0; } void BOARD_INSPECTION_TOOL::doHideNet( int aNetCode, bool aHide ) { KIGFX::PCB_RENDER_SETTINGS* rs = static_cast( m_toolMgr->GetView()->GetPainter()->GetSettings() ); PCB_SELECTION_TOOL* selectionTool = m_toolMgr->GetTool(); SELECTION& selection = selectionTool->GetSelection(); if( aNetCode <= 0 && !selection.Empty() ) { for( EDA_ITEM* item : selection ) { if( BOARD_CONNECTED_ITEM* bci = dynamic_cast( item ) ) { if( bci->GetNetCode() > 0 ) doHideNet( bci->GetNetCode(), aHide ); } } return; } if( aHide ) rs->GetHiddenNets().insert( aNetCode ); else rs->GetHiddenNets().erase( aNetCode ); m_frame->GetCanvas()->RedrawRatsnest(); m_frame->GetCanvas()->Refresh(); m_frame->GetAppearancePanel()->OnNetVisibilityChanged( aNetCode, !aHide ); } void BOARD_INSPECTION_TOOL::setTransitions() { Go( &BOARD_INSPECTION_TOOL::CrossProbePcbToSch, EVENTS::SelectedEvent ); Go( &BOARD_INSPECTION_TOOL::CrossProbePcbToSch, EVENTS::UnselectedEvent ); Go( &BOARD_INSPECTION_TOOL::CrossProbePcbToSch, EVENTS::ClearedEvent ); Go( &BOARD_INSPECTION_TOOL::LocalRatsnestTool, PCB_ACTIONS::localRatsnestTool.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HideDynamicRatsnest, PCB_ACTIONS::hideDynamicRatsnest.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::UpdateSelectionRatsnest, PCB_ACTIONS::updateLocalRatsnest.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::ListNets, PCB_ACTIONS::listNets.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::ShowStatisticsDialog, PCB_ACTIONS::boardStatistics.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::InspectClearance, PCB_ACTIONS::inspectClearance.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::InspectConstraints, PCB_ACTIONS::inspectConstraints.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HighlightNet, PCB_ACTIONS::highlightNet.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HighlightNet, PCB_ACTIONS::highlightNetSelection.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HighlightNet, PCB_ACTIONS::toggleLastNetHighlight.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::ClearHighlight, PCB_ACTIONS::clearHighlight.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HighlightNet, PCB_ACTIONS::toggleNetHighlight.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HighlightItem, PCB_ACTIONS::highlightItem.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::HideNet, PCB_ACTIONS::hideNet.MakeEvent() ); Go( &BOARD_INSPECTION_TOOL::ShowNet, PCB_ACTIONS::showNet.MakeEvent() ); }