Skip to content

v0.28.0
Compare
Choose a tag to compare
@flit flit released this 25 Sep 23:03
v0.28.0
This tag was signed with the committer’s verified signature. The key has expired.
flit Chris Reed
GPG key ID: D9CA85573297D467
Expired
Learn about vigilant mode.
19a824b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

v0.28.0 on PyPI

Important note: Support for Python 2 is deprecated and planned to be dropped from an upcoming release. Existing releases of pyocd will, of course, continue to work with Python 2. If this is a major issue for you moving forward, please create a new issue describing your concerns.

Additions

  • Replaced the gdbserver remote monitor commands with the command set from the commander subcommand. This is the first step towards providing a full command mini-language integrated throughout pyocd.
  • Added support to pyocd for RTOS and debug probe plugins. Third party packages on PyPI can now add features to pyocd.
  • Debug probes can be shared over a TCP connection and accessed remotely. Documentation is provided in here.
  • The gdbserver subcommand adds a command line argument --probe-server to cause the debug probe server to be started simultaneous with the gdbserver. For allows, for instance, to connect a pyocd commander to an already-running gdbserver.
  • Some new core registers are exposed to the Python API and gdb: the NS versions of MSP and PSP, MSPLIM and PSPLIM for S and NS, and VPR.
  • Command history file support, so the history is saved between runs of pyocd commander.
    • By default the history is stored in ~/.pyocd_history. The PYOCD_HISTORY environment variable will override this if set.
    • The default history length is 1000 entries. The PYOCD_HISTORY_LENGTH environment variable or commander.history_length option allow you to change this. Setting either one to -1 will enable an infinite history (but beware history file size).
  • The Arm SDC-600 Secure Debug Channel IP is supported in the internal Python API.
  • The v8.1-M MVE extension is detected.

Boards and targets

  • Added NXP MIMXRT1024-EVK, MIMXRT1060-EVK, and MIMXRT1064-EVK boards and i.MX RT1024, i.MX RT1060, and i.MX RT1064 targets (mimxrt1024, mimxrt1060, and mimxrt1064). (Thanks @Hoohaha)
  • Added new HDSC targets HC32F4A0xG, HC32F4A0xI and HC32M423 of HDSC MCU. (Thanks @lennvn)
  • Added OTP programming algorithm for the HDSC HC32F4A0. (Thanks @lennvn)
  • Added Nuvoton NuMaker-PFM-M487 board and M487JIDAE target, m487jidae. (Thanks @ychsu-tf)
  • Many fixes for NXP i.MX RT series devices related to reset and halt, as well as flash algorithms. (Thanks @Hoohaha)
  • Fixed HDSC HC32x120 flash algorithms. (Thanks @lennvn)

Changes

  • Command changes
    • Prevent accessing core registers unless core is halted. An error is printed.
    • Print core security state in status command, if the core has more than one security state.
    • reg command accepts all or the name of a register group in addition to register names.
    • where command prints the offset from the base address of the symbol.
    • show register-groups prints a list of the named groups of core registers.
    • Any prefixes of a command is accepted as long as it is unique. For example, "sym" for "symbol".
    • New probeserver command to control the debug probe server.
  • Vector catch supports SecureFault.
  • A new reset.halt_timeout session option controls the timeout waiting for the core to recover from reset and halt.
  • The standard Cortex-M system address space is used as the memory map if the target does not provide its own memory map (e.g. the cortex_m default target).
  • The full name of a detected FPU is logged. These are the names such as "FPv4-SP-D16-M" or "FPv5-D16-M".
  • An error will be reported if the config file (e.g., pyocd.yaml) does not have a yaml dictionary at its root. This helps users identify the cause of an otherwise obscure error message.
  • Two session options are available too control RTOS awareness in the gdbserver. rtos.enable can be used to completely disable RTOS support, which is enabled by default. rtos.name can be set to the name of an RTOS plugin in order to limit RTOS awareness to that one RTOS (which can make startup faster).
  • The cache.read_code_from_elf session option controls whether pyocd will read code from an ELF that is provided to it rather than read from the target (an optimisation that is enabled by default when an ELF is provided).
  • The cmsis_dap.deferred_transfers session options controls whether the CMSIS-DAP layer will used deferred transfers. There is generally no reason to disable this, especially since it greatly affects performance, but it may help is special cases.
  • The CMSIS-DAP pyusb/libusb backend will report a warning if pyusb fails to load libusb.
  • The cpu.step.instruction.timeout can be used to enable a timeout when performing instruction stepping. By default the timeout is disabled.
  • Handle the case where GDB sends an interrupt (Control-C) during a step or range step command.

Fixes

  • Major fixes for ITM, SWO, and SWV support. (Thanks @oxidecomputer)
  • Another fix for CMSIS-Pack flash region creation. (Thanks @menshiyu)
  • USB HID detach kernel driver fix for FreeBSD. (Thanks @cederom)
  • Fixed case of multiple Cypress target types in the board ID. This did not prevent the targets from working, but caused incorrect data to be reported via the JSON boards list query. (Thanks @mcgordonite)
  • Corrected detection of the Security extension on v8.1-M cores such as the Cortex-M55.
  • Fixed the name of the scan_all_aps session option in several places.
  • Fixed hex dump generation on Python 2 (recent regression).

Documentation

Python API

  • Major refactoring of command system used for the commander subcommand and (now) gdbserver monitor commands. See #955 for details.
  • Major refactoring of the code for managing core registers. See #933 for details.
  • Cores have an extensions property that is a list of enums from pyocd.coresight.core_ids.CortexMExtensions.
  • Cores now have a core_registers property which is a pyocd.core.core_registers.CoreRegisterIndex object. This object gives you multiple ways to list and find core registers, such as by name, index, or group.
  • Refactored CoreSightTarget so there is an SoCTarget superclass that implements the architecture-independent SoC-level features. Moved CoreSightTarget under pyocd.coresight.
  • Replaced the MemoryAccessError exception only raised by the memory cache with TransferFaultError.
  • The Session class now tracks instances of the gdbservers and probeserver.
  • Added an optional hook callback parameter to the Target.step() API.

Tests

  • Moved test binaries under test/data.
  • Functional tests check for a skip_test session option. This would be set in per-probe options in the config file if you need to skip a probe during testing.
  • automated_test.py gains --list-tests, --include-tests, and --exclude-tests command line arguments.
  • Many functional test fixes and improvements.
  • New unit test for fault and flash failure exceptions.
  • Added a new functional test for commands.
  • Removed the old and entirely unused test_pyocd_tool.sh script.
  • Functional test for range step.
Assets 2
Loading