RetroCPLD Compiler
Version 0.0.1
Copyright (c) 2026 Retrotroniks

============================================================
ABOUT RETROCPLD
============================================================

RetroCPLD is a command-line logic compiler for classic programmable
logic devices.

RetroCPLD compiles source files written in the RetroCPLD language
(.rcpld) into JEDEC programming files (.jed) suitable for programming
supported CPLD and GAL devices.

Supported device families include:

    ATF1502AS / ATF1502ASV
    ATF1504AS
    GAL16V8
    GAL20V8
    GAL22V10


============================================================
LIMITED AND REGISTERED VERSIONS
============================================================

RetroCPLD may be used without a registration license in LIMITED mode.

LIMITED mode includes support for:

    ATF1502AS / ATF1502ASV
    GAL20V8B

Additional supported devices require a RetroCPLD registration license.

To check the current registration status:

    rcpld.exe --license-status


============================================================
BASIC USAGE
============================================================

Compile a RetroCPLD source file:

    rcpld.exe filename.rcpld

RetroCPLD parses the source, fits the design to the selected device,
and generates a JEDEC (.jed) file when compilation is successful.

Example:

    rcpld.exe example.rcpld


============================================================
LICENSE FILES
============================================================

To check the status of a specific registration license file:

    rcpld.exe --license license.lic --license-status

To compile using a specific registration license file:

    rcpld.exe --license license.lic filename.rcpld

To install a registration license:

    rcpld.exe --install-license license.lic

After installation, the license is automatically located by
RetroCPLD. The --license option is not normally required.


============================================================
COMMAND REFERENCE
============================================================

Show usage information:

    rcpld.exe

Check registration status:

    rcpld.exe --license-status

Compile a source file:

    rcpld.exe filename.rcpld

Use a specific license:

    rcpld.exe --license license.lic filename.rcpld

Check a specific license:

    rcpld.exe --license license.lic --license-status

Install a license:

    rcpld.exe --install-license license.lic


============================================================
SOURCE FILES
============================================================

RetroCPLD source files use the .rcpld extension.

A source file describes the target programmable logic device,
pin assignments, signal directions, and logic equations.

Example:

    DEVICE ATF1502AS

    PIN 5 DATA INPUT
    PIN 9 LED OUTPUT

    LED = DATA

Refer to the included examples and RetroCPLD documentation for the
complete language syntax and device-specific capabilities.


============================================================
OUTPUT FILES
============================================================

Successful compilation produces a JEDEC programming file with the
.jed extension.

For example:

    example.rcpld

produces:

    example.jed

The JEDEC file can then be loaded into a compatible device programmer.


============================================================
EXAMPLES
============================================================

The examples directory contains sample RetroCPLD source files for
supported programmable logic devices.

These examples can be used as starting points for new designs and
to verify that RetroCPLD is operating correctly on a new system.


============================================================
SYSTEM REQUIREMENTS
============================================================

This package contains the 64-bit Windows version of RetroCPLD.

No development environment is required to use the compiler.

Run RetroCPLD from Command Prompt, PowerShell, a batch file, or a
compatible development environment.


============================================================
IMPORTANT
============================================================

Always verify a compiled design before using it in hardware.

Incorrect pin assignments or logic equations may cause electrical
conflicts or damage connected hardware.

RetroCPLD and Retrotroniks are not affiliated with Microchip
Technology Inc., Atmel, Lattice Semiconductor, or other device
manufacturers.

Product names and trademarks belong to their respective owners.


============================================================
RETROTRONIKS
============================================================

RetroCPLD is developed by Retrotroniks.

Copyright (c) 2026 Retrotroniks.
All rights reserved.