/* * KiRouter - a push-and-(sometimes-)shove PCB router * * Copyright (C) 2013-2015 CERN * Copyright (C) 2016-2023 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 "pns_line.h" #include "pns_segment.h" #include "pns_node.h" #include "pns_joint.h" #include "pns_solid.h" #include "pns_router.h" #include "pns_utils.h" #include "pns_diff_pair.h" #include "pns_topology.h" #include #include namespace PNS { bool TOPOLOGY::SimplifyLine( LINE* aLine ) { if( !aLine->IsLinked() || !aLine->SegmentCount() ) return false; LINKED_ITEM* root = aLine->GetLink( 0 ); LINE l = m_world->AssembleLine( root ); SHAPE_LINE_CHAIN simplified( l.CLine() ); simplified.Simplify(); if( simplified.PointCount() != l.PointCount() ) { m_world->Remove( l ); LINE lnew( l ); lnew.SetShape( simplified ); m_world->Add( lnew ); return true; } return false; } const TOPOLOGY::JOINT_SET TOPOLOGY::ConnectedJoints( const JOINT* aStart ) { std::deque searchQueue; JOINT_SET processed; searchQueue.push_back( aStart ); processed.insert( aStart ); while( !searchQueue.empty() ) { const JOINT* current = searchQueue.front(); searchQueue.pop_front(); for( ITEM* item : current->LinkList() ) { if( item->OfKind( ITEM::SEGMENT_T ) ) { const JOINT* a = m_world->FindJoint( item->Anchor( 0 ), item );; const JOINT* b = m_world->FindJoint( item->Anchor( 1 ), item );; const JOINT* next = ( *a == *current ) ? b : a; if( processed.find( next ) == processed.end() ) { processed.insert( next ); searchQueue.push_back( next ); } } } } return processed; } bool TOPOLOGY::NearestUnconnectedAnchorPoint( const LINE* aTrack, VECTOR2I& aPoint, LAYER_RANGE& aLayers, ITEM*& aItem ) { LINE track( *aTrack ); VECTOR2I end; if( !track.PointCount() ) return false; std::unique_ptr tmpNode( m_world->Branch() ); tmpNode->Add( track ); const JOINT* jt = tmpNode->FindJoint( track.CPoint( -1 ), &track ); if( !jt || m_world->GetRuleResolver()->NetCode( jt->Net() ) <= 0 ) return false; if( ( !track.EndsWithVia() && jt->LinkCount() >= 2 ) || ( track.EndsWithVia() && jt->LinkCount() >= 3 ) ) // we got something connected { end = jt->Pos(); aLayers = jt->Layers(); aItem = jt->LinkList()[0]; } else { int anchor; TOPOLOGY topo( tmpNode.get() ); ITEM* it = topo.NearestUnconnectedItem( jt, &anchor ); if( !it ) return false; end = it->Anchor( anchor ); aLayers = it->Layers(); aItem = it; } aPoint = end; return true; } bool TOPOLOGY::LeadingRatLine( const LINE* aTrack, SHAPE_LINE_CHAIN& aRatLine ) { VECTOR2I end; // Ratline doesn't care about the layer LAYER_RANGE layers; ITEM* unusedItem; if( !NearestUnconnectedAnchorPoint( aTrack, end, layers, unusedItem ) ) return false; aRatLine.Clear(); aRatLine.Append( aTrack->CPoint( -1 ) ); aRatLine.Append( end ); return true; } ITEM* TOPOLOGY::NearestUnconnectedItem( const JOINT* aStart, int* aAnchor, int aKindMask ) { std::set disconnected; m_world->AllItemsInNet( aStart->Net(), disconnected ); for( const JOINT* jt : ConnectedJoints( aStart ) ) { for( ITEM* link : jt->LinkList() ) { if( disconnected.find( link ) != disconnected.end() ) disconnected.erase( link ); } } int best_dist = INT_MAX; ITEM* best = nullptr; for( ITEM* item : disconnected ) { if( item->OfKind( aKindMask ) ) { for( int i = 0; i < item->AnchorCount(); i++ ) { VECTOR2I p = item->Anchor( i ); int d = ( p - aStart->Pos() ).EuclideanNorm(); if( d < best_dist ) { best_dist = d; best = item; if( aAnchor ) *aAnchor = i; } } } } return best; } bool TOPOLOGY::followTrivialPath( LINE* aLine, bool aLeft, ITEM_SET& aSet, std::set& aVisited, const JOINT** aTerminalJoint, bool aFollowLockedSegments ) { assert( aLine->IsLinked() ); VECTOR2I anchor = aLeft ? aLine->CPoint( 0 ) : aLine->CPoint( -1 ); LINKED_ITEM* last = aLeft ? aLine->Links().front() : aLine->Links().back(); const JOINT* jt = m_world->FindJoint( anchor, aLine ); assert( jt != nullptr ); aVisited.insert( last ); if( jt->IsNonFanoutVia() || jt->IsTraceWidthChange() ) { ITEM* via = nullptr; SEGMENT* next_seg = nullptr; ITEM_SET links( jt->CLinks() ); for( ITEM* link : links ) { if( link->OfKind( ITEM::VIA_T ) ) via = link; else if( aVisited.find( link ) == aVisited.end() ) next_seg = static_cast( link ); } if( !next_seg ) { if( aTerminalJoint ) *aTerminalJoint = jt; return false; } LINE l = m_world->AssembleLine( next_seg, nullptr, false, aFollowLockedSegments ); VECTOR2I nextAnchor = ( aLeft ? l.CLine().CPoint( -1 ) : l.CLine().CPoint( 0 ) ); if( nextAnchor != anchor ) { l.Reverse(); } if( aLeft ) { if( via ) aSet.Prepend( via ); aSet.Prepend( l ); } else { if( via ) aSet.Add( via ); aSet.Add( l ); } return followTrivialPath( &l, aLeft, aSet, aVisited, aTerminalJoint, aFollowLockedSegments ); } if( aTerminalJoint ) *aTerminalJoint = jt; return false; } const ITEM_SET TOPOLOGY::AssembleTrivialPath( ITEM* aStart, std::pair* aTerminalJoints, bool aFollowLockedSegments ) { ITEM_SET path; std::set visited; LINKED_ITEM* seg = nullptr; if( aStart->Kind() == ITEM::VIA_T ) { VIA* via = static_cast( aStart ); const JOINT* jt = m_world->FindJoint( via->Pos(), via ); if( !jt->IsNonFanoutVia() ) return ITEM_SET(); ITEM_SET links( jt->CLinks() ); for( ITEM* item : links ) { if( item->OfKind( ITEM::SEGMENT_T | ITEM::ARC_T ) ) { seg = static_cast( item ); break; } } } else if( aStart->OfKind( ITEM::SEGMENT_T | ITEM::ARC_T ) ) { seg = static_cast( aStart ); } if( !seg ) return ITEM_SET(); // Assemble a line following through locked segments // TODO: consider if we want to allow tuning lines with different widths in the future LINE l = m_world->AssembleLine( seg, nullptr, false, aFollowLockedSegments ); path.Add( l ); const JOINT* jointA = nullptr; const JOINT* jointB = nullptr; followTrivialPath( &l, false, path, visited, &jointB, aFollowLockedSegments ); followTrivialPath( &l, true, path, visited, &jointA, aFollowLockedSegments ); if( aTerminalJoints ) { wxASSERT( jointA && jointB ); *aTerminalJoints = std::make_pair( jointA, jointB ); } return path; } const ITEM_SET TOPOLOGY::AssembleTuningPath( ITEM* aStart, SOLID** aStartPad, SOLID** aEndPad ) { std::pair joints; ITEM_SET initialPath = AssembleTrivialPath( aStart, &joints, true ); PAD* padA = nullptr; PAD* padB = nullptr; auto getPadFromJoint = []( const JOINT* aJoint, PAD** aTargetPad, SOLID** aTargetSolid ) { for( ITEM* item : aJoint->LinkList() ) { if( item->OfKind( ITEM::SOLID_T ) ) { BOARD_ITEM* bi = static_cast( item )->Parent(); if( bi->Type() == PCB_PAD_T ) { *aTargetPad = static_cast( bi ); if( aTargetSolid ) *aTargetSolid = static_cast( item ); } break; } } }; if( joints.first ) getPadFromJoint( joints.first, &padA, aStartPad ); if( joints.second ) getPadFromJoint( joints.second, &padB, aEndPad ); if( !padA && !padB ) return initialPath; auto clipLineToPad = []( SHAPE_LINE_CHAIN& aLine, PAD* aPad, bool aForward = true ) { const std::shared_ptr& shape = aPad->GetEffectivePolygon(); int start = aForward ? 0 : aLine.PointCount() - 1; int delta = aForward ? 1 : -1; // Skip the "first" (or last) vertex, we already know it's contained in the pad int clip = start; for( int vertex = start + delta; aForward ? vertex < aLine.PointCount() : vertex >= 0; vertex += delta ) { SEG seg( aLine.GetPoint( vertex ), aLine.GetPoint( vertex - delta ) ); bool containsA = shape->Contains( seg.A ); bool containsB = shape->Contains( seg.B ); if( containsA && containsB ) { // Whole segment is inside: clip out this segment clip = vertex; } else if( containsB ) { // Only one point inside: Find the intersection VECTOR2I loc; if( shape->Collide( seg, 0, nullptr, &loc ) ) { aLine.Replace( vertex - delta, vertex - delta, loc ); } } } if( !aForward && clip < start ) aLine.Remove( clip + 1, start ); else if( clip > start ) aLine.Remove( start, clip - 1 ); // Now connect the dots aLine.Insert( aForward ? 0 : aLine.PointCount(), aPad->GetPosition() ); }; auto processPad = [&]( const JOINT* aJoint, PAD* aPad ) { const std::shared_ptr& shape = aPad->GetEffectivePolygon(); for( int idx = 0; idx < initialPath.Size(); idx++ ) { if( initialPath[idx]->Kind() != ITEM::LINE_T ) continue; LINE* line = static_cast( initialPath[idx] ); if( !aPad->FlashLayer( line->Layer() ) ) continue; const std::vector& points = line->CLine().CPoints(); if( points.front() != aJoint->Pos() && points.back() != aJoint->Pos() ) continue; SHAPE_LINE_CHAIN& slc = line->Line(); if( shape->Contains( slc.CPoint( 0 ) ) ) clipLineToPad( slc, aPad, true ); else if( shape->Contains( slc.CPoint( -1 ) ) ) clipLineToPad( slc, aPad, false ); } }; if( padA ) processPad( joints.first, padA ); if( padB ) processPad( joints.second, padB ); return initialPath; } const ITEM_SET TOPOLOGY::ConnectedItems( const JOINT* aStart, int aKindMask ) { return ITEM_SET(); } const ITEM_SET TOPOLOGY::ConnectedItems( ITEM* aStart, int aKindMask ) { return ITEM_SET(); } bool commonParallelProjection( SEG p, SEG n, SEG &pClip, SEG& nClip ); bool TOPOLOGY::AssembleDiffPair( ITEM* aStart, DIFF_PAIR& aPair ) { NET_HANDLE refNet = aStart->Net(); NET_HANDLE coupledNet = m_world->GetRuleResolver()->DpCoupledNet( refNet ); if( !coupledNet ) return false; std::set coupledItems; m_world->AllItemsInNet( coupledNet, coupledItems ); SEGMENT* coupledSeg = nullptr, *refSeg; int minDist = std::numeric_limits::max(); if( ( refSeg = dyn_cast( aStart ) ) != nullptr ) { for( ITEM* item : coupledItems ) { if( SEGMENT* s = dyn_cast( item ) ) { if( s->Layers().Start() == refSeg->Layers().Start() && s->Width() == refSeg->Width() ) { int dist = s->Seg().Distance( refSeg->Seg() ); bool isParallel = refSeg->Seg().ApproxParallel( s->Seg(), DP_PARALLELITY_THRESHOLD ); SEG p_clip, n_clip; bool isCoupled = commonParallelProjection( refSeg->Seg(), s->Seg(), p_clip, n_clip ); if( isParallel && isCoupled && dist < minDist ) { minDist = dist; coupledSeg = s; } } } } } else { return false; } if( !coupledSeg ) return false; LINE lp = m_world->AssembleLine( refSeg ); LINE ln = m_world->AssembleLine( coupledSeg ); if( m_world->GetRuleResolver()->DpNetPolarity( refNet ) < 0 ) { std::swap( lp, ln ); } int gap = -1; if( refSeg->Seg().ApproxParallel( coupledSeg->Seg(), DP_PARALLELITY_THRESHOLD ) ) { // Segments are parallel -> compute pair gap const VECTOR2I refDir = refSeg->Anchor( 1 ) - refSeg->Anchor( 0 ); const VECTOR2I displacement = refSeg->Anchor( 1 ) - coupledSeg->Anchor( 1 ); gap = (int) std::abs( refDir.Cross( displacement ) / refDir.EuclideanNorm() ) - lp.Width(); } aPair = DIFF_PAIR( lp, ln ); aPair.SetWidth( lp.Width() ); aPair.SetLayers( lp.Layers() ); aPair.SetGap( gap ); return true; } const std::set TOPOLOGY::AssembleCluster( ITEM* aStart, int aLayer ) { std::set visited; std::deque pending; COLLISION_SEARCH_OPTIONS opts; opts.m_differentNetsOnly = false; opts.m_overrideClearance = 0; pending.push_back( aStart ); while( !pending.empty() ) { NODE::OBSTACLES obstacles; ITEM* top = pending.front(); pending.pop_front(); visited.insert( top ); m_world->QueryColliding( top, obstacles, opts ); // only query touching objects for( const OBSTACLE& obs : obstacles ) { bool trackOnTrack = ( obs.m_item->Net() != top->Net() ) && obs.m_item->OfKind( ITEM::SEGMENT_T ) && top->OfKind( ITEM::SEGMENT_T ); if( trackOnTrack ) continue; if( visited.find( obs.m_item ) == visited.end() && obs.m_item->Layers().Overlaps( aLayer ) && !( obs.m_item->Marker() & MK_HEAD ) ) { visited.insert( obs.m_item ); pending.push_back( obs.m_item ); } } } return visited; } }