update debug docs, fix typo in Makefile.hal, update jupyter

newaetech · Jun 6, 2022 · 7aa97c9 · 7aa97c9
1 parent 3f9b43a
commit 7aa97c9
Show file tree

Hide file tree

Showing 4 changed files with 36 additions and 4 deletions.
diff --git a/cw_openocd.cfg b/cw_openocd.cfg
@@ -16,7 +16,7 @@ adapter driver ftdi
 
 ftdi channel 1
 ftdi layout_init 0x001B 0x001B
-ftdi layout_signal nTRST -data 0x0010 -oe 0x0010
+#ftdi layout_signal nTRST -data 0x0010 -oe 0x0010
 
 ftdi layout_signal SWD_EN -data 0x0100
 ftdi layout_signal SWDIO_OE -data 0x0200
diff --git a/docs/debugging.rst b/docs/debugging.rst
@@ -140,7 +140,7 @@ a firmware file onto the target:
     targets
     halt
     flash write_image erase /path/to/fw.elf
-    verify image /path/to/fw.elf
+    flash verify_image /path/to/fw.elf
     reset run
     shutdown
 
@@ -205,6 +205,38 @@ ChipWhisperer via the Python interface and via OpenOCD at the same time.
 General Limitations
 ===================
 
+Feature Limitations
+-------------------
+
+Pin Based Limitations
+^^^^^^^^^^^^^^^^^^^^^
+
+MPSSE mode takes control of some ChipWhisperer pins, meaning the following features will not be available:
+
+  * Non MPSSE target programming (STM32, XMEGA, AVR)
+  * ChipWhisperer-Husky stream mode
+  * Control of PDIC, PDID, and the SPI pins
+
+You can give normal functionality back to these pins by running the following::
+
+    scope.io.cwe.setAVRISPMode(0)
+
+MPSSE can be reenabled by running the following command::
+
+    scope.io.cwe.setAVRISPMode(1)
+
+Other Limitations
+^^^^^^^^^^^^^^^^^^^^^
+
+The following features are not available when MPSSE mode is active:
+
+  * CDC serial (normal cw.target based serial still works)
+  * ChipWhisperer-Pro stream mode
+
+To regain usage of these features, you must leave MPSSE mode by running::
+
+    scope.enable_MPSSE(0)
+
 Communication Speed
 -------------------
 

diff --git a/hardware/victims/firmware/hal/Makefile.hal b/hardware/victims/firmware/hal/Makefile.hal
@@ -105,7 +105,7 @@ define KNOWN_PLATFORMS
 | CW308_        | CW308T-MPC5676R (NXP MPC5676R)        |
 |   MPC5676R    |                                       |
 +---------------|---------------------------------------+
-| CW308_NEORV   | CW308/CW312-iCE40 with neorv32        |
+| CW308_NEORV32 | CW308/CW312-iCE40 with neorv32        |
 |               |   (RISC-V) soft-core processor.       |
 +---------------|---------------------------------------+
 

diff --git a/jupyter b/jupyter
+283 −0		demos/Debugging the CW308_STM32F3 Using ChipWhisperer.ipynb
+ −		demos/img/gdb_startup.png
+ −		demos/img/jupyter_terminal.png
+ −		demos/img/using_gdb.png