S2R(1)

📦 version 5.1.1, in fedora 43, fedora 44

✨ S2R(1) ✨ — the <rainbow>ALLIANCE USER COMMANDS</rainbow> era, bestie edition 💅

okay so. bestie. sit down. we're talking about s2r today and honestly it's giving glow-up energy for your chip 💖

🎀 NAME 🎀

s2r — process mapping from symbolic layout to physical layout. that's it, that's the whole job, and it ate. 🔥

🦋 ORIGIN 🦋

this software belongs to the ALLIANCE CAD SYSTEM, developed by the ASIM team at the LIP6 laboratory of Université Pierre et Marie CURIE, in Paris, France 🇫🇷✨ (yes the actual Paris, no cap).

🌸 SYNOPSIS 🌸

s2r [-tc1rv] source [result]

short, iconic, does exactly what it says. 👑

💖 DESCRIPTION 💖

so the whole goal of s2r is to perform the translation from the symbolic layout to the physical layout for the foundry. yes, the foundry. the place where your little drawing becomes ✨real✨.

s2r uses a technology file whose name is defined by the environment variable RDS_TECHNO_NAME.

some cells, like I/O pads, are specific to a given foundry. in the symbolic methodology, these cells are phantom cells 👻 — meaning only their abutment box and connectors are present. s2r will substitute physical cells for the symbolic phantom cells.

⚠️ beware bestie!! this implies that the manufacturer cells must be modified by hand to ensure the abutment box is a symbolic grid step multiple, and that the real connectors are centered on symbolic grid. no shortcuts here, fr fr.

and for the replacement to work well, the physical cells must have the abutment box lower left corner at coordinate (0,0). the names of cells to be replaced are written in the catalog file with the G attribute — see catal(5) for details on that file. see also ring(1) for more on pads. 💫

output can be generated in either cif or gds formats, to fit the manufacturer requirements.

mainly two kinds of users are concerned with s2r:

  • experts — they should be able to parametrize the technology file for a new process technology file, which is described in techno(5).
  • designers — they are not directly concerned with the target process, but need to be able to compute real capacitances for simulation.

the source argument is the name of the symbolic layout file to be translated. the optional result argument indicates the name to be given to the real layout output. this name is also the name of the top level model of the layout hierarchy. if the result name is omitted, then the source name is used. periodt. 💅

🌈 the six environment variables 🌈

six environment variables must be set for proper usage of s2r, all of them having default values, thus ensuring the possibility of using it "as it is". main character energy honestly 🫶

  • MBK_IN_PH — the input format for symbolic layout is given by this environment variable. the possible values are cp, ap. default is cp. see MBK_IN_PH(1) for details.
  • MBK_CATA_LIB — sets the directories that are to be searched thru for reading files. the searching mechanism first looks in MBK_WORK_LIB(1). MBK_WORK_LIB defines the path where the generated file is saved. make sure the write permissions are set up correctly, otherwise no save will occur. 😭
  • MBK_CATAL_NAME — this indicates the name of the catalog file used for pad substitution. for the appropriate syntax of this file, see catal(5).
  • RDS_IN — defines the format to be used as input for cell substitution. the available ones are cif and gds (the default one). the cells to be parsed must not contain 45 degrees wires. if an unknown layer is encountered, the entire cell will be skipped. 💀
  • RDS_OUT — gives the format of the output file. this may be either cif or gds (default is gds).
  • RDS_TECHNO_NAME — this points to the technology file to be used for symbolic to real translation. this file is in general shared between all the designers. it is the full path name to the file location, with the extension.

✨ OPTIONS ✨

without any option, s2r should produce a layout that fits for the foundry. nevertheless, its behaviour can be modified when invoked with the following options 👇

  • -t — suppress the denotching phase. s2r performs gap filling, denotching in order to avoid DRC errors. this operation is time consuming. it is mandatory for the foundry but not really useful for capacitance evaluation.
  • -c — deletes connectors and node names at all hierarchy level. these objects link the physical view and the logical view of a chip. if simulation is to be done after physical mapping, connectors must appear, so that the extractors and simulators can use them. this must not be used when preparing a final layout for the foundry. for the factory, the top level connectors are forbidden, since they do not represent any physical reality. 🚫
  • -1 — creates the top level cell with the instances as black boxes. this may be useful for hierarchical extractors, since the file size may be greatly reduced. 📉
  • -r — does not replace black boxes. cells flagged with the G attribute in the catal(5) file will not be replaced by their equivalent layout loaded from disk.
  • -v — verbose mode on. 🗣️

🌟 EXAMPLES 🌟

you should first have a correct execution environment 🫶 it is recommended to put it in the ".cshrc" file if in c shell, as in the example below.

setenv MBK_IN_PH              ap
setenv MBK_WORK_LIB      ~fred/mbk/layout
setenv MBK_CATA_LIB      ~franck/s2r:/alliance/cells
setenv MBK_CATAL_NAME    catalog
setenv RDS_TECHNO_NAME   /labo/etc/prol15.rds
setenv RDS_IN            gds
setenv RDS_OUT           gds
s2r -c na2_y

this invocation will produce the cell na2_y from the standard cell library in real layout, without connectors, scotches if needed, in gds format. iconic. obsessed. 💖

👑 SEE ALSO 👑

mbk(1), ring(1), MBK_IN_PH(1), MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_CATAL_NAME(1), RDS_IN(1), RDS_OUT(1), RDS_TECHNO_NAME(1), techno(5), catal(5).

(the whole friend group, together, slaying. 🌈)

💜 DIAGNOSTICS 💜

the actual version of the gds parser and driver doesn't translate neither connectors, nor node names. if an extraction on s2r output is needed, cif format will create the connectors using cif extension 4X, and the node names with 4N. noted 📝

🍓 BUG REPORT 🍓

this tool is under development at the ASIM department of the LIP6 laboratory.

we need your feedback to improve documentation and tools. 🥺👉👈 please, bestie, we're literally asking.

okay that's the whole page!! this one came from ASIM/LIP6 and it's dated October 1, 1997 — vintage, but still serving absolute looks. take care of your abutment boxes out there. bye bestie 🦋💅✨

📦 where this page comes from