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 Login (user: vagrant pass: vagrant). You will be asked to ''Global Tools>Host Network Manager''update your password. Do so.# If Setup a Host-Only adapter existsnew password for Jupyter. This can be done by typing <code>jupyter notebook password</code>, make sure ''Properties is selected''then entering and verifying your new password. If Note that Jupyter will not, ''Create'' a new onestart until this is done.# Uncheck ''DHCP Server''# Go to ''Adapter'' and change Reboot the IPv4 Address to 192VM.168.33.11 and the IPv4 Network Mask to 255.255.255.0# Click Apply# Go to ''Machine Tools'', select Once the VM that is booted, you added and go can connect to ''Settings'' (your VM may be named differently)# Go to ''NetworkJupyter via <code>localhost:8888</code>Adapter 2'' and make sure the Host-Only Adapter you modified is selected (if not select itFirefox/Chrome ONLY)# Run the VM.You shouldn't need to login as Jupyter (which provides will be asked for the interface) should start automatically. If password you do want to login (say to update the ChipWhisperer software), the username and set via <code>jupyter notebook password are both vagrant.</code>

You can now open ChipWhisperer 5.0 by opening Chrome or Firefox shouldn't need to login 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 login to update ChipWhisperer.