From fa491b4c327646b90de2a92ffc0c16950946f9ee Mon Sep 17 00:00:00 2001 From: Jeff Epler Date: Mon, 19 Mar 2018 21:55:49 -0500 Subject: README.rst: spell out gcc version requirements .. the text was adapted from ports/stm32 and a conversation with Dan Halbert. --- ports/atmel-samd/README.rst | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/ports/atmel-samd/README.rst b/ports/atmel-samd/README.rst index 8785ccada..cd1453b01 100644 --- a/ports/atmel-samd/README.rst +++ b/ports/atmel-samd/README.rst @@ -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 `_ +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 -------- -- cgit v1.2.3 From 3f82fe8da9edf9f9a3285b307d8c1cca01dd978f Mon Sep 17 00:00:00 2001 From: Jeff Epler Date: Mon, 19 Mar 2018 21:56:32 -0500 Subject: README.rst: document mpy-cross gotcha This was biting me, leading to an odd error later on. --- ports/atmel-samd/README.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/ports/atmel-samd/README.rst b/ports/atmel-samd/README.rst index cd1453b01..c74407b0a 100644 --- a/ports/atmel-samd/README.rst +++ b/ports/atmel-samd/README.rst @@ -141,6 +141,17 @@ The compiler can be changed using the ``CROSS_COMPILE`` variable when invoking Building -------- +Before building the firmware for a given board the MicroPython cross-compiler +must be built; it will be used to pre-compile some of the built-in scripts to +bytecode. The cross-compiler is built and run on the host machine, using: + +.. code-block:: shell + + make -C mpy-cross + +This command should be executed from the root directory of this repository. +All other commands below should be executed from the ports/atmel-samd/ directory. + To build for the Arduino Zero: .. code-block:: shell -- cgit v1.2.3