create_track
Destructive
Create copper tracks on a PCB by defining a path of points, net, layer, and width. Optionally preview geometry with dry_run before committing changes.
Instructions
Creates a copper track (trace) on the board along a path of 2 or more points. The track is assigned to a specific net and placed on a specific copper layer. Points define the track path in millimeters; each consecutive pair of points becomes a straight track segment. The net must already exist on the board. This creates one undo step: Ctrl+Z reverts all segments created in this call. Use dry_run=true to preview the track geometry without creating it. WARNING: This modifies the board. Creating tracks on a nonexistent net will cause DRC violations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer | Yes | Copper layer to place the track on. Valid values: F.Cu, B.Cu, In1.Cu through In30.Cu. | |
| dry_run | No | If true, compute and report the track geometry without actually creating it. Defaults to false. | |
| net_name | Yes | Name of the net this track belongs to. Case-sensitive. Use list_nets to discover available net names. The track must be on a valid net to pass DRC. | |
| width_mm | Yes | Track width in millimeters. Must be >= the board's minimum track width (check get_design_rules). Common values: 0.15, 0.2, 0.25, 0.3, 0.5 mm. | |
| points_mm | Yes | Path points in millimeters. Must contain at least 2 points. Each consecutive pair creates one track segment. Y increases toward the bottom of the board. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |