home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 September / pcwk_09_96.iso / demo / elmark / cupl / manual / sb3.txt < prev    next >
Text File  |  1991-12-16  |  8KB  |  218 lines
  1. .c1.Using CBLD                  3
  2.     CBLD permits the maintaining and personalizing of CUPL device 
  3.     libraries. It can list the contents of a library and build new 
  4.     libraries from existing ones.
  5.  
  6.     A CUPL device library is a file containing descriptions of one or 
  7.     more PLDs. CUPL and CSIM use device libraries to determine the 
  8.     characteristics of target devices.  CUPL provides device libraries 
  9.     to describe all the PLDs instead of supplying individual files for 
  10.     each PLD.  The advantage of device libraries is that they are easier 
  11.     to keep track of than multiple device files and they enable quicker 
  12.     program operation.
  13.  
  14.     The use of device libraries also resolves compatibility problems 
  15.     between the compiler and device descriptions. Each version of CUPL 
  16.     and its corresponding device library is given a matching key.  If a 
  17.     library is used that has a different key than the CUPL compiler, an 
  18.     error message is generated during compilation and the compilation is 
  19.     aborted.
  20.  
  21.     The library that is created when the BUILD batch file is executed, 
  22.     CUPL.DL, contains descriptions for each device that is supported by 
  23.     the current version of CUPL.
  24.  
  25. o   .c2.RUNNING CBLD
  26.     Run CBLD with the following command line format:
  27.  
  28.         cbld [-flags] [build] [library] [devices]
  29.  
  30.     where
  31.  
  32.     -flags is the following set of options:
  33.     -b    generate library using build file.
  34.     -e    list allowable extensions.
  35.     -l    list long contents of    library.
  36.     -m    list allowable macros by    pin.
  37.     -t    list short contents of    library.
  38.     -u    use specified library for    listings.
  39.  
  40.     build is the name of a file to be used with the -b option flag
  41.  
  42.     library is a device library name and path name to be used 
  43.     with the -u option flag.
  44.  
  45.     devices is one or more device names to be used with the 
  46.     -t or -l options.
  47.  
  48.    ========================================================
  49.    Note
  50.      The square brackets
  51.      indicate optional items.
  52.    ========================================================
  53.      
  54.     CBLD can be typed without any flags to see the command line format 
  55.     and a list of the option flags.  CBLD provides two distinct 
  56.     functions:  listing the contents of a library (the -t and -l 
  57.     options) and building a new library (the -b option).  These two 
  58.     functions are described in the following sections.
  59.  
  60. o   .c2.LISTING THE   CONTENTS OF A   LIBRARY
  61.     To list the contents of a device library, use one of the following 
  62.     command line formats:
  63.  
  64.         cbld -t [-u library]        [devices]
  65.         cbld -l [-u library]        [devices]
  66.  
  67.     where
  68.  
  69.         library is a device library name and path name.
  70.  
  71.         devices is one or more device names.
  72.  
  73.  
  74.    ========================================
  75.    Note
  76.      The square brackets
  77.      indicate optional items.
  78.    ========================================
  79.  
  80.     Use the -t flag to specify the short form, which lists only the 
  81.     device names and the revision number of the library.  Use the -l 
  82.     flag to specify the long form, which lists the revision number of 
  83.     the library and the names of the devices, and provides the revision 
  84.     number, the number of pins, the number of fuses, and the number of 
  85.     product terms for each device.
  86.  
  87.     By default, CBLD lists the entire contents of the library; however, 
  88.     certain devices can be specified to be listed.  For example, by 
  89.     typing:
  90.  
  91.         cbld -l p16h8 p16l8 p16hd8 p16ld8 [Enter]
  92.  
  93.     CBLD lists the characteristics of the p16h8, p16l8, p16hd8 and 
  94.     p16ld8 devices in the CUPL.DL library as follows:
  95.  
  96.         Device        Rev        Pins        Fuses        Pterms
  97.         pl6h8         08         20          2048         64
  98.         pl6l8         08         20          2048         64
  99.         pl6hd8        06         20          2048         64
  100.         pl6ld8        06         20          2048         64
  101.  
  102.     Use the -u flag and a library name with either
  103.     the -l or -t flag to list the contents of a library other than the 
  104.     default library specified in the environment file.  For example, to 
  105.     see the contents of a library named small.dl, type:  
  106.  
  107.         cbld -l -u small.dl [Enter]
  108.  
  109. o   .c2.LISTING   ALLOWABLE   EXTENSIONS
  110.     The  -e flag allows the listing of the valid  extensions for 
  111.     devices. For example:
  112.  
  113.         cbld -e p22v10
  114.  
  115.     The screen will display:
  116.  
  117.         Device        Extension
  118.         p22v10        OE D AR SP
  119.  
  120.     This shows that the valid extensions for the P22V10 are:
  121.  
  122.     OE    output enable control
  123.     D     D-type register
  124.     AR    asynchronous reset
  125.     SP    synchronous reset
  126.  
  127.     If more than one device type must be listed, specify multiple device 
  128.     names. For example:  
  129.  
  130.         cbld -e p22v10 ep600
  131.  
  132.     The screen will display:
  133.         Device        Extensions
  134.         ep600         OE D T AR CK IO DFB TFB
  135.         p22v10        OE D AR SP
  136.  
  137.     If a particular device is not specified, CBLD will, by default, list 
  138.     all the devices of the library.
  139.  
  140. o   .c2.BUILDING   DEVICE LIBRARIES
  141.     To build a new library from an existing library, first create an 
  142.     ASCII build file (filename.BLD) that specifies the name of the new
  143.     library, the name of the source library, and the devices to use from 
  144.     it. Any text editor can be used, once it can produce a standard 
  145.     ASCII Text file.
  146.  
  147.    ========================================================
  148.   Note
  149.     The vertical line ( | ) separates items in the syntax that are 
  150.     mutually exclusive. Do not type it in.
  151.    ========================================================
  152.  
  153.         The build file uses the following syntax:
  154.  
  155.         TARGET
  156.         library
  157.         SOURCE
  158.         library1
  159.         devices | *
  160.         SOURCE
  161.         library2
  162.         devices | *
  163.         .
  164.         .
  165.         .
  166.  
  167.         where
  168.  
  169.         TARGET is a keyword to identify the new library.
  170.  
  171.         SOURCE is a keyword to identify the source libraries.
  172.  
  173.         library is a target library name.
  174.  
  175.         library1 and library2 are source library names.
  176.  
  177.         devices are device names contained in the source libraries.
  178.  
  179.         * is a "wildcard" representing all devices in the specified 
  180.         library.
  181.  
  182.     When building a new library, devices from more than one source 
  183.     library can be specified by using more than one SOURCE keyword.  
  184.     Comments may be used in the build file.  Enclose comments between 
  185.     the /* and */ symbols.  To compile the build file, use the following 
  186.     command line format:
  187.  
  188.         cbld -b filename.bld
  189.  
  190.  
  191.     ========================================================
  192.    Note
  193.      There is no standard extension for build files. The .BLD extension 
  194.      is for mnemonic convenience only.  When running CBLD, the entire 
  195.      filename, including the extension, must be typed in.
  196.     ========================================================
  197.  
  198.     The following example shows the contents of a build 
  199.     specification file, small.bld.  Small.bld specifies that a new 
  200.     library, smallib.dl, be built containing the devices p22v10, f105, 
  201.     and p16rp8 from the cupl.dl library, and all the devices in the 
  202.     biglib.dl
  203.  
  204.         TARGET smallib.dl
  205.         SOURCE cupl.dl
  206.         p22v10
  207.         f105
  208.         p16rp8
  209.         SOURCE biglib.dl
  210.         *
  211.  
  212.     To run CBLD and build the smallib.dl library specified in the sample 
  213.     file above, type:
  214.  
  215.         cbld -b small.bld [Enter]
  216.  
  217.  
  218.