To obtain the latest source of Vircon32 for both the emulator and DevTools, navigate to the Vircon32 homepage where there are links to the emulator and DevTools under the source code download.

The source code (source.tar.gz) is a bit of a maze to find. From the Vircon32 home page, go to the Emulator Page under the Software header on the left, which should take you to a GitHub page. Click on <> Code to head to the root directory, then click on Releases on the right. Scroll down a bit until you find the source code file and download that.

Another option to get the source code of different repositories onto your pi is to clone it from the Vircon32 github page. Once on the page, click on the repository you want to clone and copy its url. On your pi terminal go to the location you want to put the repository in and clone it from github using “git clone url_of_repository”. For this project you will want the computer software repository to make the emulator and dev tools from them. The documents and console software repositories can also include helpful information.

Open your terminal, navigate to where your file was saved (Most likely Downloads) and proceed to extract it.

You now have a directory of the same name as that archived file, cd into it and read the Readme.md

Following the Readme.md install the needed dependencies and create the appropriate directories.

To begin you will want to start with either the DevelopmentTools or Emulator

cd into 1 of those two directories and

mkdir build

It may be helpful to have the Readme available while you're in the build directory, start by installing cmake if it's not already installed and perform step 2 in the Readme as indicated. To install cmake, and any other dependencies you may need for Vircon32, use:

sudo apt install [library]

You should receive an error saying MSYS Makefiles don't exist and you'll be given a list of options to use. Use the Unix Makefiles and repeat.

You'll now get an error about not having a file called CMakeLists.txt Find that file and copy it into builds, although as long as CMakeLists.txt is in the same directory as the builds directory (DesktopEmulator or DevelopmentTools), it should work fine.

Keep trying to run command #3 in the Readme, it'll likely need further dependencies before it can get through without experiencing an error. The dependencies needed are listed at the bottom of the Readme. Use the following command to search for the necessary libraries, those library names should be all lowercase when searched.

aptitude search [Dependency]

You'll likely be given a bunch of libraries when running this command, look for one that resembles the closest to what was listed in the Readme, and ends in _dev. Install it using the command format given above. You are (or will be) a developer in this class, you'll need these libraries installed moving forward. When you test out command #3 from the Readme again, you'll know it worked if you don't get the error for that specific dependency.

Replicate section per system/OS you are building for

• Step 1: On your Pi or virtual machine, go into your local Lab46 repo and cd either into your Data or Discrete directory.
• Once in the directory, do

  mkdir btt0

  and cd into it.

• Once in btt0 directory, you'll need to create 3 files, hello.c, hello.xml, and make.sh.
• Once created, go to

  https://github.com/vircon32/ConsoleSoftware/tree/main/Tutorials/RobotGame/Tutorial01A-HelloWorld

• Copy the contents of each file from GitHub into their respective files in your btt0 directory.
• Make sure to go into each file and adjust the names of files as we have changed them compared to what is listed on GitHub.