Save and open correctly
Use File, Save (CtrlS⌘S (⌘S on macOS)), File, Save As (CtrlShiftS⌘⇧S (⌘⇧S on macOS)) and File, Open (CtrlO⌘O (⌘O on macOS)), or File, Open Recent. One file holds all of a project’s circuits.
The File menu also has Export project bundle and Extract and open project bundle (F46). We did not test them.
Which version made this file?
Open the file in a text editor. The second line is the project element, and its source attribute holds the version that saved it, for example source="5.0.0" or source="2.7.1". The format version, version="1.0", stays the same.
Inside a .circ file
The top of our own 5.0.0 half-adder file:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project source="5.0.0" version="1.0">
This file is intended to be loaded by Logisim-evolution v5.0.0(https://github.com/logisim-evolution/).
<lib desc="#Wiring" name="0"/>
<lib desc="#Gates" name="1"/>
<lib desc="#Plexers" name="2"/>
...
<main name="main"/>
<options>
<a name="gateUndefined" val="ignore"/>
<a name="simlimit" val="1000"/>
<a name="simrand" val="0"/>
</options>
<mappings/>
<toolbar> ... </toolbar>
<circuit name="main"> ... </circuit>
</project>
In order:
- An XML declaration.
- The
projectelement withsource(the version that saved the file) andversion(the format version). - A free-text line naming the program the file is for.
- One
libelement per library. Built-in libraries have adescstarting with#, such as#Wiringor#Gates; thenamenumber is what components use to say which library they come from. A loaded.circor.jarlibrary shows a file path. main: which circuit is the main one.options: the project’s simulation options. 5.0.0 files recordsimlimit(1,000) andsimrand; our classic files usesim_limit.mappingsandtoolbar: keyboard mappings and the toolbar. A file with an empty toolbar opens with no tool buttons (F83).- One
circuitelement per circuit, withcompentries (library number, location, component name andaattribute pairs) andwireentries (from and to). - ROM contents are stored in a
contentsattribute (F12, see ROM).
Compatibility between versions
| Feature | Opened in 2.7.1 | Opened in 3.8.0 | Opened in 4.1.0 | Opened in 5.0.0 |
|---|---|---|---|---|
| Saved by 2.7.1 | Opened in 2.7.1: yesits own files | Opened in 3.8.0: untested | Opened in 4.1.0: untested | Opened in 5.0.0: partialopens with an Old file format warning; labels converted to VHDL-safe names (F02) |
| Saved by 3.8.0 or 4.1.0 | Opened in 2.7.1: untested | Opened in 3.8.0: untested | Opened in 4.1.0: untested | Opened in 5.0.0: untested |
| Saved by 5.0.0 | Opened in 2.7.1: nobuilt-in library FPArithmetic is not available (F04) | Opened in 3.8.0: yesfour basic-component files gave correct tables (F68) | Opened in 4.1.0: yesfour basic-component files gave correct tables (F68) | Opened in 5.0.0: yesgrey until a click or Ctrl+R (F45) |
Saved by 2.7.1
- Opened in 2.7.1yesits own files
- Opened in 3.8.0untested
- Opened in 4.1.0untested
- Opened in 5.0.0partialopens with an Old file format warning; labels converted to VHDL-safe names (F02)
Saved by 3.8.0 or 4.1.0
- Opened in 2.7.1untested
- Opened in 3.8.0untested
- Opened in 4.1.0untested
- Opened in 5.0.0untested
Saved by 5.0.0
- Opened in 2.7.1nobuilt-in library FPArithmetic is not available (F04)
- Opened in 3.8.0yesfour basic-component files gave correct tables (F68)
- Opened in 4.1.0yesfour basic-component files gave correct tables (F68)
- Opened in 5.0.0yesgrey until a click or Ctrl+R (F45)
The 3.8.0 and 4.1.0 results cover files that use only basic components. Files with parts new in 5.0.0 were not tested. Cells say untested where we did not run the combination.
What changes when 5.0.0 opens an old file
Labels are converted to names that are valid in VHDL (F02). The project’s notes say a 4.0.0 change to pin Type and Behavior can affect floating inputs, and that a 5.0.0 change affects RAM line enables; we did not test either.
Online and other tools
We did not test opening a 5.0.0 file in the online version of classic Logisim. It is expected to fail as 2.7.1 does. See Logisim online.
Convert a file to the current format
Open the old file in 5.0.0 and use Save As with a new name. Never overwrite the original. From the command line, --new-file-format in.circ out.circ converts a file, with three caveats: it needs a display, it stops at the compatibility dialog until it is dismissed, and it did not exit after writing in our test (F18). There is no safe way to convert from Evolution back to 2.7.1: rebuild the circuit, or use the version your course asks for (which version).
My .circ will not open
The built-in library FPArithmetic is not available in this version.A file from 5.0.0 opened in 2.7.1: open it in Logisim-evolution instead (F04).
XML formatting error: …The file is not a Logisim file. A browser download saved under a .circ name is a common cause; open it in a text editor and see whether it starts with an HTML tag.
The required library file ‘…’ is missing. Please select the file from the following dialog.A library file moved. See Libraries. For anything else, look the message up in the error list.