Plugins#
SPSDK allows user to install additional plugins and integrate them with SPSDK functionality. They allow to extend the normal SPSDK functionality with additional features.
SPSDK 2.2 changes#
Due to increasingly complex codebase it was decided to move some functionality into plugins. This allows to keep the core SPSDK codebase clean and focused on the main functionality. The repository containing the plugins is located at: nxp-mcuxpresso/spsdk_plugins Plugins are also released on PyPi.
Affected functionality is the following:
J-Link debug probe support (using the PyLink library), installable via
pip install spsdk-jlink
PE Micro debug probe support, installable via
pip install spsdk-pemicro
Added support for Lauterbach debug probe, installable via
pip install spsdk-lauterbach
J-Link and PE Micro over PyOCD is kept in the base SPSDK installation.
Supported plugin types#
The table bellow shows the list of support plugin types with associated package entrypoints, cookiecutter templates and base class they are derived from.
Plugin |
Entrypoint |
Template name |
Base class |
---|---|---|---|
Signature Provider |
spsdk.sp |
cookiecutter-spsdk-sp-plugin.zip |
spsdk.crypto.signature_provider.SignatureProvider |
Mboot Device Interface |
spsdk.device.interface |
cookiecutter-spsdk-device-interface-plugin.zip |
spsdk.mboot.protocol.base.MbootProtocolBase |
SDP Device Interface |
spsdk.device.interface |
cookiecutter-spsdk-device-interface-plugin.zip |
spsdk.sdp.protocol.base.SDPProtocolBase |
WPC Service |
spsdk.wpc.service |
cookiecutter-spsdk-wpc-service-plugin.zip |
spsdk.wpc.utils.WPCCertificateService |
Debug probe |
spsdk.debug_probe |
cookiecutter-spsdk-debug-probe-plugin.zip |
spsdk.debuggers.debug_probe.DebugProbeCoreSightOnly |
Plugin implementation#
There are basically two ways how a plugin can be implemented.
A Python package installed in the environment (preferred)
A single Python module with the plugin implementation in it
The actual implementation depends on actual plugin type. In general every plugin must be derived from the plugin base class and implement it’s methods.
Plugin as a Python package#
All the plugins installed in the Python environment will be discovered automatically. The only requirement for package is to add specific entrypoint metadata into the package.
You can find the list of plugin entrypoints based on the plugin type in the table above.
In order to make the implementation of the plugins easier, a cookiecutter template can be used.
You can find all the cookiecutter templates in the /templates
folder.
The instructions for generating plugin package from cookiecutter template:
Install cookiecutter:
pip install cookiecutter
Create plugin:
cookiecutter <spsdk_root>/examples/plugins/templates/<plugin_template>.zip
Follow the instructions in the command prompt
A new plugin package is created in current folder
Install plugin:
pip install <my_project_path>
(for development use-e/--editable
flag)
Plugin as a single Python module#
In some situations the installation into the Python environment is not possible.
For such scenarios a plugin as a single Python module can be implemented.
In this case the plugin is not loaded automatically.
The plugin will be loaded if the --plugin <path_to_py_file>
option is used in SPSDK application command.