Skip to content

Using git repository

Frederic Pillon edited this page Jun 14, 2017 · 26 revisions

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:

2. Delete the stm32 core extracted package

Go to the local Arduino directory
/img/Tips-icon.png 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 "<local Arduino directory>/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. Cloning the git repository to replace the stm32 core version package (1st method)

In the "<local Arduino directory>/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

/img/Tips-icon.png 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 (2nd method)

Go to the "<Arduino install directory>/hardware/" and create a directory named: stm
/img/Note-icon.png Directory name is not important stm is an example.
Go to this new directory then do the clone:

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

/img/Important-icon.png The name of a new directory to clone into must be stm32!

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

To the same directory clone the Arduino_Tools git repository:

git clone https://github.com/stm32duino/Arduino_Tools.git tools

/img/Important-icon.png The name of a new directory to clone into must be tools!

Clone this wiki locally