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 "Tutorial B1 Building a SimpleSerial Project"

From ChipWhisperer Wiki
Jump to: navigation, search
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
{{Warningbox|This tutorial has been updated for ChipWhisperer 4.0.0 release. If you are using 3.x.x see the "V3" link in the sidebar.}}
+
{{Warningbox|This tutorial has been updated for ChipWhisperer 5 release. If you are using 4.x.x or 3.x.x see the "V4" or "V3" link in the sidebar.}}
  
 
{{Infobox tutorial
 
{{Infobox tutorial
Line 8: Line 8:
 
|capture hardware      = CW-Lite, CW-Lite 2-Part, CW-Pro
 
|capture hardware      = CW-Lite, CW-Lite 2-Part, CW-Pro
 
|Target Device          =  
 
|Target Device          =  
−
|Target Architecture    = XMEGA/ARM
+
|Target Architecture    = XMEGA/ARM/Other
 
|Hardware Crypto        = No
 
|Hardware Crypto        = No
 
|Purchase Hardware      =  
 
|Purchase Hardware      =  
 
}}
 
}}
 +
<!-- To edit this, edit Template:Tutorial_boilerplate -->
 +
{{Tutorial boilerplate}}
  
 +
* Jupyter file: '''PA_Intro_1-Firmware_Build_Setup.ipynb'''
  
−
This tutorial will introduce you to the 'simpleserial' communications system. It will show you how to perform different operations on data based on input from the ChipWhisperer software. This can be used for building your own system which you wish to 'break'.
+
== XMEGA Target ==
  
−
For users of the ChipWhisperer Lite with ARM target, you'll want to ensure you have the latest updates to the ChipWhisperer platform. This can be done by using the ChipWhisperer Git Update program, or by using git to checkout the develop branch and pulling any updates.
+
See the following for using:
 +
* ChipWhisperer-Lite Classic (XMEGA)
 +
* ChipWhisperer-Lite Capture + XMEGA Target on UFO Board (including NAE-SCAPACK-L1/L2 users)
 +
* ChipWhisperer-Pro + XMEGA Target on UFO Board
  
−
{{TOC|limit=3}}
+
https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-openadc-cwlitexmega.html#tutorial-pa-intro-1-openadc-cwlitexmega
  
−
<h2> What is SimpleSerial </h2>
+
== ChipWhisperer-Lite ARM / STM32F3 Target ==
  
−
[[SimpleSerial]] is the communications protocol used for almost all of the ChipWhisperer demo project. It's a very basic serial protocol which can be easily implemented on most systems. This system communicates using a standard asyncronous serial protocol, 38400 baud, 8-N-1.
+
See the following for using:
 +
* ChipWhisperer-Lite 32-bit (STM32F3 Target)
 +
* ChipWhisperer-Lite Capture + STM32F3 Target on UFO Board (including NAE-SCAPACK-L1/L2 users)
 +
* ChipWhisperer-Pro + STM32F3 Target on UFO Board
  
−
All messages are sent in ASCII-text, and are normally terminated with a line-feed ('\n'). This allows you to interact with the simpleserial system over a standard terminal emulator.
+
https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-openadc-cwlitearm.html#tutorial-pa-intro-1-openadc-cwlitearm
  
−
The following message types are defined:
+
== ChipWhisperer Nano Target ==
  
−
; <code>x</code>
+
See the following for using:
−
: Sending a 'x' resets the buffers. This does not require a line-feed termination. It is suggested to always send a stream of x's to initilize the system in case the device was already in some other mode due to noise/corruption.
+
* ChipWhisperer-Nano
−
; <code>k00112233445566778899AABBCCDDEEFF\\n</code>
+
−
: Loads the encryption key <code>00112233445566778899AABBCCDDEEFF</code> into the system. If not called the system may use some default key.
+
−
; <code>pAABBCCDDEEFF00112233445566778899\\n</code>
+
−
: Encrypts the data <code>AABBCCDDEEFF00112233445566778899</code> with the key loaded with the 'k' command. The system will respond with a string starting with r, as shown next.
+
−
; <code>rCBBD4A2B34F2571758FF6A797E09859D\\n</code>
+
−
: This is the response from the system. If data has been encrypted with a 'p' for example, the system will respond with the 'r' sequence automatically. So sending the earlier example means the result of the encryption was <code>cbbd4a2b34f2571758ff6a797e09859d</code>.
+
  
−
<h2> Building the Basic Example </h2>
+
https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-cwnano-cwnano.html#tutorial-pa-intro-1-cwnano-cwnano
−
{{CollapsibleSection
+
−
|intro = === Building for CWLite with XMEGA Target ===
+
−
|content= Building for XMEGA}}
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Building for CWLite with Arm Target ===
+
−
|content= Building for Arm}}
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Building for Other Targets ===
+
−
|content= Building for Other Targets}}
+
−
<h2> Modifying the Basic Example </h2>
+
−
 
+
−
At this point we want to modify the system to perform 'something' with the data, such that we can confirm the system is working. To do so, open the file <code>simpleserial-base.c</code> with a code editor such as ''Programmer's Notepad'' (which ships with WinAVR).
+
−
 
+
−
<ol style="list-style-type: decimal;">
+
−
<li><p>Find the following code block towards the end of the file:</p>
+
−
<syntaxhighlight lang="c">/**********************************
+
−
* Start user-specific code here. */
+
−
trigger_high();
+
−
 
+
−
//16 hex bytes held in 'pt' were sent
+
−
//from the computer. Store your response
+
−
//back into 'pt', which will send 16 bytes
+
−
//back to computer. Can ignore of course if
+
−
//not needed
+
−
 
+
−
trigger_low();
+
−
/* End user-specific code here. *
+
−
********************************/</syntaxhighlight></li>
+
−
<li><p>Modify it to increment the value of each sent data byte:</p>
+
−
<syntaxhighlight lang="c">/**********************************
+
−
* Start user-specific code here. */
+
−
trigger_high();
+
−
 
+
−
//16 hex bytes held in 'pt' were sent
+
−
//from the computer. Store your response
+
−
//back into 'pt', which will send 16 bytes
+
−
//back to computer. Can ignore of course if
+
−
//not needed
+
−
 
+
−
for(int i = 0; i < 16; i++){
+
−
    pt[i]++;
+
−
}
+
−
 
+
−
trigger_low();
+
−
/* End user-specific code here. *
+
−
********************************/</syntaxhighlight></li>
+
−
<li>Rebuild the example using the <code>make</code> command. Remember you can press the up arrow on the keyboard to get recently typed commands in most OSes.</li></ol>
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Completing Tutorial with CW1173 (Lite) With XMEGA===
+
−
|content= Completing Tutorial with CW1173}}
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Completing Tutorial with CW1173 (Lite) With ARM===
+
−
|content= Completing Tutorial with CW1173 ARM}}
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Completing Tutorial with CW1173 (Lite) + UFO Board ===
+
−
|content= Completing Tutorial with CW1173 UFO Board}}
+
−
 
+
−
{{CollapsibleSection
+
−
|intro = === Completing Tutorial with CW1200 (Pro) ===
+
−
|content= Completing Tutorial with CW1200}}
+
−
 
+
−
<h2> Conclusion </h2>
+
−
 
+
−
In this tutorial you have learned how to build a custom program for the microcontroller on the ChipWhisperer target board. You have programmed the built .hex file into the microcontroller, and confirmed communications with the ChipWhisperer device.
+
−
 
+
−
In future labs you will build on this knowledge to attack specific instructions.
+
−
 
+
−
<h2> Troubleshooting </h2>
+
−
 
+
−
Issues with compilation:
+
−
 
+
−
<blockquote><ol style="list-style-type: decimal;">
+
−
<li><p>You may have to generate the .dep and objdir directories manually before make will work:</p>
+
−
<pre>mkdir .dep
+
−
mkdir objdir</pre></li>
+
−
<li>On Windows 8, you may get an error like fork: resyntaxhighlight temporarily unavailable. This requires you to install an updated mysys.dll. Download from http://www.madwizard.org/download/electronics/msys-1.0-vista64.zip, unzip file, and copy the .dll to <code>C:\WinAVR-20100110\utils\bin</code>, replacing the existing file.</li>
+
−
<li>For the AVR Studio USB Drivers, you'll need to download a [https://gallery.atmel.com/Products/Details/004ccabd-e18e-431a-8557-83deaea23341 Special Update] from Atmel.</li>
+
−
<li>You may wish to use the &quot;ChipWhisperer Virtual Machine&quot; on newer Windows systems, which does not require any of the above setup.</li></ol>
+
−
</blockquote>
+
−
 
+
−
== Links ==
+
−
 
+
−
{{Template:Tutorials}}
+
−
[[Category:Tutorials]]
+

Latest revision as of 05:05, 29 July 2019

This tutorial has been updated for ChipWhisperer 5 release. If you are using 4.x.x or 3.x.x see the "V4" or "V3" link in the sidebar.

B1: Building a SimpleSerial Project
Target Architecture XMEGA/ARM/Other
Hardware Crypto No
Software Release V3 / V4 / V5

This tutorial will introduce you to measuring the power consumption of a device under attack. It will demonstrate how you can view the difference between assembly instructions. In ChipWhisperer 5 Release, the software documentation is now held outside the wiki. See links below.

To see background on the tutorials see the Tutorial Introduction on ReadTheDocs, which explains what the links below mean. These wiki pages (that you are reading right now) only hold the hardware setup required, and you have to run the Tutorial via the Jupyter notebook itself. The links below take you to the expected Jupyter output from each tutorial, so you can compare your results to the expected/known-good results.

Running the tutorial uses the referenced Jupyter notebook file.

  • Jupyter file: PA_Intro_1-Firmware_Build_Setup.ipynb

XMEGA Target

See the following for using:

  • ChipWhisperer-Lite Classic (XMEGA)
  • ChipWhisperer-Lite Capture + XMEGA Target on UFO Board (including NAE-SCAPACK-L1/L2 users)
  • ChipWhisperer-Pro + XMEGA Target on UFO Board

https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-openadc-cwlitexmega.html#tutorial-pa-intro-1-openadc-cwlitexmega

ChipWhisperer-Lite ARM / STM32F3 Target

See the following for using:

  • ChipWhisperer-Lite 32-bit (STM32F3 Target)
  • ChipWhisperer-Lite Capture + STM32F3 Target on UFO Board (including NAE-SCAPACK-L1/L2 users)
  • ChipWhisperer-Pro + STM32F3 Target on UFO Board

https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-openadc-cwlitearm.html#tutorial-pa-intro-1-openadc-cwlitearm

ChipWhisperer Nano Target

See the following for using:

  • ChipWhisperer-Nano

https://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-cwnano-cwnano.html#tutorial-pa-intro-1-cwnano-cwnano

Retrieved from "http://wiki.newae.com/index.php?title=Tutorial_B1_Building_a_SimpleSerial_Project&oldid=4069"