SPSDK MCU-Link

0.6.6 verified Fri May 01 auth: no python

A debugger probe plugin for SPSDK (NXP's Secure Provisioning SDK) that adds support for LPC-Link and MCU-Link probes from NXP. Version 0.6.6; released as part of the SPSDK Plugins 3.2.0 release. Maintained by NXP with an active development cadence tied to SPSDK releases.

pip install spsdk-mcu-link

Common errors

error ModuleNotFoundError: No module named 'spsdk_mcu_link' ↓

cause Import path incorrectly uses hyphens instead of dots.

fix

Use 'from spsdk.mcu_link.debug_probe import MCULinkDebugProbe'.

error spsdk.mcu_link.debug_probe.MCULinkDebugProbe: Cannot open device: No MCU-Link found ↓

cause The probe is not connected or not recognized (e.g., missing udev rules on Linux).

fix

Check USB connection, install udev rules, or run with administrator privileges on Windows.

error ImportError: cannot import name 'MCULink' from 'spsdk.mcu_link' ↓

cause Trying to import a class that doesn't exist in the expected location.

fix

Check the correct symbol name; use 'from spsdk.mcu_link.debug_probe import MCULinkDebugProbe'.

Warnings

gotcha Import path uses dots (spsdk.mcu_link) not hyphens (spsdk-mcu-link). The PyPI package name does not match the Python module path. ↓

fix Use 'from spsdk.mcu_link...' instead of 'from spsdk_mcu_link...'.

deprecated The class 'MCULinkDebugProbe' was renamed from 'MCULinkDebugProbe' (case?) in v0.6.0; check older documentation for possibly different class names. ↓

fix Use the latest class name from the official SPSDK MCU-Link documentation.

gotcha Requires Python >=3.9; may cause installation errors on older Python versions. ↓

fix Upgrade Python to 3.9 or later.

gotcha On Linux, udev rules may be required to access USB devices. Without them, the probe may not be detected. ↓

fix Install udev rules from the SPSDK documentation or the package extras (e.g., 'pip install spsdk-mcu-link[udev]' if available).

Imports

MCULinkDebugProbe

from spsdk.mcu_link.debug_probe import MCULinkDebugProbe

MCULink
wrong
```
from spsdk_mcu_link import MCULink
```
correct
```
from spsdk.mcu_link.mcu_link import MCULink
```
The package is installed as 'spsdk-mcu-link' but the import path uses 'spsdk.mcu_link' (without hyphens).

Quickstart

Opens a default MCU-Link probe and prints its status. No authentication required as it uses local USB connection.

import os
from spsdk.mcu_link.debug_probe import MCULinkDebugProbe
# This will attempt to open the first available MCU-Link
probe = MCULinkDebugProbe()
print("Probe opened:", probe.is_opened())