Fork of the DuPAL-PAL-DUmper project. Original hardware and toolchain by the DuPAL-PAL-DUmper contributors. This repository adds a unified GUI, active learning (AALpy) integration, Pi Zero deployment support, and firmware extensions.

A workspace for dumping and reverse-engineering PALs, GALs, ROMs, and other combinatorial ICs using the DuPAL V3 "dupico" board (Raspberry Pi Pico / RP2040).

dupal/
├── dupico_firmware/   # C — RP2040 firmware for the dupico board
├── espresso-logic/    # C — Espresso heuristic logic minimizer
├── dupicolib/         # Python lib — serial comms with dupico
├── dpdumperlib/       # Python lib — shared dumper utilities
├── dpanalib/          # Python lib — shared analysis utilities
├── dpdumper/          # Python tool — dump combinatorial ICs
├── dppeeper/          # Python tool — visual IC analysis
├── dpdump2tab/        # Python tool — convert dumps to espresso truth tables
├── dupal_gui.py       # Python — unified Tkinter GUI for the whole workflow
└── projects/          # JSON project files (one per IC under test)

Firmware that runs on the Pico. Exposes a USB virtual serial port using a binary protocol. Must be flashed before using any of the host tools. See dupico_firmware/BUILD_AND_FLASH.md for full build and flash instructions.

Standalone C binary. Takes a truth table and produces a minimized sum-of-products expression. Used as the final step after dumping a combinatorial IC.

Python library. Handles the low-level binary protocol for communicating with the dupico over USB serial. Required by dpdumper and dppeeper.

Python library. Shared data structures and utilities for the dumping workflow. Required by dpdumper and dpdump2tab.

Python library. Shared analysis utilities. Required by dppeeper.

Python tool. Connects to a dupico and dumps basic combinatorial ICs. Outputs a dump file.

Python tool. Connects to a dupico and performs visual/interactive analysis of an IC's behavior.

Python tool. Converts a dpdumper dump file into an Espresso-compatible truth table, ready to pass to espresso-logic.

Unified Tkinter GUI that wraps the entire workflow in a single window. Run with:

python dupal_gui.py

Tabs:

Project files (projects/*.json):

Each project file stores a name, IC definition path, per-pin signal names, and notes. The project bar at the top of the window lets you create, edit, and switch between projects. Signal names from the active project are applied automatically in the Equations and JED tabs.

{
  "name": "GAL16V8 Gatter",
  "ic_def": "dpanalib/examples/GAL16V8.toml",
  "signals": { "1":"B", "2":"C", "19":"A", "18":"W", "17":"/X", "16":"Y", "15":"Z" },
  "notes": "W=A·B·C, /X=D·E (NAND), Y=F+G, Z=H·I+J·K"
}

JED→PLD device support:

The JED tab can generate a .pld source file from any of the following devices:

When multiple devices share the same QF (e.g. PAL16L8/R4/R6/R8 all have QF=2048), the first entry is used by default and the log shows which alternatives also match.

python dupal_gui.py
  │
  ├─ Connection tab  → select IC TOML, connect to dupico
  ├─ Dump tab        → run dpdumper → .bin dump file
  ├─ BIN→PLA tab     → run dpdump2tab → .pla truth table
  ├─ Espresso tab    → run espresso → minimized .pla
  └─ Equations tab   → display human-readable equations

python dupal_gui.py
  │
  ├─ Projects        → create project, assign signal names to pins
  ├─ Connection tab  → connect to dupico
  ├─ Dump tab        → dump PAL to .bin
  ├─ JED tab         → BIN→JED conversion
  ├─ JED tab         → JED→PLD (generates CUPL/GALasm source)
  └─ Equations tab   → display equations from the .jed file

IC in socket
    │
    ▼
dpdumper  ──────────────────► dump file
    │
    ▼
dpdump2tab ─────────────────► truth table (.pla)
    │
    ▼
espresso-logic ──────────────► minimized logic equations

For interactive analysis instead of a full dump:

IC in socket
    │
    ▼
dppeeper ───────────────────► visual pin-state analysis

cd E:\Dropbox\_Claude\dupal
build_all.bat

export PICO_SDK_PATH=~/pico-sdk
export FREERTOS_KERNEL_PATH=~/FreeRTOS-Kernel
export PATH="/c/msys64/mingw64/bin:/c/Users/Martin/AppData/Roaming/Python/Python314/Scripts:$PATH"

cd dupico_firmware
cmake -B build -S . -G Ninja
cmake --build build
# Output: build/src/dupico.uf2

export PATH="/c/msys64/mingw64/bin:$PATH"

cd espresso-logic/espresso-src
make
# Output: ../bin/espresso.exe

Install in dependency order (from the workspace root):

pip install -e dupicolib
pip install -e dpdumperlib
pip install -e dpanalib
pip install -e dpdumper
pip install -e dppeeper
pip install -e dpdump2tab

Executables (dpdumper.exe, dppeeper.exe, dpdump2tab.exe) are installed to C:/Users/Martin/AppData/Roaming/Python/Python314/Scripts/.