diff --git a/doc/xschem_man/developer_info.html b/doc/xschem_man/developer_info.html
index bab47f20..b9efcb9d 100644
--- a/doc/xschem_man/developer_info.html
+++ b/doc/xschem_man/developer_info.html
@@ -481,122 +481,122 @@ C {verilog_timescale.sym} 1050 -100 0 0 {name=s1 timestep="1ns" precision="1ns"
- abort_operation
- Resets UI state, unselect all and abort any pending operation
- add_symbol_pin
- Start a GUI placement of a symbol pin
- add_graph
- Start a GUI placement of a graph object
- add_png
- Ask user to choose a png file and start a GUI placement of the image
- align
- Align currently selected objects to current snap setting
- annotate_op [raw_file]
- Annotate operating point data into current schematic.
- use <schematic name>.raw or use supplied argument as raw file to open
- look for operating point data and annotate voltages/currents into schematic
- arc
- Start a GUI placement of an arc.
- User should click 3 unaligned points to define the arc
- attach_labels
- Attach net labels to selected component(s) instance(s)
- bbox begin|end
- Start/end bounding box calculation: parameter is either 'begin' or 'end'
- break_wires
- Break wires at selected instance pins
- build_colors
- Rebuild color palette using values of tcl vars dim_value and dim_bg
- callback winpath event mx my key button aux state
- Invoke the callback event dispatcher with a software event
- case_insensitive 1|0
- Set case insensitive symbol lookup. Use only on case insensitive filesystems
- check_symbols
- List all used symbols in current schematic and warn if some symbol is newer
- check_unique_names [1|0]
- Check if all instances have a unique refdes (name attribute in xschem),
- highlight such instances. If second parameter is '1' rename duplicates
- circle
- Start a GUI placement of a circle.
- User should click 3 unaligned points to define the circle
- clear [force] [symbol|schematic]
- Clear current schematic window. Resets hierarchy level. Remove symbols
- the 'force' parameter will not ask to save existing modified schematic.
- the 'schematic' or 'symbol' parameter specifies to default to a schematic
- or symbol window (default: schematic)
- clear_drawing
- Clears drawing but does not purge symbols
- color_dim value
- Dim colors or brite colors depending on value parameter: -5 <= value <= 5
- compare_schematics [sch_file]
- Compare currently loaded schematic with another 'sch_file' schematic.
- if no file is given prompt user to choose one
- connected_nets [1|0]
- Select nets connected to currently selected net or net label/pin.
- if '1' argument is given, stop at wire junctions
- copy
- Copy selection to clipboard
- copy_objects
- Start a GUI copy operation
- count_items string separator quoting_chars
- Debug command
- Create_plot_cmd
- Create an xplot file in netlist/simulation directory with
- the list of highlighted nodes in a format the selected waveform
- viewer understands (bespice, gaw, ngspice)
- cut
- Cut selection to clipboard
- debug n
- Set xschem in debug mode.'n' is the debug level
- (0=no debug). Higher levels yield more debug info.
- delete
- Delete selection
- delete_files
- Bring up a file selector the user can use to delete files
- descend [n]
- Descend into selected component instance. Optional number 'n' specifies the
- instance number to descend into for vector instances (default: 0).
- descend_symbol
- Descend into the symbol view of selected component instance
- display_hilights
- Print a list of highlighted objects (nets, net labels/pins, instances)
- draw_graph [n] [flags]
- Redraw graph rectangle number 'n'.
- If the optional 'flags' integer is given it will be used as the
- flags bitmask to use while drawing (can be used to restrict what to redraw)
- edit_file
- Edit xschem file of current schematic if nothing is selected.
- Edit .sym file if a component is selected.
- edit_prop
- Edit global schematic/symbol attributes or attributes
- of currently selected instances
- edit_prop
- Edit global schematic/symbol attributes or
- attributes of currently selected instances
- using a text editor (defined in tcl 'editor' variable)
- embed_rawfile raw_file
- Embed base 64 encoded 'raw_file' into currently
- selected element as a 'spice_data'
- attribute.
- enable_layers
- Enable/disable layers depending on tcl array variable enable_layer()
- exit
- Exit the program, ask for confirm if current file modified.
- expandlabel lab
- Expand vectored labels/instance names:
- xschem expandlabel {2*A[3:0]} --> A[3],A[2],A[1],A[0],A[3],A[2],A[1],A[0] 8
- last field is the number of bits
- since [ and ] are TCL special characters argument must be quoted with { and }
- find_nth string sep n
- Find n-th field string separated by characters in sep. 1st field is in position 1
- xschem find_nth {aaa,bbb,ccc,ddd} {,} 2 --> bbb
- flip
- Flip selection horizontally
- flip_in_place
- Flip selection horizontally, each object around its center
- fullscreen
- Toggle fullscreen modes: fullscreen with menu & status, fullscreen, normal
- get var
- Get C variable/constant 'var'
+ abort_operation
+ Resets UI state, unselect all and abort any pending operation
+ add_symbol_pin
+ Start a GUI placement of a symbol pin
+ add_graph
+ Start a GUI placement of a graph object
+ add_png
+ Ask user to choose a png file and start a GUI placement of the image
+ align
+ Align currently selected objects to current snap setting
+ annotate_op [raw_file]
+ Annotate operating point data into current schematic.
+ use <schematic name>.raw or use supplied argument as raw file to open
+ look for operating point data and annotate voltages/currents into schematic
+ arc
+ Start a GUI placement of an arc.
+ User should click 3 unaligned points to define the arc
+ attach_labels
+ Attach net labels to selected component(s) instance(s)
+ bbox begin|end
+ Start/end bounding box calculation: parameter is either 'begin' or 'end'
+ break_wires
+ Break wires at selected instance pins
+ build_colors
+ Rebuild color palette using values of tcl vars dim_value and dim_bg
+ callback winpath event mx my key button aux state
+ Invoke the callback event dispatcher with a software event
+ case_insensitive 1|0
+ Set case insensitive symbol lookup. Use only on case insensitive filesystems
+ check_symbols
+ List all used symbols in current schematic and warn if some symbol is newer
+ check_unique_names [1|0]
+ Check if all instances have a unique refdes (name attribute in xschem),
+ highlight such instances. If second parameter is '1' rename duplicates
+ circle
+ Start a GUI placement of a circle.
+ User should click 3 unaligned points to define the circle
+ clear [force] [symbol|schematic]
+ Clear current schematic window. Resets hierarchy level. Remove symbols
+ the 'force' parameter will not ask to save existing modified schematic.
+ the 'schematic' or 'symbol' parameter specifies to default to a schematic
+ or symbol window (default: schematic)
+ clear_drawing
+ Clears drawing but does not purge symbols
+ color_dim value
+ Dim colors or brite colors depending on value parameter: -5 <= value <= 5
+ compare_schematics [sch_file]
+ Compare currently loaded schematic with another 'sch_file' schematic.
+ if no file is given prompt user to choose one
+ connected_nets [1|0]
+ Select nets connected to currently selected net or net label/pin.
+ if '1' argument is given, stop at wire junctions
+ copy
+ Copy selection to clipboard
+ copy_objects
+ Start a GUI copy operation
+ count_items string separator quoting_chars
+ Debug command
+ Create_plot_cmd
+ Create an xplot file in netlist/simulation directory with
+ the list of highlighted nodes in a format the selected waveform
+ viewer understands (bespice, gaw, ngspice)
+ cut
+ Cut selection to clipboard
+ debug n
+ Set xschem in debug mode.'n' is the debug level
+ (0=no debug). Higher levels yield more debug info.
+ delete
+ Delete selection
+ delete_files
+ Bring up a file selector the user can use to delete files
+ descend [n]
+ Descend into selected component instance. Optional number 'n' specifies the
+ instance number to descend into for vector instances (default: 0).
+ descend_symbol
+ Descend into the symbol view of selected component instance
+ display_hilights
+ Print a list of highlighted objects (nets, net labels/pins, instances)
+ draw_graph [n] [flags]
+ Redraw graph rectangle number 'n'.
+ If the optional 'flags' integer is given it will be used as the
+ flags bitmask to use while drawing (can be used to restrict what to redraw)
+ edit_file
+ Edit xschem file of current schematic if nothing is selected.
+ Edit .sym file if a component is selected.
+ edit_prop
+ Edit global schematic/symbol attributes or attributes
+ of currently selected instances
+ edit_prop
+ Edit global schematic/symbol attributes or
+ attributes of currently selected instances
+ using a text editor (defined in tcl 'editor' variable)
+ embed_rawfile raw_file
+ Embed base 64 encoded 'raw_file' into currently
+ selected element as a 'spice_data'
+ attribute.
+ enable_layers
+ Enable/disable layers depending on tcl array variable enable_layer()
+ exit
+ Exit the program, ask for confirm if current file modified.
+ expandlabel lab
+ Expand vectored labels/instance names:
+ xschem expandlabel {2*A[3:0]} --> A[3],A[2],A[1],A[0],A[3],A[2],A[1],A[0] 8
+ last field is the number of bits
+ since [ and ] are TCL special characters argument must be quoted with { and }
+ find_nth string sep n
+ Find n-th field string separated by characters in sep. 1st field is in position 1
+ xschem find_nth {aaa,bbb,ccc,ddd} {,} 2 --> bbb
+ flip
+ Flip selection horizontally
+ flip_in_place
+ Flip selection horizontally, each object around its center
+ fullscreen
+ Toggle fullscreen modes: fullscreen with menu & status, fullscreen, normal
+ get var
+ Get C variable/constant 'var'
- backlayer number of background layer
- bbox_hilighted bounding box of highlinhted objects
@@ -640,357 +640,357 @@ C {verilog_timescale.sym} 1050 -100 0 0 {name=s1 timestep="1ns" precision="1ns"
- yorigin y coordinate of origin
- zoom zoom level
- getprop instance inst
- Get the full attribute string of 'inst'
-
- getprop instance inst attr
- Get the value of attribute 'attr'
- If 'attr has the form 'cell::sym_attr' look up attribute 'sym_attr'
- of the symbol referenced by the instance.
-
- getprop instance_pin inst pin
- Get the full attribute string of pin 'pin' of instance 'inst'
- Example: xschem getprop instance_pin x3 MINUS --> name=MINUS dir=in
-
- getprop instance_pin inst pin pin_attr
- Get attribute 'pin_attr' of pin 'pin' of instance 'inst'
- Example: xschem getprop instance_pin x3 MINUS dir --> in
-
- getprop symbol sym_name
- Get full attribute string of symbol 'sym_name'
- example:
- xschem getprop symbol comp_ngspice.sym -->
- type=subcircuit
- format="@name @pinlist @symname
- OFFSET=@OFFSET AMPLITUDE=@AMPLITUDE GAIN=@GAIN ROUT=@ROUT COUT=@COUT"
- template="name=x1 OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p"
-
- getprop symbol sym_name sym_attr [with_quotes]
- Get value of attribute 'sym_attr' of symbol 'sym_name'
- 'with_quotes' (default:0) is an integer passed to get_tok_value()
- getprop rect layer num attr
- Get attribute 'attr' of rectangle number 'num' on layer 'layer'
-
- getprop text num attr
- Get attribute 'attr' of text number 'num'
-
- ('inst' can be an instance name or instance number)
- ('pin' can be a pin name or pin number)
- get_tok str tok [with_quotes]
- get value of token 'tok' in string 'str'
- 'with_quotes' (default:0) is an integer passed to get_tok_value()
- get_tok_size
- Get length of last looked up attribute name (not its value)
- if returned value is 0 it means that last searched attribute did not exist
- globals
- Return various global variables used in the program
- go_back
- Go up one level (pop) in hierarchy
- hash_file file [skip_path_lines]
- Do a simple hash of 'file'
- 'skip_path_lines' is an integer (default: 0) passed to hash_file()
- hash_string str
- Do a simple hashing of string 'str'
- help
+
getprop instance inst
+ Get the full attribute string of 'inst'
+
+ getprop instance inst attr
+ Get the value of attribute 'attr'
+ If 'attr has the form 'cell::sym_attr' look up attribute 'sym_attr'
+ of the symbol referenced by the instance.
+
+ getprop instance_pin inst pin
+ Get the full attribute string of pin 'pin' of instance 'inst'
+ Example: xschem getprop instance_pin x3 MINUS --> name=MINUS dir=in
+
+ getprop instance_pin inst pin pin_attr
+ Get attribute 'pin_attr' of pin 'pin' of instance 'inst'
+ Example: xschem getprop instance_pin x3 MINUS dir --> in
+
+ getprop symbol sym_name
+ Get full attribute string of symbol 'sym_name'
+ example:
+ xschem getprop symbol comp_ngspice.sym -->
+ type=subcircuit
+ format="@name @pinlist @symname
+ OFFSET=@OFFSET AMPLITUDE=@AMPLITUDE GAIN=@GAIN ROUT=@ROUT COUT=@COUT"
+ template="name=x1 OFFSET=0 AMPLITUDE=5 GAIN=100 ROUT=1000 COUT=1p"
+
+ getprop symbol sym_name sym_attr [with_quotes]
+ Get value of attribute 'sym_attr' of symbol 'sym_name'
+ 'with_quotes' (default:0) is an integer passed to get_tok_value()
+ getprop rect layer num attr
+ Get attribute 'attr' of rectangle number 'num' on layer 'layer'
+
+ getprop text num attr
+ Get attribute 'attr' of text number 'num'
+
+ ('inst' can be an instance name or instance number)
+ ('pin' can be a pin name or pin number)
+ get_tok str tok [with_quotes]
+ get value of token 'tok' in string 'str'
+ 'with_quotes' (default:0) is an integer passed to get_tok_value()
+ get_tok_size
+ Get length of last looked up attribute name (not its value)
+ if returned value is 0 it means that last searched attribute did not exist
+ globals
+ Return various global variables used in the program
+ go_back
+ Go up one level (pop) in hierarchy
+ hash_file file [skip_path_lines]
+ Do a simple hash of 'file'
+ 'skip_path_lines' is an integer (default: 0) passed to hash_file()
+ hash_string str
+ Do a simple hashing of string 'str'
+ help
Print command help
- hier_psprint [file]
- Hierarchical postscript / pdf print
- if 'file' is not given show a fileselector dialog box
- hilight [drill]
- Highlight selected element/pins/labels/nets
- if 'drill' is given propagate net highlights through conducting elements
- (elements that have the 'propag' attribute on pins )
- hilight_instname inst
- Highlight instance 'inst'
- 'inst' can be an instance name or number
- hilight_netname net
- Highlight net name 'net'
- instance sym_name x y rot flip [prop] [first_call]
- Place a new instance of symbol 'sym_name' at position x,y,
- rotation and flip set to 'rot', 'flip'
- if 'prop' is given it is the new instance attribute
- string (default: symbol template string)
- if 'first_call' is given it must be 1 on first call
- and zero on following calls
- It is used only for efficiency reasons if placing multiple instances
- instance_bbox inst
- return instance and symbol bounding boxes
- 'inst' can be an instance name or number
- instance_net inst pin
- Return the name of the net attached to pin 'pin' of instance 'inst'
- Example: xschem instance_net x3 MINUS --> REF
- instance_nodemap inst
- Return the instance name followed by a list of 'pin net' associations
- example: xschem instance_nodemap x3
- --> x3 PLUS LED OUT LEVEL MINUS REF
- instance x3 pin PLUS is attached to net LED, pin OUT to net LEVEL and so on...
- instance_pin_coord inst attr value
- Return the name and coordinates of pin with
- attribute 'attr' set to 'value' of instance 'inst'
- 'inst can be an instance name or a number
- Example: xschem instance_pin_coord x3 name MINUS --> {MINUS} 600 -840
- instance_pins inst
- Return list of pins of instance 'inst'
- 'inst can be an instance name or a number
- instance_pos inst
- Get number (position) of instance name 'inst'
- instances_to_net net
- Return list of instances names and pins attached to net 'net'
- Example: xschem instances_to_net PANEL
- --> { {Vsw} {plus} {580} {-560} } { {p2} {p} {660} {-440} }
- { {Vpanel1} {minus} {600} {-440} }
- line x1 y1 x2 y2 [pos]
- Place a line on current layer (rectcolor)
- if integer number 'pos' is given place line at indicated
- position in the line array.
- line_width n
- set line width to floating point number 'n'
- list_hierarchy
- List all schematics at or below current hierarchy with modification times.
- Example: xschem list_hiearchy
- -->
- 20230302_003134 {/home/.../ngspice/solar_panel.sch}
- 20230211_010031 {/home/.../ngspice/pv_ngspice.sch}
- 20221011_175308 {/home/.../ngspice/diode_ngspice.sch}
- 20221014_091945 {/home/.../ngspice/comp_ngspice.sch}
- list_hilights [sep]
- Sorted list of highlight nets, separated by character 'sep' (default: space)
- list_tokens str with_quotes
- List tokens in string 'str'
- with_quotes:
- 0: eat non escaped quotes (")
- 1: return unescaped quotes as part of the token value if they are present
- 2: eat backslashes
- load f [symbol|force|noundoreset|nofullzoom]
- Load a new file 'f'.
- 'force': do not ask to save modified file or warn if opening an already open file
- 'noundoreset': do not reset the undo history
- 'symbol': do not load symbols (used if loading a symbol instead of a schematic)
- 'nofullzoom': do not do a fll zoom on new schematic.
- load_new_window [f]
- Load schematic in a new tab/window. If 'f' not given prompt user
- log f
- If 'f' is given output stderr messages to file 'f'
- if 'f' is not given and a file log is open, close log
- file and resume logging to stderr
- logic_get_net net_name
- Get logic state of net named 'net_name'
- Returns 0, 1, 2, 3 for logic levels 0, 1, X, Z or nothing if no net found.
- logic_set_net net_name n [num]
- set 'net_name' to logic level 'n' 'num' times.
- 'n':
- 0 set to logic value 0
- 1 set to logic value 1
- 2 set to logic value X
- 3 set to logic value Z
- -1 toggle logic valie (1->0, 0->1)
- the 'num' parameter is essentially useful only with 'toggle' (-1) value
- logic_set n [num]
- set selected nets, net labels or pins to logic level 'n' 'num' times.
- 'n':
- 0 set to logic value 0
- 1 set to logic value 1
- 2 set to logic value X
- 3 set to logic value Z
- -1 toggle logic valie (1->0, 0->1)
- the 'num' parameter is essentially useful only with 'toggle' (-1) value
- make_sch
- Make a schematic from selected symbol
- make_sch_from_sel
- Create an LCC instance from selection and place it instead of selection
- also ask if a symbol (.sym) file needs to be created
- make_symbol
- From current schematic (circuit.sch) create a symbol (circuit.sym)
- using ipin.sym, opin.sym, iopin.sym in schematic
- to deduce symbol interface pins.
- merge [f]
- Merge another file. if 'f' not given prompt user.
- move_objects [dx dy]
- Start a move operation on selection and let user terminate the operation in the GUI
- if dx and dy are given move by that amount.
- net_label [type]
- Place a new net label
- 'type': 1: place a 'lab_pin.sym' label
- 0: place a 'lab_wire.sym' label
- User should complete the placement in the GUI.
- net_pin_mismatch
- Highlight nets attached to selected symbols with
- a different name than symbol pin
- netlist
- do a netlist of current schematic in currently defined netlist format
- new_schematic create|destroy|destroy_all|switch_win winpath file
- Open/destroy a new tab or window
- create: create new empty window or with 'file' loaded if 'file' given.
- The winpath must be given (even {} is ok) but not used.
- destroy: destroy tab/window identified by winpath. Example:
- xschem new_schematic destroy .x1.drw
- destroy_all: close all tabs/additional windows
- switch_win: switch context to specified 'winpath' window
- switch_tab: switch context to specified 'winpath' tab
- Main window/tab has winpath set to .drw,
- Additional windows/tabs have winpath set to .x1.drw, .x2.drw and so on...
- new_symbol_window [f]
- Start a new xschem process for a symbol.
- If 'f' is given load specified symbol.
- new_window [f]
- Start a new xschem process for a schematic.
- If 'f' is given load specified schematic.
- only_probes
- dim schematic to better show highlights
- origin x y [zoom]
- Move origin to 'x, y', optionally changing zoom level to 'zoom'
- parse_cmd
- debug command to test parse_cmd_string()
- splits a command string into argv-like arguments
- return # of args in *argc
- argv[*argc] is always set to NULL
- parselabel str
- Debug command to test vector net syntax parser
- paste [x y]
- Paste clipboard. If 'x y' not given user should complete placement in the GUI
- pinlist inst
- List all pins of instance 'inst'
- Example: xschem pinlist x3
- --> { {0} {name=PLUS dir=in } } { {1} {name=OUT dir=out } }
- { {2} {name=MINUS dir=in } }
- place_symbol [sym_name] [prop]
- Start a GUI placement operation of specified 'sym_name' symbol.
- If 'sym_name' not given prompt user
- 'prop' is the attribute string of the symbol.
- If not given take from symbol template attribute.
- place_text
- Start a GUI placement of a text object
- polygon
- Start a GUI placement of a polygon
- preview_window create|draw|destroy [winpath] [file]
- Used in fileselector to show a schematic preview.
- print png|svg|ps|pdf img_file img_x img_y [x1 y1 x2 y2]
- Export current schematic to image.
- img x y size xschem area to export
- 0 1 2 3 4 5 6 7 8 9
- xschem print png file.png 400 300 [ -300 -200 300 200 ]
- xschem print svg file.svg 400 300 [ -300 -200 300 200 ]
- xschem print ps file.ps
- xschem print pdf file.pdf
- print_hilight_net show
- from highlighted nets/pins/labels:
- show == 0 ==> create pins from highlight nets
- show == 1 ==> show list of highlight net in a dialog box
- show == 2 ==> create labels with i prefix from hilight nets
- show == 3 ==> show list of highlight net with path and label
- expansion in a dialog box
- show == 4 ==> create labels without i prefix from hilight nets
- for show = 0, 2, 4 user should complete GUI placement
- of created objects
- print_spice_element inst
- Print spice raw netlist line for instance (number or name) 'inst'
- propagate_hilights [set clear]
- Debug: wrapper to propagate_hilights() function
- push_undo
- Push current state on undo stack
- raw_clear
- Delete loaded simulation raw file
- raw_query loaded|value|index|values|datasets|vars|list
- xschem raw_query list: get list of saved simulation variables
- xschem raw_query vars: get number of simulation variables
- xschem raw_query datasets: get number of datasets (simulation runs)
- xschem raw_query value node n: return n-th value of 'node' in raw file
- xschem raw_query loaded: return hierarchy level
- where raw file was loaded or -1 if no raw loaded
- xschem raw_query index node: get index of simulation variable 'node'.
- Example: raw_query index v(led) --> 46
- xschem raw_query values node [dset] : print all simulation
- values of 'node' for dataset 'dset' (default dset=0)
- xschem raw_query points [dset] : print simulation points for
- dataset 'dset' (default dset=0)
- raw_read [file] [sim]
- If a raw file is already loaded delete from memory
- else load specified file and analysis 'sim' (dc, ac, tran, op, ...)
- If 'sim' not specified load first section found in raw file.
- raw_read_from_attr [sim]
- If a simulation raw file is already loaded delete from memory
- else read section 'sim' (tran, dc, ac, op, ...)
- of base64 encoded data from a 'spice_data'
- attribute of selected instance
- If sim not given read first section found
- rebuild_connectivity
- Rebuild logical connectivity abstraction of schematic
- rebuild_selection
- Rebuild selection list
- rect [x1 y1 x2 y2] [pos]
- if 'x1 y1 x2 y2'is given place recangle on current
- layer (rectcolor) at indicated coordinates.
- if 'pos' is given insert at given position in rectangle array.
- If no coordinates are given start a GUI operation of rectangle placement
- redo
- Redo last undone action
- redraw
- redraw window
- reload
- Forced (be careful!) Reload current schematic from disk
- reload_symbols
- Reload all used symbols from disk
- remove_symbols
- Internal command: remove all symbol definitions
- replace_symbol inst new_symbol [fast]
- Replace 'inst' symbol with 'new_symbol'
- If doing multiple substitutions set 'fast' to 0
- on first call and non zero on next calls
- for faster operation
- Example: xschem replace_symbol R3 capa.sym
- rotate
- Rotate selected objects around their centers
- save
- Save schematic if modified. Does not ask confirmation!
- saveas [file] [type]
- save current schematic as 'file'
- if file is empty ({}) use current schematic name
- as defalt and prompt user with file selector
- 'type' is used used to set/change file extension:
- schematic: save as schematic (*.sch)
- symbol: save as symbol (*.sym)
- If not specified default to schematic (*.sch)
- Does not ask confirmation if file name given
- schematic_in_new_window [new_process]
- When a symbol is selected edit corresponding schematic
- in a new tab/window if not already open.
- If nothing selected open another window of the second
- schematic (issues a warning).
- if 'new_process' is given start a new xschem process
- search regex|exact select tok val
- Search instances with attribute string containing 'tok'
- attribute and value 'val'
- search can be exact ('exact') or as a regular expression ('regex')
- select:
- 0 : highlight matching instances
- 1 : select matching instances
- -1 : unselect matching instances
- 'tok' set as:
- propstring : will search for 'val' in the entire
- *instance* attribute string.
- cell::propstring : will search for 'val' in the entire
- *symbol* attribute string.
- cell::name : will search for 'val' in the symbol name
- cell::<attr> will search for 'val' in symbol attribute 'attr'
- example: xschem search regex 0 cell::template GAIN=100
- select instance|wire|text id [clear]
- Select indicated instance or wire or text.
- For 'instance' 'id' can be the instance name or number
- for 'wire' or 'text' 'id' is the position in the respective arrays
- if 'clear' is specified does an unselect operation
- select_all
- Selects all objects in schematic
- select_hilight_net
- Select all highlight objects (wires, labels, pins, instances)
- selected_set
- Return a list of selected instance names
- selected_wire
+
hier_psprint [file]
+ Hierarchical postscript / pdf print
+ if 'file' is not given show a fileselector dialog box
+ hilight [drill]
+ Highlight selected element/pins/labels/nets
+ if 'drill' is given propagate net highlights through conducting elements
+ (elements that have the 'propag' attribute on pins )
+ hilight_instname inst
+ Highlight instance 'inst'
+ 'inst' can be an instance name or number
+ hilight_netname net
+ Highlight net name 'net'
+ instance sym_name x y rot flip [prop] [first_call]
+ Place a new instance of symbol 'sym_name' at position x,y,
+ rotation and flip set to 'rot', 'flip'
+ if 'prop' is given it is the new instance attribute
+ string (default: symbol template string)
+ if 'first_call' is given it must be 1 on first call
+ and zero on following calls
+ It is used only for efficiency reasons if placing multiple instances
+ instance_bbox inst
+ return instance and symbol bounding boxes
+ 'inst' can be an instance name or number
+ instance_net inst pin
+ Return the name of the net attached to pin 'pin' of instance 'inst'
+ Example: xschem instance_net x3 MINUS --> REF
+ instance_nodemap inst
+ Return the instance name followed by a list of 'pin net' associations
+ example: xschem instance_nodemap x3
+ --> x3 PLUS LED OUT LEVEL MINUS REF
+ instance x3 pin PLUS is attached to net LED, pin OUT to net LEVEL and so on...
+ instance_pin_coord inst attr value
+ Return the name and coordinates of pin with
+ attribute 'attr' set to 'value' of instance 'inst'
+ 'inst can be an instance name or a number
+ Example: xschem instance_pin_coord x3 name MINUS --> {MINUS} 600 -840
+ instance_pins inst
+ Return list of pins of instance 'inst'
+ 'inst can be an instance name or a number
+ instance_pos inst
+ Get number (position) of instance name 'inst'
+ instances_to_net net
+ Return list of instances names and pins attached to net 'net'
+ Example: xschem instances_to_net PANEL
+ --> { {Vsw} {plus} {580} {-560} } { {p2} {p} {660} {-440} }
+ { {Vpanel1} {minus} {600} {-440} }
+ line x1 y1 x2 y2 [pos]
+ Place a line on current layer (rectcolor)
+ if integer number 'pos' is given place line at indicated
+ position in the line array.
+ line_width n
+ set line width to floating point number 'n'
+ list_hierarchy
+ List all schematics at or below current hierarchy with modification times.
+ Example: xschem list_hiearchy
+ -->
+ 20230302_003134 {/home/.../ngspice/solar_panel.sch}
+ 20230211_010031 {/home/.../ngspice/pv_ngspice.sch}
+ 20221011_175308 {/home/.../ngspice/diode_ngspice.sch}
+ 20221014_091945 {/home/.../ngspice/comp_ngspice.sch}
+ list_hilights [sep]
+ Sorted list of highlight nets, separated by character 'sep' (default: space)
+ list_tokens str with_quotes
+ List tokens in string 'str'
+ with_quotes:
+ 0: eat non escaped quotes (")
+ 1: return unescaped quotes as part of the token value if they are present
+ 2: eat backslashes
+ load f [symbol|force|noundoreset|nofullzoom]
+ Load a new file 'f'.
+ 'force': do not ask to save modified file or warn if opening an already open file
+ 'noundoreset': do not reset the undo history
+ 'symbol': do not load symbols (used if loading a symbol instead of a schematic)
+ 'nofullzoom': do not do a fll zoom on new schematic.
+ load_new_window [f]
+ Load schematic in a new tab/window. If 'f' not given prompt user
+ log f
+ If 'f' is given output stderr messages to file 'f'
+ if 'f' is not given and a file log is open, close log
+ file and resume logging to stderr
+ logic_get_net net_name
+ Get logic state of net named 'net_name'
+ Returns 0, 1, 2, 3 for logic levels 0, 1, X, Z or nothing if no net found.
+ logic_set_net net_name n [num]
+ set 'net_name' to logic level 'n' 'num' times.
+ 'n':
+ 0 set to logic value 0
+ 1 set to logic value 1
+ 2 set to logic value X
+ 3 set to logic value Z
+ -1 toggle logic valie (1->0, 0->1)
+ the 'num' parameter is essentially useful only with 'toggle' (-1) value
+ logic_set n [num]
+ set selected nets, net labels or pins to logic level 'n' 'num' times.
+ 'n':
+ 0 set to logic value 0
+ 1 set to logic value 1
+ 2 set to logic value X
+ 3 set to logic value Z
+ -1 toggle logic valie (1->0, 0->1)
+ the 'num' parameter is essentially useful only with 'toggle' (-1) value
+ make_sch
+ Make a schematic from selected symbol
+ make_sch_from_sel
+ Create an LCC instance from selection and place it instead of selection
+ also ask if a symbol (.sym) file needs to be created
+ make_symbol
+ From current schematic (circuit.sch) create a symbol (circuit.sym)
+ using ipin.sym, opin.sym, iopin.sym in schematic
+ to deduce symbol interface pins.
+ merge [f]
+ Merge another file. if 'f' not given prompt user.
+ move_objects [dx dy]
+ Start a move operation on selection and let user terminate the operation in the GUI
+ if dx and dy are given move by that amount.
+ net_label [type]
+ Place a new net label
+ 'type': 1: place a 'lab_pin.sym' label
+ 0: place a 'lab_wire.sym' label
+ User should complete the placement in the GUI.
+ net_pin_mismatch
+ Highlight nets attached to selected symbols with
+ a different name than symbol pin
+ netlist
+ do a netlist of current schematic in currently defined netlist format
+ new_schematic create|destroy|destroy_all|switch_win winpath file
+ Open/destroy a new tab or window
+ create: create new empty window or with 'file' loaded if 'file' given.
+ The winpath must be given (even {} is ok) but not used.
+ destroy: destroy tab/window identified by winpath. Example:
+ xschem new_schematic destroy .x1.drw
+ destroy_all: close all tabs/additional windows
+ switch_win: switch context to specified 'winpath' window
+ switch_tab: switch context to specified 'winpath' tab
+ Main window/tab has winpath set to .drw,
+ Additional windows/tabs have winpath set to .x1.drw, .x2.drw and so on...
+ new_symbol_window [f]
+ Start a new xschem process for a symbol.
+ If 'f' is given load specified symbol.
+ new_window [f]
+ Start a new xschem process for a schematic.
+ If 'f' is given load specified schematic.
+ only_probes
+ dim schematic to better show highlights
+ origin x y [zoom]
+ Move origin to 'x, y', optionally changing zoom level to 'zoom'
+ parse_cmd
+ debug command to test parse_cmd_string()
+ splits a command string into argv-like arguments
+ return # of args in *argc
+ argv[*argc] is always set to NULL
+ parselabel str
+ Debug command to test vector net syntax parser
+ paste [x y]
+ Paste clipboard. If 'x y' not given user should complete placement in the GUI
+ pinlist inst
+ List all pins of instance 'inst'
+ Example: xschem pinlist x3
+ --> { {0} {name=PLUS dir=in } } { {1} {name=OUT dir=out } }
+ { {2} {name=MINUS dir=in } }
+ place_symbol [sym_name] [prop]
+ Start a GUI placement operation of specified 'sym_name' symbol.
+ If 'sym_name' not given prompt user
+ 'prop' is the attribute string of the symbol.
+ If not given take from symbol template attribute.
+ place_text
+ Start a GUI placement of a text object
+ polygon
+ Start a GUI placement of a polygon
+ preview_window create|draw|destroy [winpath] [file]
+ Used in fileselector to show a schematic preview.
+ print png|svg|ps|pdf img_file img_x img_y [x1 y1 x2 y2]
+ Export current schematic to image.
+ img x y size xschem area to export
+ 0 1 2 3 4 5 6 7 8 9
+ xschem print png file.png 400 300 [ -300 -200 300 200 ]
+ xschem print svg file.svg 400 300 [ -300 -200 300 200 ]
+ xschem print ps file.ps
+ xschem print pdf file.pdf
+ print_hilight_net show
+ from highlighted nets/pins/labels:
+ show == 0 ==> create pins from highlight nets
+ show == 1 ==> show list of highlight net in a dialog box
+ show == 2 ==> create labels with i prefix from hilight nets
+ show == 3 ==> show list of highlight net with path and label
+ expansion in a dialog box
+ show == 4 ==> create labels without i prefix from hilight nets
+ for show = 0, 2, 4 user should complete GUI placement
+ of created objects
+ print_spice_element inst
+ Print spice raw netlist line for instance (number or name) 'inst'
+ propagate_hilights [set clear]
+ Debug: wrapper to propagate_hilights() function
+ push_undo
+ Push current state on undo stack
+ raw_clear
+ Delete loaded simulation raw file
+ raw_query loaded|value|index|values|datasets|vars|list
+ xschem raw_query list: get list of saved simulation variables
+ xschem raw_query vars: get number of simulation variables
+ xschem raw_query datasets: get number of datasets (simulation runs)
+ xschem raw_query value node n: return n-th value of 'node' in raw file
+ xschem raw_query loaded: return hierarchy level
+ where raw file was loaded or -1 if no raw loaded
+ xschem raw_query index node: get index of simulation variable 'node'.
+ Example: raw_query index v(led) --> 46
+ xschem raw_query values node [dset] : print all simulation
+ values of 'node' for dataset 'dset' (default dset=0)
+ xschem raw_query points [dset] : print simulation points for
+ dataset 'dset' (default dset=0)
+ raw_read [file] [sim]
+ If a raw file is already loaded delete from memory
+ else load specified file and analysis 'sim' (dc, ac, tran, op, ...)
+ If 'sim' not specified load first section found in raw file.
+ raw_read_from_attr [sim]
+ If a simulation raw file is already loaded delete from memory
+ else read section 'sim' (tran, dc, ac, op, ...)
+ of base64 encoded data from a 'spice_data'
+ attribute of selected instance
+ If sim not given read first section found
+ rebuild_connectivity
+ Rebuild logical connectivity abstraction of schematic
+ rebuild_selection
+ Rebuild selection list
+ rect [x1 y1 x2 y2] [pos]
+ if 'x1 y1 x2 y2'is given place recangle on current
+ layer (rectcolor) at indicated coordinates.
+ if 'pos' is given insert at given position in rectangle array.
+ If no coordinates are given start a GUI operation of rectangle placement
+ redo
+ Redo last undone action
+ redraw
+ redraw window
+ reload
+ Forced (be careful!) Reload current schematic from disk
+ reload_symbols
+ Reload all used symbols from disk
+ remove_symbols
+ Internal command: remove all symbol definitions
+ replace_symbol inst new_symbol [fast]
+ Replace 'inst' symbol with 'new_symbol'
+ If doing multiple substitutions set 'fast' to 0
+ on first call and non zero on next calls
+ for faster operation
+ Example: xschem replace_symbol R3 capa.sym
+ rotate
+ Rotate selected objects around their centers
+ save
+ Save schematic if modified. Does not ask confirmation!
+ saveas [file] [type]
+ save current schematic as 'file'
+ if file is empty ({}) use current schematic name
+ as defalt and prompt user with file selector
+ 'type' is used used to set/change file extension:
+ schematic: save as schematic (*.sch)
+ symbol: save as symbol (*.sym)
+ If not specified default to schematic (*.sch)
+ Does not ask confirmation if file name given
+ schematic_in_new_window [new_process]
+ When a symbol is selected edit corresponding schematic
+ in a new tab/window if not already open.
+ If nothing selected open another window of the second
+ schematic (issues a warning).
+ if 'new_process' is given start a new xschem process
+ search regex|exact select tok val
+ Search instances with attribute string containing 'tok'
+ attribute and value 'val'
+ search can be exact ('exact') or as a regular expression ('regex')
+ select:
+ 0 : highlight matching instances
+ 1 : select matching instances
+ -1 : unselect matching instances
+ 'tok' set as:
+ propstring : will search for 'val' in the entire
+ *instance* attribute string.
+ cell::propstring : will search for 'val' in the entire
+ *symbol* attribute string.
+ cell::name : will search for 'val' in the symbol name
+ cell::<attr> will search for 'val' in symbol attribute 'attr'
+ example: xschem search regex 0 cell::template GAIN=100
+ select instance|wire|text id [clear]
+ Select indicated instance or wire or text.
+ For 'instance' 'id' can be the instance name or number
+ for 'wire' or 'text' 'id' is the position in the respective arrays
+ if 'clear' is specified does an unselect operation
+ select_all
+ Selects all objects in schematic
+ select_hilight_net
+ Select all highlight objects (wires, labels, pins, instances)
+ selected_set
+ Return a list of selected instance names
+ selected_wire
Return list of selected nets
- send_to_viewer
- Send selected wires/net labels/pins/voltage source or ammeter currents to current
- open viewer (gaw or bespice)
- set var value
- Set C variable 'var' to 'value'
+ send_to_viewer
+ Send selected wires/net labels/pins/voltage source or ammeter currents to current
+ open viewer (gaw or bespice)
+ set var value
+ Set C variable 'var' to 'value'
- cadgrid set cad grid (default: 20)
- cadsnap set mouse snap (default: 10)
@@ -1011,116 +1011,115 @@ C {verilog_timescale.sym} 1050 -100 0 0 {name=s1 timestep="1ns" precision="1ns"
- show_hidden_texts set to 1 to enable showing texts with attr hide=true
- sym_txt set to 0 to hide symbol texts
- set_different_tok str new_str old_str
- Return string 'str' replacing/adding/removing tokens that are
- different between 'new_str' and 'old_str'
- set_modify
- Force modify status on current schematic
- setprop instance inst tok [val] [fast]
- set attribute 'tok' of instance (name or number) 'inst' to value 'val'
- If 'val' not given (no attribute value) delete attribute from instance
- If 'fast' argument if given does not redraw and is not undoable
- setprop rect lay n tok [val] [fast|fastundo]
- Set attribute 'tok' of rectangle number'n' on layer 'lay'
- If 'val' not given (no attribute value) delete attribute from rect
- If 'fast' argument is given does not redraw and is not undoable
- If 'fastundo' s given same as above but action is undoable.
- setprop rect 2 n fullxzoom
- setprop rect 2 n fullyzoom
- These commands do full x/y zoom of graph 'n' (on layer 2, this is hardcoded).
- setprop text n tok [val] [fast|fastundo]
- Set attribute 'tok' of text number 'n'
- If 'val' not given (no attribute value) delete attribute from text
- If 'fast' argument is given does not redraw and is not undoable
- If 'fastundo' s given same as above but action is undoable.
- simulate
- Run a simulation (start simulator configured as default in
- Tools -> Configure simulators and tools)
- snap_wire
- Start a GUI start snapped wire placement (click to start a
- wire to closest pin/net endpoint)
- subst_tok str tok newval
- Return string 'str' with 'tok' attribute value replaced with 'newval'
- symbol_in_new_window [new_process]
- When a symbol is selected edit it in a new tab/window if not already open.
- If nothing selected open another window of the second schematic (issues a warning).
- if 'new_process' is given start a new xschem process
- symbols
- List all used symbols
- table_read [table_file]
- If a simulation raw file is lodaded unload from memory.
- else read a tabular file 'table_file'
- First line is the header line containing variable names.
- data is presented in column format after the header line
- First column is sweep (x-axis) variable
- Double empty lines start a new dataset
- Single empty lines are ignored
- Datasets can have different # of lines.
- new dataset do not start with a header row.
- Lines beginning with '#' are comments and ignored
-
- time var_a var_b var_c
- # this is a comment, ignored
- 0.0 0.0 1.8 0.3
- <single empty line: ignored>
- 0.1 0.0 1.5 0.6
- ... ... ... ...
- <empty line>
- <Second empty line: start new dataset>
- 0.0 0.0 1.8 0.3
- 0.1 0.0 1.5 0.6
- ... ... ... ...
- test
- testmode
- toggle_colorscheme
- Toggle dark/light colorscheme
- translate n str
- Translate string 'str' replacing @xxx tokens with values in instance 'n' attributes
- trim_wires
- Remove operlapping wires, join lines, trim wires at intersections
- undo
- Undo last action
- undo_type disk|memory
- Use disk file ('disk') or RAM ('memory') for undo bufer
- unhilight_all
- Clear all highlights
- unhilight
- Unhighlight selected nets/pins
- unselect_all
- Unselect everything
- update_all_sym_bboxes
- Update all symbol bounding boxes (useful if show_pin_net_names is set)
- view_prop
- View attributes of selected element (read only)
- if multiple selection show the first element (in xschem array order)
- warning_overlapped_symbols [sel]
- Highlight or select (if 'sel' set to 1) perfectly overlapped instances
- this is usually an error and difficult to grasp visually
- windowid
- Used by xschem.tcl for configure events
- wire [x1 y1 x2 y2] [pos] [prop] [sel]
- Place a new wire
- if no coordinates are given start a GUI wire placement
- xcb_info
- For debug
- zoom_box [x1 y1 x2 y2] [factor]
- Zoom to specified coordinates, if 'factor' is given reduce view (factor < 1.0)
- or add border (factor > 1.0)
- If no coordinates are given start GUI zoom box operation
- zoom_full [center|nodraw|nolinewidth]
- Set full view.
- If 'center' is given center vire instead of lower-left align
- If 'nodraw' is given don't redraw
- If 'nolinewidth]' is given don't reset line widths.
- zoom_hilighted
- Zoom to highlighted objects
- zoom_in
- Zoom in drawing
- zoom_out
- Zoom out drawing
- zoom_selected
- Zoom to selection
-
+ set_different_tok str new_str old_str
+ Return string 'str' replacing/adding/removing tokens that are
+ different between 'new_str' and 'old_str'
+ set_modify
+ Force modify status on current schematic
+ setprop instance inst tok [val] [fast]
+ set attribute 'tok' of instance (name or number) 'inst' to value 'val'
+ If 'val' not given (no attribute value) delete attribute from instance
+ If 'fast' argument if given does not redraw and is not undoable
+ setprop rect lay n tok [val] [fast|fastundo]
+ Set attribute 'tok' of rectangle number'n' on layer 'lay'
+ If 'val' not given (no attribute value) delete attribute from rect
+ If 'fast' argument is given does not redraw and is not undoable
+ If 'fastundo' s given same as above but action is undoable.
+ setprop rect 2 n fullxzoom
+ setprop rect 2 n fullyzoom
+ These commands do full x/y zoom of graph 'n' (on layer 2, this is hardcoded).
+ setprop text n tok [val] [fast|fastundo]
+ Set attribute 'tok' of text number 'n'
+ If 'val' not given (no attribute value) delete attribute from text
+ If 'fast' argument is given does not redraw and is not undoable
+ If 'fastundo' s given same as above but action is undoable.
+ simulate
+ Run a simulation (start simulator configured as default in
+ Tools -> Configure simulators and tools)
+ snap_wire
+ Start a GUI start snapped wire placement (click to start a
+ wire to closest pin/net endpoint)
+ subst_tok str tok newval
+ Return string 'str' with 'tok' attribute value replaced with 'newval'
+ symbol_in_new_window [new_process]
+ When a symbol is selected edit it in a new tab/window if not already open.
+ If nothing selected open another window of the second schematic (issues a warning).
+ if 'new_process' is given start a new xschem process
+ symbols
+ List all used symbols
+ table_read [table_file]
+ If a simulation raw file is lodaded unload from memory.
+ else read a tabular file 'table_file'
+ First line is the header line containing variable names.
+ data is presented in column format after the header line
+ First column is sweep (x-axis) variable
+ Double empty lines start a new dataset
+ Single empty lines are ignored
+ Datasets can have different # of lines.
+ new dataset do not start with a header row.
+ Lines beginning with '#' are comments and ignored
+
+ time var_a var_b var_c
+ # this is a comment, ignored
+ 0.0 0.0 1.8 0.3
+ <single empty line: ignored>
+ 0.1 0.0 1.5 0.6
+ ... ... ... ...
+ <empty line>
+ <Second empty line: start new dataset>
+ 0.0 0.0 1.8 0.3
+ 0.1 0.0 1.5 0.6
+ ... ... ... ...
+ test
+ testmode
+ toggle_colorscheme
+ Toggle dark/light colorscheme
+ translate n str
+ Translate string 'str' replacing @xxx tokens with values in instance 'n' attributes
+ trim_wires
+ Remove operlapping wires, join lines, trim wires at intersections
+ undo
+ Undo last action
+ undo_type disk|memory
+ Use disk file ('disk') or RAM ('memory') for undo bufer
+ unhilight_all
+ Clear all highlights
+ unhilight
+ Unhighlight selected nets/pins
+ unselect_all
+ Unselect everything
+ update_all_sym_bboxes
+ Update all symbol bounding boxes (useful if show_pin_net_names is set)
+ view_prop
+ View attributes of selected element (read only)
+ if multiple selection show the first element (in xschem array order)
+ warning_overlapped_symbols [sel]
+ Highlight or select (if 'sel' set to 1) perfectly overlapped instances
+ this is usually an error and difficult to grasp visually
+ windowid
+ Used by xschem.tcl for configure events
+ wire [x1 y1 x2 y2] [pos] [prop] [sel]
+ Place a new wire
+ if no coordinates are given start a GUI wire placement
+ xcb_info
+ For debug
+ zoom_box [x1 y1 x2 y2] [factor]
+ Zoom to specified coordinates, if 'factor' is given reduce view (factor < 1.0)
+ or add border (factor > 1.0)
+ If no coordinates are given start GUI zoom box operation
+ zoom_full [center|nodraw|nolinewidth]
+ Set full view.
+ If 'center' is given center vire instead of lower-left align
+ If 'nodraw' is given don't redraw
+ If 'nolinewidth]' is given don't reset line widths.
+ zoom_hilighted
+ Zoom to highlighted objects
+ zoom_in
+ Zoom in drawing
+ zoom_out
+ Zoom out drawing
+ zoom_selected
+ Zoom to selection
diff --git a/src/scheduler.c b/src/scheduler.c
index fe480bae..c3cbf821 100644
--- a/src/scheduler.c
+++ b/src/scheduler.c
@@ -1216,7 +1216,7 @@ int xschem(ClientData clientdata, Tcl_Interp *interp, int argc, const char * arg
/* get_tok str tok [with_quotes]
* get value of token 'tok' in string 'str'
- * 'with_quotes' (default:0) is an integer passed to get_tok_value() */
+ * 'with_quotes' (default:0) is an integer passed to get_tok_value() */
else if(!strcmp(argv[1], "get_tok") )
{
char *s=NULL;
@@ -2042,7 +2042,7 @@ int xschem(ClientData clientdata, Tcl_Interp *interp, int argc, const char * arg
}
/* netlist
- * do a netlist of current schematic in currently defined netlist format */
+ * do a netlist of current schematic in currently defined netlist format */
else if(!strcmp(argv[1], "netlist") )
{
yyparse_error = 0;