Microsoft's fork of OpenOCD

Public pull requests are not accepted to this repo. If you would like to contribute changes to OpenOCD, please contribute directly to upstream following the OpenOCD Developer's Guide.

This is a soft fork of the OpenOCD project where Microsoft stages changes and provides binaries for Windows and Linux. The Linux binaries are statically linked with musl and are highly portable across a wide range of Linux distributions. In addition, this fork incorporates changes from Raspberry Pi, STMicroelectronics, and Azure Sphere to improve compatibility with the embedded development ecosystem.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Branching strategy

The master branch mirrors master in the upstream repository and is updated whenever OpenOCD releases. The microsoft/main branch follows master and includes small additions like this README and the scripts required to produce statically linked Linux binaries.

After every upstream tagged OpenOCD release, a new branch of the form microsoft/rel/<version> will be created based on microsoft/main. Patches from the Raspberry Pi, STMicroelectronics, and Azure Sphere forks will be applied to this new branch. After validating the build, the tip of the branch will be tagged as ms-v<version> and added as a release. Because OpenOCD releases are infrequent, it's more likely that the vendor forks and OpenOCD itself will have significant changes in the time between releases. Patches are are not applied directly to microsoft/main to avoid merge conflicts from stale vendor fork changes. Vendors are also encouraged to contribute their changes to upstream OpenOCD to avoid the need for patches at all.