Software setup
Skip navigation Computer Systems & Organisation School of Computing Search query Search ANU web, staff & maps Search current site content Search Menu Search query Search ENGN2219/COMP6719 Lectures Labs Deliverables Resources Practice Search ANU web, staff & maps Search current site content ENGN2219/COMP6719 Lectures Labs Deliverables Resources Practice menu Search query Search Search ENGN2219/COMP6719 Search query Search Resources Assembler Guide Software setup Writing a design document QuAC ISA QuAC Extensions QuAC Instruction Description Related sites Piazza Streams Wattle SoCo Homepage You are here » Resources » Software setup Table of Contents Installation On a Lab Machine (CSIT or Hanna Neumann Labs) On a computer running Windows 64bit On a Mac On a computer running Linux (Your own computer, not a Lab Machine) Using VS Code Troubleshooting VS Code developer tools console OS Specific Problems [Windows] integrated terminal freezes [Windows] Git HTTP Basic authentication Failed In this course, we will use some additional software that will need to be installed on your personal device. Digital, a logic simulator. VS Code, an IDE for coding and debugging later in the course. Git, for downloading, and submitting, exercises and assessment items. Various other packages as required. Installation On a Lab Machine (CSIT or Hanna Neumann Labs) Open VS Code, then open the Extensions view, on the left side of your screen - it’s the button with this icon: Search for and install the ENGN2219 2022-S1 extension (engn2219-anu.engn2219-2022-s1-vscode). On a computer running Windows 64bit Download Digital. Unzip the file and run Digital.exe. If you have not got a working install of Java on your computer, Digital most likely will not run. You can install Java from here. Download & install Git. Git Bash will behave like a terminal on the lab machines and should let you do all the usual Git commands. Download & install make. Copy and paste the files in the zip to C:\Program Files\Git\mingw64\. Download VS Code from here. If you need a version other than the 64 bit windows installer, you can find it on their alternate downloads page. Open VS Code, then open the Extensions view, on the left side of your screen - it’s the button with this icon: Search for and install the ENGN2219 2022-S1 extension (engn2219-anu.engn2219-2022-s1-vscode). Open a terminal from the terminal menu at the top of VS Code. A terminal window will open at the bottom of your screen. In this terminal window, there will be a drop-down menu at the top-right. Choose “Select Default Profile”, and choose “Git Bash”. You’re ready to go! If things go wrong, check the Troubleshooting section further down this page. On a Mac Install XCode from the App store. Download Digital. Unzip the file and run Digital.jar. Download & install VS Code. You may need to hold the control key and click to install in order to bypass a software security check. Open VS Code, then open the Extensions view, on the left side of your screen - it’s the button with this icon: Search for and install the ENGN2219 2022-S1 extension (engn2219-anu.engn2219-2022-s1-vscode). If things go wrong, check the Troubleshooting section further down this page. On a computer running Linux (Your own computer, not a Lab Machine) These instructions are aimed at Ubuntu, but should work for any sensible Linux distro that’s up to date. If you’re using something other than Ubuntu, I trust that you know what you’re doing. If you need help, ask on Piazza. For Arch users: VS Code has an AUR package, so you don’t need to download a tarball. Ensure Git, Java, and other dependencies, are installed by running this command in the terminal: sudo apt install openjdk-17-jdk git Build-Essential
Download Digital. Unzip the file and run the appropriate script. Download & install VS Code. You’ll want to download the .deb file - Install the package once downloaded. Using another IDE is difficult - our assembler is a VSC extension. VSCodium is an option as well, as used on the lab machines. Open VS Code, then open the Extensions view, on the left side of your screen - it’s the button with this icon: Search for and install the ENGN2219 2022-S1 extension (engn2219-anu.engn2219-2022-s1-vscode). The rest of this page is information to help you if you get stuck with software issues. If you’ve just finished your initial software install, head back to lab 1 now. Using VS Code VS Code has good documentation. The lab material will link to specific parts of it where appropriate. Many settings can be changed to customize the appearance and behaviour of VS Code - feel free to set things up to your liking. Troubleshooting Here’s a list of issues you might come across, depending on the specific details of your machine. As always, be careful with copy-pasting random code you found on the internet (even in a university course!), and try to understand the problem first before you try the solutions listed. If new problems come up on Piazza, they will be added to this page once a solution is found. VS Code developer tools console Before you look at the specific problems, here’s a tip for getting the most useful error messages out of VS Code when things are going wrong. In command pallete, run the Developer: Toggle Developer Tools command and you’ll see a new pane pop up in VS Code. Switch to the Console tab (top-right of the screenshot) and you’ll see something like this: Keep this view open while you do the command which isn’t working for you, and it might output some error messages here (watch for red lines of text) which give you more detailed information about what’s going wrong. If the issue is not immediately obvious, now would be a good time to consult with a tutor or post on Piazza. OS Specific Problems [Windows] integrated terminal freezes On some Windows machine VS Code terminal tab freezes at start up. This happens irrespective of the shell selected. Because of this the debugger will not run. The cause of the problem is still unclear. There is no fix at the moment. [Windows] Git HTTP Basic authentication Failed Open the start menu, and search for Credential Manager. Select Windows Credentials, then search for git in the list of generic credentials. Either update your password or delete the entry to resolve the issue. Updated: 31 Mar 2022 / Responsible Officer: Director, School of Computing / Page Contact: Shoaib Akram Contact ANU Copyright Disclaimer Privacy Freedom of Information +61 2 6125 5111 The Australian National University, Canberra CRICOS Provider : 00120C ABN : 52 234 063 906 You appear to be using Internet Explorer 7, or have compatibility view turned on. Your browser is not supported by ANU web styles. » Learn how to fix this » Ignore this warning in future
