oascript & oadebug Kevin Nesmith Lead Engineer, Si2 June 7, 2013

Transcription

1 oascript & oadebug Kevin Nesmith Lead Engineer, Si2 June 7,

2 oascript News Chip Designer Centric Python API Tcl API Ruby API Perl API Language-Specific Bindings Type Mapping Type Mapping Type Mapping Type Mapping Common Wrapper Architecture Interface Common EDA Programmer SWIG Framework Centric OpenAccess API C++ Programming Interface Version 2.0 available under the new ESG approved license Allows for custom C++ extensions. 64 bit binaries for each language. Windows version in development under the Silicon Photonics TAB 10 OA labs ported from C++ to support all 4 scripting languages Provides training to design engineers who operate at the scripting interface 2

3 oascript Support oascript is currently supported on OpenAccess Streams oa22.04 gcc bit oa22.41 gcc bit oa22.43 gcc bit Linux RHEL 4.8 RHEL 5 SLES 10 SLES 11 Perl Python Ruby Tcl

4 oaspython Example This simple scripting language demo will show how to use oaspython to open a library and create a simple design with two nets. 4

5 oaspython Example Shell environment variables need by oascript perl: linux> export ruby: linux> export tcl: linux> export python: linux> export =/opt/oascript/perl5 =/opt/oascript/ruby =/opt/oascript/tcl =/opt/oascript/python2 LD_LIBRARY_PATH specifies the path to the OA libraries: linux> export =/opt/oa22.43p004/lib/ linux_rhel50_gxx44_64/opt 5

6 oaspython Example Unsupported Platforms Often times the need arises to run OA/oaScript on an unsupported platform such as Fedora 17. Fedora 17: The user will still need to specify the path to the OA libraries: linux> export =/opt/oa22.43p004/lib/ linux_rhel50_gcc44x_64/opt Important The user will need to tell OA which platform to substitute: linux> export =linux_rhel50_gcc44x 6

7 oaspython Example Using the python interpreter to create a library: linux> export PYTHONPATH=/opt/oaScript/python2 linux> export LD_LIBRARY_PATH=/opt/oa22.43p004/ /opt linux> export OA_UNSUPPORTED_PLAT=linux_rhel50_gcc44x linux> python Python (default, Jul , 10:05:38) >>> import oa >>> oa.oalib.create("designlib", "./designlibondisk") <Swig Object of type 'OpenAccess_4::oaLib *' at 0x7feace8141f0> >>> quit() linux> ls -ld designlibondisk drwxrwxr-x. 2 me user 4096 May 28 12:12 designlibondisk 7

8 oaspython Example Create a lib.defs (library definition) file: The lib.defs file associates logical library names used by tools with physical locations on disks. lib.defs DEFINE designlib./designlibondisk The lib.defs file is a text file. It can be created and managed by OpenAccess functions, OR it can be created and edited in your favorite text editor. For our simple example, it is made in the editor. 8

9 oaspython Example The DEFINE statement specifies the mapping between a logical library name and its physical location on disk. lib.defs DEFINE The library s logical name is designlib. The library s physical location is./designlibondisk. 9

10 oaspython Example The OpenAccess API looks for a lib.defs file in 1. The current directory 2. The home directory 3. <oainstalldir>/data/libraries directory lib.defs DEFINE designlib./designlibondisk 10

11 oaspython Example Creating an example design script: #!/usr/bin/env python makedesign.py Execute as a python script. 11

12 oaspython Example Creating an example design script: #!/usr/bin/env python import sys import oa makedesign.py Import the system uality and oa modules. 12

13 oaspython Example Creating an example design script: #!/usr/bin/env python import sys import oa oa.oadesigninit() makedesign.py import oa calls oadesigninit() automaacally, so this isn t needed 13

14 oaspython Example Creating an example design script: #!/usr/bin/env python import sys import oa oa.oalibdeflist.openlibs() makedesign.py Read the lib.defs file, which maps logical names to physical locaaons. 14

15 oaspython Example Creating an example design script: #!/usr/bin/env python import sys import oa oa.oalibdeflist.openlibs() vt=oa.oaviewtype.get( netlist ) makedesign.py viewtype must be specified to create a design. 15

16 oaspython Example Creating an example design script: import sys import oa oa.oalibdeflist.openlibs() vt=oa.oaviewtype.get( netlist ) des=oa.oadesign.open( designlib, mycell, myview, vt, w ) makedesign.py Open a design with logical, cell, and view names, viewtype, and write mode. 16

17 oaspython Example Creating an example design script: oa.oalibdeflist.openlibs() vt=oa.oaviewtype.get( netlist ) des=oa.oadesign.open( designlib, mycell, myview, vt, w ) block=oa.oablock.create(des) makedesign.py The block holds a physical descripaon of the design. 17

18 oaspython Example Creating an example design script: des=oa.oadesign.open( designlib, mycell, myview, vt, w ) block=oa.oablock.create(des) oa.oascalarnet.create(block, net1 ) makedesign.py This creates the 1st net, net1. 18

19 oaspython Example Creating an example design script: makedesign.py block=oa.oablock.create(des) This creates the 2nd net, net2. oa.oascalarnet.create(block, net1 ) oa.oascalarnet.create(block, net2 ) 19

20 oaspython Example Creating an example design script: block=oa.oablock.create(des) oa.oascalarnet.create(block, net1 ) oa.oascalarnet.create(block, net2 ) for net in (block.getnets()): print net in block: %s % (net.getname()) makedesign.py This iterates over the collecaon of nets in the block. 20

21 oaspython Example Creating an example design script: block=oa.oablock.create(des) oa.oascalarnet.create(block, net1 ) oa.oascalarnet.create(block, net2 ) for net in (block.getnets()): print net in block: %s % (net.getname()) makedesign.py This prints each net s name in the collecaon. 21

22 oaspython Example Creating an example design script: oa.oascalarnet.create(block, net1 ) oa.oascalarnet.create(block, net2 ) for net in (block.getnets()): print net in block: %s % (net.getname()) des.save() makedesign.py This saves the design to the disk. 22

23 oaspython Example Creating an example design script: makedesign.py oa.oascalarnet.create(block, net2 ) This closes the design. for net in (block.getnets()): print net in block: %s % (net.getname()) des.save() des.close() 23

24 oaspython Example Running the makedesign.py script: Don t forget your environment variables linux> export PYTHONPATH=/opt/oaScript/python2 linux> export LD_LIBRARY_PATH=/opt/oa22.43p004/ /opt linux> export OA_UNSUPPORTED_PLAT=linux_rhel50_gcc44x Make sure you have the script, library, and lib.defs file in the current directory. linux> ls lib.defs makedesign.py designlibondisk You may need to make your file executable linux> chmod +x makedesign.py 24

25 oaspython Example Running the makedesign.py script: Execute the script linux>./makedesign.py net in block: net1 net in block: net2 NoAce: this is our expected output. 25

26 #include <iostream> #include "oadesigndb.h int main(int argc, char *argv[]) { oa::oadesigninit(); oa::oalibdeflist::openlibs(); oa::oanativens nns; C++ Dump Nets oa::oascalarname slib(nns, argv[1]); oa::oascalarname scell(nns, argv[2]); oa::oascalarname sview(nns, argv[3]); } oa::oadesign *design = oa::oadesign::open(slib, scell, sview, 'r'); oa::oablock *block = design->gettopblock(); oa::oaiter<oanet> iter(block->getnets()); while (oa::oanet *net = iter.getnext()) { oa::oastring str; net->getname(nns,str); std::cout << str << std::endl; } 26

27 Python Dump Nets import sys import oa oa.oalibdeflist.openlibs() design = oa.oadesign.open(sys.argv[1], sys.argv[2], sys.argv[3], r ) block = design.gettopblock() for net in block.getnets(): print net.getname() 27

28 oadebug Example Let s look at our design library with oadebug: Executing oadebug from the same directory will allow it to read the same lib.defs file linux> <path_to_oadebug>/si2oadebug By default, this will start a Firefox browser and show you 28

29 oadebug Example NoAce: this is our library. 29

30 oadebug Example NoAce all the references to where you are in the design. 30

31 oadebug Example To save on memory, designs are not shown unal you BIND. 31

32 oadebug Example Once you BIND, a new browser window opens containing the design. 32

33 oadebug Example NoAce the oablock within the oadesign. Under oablock, you will find your nets. 33

34 oadebug Example Under nets you can see that you have a total count of 2. 34

35 oadebug Example Here you have your net1 and net2. 35

36 oadebug Example Under each net, you will find all of it s properaes and members. 36

37 oadebug Example NoAce that OpenAccess specific classes in blue are right mouse click hyperlinks directed to the OpenAccess Docs. 37

38 Si2 oadebugging Suite Check out Si2 s other debug programs. si2oadebug si2oadiff diff any 2 designs si2oaforensics Checks for GLIBCXX compatibility Release Build Name Internal Build Name Libraries Build Info Data Model Rev API Minor Rev Platform Name Wafer Support Data Compression Support Scratch Design Support 38

39 OpenAccess Recent Progress Recent Releases of OpenAccess oa22.41 Stream p031 Released May 14, 2013 p029 Released January 28, 2013 oa22.43 Stream p014 Released April 24, 2013 p010 Released February 20,

40 OpenAccess News The new ESG v2.0 License has been approved! Sign Once / Use Many model. String/Name Table Capacity Increase Due in END of LIFE coming January 1, 2014: oa22.04 Stream oa22.42 Stream 40

41 oascript 2.0 NOW AVAILABLE TO ALL SI2 MEMBERS! UNDER THE ESG LICENSE v

42 Si2 oadebugging Suite ALWAYS AVAILABLE TO EVERYONE! FREE, AS IN GRATIS! UNDER THE APACHE 2.0 LICENSE. 42

43 For More Information oascript Users Wiki README notes for the oascript releases OpenAccess Documentation and Training Si2 OpenAccess Online Course Si2 OpenAccess Tutorial and Labs OpenAccess Online Docs 43

44 For More Information Si2 oadebugging Suite OpenAccess Documentation and Training Si2 OpenAccess Online Course Si2 OpenAccess Tutorial and Labs OpenAccess Online Docs 44

45 THANK YOU! 45