Integrating VS Code, Conda, and Multi-Language Toolchains

This guide explains how to install and configure the standard development environment used in this course. The environment is based on:

Miniconda
Visual Studio Code
Jupyter Notebook
Python 3.12
C/C++ external compiler
Verilog simulator (Icarus Verilog)

To ensure all students use the same software environment, we provide an environment.yml file. Using this file lets Conda automatically install all required packages with a single command.

1. Introduction: A Modern Engineering Workflow

Introduction: A Modern Engineering Workflow

To succeed in digital systems and software engineering, you need a workspace that is both powerful and organized. Our course utilizes a "Triple-Threat" toolchain: Visual Studio Code, Conda, and Jupyter Notebooks.

What is Visual Studio Code (VS Code)?

1. What is Visual Studio Code (VS Code)?

Visual Studio Code is a lightweight but extremely powerful source-code editor. It is the industry standard for modern developers.

Why use it? Unlike heavy IDEs, VS Code is fast and highly customizable. With its vast library of Extensions, it can be transformed from a simple text editor into a full-featured development suite for Python, C/C++, and Verilog simultaneously.

What is Jupyter Notebook?

What is Conda?

How VSC + Conda + Python Help You Learn C/C++ and Verilog

2. Step-by-Step Installation & Environment Setup

Install the Core Software
Before running any commands, ensure you have the following installed on your Windows 11 machine:
- Miniconda: Download for Windows. (Choose the latest Miniconda installer Windows-x86_64 version).
  - Go to the Miniconda Download Page.
  - Select the Miniconda3 Windows 64-bit installer. (Do not download "Anaconda Distribution".)
  - Recommended installation options:
    - Install Location: C:\BAT\Python\miniconda3
    - ✔ Just Me
    - ✔ Register Miniconda as the default Python
    - ✘ Do NOT add Miniconda to PATH (conda init will handle this)
- Visual Studio Code (VSC): Download for Windows. (Download the System Installer x64)

Understanding the Conda Prompts

Advanced Setup: Custom Environment Location

By default, Conda stores environments inside your User folder. To keep your system organized, we will redirect Conda to store all environment files in a specific folder (e.g., C:\BAT\Python\Miniconda_Envs).

Step 1: Set "Run as Administrator"

Because you are creating folders on the C: drive, you need elevated permissions to run the prompts.

Click the Start Menu and search for Anaconda Prompt.
Right-click it and select Open file location.
In the folder that opens, right-click the shortcut, select Properties, and go to the Shortcut tab.
Click Advanced... and check the box: [x] Run as administrator.
Repeat this for the Anaconda PowerShell Prompt.

Step 2: Configure the Custom Environment Folder (Optional but Recommended)

Open your Anaconda Prompt (Admin) and run the following commands to redirect your installations:

# Create the physical folder first
mkdir C:\BAT\Python\Miniconda_Envs

# Add the folder to Conda's configuration
conda config --add envs_dirs C:\BAT\Python\Miniconda_Envs

Verify the Configuration:

To ensure Conda is now pointing to your custom directory, run:

conda config --show envs_dirs

Expected Output:

You should see C:\BAT\Python\Miniconda_Envs at the top of the list. Now, any conda create command you run will automatically install the environment into that specific folder.

Step 3: Configure Package Cache (Recommended)

To prevent the miniconda3 directory from becoming very large, it is recommended to store package caches separately.

# Create the cache directory
mkdir C:\BAT\Python\Miniconda_pkgs

# Configure Conda to use this directory
conda config --add pkgs_dirs C:\BAT\Python\Miniconda_pkgs

Verify the configuration:

conda config --show pkgs_dirs

Expected result:

pkgs_dirs: - C:\BAT\Python\Miniconda_pkgs - C:\BAT\Python\miniconda3\pkgs

This configuration keeps the base installation clean and stores downloaded packages separately.

Create the Teaching Environment Using environment.yml:
Download the provided file: environment.yml

Place it in your working directory (for example):

C:\AirSupplyLab

Open Anaconda Prompt and navigate to that folder:
```
cd C:\AirSupplyLab
```
Create the environment using:
```
conda env create -f environment.yml
```
This command will automatically install all required packages, including:
- Python 3.12
- Jupyter Notebook
- JupyterLab
- NumPy
- Pandas
- Matplotlib
- Icarus Verilog
- Development utilities
Activate the Environment:
```
conda activate py312_vsc_base
```
Verify the Python version:
```
python --version
```
Expected output:

Python 3.12.x
Install Required VS Code Extensions:
Open the Extensions panel in VS Code. Install the following extensions:
- Python (ms-python.python)
- Jupyter (ms-toolsai.jupyter)
- Pylance (ms-python.vscode-pylance)
- Black Formatter
- C/C++ (ms-vscode.cpptools)
- Verilog HDL (mshr-h.veriloghdl)
- Error Lens
These extensions provide Python support, notebook integration, C/C++ syntax highlighting, Verilog editing tools, and improved diagnostics.
Select the Python Kernel:
Open a Jupyter Notebook (.ipynb file) in VS Code. Select the kernel at the top-right corner:
```
py312_vsc_base (Python 3.12)
```

Verify the Installation Using Jupyter Notebook:

Create a notebook named:

verify_installation.ipynb

Verify Python:

import sys
print("Python version:", sys.version)

Verify Scientific Libraries:

import numpy
import pandas
import matplotlib

print("Scientific libraries loaded successfully.")

Verify Jupyter:

import IPython
print("IPython version:", IPython.__version__)

Verify Verilog Simulator:

!iverilog -V

If the version information is displayed, the Verilog simulator is installed correctly.

Environment Setup Complete:

If all cells run successfully, your development environment is ready.

You can now begin programming assignments using:

Python
C / C++
Verilog HDL
Jupyter Notebook

All labs and homework in this course will use this standardized environment.

3. Conda Commands

Python Environment Management: A Professional Guide

By utilizing the following commands, you can efficiently create, manage, and toggle between isolated Python environments on Windows 11 without compromising your core system configuration. This approach ensures a stable and professional development workflow.

1. Core Environment Management

Always execute these commands via the Miniconda Prompt (available in your Start Menu) to ensure the correct pathing and permissions.

Action	Command Example	Description
Create Environment	`conda create -n py312_vsc_base python=3.12`	Creates an isolated environment named py312_vsc_base with Python 3.12.
List Environments	`conda env list`	Displays all existing environments and their installation directories.
Activate Environment	`conda activate py312_vsc_base`	Switches your current session to the specified environment.
Deactivate Environment	`conda deactivate`	Exits the current environment and returns to the base system environment.
Remove Environment	`conda remove -n py312_vsc_base --all`	Permanently deletes the environment and all its associated packages.

2. Package Installation & Maintenance

Once an environment is activated, use the following methods to manage your libraries:

Conda (Recommended Strategy):
conda install numpy pandas
Advantage: Conda automatically resolves complex dependencies to prevent version conflicts.
Pip (Alternative):
pip install requests
Advantage: Use Pip for niche libraries not found in the Conda channels.

3. The "Golden Configuration" for VS Code

VS Code serves as the primary gateway for your toolchain. Follow these steps to ensure seamless integration:

Extension Requirement: Install the official Python Extension by Microsoft from the VS Code Marketplace.
Automatic Detection: After creating a new environment in Miniconda, restart VS Code; it should automatically detect the new path.
Manual Interpretation Selection:
- Press Ctrl + Shift + P.
- Search for "Python: Select Interpreter".
- Choose your specific environment (e.g., 'py312_vsc_base': conda).

Result: The selected environment will be displayed in the VS Code status bar (bottom-right). The integrated terminal will automatically trigger conda activate upon launch.

Case Study: Setting up an Engineering Project

If a specific hardware project requires a legacy Python version (e.g., 3.9):

Launch Miniconda Prompt.
Execute conda create -n digital_logic python=3.9.
Execute conda activate digital_logic.
Install necessary tools: conda install iverilog m2w64-gcc -c conda-forge.
Open the project in VS Code and select digital_logic as your active interpreter.

Pro-Tip: Assign descriptive names to your environments (e.g., embedded_systems or computer_org). This is much more intuitive than using generic version numbers.

Bonus: Create a "One-Click" Course Desktop Shortcut

To save time, you can create a desktop shortcut that automatically launches VS Code with your py312_vsc_base environment pre-activated. This prevents you from having to manually toggle environments every time you start a lab.

Setup Instructions:

Create a New Shortcut: Right-click on your Desktop → New → Shortcut.
Enter the Target Path: Copy and paste the following command into the location box (adjust the username if necessary):
%windir%\System32\cmd.exe /K "conda activate py312_vsc_base && code ."
Name the Shortcut: Name it "VS Code - EE Course" or "EE Lab Workstation".
Change the Icon (Optional): Right-click the new shortcut → Properties → Change Icon.... Browse to the location where VS Code is installed (usually %LocalAppData%\Programs\Microsoft VS Code\Code.exe) to use the official VS Code icon.

How it works: This shortcut opens the Windows Command Prompt, tells Conda to activate your specific engineering environment, and then launches VS Code within that context. This is the most reliable way to ensure all C/C++ and Verilog paths are correctly loaded.

Feature	Anaconda Prompt	Anaconda PowerShell Prompt
Engine	Standard Windows Command Prompt (cmd.exe)	Windows PowerShell (pwsh.exe)
Syntax	Traditional DOS (e.g., dir, copy)	Modern Scripting (e.g., ls, cp)
Speed	Very fast to launch	Slightly slower launch
Use Case	Best for simple conda commands.	Best for complex automation or scripting.