sch_free_space
Find free, grid-aligned rectangles of a given size on a KiCad schematic page, closest to a preferred point, for collision-free block placement.
Instructions
Find free, grid-aligned rectangles of w x h mm on a page, nearest to a point. Use to place a new block without collisions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>",
"sheet": "<sheet>",
"w": "<w>",
"h": "<h>"
},
"name": "sch_free_space"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| h | Yes | ||
| w | Yes | ||
| near | No | [x, y] mm | |
| count | No | ||
| sheet | Yes | Page: name path (/Power/), sheet or instance name (HighSideSwitch12V_PumpMain) or file name | |
| project | Yes | Path to .kicad_pro, root .kicad_sch or the project directory |