Changes

{{Warningbox|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 has been updated for ChipWhisperer software5 release. This can be used for building your own system which If you wish to 'break'are using 4.x.x or 3.x.x see the "V4" or "V3" link in the sidebar.}}

<h1> What is {{Infobox tutorial|name = B1: Building a SimpleSerial Project|image = |caption = |software versions =|capture hardware = CW-Lite, CW-Lite 2-Part, CW-Pro|Target Device = |Target Architecture = XMEGA/ARM/Other|Hardware Crypto = No|Purchase Hardware = }}</h1!-- To edit this, edit Template:Tutorial_boilerplate -->{{Tutorial boilerplate}}

[[SimpleSerial]] is the communications protocol used for almost all of the ChipWhisperer demo project. It* Jupyter file: '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''PA_Intro_1-N-1Firmware_Build_Setup.ipynb'''

The See the following message types are definedfor 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

; <code>x</code>https: 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.; <code>k00112233445566778899AABBCCDDEEFF\\n</code>: Loads the encryption key <code>00112233445566778899AABBCCDDEEFF</code> into the systemchipwhisperer. If not called the system may use some default keyreadthedocs.; <code>pAABBCCDDEEFF00112233445566778899\\n<io/code>: Encrypts the data <code>AABBCCDDEEFF00112233445566778899<en/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<latest/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<tutorials/code>pa_intro_1-openadc-cwlitexmega.html#tutorial-pa-intro-1-openadc-cwlitexmega

<h1> Building the Basic Example <== ChipWhisperer-Lite ARM /h1>STM32F3 Target ==

You'll need to have installed avr-gcc and avr-libc. You may have already done this by following See the installation guide, or if following for using the :* ChipWhisperer-VM it comes prepared with avrLite 32-gcc already setup. See the [[Installing_ChipWhisperer]] guide for details.bit (STM32F3 Target)* ChipWhisperer-Lite Capture + STM32F3 Target on UFO Board (including NAE-SCAPACK-L1/L2 users)* ChipWhisperer-Pro + STM32F3 Target on UFO Board

Once you have a working compiler (check by typing 'avrhttps://chipwhisperer.readthedocs.io/en/latest/tutorials/pa_intro_1-gcc' at the command line openadc- if using Windows you may need to setup a special batch file to provide you with a avr-gcc command prompt)cwlitearm.html#tutorial-pa-intro-1-openadc-cwlitearm

<ol style="list-style-type: decimal;"><li>We want to use the existing SimpleSerial firmware as a base for our project, but we don't want to edit the existing firmware. Instead, we'll make a new project with a copy of this firmware. Copy the directory <code>simpleserial-base</code> which is found at <code>chipwhisperer\hardware\victims\firmware\</code> of the chipwhisperer release to a new directory called <code>simpleserial-base-lab1</code>. You must keep it in the same directory, as it will reference other files within that directory for the build process.</li><li><dl><dt>Open a terminal with avr-gcc in the path. If using Windows the sidebar on the [[Installing_ChipWhisperer]] page - you can either add WinAVR to your system path, or you can run the 'winavr.bat' file suggested.</dt></dl></li><li><p>Change the terminal to the newly copied directory. For example:</p><pre>cd c:\chipwhisperer\hardware\victims\firmware\simpleserial-base-lab1</pre></li><li><p>Then, run <code>make</code> to build the system. Make sure you specify which platform you're using as your target. For example, for the = ChipWhisperer Lite target, run</p><pre>make PLATFORMNano Target ==CW303</pre><p>Which should have the following output:</p><pre>...Bunch of lines removed...Creating Extended Listing: simpleserial-base.lssavr-objdump -h -S -z simpleserial-base.elf &gt; simpleserial-base.lss

Creating Symbol TableSee the following for using: simpleserial-base.symavr-nm -n simpleserial-base.elf &gt; simpleserial* ChipWhisperer-base.symNano

Size afterhttps:AVR Memory Usage----------------Device: atxmega128d3 Program: 1524 bytes (1.1% Full)(.text + .data + .bootloader) Data: 224 bytes (2.7% Full)(.data + .bss + .noinit)  Built for platform CW-Lite XMEGA -------- end --------</pre></li>Ensure that the "Built for platform ___" matches your target devicechipwhisperer.</ol> </h1> Modifying the Basic Example </h1> At this point we want to modify the system to perform 'something' with the data, such that we can confirm the system is workingreadthedocs. To do so, open the file <code>simpleserial-base.c<io/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:<en/p><syntaxhighlight lang="c">latest/********************************** * 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();tutorials/* End userpa_intro_1-specific code here. * ********************************/</syntaxhighlight></li><li><p>Modify it to increment the value of each sent data byte:</p><syntaxhighlight lang="c">/********************************** * Start usercwnano-specific code herecwnano. */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) =|content= Completing Tutorial with CW1173}} {{CollapsibleSection|intro = = Completing Tutorial with CW1200 (Pro) =|content= Completing Tutorial with CW1200}} {{CollapsibleSection|intro = = Completing Tutorial with CW1002 (ChipWhisperer Capture Rev2) =|content= Completing Tutorial with CW1002 (ChipWhisperer Capture Rev2)}} <h1> Conclusion </h1> In this html#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. <h1> Troubleshooting </h1> Issues with compilation: <blockquote><ol style="list-stylepa-type: decimal;"><li><p>You may have to generate the .dep and objdir directories manually before make will work:</p><pre>mkdir .depmkdir 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/msysintro-1.0-vista64.zip, unzip file, and copy the .dll to <code>C:\WinAVRcwnano-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> {{Template:Tutorials}}[[Category:Tutorials]]cwnano