readme.txt

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

   the outputs are disabled. The pin-keeper circuits are easily overdriven when
   the ouputs are enabled. When this feature is disabled all output will float
   when tri-stated. 

   Note: Pin Keeper circuits are also available on the ATF1500 devices, but they
         cannot be disabled.

   Refer to the "Atmel PLD Design Guidelines" applications note on information 
   on the pin-keeper circuits.

   You can enable of disable the pin-keeper circuits by using the CUPL property
   statement.

   1. To Disable this Feature:
      In your PLD source file add the line:

         PROPERTY ATMEL { pin_keep OFF };

      and re-compile your design for either the F1500A or F1500AT
      device types. The fitter will automatically create a JEDEC file
      which when programming into the ATF1500A device will disable the
      pin-keeper circuits. 

   2.  To Enable this feature:

         PROPERTY ATMEL { pin_keep ON };  /* This is the default condition,
                                             so this statement can be omitted */

   Refer to PINKEEP.PLD CUPL example.

F. Security Bit
   You can secure your ATF1500A designs by programming the security bit. To 
   secure a design

   1. Select either the F1500A or F1500AT device type

   2. In you PLD source file add the line:

        PROPERTY ATMEL { security ON };

      and re-compile your design. The fitter will automatically create a
      JEDEC file which, when programmed into the ATF1500A device, will secure 
      the device.

   Note that some programmers require you to manually enable the security bit
   via their menu options (regardless of whether the security bit is enabled in
   the JEDEC file).

   Refer to PINKEEP.PLD CUPL example.

G. For ATF1500/A designs, the Atmel ATF1500 fitter can generate pin assignments for
   you and WINCUPL can automatically back-annotate them into your PLD source 
   file. It you are interested in using this feature do the following:

   1. Generate your PLD source file for the ATF1500/A without pin assignments.
   
   2. Compile the design in WINCUPL. The fitter will run automatically.

   3. Run the BACKPIN utility. 
      In the DOS prompt,
      Type: backpin <device mnemonic> <PLD source file> 

      The <device mnemonic> is the appropriate CUPL ATF1500 device type
      For example: f1500, f1500t, f1500a, f1500at

      The <PLD source file> is the (*.pld) PLD source file which describes your
      design.

      The BACKPIN utility reads a pin assignment file (*.plc file) automatically 
      generated by the Atmel ATF1500 fitter and produces a new PLD source file 
      (*.pld file). The new source file will have the fitter pin assignments back-
      annotated within it. Backpin will automatically make a backup copy of the 
      original source file. This file is named using the (*.bak) suffix. 

   4. In the new source file include this line:

      PROPERTY ATMEL {PREASSIGN KEEP}; 

      The KEEP fitter pre-assignment property allows you to fix your pin 
      assignments in your PLD source file, whether generated automatically by 
      BACKPIN or manually.

   5. Re-save the PLD source file. 

   6. Re-compile the PLD source File in WINCUPL. 

H. For ATF1508 design WinCUPL support two device types. One device type disables
   the JTAG port, and allow design that use the JTAG port pin to be programmed once.
   The other device type enables the JTAG port and allow design that DO NOT use
   the JTAG port pin to be programmed. If you plan to program the ATF1508 using
   In-System Programming (ISP) you must choose the ISP device type. If you select
   an ISP device type for a design that uses the JTAG port pin WinCUPL will generate
   an error. See table below for ATF1508 WinCUPL Device types

            Table 1- WINCUPL ATF1508 Device Types
   -------------------------------------------------------
   |Device            |  JTAG Port | WINCUPL Device Type |
    -----------------------------------------------------
   |ATF1508 -68PLCC   |  Enabled   | f1508ispplcc68      |
   |                  |  Disabled  | f1508plcc68         |
   -------------------------------------------------------
   |ATF1508 -84PLCC   |  Enabled   | f1508ispplcc84      |
   |                  |  Disabled  | f1508plcc84         |
   -------------------------------------------------------
   |ATF1508 -100QFP   |  Enabled   | f1508ispqfp100      |
   |                  |  Disabled  | f1508qfp100         |
   -------------------------------------------------------

   The information in Table 1 above is subject to change as new device are added
   contact Atmel PLD Applications for the latest information.
 



==================================
5. | Atmel ATF1500 Fitter Support|
==================================

This version of Atmel-CUPL includes the Atmel ATF1500 device fitter (V2.32)
CUPL will automatically run this fitter when compiling ATF1500 designs. 
If you need a later version of this fitter download the FIT1500.ZIP file from
the Atmel BBS. A fitter macro file FIT1500.M has also been included in this  
version. This macro file allows you to specify commonly used fitter properties 
in your PLD source file.  

More information on the Atmel ATF1500 device fitter, it properties and macro
support is provided in the ATF1500 CPLD Fitter Manual available from your local
Atmel representative.  The manual is also available for download from Atmel BBS 
or Web (Please call the Atmel PLD Hotline for more information.).

Note: Property statements are used to control the following
      ATF1500 features:
        - preassign = [ TRY | keep | ignore ]
        - optimize = [ ON | off ]
        - soft_buffer [ OFF | on | = node1, node2...]
        - xor_synthesis [ OFF | on | = pin1, pin2...]
        - cascade_logic [ ON | off | = pin1, pin2...]
        - foldback_logic [ ON | off | = node1, pin2...]
        - expander [ = node1, node2... ] (inverted)
        - output_fast [ on | OFF | = pin1, pin2, ..]
        - dedicated_input [ ON | off | = pin1, pin2...]
        - security = [ OFF | on ]
        - pin_keep = [ ON | off ]
        - sleep [ OFF | on | = pin_name ] (power_down mode)
        - jedec_file = file_name
        - vector_file = file_name
        - verilog_file = file_name
        - tPD = [ 15 | 7 | 10 | 12 | 25 ]
        - time_file = file_name
      The option in uppercase is the default condition.

      Please refer to the FIT1500.M file in the WINCUPL\EXAMPLES
      directory for for information.

=============================
6. | ATF1508 Fitter Support |
=============================

This version of Atmel-CUPL includes the Atmel ATF1508 device fitter
(V1.7) CUPL will automatically run this fitter when compiling
ATF1508 designs. This fitter version is a pre-release version and future
updates will occur. Contact Atmel PLD applications for the latest version.

Note: Property statement are used to control all ATF1508 fitter strategies
shown below.
   -strategy preassign = [ TRY | keep | ignore ]
   -strategy optimize = [ ON | off ]
   -strategy soft_buffer [ OFF | on | = node1, node2...]
   -strategy xor_synthesis [ OFF | on | = pin1, pin2...]
   -strategy cascade_logic [ ON | off | = pin1, pin2...]
   -strategy foldback_logic [ ON | off | = node1, pin2...]
   -strategy expander [ = node1, node2... ] (inverted)
   -strategy output_fast [ on | OFF | = pin1, pin2, ..]
   -strategy dedicated_input [ ON | off | = pin1, pin2...]
   -strategy security = [ OFF | on ]
   -strategy pin_keep = [ ON | off ]
   -strategy jedec_file = file_name
   -strategy vector_file = file_name
   -strategy verilog_file = file_name
   -strategy tPD = [ 15 | 7 | 10 | 12 | 25 ]
   -strategy time_file = file_name
   -strategy pd1 [ OFF | on | = pin_name ] (power down 1)
   -strategy pd2 [ OFF | on | = pin_name ] (power down 2)
   -strategy power_reset = [ OFF | on ] 
   -strategy MC_power [ OFF | on | = pin1, pin2...] 
   -strategy open_collector [ OFF | on | = pin1, pin2...] 
   -strategy fast_inlatch [ ON | off | = pin1, pin2...] 
   -strategy JTAG = [ OFF | on ] 
   -strategy TDI_pullup = [ OFF | on ] 
   -strategy TMS_pullup = [ OFF | on ] 

===================
7. | CUPL Examples|
===================

Atmel-WinCUPL has several example file that you can try out to become familiar
with the syntax and capabilites of WinCUPL. The example files are installed
in the EXAMPLES subdirectory. The EXAMPLES.TXT included in this directory
also gives a description for all the examples.