Viewing IP hierarchy

This training page shows how to view the IP Hierarchy on both IPLM CLI and IPLM Web.

Viewing IP hierarchy using CLI

From IPLM CLI the "pi ip tree" command is a helpful way to display the hierarchy of an IPV and visualize all the dependencies that an IPV has. The IP hierarchy is built by including other IPVs in an IP's resources field.

pi ip tree Command

> pi ip tree tutorial.analog_top
tutorial.analog_top@1.TRUNK
├─ tutorial.MS90G@1.TRUNK
├─ tutorial.acells_tsmc18@1.TRUNK
├─ tutorial.clkgen@HEAD.TRUNK [@1]
├─ tutorial.intf_ana@HEAD.TRUNK [@1]
│  ├─ tutorial.acells_tsmc18@1.TRUNK
│  ├─ tutorial.adc@HEAD.TRUNK [@1]
│  │  ├─ tutorial.acells_tsmc18@1.TRUNK
│  │  └─ tutorial.laysc_tsmc18@1.TRUNK
│  └─ tutorial.laysc_tsmc18@1.TRUNK
├─ tutorial.laysc_tsmc18@1.TRUNK
├─ tutorial.pwr_mgmt_ana@HEAD.TRUNK [@1]
├─ tutorial.stup_ana@HEAD.TRUNK [@1]
│  ├─ tutorial.acells_tsmc18@1.TRUNK
│  └─ tutorial.laysc_tsmc18@1.TRUNK
└─ tutorial.trc@HEAD.TRUNK [@1]

As we can see all the resource versions are captured in the tree, when one of these versions changes the tree will be updated to reflect that. Note that for IP resources that have been included at an aliased version (@HEAD above for instance) the tree will show the fixed IPV version that alias resolves to '[@1]' at the time the tree was reported.

If the tree contains conflicts or locked aliases the tree output will be annotated with that information. See the IP Hierarchy page in the User Guide for more information.

Finding new resource versions

As new versions of Resource IPs are created, the 'pi ip tree --list-new' option can be used to highlight which new resource versions are available.

> pi ip tree --list-new tutorial.padring
tutorial.padring@5.TRUNK 
├─ tutorial.io5v@1.TRUNK → @3 [LATEST]
└─ tutorial.io_tsmc18@1.TRUNK → @3 [LATEST]

The line:

└─ tutorial.io_tsmc18@1.TRUNK → @3 [LATEST]

Indicates that:

The io_tsmc18 IP is currently included at release @1 in the tutorial.padring@5.TRUNK tree
There is an @3 release of io_tsmc18 that could be included in the tree instead

Viewing IP hierarchy in IPLM Web

IPLM Web displays the IP tree as follows on the IPV page, Resources tab:

See the IP Versions (Releases) page for more information.