mirrors
/
micropython
mirror of https://github.com/micropython/micropython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Describe "cross" branch.

Paul Sokolovsky 2015-10-29 17:30:27 +02:00
parent 28a5d22cd4
commit 469a6cfe47
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
CrossBranch.md Normal file

@ -0,0 +1,7 @@
Branch `cross` in the repository contains some convenience/example scripts to cross-compiler MicroPython to various targets (currently that's Linux-based systems of various architectures). The branch is *experimental*, subject to change without notice, and it is being rebased regularly (which mean you should use `git pull --rebase` command to update your local checkout).
You can browse contents of this branch at https://github.com/micropython/micropython/commits/cross (and due to the fact that branch is rebased on top of master, its changes are always "at the top").
The general idea is that there're unix/build-<target>.sh scripts which build MicroPython executable for a particular target, using suitable cross-compiling toolchain and set of options. You already should have a cross-compiler installed, a build scripts try to provide links/instructions how to set it up. Cross-compiling options are configured in such way as to compile as standalone binary as possibly (ultimately, linked sully statically and requiring just bare Linux kernel to run, but we're not yet there).
Beyond the build script, if a target is supported by QEMU user-level emulation, there's a convenience `unix/micropython.<target>` script provided to run cross-compiled binary via such emulation (until binaries are fully static, this requires at least small target filesystem with libraries, etc. - it is usually part of cross-compiling toolchain). As a final convenience, `tests/run-tests.<target>` script is provided, to run MicroPython testsuite using `micropython.<target>` wrapper.