MCUXpresso for VSCode Zephyr Installation and Troubleshooting FAQ

To get started with Zephyr and MCUXpresso for VS Code, see the Zephyr Knowledge Hub.

Here are some common tips for troubleshooting and resolving installation issues, or issues building Zephyr applications in VS Code. If you have any questions or issues related to these resources, please Ask a new question, and the NXP support team can address it there.

The installation steps use the MCUXpresso Installer, which installs several tools, Python, and many Python modules. If some tools or modules fail to install properly, it can help to try manualling installing these. The Zephyr Project Getting Started page is a good reference for this and gives detailed steps to install everything needed.
See MCUXpresso Installer fails to download a dependency file as a potential workaround.
If the MCUXpresso Installer log shows errors installing a tool, see Installing with Administrator Rights and Manually Install Tools.
To use Python commands from CLI, see Python Virtual Environment used by VS Code.
If errors are related to Python, or missing Python modules like pip, West or others used for Zephyr builds, see Issues with multiple Python versions installed and Missing Python Modules.
If you try to import a Zephyr project, but the desired board is not available in the board list, you likely need to Change the Zephyr revision with Git.
If you try to build a Zephyr project, and it fails because a pinctrl file is missing like MCXN947VDF-pinctrl.h, see Missing pinctrl file and HAL_NXP.
If the build tools run, and there are no issues finding modules or sources files, but there are compiler or linker errors, be sure you are using the correct Zephyr SDK version, see Installing a Zephyr SDK version.

Return to Zephyr Knowledge Hub