/* * KiRouter - a push-and-(sometimes-)shove PCB router * * Copyright (C) 2013-2014 CERN * Copyright (C) 2016 KiCad Developers, see AUTHORS.txt for contributors. * Author: Tomasz Wlostowski * * 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 3 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, see . */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include "pns_node.h" #include "pns_line_placer.h" #include "pns_line.h" #include "pns_solid.h" #include "pns_utils.h" #include "pns_router.h" #include "pns_shove.h" #include "pns_dragger.h" #include "pns_topology.h" #include "pns_diff_pair_placer.h" #include "pns_meander_placer.h" #include "pns_meander_skew_placer.h" #include "pns_dp_meander_placer.h" #include namespace PNS { // an ugly singleton for drawing debug items within the router context. // To be fixed sometime in the future. static ROUTER* theRouter; ROUTER::ROUTER() { theRouter = this; m_state = IDLE; m_mode = PNS_MODE_ROUTE_SINGLE; // Initialize all other variables: m_lastNode = nullptr; m_iterLimit = 0; m_showInterSteps = false; m_snapshotIter = 0; m_violation = false; m_iface = nullptr; } ROUTER* ROUTER::GetInstance() { return theRouter; } ROUTER::~ROUTER() { ClearWorld(); theRouter = nullptr; } void ROUTER::SyncWorld() { ClearWorld(); m_world = std::unique_ptr( new NODE ); m_iface->SyncWorld( m_world.get() ); } void ROUTER::ClearWorld() { if( m_world ) { m_world->KillChildren(); m_world.reset(); } m_placer.reset(); } bool ROUTER::RoutingInProgress() const { return m_state != IDLE; } const ITEM_SET ROUTER::QueryHoverItems( const VECTOR2I& aP ) { if( m_state == IDLE || m_placer == nullptr ) return m_world->HitTest( aP ); else return m_placer->CurrentNode()->HitTest( aP ); } bool ROUTER::StartDragging( const VECTOR2I& aP, ITEM* aStartItem, int aDragMode ) { if( aDragMode & DM_FREE_ANGLE ) m_forceMarkObstaclesMode = true; else m_forceMarkObstaclesMode = false; if( !aStartItem || aStartItem->OfKind( ITEM::SOLID_T ) ) return false; m_dragger.reset( new DRAGGER( this ) ); m_dragger->SetMode( aDragMode ); m_dragger->SetWorld( m_world.get() ); m_dragger->SetDebugDecorator ( m_iface->GetDebugDecorator () ); if( m_dragger->Start ( aP, aStartItem ) ) m_state = DRAG_SEGMENT; else { m_dragger.reset(); m_state = IDLE; return false; } return true; } bool ROUTER::isStartingPointRoutable( const VECTOR2I& aWhere, int aLayer ) { auto candidates = QueryHoverItems( aWhere ); for( ITEM* item : candidates.Items() ) { if( ! item->IsRoutable() && item->Layers().Overlaps( aLayer ) ) { return false; } } return true; } bool ROUTER::StartRouting( const VECTOR2I& aP, ITEM* aStartItem, int aLayer ) { if( ! isStartingPointRoutable( aP, aLayer ) ) { SetFailureReason( _("Cannot start routing inside a keepout area or board outline." ) ); return false; } m_forceMarkObstaclesMode = false; switch( m_mode ) { case PNS_MODE_ROUTE_SINGLE: m_placer.reset( new LINE_PLACER( this ) ); break; case PNS_MODE_ROUTE_DIFF_PAIR: m_placer.reset( new DIFF_PAIR_PLACER( this ) ); break; case PNS_MODE_TUNE_SINGLE: m_placer.reset( new MEANDER_PLACER( this ) ); break; case PNS_MODE_TUNE_DIFF_PAIR: m_placer.reset( new DP_MEANDER_PLACER( this ) ); break; case PNS_MODE_TUNE_DIFF_PAIR_SKEW: m_placer.reset( new MEANDER_SKEW_PLACER( this ) ); break; default: return false; } m_placer->UpdateSizes ( m_sizes ); m_placer->SetLayer( aLayer ); m_placer->SetDebugDecorator ( m_iface->GetDebugDecorator () ); bool rv = m_placer->Start( aP, aStartItem ); if( !rv ) return false; m_currentEnd = aP; m_state = ROUTE_TRACK; return rv; } void ROUTER::DisplayItems( const ITEM_SET& aItems ) { for( const ITEM* item : aItems.CItems() ) m_iface->DisplayItem( item ); } void ROUTER::Move( const VECTOR2I& aP, ITEM* endItem ) { m_currentEnd = aP; switch( m_state ) { case ROUTE_TRACK: movePlacing( aP, endItem ); break; case DRAG_SEGMENT: moveDragging( aP, endItem ); break; default: break; } } void ROUTER::moveDragging( const VECTOR2I& aP, ITEM* aEndItem ) { m_iface->EraseView(); m_dragger->Drag( aP ); ITEM_SET dragged = m_dragger->Traces(); updateView( m_dragger->CurrentNode(), dragged ); } void ROUTER::markViolations( NODE* aNode, ITEM_SET& aCurrent, NODE::ITEM_VECTOR& aRemoved ) { for( ITEM* item : aCurrent.Items() ) { NODE::OBSTACLES obstacles; aNode->QueryColliding( item, obstacles, ITEM::ANY_T ); if( item->OfKind( ITEM::LINE_T ) ) { LINE* l = static_cast( item ); if( l->EndsWithVia() ) { VIA v( l->Via() ); aNode->QueryColliding( &v, obstacles, ITEM::ANY_T ); } } for( OBSTACLE& obs : obstacles ) { int clearance = aNode->GetClearance( item, obs.m_item ); std::unique_ptr tmp( obs.m_item->Clone() ); tmp->Mark( MK_VIOLATION ); m_iface->DisplayItem( tmp.get(), -1, clearance ); aRemoved.push_back( obs.m_item ); } } } void ROUTER::updateView( NODE* aNode, ITEM_SET& aCurrent ) { NODE::ITEM_VECTOR removed, added; NODE::OBSTACLES obstacles; if( !aNode ) return; if( Settings().Mode() == RM_MarkObstacles || m_forceMarkObstaclesMode ) markViolations( aNode, aCurrent, removed ); aNode->GetUpdatedItems( removed, added ); for( auto item : added ) m_iface->DisplayItem( item ); for( auto item : removed ) m_iface->HideItem( item ); } void ROUTER::UpdateSizes( const SIZES_SETTINGS& aSizes ) { m_sizes = aSizes; // Change track/via size settings if( m_state == ROUTE_TRACK) { m_placer->UpdateSizes( m_sizes ); } } void ROUTER::movePlacing( const VECTOR2I& aP, ITEM* aEndItem ) { m_iface->EraseView(); m_placer->Move( aP, aEndItem ); ITEM_SET current = m_placer->Traces(); for( const ITEM* item : current.CItems() ) { if( !item->OfKind( ITEM::LINE_T ) ) continue; const LINE* l = static_cast( item ); int clearance = GetRuleResolver()->Clearance( item->Net() ); m_iface->DisplayItem( l, -1, clearance ); if( l->EndsWithVia() ) m_iface->DisplayItem( &l->Via(), -1, clearance ); } //ITEM_SET tmp( ¤t ); updateView( m_placer->CurrentNode( true ), current ); } void ROUTER::CommitRouting( NODE* aNode ) { NODE::ITEM_VECTOR removed, added; aNode->GetUpdatedItems( removed, added ); for( auto item : removed ) m_iface->RemoveItem( item ); for( auto item : added ) m_iface->AddItem( item ); m_iface->Commit(); m_world->Commit( aNode ); } bool ROUTER::FixRoute( const VECTOR2I& aP, ITEM* aEndItem, bool aForceFinish ) { bool rv = false; switch( m_state ) { case ROUTE_TRACK: rv = m_placer->FixRoute( aP, aEndItem, aForceFinish ); break; case DRAG_SEGMENT: rv = m_dragger->FixRoute(); break; default: break; } if( rv ) StopRouting(); return rv; } void ROUTER::StopRouting() { // Update the ratsnest with new changes if( m_placer ) { std::vector nets; m_placer->GetModifiedNets( nets ); // Update the ratsnest with new changes for ( auto n : nets ) m_iface->UpdateNet( n ); } if( !RoutingInProgress() ) return; m_placer.reset(); m_dragger.reset(); m_iface->EraseView(); m_state = IDLE; m_world->KillChildren(); m_world->ClearRanks(); } void ROUTER::FlipPosture() { if( m_state == ROUTE_TRACK ) { m_placer->FlipPosture(); } } void ROUTER::SwitchLayer( int aLayer ) { switch( m_state ) { case ROUTE_TRACK: m_placer->SetLayer( aLayer ); break; default: break; } } void ROUTER::ToggleViaPlacement() { if( m_state == ROUTE_TRACK ) { bool toggle = !m_placer->IsPlacingVia(); m_placer->ToggleVia( toggle ); } } const std::vector ROUTER::GetCurrentNets() const { if( m_placer ) return m_placer->CurrentNets(); return std::vector(); } int ROUTER::GetCurrentLayer() const { if( m_placer ) return m_placer->CurrentLayer(); return -1; } void ROUTER::DumpLog() { LOGGER* logger = nullptr; switch( m_state ) { case DRAG_SEGMENT: logger = m_dragger->Logger(); break; case ROUTE_TRACK: logger = m_placer->Logger(); break; default: break; } if( logger ) logger->Save( "/tmp/shove.log" ); } bool ROUTER::IsPlacingVia() const { if( !m_placer ) return false; return m_placer->IsPlacingVia(); } void ROUTER::SetOrthoMode( bool aEnable ) { if( !m_placer ) return; m_placer->SetOrthoMode( aEnable ); } void ROUTER::SetMode( ROUTER_MODE aMode ) { m_mode = aMode; } void ROUTER::SetInterface( ROUTER_IFACE *aIface ) { m_iface = aIface; m_iface->SetRouter( this ); } void ROUTER::BreakSegment( ITEM *aItem, const VECTOR2I& aP ) { NODE *node = m_world->Branch(); LINE_PLACER placer( this ); if ( placer.SplitAdjacentSegments( node, aItem, aP ) ) { CommitRouting( node ); } else { delete node; } } }