|
| 1 | +.. zephyr:board:: mcxw72_evk |
| 2 | +
|
| 3 | +Overview |
| 4 | +******** |
| 5 | + |
| 6 | +The MCXW72-EVK |
| 7 | + |
| 8 | +The MCX W72x family features a 96 MHz Arm® Cortex®-M33 core coupled with a |
| 9 | +multiprotocol radio subsystem supporting Matter, Thread, Zigbee and |
| 10 | +Bluetooth LE. The independent radio subsystem, with a dedicated core and |
| 11 | +memory, offloads the main CPU, preserving it for the primary application and |
| 12 | +allowing firmware updates to support future wireless standards. |
| 13 | + |
| 14 | +Hardware |
| 15 | +******** |
| 16 | + |
| 17 | +- MCXW72 Arm Cortex-M33 microcontroller running up to 96 MHz |
| 18 | +- 2MB on-chip Flash memory unit |
| 19 | +- 256 KB TCM RAM |
| 20 | +- On-board MCU-Link debugger with CMSIS-DAP |
| 21 | + |
| 22 | +For more information about the MCXW72 SoC and MCXW72-EVK board, see: |
| 23 | + |
| 24 | +- `MCXW72 SoC Website`_ |
| 25 | +- `MCXW72-EVK Website`_ |
| 26 | + |
| 27 | +Supported Features |
| 28 | +================== |
| 29 | + |
| 30 | +The ``mcxw72_evk`` board in Zephyr currently supports the following features: |
| 31 | + |
| 32 | ++-----------+------------+-------------------------------------+ |
| 33 | +| Interface | Controller | Driver/Component | |
| 34 | ++===========+============+=====================================+ |
| 35 | +| NVIC | on-chip | nested vector interrupt controller | |
| 36 | ++-----------+------------+-------------------------------------+ |
| 37 | +| SYSTICK | on-chip | systick | |
| 38 | ++-----------+------------+-------------------------------------+ |
| 39 | +| PINMUX | on-chip | pinctrl | |
| 40 | ++-----------+------------+-------------------------------------+ |
| 41 | +| GPIO | on-chip | gpio | |
| 42 | ++-----------+------------+-------------------------------------+ |
| 43 | +| LPUART | on-chip | serial port-polling; | |
| 44 | +| | | serial port-interrupt | |
| 45 | ++-----------+------------+-------------------------------------+ |
| 46 | +| TPM | on-chip | pwm | |
| 47 | ++-----------+------------+-------------------------------------+ |
| 48 | +| LPTMR | on-chip | counter | |
| 49 | ++-----------+------------+-------------------------------------+ |
| 50 | +| SPI | on-chip | spi | |
| 51 | ++-----------+------------+-------------------------------------+ |
| 52 | +| FLEXCAN | on-chip | can | |
| 53 | ++-----------+------------+-------------------------------------+ |
| 54 | +| ADC | on-chip | adc | |
| 55 | ++-----------+------------+-------------------------------------+ |
| 56 | +| I2C | on-chip | i2c | |
| 57 | ++-----------+------------+-------------------------------------+ |
| 58 | + |
| 59 | +Programming and Debugging |
| 60 | +************************* |
| 61 | + |
| 62 | +Build and flash applications as usual (see :ref:`build_an_application` and |
| 63 | +:ref:`application_run` for more details). |
| 64 | + |
| 65 | +Configuring a Debug Probe |
| 66 | +========================= |
| 67 | + |
| 68 | +A debug probe is used for both flashing and debugging the board. This board is |
| 69 | +configured by default to use the MCU-Link CMSIS-DAP Onboard Debug Probe. |
| 70 | + |
| 71 | +Using LinkServer |
| 72 | +---------------- |
| 73 | + |
| 74 | +Linkserver is the default runner for this board, and supports the factory |
| 75 | +default MCU-Link firmware. Follow the instructions in |
| 76 | +:ref:`mcu-link-cmsis-onboard-debug-probe` to reprogram the default MCU-Link |
| 77 | +firmware. This only needs to be done if the default onboard debug circuit |
| 78 | +firmware was changed. To put the board in ``DFU mode`` to program the firmware, |
| 79 | +short jumper JP20. |
| 80 | + |
| 81 | +Using J-Link |
| 82 | +------------ |
| 83 | + |
| 84 | +There are two options. The onboard debug circuit can be updated with Segger |
| 85 | +J-Link firmware by following the instructions in |
| 86 | +:ref:`mcu-link-jlink-onboard-debug-probe`. |
| 87 | +To be able to program the firmware, you need to put the board in ``DFU mode`` |
| 88 | +by shortening the jumper JP20. |
| 89 | +The second option is to attach a :ref:`jlink-external-debug-probe` to the |
| 90 | +10-pin SWD connector (J16) of the board. |
| 91 | +For both options use the ``-r jlink`` option with west to use the jlink runner. |
| 92 | + |
| 93 | +.. code-block:: console |
| 94 | +
|
| 95 | + west flash -r jlink |
| 96 | +
|
| 97 | +Configuring a Console |
| 98 | +===================== |
| 99 | + |
| 100 | +Connect a USB cable from your PC to J14, and use the serial terminal of your choice |
| 101 | +(minicom, putty, etc.) with the following settings: |
| 102 | + |
| 103 | +- Speed: 115200 |
| 104 | +- Data: 8 bits |
| 105 | +- Parity: None |
| 106 | +- Stop bits: 1 |
| 107 | + |
| 108 | +Flashing |
| 109 | +======== |
| 110 | + |
| 111 | +Here is an example for the :zephyr:code-sample:`hello_world` application. |
| 112 | + |
| 113 | +.. zephyr-app-commands:: |
| 114 | + :zephyr-app: samples/hello_world |
| 115 | + :board: mcxw72_evk/mcxw727c/cpu0 |
| 116 | + :goals: flash |
| 117 | + |
| 118 | +Open a serial terminal, reset the board (press the RESET button), and you should |
| 119 | +see the following message in the terminal: |
| 120 | + |
| 121 | +.. code-block:: console |
| 122 | +
|
| 123 | + *** Booting Zephyr OS build v3.7.0-xxx-xxxx *** |
| 124 | + Hello World! mcxw72_evk/mcxw727c/cpu0 |
| 125 | +
|
| 126 | +Debugging |
| 127 | +========= |
| 128 | + |
| 129 | +Here is an example for the :zephyr:code-sample:`hello_world` application. |
| 130 | + |
| 131 | +.. zephyr-app-commands:: |
| 132 | + :zephyr-app: samples/hello_world |
| 133 | + :board: mcxw72_evk/mcxw727c/cpu0 |
| 134 | + :goals: debug |
| 135 | + |
| 136 | +Open a serial terminal, step through the application in your debugger, and you |
| 137 | +should see the following message in the terminal: |
| 138 | + |
| 139 | +.. code-block:: console |
| 140 | +
|
| 141 | + *** Booting Zephyr OS build v3.7.0-xxx-xxxx *** |
| 142 | + Hello World! mcxw72_evk/mcxw727c/cpu0 |
| 143 | +
|
| 144 | +Troubleshooting |
| 145 | +=============== |
| 146 | + |
| 147 | +.. include:: ../../common/segger-ecc-systemview.rst |
| 148 | + :start-after: segger-ecc-systemview |
| 149 | + |
| 150 | +References |
| 151 | +********** |
| 152 | + |
| 153 | +.. target-notes:: |
| 154 | + |
| 155 | +.. _MCXW72 SoC Website: |
| 156 | + https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/mcx-arm-cortex-m/mcx-w-series-microcontrollers/mcx-w72x-secure-and-ultra-low-power-mcus-for-matter-thread-zigbee-and-bluetooth-le:MCX-W72X |
| 157 | + |
| 158 | +.. _MCXW72-EVK Website: |
0 commit comments