build
Compile HDL sources into an FPGA bitstream as a background job from a project directory and top module, with optional part, source, and constraint overrides.
Instructions
Start a full build (synthesis to bitstream) as a background job.
project_dir: folder with the HDL sources (copied to the build machine; old outputs are skipped). top: top module name. If .xst exists in the folder, the project's own synthesis script is used. part: device-package-speed, e.g. xc3s700a-fg484-4. Defaults to the selected board's part. The part selects the add-on. sources: paths relative to project_dir; default is every .v/.vhd in the folder except testbenches. constraints: constraints file relative to project_dir; default is the only .ucf (ISE) or .cst (Gowin) in the folder. backend: force a specific add-on. By default the usable add-on with the highest priority is used (the vendor tool when the user has it, otherwise the open-source flow).
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_dir": "<project_dir>",
"top": "<top>"
},
"name": "build"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | Yes | ||
| part | No | ||
| backend | No | ||
| sources | No | ||
| constraints | No | ||
| project_dir | Yes |