This is an old revision of the document!
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.
Instructions on how to log into Lab46 via shell can be found here.
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.
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.
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.
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.