README.rst: spell out gcc version requirements

.. the text was adapted from ports/stm32 and a conversation with
Dan Halbert.
This commit is contained in:
Jeff Epler 2018-03-19 21:55:49 -05:00
parent bf42611738
commit fa491b4c32
1 changed files with 17 additions and 1 deletions

View File

@ -115,13 +115,29 @@ PB03 **Yes** **Yes** **Yes** **Yes**
Setup
-----
Install required compiler packages:
An ARM compiler is required for the build, along with the associated binary
utilities. On Ubuntu, these can be installed as follows:
.. code-block:: shell
sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
sudo apt-get install gcc-arm-embedded
On Arch Linux the compiler is available for via the package
``arm-none-eabi-gcc``.
For other systems, the `GNU Arm Embedded Toolchain <https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads>`_
may be available in binary form.
The latest available package from team-gcc-arm-embedded is used to produce the
binaries shipped by AdaFruit. Other compiler versions, particularly older
ones, may not work properly. In particular, the ``gcc-arm-none-eabi`` package
in Debian Stretch is too old.
The compiler can be changed using the ``CROSS_COMPILE`` variable when invoking
``make``.
Building
--------