RetroCPLD Compiler
Version 0.0.1 - Linux x86-64
Copyright (c) 2026 Retrotroniks

ABOUT
=====

RetroCPLD is a command-line logic compiler for classic programmable logic
devices. It compiles RetroCPLD source files (.rcpld) into JEDEC programming
files (.jed).

Supported device families:

    ATF1502AS / ATF1502ASV
    ATF1504AS / ATF1504ASV
    GAL16V8B
    GAL20V8B
    GAL22V10B

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

Without a registration license, LIMITED mode supports ATF1502AS/ATF1502ASV
and GAL20V8B. Other supported devices require a RetroCPLD registration
license.

RUNNING RETROCPLD
=================

The included rcpld executable is a native, statically linked Linux x86-64
binary. Make it executable if required:

    chmod +x rcpld

Compile a design:

    ./rcpld filename.rcpld

Check registration status:

    ./rcpld --license-status

Use a specific license file:

    ./rcpld --license license.lic filename.rcpld

Install a registration license:

    ./rcpld --install-license license.lic

Installed licenses are stored at:

    $HOME/.retrocpld/license.lic

The RETROCPLD_LICENSE_FILE and RETROCPLD_LICENSE_HOME environment variables
may override the normal license locations.

INSTALLATION
============

RetroCPLD can be run directly from its extracted folder. To make it available
for every terminal command, install it in /usr/local/bin:

    sudo install -m 755 rcpld /usr/local/bin/rcpld

Then compile a source file from any directory with:

    rcpld filename.rcpld

OUTPUT
======

A successful compilation writes a .jed file beside the input file. 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.

