Skip to content

Latest commit

 

History

History
79 lines (58 loc) · 3.54 KB

dependencies.md

File metadata and controls

79 lines (58 loc) · 3.54 KB

1. Download and Install Dependencies

Building the firmware locally requires these dependencies ot be installed:

  1. GCC for ARM Cortex processors
  2. Make
  3. Device Firmware Upgrade Utilities
  4. Zatig (for Windows users only)
  5. Git
  6. Command line tools

1. GCC for ARM Cortex processors

Particle devices use an ARM Cortex Mx CPU based microcontroller. All of the code is built around the GNU GCC toolchain offered and maintained by ARM.

The build requires version 10.2.1 (10-2020-q4-major) or newer of ARM GCC and will print an error message if the version is older than this.

Linux and Windows:

OS X users can install the toolchain with Homebrew:

  • brew tap PX4/homebrew-px4
  • brew update
  • copy/paste this in Terminal and press ENTER to create the proper Brew formula
echo -e "
require 'formula'

class GccArmNoneEabi1021 < Formula
  homepage 'https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads'
  version '20201103'
  url 'https://developer.arm.com/-/media/Files/downloads/gnu-rm/10-2020q4/gcc-arm-none-eabi-10-2020-q4-major-mac.tar.bz2'
  sha256 'bed12de3565d4eb02e7b58be945376eaca79a8ae3ebb785ec7344e7e2db0bdc0'

  def install
    ohai 'Copying binaries...'
    system 'cp', '-rv', 'arm-none-eabi', 'bin', 'lib', 'share', \"#{prefix}/\"
  end
end" > /usr/local/Homebrew/Library/Taps/px4/homebrew-px4/gcc-arm-none-eabi-1021.rb
  • install it!
brew install gcc-arm-none-eabi-1021
  • arm-none-eabi-gcc --version (should now say: 10.2.1)

If you are upgrading an existing installation you will have to unlink and link your symblinks:

  • brew update
  • brew install gcc-arm-none-eabi-1021 (when you run this, it will tell you the following commands)
  • brew unlink gcc-arm-none-eabi-53 (example)
  • brew link --overwrite gcc-arm-none-eabi-1021 (example)
  • arm-none-eabi-gcc --version (should now say: 10.2.1)

2. Make

In order to turn your source code into binaries, you will need a tool called make. Windows users need to explicitly install make on their machines. Make sure you can use it from the terminal window.

Download and install the latest version from: http://gnuwin32.sourceforge.net/packages/make.htm

3. Device Firmware Upgrade Utilities

Install dfu-util 0.8. Mac users can install dfu-util with Homebrew brew install dfu-util or Macports, Linux users may find it in their package manager, and everyone can get it from http://dfu-util.gnumonks.org/index.html

4. Zadig

In order for the device to show up on the dfu list, you need to replace the USB driver with a utility called Zadig. Here is a tutorial on using it. This is only required for Windows users.

5. Git

Download and install Git: http://git-scm.com/

6. Command line tools

On Windows, you'll need to install MinGW and have it in your path to make available some of the typical *nix command line tools.

The tool crc32 is also needed:

  • available in MinGW on Windows
  • available by default on OS X
  • linux users, please check with your package manager. On debian based systems it can be installed via sudo apt-get install libarchive-zip-perl