andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 1 | # Linux Chromium Arm Recipes |
| 2 | |
| 3 | [TOC] |
| 4 | |
| 5 | ## Recipe1: Building for an ARM CrOS device |
| 6 | |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 7 | https://sites.google.com/a/chromium.org/dev/developers/how-tos/-quickly-building-for-cros-arm-x64 |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 8 | |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 9 | ## Recipe2: Explicit Cross compiling |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 10 | |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 11 | Due to the lack of ARM hardware with the grunt to build Chromium native, cross |
| 12 | compiling is currently the recommended method of building for ARM. |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 13 | |
| 14 | These instruction are designed to run on Ubuntu Precise. |
| 15 | |
| 16 | ### Installing the toolchain |
| 17 | |
| 18 | The install-build-deps script can be used to install all the compiler |
| 19 | and library dependencies directly from Ubuntu: |
| 20 | |
sbc | edd75c2 | 2015-11-22 04:53:43 | [diff] [blame] | 21 | $ ./build/install-build-deps.sh |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 22 | |
sbc | 9f033f8 | 2015-11-26 00:50:52 | [diff] [blame] | 23 | ### Installing the sysroot |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 24 | |
thakis | 3e861de | 2016-06-14 14:24:01 | [diff] [blame] | 25 | A prebuilt sysroot image is kept up to date on Cloud Storage. It will |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 26 | automatically be installed by gclient runhooks installed if you have |
| 27 | `target_arch=arm` in your `GYP_DEFINES`. |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 28 | |
| 29 | To install the sysroot manually you can run: |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 30 | |
| 31 | ./chrome/installer/linux/sysroot_scripts/install-debian.wheezy.sysroot.py \ |
| 32 | --arch=arm |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 33 | |
| 34 | ### Building |
| 35 | |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 36 | To build for ARM, using the clang binary in the chrome tree, use the following |
sbc | 84dfa8ed | 2015-12-02 23:45:37 | [diff] [blame] | 37 | gn args: |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 38 | |
sbc | 84dfa8ed | 2015-12-02 23:45:37 | [diff] [blame] | 39 | target_cpu = "arm" |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 40 | |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 41 | ## Testing |
| 42 | |
| 43 | ### Automated Build and Testing |
| 44 | |
sbc | edd75c2 | 2015-11-22 04:53:43 | [diff] [blame] | 45 | Chromium's testing infrastructure for ARM/Linux is somewhat limited. |
| 46 | There are currently two builders setup, one on the FYI waterfall and one |
| 47 | the the trybot waterfall: |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 48 | |
nodir | a6074d4c | 2015-09-01 04:26:45 | [diff] [blame] | 49 | * [Linux ARM](http://build.chromium.org/p/chromium.fyi/builders/Linux%20ARM) |
sbc | f61cb5a | 2015-12-16 19:36:43 | [diff] [blame] | 50 | * [linux_arm](http://build.chromium.org/p/tryserver.chromium.linux/builders/linux_arm) |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 51 | |
sbc | edd75c2 | 2015-11-22 04:53:43 | [diff] [blame] | 52 | These bots run x86-64 linux and cross-compile the ARM targets. Tests are |
| 53 | run on ARM hardware via swarming. |
| 54 | |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 55 | ### Testing with QEMU |
| 56 | |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 57 | If you don't have a real ARM machine, you can test with QEMU. For instance, |
| 58 | there are some prebuilt QEMU Debian images here: |
| 59 | http://people.debian.org/~aurel32/qemu/. Another option is to use the rootfs |
| 60 | generated by rootstock, as mentioned above. |
andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 61 | |
| 62 | Here's a minimal xorg.conf if needed: |
| 63 | |
| 64 | ``` |
| 65 | Section "InputDevice" |
| 66 | Identifier "Generic Keyboard" |
| 67 | Driver "kbd" |
| 68 | Option "XkbRules" "xorg" |
| 69 | Option "XkbModel" "pc105" |
| 70 | Option "XkbLayout" "us" |
| 71 | EndSection |
| 72 | |
| 73 | Section "InputDevice" |
| 74 | Identifier "Configured Mouse" |
| 75 | Driver "mouse" |
| 76 | EndSection |
| 77 | |
| 78 | Section "Device" |
| 79 | Identifier "Configured Video Device" |
| 80 | Driver "fbdev" |
| 81 | Option "UseFBDev" "true" |
| 82 | EndSection |
| 83 | |
| 84 | Section "Monitor" |
| 85 | Identifier "Configured Monitor" |
| 86 | EndSection |
| 87 | |
| 88 | Section "Screen" |
| 89 | Identifier "Default Screen" |
| 90 | Monitor "Configured Monitor" |
| 91 | Device "Configured Video Device" |
| 92 | DefaultDepth 8 |
| 93 | SubSection "Display" |
| 94 | Depth 8 |
| 95 | Modes "1024x768" "800x600" "640x480" |
| 96 | EndSubSection |
| 97 | EndSection |
| 98 | ``` |
| 99 | |
| 100 | ### Notes |
andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 101 | |
| 102 | * To building for thumb reduces the stripped release binary by around 9MB, |
| 103 | equating to ~33% of the binary size. To enable thumb, set `'arm_thumb': 1` |
| 104 | * TCmalloc does not have an ARM port, so it is disabled. |