HSDES-LAB1: Basics of Embedded Programming on PULP

Environment setup

The target device for the lab sessions is the multi-core PULP platform. The PULP Virtual Platform simulator GVSOC, which is included within the PULP SDK, will be used during the class. The execution environment for this class is distributed as a Docker container available in Docker Hub for both x86_64 (Intel / AMD based machines) and arm64 devices (Apple M-series processors, other devices using Qualcomm SoCs). The same setup will be used also in the other lab sessions.

Recommended setup: Docker + VSCode + Dev Container

1. Install Docker. You can follow instructions here Docker Desktop (for Windows/macOS) and Docker Engine (for Linux distros).
2. Install Visual Studio Code
3. Open Visual Studio Code, then through the Extensions tab look for the Dev Containers extension.
4. Open this folder (HSDES-LAB01-PULP_Embedded_Programming) from Visual Studio Code. VSCode will ask you (bottom-right corner) to "Reopen in Container": select yes. The required setup should be automatically downloaded (~1.2GiB).
5. The Visual Studio Code terminal on the bottom will use an already configured workspace. The lab folder will be mounted under /workspaces.

Alternate setup: Docker + Own editor

1. Install Docker. You can follow instructions here Docker Desktop and Docker Engine for Linux distros.
2. Open a terminal. You can pull the Docker container with the following command:

docker pull fconti/hsdes-container

3. Enter the folder of this lab session, and run the following to enter the container shell.

docker run --rm -it -v "$(pwd)":/workspaces -w /workspaces fconti/hsdes-container

4. The Docker terminal that is opened will contain an already configured workspace. The lab folder will be mounted under /workspaces.