Skip to content

Latest commit

 

History

History
124 lines (86 loc) · 2.92 KB

README.md

File metadata and controls

124 lines (86 loc) · 2.92 KB
Raw

Sichere Implementierungen auf Microcontrollern (WS 2023/2024)

Installation and Setup

Prerequisites

  • VSCode
  • VSCode Extensions: Python, Jupyter
  • Git
  • Python >=3.9 and <=3.11

Installation of ChipWhisperer

Windows

  1. Download latest version of ChipWhisperer Setup from https://github.com/newaetech/chipwhisperer/releases.
  2. Install. Recommended Installation folder: C:\cw. Make sure that the paths does not contain whitespaces.

Unix like OS

  1. Clone ChipWhisperer repository somewhere (In the following we will assume that the location is ~/work/chipwhisperer):

    cd ~/work/
git clone --branch 5.7.0 https://github.com/newaetech/chipwhisperer.git

  2. Install required packages. Here as example for a Debian based OS:

    sudo apt install libusb-dev make avr-libc gcc-avr gcc-arm-none-eabi

  3. Adjust udev rules and allow user to access serial interfaces:

    sudo cp ~/work/chipwhisperer/hardware/50-newae.rules /etc/udev/rules.d/50-newae.rules
sudo udevadm control --reload-rules
sudo usermod -aG dialout $USER
sudo usermod -aG plugdev $USER

Installation of required Python packages

  1. Clone this repository somewhere (In the following we will assume that the location is ~/work/ws2324/securecoding_ws2324):

    cd ~/work/ws2324
git clone https://github.com/hackenbergstefan/securecoding_ws2324.git

  2. Create virtual environment and activate it:

    cd ~/work/ws2324/securecoding_ws2324
python -m venv .venv
# On Unix like:
. .venv/bin/activate
# On Windows:
.venv/Scripts/activate

  3. Install requirements:

    (.venv)$ pip install -r requirements.lock

Adjust environment variables

Create a file .env inside the repository with the following content:

Windows:

# C:\work\ws2324\securecoding_ws2324\.env
PATH=C:\cw\cw\usr\bin;C:\cw\cw\home\portable\armgcc\bin;C:\cw\cw\home\portable\avrgcc\bin;$env["PATH"]
CWFIRMWAREPATH=C:\cw\cw\home\portable\chipwhisperer\hardware\victims\firmware

Unix like (Assume your username is stefan):

# /home/stefan/work/ws2324/securecoding_ws2324/.env
CWFIRMWAREPATH=/home/stefan/work/chipwhisperer/hardware/victims/firmware

Reload VSCode (Ctrl+Shift+P -> "Developer: Reload Window")

Test setup

  1. Open repository folder with VSCode VSCode should have recognized your virtual environment
  2. Inside VSCode open ./lecture_0/test_setup.ipynb
  3. Select kernel from virtual environment
  4. Run cells step by step

Update

In case requirements.txt and/or requirements.lock changed execute:

  1. Ensure you have activated the corresponding virtual environment. E.g.

    Unix like:

    . .venv/bin/activate

    Windows:

    .venv/bin/activate

  2. Run

    pip install -r requirements.lock