Menu

Theme

Tools · Tool · CHECKED ON 5.0.0

Logisim load image: make a memory image file Logisim will load

Logisim loads memory only from files whose first line is a format header such as v2.0 raw or v3.0 hex words plain; a plain list of hex numbers is rejected with Hex file header not recognized. Paste your data below, set the ROM's address and data width, and download a file that loads in Logisim-evolution 5.0.0. Then right-click the ROM or RAM and choose Load Image, or use --load on the command line.
FOR
CPU builders and lookup-table labs
CHECKED
11 Nov 2026

Memory image generator and checker

Copy these two from the ROM's attribute table. That is 256 words of 8 bits.

Image ready: 10 words, format v2.0 raw.
v2.0 raw
11 22 33 44 37 42 4d 58
aa bb
Decoded words (first 64)
AddressValue
0x0011
0x0122
0x0233
0x0344
0x0437
0x0542
0x064d
0x0758
0x08aa
0x09bb
0x0a00
0x0b00
0x0c00
0x0d00
0x0e00
0x0f00
0x1000
0x1100
0x1200
0x1300
0x1400
0x1500
0x1600
0x1700
0x1800
0x1900
0x1a00
0x1b00
0x1c00
0x1d00
0x1e00
0x1f00
0x2000
0x2100
0x2200
0x2300
0x2400
0x2500
0x2600
0x2700
0x2800
0x2900
0x2a00
0x2b00
0x2c00
0x2d00
0x2e00
0x2f00
0x3000
0x3100
0x3200
0x3300
0x3400
0x3500
0x3600
0x3700
0x3800
0x3900
0x3a00
0x3b00
0x3c00
0x3d00
0x3e00
0x3f00

Nothing you type leaves your browser.

The formats Logisim accepts

The first four rows are the formats this tool writes. All four loaded in our tests (F14). The others are formats the window may offer; we did not test them.

### v2.0 rawWORKS Hex words separated by spaces. A run of equal words can be written 4*aa. F14
file
v2.0 raw
11 22 33 44 55 66 77 88
99 aa bb cc dd ee ff 0
### v2.0 raw (run-length)WORKS The same header with count*value groups. F14
file
v2.0 raw
4*aa 2*bb cc
### v3.0 hex words plainWORKS One hex word per entry, in order. F14
file
v3.0 hex words plain
11 22 33 44 55 66 77 88 99 aa bb cc dd ee ff 00
### v3.0 hex words addressedWORKS Lines that start with a word address and a colon. Gaps become 0. F14
file
v3.0 hex words addressed
0: 11 22 33 44
8: 99 aa
### v3.0 hex bytes plainWORKS Bytes written as pairs of digits with no separator. F14
file
v3.0 hex bytes plain
1122334455667788
### v3.0 hex bytes addressed and endian variantsUNTESTED Not tested.
### Binary and ASCII importsUNTESTED Not tested.

Why your ROM is empty or wrong

### noheader.txt
file
11 22 33 44
Hex file header not recognized
The memory stays empty (reads 0). Fix: Add a header line such as v2.0 raw. F15
### hex0x.txt
file
0x11 0x22 0x33
Hex file header not recognized
A plain list of 0x values is rejected for the same reason. Fix: Add the header and drop the 0x prefixes. F15
### bad.txt
file
v2.0 raw
11 22 zz 44
Line 2: "zz" is not valid hex data.
That word becomes 0; the rest load. Fix: Fix the token on the line named. F15
### toowide.txt
file
v2.0 raw
100 22
(no message)
100 into an 8-bit ROM is cut to 00 with no warning. Fix: Check widths before you load. F15

Words wider than 8 bits

Set Data Bit Width to the word size and write one hex word per entry (for example 32 bits, eight hex digits). The generator accepts 1 to 64 bits. We tested a 32-bit ROM file and a 64-bit one read back correctly; we did not test endianness of the bytes format in the window.

Addressed means word addresses

In v3.0 hex words addressed, 8: 99 aa puts 99 at word 8, not at byte 8, and skipped words become 0 (F14).

The ROM reads zeros in a command-line truth table

--load is ignored by --tty table when the circuit has no halt pin, because the table is computed before memories are loaded (F13). Use a clocked circuit with a halt pin, or store the contents in the file with the ROM download above (F12).

Load the file in Logisim

In the window, right-click the ROM or RAM and choose Load Image. We did not capture that dialog. On the command line, put the circuit first, then the option (F16):

Terminal
java -jar logisim-evolution-5.0.0-all.jar --tty halt cpu.circ --load program.txt

For command-line use see command line; for the component see ROM and RAM. ROM contents are saved inside the .circ file; RAM contents loaded in the window are not saved with it.

What the tool does not do yet

CSV, binary files and the 7-segment preset are not in this version, and nor are the addressed bytes format and the endian variants. Intel HEX and S-record files are not read.

Sources

  1. Memory image loading tests on Logisim-evolution 5.0.0, logisim.dev lab data: test-data/lab1-2026-11-09-linux-local/logs/rom-load-*.txt, scripts/qa_memimage.mjs

Try: , , ,