| As of August 2020 the site you are on (wiki.newae.com) is deprecated, and content is now at rtfm.newae.com. |
Difference between revisions of "CW5"
(→Jupyter Tips) (Tag: VisualEditor) |
(Tag: VisualEditor) |
||
| Line 1: | Line 1: | ||
The release of ChipWhisperer v5.0 has brought major changes to the front end of the ChipWhisperer software as well as a switch to Python3: the GUI and the wiki tutorials have been replaced with Jupyter Notebooks, which allow users to run interactive Python blocks in their browser. Most of the API remains unchanged from v4 and, with the exception of Python2.7 specific code, most GUI-less scripts should run as is. Additional features, such as ChipWhipserer Analyzer support, are now available outside of any GUI. | The release of ChipWhisperer v5.0 has brought major changes to the front end of the ChipWhisperer software as well as a switch to Python3: the GUI and the wiki tutorials have been replaced with Jupyter Notebooks, which allow users to run interactive Python blocks in their browser. Most of the API remains unchanged from v4 and, with the exception of Python2.7 specific code, most GUI-less scripts should run as is. Additional features, such as ChipWhipserer Analyzer support, are now available outside of any GUI. | ||
| − | + | == Running Jupyter == | |
| − | To run Jupyter natively (aka outside a VM), navigate to the ChipWhisperer directory and run <code>jupyter notebook</code>. A new window should open in your browser. | + | To run Jupyter natively (aka outside a VM), navigate to the ChipWhisperer directory via the command line and run <code>jupyter notebook</code>. A new window should open in your browser. If you're using a ChipWhisperer VM, ensure the VM is booted, open your browser and connect to 192.168.33.10:8888. Once you have it started, Jupyter behaves as a mostly normal file explorer inside your browser, allowing you to click on directories to enter them or on files to open them. Once you have files open, you can use Jupyter to edit them as you would any normal text editor. |
| − | + | == Jupyter Notebook Tutorials == | |
| + | Starting with ChipWhisperer v5.0, tutorials have been moved from the wiki into Jupyter Notebooks. These are located in <code>Software/Jupyter</code> and can be run by opening the tutorials via the Jupyter Notebook interface. These tutorials contain interactive code blocks, which can run by clicking on them to highlight them, then hitting the run button in the menu at the top of your screen: | ||
| − | [[File: | + | [[File:Running jupyter blocks.PNG|frameless|876x876px]] |
| − | + | If you need to change anything inside the blocks, double click the block to begin editing them. Since Jupyter runs in your browser, you can improve your workflow by using tabs and windows to open multiple files at a time: | |
| − | + | ||
| − | + | Everything in these code blocks are actual Python code (unless you see something like <code>%%bash</code> at the top), so these tutorials also provide a reference for creating Python scripts. These tutorials often make use of helper scripts, which are located in the Helper_Scripts folder. The Jupyter folder also contains a <code>Helpful_Code_Blocks</code> file which, as the name suggests, contains blocks of Python code that are often a good start for creating your own notebooks or scripts. The final file of note is <code>!!Suggested_Completion_Order!!</code>, which contains a list of the tutorials in the suggested order that you complete them in. | |
| − | + | ||
| − | + | ||
Revision as of 09:38, 19 November 2018
The release of ChipWhisperer v5.0 has brought major changes to the front end of the ChipWhisperer software as well as a switch to Python3: the GUI and the wiki tutorials have been replaced with Jupyter Notebooks, which allow users to run interactive Python blocks in their browser. Most of the API remains unchanged from v4 and, with the exception of Python2.7 specific code, most GUI-less scripts should run as is. Additional features, such as ChipWhipserer Analyzer support, are now available outside of any GUI.
Running Jupyter
To run Jupyter natively (aka outside a VM), navigate to the ChipWhisperer directory via the command line and run jupyter notebook. A new window should open in your browser. If you're using a ChipWhisperer VM, ensure the VM is booted, open your browser and connect to 192.168.33.10:8888. Once you have it started, Jupyter behaves as a mostly normal file explorer inside your browser, allowing you to click on directories to enter them or on files to open them. Once you have files open, you can use Jupyter to edit them as you would any normal text editor.
Jupyter Notebook Tutorials
Starting with ChipWhisperer v5.0, tutorials have been moved from the wiki into Jupyter Notebooks. These are located in Software/Jupyter and can be run by opening the tutorials via the Jupyter Notebook interface. These tutorials contain interactive code blocks, which can run by clicking on them to highlight them, then hitting the run button in the menu at the top of your screen:
If you need to change anything inside the blocks, double click the block to begin editing them. Since Jupyter runs in your browser, you can improve your workflow by using tabs and windows to open multiple files at a time:
Everything in these code blocks are actual Python code (unless you see something like %%bash at the top), so these tutorials also provide a reference for creating Python scripts. These tutorials often make use of helper scripts, which are located in the Helper_Scripts folder. The Jupyter folder also contains a Helpful_Code_Blocks file which, as the name suggests, contains blocks of Python code that are often a good start for creating your own notebooks or scripts. The final file of note is !!Suggested_Completion_Order!!, which contains a list of the tutorials in the suggested order that you complete them in.
