Changes

Once you have ChipWhisperer/Jupyter installed and have the associated hardware, you should be all set to run ChipWhisperer 5! To run ChipWhisperer 5 via a Virtual Machine, open your VM and start the ChipWhisperer Jupyter image. Once the Virtual Machine is booted, open either Firefox or Chrome. Go to your address bar and type in [<code]>localhost:8888[</code]>. A page requesting a password should appear. Enter your password that you set for Jupyter during installation and you'll be taken to the Jupyter homescreen.

For a native installation, open a Bash-like shell terminal (for Windows users, Git Bash will work fine) and navigate to where you installed ChipWhisperer. In Bash, run [<code]>$ jupyter notebook[</code]>. You should be taken to the Jupyter homescreen.

Starting with ChipWhisperer v5.0, tutorials have been moved from the wiki into Jupyter Notebooks. Use Jupyter's file browser to navigate to [<code]>software/Jupyter[</code]>, which contains all of the tutorial notebooks. If you'd like to see our suggested completion order, you can open [code]!!Suggested_Completion_Order!!.ipynb[/code]. Once you've decided which tutorial to run, open the tutorial via Jupyter.

Once you've got a notebook open, you'll find a combination of rich text and Python (and few special blocks, like the [code]%%bash[/code] blocks. Near the top of the page, you'll find a special Python block with [<code]>#Parameters[</code] > in it. This block is used to select which scope (via [<code]>SCOPETYPE[</code]>) as well as which target (via [<code]>PLATFORM[</code]>) you'll be using for the tutorial. Make sure to edit these parameters for which hardware you're using. A list of common SCOPETYPE and PLATFORM values can be found [http://www.example.com here (not yet available)].

Now that this setup is complete, you can start actually running through the tutorials. To run a block, click on the block and make sure it's highlighted (the block should have either a green or blue outline around it), then click the [<code]>>| Run[</code] > button on the toolbar at the top of the screen. This will run the code inside of the block and move to the next one. Run the rest of the code block in the tutorial (all tutorials are designed to be able to be run with minimal modifications to the Python code).

While running tutorials, you will come across special blocks. For ChipWhisperer's notebooks, the two most common ones are [<code]>%%bash[</code] > and [<code]>%run[</code]>. The [<code]>%%bash[</code] > blocks run the following lines using the Bash-like shell you used to open Jupyter with and are typically used for building firmware. The [<code]>%run[</code] > blocks, on the other hand, are used to run other Jupyter notebooks. This avoids duplicating some common blocks across tutorials. To find these notebooks, follow the path specified after the [<code]>%run[</code] > command. For example, if you see a block with [<code]>%run "Helper_Scripts/Setup.ipynb"[</code]>, you can find that file at [<code]>software/Jupyter/Helper_Scripts/Setup.ipynb[</code]>.