If this is your first time using the ChipWhisperer toolchain, the easiest way to start is to use a virtual machine with everything already set up for you. Note that Linux users may find it easier to do a manual install.
These instructions are for the newest version of CW5 (v5.0.1+) and will not work with CW5's initial alpha release (v5.0.0). Virtualbox 6 is assumed here, but these instructions should work for Virtualbox 5 as well, provided the correct extension pack is installed.
- Install VirtualBox. This program is freely available on Windows, Mac, and Linux.
- Install the VirtualBox Extension Pack. This is necessary for the VM to interact with the ChipWhisperer hardware
- Download a ChipWhisperer virtual machine image release or build it yourself using Vagrant.
- Unzip the VirtualBox image, go to Machine>Add in VirtualBox and select the VM that was unzipped
- Verify that the VM boots
Next, we'll need to update some passwords for the VM. Boot the virtual machine then:
- Login (user: vagrant pass: vagrant). You will be asked to update your password. Do so.
- Setup a new password for Jupyter. This can be done by typing
jupyter notebook password, then entering and verifying your new password. Note that Jupyter will not start until this is done. - Reboot the VM.
- Once the VM is booted, you can connect to Jupyter via
localhost:8888(Firefox/Chrome ONLY). You will be asked for the password you set viajupyter notebook password
You shouldn't need to login again to run Jupyter (which provides the interface) as it should start automatically, but make sure you still record the password you set for the vagrant account, as you will need to login to update ChipWhisperer.