Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 1 CL D LS - LAYUTILIdea / Concept L A Y U T I L - script-pool for all layout designer - collect project independent scripts - layout designers without programming experience can use this script pool to help their design automation process - reduce redundant effort - use scripts in this script pool easily and effectively

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 2 CL D LS - LAYUTILBuild-up / Structure Availability:available in an usual directory-format Package Name:layutil Data location:/opt/layutil/current/  an ongoing pool /opt/layutil/yy.mm/  static released version as reference Pool access:world can read/execute only admin can write too, user have to submit a script to pool admin and pool admin will add it to the script pool (see pages 7-9) Original Pool:located in Munich Pool admins:Markus Schümmer Heinz Endres

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 3 CL D LS - LAYUTILPackage-Directory Structure /opt/layutil/current/ | Layutil_Guideline.doc-- Layutil-Guideline (Word-Format) | perl-- Directory for executable perl-scripts (.txt-Files as docu) | tcl-- Directory for executable tcl-scripts (.txt-Files as docu) | blastfusion_complex-- Complex scripts for blastfusion (like blastrail, eco,...) | templates-- Header-Templates for users to adapt to their work | lib-- Configuration/Built-in database for perl-scripts | README.TXT-- content of directory with short description (in each directory)

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 4 CL D LS - LAYUTILUse of script pool - From time to time the current-version will be copied to a static released version as a reference /opt/layutil/yy.mm... yy is the release year and mm is the release month - A file README.TXT in each directory will contain a list of files and subdirectories in those directory together with a short description - Copy script from /opt/layutil/ into project: e.g.: cp -p /opt/layutil/current/tcl/addBufString.tcl …/routing/blastfusion/scripts/TCL/  software will be updated frequently cp -p /opt/layutil/ /tcl/addBufString.tcl …/routing/blastfusion/scripts/TCL/  software is stable cc.ci …/routing/blastfusion/scripts/TCL source …/routing/blastfusion/TCL/addBufString.tcl

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 5 CL D LS - LAYUTILGuideline for scripts 1 1. Template scripts are available in directory /opt/layutil/current/templates/. - template_script.tcl (for TCL-Scripts) - template_script.pl (for PERL-Scripts) - template_script.scm (for SCHEME-Scripts) 2. The header should be copied out of the template-script and be filled out as much as possible. Minimum entries are - name of function(s) - author + department + date - Tool/Version - Toolbug? - short description what can be done with this script/function - usage - example of the function - history Optional entries are: - explanations about the parameters and options - recommendation/Hints

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 6 CL D LS - LAYUTILGuideline for scripts 2 3. The program-style is dependant on each programmer, cause the author is responsible for his script, there is no guideline here. Comments inside the script are desirable. 4. Optional and maybe helpful for users is a built-in user help page. This page should be able to invoke with -h or -help options. 5. If script is required to load any configuration/built-in database provide this also to the pool. Those files are located then in directory /opt/layutil/current/lib/.

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 7 CL D LS - LAYUTILScript submission process 1 Following assumption is made for the script: 1. The author is responsible for the correctness of their script. The script won’t be tested (by pool admin) before added to the pool. 2. The functionality of submitted scripts should be tested at least with the project it created for. 3. Script should follow all guideline described on page 5 and 6 (Guideline for scripts). 4. All necessary database/library-files should come together with the script.

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 8 CL D LS - LAYUTILScript submission process 2 Single File: To submit a simple script that is only single file, please copy over script and documentation, if available, to directory /opt/basar/ in Munich, change permissions and send an electronic mail to The content of electronic mail should contain a short description for the script and any necessary information. The script will be copied over directly to pilot pool (/opt/layutil/current/).

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 9 CL D LS - LAYUTILScript submission process 3 Multiple Files: The complex script, that need many files for its functionality, should be submitted to the script pool in form of.tar.gz archive which contain a script and its data file in a directory structure. Like a simple script file, the submitter have to copy this archive to directory /opt/basar/ in Munich, change permissions and send an electronic mail to The content of electronic mail should contain a short description for the script and any necessary information. The script will be copied over directly to pilot pool (/opt/layutil/current). Apart from the program and its library, the writer of a script to fix a complex problem is highly recommended to spend some time on a user manual. The manual should be a plain Text-file (.txt).

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 10 CL D LS - LAYUTIL Bug / Enhancement report One big problem for the script pool is the support system. Generally users should assume zero support from the author or the script program. Anyway, users may obtain an informal support from the script author via electronic mail. This support will rely solely on current workload of the program authors. Software Bug: - users are highly recommended to contact the program author and have pool administrator address in cc list - not necessary that the program authors have to fix all reported bug - can be fixed by both users and authors Feature Enhancement: - users may modify an existing script to enhance some extra feature - modification should remain the backward compatibility - if the compatibility can not be maintained, the modifiers are encourage to change the script name

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 11 CL D LS - LAYUTIL Script updating process - Both bug fixed and feature enhanced scripts are highly recommended to resubmitted back to the script pool. - While the script with a new name should be submitted as a new script. - If the script keeps the same name it can be resubmitted through an update protocol: 1. Please indicate in the mail that it is the updating package. 2. It is recommended to have a comment in the header of script indicating the modification and the date of modification (History-Part in the header of template_script). 3. For a complex script, script author should mention modified, newly added or removed files in the mail. If not there will assume no removed file.

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 12 CL D LS - LAYUTILScript-Examples addBuffer.tcl : Tcl-script to automatically insert a buffer, an inverter or a delay cell at a given cell or model pin blockageAroundAllPins.tcl : Creates small metal 1 blockages around standard cell pins The purpose is to force the router to contact the standard cell pins in metal2 and in case of a Metal-Redesign, hopefully the most expensive metal1-mask needs not to be touched changeBlockagesInsideWindow.tcl : This script contains several functions to modify/query Layer and Blockages inside a given window checkRefLibs.tcl : checks the referenced libraries used at the first creation of a volcano (bind step) and export copy_deep_blackages.tcl : This routine pull-ups all existing blockages in the specified layer to top (maybe some blockages in RAMs, Fuses in hierarchical blocks are not on top or level1) findCell.tcl : Finds a certain cell master in all available libraries If a cell name matches exactly the input, this cell is returned

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 13 CL D LS - LAYUTILScript-Examples findCriticalLeakage.tcl : Finds regular cells with unnecessary positive slack. Optional, an ECO to low leakage cells is done. findOpenInputs.tcl : Script to find all unconnect input pins at macros, pads and ios insertCell.tcl : Just a routine to insert a cell at a specific position maintain_hierarchy_with_given_cells.tcl : This script maintains all hierarchies with more than a given number of cells placeSpareCells.tcl : This function distributes all cells matching the regular pattern randomly over the available standard cell area traceClk.tcl : Travels through a complete clock-net down to all leaf cells. It prints an ASCII diagram in 'fileName' about the complete clock structure. Very useful to analyze the clock implementation in the front-end netlist.

Company ConfidentialLayout Synthesis Markus Schuemmer CL D LS 16. Oktober 2015 Page 14 CL D LS - LAYUTILResponsibility If you have problems, questions or comments feel free to contact one of the following persons: Markus Tel.: Heinz Tel.: