Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c6297656a6 | ||
|
|
4933b6f992 | ||
|
|
6a560b9506 | ||
|
|
09c58ea630 | ||
|
|
7c076d9995 | ||
|
|
8f006fec25 | ||
|
|
ad10113b8b |
+6
-1
@@ -186,6 +186,7 @@ def _flood(router: GridRouter, pin, net_no: int, conns) -> tuple[int, Counter]:
|
||||
def diagnose(
|
||||
dsn_text: str, edge_clearance_mm: float | None, resolution: int = 2, shove: bool = False,
|
||||
access_cost: float = 0.0, hole_to_hole_mm: float = 0.25, seed: int | None = None,
|
||||
negotiate: int = 0,
|
||||
) -> dict:
|
||||
dsn = parse_dsn(dsn_text)
|
||||
names = {i + 1: n.name for i, n in enumerate(dsn.nets)}
|
||||
@@ -202,6 +203,7 @@ def diagnose(
|
||||
shove=shove,
|
||||
access_cost=access_cost,
|
||||
seed=seed,
|
||||
negotiate=negotiate,
|
||||
# the product's configuration: net-class widths and hole spacing
|
||||
net_widths=_net_widths_board(dsn, scale),
|
||||
via_drill=_via_drill_board(dsn, scale),
|
||||
@@ -213,6 +215,8 @@ def diagnose(
|
||||
|
||||
# the board as the best pass left it
|
||||
state = _fresh(seen)
|
||||
# pins on turned pads leave along their pad's axis: replay with the same exits
|
||||
state._axis_exits = dict(routed._axis_exits)
|
||||
conns = state._conns
|
||||
for idx, (path, a_end, b_end) in best.items():
|
||||
conns[idx].a_end, conns[idx].b_end = a_end, b_end
|
||||
@@ -278,12 +282,13 @@ def main(argv: list[str] | None = None) -> int:
|
||||
ap.add_argument("--shove", action="store_true", help="as mckicad routes")
|
||||
ap.add_argument("--access-cost", type=float, default=0.0)
|
||||
ap.add_argument("--seed", type=int, help="route in this shuffled order, as bench.py does")
|
||||
ap.add_argument("--negotiate", type=int, default=0, metavar="N", help="as the router's --negotiate")
|
||||
ap.add_argument("--hole-to-hole", type=float, default=0.25, metavar="MM")
|
||||
ap.add_argument("--json", type=Path, help="also write the full table here")
|
||||
args = ap.parse_args(argv)
|
||||
|
||||
report = diagnose(args.dsn.read_text(), args.edge_clearance, args.grid_resolution, args.shove,
|
||||
args.access_cost, args.hole_to_hole, args.seed)
|
||||
args.access_cost, args.hole_to_hole, args.seed, args.negotiate)
|
||||
for row in report["failures"]:
|
||||
extra = ""
|
||||
for w in row.get("walled", []):
|
||||
|
||||
@@ -18,7 +18,7 @@ from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass
|
||||
|
||||
from freeroute.geometry import IntBox, Simplex, overlaps_2d, segment_octagon
|
||||
from freeroute.geometry import IntBox, IntPoint, Simplex, overlaps_2d, segment_octagon, segment_slab
|
||||
|
||||
__all__ = ["TreeShape", "ShapeSearchTree"]
|
||||
|
||||
@@ -63,7 +63,9 @@ class TreeShape:
|
||||
segment swept by ``half_width + clearance`` (exact integer superset)."""
|
||||
if self.seg is None:
|
||||
return self.tile.offset(clearance)
|
||||
a, b, half_width = self.seg
|
||||
a, b, half_width = self.seg[-3:]
|
||||
if self.seg[0] == "slab": # a slanted pin exit, at any angle
|
||||
return segment_slab(a, b, half_width + clearance)
|
||||
return segment_octagon(a, b, half_width + clearance)
|
||||
|
||||
|
||||
@@ -151,6 +153,25 @@ class ShapeSearchTree:
|
||||
return True
|
||||
return False
|
||||
|
||||
def segment_conflict(
|
||||
self, a: IntPoint, b: IntPoint, half_width: int, net_no: int, layer: int,
|
||||
clearance: int, kind: str = "wire",
|
||||
) -> bool:
|
||||
""":meth:`clearance_conflict` for a slanted segment, checked on its
|
||||
exact swept copper instead of its bounding box (which would reach the
|
||||
neighbouring pads of a pin leaving along its turned pad's axis)."""
|
||||
copper = segment_slab(a, b, half_width)
|
||||
grown = segment_slab(a, b, half_width + clearance)
|
||||
for shape in self.overlapping(grown.bounding_box()):
|
||||
if shape.net_no == net_no or not shape.on_layer(layer):
|
||||
continue
|
||||
if shape.blocks != "all" and shape.blocks != kind + "s":
|
||||
continue
|
||||
other = shape.exact if shape.exact is not None else shape.tile
|
||||
if overlaps_2d(copper if not shape.clearance else grown, other):
|
||||
return True
|
||||
return False
|
||||
|
||||
def rule_area_overlap(self, box: IntBox, layer: int, kind: str = "wire") -> bool:
|
||||
"""True if ``box`` overlaps a rule area on ``layer`` that stops ``kind``."""
|
||||
for shape in self.overlapping(box):
|
||||
|
||||
+14
-2
@@ -30,8 +30,8 @@ from freeroute.ses import write_ses
|
||||
#: which optional flags each engine actually implements. Anything not listed for
|
||||
#: an engine is rejected by :func:`_validate` rather than quietly ignored.
|
||||
ENGINE_OPTIONS: dict[str, frozenset[str]] = {
|
||||
"grid": frozenset({"rip_up", "max_passes", "seed", "orders", "promote", "access", "rollback"}),
|
||||
"exact": frozenset({"shove", "diagonal", "rip_up", "max_passes", "seed", "orders", "promote", "access", "rollback"}),
|
||||
"grid": frozenset({"rip_up", "max_passes", "seed", "orders", "promote", "access", "negotiate", "rollback"}),
|
||||
"exact": frozenset({"shove", "diagonal", "rip_up", "max_passes", "seed", "orders", "promote", "access", "negotiate", "rollback"}),
|
||||
"room": frozenset({"shove", "pack"}),
|
||||
}
|
||||
|
||||
@@ -46,6 +46,7 @@ _FLAG_NAMES = {
|
||||
"orders": "--orders",
|
||||
"promote": "--promote-failures",
|
||||
"access": "--access-cost",
|
||||
"negotiate": "--negotiate",
|
||||
"rollback": "--no-rollback",
|
||||
}
|
||||
|
||||
@@ -167,6 +168,14 @@ def build_parser() -> argparse.ArgumentParser:
|
||||
help="grid and exact engines: extra cost for a route to pass where it would close "
|
||||
"another pin's way out while that pin still has connections to route (default 0: off)",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--negotiate",
|
||||
type=int,
|
||||
metavar="N",
|
||||
help="grid and exact engines: before routing, N rounds of negotiation on the empty "
|
||||
"board, where routes may share space at a price that rises where they compete; "
|
||||
"the contested cells then cost extra in the real routing (default 0: off)",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--no-rollback",
|
||||
dest="rollback",
|
||||
@@ -212,6 +221,7 @@ def main(argv: list[str] | None = None) -> int:
|
||||
("orders", args.orders is not None),
|
||||
("promote", args.promote_failures is not None),
|
||||
("access", args.access_cost is not None),
|
||||
("negotiate", args.negotiate is not None),
|
||||
("rollback", not args.rollback),
|
||||
)
|
||||
if asked
|
||||
@@ -247,6 +257,7 @@ def main(argv: list[str] | None = None) -> int:
|
||||
"resolution": 2 if args.grid_resolution is None else args.grid_resolution,
|
||||
"heuristic_weight": args.heuristic_weight,
|
||||
"access_cost": args.access_cost or 0.0,
|
||||
"negotiate": args.negotiate or 0,
|
||||
"hole_to_hole_mm": args.hole_to_hole,
|
||||
"rollback": args.rollback,
|
||||
}
|
||||
@@ -258,6 +269,7 @@ def main(argv: list[str] | None = None) -> int:
|
||||
"edge_clearance_mm": args.edge_clearance,
|
||||
"resolution": 1 if args.grid_resolution is None else args.grid_resolution,
|
||||
"access_cost": args.access_cost or 0.0,
|
||||
"negotiate": args.negotiate or 0,
|
||||
"hole_to_hole_mm": args.hole_to_hole,
|
||||
"rollback": args.rollback,
|
||||
}
|
||||
|
||||
@@ -21,7 +21,7 @@ from .direction import Direction, IntDirection
|
||||
from .float_point import FloatPoint
|
||||
from .limits import CRIT_DOUBLE, CRIT_INT
|
||||
from .line import Line
|
||||
from .octagon import ceil_sqrt2, overlaps_2d, segment_octagon
|
||||
from .octagon import ceil_sqrt2, overlaps_2d, segment_octagon, segment_slab
|
||||
from .point import IntPoint, Point, RationalPoint, point, rational_point
|
||||
from .polygon import Polygon
|
||||
from .polygon_shape import PolygonShape
|
||||
@@ -59,5 +59,6 @@ __all__ = [
|
||||
"shove_segment",
|
||||
"ceil_sqrt2",
|
||||
"segment_octagon",
|
||||
"segment_slab",
|
||||
"overlaps_2d",
|
||||
]
|
||||
|
||||
@@ -29,7 +29,7 @@ from .line import Line
|
||||
from .point import IntPoint
|
||||
from .simplex import Simplex
|
||||
|
||||
__all__ = ["ceil_sqrt2", "segment_octagon", "overlaps_2d"]
|
||||
__all__ = ["ceil_sqrt2", "segment_octagon", "segment_slab", "overlaps_2d"]
|
||||
|
||||
|
||||
def ceil_sqrt2(radius: int) -> int:
|
||||
@@ -82,6 +82,46 @@ def segment_octagon(a: IntPoint, b: IntPoint, radius: int) -> Simplex:
|
||||
return Simplex.get_instance(lines)
|
||||
|
||||
|
||||
def segment_slab(a: IntPoint, b: IntPoint, radius: int) -> Simplex:
|
||||
"""Convex cover of segment ``a``-``b`` swept by ``radius``, at any angle.
|
||||
|
||||
The rectangle along the segment, ``radius`` either side, with flush ends
|
||||
like :func:`polyline.segment_box`: the ends of a trace leg sit on a pad or
|
||||
on the square corner tile of the next leg, which cover them. Corners are
|
||||
rounded away from the middle and the radius gets one unit more, so the
|
||||
side bounds never under-report, and it stays tight for a slanted segment
|
||||
off the 45-degree lines (a pin leaving along its pad's axis on a part
|
||||
turned 30 degrees).
|
||||
"""
|
||||
dx, dy = b.x - a.x, b.y - a.y
|
||||
length = math.hypot(dx, dy)
|
||||
r = max(radius, 0) + 1
|
||||
if length == 0:
|
||||
return Simplex.from_corners([
|
||||
IntPoint(a.x - r, a.y - r), IntPoint(a.x + r, a.y - r),
|
||||
IntPoint(a.x + r, a.y + r), IntPoint(a.x - r, a.y + r),
|
||||
])
|
||||
ux, uy = dx / length, dy / length
|
||||
nx, ny = -uy, ux
|
||||
mx, my = (a.x + b.x) / 2, (a.y + b.y) / 2
|
||||
|
||||
def out(x: float, y: float) -> IntPoint:
|
||||
return IntPoint(math.ceil(x) if x >= mx else math.floor(x),
|
||||
math.ceil(y) if y >= my else math.floor(y))
|
||||
|
||||
corners = [
|
||||
out(a.x + nx * r, a.y + ny * r),
|
||||
out(b.x + nx * r, b.y + ny * r),
|
||||
out(b.x - nx * r, b.y - ny * r),
|
||||
out(a.x - nx * r, a.y - ny * r),
|
||||
]
|
||||
for winding in (corners, corners[::-1]):
|
||||
slab = Simplex.from_corners(winding)
|
||||
if not slab.is_empty():
|
||||
return slab
|
||||
return Simplex(())
|
||||
|
||||
|
||||
def overlaps_2d(shape_a, shape_b) -> bool:
|
||||
"""True if the two convex tiles share 2-D area (a real clearance overlap).
|
||||
|
||||
|
||||
@@ -41,6 +41,7 @@ from freeroute.geometry import (
|
||||
Simplex,
|
||||
segment_box,
|
||||
segment_octagon,
|
||||
segment_slab,
|
||||
shove_segment,
|
||||
)
|
||||
from freeroute.geometry.polyline import corner_box
|
||||
@@ -99,6 +100,7 @@ def route_board_exact(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
rollback: bool = True,
|
||||
net_widths: dict[int, int] | None = None,
|
||||
via_drill: int | None = None,
|
||||
@@ -134,6 +136,7 @@ def route_board_exact(
|
||||
seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
rollback=rollback,
|
||||
net_widths=net_widths,
|
||||
via_drill=via_drill,
|
||||
@@ -198,16 +201,23 @@ def route_board_exact(
|
||||
zip(result.connections, ends_list, strict=False), key=lambda c: c[0][0]
|
||||
):
|
||||
wire_half = net_half.get(net_no, half_width)
|
||||
boxes = _copper_boxes(wires, vias, wire_half, via_layers, via_half)
|
||||
wire_count = len(_copper_boxes(wires, [], wire_half, via_layers, via_half))
|
||||
pieces = _copper_pieces(wires, vias, wire_half, via_layers, via_half)
|
||||
boxes = [(box, box_layers) for box, box_layers, _ in pieces]
|
||||
wire_count = len(_copper_pieces(wires, [], wire_half, via_layers, via_half))
|
||||
if any(
|
||||
tree.clearance_conflict(
|
||||
box, net_no, layer, clearance, "wire" if i < wire_count else "via"
|
||||
(
|
||||
tree.segment_conflict(*seg, wire_half, net_no, layer, clearance)
|
||||
if seg is not None
|
||||
else tree.clearance_conflict(
|
||||
box, net_no, layer, clearance, "wire" if i < wire_count else "via"
|
||||
)
|
||||
)
|
||||
for i, (box, box_layers) in enumerate(boxes)
|
||||
for i, (box, box_layers, seg) in enumerate(pieces)
|
||||
for layer in box_layers
|
||||
) or _end_in_rule_area(tree, wires, wire_half) or (
|
||||
outline is not None and not all(outline.box_clear(b, edge) for b, _ in boxes)
|
||||
outline is not None and not _inside_outline(
|
||||
outline, boxes[:wire_count], vias, (via_half or wire_half) + edge, edge
|
||||
)
|
||||
):
|
||||
rejected.append((net_no, *ends))
|
||||
continue # exact-clearance conflict -> drop (may be recovered by shove)
|
||||
@@ -221,9 +231,15 @@ def route_board_exact(
|
||||
v for v in dict.fromkeys(vias)
|
||||
if v not in acc.vias and not _on_fixed_via(net_no, v, fixed_vias, via_half)
|
||||
)
|
||||
for box, box_layers in boxes:
|
||||
for box, box_layers, seg in pieces:
|
||||
oid = next(owner)
|
||||
tree.insert(TreeShape(oid, net_no, box_layers, box, routed=True))
|
||||
if seg is None:
|
||||
tree.insert(TreeShape(oid, net_no, box_layers, box, routed=True))
|
||||
else: # a slanted pin exit: its exact copper, rebuilt for the DRC check
|
||||
tree.insert(TreeShape(
|
||||
oid, net_no, box_layers, box, routed=True,
|
||||
exact=segment_slab(*seg, wire_half), seg=("slab", *seg, wire_half),
|
||||
))
|
||||
acc.owners.append(oid)
|
||||
|
||||
accepted_before_recovery = set(accepted)
|
||||
@@ -658,6 +674,27 @@ def _on_fixed_via(net_no, point, fixed_vias, via_half) -> bool:
|
||||
)
|
||||
|
||||
|
||||
def _copper_pieces(wires, vias, half_width, via_layers, via_half=None):
|
||||
"""Like :func:`_copper_boxes`, but a slanted wire segment (a pin leaving
|
||||
along a turned pad's axis) comes with its end points, so it can be checked
|
||||
on its exact copper: ``(box, layers, (a, b) or None)``."""
|
||||
via_half = via_half or half_width
|
||||
pieces: list[tuple[IntBox, frozenset[int], tuple | None]] = []
|
||||
for layer, points in wires:
|
||||
on = frozenset({layer})
|
||||
for a, b in zip(points, points[1:], strict=False):
|
||||
if a.x == b.x or a.y == b.y:
|
||||
pieces.append((segment_box(a, b, half_width), on, None))
|
||||
else:
|
||||
pieces.append((segment_slab(a, b, half_width).bounding_box(), on, (a, b)))
|
||||
for c in points[1:-1]:
|
||||
pieces.append((corner_box(c, half_width), on, None))
|
||||
for loc in vias:
|
||||
vbox = IntBox(loc.x - via_half, loc.y - via_half, loc.x + via_half, loc.y + via_half)
|
||||
pieces.append((vbox, via_layers, None))
|
||||
return pieces
|
||||
|
||||
|
||||
def _copper_boxes(wires, vias, half_width, via_layers, via_half=None):
|
||||
via_half = via_half or half_width
|
||||
boxes: list[tuple[IntBox, frozenset[int]]] = []
|
||||
@@ -670,6 +707,15 @@ def _copper_boxes(wires, vias, half_width, via_layers, via_half=None):
|
||||
return boxes
|
||||
|
||||
|
||||
def _inside_outline(outline, wire_boxes, vias, via_reach, edge) -> bool:
|
||||
"""Copper inside the board, ``edge`` from its outline. A via is round, as
|
||||
the grid and KiCad take it: its square box would reach past a chamfered
|
||||
corner where the via itself does not."""
|
||||
return all(outline.box_clear(b, edge) for b, _ in wire_boxes) and all(
|
||||
outline.point_clear(v, via_reach) for v in vias
|
||||
)
|
||||
|
||||
|
||||
def _is_rotated(shape) -> bool:
|
||||
return isinstance(shape, Simplex) and not shape.is_int_box()
|
||||
|
||||
|
||||
@@ -34,8 +34,8 @@ import random
|
||||
from freeroute.board.board import BasicBoard
|
||||
from freeroute.board.items import ConductionArea, ObstacleArea, Pin, Via
|
||||
from freeroute.geometry import IntBox, IntPoint, Simplex
|
||||
from freeroute.geometry.octagon import overlaps_2d
|
||||
from freeroute.geometry.polyline import corner_box
|
||||
from freeroute.geometry.octagon import overlaps_2d, segment_slab
|
||||
from freeroute.geometry.polyline import corner_box, segment_box
|
||||
|
||||
__all__ = ["GridRouter", "RouteResult", "route_board"]
|
||||
|
||||
@@ -126,6 +126,7 @@ class _Connection:
|
||||
"narrow",
|
||||
"half",
|
||||
"stubs",
|
||||
"stub_near",
|
||||
)
|
||||
|
||||
def __init__(self, index: int, net_no: int, a: Pin, b: Pin) -> None:
|
||||
@@ -143,6 +144,8 @@ class _Connection:
|
||||
self.halo_nodes: list[Node] = []
|
||||
# each end's stub: its layer, its copper tiles, and the nodes it claims
|
||||
self.stubs: list[tuple[int, list[IntBox], set[Node]]] = []
|
||||
# every node its stubs come near, claimed or not (see GridRouter._stub_near)
|
||||
self.stub_near: list[Node] = []
|
||||
# the pins and zones each end may use, and which pin the route ended
|
||||
# on (None when it ended on a zone)
|
||||
self.a_group: tuple[list[Pin], list] = ([a], [])
|
||||
@@ -180,6 +183,7 @@ class GridRouter:
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
rollback: bool = True,
|
||||
net_widths: dict[int, int] | None = None,
|
||||
via_drill: int | None = None,
|
||||
@@ -191,6 +195,15 @@ class GridRouter:
|
||||
# and the clearance around both) cost other nets this much extra, so
|
||||
# they route round a fine-pitch pin's way out instead of sealing it.
|
||||
self.access_cost = max(float(access_cost), 0.0)
|
||||
# Negotiated congestion (PathFinder): before the real routing, every
|
||||
# connection is routed this many times on the empty board, where routes
|
||||
# may overlap at a price that grows where they compete. The cells that
|
||||
# stay contested keep a history cost the real routing pays, so the first
|
||||
# routes leave room around the places later routes have no way round.
|
||||
self.negotiate = max(int(negotiate), 0)
|
||||
self._history: dict[Node, float] = {}
|
||||
self._present: dict[Node, dict[int, int]] | None = None
|
||||
self._present_cost = 0.0
|
||||
self._doorways: dict[Node, list[tuple[int, int]]] = {}
|
||||
self._pending: dict[int, int] = {}
|
||||
# Rip-up as a transaction: the connections a rip-up route crosses are
|
||||
@@ -208,6 +221,12 @@ class GridRouter:
|
||||
self._escape_cells = 12
|
||||
self._crowded_cache: dict = {}
|
||||
self._trapped_cache: dict = {}
|
||||
# pin location -> where a pin on a turned fine-pitch pad leaves its
|
||||
# pin row along the pad's axis (None: it leaves like any other pin)
|
||||
self._axis_exits: dict[IntPoint, IntPoint | None] = {}
|
||||
# and the other nets' pads near each such pin, its stubs' obstacles
|
||||
self._axis_pads: dict[IntPoint, list] = {}
|
||||
self._part_centres: dict[int, tuple[float, float] | None] = {}
|
||||
self.heuristic_weight = max(float(heuristic_weight), 1.0)
|
||||
self.trace_width = max(trace_width, 1)
|
||||
self.clearance = max(clearance, 0)
|
||||
@@ -299,9 +318,15 @@ class GridRouter:
|
||||
self._zone_cells: dict[int, list[Node]] = {}
|
||||
# per-connection occupancy (owner = connection index)
|
||||
self._cell_owner: dict[Node, int] = {}
|
||||
self._via_owner: dict[Cell, int] = {}
|
||||
# Node -> connections whose stub comes near it. A cell has one owner,
|
||||
# and a stub claims only cells nobody owns yet, so where several pins
|
||||
# leave side by side (a QFN turned 45 degrees: neighbours 0.35 mm apart
|
||||
# on each axis) the cell two stubs share names only the first, and the
|
||||
# exact check between the later stubs would never run.
|
||||
self._stub_near: dict[Node, set[int]] = {}
|
||||
# every connection whose via covers a cell, in claim order: a via two
|
||||
# connections share still blocks after the first of them is ripped
|
||||
# connections share still blocks after the first of them is ripped,
|
||||
# and a route through it must rip all of them
|
||||
self._via_claims: dict[Cell, list[int]] = {}
|
||||
# trace halos: node -> indices of the connections claiming it
|
||||
self._halo: dict[Node, list[int]] = {}
|
||||
@@ -520,14 +545,19 @@ class GridRouter:
|
||||
if owner is not None and conns[owner].net_no != net_no:
|
||||
blocking = owner
|
||||
else:
|
||||
via_owner = self._via_owner.get(cell)
|
||||
if via_owner is not None and conns[via_owner].net_no != net_no:
|
||||
blocking = via_owner
|
||||
blocking = self._via_blocker(cell, net_no, conns)
|
||||
if blocking is None:
|
||||
for i in self._halo.get(node, ()):
|
||||
if conns[i].net_no != net_no:
|
||||
blocking = i
|
||||
break
|
||||
if blocking is None:
|
||||
# another net's pin stub comes too close, though the cell it once
|
||||
# claimed may since have been freed by a rip of its first owner
|
||||
for i in self._stub_near.get(node, ()):
|
||||
if conns[i].net_no != net_no:
|
||||
blocking = i
|
||||
break
|
||||
if blocking is None:
|
||||
return 0.0
|
||||
if not allow_ripup:
|
||||
@@ -537,6 +567,17 @@ class GridRouter:
|
||||
return None
|
||||
return self.rip_penalty * (1 + rip_count)
|
||||
|
||||
def _via_others(self, cell: Cell, net_no: int, conns: list[_Connection]) -> list[int]:
|
||||
"""Connections of other nets whose via covers ``cell``: all of them,
|
||||
since two connections of a net can share one via."""
|
||||
return [i for i in self._via_claims.get(cell, ()) if conns[i].net_no != net_no]
|
||||
|
||||
def _via_blocker(self, cell: Cell, net_no: int, conns: list[_Connection]) -> int | None:
|
||||
"""The other net's via connection on ``cell`` hardest to rip (the
|
||||
penalty and the rip cap go by it), or None."""
|
||||
others = self._via_others(cell, net_no, conns)
|
||||
return max(others, key=lambda i: conns[i].rip_count) if others else None
|
||||
|
||||
def _via_cells(self, cell: Cell) -> list[Cell]:
|
||||
"""The cell a via sits in plus the neighbours its copper reaches."""
|
||||
r = self.via_reach
|
||||
@@ -758,6 +799,8 @@ class GridRouter:
|
||||
continue
|
||||
if self._doorways:
|
||||
enter += self._access(nxt, net_no)
|
||||
if self._history or self._present is not None:
|
||||
enter += self._congestion(nxt, net_no)
|
||||
step = 1.0 if dx == 0 or dy == 0 else math.sqrt(2)
|
||||
self._relax(
|
||||
current, nxt, base + step + enter, goal_cell, g_score, came_from, open_heap
|
||||
@@ -770,9 +813,12 @@ class GridRouter:
|
||||
if layer == cl:
|
||||
continue
|
||||
nxt = (cx, cy, layer)
|
||||
if g_via < g_score.get(nxt, math.inf):
|
||||
g_layer = g_via
|
||||
if self._history or self._present is not None:
|
||||
g_layer += self._congestion(nxt, net_no)
|
||||
if g_layer < g_score.get(nxt, math.inf):
|
||||
heapq.heappush(
|
||||
open_heap, (g_via + self._h(nxt, goal_cell), nxt, g_via, current)
|
||||
open_heap, (g_layer + self._h(nxt, goal_cell), nxt, g_layer, current)
|
||||
)
|
||||
return None
|
||||
|
||||
@@ -833,30 +879,143 @@ class GridRouter:
|
||||
clearance of the pad next door, though the straight exit clears it.
|
||||
"""
|
||||
end = self._cell_center(cell)
|
||||
dx, dy = end.x - pin_location.x, end.y - pin_location.y
|
||||
head = [pin_location]
|
||||
start = pin_location
|
||||
exit_point = self._axis_exits.get(pin_location)
|
||||
if exit_point is not None:
|
||||
# a pin on a turned fine-pitch pad first leaves along the pad's
|
||||
# axis, past the pin row, then takes the usual L to its cell
|
||||
head = [pin_location, exit_point]
|
||||
start = exit_point
|
||||
dx, dy = end.x - start.x, end.y - start.y
|
||||
if not self._orthogonal or dx == 0 or dy == 0:
|
||||
return [pin_location, end]
|
||||
if abs(dx) >= abs(dy):
|
||||
return [pin_location, IntPoint(end.x, pin_location.y), end]
|
||||
return [pin_location, IntPoint(pin_location.x, end.y), end]
|
||||
tail = [end]
|
||||
elif abs(dx) >= abs(dy):
|
||||
tail = [IntPoint(end.x, start.y), end]
|
||||
else:
|
||||
tail = [IntPoint(start.x, end.y), end]
|
||||
points = []
|
||||
for point in head + tail:
|
||||
if not points or points[-1] != point:
|
||||
points.append(point)
|
||||
return points if len(points) > 1 else [pin_location, end]
|
||||
|
||||
def _leg_shapes(self, points: list[IntPoint], half: int, grow: int = 0) -> list:
|
||||
"""A stub's copper, grown by ``grow``: a box per straight leg and per
|
||||
inner corner, and an exact slab for a slanted leg (a pad-axis exit),
|
||||
whose bounding box would reach the neighbouring pads."""
|
||||
shapes: list = []
|
||||
for a, b in zip(points, points[1:], strict=False):
|
||||
if a == b:
|
||||
continue
|
||||
if a.x == b.x or a.y == b.y:
|
||||
box = segment_box(a, b, half)
|
||||
shapes.append(box.offset(grow) if grow else box)
|
||||
else:
|
||||
shapes.append(segment_slab(a, b, half + grow))
|
||||
for c in points[1:-1]:
|
||||
box = corner_box(c, half)
|
||||
shapes.append(box.offset(grow) if grow else box)
|
||||
return shapes
|
||||
|
||||
def _axis_exit(self, pin: Pin) -> IntPoint | None:
|
||||
"""Where a pin on a turned fine-pitch pad clears its pin row.
|
||||
|
||||
A QFN placed at 45 degrees has no straight exit on the grid: every
|
||||
horizontal or vertical step from a pin passes its neighbours closer
|
||||
than the clearance. The way out is along the pad's own axis, away
|
||||
from the part, until an L from there to a grid cell clears every
|
||||
other net's pad (checked on exact shapes, as the exact engine will).
|
||||
Any angle off the grid axes counts, not just 45 degrees.
|
||||
"""
|
||||
loc = pin.location
|
||||
if loc in self._axis_exits:
|
||||
return self._axis_exits[loc]
|
||||
self._axis_exits[loc] = None
|
||||
shape = pin.shape
|
||||
if not isinstance(shape, Simplex) or shape.is_int_box():
|
||||
return None
|
||||
corners = [shape.corner_approx(i) for i in range(shape.border_line_count())]
|
||||
edges = [(b.x - a.x, b.y - a.y) for a, b in zip(corners, corners[1:] + corners[:1], strict=False)]
|
||||
lengths = [math.hypot(dx, dy) for dx, dy in edges]
|
||||
if len(edges) < 3 or max(lengths) < 1.25 * min(lengths):
|
||||
return None # no long axis to leave along
|
||||
dx, dy = edges[lengths.index(max(lengths))]
|
||||
ux, uy = dx / max(lengths), dy / max(lengths)
|
||||
if min(abs(ux), abs(uy)) < 0.17:
|
||||
return None # within ten degrees of a grid axis: the usual exits work
|
||||
centre = self._part_centre(pin)
|
||||
if centre is None:
|
||||
return None
|
||||
if (loc.x - centre[0]) * ux + (loc.y - centre[1]) * uy < 0:
|
||||
ux, uy = -ux, -uy
|
||||
reach = max((c.x - loc.x) * ux + (c.y - loc.y) * uy for c in corners)
|
||||
h, cl = self.half_width, self.clearance
|
||||
span = reach + h + cl + 16 * self.step
|
||||
others = [
|
||||
p.shape for p in self.board.get_pins()
|
||||
if p.shape is not None and p is not pin and not set(p.net_nos) & set(pin.net_nos)
|
||||
and set(p.layers) & set(pin.layers)
|
||||
and abs(p.location.x - loc.x) < 2 * span and abs(p.location.y - loc.y) < 2 * span
|
||||
]
|
||||
self._axis_pads[loc] = others
|
||||
for j in range(16):
|
||||
d = reach + h + cl + j * self.step / 2
|
||||
exit_point = IntPoint(round(loc.x + ux * d), round(loc.y + uy * d))
|
||||
out = segment_slab(loc, exit_point, h + cl)
|
||||
if any(overlaps_2d(out, o) for o in others):
|
||||
continue
|
||||
ex, ey = self._cell_of(exit_point)
|
||||
self._axis_exits[loc] = exit_point
|
||||
for ddx, ddy in itertools.product((0, -1, 1), repeat=2):
|
||||
cell = (ex + ddx, ey + ddy)
|
||||
if not (0 <= cell[0] < self.cols and 0 <= cell[1] < self.rows):
|
||||
continue
|
||||
legs = self._leg_shapes(self._stub_points(loc, cell)[1:], h, cl)
|
||||
if not any(overlaps_2d(g, o) for g in legs for o in others):
|
||||
return exit_point
|
||||
self._axis_exits[loc] = None
|
||||
return None
|
||||
|
||||
def _exit_clips_a_pad(self, pin: Pin, cell: Cell) -> bool:
|
||||
"""Whether the stub from an axis exit to ``cell`` comes closer than the
|
||||
clearance to another net's pad (exactly, as the exact engine checks):
|
||||
the exit was chosen with one clear cell, not every cell around it."""
|
||||
legs = self._leg_shapes(
|
||||
self._stub_points(pin.location, cell)[1:], self._cur_half, self.clearance
|
||||
)
|
||||
return any(overlaps_2d(g, pad) for g in legs for pad in self._axis_pads.get(pin.location, ()))
|
||||
|
||||
def _part_centre(self, pin: Pin) -> tuple[float, float] | None:
|
||||
key = pin.component_no
|
||||
if key not in self._part_centres:
|
||||
mates = [p.location for p in self.board.get_pins() if p.component_no == key] if key else []
|
||||
self._part_centres[key] = (
|
||||
(sum(m.x for m in mates) / len(mates), sum(m.y for m in mates) / len(mates))
|
||||
if len(mates) > 2 else None
|
||||
)
|
||||
return self._part_centres[key]
|
||||
|
||||
def _stub_cells(self, pin_location: IntPoint, cell: Cell, half: int | None = None) -> list[Cell]:
|
||||
"""Cells where another net's trace would come too close to the stub."""
|
||||
from freeroute.board.outline import _point_segment
|
||||
|
||||
points = self._stub_points(pin_location, cell)
|
||||
end = points[-1]
|
||||
reach = (half or self._cur_half) + self.half_width + self.clearance
|
||||
box = IntBox(
|
||||
min(pin_location.x, end.x), min(pin_location.y, end.y),
|
||||
max(pin_location.x, end.x), max(pin_location.y, end.y),
|
||||
min(p.x for p in points), min(p.y for p in points),
|
||||
max(p.x for p in points), max(p.y for p in points),
|
||||
)
|
||||
legs = list(zip(points, points[1:], strict=False))
|
||||
return [
|
||||
c
|
||||
for c in self._cells_in_box(box, reach)
|
||||
if min(_point_segment(self._cell_center(c), a, b) for a, b in legs) < reach
|
||||
]
|
||||
joints = points[1:] # each carries a square corner tile
|
||||
|
||||
def near(c) -> bool:
|
||||
p = self._cell_center(c)
|
||||
if min(_point_segment(p, a, b) for a, b in legs) < reach:
|
||||
return True
|
||||
return any(max(abs(p.x - j.x), abs(p.y - j.y)) < reach for j in joints)
|
||||
|
||||
return [c for c in self._cells_in_box(box, reach) if near(c)]
|
||||
|
||||
def _stub_clear(
|
||||
self,
|
||||
@@ -872,13 +1031,12 @@ class GridRouter:
|
||||
if keepouts:
|
||||
# the stub is off the grid, so check it exactly, as the exact
|
||||
# engine will: its copper grown by clearance must miss every keepout
|
||||
from freeroute.geometry.polyline import Polyline, PolylineShape
|
||||
|
||||
points = self._stub_points(pin.location, cell)
|
||||
if points[-1] != pin.location:
|
||||
for tile in PolylineShape(Polyline(points), self._cur_half).tiles():
|
||||
grown = tile.offset(self.clearance)
|
||||
if any(k.overlaps(grown if needs else tile) for k, needs in keepouts):
|
||||
legs = self._leg_shapes(points, self._cur_half)
|
||||
grown_legs = self._leg_shapes(points, self._cur_half, self.clearance)
|
||||
for tile, grown in zip(legs, grown_legs, strict=True):
|
||||
if any(overlaps_2d(k, grown if needs else tile) for k, needs in keepouts):
|
||||
return False
|
||||
# the track's round end at the pin, for a rule area
|
||||
cap = corner_box(pin.location, self._cur_half)
|
||||
@@ -892,15 +1050,16 @@ class GridRouter:
|
||||
allow_ripup and all(conns[i].rip_count < self.rip_cap for i in owners)
|
||||
)
|
||||
|
||||
def _stub_tiles(self, pin_location: IntPoint, cell: Cell, half: int) -> list[IntBox]:
|
||||
"""The stub's copper: its legs, and a square at each corner and at the
|
||||
cell end, where the route carries on."""
|
||||
def _stub_tiles(self, pin_location: IntPoint, cell: Cell, half: int, grow: int = 0) -> list:
|
||||
"""The stub's copper (grown by ``grow``): its legs, and a square at each
|
||||
corner and at the cell end, where the route carries on."""
|
||||
points = self._stub_points(pin_location, cell)
|
||||
tiles = [corner_box(point, half) for point in points[1:]]
|
||||
tiles: list = [
|
||||
corner_box(point, half).offset(grow) if grow else corner_box(point, half)
|
||||
for point in points[1:]
|
||||
]
|
||||
if len(points) > 1 and points[-1] != pin_location:
|
||||
from freeroute.geometry.polyline import Polyline, PolylineShape
|
||||
|
||||
tiles += PolylineShape(Polyline(points), half).tiles()
|
||||
tiles += self._leg_shapes(points, half, grow)
|
||||
return tiles
|
||||
|
||||
def _stub_owners(
|
||||
@@ -920,16 +1079,24 @@ class GridRouter:
|
||||
other = [tiles for lay, tiles, nodes in conns[owner].stubs if node in nodes]
|
||||
if other:
|
||||
if grown is None:
|
||||
grown = [
|
||||
t.offset(self.clearance)
|
||||
for t in self._stub_tiles(pin.location, cell, half or self._cur_half)
|
||||
]
|
||||
if not any(g.overlaps(t) for tiles in other for t in tiles for g in grown):
|
||||
grown = self._stub_tiles(
|
||||
pin.location, cell, half or self._cur_half, self.clearance
|
||||
)
|
||||
if not any(overlaps_2d(g, t) for tiles in other for t in tiles for g in grown):
|
||||
continue
|
||||
owners.add(owner)
|
||||
via_owner = self._via_owner.get(c)
|
||||
if via_owner is not None and conns[via_owner].net_no != net_no:
|
||||
owners.add(via_owner)
|
||||
for idx in self._stub_near.get(node, ()):
|
||||
if idx in owners or conns[idx].net_no == net_no:
|
||||
continue
|
||||
theirs = [tiles for lay, tiles, _ in conns[idx].stubs if lay == layer]
|
||||
if theirs:
|
||||
if grown is None:
|
||||
grown = self._stub_tiles(
|
||||
pin.location, cell, half or self._cur_half, self.clearance
|
||||
)
|
||||
if any(overlaps_2d(g, t) for tiles in theirs for t in tiles for g in grown):
|
||||
owners.add(idx)
|
||||
owners.update(self._via_others(c, net_no, conns))
|
||||
return owners
|
||||
|
||||
def _end_penalty(self, pin: Pin, node: Node, net_no: int, allow_ripup: bool, conns) -> float:
|
||||
@@ -1009,11 +1176,16 @@ class GridRouter:
|
||||
return self._cell_of(IntPoint((box.ll.x + box.ur.x) // 2, (box.ll.y + box.ur.y) // 2))
|
||||
|
||||
def _stub_cost(self, pin: Pin, node: Node) -> float:
|
||||
c = self._cell_center(node[:2])
|
||||
dx, dy = abs(c.x - pin.location.x), abs(c.y - pin.location.y)
|
||||
if self._orthogonal: # measured the way the route itself is allowed to move
|
||||
return (dx + dy) / self.step
|
||||
return math.hypot(dx, dy) / self.step
|
||||
if self._axis_exits.get(pin.location) is None:
|
||||
c = self._cell_center(node[:2])
|
||||
dx, dy = abs(c.x - pin.location.x), abs(c.y - pin.location.y)
|
||||
if self._orthogonal: # measured the way the route itself is allowed to move
|
||||
return (dx + dy) / self.step
|
||||
return math.hypot(dx, dy) / self.step
|
||||
points = self._stub_points(pin.location, node[:2])
|
||||
return sum(
|
||||
math.hypot(b.x - a.x, b.y - a.y) for a, b in zip(points, points[1:], strict=False)
|
||||
) / self.step
|
||||
|
||||
def _end_nodes(self, pin: Pin, net_no: int, conns, allow_ripup: bool = False) -> set[Node]:
|
||||
"""Nodes a route may start or end on for ``pin``: the nearest cell and
|
||||
@@ -1023,14 +1195,21 @@ class GridRouter:
|
||||
everywhere else, or a pin whose only way out another net has taken
|
||||
could never have it back."""
|
||||
layers = [layer for layer in pin.layers if layer in self.layers]
|
||||
cx, cy = self._cell_of(pin.location)
|
||||
exit_point = None
|
||||
if self._orthogonal and self._crowded(pin, net_no):
|
||||
exit_point = self._axis_exit(pin)
|
||||
cx, cy = self._cell_of(exit_point if exit_point is not None else pin.location)
|
||||
nodes: set[Node] = set()
|
||||
for dx, dy in ((0, 0), *self._neighbours):
|
||||
cell = (cx + dx, cy + dy)
|
||||
if not (0 <= cell[0] < self.cols and 0 <= cell[1] < self.rows):
|
||||
continue
|
||||
if exit_point is not None and self._exit_clips_a_pad(pin, cell):
|
||||
continue
|
||||
for layer in layers:
|
||||
if (dx or dy) and self._enter_cost(cell, layer, net_no, allow_ripup, conns) is None:
|
||||
# the pin's own cell is in its pad; an exit cell is not
|
||||
checked = dx or dy or exit_point is not None
|
||||
if checked and self._enter_cost(cell, layer, net_no, allow_ripup, conns) is None:
|
||||
continue
|
||||
if self._stub_clear(pin, cell, layer, net_no, conns, allow_ripup=allow_ripup):
|
||||
nodes.add((*cell, layer))
|
||||
@@ -1040,6 +1219,11 @@ class GridRouter:
|
||||
# cost, so it is only taken where a short step would not do.
|
||||
if self._orthogonal and self._crowded(pin, net_no) and self._trapped(pin, net_no, nodes):
|
||||
nodes |= self._escape_nodes(pin, net_no, conns, layers, (cx, cy), allow_ripup)
|
||||
if not nodes and exit_point is not None:
|
||||
# every cell past the pin row is taken: report no way out, so the
|
||||
# search goes on to rip-up, rather than fall back to a cell out in
|
||||
# the open on top of another net's route
|
||||
return nodes
|
||||
if not nodes: # nothing clear: fall back to the nearest cell, as before
|
||||
nodes = {(cx, cy, layer) for layer in layers}
|
||||
if self._keepout_boxes and not any(
|
||||
@@ -1113,7 +1297,6 @@ class GridRouter:
|
||||
whose stub from the pin clears every other net's pad by the full
|
||||
clearance, checked on the stub's copper tiles as the exact engine
|
||||
will rather than on the grid."""
|
||||
from freeroute.geometry.polyline import Polyline, PolylineShape
|
||||
|
||||
reach = self._escape_cells
|
||||
near = [
|
||||
@@ -1135,17 +1318,14 @@ class GridRouter:
|
||||
cell = (cx + dx * k + sx, cy + dy * k + sy)
|
||||
if not (0 <= cell[0] < self.cols and 0 <= cell[1] < self.rows):
|
||||
break
|
||||
grown = [
|
||||
tile.offset(self.clearance)
|
||||
for tile in PolylineShape(
|
||||
Polyline(self._stub_points(pin.location, cell)), self._cur_half
|
||||
).tiles()
|
||||
]
|
||||
grown = self._leg_shapes(
|
||||
self._stub_points(pin.location, cell), self._cur_half, self.clearance
|
||||
)
|
||||
for layer in layers:
|
||||
if self._enter_cost(cell, layer, net_no, allow_ripup, conns) is None:
|
||||
continue
|
||||
if any(
|
||||
layer in box_layers and any(g.overlaps(box) for g in grown)
|
||||
layer in box_layers and any(overlaps_2d(g, box) for g in grown)
|
||||
for box, box_layers in near
|
||||
):
|
||||
continue
|
||||
@@ -1206,9 +1386,9 @@ class GridRouter:
|
||||
if conn.index not in claims:
|
||||
claims.append(conn.index)
|
||||
conn.via_halo.append(c)
|
||||
self._via_owner.setdefault(c, conn.index)
|
||||
ends = ((conn.a_end, wire_segs[0], 0), (conn.b_end, wire_segs[-1], -1)) if wire_segs else ()
|
||||
conn.stubs = []
|
||||
self._forget_stubs(conn)
|
||||
for pin, (layer, cells), at in ends:
|
||||
if not isinstance(pin, Pin):
|
||||
continue # ended on a zone or a plane: no stub
|
||||
@@ -1216,6 +1396,8 @@ class GridRouter:
|
||||
claimed: set[Node] = set()
|
||||
for c in self._stub_cells(pin.location, cell, half):
|
||||
node = (*c, layer)
|
||||
self._stub_near.setdefault(node, set()).add(conn.index)
|
||||
conn.stub_near.append(node)
|
||||
if node not in self._cell_owner:
|
||||
self._cell_owner[node] = conn.index
|
||||
conn.trace_cells.append((c, layer))
|
||||
@@ -1251,6 +1433,15 @@ class GridRouter:
|
||||
conn.routed = True
|
||||
self._settle(conn, -1)
|
||||
|
||||
def _forget_stubs(self, conn: _Connection) -> None:
|
||||
for node in conn.stub_near:
|
||||
near = self._stub_near.get(node)
|
||||
if near is not None:
|
||||
near.discard(conn.index)
|
||||
if not near:
|
||||
del self._stub_near[node]
|
||||
conn.stub_near = []
|
||||
|
||||
def _rip(self, conn: _Connection) -> None:
|
||||
for cell, layer in conn.trace_cells:
|
||||
if self._cell_owner.get((*cell, layer)) == conn.index:
|
||||
@@ -1259,11 +1450,6 @@ class GridRouter:
|
||||
claims = self._via_claims.get(cell)
|
||||
if claims is not None and conn.index in claims:
|
||||
claims.remove(conn.index)
|
||||
if self._via_owner.get(cell) == conn.index:
|
||||
if claims:
|
||||
self._via_owner[cell] = claims[0]
|
||||
else:
|
||||
del self._via_owner[cell]
|
||||
if claims is not None and not claims:
|
||||
del self._via_claims[cell]
|
||||
conn.via_halo = []
|
||||
@@ -1276,6 +1462,7 @@ class GridRouter:
|
||||
conn.halo_nodes = []
|
||||
conn.trace_cells = []
|
||||
conn.stubs = []
|
||||
self._forget_stubs(conn)
|
||||
for cell in conn.via_cells:
|
||||
count = self._via_nets.get(cell)
|
||||
if count and count.get(conn.net_no):
|
||||
@@ -1308,12 +1495,13 @@ class GridRouter:
|
||||
owner = self._cell_owner.get((cx, cy, cl))
|
||||
if owner is not None and conns[owner].net_no != net_no:
|
||||
owners.add(owner)
|
||||
via_owner = self._via_owner.get((cx, cy))
|
||||
if via_owner is not None and conns[via_owner].net_no != net_no:
|
||||
owners.add(via_owner)
|
||||
owners.update(self._via_others((cx, cy), net_no, conns))
|
||||
for i in self._halo.get((cx, cy, cl), ()):
|
||||
if conns[i].net_no != net_no:
|
||||
owners.add(i)
|
||||
for i in self._stub_near.get((cx, cy, cl), ()):
|
||||
if conns[i].net_no != net_no:
|
||||
owners.add(i)
|
||||
return owners
|
||||
|
||||
# --- pin access ---------------------------------------------------------
|
||||
@@ -1360,6 +1548,74 @@ class GridRouter:
|
||||
return self.access_cost
|
||||
return 0.0
|
||||
|
||||
# --- negotiated congestion --------------------------------------------
|
||||
|
||||
def _congestion(self, node: Node, net_no: int) -> float:
|
||||
"""History of a contested cell, plus while negotiating the price of
|
||||
sharing it with the other nets on it now."""
|
||||
cost = self._history.get(node, 0.0)
|
||||
if self._present is not None:
|
||||
users = self._present.get(node)
|
||||
if users:
|
||||
others = len(users) - (1 if net_no in users else 0)
|
||||
cost += self._present_cost * others
|
||||
return cost
|
||||
|
||||
def _footprint(self, path: list[Node]) -> set[Node]:
|
||||
"""The nodes a route claims: its cells and their clearance halo on
|
||||
its layer, and every via's footprint on all layers."""
|
||||
wire_segs, via_cells = _split_path(path)
|
||||
halo = [(0, 0), *self._halo_offsets]
|
||||
nodes: set[Node] = set()
|
||||
for layer, cells in wire_segs:
|
||||
for cx, cy in cells:
|
||||
for dx, dy in halo:
|
||||
nodes.add((cx + dx, cy + dy, layer))
|
||||
for cell in via_cells:
|
||||
for c in self._via_cells(cell):
|
||||
for layer in self.layers:
|
||||
nodes.add((*c, layer))
|
||||
return nodes
|
||||
|
||||
def _negotiate(self, order: list[_Connection], conns: list[_Connection]) -> None:
|
||||
"""Route every connection on the empty board ``self.negotiate`` times,
|
||||
letting routes share cells at a price: the number of other nets on a
|
||||
cell times a factor that doubles every round, plus the cell's history,
|
||||
which grows by one for every extra net each round it stays shared.
|
||||
Only the history is kept; the board is left empty."""
|
||||
present: dict[Node, dict[int, int]] = {}
|
||||
claimed: dict[int, set[Node]] = {}
|
||||
ends = [(c, c.a_end, c.b_end) for c in conns]
|
||||
self._present, self._present_cost = present, 0.5
|
||||
try:
|
||||
for _ in range(self.negotiate):
|
||||
for conn in order:
|
||||
for node in claimed.pop(conn.index, ()):
|
||||
users = present[node]
|
||||
users[conn.net_no] -= 1
|
||||
if not users[conn.net_no]:
|
||||
del users[conn.net_no]
|
||||
path = self._search(conn, allow_ripup=False, conns=conns)
|
||||
if path is None:
|
||||
continue
|
||||
nodes = self._footprint(path)
|
||||
claimed[conn.index] = nodes
|
||||
for node in nodes:
|
||||
users = present.setdefault(node, {})
|
||||
users[conn.net_no] = users.get(conn.net_no, 0) + 1
|
||||
shared = 0
|
||||
for node, users in present.items():
|
||||
if len(users) > 1:
|
||||
shared += 1
|
||||
self._history[node] = self._history.get(node, 0.0) + len(users) - 1
|
||||
if not shared:
|
||||
break
|
||||
self._present_cost *= 2
|
||||
finally:
|
||||
self._present = None
|
||||
for conn, a_end, b_end in ends: # the search picks ends; undo that
|
||||
conn.a_end, conn.b_end = a_end, b_end
|
||||
|
||||
# --- passes -------------------------------------------------------------
|
||||
|
||||
def route(self) -> RouteResult:
|
||||
@@ -1383,6 +1639,8 @@ class GridRouter:
|
||||
if self.route_first:
|
||||
# stable: the promoted keep their order among themselves, as do the rest
|
||||
order.sort(key=lambda c: (c.net_no, *_ends_of(c)) not in self.route_first)
|
||||
if self.negotiate:
|
||||
self._negotiate(order, conns)
|
||||
for _ in range(passes):
|
||||
changed = False
|
||||
for conn in order:
|
||||
@@ -1779,6 +2037,7 @@ def route_board(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
rollback: bool = True,
|
||||
net_widths: dict[int, int] | None = None,
|
||||
via_drill: int | None = None,
|
||||
@@ -1801,6 +2060,7 @@ def route_board(
|
||||
seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
rollback=rollback,
|
||||
net_widths=net_widths,
|
||||
via_drill=via_drill,
|
||||
|
||||
@@ -118,6 +118,7 @@ def route_dsn_board(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
hole_to_hole_mm: float = 0.25,
|
||||
rollback: bool = True,
|
||||
) -> tuple[RouteResult, int, list[str]]:
|
||||
@@ -143,6 +144,7 @@ def route_dsn_board(
|
||||
seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
rollback=rollback,
|
||||
net_widths=_net_widths_board(dsn, scale),
|
||||
via_drill=_via_drill_board(dsn, scale),
|
||||
@@ -196,6 +198,7 @@ def build_routing_result(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
hole_to_hole_mm: float = 0.25,
|
||||
rollback: bool = True,
|
||||
) -> RoutingResult:
|
||||
@@ -205,6 +208,7 @@ def build_routing_result(
|
||||
edge_clearance_mm=edge_clearance_mm, resolution=resolution, seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
hole_to_hole_mm=hole_to_hole_mm,
|
||||
rollback=rollback,
|
||||
)
|
||||
@@ -225,6 +229,7 @@ def route_dsn_board_exact(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
hole_to_hole_mm: float = 0.25,
|
||||
rollback: bool = True,
|
||||
) -> tuple[ExactRouteResult, int, list[str]]:
|
||||
@@ -254,6 +259,7 @@ def route_dsn_board_exact(
|
||||
seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
rollback=rollback,
|
||||
net_widths=_net_widths_board(dsn, scale),
|
||||
via_drill=_via_drill_board(dsn, scale),
|
||||
@@ -276,6 +282,7 @@ def build_exact_routing_result(
|
||||
seed: int | None = None,
|
||||
route_first: frozenset | None = None,
|
||||
access_cost: float = 0.0,
|
||||
negotiate: int = 0,
|
||||
hole_to_hole_mm: float = 0.25,
|
||||
rollback: bool = True,
|
||||
) -> RoutingResult:
|
||||
@@ -293,6 +300,7 @@ def build_exact_routing_result(
|
||||
seed=seed,
|
||||
route_first=route_first,
|
||||
access_cost=access_cost,
|
||||
negotiate=negotiate,
|
||||
hole_to_hole_mm=hole_to_hole_mm,
|
||||
rollback=rollback,
|
||||
)
|
||||
|
||||
@@ -0,0 +1,113 @@
|
||||
"""Pins of a fine-pitch part turned off the grid axes leave along their pads.
|
||||
|
||||
A QFN at 45 degrees has no straight exit: every horizontal or vertical step
|
||||
from a pin passes its neighbours closer than the clearance (0.35 mm away on
|
||||
each axis at 0.5 mm pitch). The grid leaves along the pad's own axis first,
|
||||
past the pin row, and the exact engine checks that slanted leg on its exact
|
||||
copper. Found on th-eda's lift ESC, where a QFN-24 at 45 degrees left 15
|
||||
connections unroutable on an empty board.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import math
|
||||
|
||||
import pytest
|
||||
|
||||
from freeroute.board import build_board
|
||||
from freeroute.dsn import parse_dsn
|
||||
from freeroute.geometry import IntPoint, overlaps_2d, segment_slab
|
||||
from freeroute.route.grid_router import GridRouter
|
||||
from freeroute.route.pipeline import (
|
||||
_rule_clearance_dsn,
|
||||
_rule_width_dsn,
|
||||
_via_half_board,
|
||||
build_exact_routing_result,
|
||||
)
|
||||
|
||||
|
||||
def _qfn_side_dsn(rotation: float) -> str:
|
||||
"""Two rows of five 0.25 x 0.8 mm pads at 0.5 mm pitch (one side of a
|
||||
QFN and its opposite side), turned by ``rotation``; each pin of the top
|
||||
row is its own net, routed to a pad 4.5 mm out, the pads fanned 1.5 mm
|
||||
apart."""
|
||||
cx, cy = 100000, -100000
|
||||
t = math.radians(rotation)
|
||||
out = (-math.sin(t), math.cos(t)) # the pads' outward axis after turning
|
||||
along = (math.cos(t), math.sin(t)) # the pin row
|
||||
pins, targets, nets = [], [], []
|
||||
for i in range(5):
|
||||
x = -1000 + 500 * i
|
||||
pins += [f"(pin P {i + 1} {x} 1000)", f"(pin P {i + 6} {x} -1000)"]
|
||||
px = cx + x * math.cos(t) - 1000 * math.sin(t)
|
||||
py = cy + x * math.sin(t) + 1000 * math.cos(t)
|
||||
spread = 1500 * (i - 2) - x # fan the far pads out to 1.5 mm apart
|
||||
tx = px + 4500 * out[0] + spread * along[0]
|
||||
ty = py + 4500 * out[1] + spread * along[1]
|
||||
targets.append(f"(place T{i + 1} {round(tx)} {round(ty)} front 0)")
|
||||
nets.append(f"(net N{i} (pins U1-{i + 1} T{i + 1}-1))")
|
||||
return f"""(pcb qfn (parser) (resolution um 10) (unit um)
|
||||
(structure
|
||||
(layer F.Cu (type signal)) (layer B.Cu (type signal))
|
||||
(boundary (path pcb 0 115000 -115000 85000 -115000 85000 -85000 115000 -85000
|
||||
115000 -115000))
|
||||
(via "Via[0-1]_450:200_um")
|
||||
(rule (width 150) (clearance 150)))
|
||||
(placement
|
||||
(component Q (place U1 {cx} {cy} front {rotation}))
|
||||
(component T {" ".join(targets)}))
|
||||
(library
|
||||
(image Q {" ".join(pins)})
|
||||
(image T (pin t 1 0 0))
|
||||
(padstack P (shape (rect F.Cu -125 -400 125 400)) (attach off))
|
||||
(padstack t (shape (rect F.Cu -300 -300 300 300)) (attach off))
|
||||
(padstack "Via[0-1]_450:200_um" (shape (circle F.Cu 450)) (shape (circle B.Cu 450))
|
||||
(attach off)))
|
||||
(network {" ".join(nets)}))"""
|
||||
|
||||
|
||||
@pytest.mark.parametrize("rotation", [45, 30, -45])
|
||||
def test_a_turned_fine_pitch_part_gets_its_pins_out(rotation):
|
||||
result = build_exact_routing_result(parse_dsn(_qfn_side_dsn(rotation)), resolution=2, shove=True)
|
||||
assert result.unrouted == []
|
||||
|
||||
|
||||
def test_the_exit_runs_along_the_pad_axis_and_clears_the_neighbours():
|
||||
dsn = parse_dsn(_qfn_side_dsn(45))
|
||||
s = dsn.resolution.value
|
||||
board = build_board(dsn)
|
||||
router = GridRouter(
|
||||
board,
|
||||
trace_width=round(_rule_width_dsn(dsn) * s),
|
||||
clearance=round(_rule_clearance_dsn(dsn) * s),
|
||||
via_half=_via_half_board(dsn, s),
|
||||
orthogonal=True,
|
||||
)
|
||||
pins = {p.name: p for p in board.get_pins() if p.component_ref == "U1"}
|
||||
pin = pins["3"]
|
||||
exit_point = router._axis_exit(pin)
|
||||
assert exit_point is not None
|
||||
dx, dy = exit_point.x - pin.location.x, exit_point.y - pin.location.y
|
||||
assert abs(abs(dx) - abs(dy)) <= 2 # along the 45-degree axis
|
||||
leg = segment_slab(pin.location, exit_point, router.half_width + router.clearance)
|
||||
for name in ("2", "4"):
|
||||
assert not overlaps_2d(leg, pins[name].shape)
|
||||
|
||||
|
||||
def test_a_pad_on_the_grid_axes_keeps_the_usual_exits():
|
||||
dsn = parse_dsn(_qfn_side_dsn(0))
|
||||
s = dsn.resolution.value
|
||||
board = build_board(dsn)
|
||||
router = GridRouter(board, trace_width=round(_rule_width_dsn(dsn) * s),
|
||||
clearance=round(_rule_clearance_dsn(dsn) * s), via_half=_via_half_board(dsn, s))
|
||||
pin = next(p for p in board.get_pins() if p.component_ref == "U1" and p.name == "3")
|
||||
assert router._axis_exit(pin) is None
|
||||
|
||||
|
||||
def test_a_slanted_slab_is_tight_where_a_bounding_box_is_not():
|
||||
slab = segment_slab(IntPoint(0, 0), IntPoint(10000, 10000), 750)
|
||||
# a point beside the diagonal but inside its bounding box
|
||||
from freeroute.geometry import IntBox
|
||||
|
||||
assert not overlaps_2d(slab, IntBox(8000, 0, 8100, 100))
|
||||
assert overlaps_2d(slab, IntBox(4900, 4900, 5100, 5100))
|
||||
@@ -143,11 +143,48 @@ def test_a_shared_via_keeps_its_footprint_when_one_user_is_ripped():
|
||||
router._rip(first)
|
||||
|
||||
assert second.routed and via in second.via_cells
|
||||
assert all(router._via_owner.get(c) == second.index for c in footprint)
|
||||
assert all(router._via_claims.get(c) == [second.index] for c in footprint)
|
||||
# another net still keeps its distance from the via that is left
|
||||
assert all(router._enter_cost_base(c, 0, sig.net_no, False, conns) is None for c in footprint)
|
||||
|
||||
|
||||
def test_a_route_through_a_shared_via_rips_every_user():
|
||||
"""Two connections of a net share a via. Another net routed through it
|
||||
in rip-up mode has to rip both, or the one left keeps its via under the
|
||||
new trace and the exact check throws one of them out."""
|
||||
dsn = parse_dsn(_SHARED_VIA)
|
||||
s = dsn.resolution.value
|
||||
router = GridRouter(
|
||||
build_board(dsn),
|
||||
trace_width=round(_rule_width_dsn(dsn) * s),
|
||||
clearance=round(_rule_clearance_dsn(dsn) * s),
|
||||
via_half=_via_half_board(dsn, s),
|
||||
)
|
||||
conns = router._conns = router._build_connections()
|
||||
gnd = [c for c in conns if len({c.a.component_ref, c.b.component_ref} & {"G1", "G2", "G3"})]
|
||||
sig = next(c for c in conns if c not in gnd)
|
||||
first, second = gnd
|
||||
g3 = router._cell_of(next(p for p in router.board.get_pins() if p.component_ref == "G3").location)
|
||||
via = (g3[0] - 10, g3[1])
|
||||
|
||||
def through_via(conn):
|
||||
a, b = router._cell_of(conn.a.location), router._cell_of(conn.b.location)
|
||||
return _line(a, via, 0) + _line(via, b, 1)
|
||||
|
||||
router._commit(first, through_via(first))
|
||||
router._commit(second, through_via(second))
|
||||
# the via's copper alone: footprint cells no trace or trace halo covers
|
||||
crossing = [
|
||||
node
|
||||
for c in router._via_cells(via)
|
||||
for node in ((*c, 0), (*c, 1))
|
||||
if node not in router._cell_owner and node not in router._halo
|
||||
]
|
||||
assert crossing
|
||||
|
||||
assert router._crossed_owners(crossing, sig.net_no, conns) == {first.index, second.index}
|
||||
|
||||
|
||||
# --- a wider net class --------------------------------------------------------
|
||||
|
||||
_WIDE = """(pcb wide (parser) (resolution um 10) (unit um)
|
||||
@@ -225,3 +262,23 @@ def test_a_pad_cell_check_uses_the_rotated_outline():
|
||||
c = router._cell_center(cell)
|
||||
square = IntBox(c.x - margin, c.y - margin, c.x + margin, c.y + margin)
|
||||
assert oval.shape.intersection(square).dimension() != 2
|
||||
|
||||
|
||||
def test_a_via_by_a_chamfered_corner_is_judged_round():
|
||||
"""The grid keeps a via's centre its radius plus the edge clearance from
|
||||
the outline. The exact check used the via's square, whose corner reaches
|
||||
past a 45-degree chamfer where the round via does not."""
|
||||
from freeroute.board.outline import BoardOutline
|
||||
from freeroute.geometry import IntBox, IntPoint
|
||||
from freeroute.route.exact_router import _inside_outline
|
||||
|
||||
# a 10 mm square with its lower-left corner cut at 45 degrees
|
||||
outline = BoardOutline([IntPoint(*p) for p in
|
||||
[(30, 0), (100, 0), (100, 100), (0, 100), (0, 30)]])
|
||||
half, edge = 4, 1
|
||||
via = IntPoint(19, 20) # its centre 6.4 from the chamfer x + y = 30
|
||||
square = IntBox(via.x - half, via.y - half, via.x + half, via.y + half)
|
||||
assert not outline.box_clear(square, edge) # the square's corner: 0.7 away
|
||||
assert _inside_outline(outline, [], [via], half + edge, edge)
|
||||
# 4.2 from the chamfer: the round via itself is too close
|
||||
assert not _inside_outline(outline, [], [IntPoint(18, 18)], half + edge, edge)
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
"""--negotiate: PathFinder-style rounds on the empty board before routing."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
from freeroute.board import build_board
|
||||
from freeroute.dsn import parse_dsn
|
||||
from freeroute.route.grid_router import GridRouter
|
||||
from freeroute.route.pipeline import _rule_clearance_dsn, _rule_width_dsn, route_dsn_board
|
||||
|
||||
FIXTURES = Path(__file__).resolve().parent.parent / "dsn" / "fixtures"
|
||||
|
||||
|
||||
def _router(name, negotiate):
|
||||
dsn = parse_dsn((FIXTURES / name).read_text())
|
||||
s = dsn.resolution.value
|
||||
return GridRouter(
|
||||
build_board(dsn),
|
||||
trace_width=round(_rule_width_dsn(dsn) * s),
|
||||
clearance=round(_rule_clearance_dsn(dsn) * s),
|
||||
negotiate=negotiate,
|
||||
)
|
||||
|
||||
|
||||
def test_negotiation_leaves_the_board_empty_and_the_ends_as_they_were():
|
||||
router = _router("true_density.dsn", 3)
|
||||
conns = router._conns = router._build_connections()
|
||||
ends = [(c.a_end, c.b_end) for c in conns]
|
||||
router._negotiate(list(conns), conns)
|
||||
assert router._history # a dense board has contested cells
|
||||
assert not router._cell_owner and not router._halo and not router._via_claims
|
||||
assert not any(c.routed for c in conns)
|
||||
assert [(c.a_end, c.b_end) for c in conns] == ends
|
||||
assert router._present is None
|
||||
|
||||
|
||||
def test_sharing_is_priced_only_for_other_nets():
|
||||
router = _router("true_density.dsn", 1)
|
||||
node = (3, 4, 0)
|
||||
router._history[node] = 2.0
|
||||
router._present, router._present_cost = {node: {7: 1, 9: 2}}, 0.5
|
||||
assert router._congestion(node, 7) == pytest.approx(2.5) # one other net
|
||||
assert router._congestion(node, 5) == pytest.approx(3.0) # two other nets
|
||||
router._present = None
|
||||
assert router._congestion(node, 5) == pytest.approx(2.0) # history only, after
|
||||
|
||||
|
||||
@pytest.mark.parametrize("name", ["ripup_needed.dsn", "true_density.dsn", "kicad_routable.dsn"])
|
||||
def test_negotiated_routing_keeps_the_occupancy_honest(name):
|
||||
"""Only routed connections hold cells afterwards, as without negotiation."""
|
||||
router = _router(name, 3)
|
||||
router.route()
|
||||
conns = router._conns
|
||||
assert all(conns[i].routed for i in router._cell_owner.values())
|
||||
assert all(conns[i].routed for claims in router._halo.values() for i in claims)
|
||||
|
||||
|
||||
def test_option_reaches_the_router_and_is_off_by_default():
|
||||
text = (FIXTURES / "kicad_routable.dsn").read_text()
|
||||
plain, _, _ = route_dsn_board(parse_dsn(text))
|
||||
again, _, _ = route_dsn_board(parse_dsn(text), negotiate=0)
|
||||
assert plain.unrouted == again.unrouted
|
||||
@@ -31,7 +31,7 @@ def test_occupancy_only_holds_routed_connections(name):
|
||||
router, _ = _routed_router(name)
|
||||
conns = router._conns
|
||||
assert all(conns[i].routed for i in router._cell_owner.values())
|
||||
assert all(conns[i].routed for i in router._via_owner.values())
|
||||
assert all(conns[i].routed for claims in router._via_claims.values() for i in claims)
|
||||
assert all(conns[i].routed for claims in router._halo.values() for i in claims)
|
||||
|
||||
|
||||
|
||||
@@ -158,6 +158,7 @@ def test_cli_supported_combinations_are_accepted(tmp_path):
|
||||
"orders": ["--orders", "2"],
|
||||
"promote": ["--promote-failures", "2"],
|
||||
"access": ["--access-cost", "5"],
|
||||
"negotiate": ["--negotiate", "2"],
|
||||
"rollback": ["--no-rollback"],
|
||||
}
|
||||
for engine, options in ENGINE_OPTIONS.items():
|
||||
|
||||
Reference in New Issue
Block a user