CW-Capture Tool - Revision history

Adewar at 13:33, 24 August 2023

2023-08-24T13:33:05Z

Fheubach at 13:59, 1 May 2018

2018-05-01T13:59:54Z

Adriel at 02:31, 26 July 2017

2017-07-26T02:31:52Z

Adriel at 02:15, 26 July 2017

2017-07-26T02:15:23Z

Adriel at 02:13, 26 July 2017

2017-07-26T02:13:51Z

Adriel at 17:03, 19 November 2016

2016-11-19T17:03:21Z

Adriel: /* The Basic */

2016-07-15T17:10:17Z

‎The Basic

Adriel: /* Tutorials */

2016-07-15T16:53:14Z

‎Tutorials

Adriel: /* Tutorials */

2016-07-15T16:52:51Z

‎Tutorials

Adriel: /* Tutorials */

2016-07-15T16:52:12Z

‎Tutorials

← Older revision		Revision as of 13:33, 24 August 2023
Line 1:		Line 1:
		+	'''WARNING: THE CHIPWHISPERER CAPTURE AND ANALYZER TOOLS ARE DEPRECATED. AS SUCH, WE ARE UNABLE TO PROVIDE SUPPORT FOR THESE TOOLS OR RELEASES THAT INCLUDE THESE TOOLS.'''
		+
		+
	This tool captures traces from scopes while is also capable of synchronize it with different targets devices.		This tool captures traces from scopes while is also capable of synchronize it with different targets devices.

@@ Line 11: / Line 11: @@
 [[File:Screen Shot 2016-07-15 at 10.00.52 AM.png|1100px]]
-== The Basic ==
+== The Basics ==
 The capture tool comes with a list of built-in scripts to connect to different pairs of target-scope hardwares. The easiest way to start using it is accessing the "Project"->"Example Scripts" menu and select the appropriate item in the list.

@@ Line 34: / Line 34: @@
 #* TIP: check the content of the "Example Scripts" at chipwhisperer/software/chipwhisperer/capture/scripts if you are lost.
 # You may want to check if everything is working properly by clicking in the "Capture 1" button and adjusting the above settings if necessary.
-# Once it is working as expected, you can set the "Generic Settings"->"Acquisition Settings"->"Number of Traces" option to the desired amount (i.e. 50-100) and click the "Capture M" button in the toolbar. This time the traces will be saved to the "Trace Manager" if you specified a "Trace Format".
+# Once it is working as expected, you can set the "Generic Settings"->"Acquisition Settings"->"Number of Traces" option to the desired amount (e.g. 50-100) and click the "Capture M" button in the toolbar. This time the traces will be saved to the "Trace Manager" if you specified a "Trace Format".
 # In order to view the saved traces, you will have to change the "Result"->"Trace Output Plot"->"Input" from the scope channel to the "Trace Manager". You may also want to change the "X Axis" temporal sequence from Samples to Time.
 # You can also import, delete, edit or select/deselect the trace segments by opening the "Trace Manager" in the Project menu.

@@ Line 22: / Line 22: @@
 # Connect to the desired scope/target pair, using the toolbar buttons. The master button connects to both at the same time.
 #* At this point, you may want to flash the desired firmware to the target, using the Programmer option in the Tools' menu.
-# Once connected, both the "Scope Settings" and "Target Settings" list of parameters may expand, giving access to more advanced settings. You will have to setup these parameters which depend on what you want to capture. It usually involves setting the following parameters:
+# Once connected, both the "Scope Settings" and "Target Settings" list of parameters may expand, giving access to more advanced settings. You will have to set these parameters which depend on what you want to capture. It usually involves setting the following parameters:
 #* Trigger Pins
 #* Target IOn Pins

@@ Line 15: / Line 15: @@
 If you want more advanced setups, you will have to configure the capture environment manually using the Setting tabs, starting with the "Generic Settings":
-# Select the desired "Scope Module"  (i.e.: ChipWhisperer/OpenADC). Leave it as None if you only want to use the target.
+# Select the desired "Scope Module"  (e.g., ChipWhisperer/OpenADC). Leave it as None if you only want to use the target.
-# Select the desired "Target Module" (i.e.: Simple Serial). Leave it as None if you only want to use the scope.
+# Select the desired "Target Module" (e.g., Simple Serial). Leave it as None if you only want to use the scope.
-# Select the desired "Trace Format" (i.e.: ChipWhisperer/Native). Leave it as None if you don't need to save the traces, as often happen when executing the Glitching attack.
+# Select the desired "Trace Format" (e.g., ChipWhisperer/Native). Leave it as None if you don't need to save the traces, as often happen when executing the Glitching attack.
-# Switch to the "Scope Settings" tab and setup your scope connection (i.e. selecting 'NewAE USB (CWLite/CW1200)').
+# Switch to the "Scope Settings" tab and setup your scope connection (e.g., selecting 'NewAE USB (CWLite/CW1200)').
-# Switch to the "Target Settings" tab and setup your target connection (i.e. selecting 'NewAE USB (CWLite/CW1200)').
+# Switch to the "Target Settings" tab and setup your target connection (e.g., selecting 'NewAE USB (CWLite/CW1200)').
 # Connect to the desired scope/target pair, using the toolbar buttons. The master button connects to both at the same time.
 #* At this point, you may want to flash the desired firmware to the target, using the Programmer option in the Tools' menu.

@@ Line 21: / Line 21: @@
 # Switch to the "Target Settings" tab and setup your target connection (i.e. selecting 'NewAE USB (CWLite/CW1200)').
 # Connect to the desired scope/target pair, using the toolbar buttons. The master button connects to both at the same time.
-## At this point, you may want to flash the desired firmware to the target, using the Programmer option in the Tools' menu.
+#* At this point, you may want to flash the desired firmware to the target, using the Programmer option in the Tools' menu.
 # Once connected, both the "Scope Settings" and "Target Settings" list of parameters may expand, giving access to more advanced settings. You will have to setup these parameters which depend on what you want to capture. It usually involves setting the following parameters:
 #* Trigger Pins
@@ Line 38: / Line 38: @@
 # You can also import, delete, edit or select/deselect the trace segments by opening the "Trace Manager" in the Project menu.
 # Don't forget to save the Project after each change in the traces. A "Consolidate" option is also available to move/copy all the trace files to the current project directory. It is useful if you imported existing traces or captured it before creating the project.
-Once you master this procedure get tired of doing it over and over again, there are two things you can do about it:
+Once you master this procedure and get tired of doing it over and over again, there are two things you can do about it:
 # Create your own script (based on the existing ones) and add it to the chipwhisperer/software/chipwhisperer/capture/scripts or ~/chipwhisperer_projects/chipwhisperer/capture/scripts directories. You may want to copy/paste the lines from the "Script Commands" window, once the environment is already set, in order to make it easier.
 # Set your capture environment and save the parameter groups using the Save buttons in the top of the Settings tabs. Other possibility would be to use the "Project"->"Save Settings" option to save all the settings at the same time to the "settings.cwset" file inside your project directory. The '''settings are NOT loaded automatically''' when the project is opened. Instead, you should click in the Load button for each group of settings that you want to restore. It is possible to have multiple settings profiles using different settings files. The capture tool also records the settings with the traces when they are captured. If you want to configure the tool to the same environment used in a previous capture, it is possible by loading the setting file saved inside the traces directory.

@@ Line 35: / Line 35: @@
 # You may want to check if everything is working properly by clicking in the "Capture 1" button and adjusting the above settings if necessary.
 # Once the traces output is working as expected, you can set the "Generic Settings"->"Ackisition Settings"->"Number of Traces" option to the desired amount (i.e. 50-100) and click the "Capture M" button in the toolbar. This time the traces will be saved to the "Trace Manager" if you specified a "Trace Format".
-# In order to view the saved traces, you will have to change the "Result"->"Trace Output Plot"->"Input" from the scope channel to the "Trace Manager". There you may also want to change  "X Axis" from Samples to Time.
+# In order to view the saved traces, you will have to change the "Result"->"Trace Output Plot"->"Input" from the scope channel to the "Trace Manager". You may also want to change  "X Axis" temporal sequence from Samples to Time.
 # You can also import, delete, edit or select/deselect the trace segments by opening the "Trace Manager" in the Project menu.
 # Don't forget to save the Project after each change in the traces. A "Consolidate" option is also available to move/copy all the trace files to the current project directory. It is useful if you imported existing traces or captured it before creating the project.