As of August 2020 the site you are on (wiki.newae.com) is deprecated, and content is now at rtfm.newae.com.

Changes

Jump to: navigation, search

CW1173 ChipWhisperer-Lite

6,781 bytes removed, 18:13, 1 May 2018
no edit summary
__TOC__
 
<span class="expandall">
[[File:cwlite_basic.png|image]]
== Quick-Start Guide ==
You can see a [http://www.youtube.com/watch?v=MJmkYqA-LeM&hd=1 Video] of the quickstart guide, which will take you through all the setup items discussed here:
[[File:cwlite_demo_video.png|YouTubeCW1173Demolink=http://www.youtube.com/watch?v=MJmkYqA-LeM&hd=1]]_
== Connection Quick-Start ==
 <ol style="list-style-type: decimal;"><li>Install Python and Dependancies<dl><dt>Windows:</dt><dd><ul><li>Install Python distribution (such as WinPython), see [[Installing_WinPython]]</li><li><p>Using Follow the Python Command Prompt, use pip to install the following:</p><pre>pip install pysidepip install configobjpip install pyusbpip install pyqtgraph </pre></li></ul> <blockquote><p>What is included in releases varies. If you get a message saying it is already installed you can simply continue with this tutorial.</p></blockquote></dd><dt>Linux:</dt><dd><ul><li><p>Python should come pre-installed. If so you'll also need to install the following from your package manager:</p><blockquote><ul><li>pyside</li><li>configobj</li><li>scipy</li><li>numpy</li></ul> <p>For example the following shows the install command for Ubuntu:</p><pre>sudo apt-get install python2.7 python2.7-dev python2.7-libs python-numpy python-scipy python-pyside python-configobj python-setuptools python-pip</pre></blockquote></li><li><p>Some packages may require installation via 'pip', as they are not always in your package manager repo:</p><pre>$pip install pyusb$pip install pyqtgraph </pre></li></ul></dd><dt>Mac OS-X:</dt><dd><ul><li>Install homebrew, pyside, libusb, along with required Python modules.</li><li>See [[MacOSX_InstallationInstalling ChipWhisperer]] instructions for full details.</li></ul></dd></dl></li><li><p>Download and install ChipWhisperer</p><ul><li>Download the latest release linked from ChipWhisperer.com</li><li>Unzip the file somewhere. Generally 'somewhere' will become your ChipWhisperer working directory. These examples assume you've chosen <code>C:\chipwhisperer</code> as your working directory.</li><li><p>Open a Python terminal (again if using WinPython be sure to run the specific Python command prompt), software and run the following, adjusting paths as needed to refelct your working directory:</p><pre>cd c:\chipwhisperer\openadc\controlsw\pythonpython setupits prerequisites.py developcd c:\chipwhisperer\softwarepython setup.py develop</pre></li></ul> <blockquote><p>If you wish to confirm the installation worked, you can run ChipWhispererAnalyzer in the same terminal:</p><pre>cd c:\chipwhisperer\software\chipwhispererpython CWAnalyzer.pyw</pre></blockquote></li>
<li>Connect ChipWhisperer-Lite, install USB Drivers:
<dl>
</dd></dl>
</li>
<li><p>To check for a successful installation Run ChipWhisperer-Capture. This can be done from one of three ways:</p>
<blockquote><ul>
<li>Double-click on <code>CWCapture.pyw</code> in the <code>chipwhisperer\software</code> folder. You must have installed Python into your path for this to work.</li>
<p>[[File:cwlite_simpleserial.png|image]]</p>
<p>This should connect to the ChipWhisperer-Lite, program the FPGA, and run a few captures. Your screen should look something like this now:</p>
<p>[[File:cwdemo_normalStep Connection Quick Start 05 02.pngPNG|1000px|image]]</p></li>
<li><p>If the previous step fails, you may need to set the path for the &quot;firmware&quot;. This is done by going to the &quot;Tools&quot; menu and selecting the &quot;Config CW Firmware&quot; option. Note on MAC OS X a special command is required instead sometimes, see [[MacOSX_Installation]].</p>
<p>From there, hit the &quot;FIND&quot; button beside the &quot;FPGA .zip (Release)&quot; option. Point it to the file located at <code>chipwhisperer/hardware/capture/chipwhisperer-lite/cwlite_firmware.zip</code> on your filesystem.</p></li>
# By default the XMEGA device was programmed with a partial AES implementation only. This is done to avoid any crypto export issues. This does not affect your side-channel analysis, but be aware the returned value might not appear to be correct (since only the first couple rounds of AES occurred).
== Basic Usage Instructions ==
{{CollapsibleSection
|intro = = == AVR Programmer ===
|content= CW1173_ChipWhisperer-Lite/AVR Programmer}}
{{CollapsibleSection
|intro = = == XMEGA Programmer ===
|content= CW1173_ChipWhisperer-Lite/XMEGA Programmer}}
{{CollapsibleSection
|intro = = == Using Glitch Port ===
|content= CW1173_ChipWhisperer-Lite/Glitch Port}}
{{CollapsibleSection
|intro = = == Using Measure Port ===
|content= CW1173_ChipWhisperer-Lite/Measure Port}}
{{CollapsibleSection
|intro = = == 20-Pin Connector ===
|content= CW1173_ChipWhisperer-Lite/20-Pin Connector}}
{{CollapsibleSection|intro = === 8-Pin SmartCard Connector ===|content= CW1173_ChipWhisperer-Lite/8-Pin SmartCard Connector}}
The CW1173 contains two 8-pin connectors, which use our standard 8-pin Smart-Card header pinout. One header connects to the SAM3U device (which has ISO-7816 drivers), one header connects to the FPGA. Note there is currently no firmware support for these devices, but the hardware is designed for any of the following: * Emulating a smart card (use interposer board), or fuzzing a smart card reader* Communicating to a smart card* Sniffing traffic between a legitimate reader and smart card* Side-channel analysis of smart card device Header J7 (Connects to SAM3U): {| class="wikitable"! Number! Name! Dir! Description|-| 1| VCCIO| O| 3.3V Supply (from linear regulator, always on)|-| 2| GND| O| System GND|-| 3| RST| I/O| Reset (SAM3U: PA3)|-| 4| PRESENT| I| Used to detect presence of smart card (SAM3U: PA2)|-| 5| CLK| I/O| Clock (SAM3U: PA25, 'CLK2'. FPGA: P131)|-| 6| I/O| I/O| I/O Line (SAM3U: PA22), 10k pull-up|-| 7| AUX1| I/O| Spare line (SAM3U: PA4)|-| 8| AUX2| I/O| Spare line (SAM3U: PA5)|} Header J6 (Connects to FPGA): {| class="wikitable"! Number! Name! Dir! DescriptionCollapsibleSection|-| 1| VCCIO| O| 3.3V Supply (from FPGA supply)|-| 2| GND| O| System GND|-| 3| RST| I/O| Reset (FPGA: P102)|-| 4| PRESENT/VPP| I| Not Connected (mount R60 to connect to P101)|-| 5| CLK| I/O| Clock (FPGA: P100)|-| 6| I/O| I/O| I/O Line (FPGA: P99), 10k pull-up|-| 7| AUX1| I/O| Spare line (FPGA: P98)|-| 8| AUX2| I/O| Spare line (FPGA: P97)|} intro == Upgrading SAM3U Firmware == When talking about the ChipWhisperer-Lite's firmware, there is really two parts to this: # The FPGA Bitstream file.# The Upgrading SAM3U USB interface chip firmware. The FPGA bitstream alone is what is normally configured by the ChipWhisperer-Capture software. This bitstream is always the most up-to-date, since it's automatically reloaded by the computer every time you power cycle the ChipWhisperer-Capture. The SAM3U firmware however is not automatically updated, but it tends to change less frequently. === Checking Firmware Version === The firmware version is printed at start-up. You will see a line that looks like this indicating the version of the SAM3U Firmware: <pre>Found CW-Lite, Serial Number = 442031204630xxxxxxxxxxxSAM3U Firmware version = 0.11 b0Programmed FPGA</pre>If your firmware version is outdated, a warning will be printed. You can also see the firmware version in the ''Config CW Firmware'' dialog: <blockquote>[[File:sam3fwver.png|image]]</blockquote>Note the main version is 0.11 in this example. The &quot;b0&quot; indicates a &quot;build&quot; number. Typically this will be &quot;build 0&quot;, but special versions will use a different build number to indicate a variant of a regular version. content=== Upgrading Firmware === Before updating, you must put your ChipWhispererCW1173_ChipWhisperer-Lite into bootloader mode. Once put into this mode you will need to load a new firmware file. There is two ways of doing it: the ''automatic'' method, and the ''manual'' method. The automatic method is done through the GUI, and works if you have valid firmware image loaded. The ''manual'' method is always guaranteed to work. The automatic method is: Using ChipWhisperer-Capture GUI # Connect to the ChipWhisperer-Lite.# From the ''Tools'' menu select ''Config CW Firmware''# Select the ''Open SAM3U Update Widget'' button.# Press the ''Enable Bootloader Mode'' button.# You will get an error, and the ChipWhisperer-Lite will disconnect. This is normal, and indicates the USB mode changed suddenly.# The blue LED will stop flashing, and the device will reconnect in programmer mode (see below). Once you are in bootloader mode, both the blue and red LED will be very dimmly lit: [[File:lights_prog.jpg|400px]] This indicates it is in bootloader mode. The device will now attach as a serial port. If you are using Windows this may take a few minutes to happen. If using Linux, you can use ''dmesg'' to verify the serial port was connected OK. If this doesn't work, see the page [[Manual SAM3U Firmware Update]] for details on how to manually enter bootloader mode. You can return to this page for the actual programming - you don't need to install/use the BOSSA utility if you follow those manual directions. You simply need to force the system into bootloader mode using those directions. To actually program the file, we use the second part of the dialog box you already had open: [[File:sam3uupdate.png|400px]] Once we are in bootloader mode, you can follow these steps: # Hit "Update List", and select the serial port the SAM3U attached as.# To use the default firmware file, leave the "Built-in" radio-box selected. If you want a custom firmware you can select the "External" mode.# Hit the "Run Program" button# Once completed, unplug/replug your device and it should come to life.# Close the update widgets, and reconnect to your ChipWhisperer-Lite. === Manual Update === If the above instructions fail, there is no big problem. The SAM3U chip contains a hardware-resident bootloader. You may need to follow instructions on the [[Manual Upgrading SAM3U Firmware Update]] page (including using BOSSA) if you are unable to use the automatic system that is part of ChipWhisperer-Capture.}}
{{CollapsibleSection
|intro = = == Breaking Target Section Apart ===
|content= CW1173_ChipWhisperer-Lite/Breaking Target Section Apart
}}
== Advanced Usage ==
=== Mounting Jumpers ===
Note the ChipWhisperer-Lite main board and target section contain a number of jumper options. By default these are not mounted, and solder jumper bridges on the PCB have been bridged to select the appropriate options when required. Some options are only solder jumpers, which to move the jumper requires a soldering iron to bridge or clear the appropriate connections.
</span>
{{CollapsibleSection
|intro = === Schematic ===
[https://github.com/newaetech/chipwhisperer/blob/master/hardware/capture/chipwhisperer-lite/pcb/cw-lite-main.pdf Link to PDF]
 
(Expand for inline images of schematic)
|content= CW1173_ChipWhisperer-Lite/Schematic
}}
== Hardware ==
{{Template:Hardware}}
 
[[Category:Capture Hardware]]
Retrieved from "http://wiki.newae.com/Special:MobileDiff/1817...3440"

Navigation menu