François
a4f8254cb3
DESIGN.md: libbsdl dependency and --batch headless mode; bsdl_model/bsdl_check in the layout; the attach-bsdl command and the `B` persist tag; PinSpec is now BSDL-populated; verify's five passes incl. the model-driven and JTAG checks and the new AnomalyKinds. README: libbsdl dependency, --batch usage, tutorial link. New doc/user/tutorial.md: end-to-end batch and TUI walkthroughs (load → tag → connect → attach-bsdl → verify, with the pin/JTAG findings explained). Regenerated commands.md (adds attach-bsdl); index.md links the tutorial. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
260 lines
4.5 KiB
Markdown
260 lines
4.5 KiB
Markdown
# essim — command reference
|
|
|
|
Auto-generated from the live command registry. Regenerate with
|
|
`cmake --build build --target doc` after adding or changing
|
|
commands; the binary itself is the single source of truth.
|
|
|
|
Keys global to the shell: `Esc` cancels a multi-step prompt or
|
|
leaves an interactive screen; `Tab` completes commands/paths
|
|
(top-level prompt) or cycles focus inside an interactive
|
|
screen; `PageUp` / `PageDown` scroll output by 10 lines,
|
|
`Home` / `End` jump to top / bottom; ↑ / ↓ walk command
|
|
history.
|
|
|
|
## Interactive commands
|
|
|
|
### `dashboard` *(interactive)*
|
|
|
|
open the dashboard (system overview)
|
|
|
|
**No arguments.**
|
|
**Notes**
|
|
|
|
- bare form opens an interactive screen; inline form (all args) is scriptable
|
|
- not recorded by `script-save` and rejected by `source`
|
|
|
|
---
|
|
### `explore` *(interactive)*
|
|
|
|
browse modules → parts/signals/connections → details (interactive)
|
|
|
|
**No arguments.**
|
|
**Notes**
|
|
|
|
- bare form opens an interactive screen; inline form (all args) is scriptable
|
|
- not recorded by `script-save` and rejected by `source`
|
|
|
|
---
|
|
### `export` *(interactive)*
|
|
|
|
export structured data to CSV / ODS (kinds: connections; bare form opens the file-picker dialog)
|
|
|
|
**Arguments**
|
|
|
|
1. `kind [connections]`
|
|
2. `filename (.csv)` *(Tab → path completion)*
|
|
|
|
**Notes**
|
|
|
|
- bare form opens an interactive screen; inline form (all args) is scriptable
|
|
|
|
---
|
|
### `plug` *(interactive)*
|
|
|
|
connect a part across two modules (interactive screen if no args)
|
|
|
|
**Arguments**
|
|
|
|
1. `module1`
|
|
2. `part1 (name or pattern)`
|
|
3. `module2`
|
|
4. `part2 (name or pattern)`
|
|
|
|
**Notes**
|
|
|
|
- bare form opens an interactive screen; inline form (all args) is scriptable
|
|
|
|
---
|
|
### `set-connector-type` *(interactive)*
|
|
|
|
tag a part's connector type for transform lookup
|
|
|
|
**Arguments**
|
|
|
|
1. `module`
|
|
2. `part (name or pattern)`
|
|
3. `connector type (free string, e.g. vpx-bp, vpx-payload)`
|
|
|
|
**Notes**
|
|
|
|
- bare form opens an interactive screen; inline form (all args) is scriptable
|
|
|
|
---
|
|
|
|
## Other commands
|
|
|
|
### `analyze`
|
|
|
|
detect signal groups (diff pairs, buses) and structural anomalies
|
|
|
|
**No arguments.**
|
|
---
|
|
### `attach-bsdl`
|
|
|
|
attach a BSDL (.bsd) model to a part and populate pin specs
|
|
|
|
**Arguments**
|
|
|
|
1. `module`
|
|
2. `part (name or pattern)`
|
|
3. `bsdl file (.bsd path)`
|
|
|
|
**Notes**
|
|
|
|
- no per-arg prompt: pass all args inline (or run bare for an empty-args path)
|
|
|
|
---
|
|
### `clear`
|
|
|
|
clear the visualization area
|
|
|
|
**No arguments.**
|
|
---
|
|
### `duplicate`
|
|
|
|
clone a module under a new name (parts, pins, signals; no connections)
|
|
|
|
**Arguments**
|
|
|
|
1. `source module`
|
|
2. `new module name`
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `exit`
|
|
|
|
leave essim (alias of quit)
|
|
|
|
**No arguments.**
|
|
---
|
|
### `help`
|
|
|
|
list commands (or `help <name>` for one command's details)
|
|
|
|
**Arguments**
|
|
|
|
1. `command name (optional)` *(Tab → command completion)*
|
|
|
|
**Notes**
|
|
|
|
- no per-arg prompt: pass all args inline (or run bare for an empty-args path)
|
|
|
|
---
|
|
### `load`
|
|
|
|
load a module from a netlist / pinout file (mentor, altium, ods)
|
|
|
|
**Arguments**
|
|
|
|
1. `module name`
|
|
2. `filename` *(Tab → path completion)*
|
|
3. `import type [mentor|altium|ods]`
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `new`
|
|
|
|
create a new (empty) system; resets the script-save buffer and $vars
|
|
|
|
**No arguments.**
|
|
---
|
|
### `quit`
|
|
|
|
leave essim
|
|
|
|
**No arguments.**
|
|
---
|
|
### `restore`
|
|
|
|
replace the current system with a saved snapshot
|
|
|
|
**Arguments**
|
|
|
|
1. `filename` *(Tab → path completion)*
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `save`
|
|
|
|
write the current system snapshot to a file
|
|
|
|
**Arguments**
|
|
|
|
1. `filename` *(Tab → path completion)*
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `script-save`
|
|
|
|
write commands run since last 'new' as a replay-ready script
|
|
|
|
**Arguments**
|
|
|
|
1. `filename` *(Tab → path completion)*
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `set`
|
|
|
|
define a $variable for substitution in subsequent commands (no args = list defined vars)
|
|
|
|
**Arguments**
|
|
|
|
1. `name`
|
|
2. `value`
|
|
|
|
**Notes**
|
|
|
|
- no per-arg prompt: pass all args inline (or run bare for an empty-args path)
|
|
|
|
---
|
|
### `set-signal-type`
|
|
|
|
override the auto-detected signal type (power | gnd | other)
|
|
|
|
**Arguments**
|
|
|
|
1. `module`
|
|
2. `signal name`
|
|
3. `type [power|gnd|other]`
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `source`
|
|
|
|
execute a file of commands line by line (interactive cmds rejected)
|
|
|
|
**Arguments**
|
|
|
|
1. `filename` *(Tab → path completion)*
|
|
|
|
**Notes**
|
|
|
|
- missing args trigger one prompt each
|
|
|
|
---
|
|
### `verify`
|
|
|
|
check pin roles, bridged-net consistency, and model-driven pin specs (contention/undriven/NC)
|
|
|
|
**No arguments.**
|
|
---
|