1. Overview

Lab 3 requires you to use a graphical tool called Logisim to complete the assignment. You will get the best performance if you install this free tool on your personal computer. This page outlines the steps necessary to install Logisim. Once installed, you will be able to use Logisim for the next two weeks to complete the lab assignments.

2. Install Java

Logisim is a Java application and you will need the latest version of Java to run the program. Go to https://www.java.com/download/ to get Java version 8 for your platform. Follow the instructions provided to install the Java JDK package. This may take a little while to download over a slow connection. It is recommended that you reboot your computer after completing this step and prior to installing Logisim.

3. Install Logisim

Go to https://logisim.altervista.org/ to download the Logisim package. Scroll to the bottom of the page and click on the appropriate extension button first. Windows users can click on the EXE extension. Other platforms (Mac OSX and Linux) should select JAR. The filename will show just above the DOWNLOAD button. Click on the DOWNLOAD button to save the file to a location you can find easily, e.g., your desktop or home directory.

4. Running Logisim

On both Windows and Linux, you should be able to start Logisim by double clicking on either the exe file in Windows or the jar file in OSX. On OSX, you can also navigate to the path containing the .jar file in the terminal application and run

java -jar Logisim-ITA.jar

To open a specific file, you can navigate to the File→Open menu in Logisim or run

java -jar Logisim-ITA.jar firstcircuit.circ

to open the file firstcircuit.circ directly from the command line.

5. Troubleshooting

  • You may need to reboot your computer after installing the Java JDK prior to installing Logisim. If Logisim does not work after downloading and installing Java, please try rebooting your computer.

  • If you get an error on OSX saying the jar cannot be opened because it is from an unidentified developer, try going to menu→system preferences→security & privacy settings. Click on the General tab at the top. At the bottom of the page, you should see a notice that the installation was blocked, and a button to "Open Anyway." Click this button.

OSX Security Pane

  • Some OSX users are reporting they cannot open .circ files that are in their Downloads or Documents folders. You can create a separate subdirectory in your home folder through the Mac Finder application, or use the terminal. When using the terminal commands below, you do not need to run ssh. These commands will be run locally on your personal computer, not on the CS machines.

    cd
mkdir cs31
cd cs31
ls #should be empty the first time

    When you download a .circ file from GitHub, either save it to your cs31 folder, or move it there after downloading. Again, you can use the Mac Finder app, or the terminal.

    cd ~/cs31
mv ~/Downloads/firstcircuit.circ ./
ls #should show your .circ files here

  • Some Windows users are reporting text scaling issues where the text can appear too small on high resolution screens. You can try the following steps to fix this.

    1. Find the Logisim.exe file

    2. Right Click → select Properties

    3. Go to the Compatibility Tab

    4. Click Change High DPI settings

    5. Check Override High DPI Scaling Behavior Box

    6. Select System from the dropdown

    7. Click OK a few times

    8. Try the application again