Core_EDA

# Chip Package Co-Simulation

## Overall Flow

```

1. Import Chip Design Data

    1.Def-in flow

    2.DB-in flow

2. Import Package Data

    1.Import Package SPICE netlist

    2.Import chip-package port mapping file

3. Run chip-package co-simulation

    1.DC simulation: static IR analysis

    2.Transient simulation: dynamic IR analysis

```

## Tcl Commands

### 1. import_package_model

```

import—package—model  [-spice—netlist  <package—netlist—file>]  [-port—name—map  <chip—to—package—port

—name—map—csv>] [-reset]

```

Import package model components including a package SPICE netlist file and a chip-to-package port name map CSV file.

#### Examples

1. Import package SPICE netlist file pkg.sp.

```

import—package—model -spice—netlist pkg.sp

```

2. Import chip-to-package port name map CSV file.

```

import—package—model -port—name—map chip-to-package-port-name-map.csv

```

chip-to-package-port-name-map.csv, saying, PLOC file, is a column-based CSV text file. We support a two-column PLOC file:  

* the 1st column contains chip port names (i.e. source node);

* the 2nd column contains package port names. 

  chip-to-package-port-name-map.csv example:

```

VDD8—15388—2591210,Vo·T—0 

VDD8—15388—923,Vo·T—1 

VDD8—l290l—2591210,Vo·T—2 

VDD8—l290l—923,Vo·T—3

......

```

3. Remove all old results created by last import_package_model and then import package SPICE netlist file pkg.sp and chip-to-package port map file chip-to-package-port-name-map.csv

Note: -reset clean up all old results before importing anything.

```

import—package—model -spice—netlist pkg.sp -port—name—map chip-to-package-port-name-map.csv -r eset

```

### 2. report_package

report—package

Report package netlist statistics, such as the number of resistors(R), capacitors(C), inductors(L), mutual inductors(K), voltage sources (V), etc..

Print the records to console. For example,

```

% report—package      髻C = 6

髻K = 190653

髻l . = 618

髻R = 292

髻V = 2

```

report_package also does package static diagnostic before running the chip-package co-simulation. It checks following items:

1.Connection between package and chip. For example, short/open bump or pad.

2.Package internal short check.

For example, regression case ut_run/ir/package_flow/qa_static_ir_with_package generate following package diagnostic report:

![](clipboard-202503292156-b2xu4.png)

![](clipboard-202503292156-qa0bl.png)

### 3.set_package_port_current* 

**Caution:** set_package_port_current is a hidden Tcl command as part of the built-in static IR drop Tcl iteration procedure: work/src/emirTcl/pkgIteration.tcl

![](clipboard-202503292156-jfdnr.png)

```

set—package—port—current -type [staticldynamic] -file <supply—location—current—file> -reset

```

Load the output dumped by continue_analyze_power_network -report_supply_location_current.

* -reset removes last package port current data before setting new package port current data.  

* type static is default for static IR drop with package.

* -type dynamic is used for dynamic IR drop with package. (Deprecated since 2022/7/25) 

* <supply_location_current_file> is created by VP Tcl commands as follows:

>  Static IR drop

continue—analy江e—power—network  -report—supply—location—current  >  supply—location—current—f ile.static.txt

> Dynamic IR drop (Deprecated since 2022/7/25)

continue—analy江e—power—network -report—supply—location—current -simtime 0.5 > supply—locat ion—current—file.dynamic.txt

### 4. run_package_simulation*

**Caution:** run_package_simulation is a hidden Tcl command as part of the built-in static IR drop Tcl iteration procedure: work/src/emirTcl/pkgIteration.tcl

You should NOT use it directly in customer cases. See also set_package_port_current.

```

run—package—simulation -type [staticldynamic] -file <supply—location—current—file> -reset

```

Run package SPICE simulation.

* -reset removes last package port current data before setting new package port current data.

* -type static is default for static package SPICE simulation.

* -type dynamic is used for dynamic package SPICE simulation. (Deprecated since 2022/07/25)

### 5. report_package_voltage*

**Caution:** report_package_voltage is a hidden Tcl command as part of the built-in static IR drop Tcl iteration procedure: work/src/emirTcl/pkgIteration.tcl

You should NOT use it directly in customer cases. See also set_package_port_current.

```

report—package—voltage

```

Report package port voltages to console for both static and dynamic IR drop analysis. Report contents are a group of Tcl command set_supply_location_voltage .

Redirect the output to a Tcl file and source the Tcl file for next IR drop analysis iteration.

**Examples**

```

% report—package—voltage > "pkg—port—voltage.tcl" 

% source "pkg—port—voltage.tcl"            

髻 next IR drop iteration

```

pkg_port_voltage.tcl looks like

```

set—supply—location—voltage -port—name VDD8—15388—2591210 -voltage—value 1.08 

set—supply—location—voltage -port—name VDD8—15388—923 -voltage—value 1.08 

set—supply—location—voltage -port—name VDD8—l290l—2591210 -voltage—value 1.08 

set—supply—location—voltage -port—name VDD8—l290l—923 -voltage—value 1.08

......

```

Chip updates supply node voltage with values given by -voltage_value and continue to analyze the power network.

### 6.Report Generation

For either VDD or VSS analysis, following report commands dumps the IR drop/bounce reports for dynamic IR with package analysis.

```

report—misc -dynamic—ir vdd—inst—dvd.rpt  髻 Generate instance-based IR report

report—misc -ploc—current vdd—ploc—current.rpt  髻 Generate current waveforms for every supply loca tion

report—misc -ploc—voltage vdd—ploc—voltage.rpt  髻 Generate voltage waveforms for every supply loca tion

report—supply—location—current -output—file vdd—supply—current.inc -format spice 髻 Generate curre nt  waveform  in  SPICF  PWl  .  current  source  format  for  every  supply  location report—supply—location—current -output—file vdd—supply—sumup.rpt -sum—up 髻 Generate the total cur rent waveform of VDD or VSS

```

**Typical Supply Node Voltage/Current Waveform Example - Dynamic IR with Package**

The waveform files are generated by report_supply_location_current and report_misc .

1.Supply node voltage waveform

![](clipboard-202503292201-8zgl9.png)

2.Supply node current waveform

![](clipboard-202503292201-cgn2k.png)

## Static IR Drop with Package

After importing chip and package design data, static IR drop with package analysis only need an extra -with_package option.

* VDD static anlaysis: analyze_power_network -net VDD -with_package  

* VSS static analysis: analyze_power_network -net VDD -with_package

Regression case: ut_run/ir/package_flow/qa_static_ir_with_package

## Dynamic IR Drop with Package

Since 2022/07/25, -with_package is deprecated for dynamic IR drop with package.

For package flow, only need to add following Tcl command to no package dynamic IR drop flow:

```

import—package—model -spice—netslit <package—top—spice—netlist—file—name> \

	-port—name—map <two—column—csv—Pl.oC—file—name> \

	-integ—method be -skip—calc—ix -skip—calc—source—i -package—dim 10000

```

Regression case: ut_run/ir/package_flow/qa_dynamic_ir_vector_base_with_L0_newflow

## TODO (202208-01)

1. Multi-solver solution: GSS solver for chip matrix and spsolver for package matrix.

2. Combined PG package flow