luke
/
magic
mirror of https://github.com/RTimothyEdwards/magic.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
magic/extract/extract.h

153 lines
5.3 KiB
C
Raw Normal View History

Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/*
* extract.h --
*
* Defines the exported interface to the circuit extractor.
*
* rcsid "$Header: /usr/cvsroot/magic-8.0/extract/extract.h,v 1.3 2009/01/30 03:51:02 tim Exp $"
*
Updates from running the fix-ending-whitespace script.
2020-05-23 23:13:14 +02:00
* *********************************************************************
* * Copyright (C) 1985, 1990 Regents of the University of California. *
* * Permission to use, copy, modify, and distribute this *
* * software and its documentation for any purpose and without *
* * fee is hereby granted, provided that the above copyright *
* * notice appear in all copies. The University of California *
* * makes no representations about the suitability of this *
* * software for any purpose. It is provided "as is" without *
* * express or implied warranty. Export of this software outside *
* * of the United States of America may require an export license. *
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
* *********************************************************************
*
*/
header file #ifndef guard namespace consistency (global change) This add an effective namespace prefix to the guard ifndef
2024-10-16 08:38:41 +02:00
#ifndef _MAGIC__EXTRACT__EXTRACT_H
#define _MAGIC__EXTRACT__EXTRACT_H
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
#include "utils/magic.h"
extract.h/EFVisit.h include database.h for TileTypeBitMask This has a knock on effect of causing EFvisit.c to require database.h to be defined BEFORE the EFint.h due to an identical copy of ArrayInfo type being present in both files. Maybe there should be database_arrayinfo.h ? To remove the copy.
2025-02-17 10:41:50 +01:00
#include "database/database.h" /* TileTypeBitMask */
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/* Extractor warnings */
#define EXTWARN_DUP 0x01 /* Warn if two nodes have the same name */
#define EXTWARN_LABELS 0x02 /* Warn if connecting to unlabelled subcell
* node.
*/
#define EXTWARN_FETS 0x04 /* Warn about badly constructed fets */
#define EXTWARN_ALL (EXTWARN_DUP|EXTWARN_LABELS|EXTWARN_FETS)
extern int ExtDoWarn; /* Bitmask of above */
/* Known devices (see ExtTech.c and ExtBasic.c) */
/* Make sure these match extDevTable in extract/ExtBasic.c and */
/* also extflat/EFread.c */
#define DEV_FET 0 /* FET w/area, perimeter declared */
#define DEV_MOSFET 1 /* FET w/length, width declared */
#define DEV_ASYMMETRIC 2 /* Like MOSFET but D,S not swappable */
#define DEV_BJT 3 /* Bipolar Junction Transistor */
#define DEV_RES 4 /* Resistor */
#define DEV_CAP 5 /* Capacitor */
#define DEV_CAPREV 6 /* Capacitor, terminals reversed */
Implemented a command option "ext2spice short voltage|resistor|none" that implements a method for handling ports in a subcircuit that have different port names and indexes but are shorted together. "none" is the default and backwards-compatible behavior that merges ports together, which will often cause one of the ports to be optimized out of the netlist. "resistor" will separate the port names with a 0-ohm ideal resistor. "voltage" will separate the port names with a 0-volt voltage source. This should work well for simulation and potentially for LVS, although its impact on LVS has not been fully investigated.
2021-07-11 03:13:24 +02:00
#define DEV_VOLT 7 /* Voltage source (used for shorts) */
#define DEV_DIODE 8 /* Diode */
#define DEV_PDIODE 9 /* pDiode, same as Diode */
#define DEV_NDIODE 10 /* nDiode, terminals reversed */
#define DEV_SUBCKT 11 /* general-purpose subcircuit */
#define DEV_RSUBCKT 12 /* Resistor-like subcircuit. */
#define DEV_MSUBCKT 13 /* MOSFET-like subcircuit. */
#define DEV_CSUBCKT 14 /* Capacitor-like subcircuit. */
Added a new device type "dsubcircuit" which basically behaves like "csubcircuit" but swaps the first two pins (with the device identifier layer becoming the 2nd pin and the other terminal the first), which is needed for n-type diodes modeled as subcircuits where the subcircuit pin order matches the order of pins for a SPICE n-type diode component. Previously "msubcircuit" was used for this purpose, but will calculate the wrong L and W. While use of L and W for diodes is rare, this device type also works for reversed capacitors (where the bottom or non-identifying layer terminal is in the first pin position of the subcircuit).
2025-10-07 22:45:22 +02:00
#define DEV_DSUBCKT 15 /* Diode-like subcircuit. */
#define DEV_VERILOGA 16 /* Verilog-A model ("N" component) */
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/* Device names for .ext file output (new in version 7.2) */
/* (defined in extract/ExtBasic.c *and* extflat/EFread.c) */
extract/ExtBasic.c: Lookup() constify call-site
2024-10-10 21:20:26 +02:00
extern const char * const extDevTable[];
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
/* Extractor options */
Implemented a command option "ext2spice short voltage|resistor|none" that implements a method for handling ports in a subcircuit that have different port names and indexes but are shorted together. "none" is the default and backwards-compatible behavior that merges ports together, which will often cause one of the ports to be optimized out of the netlist. "resistor" will separate the port names with a 0-ohm ideal resistor. "voltage" will separate the port names with a 0-volt voltage source. This should work well for simulation and potentially for LVS, although its impact on LVS has not been fully investigated.
2021-07-11 03:13:24 +02:00
#define EXT_DOADJUST 0x001 /* Extract hierarchical adjustments */
#define EXT_DOCAPACITANCE 0x002 /* Extract capacitance */
#define EXT_DOCOUPLING 0x004 /* Extract coupling capacitance */
#define EXT_DORESISTANCE 0x008 /* Extract resistance */
#define EXT_DOLENGTH 0x010 /* Extract pathlengths */
(1) Corrected an error in generating GDS_FILE properties when reading GDS files, caused by an unneeded change to pass both the "original" filename and the actual filename when handling compressed files---The original filename is unneeded. (2) Implemented several new methods for parasitic extraction. The first is an option offset value to apply to sidewall calculations. This handles issues where actual wire separation is different from drawn wire separation, which can be significant for the 1/d calculation of sidewall coupling. The second method is to use the recently-added fringe halo to compute the coupling of the fringe capacitance to nearby wires. Prior to this change, all fringe capacitance was applied to surfaces directly under a wire edge as if the fringe capacitance did not extend outward from the edge. Now the capacitance is properly pro-rated for the position of any overlapped shape inside the fringing field. Finally, the third method added is a new search algorithm for finding the nearest shapes along the length of a boundary. This is used for sidewall coupling and fringe shielding, where the nearest shape dominates the coupling, and any shapes behind are shielded and may (to first order) be ignored. Previously, the entire halo was searched without regard to shapes shielding other shapes behind, and a recent correction added an ad-hoc search for blocking shapes that was inefficient and not always correct. The new method is both efficient and accurate.
2022-05-28 16:33:21 +02:00
#define EXT_DOFRINGEHALO 0x020 /* Distributed fringe capacitance */
#define EXT_DOALL 0x03f /* ALL OF THE ABOVE */
Reimplemented the "extract do local" option as "extract path <name>" with "extract do local" now being equivalent to "extract path .". This allows extraction files to be put in a subdirectory and not clog up the current working directory. Also: Fixed some behavior around the use of "ext2spice -p <path>" so that it (1) works, and (2) is compatible with the new "extract path". Since the ext2spice and ext2sim commands are effectively independent of the primary extraction, the "-p" option is needed to correspond to the use of "extract path". Hopefully this is seen as only a minor inconvenience.
2023-06-14 19:55:59 +02:00
#define EXT_DOLABELCHECK 0x040 /* Check for connections by label */
#define EXT_DOALIASES 0x080 /* Output all node aliases */
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern int ExtOptions; /* Bitmask of above */
Reimplemented the "extract do local" option as "extract path <name>" with "extract do local" now being equivalent to "extract path .". This allows extraction files to be put in a subdirectory and not clog up the current working directory. Also: Fixed some behavior around the use of "ext2spice -p <path>" so that it (1) works, and (2) is compatible with the new "extract path". Since the ext2spice and ext2sim commands are effectively independent of the primary extraction, the "-p" option is needed to correspond to the use of "extract path". Hopefully this is seen as only a minor inconvenience.
2023-06-14 19:55:59 +02:00
extern char *ExtLocalPath; /* If non-NULL, location to write .ext files */
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
Added option "notopports" to "extract unique". The option behaves like "extract unique all" on all cells below the topmost level of hierarchy, and "extract unique noports" on the top level.
2021-09-09 21:47:48 +02:00
/* Options for "extract unique" */
#define EXT_UNIQ_ALL 0
#define EXT_UNIQ_TAGGED 1
#define EXT_UNIQ_NOPORTS 2
#define EXT_UNIQ_NOTOPPORTS 3
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
extern bool ExtTechLine();
extern void ExtTechInit();
extern void ExtTechFinal();
extern void ExtSetStyle();
extern void ExtPrintStyle();
Reimplemented the "extract do local" option as "extract path <name>" with "extract do local" now being equivalent to "extract path .". This allows extraction files to be put in a subdirectory and not clog up the current working directory. Also: Fixed some behavior around the use of "ext2spice -p <path>" so that it (1) works, and (2) is compatible with the new "extract path". Since the ext2spice and ext2sim commands are effectively independent of the primary extraction, the "-p" option is needed to correspond to the use of "extract path". Hopefully this is seen as only a minor inconvenience.
2023-06-14 19:55:59 +02:00
extern void ExtSetPath();
extern void ExtPrintPath();
Moved the substrate plane/restore further out so that planes are not restored until after all cells have been processed through extraction. Otherwise, top-down connections can end up with different generated names for the same node, resulting in a disconnect in the netlist.
2021-04-05 22:03:54 +02:00
extern void ExtRevertSubstrate();
extern Plane *ExtCell();
Found another issue with the substrate extraction, caused by the fact that "extract all" does not enumerate cells from bottom up as I had assumed---The order is roughly bottom-to-top, but cells re-used in different places in the hierarchy could end up called before one or more of their own subcells is extracted. Since this conflicted with the preparation of the substrate in each extracted subcircuit, I changed the method to enumerate cells so that it is properly bottom-to-top. Also, methods were added to "extract" (incremental), "extract cell", and "extract parents" to ensure that the substrate is prepared on all subcells before extraction.
2022-04-06 03:33:15 +02:00
extern void ExtractOneCell();
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
Enhanced the "lef write" routine: (1) Calculates gate and diff areas and writes ANTENNAGATEAREA and ANTENNADIFFAREA values. (2) Determines "USE POWER" or "USE GROUND" from label names matching Tcl variables $VDD and $GND, if the USE has not been registered as a cell property (knowning the use allows magic to avoid writing an ANTENNADIFFAREA for power rails, although doing so should not be an issue).
2020-05-21 22:26:24 +02:00
extern int ExtGetGateTypesMask();
extern int ExtGetDiffTypesMask();
Finished first cut at an implementation of antenna rule violation checks. Added new command "antennacheck" and a routine that adds feedback entries where violations are found. Extended the syntax of the extraction section of the techfile to support the antenna ratios and antenna calculation methods.
2019-10-21 04:12:02 +02:00
Initial commit at Tue Apr 25 08:41:48 EDT 2017 by tim on stravinsky
2017-04-25 14:41:48 +02:00
#ifdef MAGIC_WRAPPER
extern bool ExtCompareStyle();
#endif
#ifdef THREE_D
extern void ExtGetZAxis();
#endif
extern void ExtDumpCaps();
ExtPerim.c: extEnumTilePerim() pass by-pointer const TileTypeBitMask* instead of by-value sizeof(TileTypeBitMask) == 32
2025-02-17 10:44:49 +01:00
extern int extEnumTilePerim(Tile *tpIn, const TileTypeBitMask *maskp, int pNum, int (*func)(), ClientData cdata);
Found another issue with the substrate extraction, caused by the fact that "extract all" does not enumerate cells from bottom up as I had assumed---The order is roughly bottom-to-top, but cells re-used in different places in the hierarchy could end up called before one or more of their own subcells is extracted. Since this conflicted with the preparation of the substrate in each extracted subcircuit, I changed the method to enumerate cells so that it is properly bottom-to-top. Also, methods were added to "extract" (incremental), "extract cell", and "extract parents" to ensure that the substrate is prepared on all subcells before extraction.
2022-04-06 03:33:15 +02:00
extern Plane *extPrepSubstrate();
Compatibility with C99 standard This commit makes the code (mostly) C99-compatible, enabling to compile it without the -Wno-error=implicit-function-declaration flag. This way, Magic becomes usable on arm64 architectures, specifically on Apple computers with M1/M2 SoC.
2022-10-10 11:50:15 +02:00
/* C99 compat */
extern void ExtAll();
extern void ExtIncremental();
extern void ExtLengthClear();
extern void ExtParents();
extern void ExtSetDriver();
extern void ExtSetReceiver();
extern void ExtShowParents();
extern void ExtTechScale();
extern void ExtUnique();
extern void ExtractTest();
extern int ExtFindNeighbors();
extern void ExtFreeLabRegions();
extern void ExtResetTiles();
extern void extArray();
extern void extFindCoupling();
extern void extHierAdjustments();
extern void extHierConnections();
extern void extHierFreeLabels();
extern void extHierFreeOne();
extern void extHierFreeOne();
extern void extHierSubstrate();
extern int extHierYankFunc();
extern bool extLabType();
extern void extLength();
extern void extLengthInit();
extern void extOutputConns();
extern void extOutputCoupling();
extern int extPathTileDist();
extern void extRelocateSubstrateCoupling();
extern void extSetNodeNum();
extern void extShowTile();
extern void extSubtree();
extern int extUniqueCell();
extern void ExtLabelOneRegion();
extern void ExtInit();
C99 code compat when configured with no TCL support
2022-10-28 07:50:29 +02:00
extern bool ExtGetDevInfo();
Resolved an issue with magic crashing during "antennacheck" due to a routine that should have been called with a NULL argument, but instead was called with no argument, making the behavior system- dependent. Revised the parsing of the "defaultareacap" and "defaultperimeter" statements in the tech file, such that the short version of both statements gets automatic handling of the substrate and isolated substrate areas; this goes back to the recent change in extraction behavior to redefine the "substrate type" (e.g., pwell) during extraction as defining isolated substrate areas, and not the default substrate. The earlier code change dealt with problems related to extracting nodes and regions, but did not consider how parasitic capacitance was affected. This commit resolves that issue.
2022-02-23 21:02:40 +01:00
header file #ifndef guard namespace consistency (global change) This add an effective namespace prefix to the guard ifndef
2024-10-16 08:38:41 +02:00
#endif /* _MAGIC__EXTRACT__EXTRACT_H */