V5:Installing ChipWhisperer/Required Tools - Windows - Revision history

Adewar at 14:44, 14 May 2019

2019-05-14T14:44:59Z

Adewar at 16:36, 13 May 2019

2019-05-13T16:36:55Z

Adewar at 16:26, 13 May 2019

2019-05-13T16:26:31Z

Adewar at 14:17, 8 May 2019

2019-05-08T14:17:37Z

Adewar: /* Installing Arm Toolchain */

2018-12-21T20:19:53Z

‎Installing Arm Toolchain

Adewar at 17:44, 19 December 2018

2018-12-19T17:44:57Z

Adewar at 17:43, 19 December 2018

2018-12-19T17:43:23Z

Adewar at 17:42, 19 December 2018

2018-12-19T17:42:10Z

Adewar: Created page with "

Python

For any of the other installation methods, you'll need to have Python 3 installed on your computer. If you already a recent version of Python installed (3.5...."

2018-12-18T20:24:53Z

Created page with "<h4> Python </h4> For any of the other installation methods, you'll need to have Python 3 installed on your computer. If you already a recent version of Python installed (3.5...."

New page

<h4> Python </h4>
For any of the other installation methods, you'll need to have Python 3 installed on your computer. If you already a recent version of Python installed (3.5.x+), you can skip this step. Note that Python 2.x will not work with this codebase. There's also a bit of setup that's needed to get other tools and prepare other drivers.

The recommend method of installing Python is to use a distribution called [http://winpython.github.io/ WinPython]. This setup avoids installing Python globally, and includes most of the software you will need. In addition it makes it possible to install 32-bit and 64-bit Python on the same system with minimal problems. This can be very useful as the 64-bit version is handy for doing analysis on large data sets.

To install WinPython 3.7.x, Download a release in the 3.7.x branch from the [http://winpython.github.io/ WinPython] site. It's recommended to use the 32-bit version, but you can also use the 64-bit version ('''NOT SURE IF STILL TRUE)'''.

Choose a reasonable location to install this to - note the default is simply in the download directory. Instead it's recommended to find a directory such as <code>c:\WinPython32bit-3.7.1.0</code>, or into your local directory such as <code>c:\Users\yourname\<code>WinPython32bit-3.7.1.0</code></code>.

Go to your installation directory for WinPython, and run the shortcut called '''WinPython Command Prompt.exe'''. This will give you a command prompt which is setup to run Python along with associated scripts.

''Optional'': You can add the python.exe you just installed to your PATH. To do so navigate to your installation folder, and run the '''WinPython Control Panel.exe''' program. Then select ''Advanced -> Register distribution...''. If you do not do this, you will have to run all commands in this document via the '''WinPython Command Prompt.exe'''. If you plan on running both 32-bit and 64-bit Python, you should not register them. Instead explicitly call the correct Python by always running the '''WinPython Command Prompt.exe''', and then calling specific programs (such as CW Capture or Analyzer) from that command prompt.

<h4> Python Packages </h4>
There are a number of packages that the ChipWhisperer project uses. You'll need to install these so that the software can run. With your WinPython command prompt, navigate to where you downloaded ChipWhisperer to, then move to the <code>software/</code> directory.

Run the following commands to get the needed packages:
* '''ConfigObj:''' <code>pip install -r requirements.txt</code>

<h4> Installing Hardware Drivers </h4>

Details of driver installation are on specific pages for supported hardware (such as cwcapturerev2 and naecw1173_cwlite). Drivers are available from [http://chipwhisperer.com ChipWhisperer] release section.

<h4> Getting AVR Compiler Toolchain </h4>

The following section is not required for your first attack - you can jump right to the tutorial if you wish. However you'll ultimately wish to modify the code of the device under test, and these instructions tell you how. You should first follow the tutorial to confirm your system is working before modifying the code however!

To build the code, you'll need to install avr-gcc on Windows (if using the Virtual Machine, the following is ''not required'', as the VM comes setup with the AVR compiler already). On Windows, you could choose to install:

* Atmel AVR-GCC standalone - see [http://www.atmel.com/tools/atmelavrtoolchainforwindows.aspx Atmel avr-gcc standalone] (registration required)
* WinAVR. Last release - 2010, see [https://sourceforge.net/projects/winavr/files/latest/download?source=typ_redirect WinAVR Page] (no registration required)

To test the code build, follow these steps:

<p><code>cd</code> to the directory with the avr-serial example, and run <code>make</code>:</p>
<pre>cd c:\chipwhisperer\hardware\victims\firmware\simpleserial-aes
make</pre>
<p>If this is successful, you'll see an output like the following:</p>
<p>[[File:Avr-build-ok.png|image]]</p>
<p>If instead you get an error something like <code>make: *** No rule to make target `simpleserial.elf', needed by `elf'. Stop.</code>, this means a required file was missing.</p>
Programming the target AVR is accomplished in one of two methods depending on your hardware. The ChipWhisperer Capture Rev 2 uses the external "AVR Studio" program, whereas the CW1173 and CW1200 use a programmer menu from the ChipWhisperer-Capture software.

For details about programming the targets, see [[Tutorial B1 Building a SimpleSerial Project]].

<h5> WinAVR Path Settings </h5>

By default, WinAVR is added to your system path. This means you can run avr-gcc, make and other programs from your normal Windows command line. You may not want this on certain systems where you already have similar tools installed. In which case either uncheck the Add WinAVR to Path option, or edit your system path to remove the WinAVR directories.

If you do not add it to the system path, you’ll need a method of readding the WinAVR directories when you want to use WinAVR. To do so create a file called winavr.bat in C:\WinAVR-20100110 with the following contents:

set PATH=%PATH%;C:\WinAVR-20100110\bin;C:\WinAVR-20100110\utils\bin
cmd

Now when you want to run WinAVR (e.g. to continue the examples here), you can simply double-click on the winavr.bat file. This will configure the path for just that terminal, rather than every terminal you open.

Note if using WinAVR on Windows 8.1, you must replace the dll msys-1.0.dll with an updated version. See [http://www.avrfreaks.net/forum/windows-81-compilation-error Windows 8.1 Fix] for a link to this DLL replacement.

==== Installing Arm Toolchain ====

To be able to build firmware for ARM Targets, you'll need to install the GNU Toolchain for ARM Devices. An installer for Windows and archives for Linux/Windows can be found [https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads here]. If you use the installer, make sure the "Add path to environment variable", "Add registry information", and "Launch gccvar.bat" boxes are ticked.

Once you've done this, open a terminal and type <code>arm-none-eabi-gcc</code>. If this fails, you'll need to add the toolchain to your path manually.

@@ Line 58: / Line 58: @@
 ==== Installing Arm Toolchain ====
-To be able to build firmware for ARM Targets, you'll need to install the GNU Toolchain for ARM Devices. An installer for Windows and archives for Linux/Windows can be found [https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads here]. Make sure you install the 2018-q2 version of the software, as 2018-q4 has a bug that prevents compiling. If you use the installer, make sure the "Add path to environment variable", "Add registry information", and "Launch gccvar.bat" boxes are ticked. Otherwise, you'll need to add the compiler to your path as with avr-gcc.
+To be able to build firmware for ARM Targets, you'll need to install the GNU Toolchain for ARM Devices. An installer for Windows and archives for Linux/Windows can be found [https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads here]. Make sure you install the '''2018-q2 version''' of the software, as 2018-q4 has a bug that prevents compiling and earlier ones may not work once uploaded. If you use the installer, make sure the "Add path to environment variable", "Add registry information", and "Launch gccvar.bat" boxes are ticked. Otherwise, you'll need to add the compiler to your path as with avr-gcc.
 Once you've done this, open a terminal and type <code>arm-none-eabi-gcc</code>. If this fails, you'll need to add the toolchain to your path manually.
 This doesn't install make like WinAVR does, so if you haven't installed that, you'll need to on your own (the easiest way is just to install WinAVR as well).

← Older revision		Revision as of 20:19, 21 December 2018
Line 61:		Line 61:

	Once you've done this, open a terminal and type <code>arm-none-eabi-gcc</code>. If this fails, you'll need to add the toolchain to your path manually.		Once you've done this, open a terminal and type <code>arm-none-eabi-gcc</code>. If this fails, you'll need to add the toolchain to your path manually.
		+
		+	This doesn't install make like WinAVR does, so if you haven't installed that, you'll need to on your own (the easiest way is just to install WinAVR as well).

@@ Line 4: / Line 4: @@
 The recommend method of installing Python is to use a distribution called [http://winpython.github.io/ WinPython]. This setup avoids installing Python globally, and includes most of the software you will need. In addition it makes it possible to install 32-bit and 64-bit Python on the same system with minimal problems. This can be very useful as the 64-bit version is handy for doing analysis on large data sets.
-To install WinPython 3.7.x, Download a release in the 3.7.x branch from the [http://winpython.github.io/ WinPython] site. It's recommended to use the 32-bit version, but you can also use the 64-bit version.
+To install WinPython 3.7.x, Download a release in the 3.7.x branch from the [http://winpython.github.io/ WinPython] site. ChipWhisperer works with both 32-bit and 64-bit versions of Python. If you run into issues connecting on Windows with 64-bit Python, see https://github.com/newaetech/chipwhisperer/issues/199.
 Choose a reasonable location to install this to - note the default is simply in the download directory. Instead it's recommended to find a directory such as <code>c:\WinPython32bit-3.7.1.0</code>, or into your local directory such as <code>c:\Users\yourname\<code>WinPython32bit-3.7.1.0</code></code>.

@@ Line 28: / Line 28: @@
 To build the code, you'll need to install avr-gcc on Windows (if using the Virtual Machine, the following is ''not required'', as the VM comes setup with the AVR compiler already). On Windows, you could choose to install:
-* Atmel AVR-GCC standalone - see [http://www.atmel.com/tools/atmelavrtoolchainforwindows.aspx Atmel avr-gcc standalone] (registration required)
+* AVR-GCC standalone - see [https://www.microchip.com/mymicrochip/filehandler.aspx?ddocname=en607654 avr-gcc standalone]. You'll need to unzip this file and add the bin folder to your path. See [https://docs.alfresco.com/4.2/tasks/fot-addpath.html this link] for instructions on how to add something to your path.
-* WinAVR. Last release - 2010, see [https://sourceforge.net/projects/winavr/files/latest/download?source=typ_redirect WinAVR Page] (no registration required)
+* WinAVR. WinAVR is rather old at this point, so its use is not recommended. Last release - 2010, see [https://sourceforge.net/projects/winavr/files/latest/download?source=typ_redirect WinAVR Page]
 To test the code build, follow these steps:

@@ Line 54: / Line 54: @@
 Now when you want to run WinAVR (e.g. to continue the examples here), you can simply double-click on the winavr.bat file. This will configure the path for just that terminal, rather than every terminal you open.
-Note if using WinAVR on Windows 8.1, you must replace the dll msys-1.0.dll with an updated version. See [http://www.avrfreaks.net/forum/windows-81-compilation-error Windows 8.1 Fix] for a link to this DLL replacement.
+Note if using WinAVR on Windows 8.1 and possibly Windows 10, you must replace the dll msys-1.0.dll with an updated version. See [http://www.avrfreaks.net/forum/windows-81-compilation-error Windows 8.1 Fix] for a link to this DLL replacement.
 ==== Installing Arm Toolchain ====

@@ Line 10: / Line 10: @@
 Go to your installation directory for WinPython, and run the shortcut called '''WinPython Command Prompt.exe'''. This will give you a command prompt which is setup to run Python along with associated scripts.
-''Optional'': You can add the python.exe you just installed to your PATH. To do so navigate to your installation folder, and run the '''WinPython Control Panel.exe''' program. Then select ''Advanced -> Register distribution...''. If you do not do this, you will have to run all commands in this document via the '''WinPython Command Prompt.exe'''. If you plan on running both 32-bit and 64-bit Python, you should not register them. Instead explicitly call the correct Python by always running the '''WinPython Command Prompt.exe''', and then calling specific programs (such as CW Capture or Analyzer) from that command prompt.
+''Optional'': You can add the python.exe you just installed to your PATH. To do so navigate to your installation folder, and run the '''WinPython Control Panel.exe''' program. Then select ''Advanced -> Register distribution...''. If you do not do this, you will have to run all commands in this document via the '''WinPython Command Prompt.exe'''. If you plan on running both 32-bit and 64-bit Python, you should not register them. Instead explicitly call the correct Python by always running the '''WinPython Command Prompt.exe''', and then calling specific scripts or notebooks.
 <h4> Python Packages </h4>