All docs

EPROM Programmer

Flash your compiled ROM to a physical EPROM chip using a TL866 or compatible programmer, directly from the IDE.

Vectrex Studio can write your compiled .bin ROM directly to an EPROM chip without leaving the IDE. It uses the open-source minipro command-line tool under the hood, with a GUI wrapper that handles chip selection, programmer detection, and progress streaming.

Open the EPROM Programmer from the activity bar (chip icon) or from Tools → EPROM Programmer.

EPROM Programmer dialog — chip selector, programmer selector, operation buttons, and live log


Requirements

minipro

minipro is a free CLI tool for TL866-series programmers. The IDE can install it automatically:

  • macOS: click Install minipro in the dialog — runs brew install minipro internally.
  • Linux: click Install minipro — runs sudo apt-get install -y minipro.
  • Manual: follow the minipro installation guide.

When the dialog opens it checks whether minipro is on your PATH and shows a green indicator if found.

minipro detection indicator — green "minipro found" with version string

Hardware

Connect your programmer via USB before opening the dialog. Supported programmers:

ModelNotes
TL866II PlusRecommended — most common, widely available
TL866AOlder hardware revision
TL866CSOlder hardware revision
T48Newer model, broader chip support
T56High-end model

Chip Selection

Choose the target chip from the Chip dropdown. Common chips for Vectrex cartridges:

ChipCapacityNotes
27C25632 KBStandard single-bank Vectrex cartridge
27C51264 KBMultibank — requires bank-switching cartridge PCB
27C12816 KBSmall demos and tests
27C010128 KBLarger multibank projects
27C020256 KB
27C040512 KBMaximum supported by TL866II+

The IDE remembers your chip and programmer selection across sessions.


Operations

Write

Writes the current project's compiled .bin file to the chip. The IDE automatically uses the output path from your .vpyproj.

  1. Build your project first (Ctrl+F7) to make sure the .bin is up to date.
  2. Insert the chip into the programmer socket in the correct orientation.
  3. Select the chip and programmer, then click Write.

The log panel streams minipro output in real time. A green checkmark confirms success.

Write operation in progress — live log with minipro output, progress bar

Verify

Reads back the chip and compares it byte-for-byte against the .bin file. Run this after every write to confirm the chip programmed correctly.

Erase

Erases the chip to an all-0xFF blank state. Required before re-writing a chip that already contains data. Some chips support Erase First (see Advanced Options) which erases automatically as part of the Write operation.

Blank Check

Reads the chip and verifies it is blank (all bytes 0xFF) before writing. Useful to confirm an erase succeeded.


Advanced Options

Click Advanced to expand voltage and timing overrides. These are saved per chip.

OptionDescription
Skip ID checkSkip the chip ID verification step. Useful if minipro does not recognise a compatible clone chip.
Skip verifyDo not verify after writing. Faster but less safe.
Erase firstAutomatically erase before writing. Equivalent to running Erase then Write.
UnprotectRemove write protection before erasing (required for some SST and ATMEL flash chips).
Vpp / Vdd / VccOverride programming voltages. Leave at defaults unless you have a specific chip datasheet requirement.
PulseOverride the programming pulse width in microseconds.

Advanced options panel expanded — voltage and timing fields with default values

⚠️ Incorrect voltage overrides can permanently damage the chip or the programmer. Only change these if you know what you are doing and have the chip datasheet in front of you.


Typical Workflow

  1. Write your game in VPy and build: Ctrl+F7.
  2. Open the EPROM Programmer from the activity bar.
  3. Select chip (e.g. 27C256) and programmer (TL866II Plus).
  4. Click Erase, wait for completion.
  5. Click Write — the IDE writes build/yourgame.bin to the chip.
  6. Click Verify to confirm the write.
  7. Insert the chip into your Vectrex cartridge PCB and test on hardware.