458
edits
| As of August 2020 the site you are on (wiki.newae.com) is deprecated, and content is now at rtfm.newae.com. |
Changes
no edit summary
[[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|link=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>
# 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}}
{{CollapsibleSection
|intro = = == Upgrading SAM3U Firmware ===
|content= CW1173_ChipWhisperer-Lite/Upgrading SAM3U Firmware}}
{{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]]
