Skip to content

2 Week digital VLSI SoC design and planning workshop with complete RTL2GDSII flow organized by VSD in collaboration with NASSCOM (Advanced Physical Design using OpenLANE /Sky130)

License

Notifications You must be signed in to change notification settings

ShyamRazesh/DIGITAL-VLSI-SOC-DESIGN-AND-PLANNING

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 

Repository files navigation

DIGITAL-VLSI-SOC-DESIGN-AND-PLANNING

OS EDA Tools languages

last commit files repo size

Contents

Author: Shyam Razesh

Acknowledgments: SoC design Program by Mr. Kunal Ghosh , VLSI System Design

OpenSource Physical Design

This repository contains all the information studied and created during the Digital VLSI SoC Design and Planning workshop. It is primarily foucused on a complete RTL2GDS flow using the open-soucre flow named OpenLANE. PICORV32A RISC-V core design is used for the purpose.

Introduction To RTL to GDSII Flow

RTL to GDSII Flow refers to the all the steps involved in converting a logical Register Transfer Level(RTL) Design to a fabrication ready GDSII format. GDSII is a database file format which is an industry standard for data exchange of IC layout artwork. The RTL to GSDII flow consists of following steps:

  • RTL Synthesis
  • Static Timing Analysis(STA)
  • Design for Testability(DFT)
  • Floorplanning
  • Placement
  • Clock Tree Synthesis(CTS)
  • Routing
  • GDSII Streaming

All the steps are further discussed in details in the repository.

About Google SkyWater PDK

Google and SkyWater Technology Foundry in collaboration have released a completely open-source Process Design Kit(PDK) in May, 2020. The current release target to a SKY130 (i.e. 130 nm) process node is available as SkyWater Open Source PDK. The PDK provides Physical VLSI Designer with a wide range of flexibility in design choices. All the designs and simulations listed in this repository are carried out using the same SkyWater Open Source PDK.

List of All Open-Source Tools Used

Name of Tool Application / Usage
Yosys Synthesis of RTL Design
ABC Mapping of Netlist
OpenSTA Static Timing Analysis
OpenROAD Floorplanning, Placement, CTS, Optimization, Routing
TritonRoute Detailed Routing
Magic VLSI Layout Tool
NGSPICE SPICE Extraction and Simulation
SPEF_EXTRACTOR Generation of SPEF file from DEF file

Setting Up Environment

The above list of tools shows that, many different tools are required for various tasks in Physical VLSI Design. Each tool in itself have number of system requirements and require various supporting tools to be installed. Installing each tool one-by-one seems in-efficient. This is made easy by some custom scripts that setup the required tools and environment for them in just a few easy steps. To install all the required tools, one can refer to the below mentioned repositories:

  • VSDFlow - Installs Yosys, Magic, OpenTimer, OpenSTA and some other supporting tools
  • OpenLANE Build Scripts - Install all required OpenROAD and some supporting tools

Created a VM on my Laptop

Screenshot 2024-04-10 121518

Day 1- Inception of open-source EDA, OpenLANE and Sky130 PDK

Digital ASIC Design

It is the process of designing an ASIC chip that uses digital logic components, as opposed to analog.

digital asic design jpeg

Open Source Digital ASIC Design

open source asic digital design

RTL2GDS Flow

Screenshot 2024-03-31 110337

  1. Synthesis:

    • RTL Analysis: Conduct RTL analysis to ensure the correctness and completeness of the RTL design. Identify and address any issues related to combinational loops, clock domain crossings (CDC), and other potential synthesis issues.
    • Logic Synthesis: Translate the RTL design into a gate-level netlist using logic synthesis tools. Optimize the netlist for area, power, and timing based on specified constraints.
    • Technology Mapping: Map the synthesized logic gates to cells from the target technology library. This step involves selecting the appropriate cells and optimizing the mapping for timing and area.
  2. Floor Planning with Power Planning:

    • Floor Planning: Define the physical layout of the chip by allocating space for different functional blocks, such as logic cores, memory blocks, I/O pads, and power grid structures. Consider factors such as chip size, aspect ratio, and placement of critical components.
    • Macro floor planning: This includes defining of the dimensions, pin locations, row etc.
    • Power Planning: Design the power distribution network (PDN) to ensure stable and reliable power delivery to all parts of the chip. Place power pads and create power rails, power straps, and decoupling capacitors to minimize voltage drop and noise.
  3. Placement:Using a post-synthesis netlist and floor-planning/physical design limitations, arranging the standard cells on the chip to create a physical layout.

    • Global Placement: Perform global placement to assign initial positions to cells on the chip while considering factors such as timing, congestion, and wirelength.
    • Detailed Placement: Refine the placement by optimizing cell positions to minimize wirelength, reduce congestion, and meet timing constraints. Ensure proper placement of critical paths and avoid hotspots.
  4. Clock Tree Synthesis (CTS):

    • Clock Tree Synthesis: Design and optimize the clock distribution network to ensure consistent and reliable clock signals across the chip. Generate a balanced clock tree that minimizes clock skew and meets timing requirements for all clock domains.Involves providing clock signals to all the sequential elements in the design to obtain minimum skew usually in the form of a tree(H, X, pi tree, Fish Bone).
  5. Routing:

    • Global Routing: Create the initial routing topology by determining the paths for signal wires, clock lines, and power/ground connections. Resolve conflicts and congestion to achieve a feasible routing solution.
    • Detailed Routing: Perform detailed routing to physically implement the routing paths generated during global routing. Optimize wire lengths, minimize parasitic effects, and ensure signal integrity. Use techniques such as via insertion, wire spreading, and metal layer assignment. Includes making wires to connect the various cells to create a physical layout.
  6. Signoff:

    • Design Rule Checking (DRC): Run design rule checks to verify that the layout adheres to the manufacturing rules and constraints specified by the foundry.

    • Layout vs. Schematic (LVS) Verification: Perform layout vs. schematic checks to ensure the layout matches the intended circuit functionality.

    • Timing Analysis: Conduct static timing analysis (STA) to verify timing constraints, including setup time, hold time, and clock skew, and ensure that timing requirements are met across the chip.

    • Power Analysis: Analyze power consumption and distribution to ensure that power constraints are satisfied and that the PDN is robust.

    • Physical Verification: Perform full-chip physical verification to ensure the layout is free from manufacturing defects and meets reliability criteria.

      OpenLANE and strive chipset

      Screenshot 2024-03-31 111302 Screenshot 2024-03-31 111426

      OpenLANE ASIC Flow

      Screenshot 2024-03-31 111559

      OpenLANE Directory structure

      Basic Linux Commands cd: opens the particular folder ls: lists the content of the folder pwd: shows the present working directory mkdir: to make a new directory command --help: shows the complete use of that command clear: clears the terminal screen

      Exploring OpenLANE Directory

      Working on sky130A(pdk) which contains libs.tech which has respective files on tools such as magic, netgen etc., and libs.ref which has files related to the specific technology.

      Open the working Directory

      Screenshot 2024-03-31 200154

         cd Desktop
         cd work/tools
         cd openlane_working_dir
         cd openlane

      To open the Openlane

      After getting into the directory, enter the commands

    Screenshot 2024-03-31 200453

       docker
       pwd
       ls -ltr

    Interactive Mode

    To open the openlane in interactive mode,

    Screenshot 2024-03-31 201104

    You may run the interactively by using the -interactive option:

      ./flow.tcl -interactive

    To prepare the openlane,

    Screenshot 2024-03-31 215317

       package require openlane 0.9
       prep - design picorv32a

    Screenshot 2024-04-02 215510

    Screenshot 2024-04-02 220124

Synthesis

To run the Synthesis the cmd i.e, run_synthesis

Screenshot 2024-03-31 220804

Report generated after synthesis

Before running, we saw that the result folder was empty. But now, after running the synthesis, we can see that all the mapping has been done by ABC. And in the report, we can see when the actual synthesis has been done. and the actual statistics synthesis report is shown below, which is the same as what we have seen before.

Screenshot 2024-03-31 223408

Particularly we are interested in finding the Flop ratio. This can be calculated by using the formula:

   Flop Ratio = No. of D FlipfLops/Total No. of cells
  
               =1613/14876
  
               =0.10842
  
    Percentage of D FF's = 10.842%

Screenshot 2024-03-31 222449

Screenshot 2024-03-31 222608

Screenshot 2024-03-31 232041

Chip area for the module = 147712.9184

Synthesis Report directory

The Synthesis Report are found in the directory

Screenshot 2024-03-31 231746

 ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/01-04_19-21/reports/synthesis/1-yosys_4.stat.rpt

The synthesis Results are found in the directory

   ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/01-04_19-21/results/synthesis/picorv32a.synthesis.v

Day 2- Good floorplan vs bad floorplan and introduction to library cells

Theory

Implementation

  1. Run 'picorv32a' design floorplan using OpenLANE flow and generate necessary outputs.

  2. Calculate the die area in microns from the values in floorplan def.

  3. Load generated floorplan def in magic tool and explore the floorplan.

  4. Run 'picorv32a' design congestion aware placement using OpenLANE flow and generate necessary outputs.

  5. Load generated placement def in magic tool and explore the placement.

    Screenshot 2024-04-10 113003

  • All section 2 logs, reports and results can be found in following run folder:

The LAB gives the complete flow of the Floorplanning and the placement process After the Synthesis process, type the command for running the Floor planning

Screenshot 2024-04-02 214540

The configuration files are inside the location

  /Desktop/work/tools/openlane_working_dir/openlane/configurations/README.md

Before run the floorplanning, we required some switches for the floorplanning. these we can get from the configuration from openlane.

Screenshot 2024-04-02 215656

Here we can see that the core utilization ratio is 50% (bydefault) and aspect ratio is 1 (bydefault). similarly other information is also given. But it is not neccessory to take these values. we need to change these value as per the given requirments also.

Here FP_PDN files are set the power distribution network. These switches are set in the floorplane stage bydefault in OpenLANE.

Screenshot 2024-04-02 220209

Here, (FP_IO MODE) 1, 0 means pin positioning is random but it is on equal distance.

In the OpenLANE lower priority is given to system default (floorplanning.tcl), the next priority is given to config.tcl and then priority is given to PDK varient.tcl (sky130A_sky130_fd_sc_hd_congig.tcl).

In the run folder, we can see the connfig.tcl file. this file contains all the configuration that are taken by the flow. if we open the config.tcl file, then we can see that which are the parameters are accepted in the current flow.

Screenshot 2024-04-02 220647 In this particular location from the floorplan.def file, we can able to see the area of the chip

Screenshot 2024-04-02 010306

Screenshot 2024-04-02 214343

     1000 unit distance = 1 Micron

     Distance in micron = value
                        ----------
                           1000

    Die width in micron = 660685 
                         ---------
                           1000
                        
   Die height in micron =  671405 
                          ---------
                            1000

  Area of die in micron = 660.685*671.405 Square micron 

Locate to this directory

   ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/01-04_19-21/results/floorplan

To see the actual layout after the flow, we have to open the magic file by adding the command magic -T /home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic/sky130A.tech lef read ../../tmp/merged.lef def read picorv32a.floorplan.def &

  • Floorplan def in Magic

Screenshot 2024-04-02 221927

Screenshot 2024-04-02 222243

  • The side rows,the Decap cells are arranged at the border of the side rows.

Screenshot 2024-04-02 222333

  • Horizontal metal layer Screenshot 2024-04-02 222516

  • Vertical metal layer

Screenshot 2024-04-02 222949

  • Subcells
    Screenshot 2024-04-02 223201

Screenshot 2024-04-02 223245

  • Standard cells Screenshot 2024-04-02 223601

  • To watch how Placementplane looks, we have to go in the results. plac def

  • These switches are set in the Placementplane stage bydefault in OpenLANE. Screenshot 2024-04-02 220252

  • Before run the Placement, we required some switches for the Placement. these we can get from the configuration from openlane.
    p

To run the Placement, the command is run_placement

The Magic file to see actual view of standerd cells placement.And the actual view in the magic file is given below.

Commands to load placement def in magic magic -T /home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic/sky130A.tech lef read ../../tmp/merged.lef def read picorv32a.placement.def &

Screenshot 2024-04-02 224536

Screenshot 2024-04-02 224656

  • If we zooom into this, we can find the buffers, gates, flip flops in this. Screenshot 2024-04-02 225033

  • Via
    Screenshot 2024-04-02 225354

  • Vertical metal layer., metal 4
    Screenshot 2024-04-02 225442

  • Horizontal metal layer i.e., metal 5
    Screenshot 2024-04-02 225534

Day 3- Design library cell using Magic Layout and ngspice characterization

Theory

Implementation

1.Clone custom inverter standard cell design from github repository: Standard cell design and characterization using OpenLANE flow.

2.Load the custom inverter layout in magic and explore.

3.Spice extraction of inverter in magic.

4.Editing the spice model file for analysis through simulation.

5.Post-layout ngspice simulations.

6.Find problem in the DRC section of the old magic tech file for the skywater process and fix them.

  • Topmost cell in window picorv32a
    Screenshot 2024-04-02 225940

Every Design is represented by an equivalent cell design. All the standard cell designs are available in the Cell Library. A fully custom cell design that meets all rules can be added to the library. To begin with, a CMOS Inverter is designed in Magic Layout Tool and analysis is carried out using NGSPICE tool.

Go to this directory to git clone the files /Desktop/work/tools/openlane_working_dir/openlane

Git clone the files from GitHub to your local pc git clone https://github.com/nickson-jose/vsdstdcelldesign.git Screenshot 2024-04-03 001705 open another terminal and go to the location

/home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic

copy the sky130A.tech file from this location to the git cloned location. Screenshot 2024-04-03 002158

Now, we can see that this file is copied in the vsdstdcelldesign folder. Screenshot 2024-04-03 002314

Now initialize magic magic -T sky130A.tech sky130_inv.mag & Screenshot 2024-04-03 002627

-In sky130, every color is showing the different layer. here the first layer is for local interconnect shown by blue_purple color, then second layer is metal 1 which is shown by light purple color, and the metal 2 is shown by pink color. N-well is shown by solide das line. green is N-diffusion region. and red is for polysilicon gate. similarly the brown color is for P-diffusion.

  • Inverter layout Screenshot 2024-04-03 002733

Screenshot 2024-04-03 003136

  • nmos Screenshot 2024-04-03 003303

we will check for the output terminal also.(by double pressing "S" to select the entire thing at output Y).

so, we can see that "Y" is attached to locali in cell def sky130_inv.

we can check the source of the PMOS is connected to the ground or not. and similarly we can check it for NMOS also. Screenshot 2024-04-03 003759

  • Connection between source and VDD in Pmos Screenshot 2024-04-03 003854

  • Connection between source and Ground in Nmos Screenshot 2024-04-03 003938

Now open the tkcon window and type the commands for extracting the files. Bute before that see lets see its location

    `pwd`  

To extract the file from here, we have to write the command in tckon window and the comand is extract all Screenshot 2024-04-03 004306

we will use this .ext file to create the spice file to be use with our ngspice tool. for that we have apply the command ext2spice cthresh 0 rthresh 0, this will not create anything new.

now again we have to type ext2spice command in tckon window. Screenshot 2024-04-03 004650

so, now we are checking the location and at there spice file has been created. Screenshot 2024-04-03 004729

let's see what is inside the spice file by "vim sky130_inv.spice". Screenshot 2024-04-03 005032

Now we have to include the PMOS and NMOS lib files. it is inside the libs folder in the vsdstdcellsdesign folder. Screenshot 2024-04-08 161011

let's see inside PMOS lib file. Screenshot 2024-04-04 153800

Measuring unit distance in layout grid Screenshot 2024-04-05 185633

Screenshot 2024-04-08 153747

run the spice file in ngspice

ngspice sky130_inv.spice

To plot the graph between Voltage and time type the command in ngspice

plot y vs time a

after running this file we get output of ngspice like this, Screenshot 2024-04-06 002259

  • Transient response output V = 3.3v

    80% of V is 2.64v

    20% of V is 0.65v Screenshot 2024-04-06 002339 -80% value Screenshot 2024-04-06 003511 -80% value Screenshot 2024-04-06 154821 Fall transition time = Time taken for output to fall from 20% - Time taken for output to fall from 80%

                    = 4.09511 ns - 4.05263 ns
                    =  0.04248 ns
    

-20% value Screenshot 2024-04-06 154939 Rise transition time = Time taken for output to rise from 80% - Time taken for output to rise from 20%

                 = 2.4577 ns - 2.182 ns
                 =  0.06377 ns

-20% value Screenshot 2024-04-06 155011

Screenshot 2024-04-06 155121

Rise propagation delay = Time taken for output to rise to 50% - Time taken for input to fall to 50%

                   = 2.2113 ns - 2.15 ns
                   =  0.0613 ns

Fall propagation delay = Time taken for output to fall to 50% - Time taken for input to rise to 50%

                    = 4.07806 ns - 4.05056 ns
                    =  0.0275 ns 

Day 4- Pre-layout timing analysis and importance of good clock tree

Theory

Implementation

  1. Fix up small DRC errors and verify the design is ready to be inserted into our flow.
  2. Save the finalized layout with custom name and open it.
  3. Generate lef from the layout.
  4. Copy the newly generated lef and associated required lib files to 'picorv32a' design 'src' directory.
  5. Edit 'config.tcl' to change lib file and add the new extra lef into the openlane flow.
  6. Run openlane flow synthesis with newly inserted custom inverter cell.
  7. Remove/reduce the newly introduced violations with the introduction of custom inverter cell by modifying design parameters.
  8. Once synthesis has accepted our custom inverter we can now run floorplan and placement and verify the cell is accepted in PnR flow.
  9. Do Post-Synthesis timing analysis with OpenSTA tool.
  10. Make timing ECO fixes to remove all violations.
  11. Replace the old netlist with the new netlist generated after timing ECO fix and implement the floorplan, placement and cts.
  12. Post-CTS OpenROAD timing analysis.
  13. Explore post-CTS OpenROAD timing analysis by removing 'sky130_fd_sc_hd__clkbuf_1' cell from clock buffer list variable 'CTS_CLK_BUFFER_LIST'.

-Fix up small DRC errors and verify the design is ready to be inserted into our flow. Conditions to be verified before moving forward with custom designed cell layout:

Condition 1: The input and output ports of the standard cell should lie on the intersection of the vertical and horizontal tracks.

Condition 2: Width of the standard cell should be odd multiples of the horizontal track pitch.

Condition 3: Height of the standard cell should be even multiples of the vertical track pitch.

Commands to open the custom inverter layout

   # Change directory to vsdstdcelldesign
   cd Desktop/work/tools/openlane_working_dir/openlane/vsdstdcelldesign
   
   # Command to open custom inverter layout in magic
   magic -T sky130A.tech sky130_inv.mag &

Screenshot of tracks.info of sky130_fd_sc_hd Screenshot 2024-04-06 004138

Commands for tkcon window to set grid as tracks of locali layer

   # Get syntax for grid command
   help grid
   
   # Set grid values accordingly
   grid 0.46um 0.34um 0.23um 0.17um

Screenshot of commands run Screenshot 2024-04-06 004913

Save the finalized layout with custom name and open it.

Command for tkcon window to save the layout with custom name

   # Command to save as
   save sky130_vsdinv.mag
   Command to open the newly saved layout
   
   # Command to open custom inverter layout in magic
   magic -T sky130A.tech sky130_vsdinv.mag &

Screenshot of newly saved layout Screenshot 2024-04-06 005559

Screenshot 2024-04-06 005056 Generate lef from the layout.

Command for tkcon window to write lef

   # lef command
   lef write

Screenshot of command run Screenshot 2024-04-06 010332

Screenshot of newly created lef file Screenshot 2024-04-06 010449

Copy the newly generated lef and associated required lib files to 'picorv32a' design 'src' directory. Commands to copy necessary files to 'picorv32a' design 'src' directory

   # Copy lef file
   cp sky130_vsdinv.lef ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/src/
   
   # List and check whether it's copied
   ls ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/src/
   
   # Copy lib files
   cp libs/sky130_fd_sc_hd__* ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/src/
   
   # List and check whether it's copied
   ls ~/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/src/

Screenshot of commands run Screenshot 2024-04-06 011114

Screenshot 2024-04-06 011431

Screenshot 2024-04-06 011553

Screenshot 2024-04-06 012239

Screenshot 2024-04-06 012348

Screenshot 2024-03-31 215317

Screenshot 2024-04-10 103128 Run openlane flow synthesis with newly inserted custom inverter cell. Commands to invoke the OpenLANE flow include new lef and perform synthesis

   # Change directory to openlane flow directory
   cd Desktop/work/tools/openlane_working_dir/openlane
   
   # alias docker='docker run -it -v $(pwd):/openLANE_flow -v $PDK_ROOT:$PDK_ROOT -e PDK_ROOT=$PDK_ROOT -u $(id -u $USER):$(id -g $USER) efabless/openlane:v0.21'
   # Since we have aliased the long command to 'docker' we can invoke the OpenLANE flow docker sub-system by just running this command
   docker
   # Now that we have entered the OpenLANE flow contained docker sub-system we can invoke the OpenLANE flow in the Interactive mode using the following command
   ./flow.tcl -interactive
   
   # Now that OpenLANE flow is open we have to input the required packages for proper functionality of the OpenLANE flow
   package require openlane 0.9
   
   # Now the OpenLANE flow is ready to run any design and initially we have to prep the design creating some necessary files and directories for running a specific design which in our case is 'picorv32a'
   prep -design picorv32a
   
   # Adiitional commands to include newly added lef to openlane flow
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis

Screenshots of commands run Screenshot 2024-04-06 014555

Screenshot 2024-04-06 142503

Screenshot 2024-04-06 143302

Screenshot 2024-04-06 145505

Screenshot 2024-04-06 145607 -Remove/reduce the newly introduced violations with the introduction of custom inverter cell by modifying design parameters.

Noting down current design values generated before modifying parameters to improve timing Screenshot 2024-04-06 145825

Screenshot 2024-04-06 150235 Commands to view and change parameters to improve timing and run synthesis

   # Now once again we have to prep design so as to update variables
   prep -design picorv32a -tag 24-03_10-03 -overwrite
   
   # Addiitional commands to include newly added lef to openlane flow merged.lef
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Command to display current value of variable SYNTH_STRATEGY
   echo $::env(SYNTH_STRATEGY)
   
   # Command to set new value for SYNTH_STRATEGY
   set ::env(SYNTH_STRATEGY) "DELAY 3"
   
   # Command to display current value of variable SYNTH_BUFFERING to check whether it's enabled
   echo $::env(SYNTH_BUFFERING)
   
   # Command to display current value of variable SYNTH_SIZING
   echo $::env(SYNTH_SIZING)
   
   # Command to set new value for SYNTH_SIZING
   set ::env(SYNTH_SIZING) 1
   
   # Command to display current value of variable SYNTH_DRIVING_CELL to check whether it's the proper cell or not
   echo $::env(SYNTH_DRIVING_CELL)
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis

Screenshot of merged.lef in tmp directory with our custom inverter as macro Screenshot 2024-04-06 010646 -Once synthesis has accepted our custom inverter we can now run floorplan and placement and verify the cell is accepted in PnR flow.

Now that our custom inverter is properly accepted in synthesis we can now run floorplan using following command

   # Now we can run floorplan
   run_floorplan

Screenshots of command run Screenshot 2024-04-06 150401

Since we are facing unexpected un-explainable error while using run_floorplan command, we can instead use the following set of commands available based on information from Desktop/work/tools/openlane_working_dir/openlane/scripts/tcl_commands/floorplan.tcl and also based on Floorplan Commands section in Desktop/work/tools/openlane_working_dir/openlane/docs/source/OpenLANE_commands.md

# Follwing commands are alltogather sourced in "run_floorplan" command
init_floorplan
place_io
tap_decap_or

Screenshots of commands run Screenshot 2024-04-06 150453

Screenshot 2024-04-06 150531

Screenshot 2024-04-06 150629 Now that floorplan is done we can do placement using following command

   # Now we are ready to run placement
   run_placement

Screenshots of command run Screenshot 2024-04-06 150814 Commands to load placement def in magic in another terminal

   # Change directory to path containing generated placement def
   cd Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/24-03_10-03/results/placement/
   
   # Command to load the placement def in magic tool
   magic -T /home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic/sky130A.tech lef read ../../tmp/merged.lef def read    
   picorv32a.placement.def &

Screenshot of placement def in magic Screenshot 2024-04-06 151452

Screenshot 2024-04-06 151535

Screenshot of custom inverter inserted in placement def with proper abutment Screenshot 2024-04-06 151636

Command for tkcon window to view internal layers of cells

   # Command to view internal connectivity layers
   expand

The abutment of power pins with other cell from library clearly visible Screenshot 2024-04-06 151806

Screenshot 2024-04-06 151949

Before run the further stage, lets see cts we can get from the configuration from openlane and also cts.tcl file. cts

c tcl

  • Do Post-Synthesis timing analysis with OpenSTA tool.

Since we are having 0 wns after improved timing run we are going to do timing analysis on initial run of synthesis which has lots of violations and no parameters were added to improve timing

Commands to invoke the OpenLANE flow include new lef and perform synthesis

   # Change directory to openlane flow directory
   cd Desktop/work/tools/openlane_working_dir/openlane
   
   # alias docker='docker run -it -v $(pwd):/openLANE_flow -v $PDK_ROOT:$PDK_ROOT -e PDK_ROOT=$PDK_ROOT -u $(id -u $USER):$(id -g $USER) efabless/openlane:v0.21'
   # Since we have aliased the long command to 'docker' we can invoke the OpenLANE flow docker sub-system by just running this command
   docker
   # Now that we have entered the OpenLANE flow contained docker sub-system we can invoke the OpenLANE flow in the Interactive mode using the following command
   ./flow.tcl -interactive
   
   # Now that OpenLANE flow is open we have to input the required packages for proper functionality of the OpenLANE flow
   package require openlane 0.9
   
   # Now the OpenLANE flow is ready to run any design and initially we have to prep the design creating some necessary files and directories for running a specific design which in our case is 'picorv32a'
   prep -design picorv32a
   
   # Adiitional commands to include newly added lef to openlane flow
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Command to set new value for SYNTH_SIZING
   set ::env(SYNTH_SIZING) 1
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis

Commands run final screenshot Newly created pre_sta.conf for STA analysis in openlane directory Screenshot 2024-04-07 114617

Newly created my_base.sdc for STA analysis in openlane/designs/picorv32a/src directory based on the file openlane/scripts/base.sdc Screenshot 2024-04-07 114529 Commands to run STA in another terminal

   # Change directory to openlane
   cd Desktop/work/tools/openlane_working_dir/openlane
   
   # Command to invoke OpenSTA tool with script
   sta pre_sta.conf

Screenshots of commands run Screenshot 2024-04-07 114707

Screenshot 2024-04-07 114935

Screenshot 2024-04-07 114819

Screenshot 2024-04-07 115016

Screenshot 2024-04-07 115113

Screenshot 2024-04-07 115147

Screenshot 2024-04-07 115242

Screenshot 2024-04-07 122156

Screenshot 2024-04-07 122306

Screenshot 2024-04-07 122657

Screenshot 2024-04-07 122840

Since more fanout is causing more delay we can add parameter to reduce fanout and do synthesis again

Commands to include new lef and perform synthesis

   # Now the OpenLANE flow is ready to run any design and initially we have to prep the design creating some necessary files and directories for running a specific design which in our case is 'picorv32a'
   prep -design picorv32a -tag 01-04_19-21 -overwrite
   
   # Adiitional commands to include newly added lef to openlane flow
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Command to set new value for SYNTH_SIZING
   set ::env(SYNTH_SIZING) 1
   
   # Command to set new value for SYNTH_MAX_FANOUT
   set ::env(SYNTH_MAX_FANOUT) 4
   
   # Command to display current value of variable SYNTH_DRIVING_CELL to check whether it's the proper cell or not
   echo $::env(SYNTH_DRIVING_CELL)
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis

Commands run final screenshot Screenshot 2024-04-07 123012

Screenshot 2024-04-07 123210

Commands to run STA in another terminal

   # Change directory to openlane
   cd Desktop/work/tools/openlane_working_dir/openlane
   
   # Command to invoke OpenSTA tool with script
   sta pre_sta.conf

Screenshots of commands run Screenshot 2024-04-07 124001

Screenshot 2024-04-07 124137

Screenshot 2024-04-07 124220

  • Make timing ECO fixes to remove all violations.

OR gate of drive strength 2 is driving 4 fanouts Screenshot 2024-04-07 125131

Commands to perform analysis and optimize timing by replacing with OR gate of drive strength 2, but turns out to reduce of slack is less due to less driving strength

   # Reports all the connections to a net
   report_net -connections _11675_
   
   # Replacing cell
   replace_cell _14514_ sky130_fd_sc_hd__or3_2
   
   # Generating custom timing report
   report_checks -fields {net cap slew input_pins} -digits 4

Result - slack reduced Screenshot 2024-04-07 125225

Screenshot 2024-04-07 125605

OR gate of drive strength 2 is driving 4 fanouts Screenshot 2024-04-07 125704

Commands to perform analysis and optimize timing by replacing with OR gate of drive strength 4

   # Reports all the connections to a net
   report_net -connections _11672_
   
   # Checking command syntax
   help replace_cell
   
   # Replacing cell
   replace_cell _14510_ sky130_fd_sc_hd__or3_4
   
   # Generating custom timing report
   report_checks -fields {net cap slew input_pins} -digits 4

Result - slack reduced Screenshot 2024-04-07 125726

OR gate of drive strength 2 driving OA gate has more delay Screenshot 2024-04-07 125858

Commands to perform analysis and optimize timing by replacing with OR gate of drive strength 4

   # Reports all the connections to a net
   report_net -connections _11643_
   
   # Replacing cell
   replace_cell _14481_ sky130_fd_sc_hd__or4_4
   
   # Generating custom timing report
   report_checks -fields {net cap slew input_pins} -digits 4

Result - slack reduced Screenshot 2024-04-07 130359

Screenshot 2024-04-07 130456

OR gate of drive strength 2 driving OA gate has more delay Screenshot 2024-04-07 130602

Commands to perform analysis and optimize timing by replacing with OR gate of drive strength 4

   # Reports all the connections to a net
   report_net -connections _11668_
   
   # Replacing cell
   replace_cell _14506_ sky130_fd_sc_hd__or4_4
   
   # Generating custom timing report
   report_checks -fields {net cap slew input_pins} -digits 4

Result - slack reduced Screenshot 2024-04-07 131107

Screenshot 2024-04-07 131150

Commands to verify instance _14506_ is replaced with sky130_fd_sc_hd__or4_4

   # Generating custom timing report
   report_checks -from _29043_ -to _30440_ -through _14506_

Screenshot of replaced instance Screenshot 2024-04-07 225814 We started ECO fixes at wns -23.9000 and now we stand at wns -22.6173 we reduced around 1.2827 ns of violation

  • Replace the old netlist with the new netlist generated after timing ECO fix and implement the floorplan, placement, and cts.

Now to insert this updated netlist to the PnR flow, we can use write_verilog and overwrite the synthesis netlist but before that, we are going to make a copy of the old netlist

Commands to make a copy of netlist

   # Change from home directory to synthesis results directory
   cd Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/25-03_18-52/results/synthesis/
   
   # List contents of the directory
   ls
   
   # Copy and rename the netlist
   cp picorv32a.synthesis.v picorv32a.synthesis_old.v
   
   # List contents of the directory
   ls

Screenshot of commands run Screenshot 2024-04-07 230459

Commands to write verilog

   # Check syntax
   help write_verilog
   
   # Overwriting current synthesis netlist
   write_verilog /home/vsduser/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/25-03_18-52/results/synthesis/picorv32a.synthesis.v
   
   # Exit from OpenSTA since timing analysis is done
   exit

Screenshot of commands run Screenshot 2024-04-07 231259

Screenshot 2024-04-07 231409

Verified that the netlist is overwritten by checking that instance 14506 is replaced with sky130_fd_sc_hd__or4_4 Screenshot 2024-04-07 232758

Since we confirmed that netlist is replaced and will be loaded in PnR but since we want to follow up on the earlier 0 violation design we are continuing with the clean design to further stages

Commands load the design and run necessary stages

   # Now once again we have to prep design so as to update variables
   prep -design picorv32a -tag 24-03_10-03 -overwrite
   
   # Addiitional commands to include newly added lef to openlane flow merged.lef
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Command to set new value for SYNTH_STRATEGY
   set ::env(SYNTH_STRATEGY) "DELAY 3"
   
   # Command to set new value for SYNTH_SIZING
   set ::env(SYNTH_SIZING) 1
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis
   
   # Follwing commands are alltogather sourced in "run_floorplan" command
   init_floorplan
   place_io
   tap_decap_or
   
   # Now we are ready to run placement
   run_placement
   
   # Incase getting error
   unset ::env(LIB_CTS)
   
   # With placement done we are now ready to run CTS
   run_cts

Screenshots of commands run Screenshot 2024-04-07 233207

Screenshot 2024-04-07 233404

Screenshot 2024-04-07 233615

Screenshot 2024-04-07 233705

Screenshot 2024-04-07 233934

Screenshot 2024-04-07 234009

Screenshot 2024-04-07 234601

Screenshot 2024-04-07 234519

Screenshot 2024-04-07 235728

Screenshot 2024-04-08 163333

Screenshot 2024-04-08 163428

Screenshot 2024-04-08 163453

  • Explore post-CTS OpenROAD timing analysis by removing ' sky130_fd_sc_hd__clkbuf_1 ' cell from clock buffer list variable 'CTS_CLK_BUFFER_LIST'.

Commands to be run in OpenLANE flow to do OpenROAD timing analysis after changing CTS_CLK_BUFFER_LIST

   # Checking current value of 'CTS_CLK_BUFFER_LIST'
   echo $::env(CTS_CLK_BUFFER_LIST)
   
   # Removing 'sky130_fd_sc_hd__clkbuf_1' from the list
   set ::env(CTS_CLK_BUFFER_LIST) [lreplace $::env(CTS_CLK_BUFFER_LIST) 0 0]
   
   # Checking current value of 'CTS_CLK_BUFFER_LIST'
   echo $::env(CTS_CLK_BUFFER_LIST)
   
   # Checking current value of 'CURRENT_DEF'
   echo $::env(CURRENT_DEF)
   
   # Setting def as placement def
   set ::env(CURRENT_DEF) /openLANE_flow/designs/picorv32a/runs/24-03_10-03/results/placement/picorv32a.placement.def
   
   # Run CTS again
   run_cts
   
   # Checking current value of 'CTS_CLK_BUFFER_LIST'
   echo $::env(CTS_CLK_BUFFER_LIST)
   
   # Command to run OpenROAD tool
   openroad
   
   # Reading lef file
   read_lef /openLANE_flow/designs/picorv32a/runs/24-03_10-03/tmp/merged.lef
   
   # Reading def file
   read_def /openLANE_flow/designs/picorv32a/runs/24-03_10-03/results/cts/picorv32a.cts.def
   
   # Creating an OpenROAD database to work with
   write_db pico_cts1.db
   
   # Loading the created database in OpenROAD
   read_db pico_cts.db
   
   # Read netlist post CTS
   read_verilog /openLANE_flow/designs/picorv32a/runs/24-03_10-03/results/synthesis/picorv32a.synthesis_cts.v
   
   # Read library for design
   read_liberty $::env(LIB_SYNTH_COMPLETE)
   
   # Link design and library
   link_design picorv32a
   
   # Read in the custom sdc we created
   read_sdc /openLANE_flow/designs/picorv32a/src/my_base.sdc
   
   # Setting all cloks as propagated clocks
   set_propagated_clock [all_clocks]
   
   # Generating custom timing report
   report_checks -path_delay min_max -fields {slew trans net cap input_pins} -format full_clock_expanded -digits 4
   
   # Report hold skew
   report_clock_skew -hold
   
   # Report setup skew
   report_clock_skew -setup
   
   # Exit to OpenLANE flow
   exit
   
   # Checking current value of 'CTS_CLK_BUFFER_LIST'
   echo $::env(CTS_CLK_BUFFER_LIST)
   
   # Inserting 'sky130_fd_sc_hd__clkbuf_1' to first index of list
   set ::env(CTS_CLK_BUFFER_LIST) [linsert $::env(CTS_CLK_BUFFER_LIST) 0 sky130_fd_sc_hd__clkbuf_1]
   
   # Checking current value of 'CTS_CLK_BUFFER_LIST'
   echo $::env(CTS_CLK_BUFFER_LIST)

Screenshots of commands run and timing report generated Screenshot 2024-04-08 164124

Screenshot 2024-04-08 164251

Screenshot 2024-04-08 165534

Screenshot 2024-04-08 165618

Screenshot 2024-04-08 165655

Screenshot 2024-04-08 165725

  • Post-CTS OpenROAD timing analysis. Commands to be run in OpenLANE flow to do OpenROAD timing analysis with integrated OpenSTA in OpenROAD
  # Command to run OpenROAD tool
  openroad
  
  # Reading lef file
  read_lef /openLANE_flow/designs/picorv32a/runs/24-03_10-03/tmp/merged.lef
  
  # Reading def file
  read_def /openLANE_flow/designs/picorv32a/runs/24-03_10-03/results/cts/picorv32a.cts.def
  
  # Creating an OpenROAD database to work with
  write_db pico_cts.db
  
  # Loading the created database in OpenROAD
  read_db pico_cts.db
  
  # Read netlist post CTS
  read_verilog /openLANE_flow/designs/picorv32a/runs/24-03_10-03/results/synthesis/picorv32a.synthesis_cts.v
  
  # Read library for design
  read_liberty $::env(LIB_SYNTH_COMPLETE)
  
  # Link design and library
  link_design picorv32a
  
  # Read in the custom sdc we created
  read_sdc /openLANE_flow/designs/picorv32a/src/my_base.sdc
  
  # Setting all cloks as propagated clocks
  set_propagated_clock [all_clocks]
  
  # Check syntax of 'report_checks' command
  help report_checks
  
  # Generating custom timing report
  report_checks -path_delay min_max -fields {slew trans net cap input_pins} -format full_clock_expanded -digits 4
  
  # Exit to OpenLANE flow
  exit

Screenshots of commands run and timing report generated Screenshot 2024-04-08 165759

Screenshot 2024-04-08 165827

Screenshot 2024-04-08 165909

Screenshot 2024-04-08 170225

Day 5- Final steps for RTL2GDS using tritonRoute and openSTA

Theory

Implementation

  1. Perform generation of Power Distribution Network (PDN) and explore the PDN layout.
  2. Perfrom detailed routing using TritonRoute.
  3. Post-Route parasitic extraction using SPEF extractor.
  4. Post-Route OpenSTA timing analysis with the extracted parasitics of the route.
  5. Perform generation of Power Distribution Network (PDN) and explore the PDN layout.

Commands to perform all necessary stages up until now

   # Change directory to openlane flow directory
   cd Desktop/work/tools/openlane_working_dir/openlane
   
   # alias docker='docker run -it -v $(pwd):/openLANE_flow -v $PDK_ROOT:$PDK_ROOT -e PDK_ROOT=$PDK_ROOT -u $(id -u $USER):$(id -g $USER) efabless/openlane:v0.21'
   # Since we have aliased the long command to 'docker' we can invoke the OpenLANE flow docker sub-system by just running this command
   docker
   # Now that we have entered the OpenLANE flow contained docker sub-system we can invoke the OpenLANE flow in the Interactive mode using the following command
   ./flow.tcl -interactive
   
   # Now that OpenLANE flow is open we have to input the required packages for the proper functionality of the OpenLANE flow
   package require openlane 0.9
   
   # Now the OpenLANE flow is ready to run any design and initially we have to prep the design creating some necessary files and directories for running a specific design which in our case is 'picorv32a'
   prep -design picorv32a
   
   # Addiitional commands to include newly added lef to openlane flow merged.lef
   set lefs [glob $::env(DESIGN_DIR)/src/*.lef]
   add_lefs -src $lefs
   
   # Command to set new value for SYNTH_STRATEGY
   set ::env(SYNTH_STRATEGY) "DELAY 3"
   
   # Command to set new value for SYNTH_SIZING
   set ::env(SYNTH_SIZING) 1
   
   # Now that the design is prepped and ready, we can run synthesis using following command
   run_synthesis
   
   # Following commands are alltogather sourced in "run_floorplan" command
   init_floorplan
   place_io
   tap_decap_or
   
   # Now we are ready to run placement
   run_placement
   
   # Incase getting error
   unset ::env(LIB_CTS)
   
   # With placement done we are now ready to run CTS
   run_cts
   
   # Now that CTS is done we can do power distribution network
   gen_pdn

Screenshots of power distribution network run Screenshot 2024-04-08 171326

Screenshot 2024-04-08 171409

Screenshot 2024-04-08 171511

Screenshot 2024-04-08 171732

Screenshot 2024-04-08 172050

Screenshot 2024-04-08 172455

Commands to load PDN def in magic in another terminal

   # Change directory to path containing generated PDN def
   cd Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/26-03_08-45/tmp/floorplan/
   
   # Command to load the PDN def in magic tool
   magic -T /home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic/sky130A.tech lef read ../../tmp/merged.lef def read 14-pdn.def &

Screenshots of PDN def Screenshot 2024-04-08 214953

Screenshot 2024-04-08 215115

Screenshot 2024-04-08 215248

  • Basics of global and detail routing and configure TritonRoute The final step of physical design is Routing. The usage of the def command in the image above is to indicate that the latest completed step was the generation of PDN.

The resulting file 17-pdn.def contains the information from cts.def as well as the power distribution network.

If one wants to learn about the various switches available for routing, they can refer to the README.md file located in the configuration folder of the OpenLANE directory. r

r tcl

  • By executing specific commands, we can determine the type of global and detailed routing that will be performed. In case we want to change the routing type, we can use the set command followed by the parameter names mentioned in the routing section of the README.md file.

  • Perform detailed routing using TritonRoute and explore the routed layout. Command to perform routing

    ```bash
       # Check value of 'CURRENT_DEF'
       echo $::env(CURRENT_DEF)
       
       # Check value of 'ROUTING_STRATEGY'
       echo $::env(ROUTING_STRATEGY)
       
       # Command for detailed route using TritonRoute
       run_routing
    ```  
    

Screenshots of routing run Screenshot 2024-04-08 221336

Screenshot 2024-04-08 221446

Screenshot 2024-04-08 221735 Commands to load routed def in magic in another terminal

   # Change directory to path containing routed def
   cd Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/26-03_08-45/results/routing/
   
   # Command to load the routed def in magic tool
   magic -T /home/vsduser/Desktop/work/tools/openlane_working_dir/pdks/sky130A/libs.tech/magic/sky130A.tech lef read ../../tmp/merged.lef def read picorv32a.def &

Screenshot 2024-04-08 222713

Screenshot 2024-04-08 222836

Screenshot 2024-04-08 222325

Screenshot 2024-04-08 222509

Screenshots of routed def Screenshot 2024-04-08 222615

Screenshot of fast route guide present in openlane/designs/picorv32a/runs/01-04_19-21/tmp/routing directory Screenshot 2024-04-08 223242

  • Post-Route parasitic extraction using SPEF extractor. Screenshot 2024-04-09 101927 Commands for SPEF extraction using external tool
   # Change directory
   cd Desktop/work/tools/SPEF_EXTRACTOR
   
   # Command extract spef
   python3 main.py /home/vsduser/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/26-03_08-45/tmp/merged.lef 
  /home/vsduser/Desktop/work/tools/openlane_working_dir/openlane/designs/picorv32a/runs/26-03_08-45/results/routing/picorv32a.def

Screenshot 2024-04-09 101854

References

Acknowledgement

About

2 Week digital VLSI SoC design and planning workshop with complete RTL2GDSII flow organized by VSD in collaboration with NASSCOM (Advanced Physical Design using OpenLANE /Sky130)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published