This repo contains Docker files for cross-compilation of the Ethereum C++ components.
The C++ cross-build support was developed by Bob Summerwill and Anthony Cros for doublethinkco.
The intention of the project is to bring Ethereum to mobile/wearable Linux platforms for the benefit of the whole Ethereum community, current and future. Given the ubiquitous nature of ARM processors, it was trivial to extend the scope of the project from mobile/wearable to cover a huge range of devices and OSes. There is a large test matrix further down this document showing our understanding of the status on a very broad range of devices.
Here is a photo of our nascent mobile/wearable build and testing farm:
This code is released as open source software under the permissive Apache 2.0 license.
We have written blogs and articles through development which are hosted at doublethink.co. Here are some key articles
| Form factor | Vendor | Device | OS | ABI | SoC | Core | Native | Cross |
|---|---|---|---|---|---|---|---|---|
| Smartwatch | Samsung | Gear S2 | Tizen 2.3.1 | armv7 | Qualcomm MSM8x26 | 2 x Cortex-A7 | N/A | Broken #20 |
| Smartwatch | Apple | Apple Watch Sport | watchOS 2.0 | armv7k | Apple S1 | 1 x ARM-v7k | N/A | TODO #41 |
| Vendor | Device | OS | ABI | SoC | Core | Native | Cross |
|---|---|---|---|---|---|---|---|
| Samsung | Samsung Z1 | Tizen 2.3.0 | armv7 | Spreadtrum SC7727S | 2 x Cortex-A7 | N/A | Broken #20 |
| Samsung | Samsung Z3 | Tizen 2.4.0 | armv7 | Spreadtrum SC7730S | 4 x Cortex-A7 | N/A | Broken #20 |
| LG | Nexus 5 | Sailfish 2.0 | armv7 | Qualcomm Snapdragon 800 | 4 x Krait 400 | Working | TODO #60 |
| Jolla | Jolla Phone | Sailfish 2.0 | armv7 | Qualcomm Snapdragon 400 | 2 x Krait 300 | TODO #61 | Working |
| Intex | Aquafish | Sailfish 2.0 | armv7 | Qualcomm Snapdragon ??? | TODO | TODO | |
| Meizu | MX4 Ubuntu Edition | Ubuntu Touch | armv7 | MediaTek MT6595 | 4 x Cortex-A17, 4 x Cortex-A7 | TODO #62 | Working |
| Samsung | Galaxy S3 | Android 4.3 | armel | Samsung Exynos 4412 Quad | 4 x Cortex-A9 | N/A | TODO #35 |
| Samsung | Galaxy S4 | Android 4.4 | armel | Qualcomm Snapdragon 600 | 4 x Krait 300 | N/A | TODO #35 |
| Samsung | Galaxy S6 | Android 5.0.2 | aarch64 | Samsung Exynos 7420 | 4 x Cortex-A57, 4 x Cortex-A53 | N/A | TODO #35 |
| Apple | iPhone 3GS | iOS 3 | armv7 | Samsung S5PC100 | 1 x Cortex-A8 | N/A | TODO #36 |
| Apple | iPhone 5 | iOS 6 | armv7 | Apple A6 | 2 x ARMv7A | N/A | TODO #36 |
| Nokia | N900 | Maemo 5 | armv7 | Apple A6 | 2 x ARMv7A | N/A | TODO #74 |
| Nokia | N9 | MeeGo 1.3 | armv7 | Apple A6 | 2 x ARMv7A | N/A | TODO #73 |
| Vendor | Device | OS | ABI | SoC | Core | Native | Cross |
|---|---|---|---|---|---|---|---|
| Samsung | RD-210 | Tizen 2.2.0 | armv7 | Samsung Exynos 4210 | 2 x Cortex-A9 | N/A | Broken #20 |
| Samsung | RD-PQ | Tizen 2.3.0 | armv7 | Samsung Exynos 4412 Quad | 4 x Cortex-A9 | N/A | Broken #20 |
| Samsung | TM1 | Tizen 2.4.0 | armv7 | Spreadtrum SC7730S | 4 x Cortex-A7 | N/A | Broken #20 |
| Vendor | Device | OS | ABI | SoC | Core | Native | Cross |
|---|---|---|---|---|---|---|---|
| Asus | Nexus 7 | Android 5.1.1 | armel | Nvidia Tegra 3 | 4+1 x Cortex-A9 | N/A | TODO #35 |
| Samsung | Galaxy Tab S 10.5 | Android 5.0.2 | armel | Samsung Exynos 5 Octa 5420 | 4 x Cortex-A15, 4 x Cortex-A7 | N/A | TODO #35 |
| Apple | iPad Air 2 | iOS 8.1 | aarch64 | Apple A8X | 3 x ARMv8-A | N/A | TODO #36 |
| Vendor | Device | OS | ABI | SoC | Core | Native | Cross |
|---|---|---|---|---|---|---|---|
| Raspberry Pi Foundation | Raspberry Pi Model A | Raspbian | armv6 | Broadcom BCM2835 | 1 x ARMv6 | TODO | TODO |
| Raspberry Pi Foundation | Raspberry Pi Model B+ | Raspbian | armv6 | Broadcom BCM2835 | 1 x ARMv6 | Working | Working |
| Raspberry Pi Foundation | Raspberry Pi Zero | Raspbian | armv6 | Broadcom BCM2835 | 1 x ARMv6 | TODO | Working |
| Raspberry Pi Foundation | Raspberry Pi 2 | Raspbian | armv7 | Broadcom BCM2836 | 4 x Cortex-A7 | Working | Working |
| Raspberry Pi Foundation | Raspberry Pi 3 | Ubuntu 15.04 MATE | armv7 | Broadcom BCM2837 | 4 x Cortex-A53 | TODO | TODO |
| Odroid | Odroid XU3 | Ubuntu 15.04 MATE | armv7 | Samsung Exynos 5422 | 4 x Cortex-A15, 4 x Cortex-A7 | Working | Working |
| Odroid | Odroid XU4 | Tizen 3.x | armv7 | Samsung Exynos 5422 | 4 x Cortex-A15, 4 x Cortex-A7 | TODO | TODO |
| Beaglebone | Beaglebone Black | Debian | armv7 | Texas Instruments AM3358/9 | 1 x Cortex-A8 | Working | Working |
| Wandboard | Wandboard Quad | Debian | armv7 | Freescale i.MX6 | 4 x Cortex-A9 | Working | Working |
| Dragonboard | DragonBoard 410c | armv7 | Qualcomm Snapdragon 410 | 4 x Cortex-A7 | TODO | TODO | |
| C.H.I.P. | C.H.I.P. | Debian | armv7 | Allwinner R8 | 1 x Cortex-A8 | TODO | Working |
| Minnowboard | Minnowboard MAX | x86_64 | Intel Atom E3800 | 2 x Core | TODO | TODO | |
| Intel | Intel NUC DCP847SKE | i386 | Intel QS77 Express | TODO | TODO | ||
| Intel | Intel Edison | Yocto | x86_64 | Intel "Tangier" Z34XX | Working | TODO | |
| Intel | Intel Curie | i386 | Intel Quark SE | TODO | TODO |
NOTE - Here is some information on ARM options in GCC.
See also ARM Infocenter and ARM Architecture page on Wikipedia.
Prebuilt releases are hosted on Github and are updated periodically.
If you use these binaries please do let us know how you get on, either via cpp-ethereum on Gitter or by logging an issue in Github. Please give as much detail as you can, including your exact device and operating system version. Thanks!
To cross-build the HEAD of webthree-umbrella from source yourself, follow these instructions.
Clone this repo and use Dockerfile-crosseth to build either 'armel' binaries or 'armhf' binaries:
$ git clone https://github.com/doublethinkco/webthree-umbrella-cross.git
$ cd webthree-umbrella-cross
And then one of ...
$ sudo ./build-armel.sh
$ sudo ./build-armhf.sh
$ sudo ./build-armel-apt.sh
$ sudo ./build-armhf-apt.sh
If the build succeeds then you will end up with an output file in /tmp/crosseth.tgz.
The "apt" versions use the pre-built g++-arm-linux-gnueabi and g++-arm-linux-gnueabihf cross-compilers which "apt-get install"-ed, rather than the cross-compilers which we built ourselves (see next paragraph).
Dockerfile-crosseth makes use of the crosstool-NG toolchain-building scripts to generate a cross-compiler which is then used in the rest of the build process. The cross-compiler was originally built and then used as part of the same Docker flow, but that was slow and unnecessarily, so that step was been split into its own Dockerfile-xcompiler process, which can be run in a similar manner:
$ git clone https://github.com/doublethinkco/webthree-umbrella-cross.git
$ cd webthree-umbrella-cross
$ sudo ./build-xcompiler-armel.sh
or
$ git clone https://github.com/doublethinkco/webthree-umbrella-cross.git
$ cd webthree-umbrella-cross
$ sudo ./build-xcompiler-armhf.sh
If the cross-compiler build succeeds then you will end up with an output file in /tmp/xcompiler.tgz.
The results from two specific runs of this process are stored as releases on Github and are used in the crosseth build process. The "glue" for this process is in cross-build/ethereum/setup.sh:
The bulk of the remaining work is getting specific platforms and devices into a working state. For the ARM devices, that will mainly be a matter of iterating on the ABI settings until we get working binaries. Intel support should not be too hard either - just more cross-compilers.