CO Lab Manual
Course Page
  • Course Information
    • Welcome
    • Introduction
    • Your Contributions
    • Lab Sessions and Etiquette
    • Team Setup
    • Assumed Prior Knowledge
  • Setup Guides
    • GitHub Repository Setup
    • Technical Setup
      • Windows
      • Linux
      • macOS
    • GitHub SSH Setup
    • Framework Setup
  • Reference Documentation
    • Introduction to the Documentation
    • A Brief History Lesson
    • Syntax (Intel vs. AT&T)
      • Section Exercises
    • Memory
      • Memory Management
      • Section Exercises
    • Registers
      • Section Exercises
    • Instructions
    • Subroutines
      • Calling Subroutines
      • Writing Subroutines
      • Section Exercises
    • Input/Output
      • Printing to the Terminal
      • Reading from the Terminal
      • Section Exercises
    • Programming Constructs
    • Assembler Directives
    • C/C++ vs Assembly
    • Building and Running Programs
    • Address Sanitization
    • A0: A Running Example
  • Assignments
    • Introduction to the Assignments
    • Mandatory Assignments
      • A1: Subroutines and I/O
      • A2: Recursion
    • Extra Assignments
      • A3-a: Fibonacci Calculator
      • A3-b: Fibonacci REPL
      • A4: Diff
      • A5: Printf
      • A6: HPC
      • A7: Bitmap
      • A8: Game
  • Appendix
    • Acknowledgments
    • Rules and Regulations
    • Frequently Asked Questions
    • How to use a Debugger
Powered by GitBook
On this page
  • Install the Needed Extensions
  • Read the README
  • What Next?
  1. Setup Guides

Framework Setup

After you have finished all previous setup steps, you can finally start exploring the framework.

To do so, open a Terminal window and navigate (using the cd command) to the folder of the framework that you have cloned from your GitHub repository (remember to use the WSL terminal if you are on Windows). If you have not given a different name as part of the clone command, the folder should have the same name as your repository.

If you are unsure what directory your terminal window is currently in, you can always use the pwd command to print the working directory.

You can furthermore use the ls command to list all files and folders in the current directory.

Once you are inside the folder of the framework, use the code . command to open VS Code in the current directory.

If you have done everything correctly, the Explorer panel of VS Code should show the folders for all assignments, as well as a .vscode folder and some other files.


Install the Needed Extensions

To use the framework with all its features, you will need to install some extensions. Upon first opening the framework in VS Code, a prompt should appear in the bottom right corner asking whether you want to install the recommended extensions. If the prompt did not appear or you have accidentally dismissed it, simply follow these steps:

  1. Open the "Extensions" panel ("View" → "Extensions" | ⇧⌘X | Ctrl + Shift + X)

  2. Type "@recommended" in the search bar.

  3. Install all (4) extensions that are listed.


Read the README

To acclimate yourself to the given framework, its structure, and the way(s) of using it, start by thoroughly reading the README.md file.

Hint: Once you have opened the README.md file in VS Code, press ⌘⇧V (macOS) or Ctrl + Shift + V (Linux/Windows) to get a nicely rendered view of the markdown file.


What Next?

Even though you have already gone through quite a bit of reading/setup/other boring things, you are (likely) not quite at the point where you can start coding yet. The next part of this Manual is the so-called Reference Documentation.

This documentation is essentially a somewhat concise summary of all the concepts that you need to know to successfully solve the assignments. While you are free to go straight to the assignments, it is highly recommended to at least skim through the documentation first - it is highly likely that it will save you some hours of frustration with the assignments.

PreviousGitHub SSH SetupNextIntroduction to the Documentation

Last updated 8 months ago