Using git repository

To use the Arduino_Core_STM32 git repository instead of the package version, follow those steps:

1. Install the STM32 Cores package, see the Getting Started page.

This will install the required dependencies:

• CMSIS: ARM® Cortex® Microcontroller Software Interface Standard
• arm-none-eabi-gcc: GNU ARM Embedded Toolchain
• STM32Tools: upload tools,...

2. Delete the stm32 core extracted package.

Go to the local Arduino directory
The location is displayed in the "Preferences" dialog.
It should be:

* `/Users/\<USERNAME\>/Library/Arduino15/` _(Mac)_
* `c:\Documents and Settings\\<USERNAME\>\Application Data\Arduino15\` _(Windows XP)_
* `c:\Users\\<USERNAME\>\AppData\Roaming\Arduino15\` _(Windows Vista)_
* `c:\Users\\<USERNAME\>\AppData\Local\Arduino15\` _(Windows 7)_
* `~/.arduino15/` _(Linux)_

Then, go to "/packages/STM32/hardware/stm32/" directory.
You should see a directory named with the STM32 Core version installed. Example: 2017.6.2
Delete this directory.

3. Hereafter, 2 methods to use git repository:

Directory of step 2 is now deleted.

3.1. Replacing the stm32 core version package by the clone of the git repository

In the "/packages/STM32/hardware/stm32/" do the clone:

git clone https://github.com/stm32duino/Arduino_Core_STM32.git <version>

where <version> is the one you delete in step 2.
For this example: 2017.6.2
So, do:

git clone https://github.com/stm32duino/Arduino_Core_STM32.git 2017.6.2

It is possible to clone it elsewhere and create a symlink named <version>

At this step, you are able to build using the git repository but upload is broken.
.../massStorageCopy": error=2, No such file or directory
or
.../stlink_upload": error=2, No such file or directory

Uploader tools path need to be updated in platform.txt at the root of the git repository.
Replace all {runtime.hardware.path} by {runtime.tools.STM32Tools.path}
That's all.

/img/Warning-icon.png Uninstalling from the boards managers will remove the git repository!

3.2. Adding repositories in Arduino/hardware directory