Skip to content

Latest commit

 

History

History
83 lines (57 loc) · 5.07 KB

README_EN.md

File metadata and controls

83 lines (57 loc) · 5.07 KB

FreeRouting Auto-Router Integration

中文

With this extension, you can directly push PCB files to the open-source auto-routing tool FreeRouting without manually running FreeRouting or handling import/export of routing files, enabling one-click auto-routing and providing a new option for PCB automatic routing.

Features

  • Quick Auto-Routing - One-click startup with optimized default parameters for fast PCB routing, with real-time progress bar during routing
  • Custom Routing - Configure routing parameters (max passes, via cost, threads, etc.) through a visual panel to meet different design requirements
  • Real-time Preview - Automatically fetches intermediate results every few seconds during routing and updates the canvas for live preview
  • Stop Routing - Stop routing at any time and keep the current routing results
  • Auto DRC - Optionally run design rule check automatically after routing completes
  • Layer Name Conversion - Automatically converts FreeRouting layer names to EasyEDA format

Important Notes

  • System Requirements - This extension requires EasyEDA Pro V3.2 or above.
  • Existing routes are not preserved - Each time auto-routing is executed, all existing traces and vias (unlocked) on the PCB will be cleared before importing FreeRouting results. To preserve manual routing, lock the corresponding traces and vias first.
  • Refresh routing progress - Since FreeRouting does not support the writing of incremental routing results, every time the canvas progress is refreshed, old data is cleared before new results are imported, resulting in a flickering effect on the canvas.

Usage

Installation

  1. Download and install the latest FreeRouting version (V2.2.3 or above). Download FreeRouting
  2. Open EasyEDA Pro, go to top menu: Advanced - Extension Manager, find FreeRouting, and click Install
  3. Or download the .eext extension package, go to top menu: Advanced - Extension Manager - Import .eext file
  4. After installation, go to Installed list, click FreeRouting, and enable "External Interaction" in settings (required for connecting to FreeRouting service)

Extension Settings

Start FreeRouting Service

Before using the extension, you need to start the FreeRouting API service. Run the startup script for your platform:

Platform Script
Windows scripts/start-freerouting-windows.bat
Linux scripts/start-freerouting-linux.sh
macOS scripts/start-freerouting-mac.sh

The script will automatically find your local FreeRouting installation and launch the API server in headless mode with authentication disabled (port 37864).

If the service is not running, the extension will show a dialog with step-by-step instructions and download links when you click the routing menu.

Quick Routing

  1. Run the startup script to start FreeRouting service
  2. Open a PCB document in EasyEDA Pro
  3. Click menu FreeRouting → Auto Route
  4. Wait for routing completion, results will be imported automatically. A progress bar is shown during routing, and you can stop at any time via FreeRouting → Stop Routing

Custom Routing

  1. Click menu FreeRouting → Custom Auto Route...
  2. In the popup panel, configure routing parameters on the left and view logs on the right

Custom Routing Panel

  1. Configurable parameters include: max passes, via cost, max threads, improvement threshold, trace pull tight accuracy, start ripup costs, automatic neckdown, allowed via types, auto DRC after completion
  2. Click Start Routing to begin. During routing the button changes to Stop Routing, click to stop at any time
  3. Intermediate results are automatically fetched and updated on the canvas every few seconds during routing

Routing Parameters

Parameter Default Description
Max Passes (max_passes) 100 (custom) / 50 (quick) Routing iteration count
Via Cost (via_costs) 50 Cost weight for vias, higher values result in fewer vias
Max Threads (max_threads) 4 Number of threads for parallel routing
Improvement Threshold (improvement_threshold) 0 Controls stop condition, 0 means complete routing
Trace Pull Tight Accuracy (trace_pull_tight_accuracy) 500 Accuracy for trace pull-tight optimization
Start Ripup Costs (start_ripup_costs) 100 Starting cost for ripping up existing traces
Automatic Neckdown (automatic_neckdown) Enabled Automatically reduce trace width in narrow areas
Allowed Via Types (allowed_via_types) Allowed Allow using different types of vias
Auto DRC Enabled Run DRC automatically after routing completes

Acknowledgments

  1. Thanks to the FreeRouting Project and authors like andrasfuchs for providing the FreeRouting tool and API capabilities
  2. Thanks to FreeRouting contributor L1uTongweiNewAccount for helping adapt the FreeRouting API