chore(Examples): Test examples on Rev. B production silicon for MAX32…

…655 (#649)

Examples/MAX32655/ADC/README.md

@@ -1,6 +1,6 @@
 ## Description
 
-Demonstrates the use of the ADC by continuously monitoring ADC input channel 0.  Vary the voltage on the AIN0 input (0 to 1.8V) to observe different readings from the ADC.
+Demonstrates the use of the ADC by continuously monitoring ADC input channel 0.  Vary the voltage on the AIN0 input (0 to 1.22V) to observe different readings from the ADC.
 
 The example can be configured to either use a polling or interrupt driven ADC Conversion by commenting or uncommenting the "USE_INTERRUPTS" define respectively. 
 
@@ -17,19 +17,17 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
--   Apply an input voltage between 0 and 0.9V to pin labeled 0 of the JH11 (Analog) header.
+-   Apply an input voltage between 0 and 1.22V to pin labeled "0" of the JH11 (Analog) header.
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
--   Apply an input voltage between 0 and 0.9V to pin labeled 0 of the JH11 (Analog) header.
+-   Apply an input voltage between 0 and 1.22V to pin labeled "AIN0" on header J9.
 
 ## Expected Output
 

Examples/MAX32655/AES/README.md

@@ -14,15 +14,13 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the standard EV Kit (EvKit\_V1):
+##  Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
-If using the featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 

Examples/MAX32655/CRC/README.md

@@ -13,15 +13,13 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 

Examples/MAX32655/Coremark/README.md

@@ -14,17 +14,19 @@ Universal instructions on building, flashing, and debugging this project can be
 
 ### Project-Specific Build Notes
 
-To comply with the CoreMark rules, the only source files which are included in this example directory are the core_portme.c/.h files, the rest (including main) are located in the [Coremark](../../../Libraries/Coremark/) library.
+* To comply with the CoreMark rules, the only source files which are included in this example directory are the core_portme.c/.h files, the rest (including main) are located in the [Coremark](../../../Libraries/Coremark/) library.
+
+* This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the UG for instructions on changing the target board.
 
 ## Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 -   Close jumper JP2 (LED0 EN).
 -   Close jumper JP3 (LED1 EN).
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 

Examples/MAX32655/DMA/README.md

@@ -2,7 +2,7 @@
 
 A simple DMA transaction is shown that copies a block of memory from one location to another.
 
-A second more complex memory-to-memory DMA transaction is then shown that chains two transfers together.  A callback function is used to notify the application once both transfers have completed.
+A second more complex DMA transaction is then shown that chains two memory-to-memory transfers together.  In the second example a callback function is used to notify the application once both transfers have completed.
 
 
 ## Software
@@ -15,15 +15,13 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
-If using the featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 

Examples/MAX32655/Dual_core_sync/Dual_core_sync_arm/README.md

@@ -1,6 +1,6 @@
 ## Description
 
-Projects Dual_core_sync_arm and Dual_core_sync_riscv demonstrates loading the RISC-V core program from the ARM core and synchronizing these two cores by hardware semaphores. 
+Projects Dual_core_sync_arm and Dual_core_sync_riscv demonstrate loading the RISC-V core program from the ARM core and synchronizing these two cores by hardware semaphores. 
 
 Dual_core_sync_arm runs on the ARM core (CM4) to load the RISC-V core (RV32) code space, setup the RISC-V debugger pins, and start the RISC-V core.
 
@@ -19,17 +19,15 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 -   Close jumper JP2 (LED0 EN).
 -   Close jumper JP3 (LED1 EN).
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 -   

Examples/MAX32655/Dual_core_sync/Dual_core_sync_riscv/README.md

@@ -17,9 +17,7 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
+## Required Connections
 If using the Standard EV Kit (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.

Examples/MAX32655/EEPROM_Emulator/README.md

@@ -54,9 +54,8 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
@@ -66,7 +65,7 @@ If using the Standard EV Kit (EvKit\_V1):
 -   Enabling the pullup jumper by selecting the approriate bus voltage with jumper JP21.
 -   Connect Ready Signal (P0.27) to the pin used for ready signal on your micro.
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 -   Connect pins SCL - P0.30 (J7.11) and SDA - P0.31 (J7.12) to the I2C Bus

Examples/MAX32655/External_Flash/README.md

@@ -1,7 +1,10 @@
 ## Description
 
-This example communicates with the W25 flash on the EvKit. It loads "Analog Devices" array onto it and then reads it back.
+This example demonstrates how to use the External_Flash library to communicate with the W25 external flash chip on the EvKit.
 
+In this example, a portion of the external flash memory is erased (and verified), then the string "Analog Devices" is loaded into the flash and then the data string is read back to verify the write was successful.
+
+The user may select between Quad and Single SPI interface modes by setting the value of the EXT_FLASH_SPIXFC_WIDTH definition at the top of main.c to either Ext_Flash_DataLine_Quad or Ext_Flash_DataLine_Single. 
 
 ## Software
 
@@ -11,10 +14,10 @@ Universal instructions on building, flashing, and debugging this project can be
 
 ### Project-Specific Build Notes
 
-* This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
+* NOTE: This example is only supported by the MAX32655EVKIT.
 
 ## Required Connections
-
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN2 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 

Examples/MAX32655/External_Flash/project.mk

@@ -8,3 +8,8 @@
 # **********************************************************
 
 # Add your config here!
+
+# This example is only compatible with the MAX32655EVKIT
+ifneq ($(BOARD),EvKit_V1)
+$(error ERR_NOTSUPPORTED: This project is only supported on the MAX32655EVKIT.  (see https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages))
+endif

Examples/MAX32655/FTHR_I2C/README.md

@@ -2,7 +2,7 @@
 
 This example uses I2C to cycle through the 8 colors of the RGB LED connected to the on-board MAX20303 Power Management IC. 
 
-*** NOTE ***: This example is only intended to be run on the MAX32655 Featherboard.
+*** NOTE ***: This example is only intended to be run on the MAX32655FTHR.
 
 
 ## Software
@@ -13,16 +13,15 @@ Universal instructions on building, flashing, and debugging this project can be
 
 ### Project-Specific Build Notes
 
-* This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
+* NOTE: This project is only compatible with the MAX32655FTHR!
 
-## Setup
-
-##### Required Connections
+## Required Connections
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
 ## Expected Behavior
-The LED should change colors once a second, cycling through the 8 colors (off, blue, red, purple, green, light blue, yellow, white).
+The PMIC RGB LED should change colors once a second, cycling through the 8 colors (off, blue, red, purple, green, light blue, yellow, white).
 
 The Console UART of the device will output these messages:
 

Examples/MAX32655/FTHR_I2C/project.mk

@@ -8,3 +8,9 @@
 # **********************************************************
 
 # Add your config here!
+override BOARD=FTHR_Apps_P1
+
+# This example is only compatible with the MAX32655FTHR
+ifneq ($(BOARD),FTHR_Apps_P1)
+$(error ERR_NOTSUPPORTED: This project is only supported on the MAX32655FTHR.  (see https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages))
+endif

Examples/MAX32655/Flash/README.md

@@ -27,25 +27,17 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Hardware Connections
-
-If using the MAX32655EVKIT:
+## Required Connections
 
+If using the MAX32655EVKIT (EvKit\_V1):
 - Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 - Connect jumpers JP4 (RX_SEL) to RX0 and JP5 (TX_SEL) to TX0
 - Open a terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
-If using the MAX32655FTHR:
-
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 - Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 - Open a terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 
-## Building and Running
-
-**See the [MSDK User Guide](https://analog-devices-msdk.github.io/msdk/USERGUIDE/)** for detailed instructions on building and running example projects from supported development environments.
-
-This example supports all available MAX32655 evaluation platforms but comes _pre-configured_ for the MAX32655EVKIT by default.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) for instructions on how to configure the project for a different board.
-
 ## Expected Output
 
 After flashing and launching the example, an LED on the board will blink once every second.  This is the application waiting for PushButton 1 (PB1) to be pressed, and gives a window for a serial terminal to be connected.  After connecting the serial terminal, the application will output the following contents:

Examples/MAX32655/Flash/main.c

@@ -54,6 +54,7 @@
 #include "pb.h"
 
 /***** Definitions *****/
+#define WORDS_PER_FLASH_PG (MXC_FLASH_PAGE_SIZE / 4)
 #define TEST_ADDRESS (MXC_FLASH_MEM_BASE + MXC_FLASH_MEM_SIZE) - (1 * MXC_FLASH_PAGE_SIZE)
 /*
     ^ Points to last page in flash, which is guaranteed to be unused by this small example.
@@ -205,7 +206,7 @@ int erase_magic()
         Therefore, the entire page must be buffered, erased, then modified.
     */
     int err;
-    uint32_t buffer[MXC_FLASH_PAGE_SIZE >> 2] = {
+    uint32_t buffer[WORDS_PER_FLASH_PG] = {
         0xFFFFFFFF
     }; // 8192 bytes per page / 4 bytes = 2048 uint32_t
 

Examples/MAX32655/Flash_CLI/README.md

@@ -15,17 +15,15 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0  header.
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1.
 -   Close jumper JP2 (LED0 EN).
 -   Close jumper JP3 (LED1 EN).
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1.
 

Examples/MAX32655/FreeRTOSDemo/README.md

@@ -13,18 +13,26 @@ Universal instructions on building, flashing, and debugging this project can be
 
 * This project comes pre-configured for the MAX32655EVKIT.  See [Board Support Packages](https://analog-devices-msdk.github.io/msdk/USERGUIDE/#board-support-packages) in the MSDK User Guide for instructions on changing the target board.
 
-## Setup
-
-### Required Connections
-If using the Standard EV Kit (EvKit\_V1):
+## Required Connections
+If using the MAX32655EVKIT (EvKit\_V1):
 -   Connect a USB cable between the PC and the CN1 (USB/PWR) connector.
 -   Connect pins JP4(RX_SEL) and JP5(TX_SEL) to RX0 and TX0 header. Also connect JP6 and JP7 for CTS/RTS signals. 
 -   Open an terminal application on the PC and connect to the EV kit's console UART at 115200, 8-N-1. Enable CTS/RTS on PC terminal.
 -   Close jumper JP2 (LED0 EN).
 -   Close jumper JP3 (LED1 EN).
 
-If using the Featherboard (FTHR\_Apps\_P1):
+If using the MAX32655FTHR (FTHR\_Apps\_P1):
 -   Connect a USB cable between the PC and the J4 (USB/PWR) connector.
 -   Open an terminal application on the PC and connect to the board's console UART at 115200, 8-N-1. Enable CTS/RTS on PC terminal.
 
 ## Expected Output
+
+```
+-=- MAX32655 FreeRTOS (V10.5.1) Demo -=-
+SystemCoreClock = 100000000
+Starting scheduler.
+Uptime is 0x00000000 (0 seconds), tickless-idle is disabled
+
+Enter 'help' to view a list of available commands.
+cmd>
+```