oascript HowTo Kevin Nesmith Lead Engineer, Si2 June 10, 2013

Transcription

1 oascript HowTo Kevin Nesmith Lead Engineer, Si2 June 10,

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 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 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 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 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 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 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 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 Creating an example design script: #!/usr/bin/env python makedesign.py Execute as a python script. 11

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

13 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 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 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 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 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 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 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 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 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 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 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 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 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 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 26

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

28 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 28

29 THANK YOU! 29