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.
[[Manual SAM3U Firmware Update]]
==== Checking Firmware Version ====
Note the main version is 0.11 in this example. The "b0" indicates a "build" number. Typically this will be "build 0", but special versions will use a different build number to indicate a variant of a regular version.
==== Entering Bootloader Mode Upgrading Firmware ====
Before updating, you must put your ChipWhisperer-Lite into bootloader mode. Once put into this mode you will need to load a new firmware file. The There is two methods ways of doing this areit: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.
<ol style="list-style-typeThe automatic method is: decimal;"><li>Using ChipWhisperer-Capture GUI<ol style="list-style-type: lower-alpha;"><li># Connect to the ChipWhisperer-Lite.</li><li># From the ''Tools'' menu select ''Config CW Firmware''.</li><li># Select the ''Open SAM3U Update Widget'' button.</li><li># Press the ''Enable Bootloader Mode'' button.</li><li>The blue LED # You will stop flashingget an error, and the device will reconnect in programmer mode (see below).</li></ol></li><li>If this method doesn't work, you can use the manual override method. To use a metal object:<ol style="list-style-type: lower-alpha;"><li><p>Short the jumper labeled "ERASE" on the ChipWhisperer-Litewill disconnect. Do this while This is normal, and indicates the device is connected via micro-USBmode changed suddenly. # The blue LED should will stop flashing at this point, and the device will stay either on or off reconnect in programmer mode (depending when you shorted the jumpersee below). This can be accomplished by anything metallic - for example using a screwdriver or tweezers:</p><p>[[File:short_screwdriver.jpg|image]]</p><blockquote><dl><dt>width</dt><dd><p>300pt</p></dd></dl></blockquote><p>[[File:short_tweezers.jpg|image]]</p><blockquote><dl><dt>width</dt><dd><p>300pt</p></dd></dl></blockquote></li><li>Unplug and Replug the micro-USB port.</li></ol></li></ol>
Once you are in bootloader mode, both the blue and red LED will be very dimmly lit:
<blockquote>[[File:lights_prog.jpg|400px]]</blockquote>
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.
==== Upgrading with BOSSA ==== BOSSA is a programming tool for the Atmel SAM devices. The ChipWhisperer-Capture software can call the command-line tool for you. To do If this: <ol style="list-style-type: decimal;"><li>Open the SAM3U Firmware Loader - if you just used it to enter bootloader mode, you will already have this window open. If not:<ol style="list-style-type: lower-alpha;"><li>Start ChipWhisperer-Capture.</li><li>Select the "ChipWhisperer/OpenADC" and "ChipWhisperer-Lite" target, but ''do not'' click connect (as it wondoesn't work).</li><li>From the ''Tools'' menu select ''Config CW Firmware''.</li><li>Press the ''Open SAM3U Update Widget'' button.</li></ol></li><li><p>Hopefully the ''bossac'' binary was found. ChipWhisperer-Capture has a binary for Windows and Linux already present, which should be located at <code>chipwhisperer/capture/hardware/chipwhisperer-lite/bossa</code>. If these binaries are not working, see the BOSSA homepage to download an appropriate installer for your system.</p><p>Once ready, point to the <code>bossac</code> binary for your system.</p></li><li><p>The firmware update file is normally located in <code>hardware/capture/chipwhisperer-lite/sam3u_fw/SAM3U_VendorExample/Debug/SAM3U_CW1173.bin</code>. If not found, again point your system to this. If the window is setup correctly, it should look like this:</p><p>page [[File:bossa_gui.png|imageManual SAM3U Firmware Update]]</p></li><li>Hit the ''Run bossac'' buttonfor details on how to manually enter bootloader mode. You should see a decleration of success printed in can return to this page for the output.</li><li>Unplug and replug the ChipWhispereractual programming -Lite. The blue LED should be blinking again. Close ChipWhisperer-Capture and re-open it to attempt a re-connect.</li></ol> If things you don't work, you can manually run bossac as follows: <pre>bossac -e -w -v -b /path/need toinstall/SAM3U_CW1173.bin</pre>If use the BOSSA utility if you are on Linux, you may need to either fix permissions on the serial port, or run bossac as root/sudofollow those manual directions. See below for details. ===== Linux-Specific Instructions ===== You may simply need to give yourself write permission for force the serial port. This can be done on some systems easily by adding yourself to the <code>dialout</code> user group. For example, assuming your username was <code>cwuser</code>: # <code>$ sudo usermod -a -G dialout cwuser</code># Log out and log back in again for changes to take effectsystem into bootloader mode using those directions.
You may also need to build bossac from sources, as the provided binary does not work with your system. Details of how to perform this Once we are provided next:in bootloader mode
To build BOSSA, it is recommended to use our simplified bossac repository, which only builds the command-line version. To build this perform these steps:==== Manual Update ====
# Download [https://githubIf the above instructions fail, there is no big problem.com/newaetech/BOSSA/archive/masterThe SAM3U chip contains a hardware-resident bootloader.zip a copy of You may need to follow instructions on the GIT repo[[Manual SAM3U Firmware Update], or clone with <code>git clone git@github.com:newaetech/] page (including using BOSSA.git</code> (see github.com/newaetech/bossa for the full repo).# Unzip the directory if you downloaded are unable to use the zip.# Run <code>make</code>.# The binary should be in <code>bin\bossac</code>automatic system that is part of ChipWhisperer-Capture.
=== Breaking Target Section Apart ===