examples.txt

Atmel提供的GAL编译工具,对GAL芯片进行编写,以及可转换成机器码

                         ********************************
                          WELCOME TO Atmel-WINCUPL V4.8a
                         ********************************

This README file contains important information about CUPL. For the latest
information about CUPL read this entire file.

*****************
TABLE OF CONTENTS
*****************
1.  How to Get Assistance
         -- Sources of information
2.  Installation
         -- Installing WINCUPL
3.  New Features
4.  Important Information
5.  ATMEL ATF1500 Fitter Support
6.  CUPL Manual
7.  CUPL Examples


===========================
1. |HOW TO GET ASSISTANCE |
===========================

If you have any problems, please read this file.  If you need need assistance,
please contact Atmel at:

PLD Hotline at [phone]
E-mail: [e-mail].
WEB Homepage: http://www.atmel.com
BBS: [phone]

You can also contact Logical Devices' technical support at:
Phone: [phone]
Fax:   [phone]
E-mail: [e-mail].
Web: http:\\www.logical.com

When reporting bugs please be detailed as possible, send your PLD source
file and indicate the version of Atmel-CUPL/WINCUPL with the problem. 


==================
2. |INSTALLATION |
==================

To install Atmel-WINCUPL,
1.  Put disk 1 in your floppy drive.
2.  In Program Manager, choose File|Run.
3.  Type A:\SETUP (If your disk drive is not drive A, type the appropriate 
    letter instead.)
4.  Choose OK.
5.  Follow the instructions on the screen.

It is recommended that you install all of the executable files in the default
directories.


==================
3. | NEW FEATURES|
==================
Atmel-WINCUPL V4.8a includes the following new features:

DEVICE SUPPORT
--------------

ATF16V8C/ATF22V10C - This version support these new Atmel product. Selecting
these device type (E.g. g22v10cp) automatically enables the pin controlled
power down feature on these device. WinCUPL will check if your logic is using
the power down pin and report an error.

ATF1508 - The ATF1508-68PLCC, ATF1508-84PLCC and ATF1508-100QFP devices are
now support on this release. Manually pin assignment like the ATF1500/A are
not necessary. A device fitter for the ATF1508 is included in this release. 

BUG FIXES:
----------
Refer to the CUPL_BUG.TXT file included with this version of CUPL for a list of
bug fixes. You can obtain the latest version of this file from the Atmel BBS 
and check it to see if there is a workaround for your particular bug. If you 
find a bug that is not included in this list, please contact Atmel PLD 
Applications. 

CUPL MODULE CHANGES:
--------------------
Device Library: Added ATF16V8C/CZ, ATF22V10C/CZ and ATF1500A device support

CUPLB:          Fixed f1500 device types that had two term equations being 
                demorganized but were not expanded correctly in the pla file.
		    Module now checks is ISP device is select for a design that
		    uses the JTAG port pins. Syntax error point to signal name.

CUPLC:          Fixed some memory corruption bugs. Changed the v2500b jedec 
                mapping to configure the IO cells better. 

VSIMA:          Fixed some simulation support bugs for the ATF1500 device.

BACKPIN:        Upgraded version allows for back-annotation of Atmel ATF1500 
                fitter pin assignments. 

ONLINE HELP:
------------
On-line help is available. Use to on-line help to obtain information about CUPL
syntax, suffix usage, Keywords, How to use Atmel-Wincupl and error messages.
To use the On-line help:

1. Run Atmel-WinCUPL

2. In the Atmel-WinCUPL main menu select the Help topic.

3. Click on Index

4. A list of help topic are displayed. You can either browse through these topic
   list or find help on a particular topic.

5. To find help on a particular topic. Click Search with the Help Menu open
   Select the help topic to display from the listing

FLIP-FLOP SYNTHESIS:
--------------------
You can use D,T,JK or RS type flip-flops to capture your design.
WINCUPL can automatically convert equations for these flip-flop into
equivalent expression for D or T type flip-flops supported by Atmel devices
through the REGISTER_SELECT Keyword. This keyword can also be used to allow
WINCUPL to automatically choose the appropriate flip-flop type that results
in the fewest number of product terms for your design.
More information on this Keyword is available in the WINCUPL On-line HELP.

Refer to CONVERT.PLD CUPL example.  Note that all CUPL example files
are located in the EXAMPLES directory.


=========================
4. IMPORTANT INFORMATION
=========================

GENERAL:
-------
You may notice that some large text files (> 24Kbytes) such as PLD source,
simulation input, output and/or fitter report files may fail to open in WINCUPL.
You may see an "Out of Memory","Fail to read" of General Protection Fault errors
when attempting to view a particular file.  If you experience the 
"Out of Memory" or "Fail to read" error you can still view the file provided 
that it exists.  To view the file:

1. Select DOS PROMPT under the UTILITIES menu in WINCUPL. This will open
   the DOS prompt in WINCUPL.

2. Type: edit <filename> where <filename> represents the DOS path to the file.
   This will invoke the DOS editor to allow the file to be viewed.

3. Type: EXIT from the FILE Menu in the DOS editor.
   This will exit the DOS editor and return to the DOS prompt 

4. Type: EXIT in the DOS prompt. This will close the DOS prompt and return to 
   the WINCUPL main menu.   

If you see a General Protection Fault (GPF) error, exit WinCUPL and re-run this
should correct the problem. This error can also be minimized by having fewer 
file open during compilation.

DEVICE SPECIFICS:
-----------------
A. Support has been added for the Atmel ATF16V8C/CZ device.
   - If you want to enable the pin-controlled power down feature on the Atmel
     ATF16V8C select the "g16v8cp" device type.  Refer to GATES_C.PLD file.
     Note: If you select this device type, you will need to select the ATF16V8C
           device with a "EXT" suffix on your programmer device menu listing.
   - If you want to disable pin-controlled power down feature select "g16v8a"
     device type.

B. If you are generating a simulation file for the g16v8cp device type you must 
   specify pin 4 to be zero. If you do not, WINCUPL will automatically 
   overwrite it to a zero. This is required for functional verification of the
   ATF16V8C/CZ on the programmer when the pin-controlled power down mode is 
   enabled.

C. Support has been added for the Atmel ATF22V10C/CZ device. 
   - If you want to enable the pin-controlled power down feature select either
     the "g22v10cp" or "g22v10cplcc" device types for DIP or PLCC packages 
     respectively.  Refer to LOOKUP.PLD file.
     Note: If you select this device type, you will need to select the ATF22V10C
           device with a "EXT" suffix" on your programmer device menu listing.
   - If you want to disable the pin-controlled power down feature select 
     either the "g22v10" or "g22v10lcc" device types.  
     Note: If you select this device type, you may need to select the ATF22V10C
           device with a "U" or "UES" suffix on your programmer device menu 
           listing.

D. If you are generating a simulation file for the g22v10cp or g22v10cplcc 
   device types you must specify pin 4 for DIP or pin 5 for PLCC to be zero. 
   If you do not, WINCUPL will automatically overwrite it to a zero. This is 
   required for functional verification of the ATF22V10C/CZ on the programmer 
   when the pin-controlled power down mode is enabled.  Refer to CUPL_BUG.TXT
   for bug information.

E. Support has been added for the ATF1500A device. This device allows the 
   Bus-friendly Pin Keeper circuits to be enabled or disabled.  The pin keeper
   circuit will weakly hold all outputs to their previoulsy defined states when