Changes

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 [https://www.virtualbox.org/wiki/Downloads VirtualBox]. Note you currently must use Virtualbox 5, not 6 as there is an incompatibility between Virtualbox 6 and the current VM operating system. This program is freely available on Windows, Mac, and Linux.# Install the [https://download.virtualbox.org/virtualbox/56.20.226/Oracle_VM_VirtualBox_Extension_Pack-56.20.226.vbox-extpack VirtualBox Extension Pack]. This is necessary for the VM to interact with the ChipWhisperer hardware# Download a ChipWhisperer virtual machine image release (not yet available) or build it yourself using Vagrant (not yet available).

Next, we'll need to setup the network update some passwords for the VM. In VirtualBoxBoot the virtual machine then:# Go Log in (user: vagrant pass: vagrant). You will be asked to ''Global Tools>Host Network Manager''# If a Host-Only adapter exists, update your password. Do so (make sure ''Properties is selected''to record this password). If not, ''Create'' # Setup a new one# Uncheck ''DHCP Server''# Go to ''Adapter'' and change the IPv4 Address to 192password for Jupyter.168.33.11 This can be done by typing <code>jupyter notebook password</code>, then entering and the IPv4 Network Mask to 255verifying your new password.255Note that Jupyter will not start until this is done.255.0# Click Apply# Go This password will be needed to ''Machine Tools''log into Jupyter, select the VM that you added and go to ''Settings'' (your VM may be named differently)# Go to ''Network>Adapter 2'' and so make sure the Host-Only Adapter you modified is selected (if not select record it)as well.# Run Reboot the VM.You shouldn't need # Once the VM is booted, you can connect to login as Jupyter via <code>localhost:8888</code> (which provides the interfaceFirefox/Chrome ONLY) should start automatically. If you do want to login (say to update You will be asked for the ChipWhisperer software), the username and password are both vagrant.you set via <code>jupyter notebook password</code>

You can now open ChipWhisperer 5.0 by opening Chrome or Firefox shouldn't need to log in to the VM again to run Jupyter (Edge/Internet Explorer/Safari DO NOT workwhich provides the interface) and typing 192.168.33.10:8888 into your address baras it should start automatically, but make sure you still record the password you set for the vagrant account, as you will need to log in to update ChipWhisperer.