Setup

All of the programming assignments in this course have been developed for Linux. We will officially support two methods of development: CAEN Linux Remote Login Server (Red Hat Enterprise Linux 8.10 Ootpa) and the MBot (Debian GNU/Linux 12 Bookworm).

The instructions for using the CAEN Linux Remote Login Service via SSH can be found here.

In this course, we advise you to set up the VS Code Remote extension to be used with the CAEN Linux Remote Login Service so that you can develop with an IDE in a Linux environment at your convenience.

To set up this workflow, first install Visual Studio Code if you have not already, and then install the Remote Explorer and Remote - SSH VS Code extensions.
Navigate to the Remote Explorer extension tab on the left side of the VS Code browser. Click the settings wheel to open the SSH config file.
Copy the following into the file. Replace [UNIQNAME] with your uniqname. To avoid issues with connecting to the CAEN server, any configuration that you have in this file that would attempt to auto-fill your password should be removed.
```
Host oncampus-course.engin.umich.edu
  HostName oncampus-course.engin.umich.edu
  User [UNIQNAME]
```
Open the Command Pallette by pressing ctrl/cmd + shift + p. Search “Remote” and open the Remote-SSH: Settings.
Scroll down towards the bottom of the settings and ensure that the Show Login Terminal is toggled on and the Use Local Server option is toggled off.
Close out of the Command Palette and navigate back to the Remote Explorer window. You can choose to open the remote window in the current VS Code window (arrow icon) or a new window (folder icon). Select one.
You should see a prompt for your password and two factor authentication. Enter your password and choose an option to authenticate with your device.
If successful, VS Code should now connect to the CAEN Linux Remote Login Server. You can choose to open a folder and navigate through the directory. When selecting a folder, VS Code may prompt you again for your password and 2FA. Follow steps 7 and 8 if this occurs.
This guide is only for the on campus connection. If you are working from an off-campus network, do this guide again but replace oncampus-course.engin.umich.edu with login-course.engin.umich.edu.

MBot Setup

You can use VS Code Remote to develop on the MBots as well.

Click on the + button in the Remote Explorer window.
Find the IP address of the MBot. It should display on the OLED after turning the battery on. Enter ssh mbot@[IP ADDRESS] and the password once prompted.
You can now open a folder, clone your repository, and develop your assignments with the VS Code IDE on the MBot.