spsdk-pemicro 0.1.0__tar.gz

spsdk_pemicro-0.1.0/LICENSE

@@ -0,0 +1,31 @@
+
+
+BSD 3-Clause "New" or "Revised" License
+
+Copyright 2024 NXP
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this
+  list of conditions and the following disclaimer in the documentation and/or
+  other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+OF THE POSSIBILITY OF SUCH DAMAGE.
+

spsdk_pemicro-0.1.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include CONTRIBUTING.rst
+include HISTORY.rst
+include LICENSE
+include README.rst
+include SW_Content_Register_spsdk_pemicro.txt
+include requirements*
+
+recursive-include tests *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude .github *
+
+recursive-include docs *.rst conf.py Makefile make.bat *.jpg *.png *.gif

spsdk_pemicro-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.1
+Name: spsdk-pemicro
+Version: 0.1.0
+Summary: P&E Micro debugger probe plugin. A debugger probe plugin for SPSDK.
+Author: NXP
+Maintainer-email: NXP <michal.starecek@nxp.com>
+License: BSD-3-Clause
+Project-URL: Homepage, https://github.com/nxp-mcuxpresso/spsdk_plugins/tree/master/pemicro
+Project-URL: Issues, https://github.com/nxp-mcuxpresso/spsdk_plugins/issues
+Keywords: NXP,SPSDK,pemicro
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: spsdk>=2.2.0
+Requires-Dist: pypemicro>=0.1.11
+
+
+P&E Micro debugger probe plugin
+===============================
+
+
+* Free software: BSD-3-Clause
+
+
+Features
+--------
+
+* Allow SPSDK to use P&E Micro as an interface for debugger probes.
+
+
+Installation
+------------
+
+* Activate virtual env, where you have SPSDK
+    - if SPSDK is not installed, the latest one will be installed automatically from [PyPI](https://pypi.org/project/spsdk/)
+* `pip install spsdk-pemicro`
+* Verify installation by running `nxpdebugmbox --help`
+    - you should see `pemicro` amongst available interfaces (--interface)
+
+
+Credits
+-------
+
+This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [SPSDK Debug Probe project template](https://github.com/nxp-mcuxpresso/spsdk/blob/master/examples/plugins/templates/cookiecutter-spsdk-debug-probe-plugin.zip).

spsdk_pemicro-0.1.0/README.md

@@ -0,0 +1,28 @@
+
+P&E Micro debugger probe plugin
+===============================
+
+
+* Free software: BSD-3-Clause
+
+
+Features
+--------
+
+* Allow SPSDK to use P&E Micro as an interface for debugger probes.
+
+
+Installation
+------------
+
+* Activate virtual env, where you have SPSDK
+    - if SPSDK is not installed, the latest one will be installed automatically from [PyPI](https://pypi.org/project/spsdk/)
+* `pip install spsdk-pemicro`
+* Verify installation by running `nxpdebugmbox --help`
+    - you should see `pemicro` amongst available interfaces (--interface)
+
+
+Credits
+-------
+
+This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [SPSDK Debug Probe project template](https://github.com/nxp-mcuxpresso/spsdk/blob/master/examples/plugins/templates/cookiecutter-spsdk-debug-probe-plugin.zip).

spsdk_pemicro-0.1.0/SW_Content_Register_spsdk_pemicro.txt

@@ -0,0 +1,10 @@
+NXP Software Content Register
+
+Package:                   spsdk-pemicro
+Version:                   0.1.0
+Outgoing License:          BSD-3-Clause
+License Files:             LICENSE
+Type of content:           Source code
+Description and comments:  NXP Secure Provisioning SDK Team - Debug Probe plugin for PEmicro probes
+Origin:                    NXP (BSD-3-Clause)
+URL:                       https://github.com/nxp-mcuxpresso/spsdk_plugins/tree/master/pemicro

spsdk_pemicro-0.1.0/pyproject.toml

@@ -0,0 +1,209 @@
+[project]
+name = "spsdk-pemicro"
+description = "P&E Micro debugger probe plugin. A debugger probe plugin for SPSDK."
+dynamic = ["version"]
+
+entry-points = { "spsdk.debug_probe" = { pemicro = "spsdk_pemicro.probe" } }
+
+requires-python = ">= 3.9"
+dependencies = ["spsdk>=2.2.0", "pypemicro>=0.1.11"]
+
+authors = [{ name = "NXP" }]
+maintainers = [{ name = "NXP", email = "michal.starecek@nxp.com" }]
+readme = { file = "README.md", content-type = "text/markdown" }
+license = { text = "BSD-3-Clause" }
+
+keywords = ["NXP", "SPSDK", "pemicro"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/nxp-mcuxpresso/spsdk_plugins/tree/master/pemicro"
+Issues = "https://github.com/nxp-mcuxpresso/spsdk_plugins/issues"
+
+
+[build-system]
+requires = ["setuptools >= 61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["spsdk_pemicro"]
+
+[tool.setuptools.dynamic]
+version = { attr = "spsdk_pemicro.__version__" }
+
+[tool.bumpversion]
+current_version = "0.1.0"
+
+[[tool.bumpversion.files]]
+filename = "spsdk_pemicro/__init__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "SW_Content_Register_spsdk_peicro.txt"
+search = "{current_version}"
+replace = "{new_version}"
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+junit_family = "xunit1"
+
+[tool.coverage.report]
+exclude_lines = ["pragma: no cover", "safe_main()", "sys.exit(main())"]
+
+[tool.coverage.run]
+relative_files = true
+
+[tool.black]
+line-length = 100
+target-version = ["py39", "py310", "py311", "py312"]
+include = '\.pyi?$'
+
+[tool.isort]
+multi_line_output = 3
+include_trailing_comma = true
+force_grid_wrap = 0
+use_parentheses = true
+ensure_newline_before_comments = true
+line_length = 100
+
+[tool.mypy]
+disallow_untyped_defs = true
+ignore_missing_imports = true
+warn_unused_ignores = true
+
+[tool.pydocstyle]
+convention = "google"
+add_ignore = "D105,D301"
+match = '(?!test_|__version__).*\.py'
+
+[tool.pylint]
+format = { max-line-length = 120 }
+"messages control" = { disable = ["logging-fstring-interpolation"] }
+
+
+[tool.checker_depencecies.spdx]
+"Apache-2.0" = [
+    "Apache 2.0",
+    "Apache-2.0 License",
+    "Apache Software License 2.0",
+    "Apache License, Version 2.0",
+    "Apache License 2.0",
+    "Apache Software License",
+]
+"BSD-2-Clause" = ["BSD", "BSD 2-Clause License"]
+"BSD-3-Clause" = [
+    "BSD",
+    "BSD License",
+    "BSD 3-Clause",
+    "BSD (3 clause)",
+    "BSD 3-Clause License",
+    "Modified BSD License",
+]
+"MIT" = ["MIT License", "MIT license"]
+"MPL-2.0" = ["MPL 2.0", "Mozilla Public License 2.0 (MPL 2.0)"]
+"NLPL" = ["Public domain", "Public Domain"]
+"PSF-2.0" = ["PSF", "PSFL", "Python Software Foundation License"]
+"GPL-2.0-or-later" = []
+"LGPL-2.0-only" = ["LGPL-2.0"]
+"LGPL-2.1-or-later" = []
+"LGPL-3.0-only" = ["LGPL-3.0"]
+"ISC" = ["ISC license"]
+
+[tool.nxp_codecheck]
+git_parent_branch = "origin/master"
+output_directory = "reports"
+default_check_paths = ["spsdk_pemicro"]
+
+# *********************************** Checker list ***********************************
+[[tool.nxp_codecheck.checkers]]
+name = "PYTEST"
+method = "check_pytest"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+kwargs = { disable_xdist = false }
+
+# [[tool.nxp_codecheck.checkers]]
+#     name = "GITCOV"
+#     method = "check_gitcov"
+#     # check_paths = [] # The default check paths could be overrides by local settings
+#     info_only = true
+#     dependencies = ["PYTEST"]
+[[tool.nxp_codecheck.checkers]]
+name = "PYLINT"
+method = "check_pylint"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+[[tool.nxp_codecheck.checkers]]
+name = "MYPY"
+method = "check_mypy"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+[[tool.nxp_codecheck.checkers]]
+name = "DEPENDENCIES"
+method = "check_dependencies"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+fixer = "fix_dependencies"
+[[tool.nxp_codecheck.checkers]]
+name = "PYDOCSTYLE"
+method = "check_pydocstyle"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+[[tool.nxp_codecheck.checkers]]
+name = "RADON_C"
+method = "check_radon"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = true
+kwargs = { min_rank = "C" }
+[[tool.nxp_codecheck.checkers]]
+name = "RADON_D"
+method = "check_radon"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+kwargs = { min_rank = "D" }
+[[tool.nxp_codecheck.checkers]]
+name = "BLACK"
+method = "check_black"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+dependencies = []
+fixer = "fix_black"
+[[tool.nxp_codecheck.checkers]]
+name = "ISORT"
+method = "check_isort"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+dependencies = []
+fixer = "fix_isort"
+[[tool.nxp_codecheck.checkers]]
+name = "COPYRIGHT"
+method = "check_copyright_year"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+dependencies = []
+fixer = "fix_copyright_year"
+[[tool.nxp_codecheck.checkers]]
+name = "PY_HEADERS"
+method = "check_py_file_headers"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+dependencies = []
+fixer = "fix_py_file_headers"
+[[tool.nxp_codecheck.checkers]]
+name = "CYCLIC"
+method = "check_cyclic_imports"
+# check_paths = [] # The default check paths could be overrides by local settings
+info_only = false
+dependencies = []

spsdk_pemicro-0.1.0/requirements_dev.txt

@@ -0,0 +1,10 @@
+# package management
+build
+bump-my-version
+twine
+
+# testing
+tox
+
+# code quality
+nxp-codecheck

spsdk_pemicro-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

spsdk_pemicro-0.1.0/spsdk_pemicro/__init__.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+#
+# Copyright 2024 NXP
+#
+# SPDX-License-Identifier: BSD-3-Clause
+"""Top-level package for P&E Micro debugger probe plugin."""
+
+__author__ = """NXP"""
+__email__ = "starecek.michal@nxp.com"
+__version__ = "0.1.0"
+
+from .probe import DebugProbePemicro
+
+__all__ = ["DebugProbePemicro"]

spsdk_pemicro-0.1.0/spsdk_pemicro/probe.py

@@ -0,0 +1,223 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+#
+# Copyright 2024 NXP
+#
+# SPDX-License-Identifier: BSD-3-Clause
+"""Main module for P&E Micro debugger probe plugin."""
+
+import logging
+from typing import Dict, Optional
+
+from pypemicro import PEMicroException, PEMicroInterfaces, PyPemicro
+from spsdk.debuggers.debug_probe import (
+    DebugProbeCoreSightOnly,
+    DebugProbes,
+    ProbeDescription,
+    SPSDKDebugProbeError,
+    SPSDKDebugProbeNotOpenError,
+    SPSDKDebugProbeTransferError,
+)
+from spsdk.utils.misc import value_to_int
+
+logger = logging.getLogger(__name__)
+logger_pypemicro = logger.getChild("PyPemicro")
+
+
+class DebugProbePemicro(DebugProbeCoreSightOnly):
+    """Class to define Pemicro package interface for NXP SPSDK."""
+
+    NAME = "pemicro"
+
+    @staticmethod
+    def get_options_help() -> Dict[str, str]:
+        """Get full list of options of debug probe.
+
+        :return: Dictionary with individual options. Key is parameter name and value the help text.
+        """
+        options_help = {}
+        options_help.update(
+            {
+                "frequency": "Set the communication frequency in Hz, default is 100_000Hz",
+            }
+        )
+        options_help.update(DebugProbeCoreSightOnly.get_options_help())
+
+        return options_help
+
+    @classmethod
+    def get_pemicro_lib(cls) -> PyPemicro:
+        """Get Pemicro object.
+
+        :return: The Pemicro Object
+        :raises SPSDKDebugProbeError: The Pemicro object get function failed.
+        """
+        try:
+            return PyPemicro(
+                log_info=logger_pypemicro.info,
+                log_debug=logger_pypemicro.debug,
+                log_err=logger_pypemicro.error,
+                log_war=logger_pypemicro.warn,
+            )
+        except PEMicroException as exc:
+            raise SPSDKDebugProbeError(f"Cannot get Pemicro library: ({str(exc)})") from exc
+
+    def __init__(self, hardware_id: str, options: Optional[Dict] = None) -> None:
+        """The Pemicro class initialization.
+
+        The Pemicro initialization function for SPSDK library to support various DEBUG PROBES.
+        """
+        super().__init__(hardware_id, options)
+
+        self.pemicro: Optional[PyPemicro] = None
+
+        logger.debug("The SPSDK Pemicro Interface has been initialized")
+
+    # pylint: disable=unused-argument # we need to satisfy the method signature
+    @classmethod
+    def get_connected_probes(
+        cls, hardware_id: Optional[str] = None, options: Optional[Dict] = None
+    ) -> DebugProbes:
+        """Get all connected probes over Pemicro.
+
+        This functions returns the list of all connected probes in system by Pemicro package.
+
+        :param hardware_id: None to list all probes, otherwise the the only probe with matching
+            hardware id is listed.
+        :param options: The options dictionary
+        :return: probe_description
+        """
+        probes = DebugProbes()
+        try:
+            connected_probes = PyPemicro.list_ports()
+            for probe in connected_probes:
+                if not hardware_id or hardware_id == str(probe["id"]):
+                    probes.append(
+                        ProbeDescription(
+                            "PEMicro", probe["id"], probe["description"], DebugProbePemicro
+                        )
+                    )
+        except PEMicroException as exc:
+            logger.warning(f"Cannot get list of PEMicro probes: {str(exc)}")
+        return probes
+
+    def open(self) -> None:
+        """Open Pemicro interface for NXP SPSDK.
+
+        The Pemicro opening function for SPSDK library to support various DEBUG PROBES.
+        The function is used to initialize the connection to target and enable using debug probe
+        for DAT purposes.
+
+        :raises SPSDKDebugProbeError: Opening of the debug probe failed
+        """
+        try:
+            self.pemicro = DebugProbePemicro.get_pemicro_lib()
+            if self.pemicro is None:
+                raise SPSDKDebugProbeError("Getting of Pemicro library failed.")
+        except SPSDKDebugProbeError as exc:
+            raise SPSDKDebugProbeError(f"Getting of Pemicro library failed({str(exc)}).") from exc
+        try:
+            self.pemicro.open(debug_hardware_name_ip_or_serialnum=self.hardware_id)
+        except PEMicroException as exc:
+            raise SPSDKDebugProbeError(f"Opening the debug probe failed ({str(exc)})") from exc
+
+    def connect(self) -> None:
+        """Connect to target.
+
+        The Pemicro connecting function for SPSDK library to support various DEBUG PROBES.
+        The function is used to initialize the connection to target
+
+        :raises SPSDKDebugProbeError: The Pemicro cannot establish communication with target
+        """
+        if self.pemicro is None:
+            raise SPSDKDebugProbeError("Debug probe must be opened first")
+        try:
+            self.pemicro.connect(PEMicroInterfaces.SWD)
+            self.pemicro.set_debug_frequency(value_to_int(self.options.get("frequency", 100000)))
+            self.clear_sticky_errors()
+            self.power_up_target()
+
+        except PEMicroException as exc:
+            raise SPSDKDebugProbeError(
+                f"Pemicro cannot establish communication with target({str(exc)})."
+            ) from exc
+
+    def close(self) -> None:
+        """Close Pemicro interface.
+
+        The Pemicro closing function for SPSDK library to support various DEBUG PROBES.
+        """
+        if self.pemicro:
+            self.pemicro.close()
+
+    def coresight_reg_read(self, access_port: bool = True, addr: int = 0) -> int:
+        """Read coresight register over Pemicro interface.
+
+        The Pemicro read coresight register function for SPSDK library to support various DEBUG PROBES.
+
+        :param access_port: if True, the Access Port (AP) register will be read(default), otherwise the Debug Port
+        :param addr: the register address
+        :return: The read value of addressed register (4 bytes)
+        :raises SPSDKDebugProbeTransferError: The IO operation failed
+        :raises SPSDKDebugProbeNotOpenError: The Pemicro probe is NOT opened
+        """
+        if self.pemicro is None:
+            raise SPSDKDebugProbeNotOpenError("The Pemicro debug probe is not opened yet")
+
+        try:
+            if access_port:
+                ap_ix = (addr & self.APSEL_APBANKSEL) >> self.APSEL_SHIFT
+                ret = self.pemicro.read_ap_register(apselect=ap_ix, addr=addr)
+            else:
+                ret = self.pemicro.read_dp_register(addr=addr)
+            return ret
+        except PEMicroException as exc:
+            self._reinit_target()
+            raise SPSDKDebugProbeTransferError(
+                f"The Coresight read operation failed({str(exc)})."
+            ) from exc
+
+    def coresight_reg_write(self, access_port: bool = True, addr: int = 0, data: int = 0) -> None:
+        """Write coresight register over Pemicro interface.
+
+        The Pemicro write coresight register function for SPSDK library to support various DEBUG PROBES.
+
+        :param access_port: if True, the Access Port (AP) register will be write(default), otherwise the Debug Port
+        :param addr: the register address
+        :param data: the data to be written into register
+        :raises SPSDKDebugProbeTransferError: The IO operation failed
+        :raises SPSDKDebugProbeNotOpenError: The Pemicro probe is NOT opened
+        """
+        if self.pemicro is None:
+            raise SPSDKDebugProbeNotOpenError("The Pemicro debug probe is not opened yet")
+
+        try:
+            if access_port:
+                ap_ix = (addr & self.APSEL_APBANKSEL) >> self.APSEL_SHIFT
+                self.pemicro.write_ap_register(apselect=ap_ix, addr=addr, value=data)
+            else:
+                self.pemicro.write_dp_register(addr=addr, value=data)
+
+        except PEMicroException as exc:
+            self._reinit_target()
+            raise SPSDKDebugProbeTransferError(
+                f"The Coresight write operation failed({str(exc)})."
+            ) from exc
+
+    def assert_reset_line(self, assert_reset: bool = False) -> None:
+        """Control reset line at a target.
+
+        :param assert_reset: If True, the reset line is asserted(pulled down), if False the reset line is not affected.
+        :raises SPSDKDebugProbeNotOpenError: The Pemicro debug probe is not opened yet
+        :raises SPSDKDebugProbeError: The PyPEMicro probe RESET function failed
+        """
+        if self.pemicro is None:
+            raise SPSDKDebugProbeNotOpenError("The Pemicro debug probe is not opened yet")
+
+        try:
+            if assert_reset:
+                self.pemicro.control_reset_line(True)
+            else:
+                self.pemicro.control_reset_line(False)
+        except PEMicroException as exc:
+            raise SPSDKDebugProbeError(f"Pemicro reset operation failed: {str(exc)}") from exc

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.1
+Name: spsdk-pemicro
+Version: 0.1.0
+Summary: P&E Micro debugger probe plugin. A debugger probe plugin for SPSDK.
+Author: NXP
+Maintainer-email: NXP <michal.starecek@nxp.com>
+License: BSD-3-Clause
+Project-URL: Homepage, https://github.com/nxp-mcuxpresso/spsdk_plugins/tree/master/pemicro
+Project-URL: Issues, https://github.com/nxp-mcuxpresso/spsdk_plugins/issues
+Keywords: NXP,SPSDK,pemicro
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: spsdk>=2.2.0
+Requires-Dist: pypemicro>=0.1.11
+
+
+P&E Micro debugger probe plugin
+===============================
+
+
+* Free software: BSD-3-Clause
+
+
+Features
+--------
+
+* Allow SPSDK to use P&E Micro as an interface for debugger probes.
+
+
+Installation
+------------
+
+* Activate virtual env, where you have SPSDK
+    - if SPSDK is not installed, the latest one will be installed automatically from [PyPI](https://pypi.org/project/spsdk/)
+* `pip install spsdk-pemicro`
+* Verify installation by running `nxpdebugmbox --help`
+    - you should see `pemicro` amongst available interfaces (--interface)
+
+
+Credits
+-------
+
+This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [SPSDK Debug Probe project template](https://github.com/nxp-mcuxpresso/spsdk/blob/master/examples/plugins/templates/cookiecutter-spsdk-debug-probe-plugin.zip).

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+SW_Content_Register_spsdk_pemicro.txt
+pyproject.toml
+requirements_dev.txt
+spsdk_pemicro/__init__.py
+spsdk_pemicro/probe.py
+spsdk_pemicro.egg-info/PKG-INFO
+spsdk_pemicro.egg-info/SOURCES.txt
+spsdk_pemicro.egg-info/dependency_links.txt
+spsdk_pemicro.egg-info/entry_points.txt
+spsdk_pemicro.egg-info/requires.txt
+spsdk_pemicro.egg-info/top_level.txt
+tests/__init__.py
+tests/test_integration.py

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[spsdk.debug_probe]
+pemicro = spsdk_pemicro.probe

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/requires.txt

@@ -0,0 +1,2 @@
+spsdk>=2.2.0
+pypemicro>=0.1.11

spsdk_pemicro-0.1.0/spsdk_pemicro.egg-info/top_level.txt

@@ -0,0 +1 @@
+spsdk_pemicro

spsdk_pemicro-0.1.0/tests/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+#
+# Copyright 2024 NXP
+#
+# SPDX-License-Identifier: BSD-3-Clause
+"""Unit test package for spsdk_pemicro."""

spsdk_pemicro-0.1.0/tests/test_integration.py

@@ -0,0 +1,16 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+#
+# Copyright 2024 NXP
+#
+# SPDX-License-Identifier: BSD-3-Clause
+"""Tests for `spsdk_pemicro` package integration in SPSDK."""
+
+from click.testing import CliRunner
+from spsdk.apps import nxpdebugmbox
+
+
+def test_integration():
+    runner = CliRunner()
+    result = runner.invoke(nxpdebugmbox.main, "--help")
+    assert "pemicro" in result.output