boards: arm: Update frdm_k64f and mimxrt10{60,64}_evk board docs

Updates board documentation for several NXP boards to reflect currently
supported features, NXP documentation links, clarifications on debug
probes, additional troubleshooting tips, and some minor editorial
changes.

Signed-off-by: Derek Snell <derek.snell@nxp.com>
Signed-off-by: Maureen Helm <maureen.helm@nxp.com>

boards/arm/frdm_k64f/doc/index.rst

@@ -80,6 +80,8 @@ The frdm_k64f board configuration supports the following hardware features:
 +-----------+------------+-------------------------------------+
 | ADC       | on-chip    | adc                                 |
 +-----------+------------+-------------------------------------+
+| DAC       | on-chip    | dac                                 |
++-----------+------------+-------------------------------------+
 | PWM       | on-chip    | pwm                                 |
 +-----------+------------+-------------------------------------+
 | ETHERNET  | on-chip    | ethernet                            |
@@ -98,6 +100,8 @@ The frdm_k64f board configuration supports the following hardware features:
 +-----------+------------+-------------------------------------+
 | RTC       | on-chip    | rtc                                 |
 +-----------+------------+-------------------------------------+
+| DMA       | on-chip    | dma                                 |
++-----------+------------+-------------------------------------+
 
 The default configuration can be found in the defconfig file:
 
@@ -235,7 +239,7 @@ Install the :ref:`jlink-debug-host-tools` and make sure they are in your search
 path.
 
 Follow the instructions in :ref:`opensda-jlink-onboard-debug-probe` to program
-the `OpenSDA J-Link Generic Firmware for V3.2 Bootloader`_. Note that Segger
+the `OpenSDA J-Link Generic Firmware for V2.0 Bootloader`_. Note that Segger
 does provide an OpenSDA J-Link Board-Specific Firmware for this board, however
 it is not compatible with the DAPLink bootloader.
 
@@ -346,7 +350,7 @@ of pyocd commands:
    https://os.mbed.com/blog/entry/DAPLink-bootloader-update/
 
 .. _OpenSDA DAPLink FRDM-K64F Firmware:
-   https://www.nxp.com/assets/downloads/data/en/snippets-boot-code-headers-monitors/k20dx_frdmk64f_if_crc_legacy_0x5000.bin
+   https://www.nxp.com/downloads/en/snippets-boot-code-headers-monitors/k20dx_frdmk64f_if_crc_legacy_0x5000.bin
 
-.. _OpenSDA J-Link Generic Firmware for V3.2 Bootloader:
+.. _OpenSDA J-Link Generic Firmware for V2.0 Bootloader:
-   https://www.segger.com/downloads/jlink/OpenSDA_V3_2
+   https://www.segger.com/downloads/jlink/OpenSDA_V2

boards/arm/mimxrt1060_evk/doc/index.rst

@@ -6,14 +6,14 @@ NXP MIMXRT1060-EVK
 Overview
 ********
 
-The i.MX RT1060 is the latest addition to the industry's first crossover
+The i.MX RT1060 adds to the industry's first crossover
 processor series and expands the i.MX RT series to three scalable families.
 
 The i.MX RT1060 doubles the On-Chip SRAM to 1MB while keeping pin-to-pin
-compatibility with i.MX RT1050. This new series introduces additional features
+compatibility with i.MX RT1050. This series introduces additional features
 ideal for real-time applications such as High-Speed GPIO, CAN-FD, and
 synchronous parallel NAND/NOR/PSRAM controller. The i.MX RT1060 runs on the
-Arm® Cortex-M7® core at 600 MHz.
+Arm® Cortex-M7® core up to 600 MHz.
 
 .. image:: ./mimxrt1060_evk.jpg
    :width: 720px
@@ -102,6 +102,8 @@ features:
 +-----------+------------+-------------------------------------+
 | I2C       | on-chip    | i2c                                 |
 +-----------+------------+-------------------------------------+
+| WATCHDOG  | on-chip    | watchdog                            |
++-----------+------------+-------------------------------------+
 | SDHC      | on-chip    | disk access                         |
 +-----------+------------+-------------------------------------+
 | UART      | on-chip    | serial port-polling;                |
@@ -111,6 +113,10 @@ features:
 +-----------+------------+-------------------------------------+
 | USB       | on-chip    | USB device                          |
 +-----------+------------+-------------------------------------+
+| CAN       | on-chip    | can                                 |
++-----------+------------+-------------------------------------+
+| DMA       | on-chip    | dma                                 |
++-----------+------------+-------------------------------------+
 
 
 The default configuration can be found in the defconfig file:
@@ -261,15 +267,18 @@ however the :ref:`pyocd-debug-host-tools` do not yet support programming the
 external flashes on this board so you must reconfigure the board for one of the
 following debug probes instead.
 
-:ref:`jlink-external-debug-probe`
+.. _Using J-Link RT1060:
+
+Using J-Link
 ---------------------------------
 
 Install the :ref:`jlink-debug-host-tools` and make sure they are in your search
 path.
 
-Attach a J-Link 20-pin connector to J21. Check that jumpers J47 and J48 are
+There are two options: the onboard debug circuit can be updated with Segger
-**off** (they are on by default when boards ship from the factory) to ensure
+J-Link firmware, or :ref:`jlink-external-debug-probe` can be attached to the
-SWD signals are disconnected from the OpenSDA microcontroller.
+EVK. See `Using J-Link with MIMXRT1060-EVK or MIMXRT1064-EVK`_ for more
+details.
 
 Configuring a Console
 =====================
@@ -356,11 +365,15 @@ steps:
 
 #. Reset by pressing SW9
 
+If the west flash or debug commands fail, and the command hangs while executing
+runners.jlink, confirm the J-Link debug probe is configured, powered, and
+connected to the EVK properly. See :ref:`Using J-Link RT1060` for more details.
+
 .. _MIMXRT1060-EVK Website:
    https://www.nxp.com/support/developer-resources/software-development-tools/mcuxpresso-software-and-tools/mimxrt1060-evk-i.mx-rt1060-evaluation-kit:MIMXRT1060-EVK
 
 .. _MIMXRT1060-EVK User Guide:
-   https://www.nxp.com/webapp/Download?colCode=UM11151UG
+   https://www.nxp.com/docs/en/data-sheet/MIMXRT10601064EKBHUG.pdf
 
 .. _MIMXRT1060-EVK Schematics:
    https://www.nxp.com/webapp/Download?colCode=MIMXRT1060-EVK-DESIGN-FILE-A2
@@ -373,3 +386,6 @@ steps:
 
 .. _i.MX RT1060 Reference Manual:
    https://www.nxp.com/webapp/Download?colCode=IMXRT1060RM
+
+.. _Using J-Link with MIMXRT1060-EVK or MIMXRT1064-EVK:
+   https://community.nxp.com/t5/i-MX-RT-Knowledge-Base/Using-J-Link-with-MIMXRT1060-EVK-or-MIMXRT1064-EVK/ta-p/1281149

boards/arm/mimxrt1064_evk/doc/index.rst

@@ -6,13 +6,13 @@ NXP MIMXRT1064-EVK
 Overview
 ********
 
-The i.MX RT1064 is the latest addition to the industry's first crossover
+The i.MX RT1064 adds to the industry's first crossover
 processor series and expands the i.MX RT series to three scalable families.
 The i.MX RT1064 doubles the On-Chip SRAM to 1MB while keeping pin-to-pin
-compatibility with i.MX RT1050. This new series introduces additional features
+compatibility with i.MX RT1050. This series introduces additional features
 ideal for real-time applications such as High-Speed GPIO, CAN-FD, and
 synchronous parallel NAND/NOR/PSRAM controller. The i.MX RT1064 runs on the
-Arm® Cortex-M7® core at 600 MHz.
+Arm® Cortex-M7® core up to 600 MHz.
 
 .. image:: ./mimxrt1064_evk.jpg
    :width: 600px
@@ -79,6 +79,7 @@ these references:
 - `i.MX RT1064 Reference Manual`_
 - `MIMXRT1064-EVK Website`_
 - `MIMXRT1064-EVK Quick Reference Guide`_
+- `MIMXRT1064-EVK User Guide`_
 - `MIMXRT1064-EVK Schematics`_
 
 Supported Features
@@ -96,10 +97,18 @@ features:
 +-----------+------------+-------------------------------------+
 | DISPLAY   | on-chip    | display                             |
 +-----------+------------+-------------------------------------+
+| VIDEO     | on-chip    | video, using CSI                    |
++-----------+------------+-------------------------------------+
 | FLASH     | on-chip    | QSPI flash                          |
 +-----------+------------+-------------------------------------+
 | GPIO      | on-chip    | gpio                                |
 +-----------+------------+-------------------------------------+
+| I2C       | on-chip    | i2c                                 |
++-----------+------------+-------------------------------------+
+| WATCHDOG  | on-chip    | watchdog                            |
++-----------+------------+-------------------------------------+
+| PWM       | on-chip    | pwm                                 |
++-----------+------------+-------------------------------------+
 | SDHC      | on-chip    | disk access                         |
 +-----------+------------+-------------------------------------+
 | UART      | on-chip    | serial port-polling;                |
@@ -107,8 +116,13 @@ features:
 +-----------+------------+-------------------------------------+
 | ENET      | on-chip    | ethernet                            |
 +-----------+------------+-------------------------------------+
-| USB       | on-chip    | USB device controller               |
+| USB       | on-chip    | USB device                          |
 +-----------+------------+-------------------------------------+
+| CAN       | on-chip    | can                                 |
++-----------+------------+-------------------------------------+
+| DMA       | on-chip    | dma                                 |
++-----------+------------+-------------------------------------+
+
 
 The default configuration can be found in the defconfig file:
 ``boards/arm/mimxrt1064_evk/mimxrt1064_evk_defconfig``
@@ -245,8 +259,8 @@ board with the on-chip PLL to generate a 600 MHz core clock.
 Serial Port
 ===========
 
-The MIMXRT1064 SoC has eight UARTs. One is configured for the console and the
+The MIMXRT1064 SoC has eight UARTs. ``LPUART1`` is configured for the console
-remaining are not used.
+and the remaining are not used.
 
 Programming and Debugging
 *************************
@@ -263,15 +277,18 @@ however the :ref:`pyocd-debug-host-tools` do not yet support programming the
 external flashes on this board so you must reconfigure the board for one of the
 following debug probes instead.
 
-:ref:`jlink-external-debug-probe`
+.. _Using J-Link RT1064:
+
+Using J-Link
 ---------------------------------
 
 Install the :ref:`jlink-debug-host-tools` and make sure they are in your search
 path.
 
-Attach a J-Link 20-pin connector to J21. Check that jumpers J47 and J48 are
+There are two options: the onboard debug circuit can be updated with Segger
-**off** (they are on by default when boards ship from the factory) to ensure
+J-Link firmware, or :ref:`jlink-external-debug-probe` can be attached to the
-SWD signals are disconnected from the OpenSDA microcontroller.
+EVK. See `Using J-Link with MIMXRT1060-EVK or MIMXRT1064-EVK`_ for more
+details.
 
 Configuring a Console
 =====================
@@ -327,12 +344,51 @@ should see the following message in the terminal:
    ***** Booting Zephyr OS v1.14.0-rc1 *****
    Hello World! mimxrt1064_evk
 
+Troubleshooting
+===============
+
+If the debug probe fails to connect with the following error, it's possible
+that the boot header in QSPI flash is invalid or corrupted. The boot header is
+configured by :option:`CONFIG_NXP_IMX_RT_BOOT_HEADER`.
+
+.. code-block:: console
+
+   Remote debugging using :2331
+   Remote communication error.  Target disconnected.: Connection reset by peer.
+   "monitor" command not supported by this target.
+   "monitor" command not supported by this target.
+   You can't do that when your target is `exec'
+   (gdb) Could not connect to target.
+   Please check power, connection and settings.
+
+You can fix it by erasing and reprogramming the QSPI flash with the following
+steps:
+
+#. Set the SW7 DIP switches to ON-OFF-ON-OFF to prevent booting from QSPI flash.
+
+#. Reset by pressing SW9
+
+#. Run ``west debug`` or ``west flash`` again with a known working Zephyr
+   application.
+
+#. Set the SW7 DIP switches to OFF-OFF-ON-OFF to boot from QSPI flash.
+
+#. Reset by pressing SW9
+
+If the west flash or debug commands fail, and the command hangs while executing
+runners.jlink, confirm the J-Link debug probe is configured, powered, and
+connected to the EVK properly.  See :ref:`Using J-Link RT1064` for more
+details.
+
 .. _MIMXRT1064-EVK Website:
    https://www.nxp.com/support/developer-resources/run-time-software/i.mx-developer-resources/mimxrt1064-evk-i.mx-rt1064-evaluation-kit:MIMXRT1064-EVK
 
 .. _MIMXRT1064-EVK Quick Reference Guide:
    https://www.nxp.com/webapp/Download?colCode=IMXRT1064QSG
 
+.. _MIMXRT1064-EVK User Guide:
+   https://www.nxp.com/docs/en/data-sheet/MIMXRT10601064EKBHUG.pdf
+
 .. _MIMXRT1064-EVK Schematics:
    https://www.nxp.com/webapp/Download?colCode=i.MXRT160EVKDS&Parent_nodeId=1537930933174731284155&Parent_pageType=product
 
@@ -344,3 +400,6 @@ should see the following message in the terminal:
 
 .. _i.MX RT1064 Reference Manual:
    https://www.nxp.com/webapp/Download?colCode=IMXRT1064RM
+
+.. _Using J-Link with MIMXRT1060-EVK or MIMXRT1064-EVK:
+   https://community.nxp.com/t5/i-MX-RT-Knowledge-Base/Using-J-Link-with-MIMXRT1060-EVK-or-MIMXRT1064-EVK/ta-p/1281149