Installing

PyOCD requires Python 3.6 or later, and a recent version of libusb. It runs on macOS, Linux, FreeBSD, and Windows platforms.

The latest stable version of pyOCD may be installed or upgraded via pip as follows:

$ python3 -mpip install -U pyocd

Note: depending on your system, you may need to use python instead of python3.

The latest pyOCD package is available on PyPI. The GitHub releases page details changes between versions.

To install the latest prerelease version from the HEAD of the develop branch, you can do the following:

$ python3 -mpip install --pre -U git+https://github.com/pyocd/pyOCD.git@develop

You can also install directly from the source by cloning the git repository and running:

$ python3 -mpip install .

See the developer’s guide for more about setting up a development environment for pyOCD.

Note that, depending on your operating system, you may run into permissions issues running these commands. You have a few options here:

  1. Under Linux, run with sudo -H to install pyOCD and dependencies globally. On macOS, installing with sudo should never be required, although sometimes permissions can become modified such that installing without using sudo fails.
  2. Specify the --user option to install local to your user account.
  3. Run the command in a virtualenv local to a specific project working set.

For notes about installing and using on non-x86 systems such as Raspberry Pi, see the relevant documentation.

(Note: Installing by running setup.py directly is deprecated since pyOCD migrated to PEP 517 based packaging. In many cases it will not work at all. Installing with pip or another standards-compliant tool is the only supported method.)

udev rules on Linux

On Linux, particularly Ubuntu 16.04+, you must configure udev rules to allow pyOCD to access debug probes from user space. Otherwise you will need to run pyOCD as root, using sudo, which is very highly discouraged. (You should never run pyOCD as root on any OS.)

To help with this, example udev rules files are included with pyOCD in the udev folder. The readme in this folder has detailed instructions.

Target support

See the target support documentation for information on how to check if the MCU(s) you are using have built-in support, and how to install support for additional MCUs via CMSIS-Packs.