As ever
Object: TYPE ~ CD.Object;
Instance: TYPE ~ CoreGeometry.Instance;
Instances: TYPE ~ CoreGeometry.Instances;
Design: TYPE ~ CD.Design;
Technology: TYPE ~ CD.Technology;
CellType: TYPE ~ Core.CellType;
ROPE: TYPE ~ Core.ROPE;
Wire: TYPE ~ Core.Wire;
Wires: TYPE ~ Core.Wires;
Properties: TYPE ~ Core.Properties;
CellInstance: TYPE ~ CoreClasses.CellInstance;
CellInstances: TYPE ~ CoreClasses.CellInstances;
InstancePath: TYPE ~ CoreFlat.InstancePath;
FlatWire: TYPE ~ CoreFlat.FlatWire;
FlatWireRec: TYPE ~ CoreFlat.FlatWireRec;
FlatCellType: TYPE ~ CoreFlat.FlatCellType;
FlatCellTypeRec: TYPE ~ CoreFlat.FlatCellTypeRec;
Mode: TYPE ~ Sinix.Mode;
Decoration: TYPE = CoreGeometry.Decoration;
Links between Core and ChipNDale
The functions in this section permit to designate Core objects (instance or wire) through the CD selection mechanism.
IsIcon:
PROC [decoration: Decoration, cell: CellType]
RETURNS [
BOOL];
An icon is defined as a cellType decorated with interface decoration, but that is not a recordCell.
ExtractCDInstance:
PROC [instance: Instance, design: Design, mode: Mode]
RETURNS [result:
REF, props: Properties];
This version of Sinix.Extract starts from a top-level CD Instance and computes the context if necessary (currently because of satellites).
Returned arguments have same meaning as in Sinix.Extract.
ExtractCDStack:
PROC [design: Design, mode: Mode]
RETURNS [instance: Instance, root: CellType];
Extracts all cells in the CD stack, which is assumed to be non-empty.
instance is the top-level CD instance.
root is the extraction result of the outer cell, assumed to be a CellType.
root will be NIL if there is an error. A message is printed on the terminal in that case.
CDStackToPath:
PROC [design: Design, mode: Mode]
RETURNS [instance: Instance, root: CellType, pushed: CellType, flatPushed: FlatCellTypeRec];
Converts the current pushed-in stack (assumed to be non-empty) into a CoreFlat path respective to the outermost pushed-in cell.
instance is the top-level CD instance.
root is the extraction result of the outer cell, assumed to be a CellType.
In case of failure, root will be NIL and a message has been printed on the terminal.
pushed is the outermost icon or recordCell (might be root).
flatPushed is the path from root (might be []).
SelectedCoreObjects:
PROC [design: Design, mode: Mode, flatCellsActuals:
BOOL ←
FALSE]
RETURNS [instance: Instance, root: CellType, pushed: CellType, flatPushed: FlatCellTypeRec, flatCells:
LIST
OF FlatCellTypeRec ←
NIL, flatWires:
LIST
OF FlatWireRec ←
NIL];
Returns all Core cellTypes and wires that are selected in the currently pushed-in cell.
instance is the top-level CD instance.
root is the extraction result of the outer cell, assumed to be a CellType. In case of failure, root will be NIL and a message has been printed on the terminal.
pushed is the outermost icon or recordCell (might be root).
If flatCellsActuals, actuals of flatCells are added to flatWires.
IF NOT IsIcon[pushed], flatCells and flatWires design the selected instances. Each flatWire has wireRoot=internal.
IF IsIcon[pushed], flatCells=NIL and flatWires design the selected instances. Each flatWire has wireRoot=public.
If a structured wire is selected all its sub wires also appear in flatWires.
All flatWires are canonized.
SelectedCellType:
PROC [design: Design, mode: Mode]
RETURNS [instance: Instance, root: CellType, cell: CellType, flatCell: FlatCellTypeRec, transf: Instance];
Returns the current selected cell, assuming that the selection is unique.
transf is the transformation to apply to its decoration in order to get design coordinates.
If design was at top level, instance = transf = the selected instance, root = cell, flatCell = [].
If any error occurs, a message is printed on the terminal and root=NIL.
Registration of extract modes
RegisterDefaultLayoutMode:
PROC [technology: Technology, mode: Mode];
Create menu entries for extraction and highlighting
RegisterExtractCommand:
PROC [technology: Technology ←
NIL, mode: Mode, prompt:
ROPE, key:
ATOM];
Create menu entry for extraction using a non-layout extractor (e.g. Sisyph). If technology is NIL, the entry will be valid for ALL technologies.
RegisterHighlightCommand:
PROC [technology: Technology ←
NIL, mode: Mode, prompt:
ROPE, key:
ATOM];
Create menu entry for highlighting using a non-layout extractor (e.g. Sisyph). If technology is NIL, the entry will be valid for ALL technologies.
RegisterBackgroundExtractionCommand:
PROC [technology: Technology, mode: Mode, prompt:
ROPE, key:
ATOM, filter: FilterProc];
FilterProc: TYPE = PROC [design: Design, name: ROPE, object: Object] RETURNS [extract: BOOL];
Create a menu entry for starting/stopping background extraction of filtered objects. If technology is NIL, the entry will be valid for ALL technologies.
GetExtractMode:
PROC [tech:
REF]
RETURNS [mode: Mode ←
NIL];
Recover the layout extract mode associated to a technology.
tech can be a Technology or an atom name of a Technology.
mode must have been previously registered through RegisterDefaultLayoutMode.