home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 September / pcwk_09_96.iso / demo / elmark / cupl / manual / ug2.txt < prev    next >
Text File  |  1992-01-17  |  15KB  |  366 lines
  1. .C1.INSTALLING CUPL                U2
  2.  
  3.     A read.me file has been provided to describe the new features and 
  4.     enhancements of this version of CUPL software.  The following are 
  5.     the requirements and steps for installing CUPL on a system.
  6.  
  7. o   .c2.MS-DOS INSTALLATION
  8.  
  9.     The following are the minimum requirements in order to install and 
  10.     run CUPL properly:
  11.  
  12.             An IBM PC, PC/XT, or PC/AT (or equivalent) with at least 
  13.             512K of RAM.
  14.  
  15.             PC-DOS version  3.3 or higher (or MS-DOS 3.3).  A hard disk
  16.  
  17.             At least one double-sided floppy disk drive.
  18.  
  19.     Installing  CUPL  requires these steps.
  20.  
  21.     Run the INSTALL program contained on the diskette labelled 
  22.     "DISK 1".
  23.  
  24.     Build the library.
  25.     Set the 'Configuration' of the computer so that CUPL will have the 
  26.     setup that it needs.
  27.  
  28.     Set the 'Environment' of the computer so that the system will 
  29.     function properly.
  30.  
  31.     The INSTALL program has been provided to quickly and easily install 
  32.     the CUPL software. It creates the appropriate directory and copies 
  33.     the original diskettes onto the hard drive.  If the install 
  34.     procedure is interrupted, it may be resumed without starting over.  
  35.     For example, if Disk 3 was completely installed, resume by inserting 
  36.     disk 1 and typing install 4.  If disk 3 was partially installed 
  37.     resume by inserting disk 1 and typing install 3.
  38.  
  39.     This installation procedure assumes that CUPL is being installed 
  40.     from drive A: to C:\CUPL.  If your computer will use a different 
  41.     setup then replace the examples with your particular setup.  To run 
  42.     the INSTALL program, follow the steps below:
  43.  
  44.     1.     Place the "DISK 1" diskette in drive A. Change the current 
  45.            drive to drive A by typing:
  46.  
  47.                 a:[Enter]
  48.  
  49.     2.           Type install [Enter]
  50.  
  51.     3.     Follow the prompts on the screen. The program suggests 
  52.            default values at each prompt; for example, it supplies CUPL 
  53.            as the directory name. Press [Enter] to accept the default 
  54.            name or type a different name and then press [Enter].
  55.  
  56.     4.     CUPL needs to access its device library CUPL.DL. This file 
  57.            must be created on the hard disk. To do this, run build while 
  58.            in the CUPL subdirectory.  This is a batch file which creates 
  59.            the library and puts the required information into it. A 
  60.            batch file is simply a text file which contains a series of 
  61.            DOS commands which can be executed by typing in the batch 
  62.            file name.  Before running build, make sure that there is 1.2 
  63.            Mb of disk space available.
  64.  
  65.            Type:
  66.                 build[Enter]
  67.  
  68.            If Surface Mount Technology parts are to be used, then an 
  69.            additional step is required to add these to the library. 
  70.            Before running buildsmt, make sure that there is .7 Mb free 
  71.            space on the disk.
  72.  
  73.            Type:
  74.                buildsmt[Enter]
  75.  
  76.     5.     When a DOS computer starts up, it executes commands that are 
  77.            contained in a file called AUTOEXEC.BAT if it is present on 
  78.            the disk.  Some additional commands must be added to the 
  79.            AUTOEXEC.BAT file for CUPL to function most efficiently. If 
  80.            there is no AUTOEXEC.BAT file on the computer, then create 
  81.            one and add the following information to it:
  82.  
  83.         path <drive>:\<subdirectory>
  84.  
  85.         set LIBCUPL=<drive>:\<subdirectory>\cupl.dl
  86.  
  87.         e.g.:
  88.         path c:\cupl
  89.         set LIBCUPL=c:\cupl\cupl.dl
  90.  
  91.            This lets the computer know where to find the CUPL Program 
  92.            and Library.
  93.  
  94.            The computer may already have an AUTOEXEC.BAT file. In that 
  95.            case, it should be modified as follows.
  96.  
  97.         Add CUPL to the path command.
  98.  
  99.         If the current path command reads:
  100.  
  101.         path        <drive>:\<subdirectory>;
  102.         <drive>:\<subdirectory>
  103.  
  104.         e.g.
  105.         path c:\dos;c:\bin
  106.  
  107.         Change it to:
  108.          path <drive>:\<subdirectory>;<drive>:\<subdirectory>;<drive>:\cupl
  109.  
  110.         e.g.
  111.         path c:\dos;c:\bin;c:\cupl
  112.  
  113.         Add this set command to the AUTOEXEC.BAT file:
  114.  
  115.         set LIBCUPL=<drive>:\<subdirectory>\cupl.dl
  116.  
  117.         e.g.
  118.         set LIBCUPL=c:\cupl\cupl.dl
  119.  
  120.     This example assumes that CUPL is installed in a directory called 
  121.     CUPL on Drive C of the computer.
  122.  
  123.    .c3.Specifying the Configuration
  124.  
  125.     Each time the system is booted, the disk operating system (DOS) 
  126.     configures the system for a specified number of buffers and files.  
  127.     A buffer is a block of memory that DOS uses to hold data being read 
  128.     from or written to disk when the amount of data being transferred is 
  129.     not an exact multiple of the sector size.  The number of files for 
  130.     which the system is configured determines how many files can be open 
  131.     at one time during program operation.  A CONFIG.SYS file in the root 
  132.     directory instructs DOS on how to configure the system. If there is 
  133.     no CONFIG.SYS file, DOS sets default values for the configuration.  
  134.     CUPL requires 20 buffers and 15 files to ensure proper operation.  
  135.     Verify that the system has a CONFIG.SYS file in the root directory 
  136.     and that it contains the following two commands:
  137.  
  138.  
  139.     buffers=20
  140.     files=15
  141.  
  142.     If the system does not have a CONFIG.SYS file, create one using the 
  143.     an editor in non-document mode.  Type in the following:
  144.  
  145.  
  146.     BUFFERS=20
  147.     FILES=15
  148.  
  149.     If the system has a CONFIG.SYS file, but the buffers are less than 
  150.     20 or the files are less than 15, change the values to 20 and 15 
  151.     respectively.  If the CONFIG.SYS file on the system specifies 
  152.     buffers greater than 20 and files greater than 15, leave the file 
  153.     intact.  Other programs that are running may require more buffers or 
  154.     files than CUPL does.  If a CONFIG.SYS file has been created or 
  155.     altered, or if the AUTOEXEC.BAT file was changed according to the 
  156.     instructions in the previous section, press Control-Alternate-Delete 
  157.     to reboot the system and put the new commands into effect.
  158.  
  159. .c3.The CUPL Menu System
  160.  
  161.     There are two ways to  run the CUPL program. The program may be 
  162.     executed using the DOS command line, or, the optional menu system 
  163.     may be used.
  164.  
  165.     The CUPL menu system is called MCUPL.  It is entirely menu driven 
  166.     and can be learned in a few minutes.  This section will describe 
  167.     MCUPL.
  168.  
  169.     Note:
  170.            MCUPL is available for MS-DOS computers only.
  171.  
  172.     Note:
  173.            Although it may not be explicitly stated on the screens, the 
  174.            Escape key can be used to cancel a choice or to go back to 
  175.            the previous screen or menu.
  176.  
  177. MENU CONFIGURATION
  178.  
  179.     The menu system uses information stored in a file called 
  180.     "MCUPL.CFG".  This file permits the following information to be 
  181.     specified:
  182.  
  183.     Machine ID:  This can be set to "PC" or "AT".  If using a computer 
  184.     with an 8088/8086 processor, then select "PC". If using an 80286 or 
  185.     better, then select "AT".  The specification is done with the 
  186.     following syntax:
  187.  
  188.      "set mid PC" or "set mid AT".
  189.  
  190.     The editor being used must be specified.  If this is not done, then 
  191.     MCUPL will use the default editor, EZEDIT.  Specifying the editor is 
  192.     done as follows:
  193.  
  194.         "set editor me"        if "me.exe" is the editor being used.
  195.         "set editor ws"        if "ws.exe" is the editor being used.
  196.  
  197.     MCUPL uses a working directory where it reads and writes files.  Any 
  198.     file created by the user or by CUPL should be stored here.  Set the 
  199.     working directory with the following syntax:  "set wdpath pathname", 
  200.     where pathname is a directory path name.  Example:
  201.  
  202.     "set wdpath c:\cupl\files".
  203.  
  204.     MCUPL.CFG contains specifications for screen colors of the menus.  
  205.     Use "set color area color", where area is the area of the screen, 
  206.     such as MCFG (Message Center Text), MCBG (Message Center
  207.     Background), MCBC (Message Center Border), UIFG (User Input Text), 
  208.     UIBG (User Input Background), UIBC (User Input Border), MMFG (Main
  209.     Menu Text), MMBC (Main Menu Border) and MMBG (Main Menu Background).  
  210.     The color attribute determines what color the area will have, such 
  211.     as Black, Blue, Green, Cyan, Red, Magenta, Brown, Yellow, Darkgrey, 
  212.     Lightgrey, Lightblue, Lightgreen, Lightcyan, Lightred, Lightmagenta 
  213.     and White.  Example "set color MCFG Lightblue" will make the message 
  214.     center text appear light blue.  .i.function keys;.i.Menu:function 
  215.     keys;The function keys F6 to F10 can be user-defined. Since the 
  216.     menus can be operated either by using the arrow keys or by typing 
  217.     the first key of the desired menu selection, the menus can be used 
  218.     normally or a function key can be defined to perform a specific 
  219.     action by having it type a series of keys.  The following example 
  220.     defines F10 (F0) to quit MCUPL by typing 'Q' to select quit and then 
  221.     'Y' to confirm the action.  Example:
  222.  
  223.     "def F0 QY"
  224.  
  225.     Start the menu system as follows.  Start up the computer. At the 
  226.     prompt, type:
  227.  
  228.     mcupl[Enter] The startup screen will appear, followed by the main 
  229.     menu with 18 items on it.
  230.  
  231.      <E>dit Design Entry                Edit or convert a design file.
  232.  
  233.      <C>ompile CUPL file                Prompts for a .PLD file then 
  234.                                         compiles it.
  235.  
  236.      <L>ook at DOC file                 View the Documentation file.
  237.  
  238.      <R>eview error LST file            View the error listing file .
  239.  
  240.      <J>EDEC file editor                View or edit a JEDEC file.
  241.  
  242.      Ed<I>t Simulation Input            Create or edit a simulation 
  243.                                         input file (.SI).
  244.  
  245.      <S>imulate CUPL file               Simulate the PLD design using 
  246.                                         the .SI file.
  247.  
  248.      <V>iew simulation results          View simulation output file 
  249.                                         (.SO).
  250.  
  251.      <D>evice Selection                 Choose a device from a list, 
  252.                                         giving device type, 
  253.                                         manufacturer, and other 
  254.                                         information.
  255.  
  256.      <B>uild/view Device Library        Build or view a user device 
  257.                                         library.
  258.  
  259.      <P>ALASM to CUPL                   This allows user to convert 
  260.                                         PALASM source file to CUPL 
  261.                                         source file.
  262.  
  263.      <H>elp (CUPL Quick Reference)      The online quick reference guide 
  264.                                         for CUPL.
  265.  
  266.     <T>utorial for PLDs                 Executes the Programmable Logic 
  267.                                         User's guide demonstration.
  268.  
  269.     Design E<X>amples                   Display PLD design examples 
  270.                                         description .
  271.  
  272.     <U>ser's Editor                     Create or edit any text file
  273.                                         e.  g .
  274.                                         DEVHELP.TXT, CQRG.TXT, 
  275.                                         EXAMPLES.TXT, INFO.TXT .
  276.  
  277.     <A>dditional Product Information    Provide further in formation 
  278.                                         about CUPL and other Logical 
  279.                                         Devices products .
  280.  
  281.     S<Y>stem Information                Show system information .
  282.  
  283.     <Q>uit                              Return to DOS.
  284.  
  285.     Only one menu item can be highlighted at a time.  While an item is 
  286.     highlighted, a description of the action performed is displayed in 
  287.     the message center window. To initiate the action associated with 
  288.     the menu item, press [Enter]. The action may also be initiated by 
  289.     pressing the first letter of the menu item.
  290.  
  291.     The keyboard can be used to select from the menu by typing the first 
  292.     letter of the menu item name. This has the same effect as using the 
  293.     arrow keys and pressing the return key for that item.  Some menu 
  294.     selections simply cause another menu to appear.  Selecting items 
  295.     from sub-menus is the same as selecting from the main menu.  To 
  296.     return to the previous menu, press the ESC key.
  297.  
  298.  
  299. The Device Information File(DEVHELP.TXT) Format
  300.  
  301.     A large number of devices are supported by CUPL.  MCUPL provides a 
  302.     device information file (DEVHELP.TXT) to help users to look up or 
  303.     add application notes for certain devices.
  304.  
  305.     From the Device Selection Menu,highlight the desired device and 
  306.     press F1 to review additional information on this device. If no 
  307.     additional information for this device is contained in DEVHELP.TXT, 
  308.     the following message will appear:
  309.  
  310.         No information for
  311.         this device.
  312.  
  313.     DEVHELP.TXT can be modified for your own purposes. This file is 
  314.     composed of several discrete units. Each unit is comprised of three 
  315.     main parts, a header, a body and an end marker.  The header is a 
  316.     line that begins with a percent(%) sign and is followed by a unique 
  317.     keyword (device mnemonic).
  318.  
  319.     The body is comprised of two parts. The first part is the title 
  320.     which is any text on the first line of the body. The second part is 
  321.     the text of the body itself. This information can span as many lines 
  322.     as necessary. The end marker is a double percent sign(%%) on a line 
  323.     by itself.
  324.  
  325.     Example:
  326.         %EP300EP300
  327.         ArchitectureThe
  328.         ep300 is a
  329.         ...............%%
  330.  
  331.    .c3.The EZ Edit Editor
  332.  
  333.     The EZ Edit editor is the stand-alone editor used by MCUPL, unless a 
  334.     different editor is specified in MCUPL.CFG.  EZ Edit is a simple 
  335.     text editor.
  336.  
  337.     When using EZ Edit, the insert key is used to alternate between the 
  338.     insert and overwrite modes.  The Alternate-X [Alt-X] key is used to 
  339.     exit the editor.  When exiting, the editor will ask for the filename 
  340.     to which changes should be saved (only if there were changes).
  341.  
  342.     The following are the keystrokes and commands available when using 
  343.     the EZ Edit editor:
  344.  
  345.     Key             Action
  346.  
  347.     Up Arrow        Cursor up
  348.     Down Arrow      Cursor down
  349.     Left Arrow      Cursor left
  350.     Right Arrow     Cursor right
  351.     Home            Beginning of line
  352.     End             End of line
  353.     PgUp            Page up
  354.     PgDn            Page down
  355.     Ctrl-Home       Top of screen
  356.     Ctrl-End        Bottom of screen
  357.     Ctrl-PgUp       Top of file
  358.     Ctrl-PgDn       Bottom of file
  359.     Backspace       Deletes a character
  360.     Ctrl-Backspace  Deletes a line
  361.     Alt-X           Exits EZ Edit
  362.  
  363.  
  364.  
  365.  
  366.