.. zephyr:board:: msp_exp432p401r_launchxl

Overview

The SimpleLink MSP‐EXP432P401R LaunchPad development kit is an easy-to-use evaluation module for the SimpleLink MSP432P401R microcontroller. It contains everything needed to start developing on the SimpleLink MSP432 low-power + performance ARM® 32-bit Cortex®-M4F microcontroller (MCU).

Features:

Low-power ARM Cortex-M4F MSP432P401R
40-pin LaunchPad development kit standard that leverages the BoosterPack plug-in module ecosystem
XDS110-ET, an open-source onboard debug probe featuring EnergyTrace+ technology and application UART
Two buttons and two LEDs for user interaction
Backchannel UART through USB to PC

Details on the MSP-EXP432P401R LaunchXL development board can be found in the MSP-EXP432P401R LaunchXL User's Guide.

Supported Features

.. zephyr:board-supported-hw::

The on-board 32-kHz crystal allows for lower LPM3 sleep currents and a higher-precision clock source than the default internal 32-kHz REFOCLK. Therefore, the presence of the crystal allows the full range of low-power modes to be used.
The on-board 48-MHz crystal allows the device to run at its maximum operating speed for MCLK and HSMCLK.

More details about the supported peripherals are available in MSP432P4XX TRM.

Building and Flashing

.. zephyr:board-supported-runners::

Prerequisites:

#. Ensure the XDS-110 emulation firmware is updated.

Download and install the latest XDS-110 emulation package_.

Follow these xds110 firmware update directions <http://software-dl.ti.com/ccs/esd/documents/xdsdebugprobes/emu_xds110.html#updating-the-xds110-firmware>_

Note that the emulation package install may place the xdsdfu utility in <install_dir>/ccs_base/common/uscif/xds110/.

#. Install OpenOCD

You can obtain OpenOCD by following these :ref:installing the latest Zephyr SDK instructions <toolchain_zephyr_sdk>.

After the installation, add the directory containing the OpenOCD executable to your environment's PATH variable. For example, use this command in Linux:

.. code-block:: console

  export PATH=$ZEPHYR_SDK_INSTALL_DIR/sysroots/x86_64-pokysdk-linux/usr/bin/openocd:$PATH

If you had previously installed TI OpenOCD, you can simply switch to use the one in the Zephyr SDK. If for some reason you wish to continue to use your TI OpenOCD installation, you can set the OPENOCD and OPENOCD_DEFAULT_PATH variables in :zephyr_file:boards/ti/msp_exp432p401r_launchxl/board.cmake to point the build to the paths of the OpenOCD binary and its scripts, before including the common openocd.board.cmake file:

.. code-block:: cmake

  set(OPENOCD "/usr/local/bin/openocd" CACHE FILEPATH "" FORCE)
  set(OPENOCD_DEFAULT_PATH /usr/local/share/openocd/scripts)
  include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)

Flashing

Follow the :ref:getting_started instructions for Zephyr application development.

For example, to build and flash the :zephyr:code-sample:hello_world application for the MSP-EXP432P401R LaunchXL:

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: msp_exp432p401r_launchxl :goals: flash

This will load the image into flash.

To see program output from UART0, connect a separate terminal window:

.. code-block:: console

% screen /dev/ttyACM0 115200 8N1

Then press the reset button (S3) on the board to run the program.

Debugging

To debug a previously flashed image, after resetting the board, use the 'debug' build target:

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: msp_exp432p401r_launchxl :maybe-skip-config: :goals: debug

References

.. target-notes::

TI MSP432 Wiki: https://en.wikipedia.org/wiki/TI_MSP432

TI MSP432P401R Product Page: http://www.ti.com/product/msp432p401r

TI MSP432 SDK: http://www.ti.com/tool/SIMPLELINK-MSP432-SDK

.. _UniFlash: http://processors.wiki.ti.com/index.php/UniFlash_v4_Quick_Guide#Command_Line_Interface

.. _CCS IDE: http://www.ti.com/tool/ccstudio

.. _XDS-110 emulation package: http://processors.wiki.ti.com/index.php/XDS_Emulation_Software_Package#XDS_Emulation_Software_.28emupack.29_Download