boards/nxp/frdm_ke17z512/doc/index.rst
.. zephyr:board:: frdm_ke17z512
Overview
The FRDM-KE17Z512 is a development board for NXP Kinetis KE1xZ 32-bit MCU-based platforms. The onboard OpenSDAv2 serial and debug adapter, running an open source bootloader, offers options for serial communication, flash programming, and run-control debugging.
Hardware
For more information about the KE1xZ SoC and the FRDM-KE17Z512 board, see these NXP reference documents:
KE1xZ Website_KE1xZ Fact Sheet_KE1xZ Reference Manual_FRDM-KE17Z512 Website_FRDM-KE17Z512 Quick Start Guide_FRDM-KE17Z512 Reference Manual_.. zephyr:board-supported-hw::
The KE17Z9 SoC is configured to run at 72 MHz using the LPFLL.
The KE17Z9 SoC has three LPUARTs. UART2 is configured for the console.
Programming and Debugging
.. zephyr:board-supported-runners::
Build and flash applications as usual (see :ref:build_an_application and
:ref:application_run for more details).
A debug probe is used for both flashing and debugging the board. This board is configured by default to use Linkserver.
Early versions of this board have an outdated version of the OpenSDA bootloader
and require an update. Please see the DAPLink Bootloader Update_ page for
instructions to update from the CMSIS-DAP bootloader to the DAPLink bootloader.
Install the :ref:linkserver-debug-host-tools and make sure they are in your
search path. LinkServer works with the default CMSIS-DAP firmware included in
the on-board debugger.
Linkserver is the default for this board, west flash and west debug will
call the linkserver runner.
opensda-jlink-onboard-debug-probeInstall 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 Segger J-Link OpenSDA V2.1 Firmware_.
Use the -r jlink option with west to use the jlink runner.
.. code-block:: console
west flash -r jlink
Regardless of your choice in debug probe, we will use the OpenSDA microcontroller as a usb-to-serial adapter for the serial console.
Connect a USB cable from your PC to J10.
Use the following settings with your serial terminal of choice (minicom, putty, etc.):
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: frdm_ke17z512 :goals: flash
Open a serial terminal, reset the board (press the SW1 button), and you should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v3.6.0-xxxx-gxxxxxxxxxxxx *** Hello World! frdm_ke17z512/mke17z9
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: frdm_ke17z512 :goals: debug
Open a serial terminal, step through the application in your debugger, and you should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v3.6.0-xxxx-gxxxxxxxxxxxx *** Hello World! frdm_ke17z512/mke17z9
.. include:: ../../common/board-footer.rst.inc
.. _FRDM-KE17Z512 Website: https://www.nxp.com/design/design-center/development-boards-and-designs/general-purpose-mcus/frdm-development-board-for-96-mhz-ke17z-ke13z-ke12z-with-512-kb-flash-mcus:FRDM-KE17Z512
.. _FRDM-KE17Z512 Quick Start Guide: https://www.nxp.com/docs/en/quick-reference-guide/FRDMKE17Z512QSG.pdf
.. _FRDM-KE17Z512 Reference Manual: https://www.nxp.com/docs/en/reference-manual/KE1XZP100M96SF0RM.pdf
.. _KE1xZ Fact Sheet: https://www.nxp.com/docs/en/fact-sheet/KE1xZMCUFAMFS.pdf
.. _KE1xZ Reference Manual: https://www.nxp.com/webapp/Download?colCode=KE1XZP100M72SF0RM
.. _linkserver-debug-host-tools: https://www.nxp.com/lgfiles/updates/mcuxpresso/LinkServer_1.5.30.exe
.. _Segger J-Link OpenSDA V2.1 Firmware: https://www.segger.com/downloads/jlink/OpenSDA_V2_1.bin
.. _DAPLink Bootloader Update: https://os.mbed.com/blog/entry/DAPLink-bootloader-update/
.. _jlink-debug-host-tools: https://www.segger.com/downloads/jlink/JLink_Windows_V794_x86_64.exe