User Tools

Site Tools


notes:c4eng:fall2023:projects:abc0

This is an old revision of the document!


ABC0 documentation

Tasks

Get on discord and into class channels

Join the Discord, invite found towards the top of the syllabus located here. You may create a new account or join with an existing one. Once you've joined, introduce yourself with your name, and what classes you're taking so that appropriate roles can be assigned, granting you access to the class channels.

Log into Lab46 (shell)

Instructions on how to log into Lab46 via shell can be found here.

Clone lab46 semester repo on lab46

After you've logged into lab46 via shell, we'll be using Mercurial to clone a remote repository. This is done with the command:

 hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER ~/src 

Where uppercase USER is replaced with your lab46 username, and lowercase user remains unchanged.

This will clone the repository into a directory named src that is a subdirectory of your home (~) directory.

We will also be cloning a second repository for the semester, done with the command:

 hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER/SEMESTER ~/src/SEMESTER

Where SEMESTER is your semester written as the name of the month in lowercase and then the year in YYYY format, without spaces, e.g. fall2023.

Log into Lab46 wiki

At the top right of any lab46.g7n.org page should be a button to log in, shown here:

The username and password should be the same as the username and password you used to log into Lab46 via shell in previous steps.

Set up personal development system

Your personal development system will be the Raspberry Pi 4, a link to which will be in the class syllabus, in the “Referenced Books” section. Instructions on how to set up should be included in the purchased kit.

Clone lab46 semester repo on your system

The steps here are very similar to the steps in the section “Clone lab46 semester repo on lab46”; however, assuming your development system has just been set up with Raspberry Pi OS, then Mercurial is not yet installed. Luckily, this is easy on most UNIX-like operating systems. Simply open your terminal, which should be located at the top of the desktop, and type hg. Once you enter that command, you should be prompted to install Mercurial. Once Mercurial is installed, you may proceed. You should start by creating a directory anywhere you'd like, using the mkdir command, i.e.

 mkdir NAME 

Where NAME is the name you'd like to give the directory.

After making this organizational directory, we will now clone the repo. To do so, we'll use Mercurial's hg clone command again, into a new src directory under our directory, like so:

hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER /NAME/src 

Where NAME is the name you gave the directory, and you are currently in its parent directory.

Once that is done, we'll clone the semester repo:

hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER/SEMESTER /NAME/src/SEMESTER

Recall that SEMESTER is the lowercase name of the month and the year in YYYY format, without spaces. e.g. fall2023

Let's enter the SEMESTER directory using cd, as such:

cd /NAME/src/SEMESTER

From here we'll create a class directory with the name of the class, e.g. c4eng, and a subdirectory of it for our project abc0:

mkdir -p c4eng/abc0

This is where we'll put our project files coming up in the next steps.

Create info.text file with information

Create and execute hello.c

Locate journal and customize title and intro

notes/c4eng/fall2023/projects/abc0.1692473047.txt.gz · Last modified: 2023/08/19 19:24 by mwinter4