From 3f82fe8da9edf9f9a3285b307d8c1cca01dd978f Mon Sep 17 00:00:00 2001 From: Jeff Epler Date: Mon, 19 Mar 2018 21:56:32 -0500 Subject: [PATCH] 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 cd1453b011..c74407b0a0 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