Building a custom kernel for the Nexus S

There are several reasons why someone would want to build a custom kernel for their Android phone. In my case, this is because I wanted performance counters (those used by the perf tool that comes with the kernel source). In Julian Seward‘s case, he wanted swap support to overcome the limited memory amount on these devices in order to run valgrind. In both cases, the usual suspects (AOSP, CyanogenMod) don’t provide the wanted features in prebuilt ROMs.

There are also several reasons why someone would NOT want to build a complete ROM for their Android phone. In my case, the Nexus S is what I use to work on Firefox Mobile, but it is also my actual mobile phone. It’s a quite painful and long process to create a custom ROM, and another long (but arguably less painful thanks to ROM manager) process to backup the phone data, install the ROM, restore the phone data. And if you happen to like or use the proprietary Google Apps that don’t come with the AOSP sources, you need to add more steps.

There are however tricks that allow to build a custom kernel for the Nexus S and use it with the system already on the phone. Please note that the following procedure has only been tested on two Nexus S with a kernel (one with a stock ROM, but unlocked, and another one with an AOSP build). Also please note that there are various ways to achieve many of the steps in this procedure, but I’ll only mention one (or two in a few cases). Finally, please note some steps rely on your device being rooted. There may be ways to do without, but I’m pretty sure it requires an unlocked device at the very least. This post doesn’t cover neither rooting nor unlocking.

Preparing a build environment

To build an Android kernel, you need a cross-compiling toolchain. Theoretically, any will do, provided it targets ARM. I just used the one coming in the Android NDK:

$ wget
$ tar -jxf android-ndk-r6b-linux-x86.tar.bz2
$ export ARCH=arm
$ export CROSS_COMPILE=$(pwd)/android-ndk-r6b/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin/arm-linux-androideabi-

For the latter, you need to use a directory path containing prefixed versions (such as arm-eabi-gcc or arm-linux-androideabi-gcc), and include the prefix, but not “gcc”.

You will also need the adb tool coming from the Android SDK. You can install it this way:

$ wget
$ tar -zxf android-sdk_r12-linux_x86.tgz
$ android-sdk-linux_x86/tools/android update sdk -u -t platform-tool
$ export PATH=$PATH:$(pwd)/android-sdk-linux_x86/platform-tools

Building the kernel

For the Nexus S, one needs to use the Samsung Android kernel tree, which happens to be unavailable at the moment of writing due to the outage. Fortunately, there is a clone used for the B2G project, which also happens to contain the necessary cherry-picked patch to add support for the PMU registers on the Nexus S CPU that are needed for the performance counters.

$ git clone -b devrom-2.6.35
$ cd samsung-android-kernel

You can then either start from the default kernel configuration:

$ make herring_defconfig

or use the one from the B2G project, which enables interesting features such as oprofile:

$ wget -O .config

From then, you can use the make menuconfig or similar commands to further configure your kernel.

One of the problems you’d first encounter when booting such a custom kernel image is that the bcm4329 driver module that is shipped in the system partition (and not in the boot image) won’t match the kernel, and won’t be loaded. The unfortunate consequence is the lack of WiFi support.

One way to overcome this problem is to overwrite the kernel module in the system partition, but I didn’t want to have to deal with switching modules when switching kernels.

There is however a trick allowing the existing module to be loaded by the kernel: compile a kernel with the same version string as the one already on the phone. Please note this only really works if the kernel is really about the same. If there are differences in the binary interface between the kernel and the modules, it will fail in possibly dangerous ways.

To use that trick, you first need to know what kernel version is running on your device. Settings > About phone > Kernel version will give you that information on the device itself. You can also retrieve that information with the following command:

$ adb shell cat /proc/version

With my stock ROM, this looks like the following:

Linux version ( (gcc version 4.4.3 (GCC) ) #1 PREEMPT Thu Mar 31 21:11:55 PDT 2011

In the About phone information, it looks like:

The important part above is -ge382d80, and that is what we will be using in our kernel build. Make sure the part preceding -ge382d80 does match the output of the following command:

$ make kernelversion

The trick is to write that -ge382d80 in a .scmversion file in the kernel source tree (obviously, you need to replace -ge382d80 with whatever your device has):

$ echo -ge382d80 > .scmversion

The kernel can now be built:

$ make -j$(($(grep -c processor /proc/cpuinfo) * 3 / 2))

The -j… part is the general rule I use when choosing the number of parallel processes make can use at the same time. You can pick whatever suits you better.

Before going further, we need to get back to the main directory:

$ cd ..

Getting the current boot image

The Android boot image living in the device doesn’t contain only a kernel. It also contains a ramdisk containing a few scripts and binaries, that starts the system initialization. As we will be using the ramdisk coming with the existing kernel, we need to get that ramdisk from the device flash memory:

$ adb shell cat /proc/mtd | awk -F'[:"]' '$3 == "boot" {print $1}'

The above command will print the mtd device name corresponding to the “boot” partition. On the Nexus S, this should be mtd2.

$ adb shell
$ su
# dd if=/dev/mtd/mtd2 of=/sdcard/boot.img bs=4096
2048+0 records in
2048+0 records out
8388608 bytes transferred in secs (xxxxxxxx bytes/sec)
# exit
$ exit

In the above command sequence, replace mtd2 with whatever the previous command did output for you. Now, you can retrieve the boot image:

$ adb pull /sdcard/boot.img

Creating the new boot image

We first want to extract the ramdisk from that boot image. There are various tools to do so, but for convenience, I took unbootimg, on github, and modified it slightly to seemlessly support the page size on the Nexus S. For convenience as well, we’ll use mkbootimg even if fastboot is able to create boot images.

Building unbootimg, as well as the other tools rely on the Android build system, but since I didn’t want to go through setting it up, I figured a minimalistic way to build the tools:

$ git clone
$ git clone git://

The latter is a clone of git://, which is down at the moment.

$ gcc -o unbootimg/unbootimg unbootimg/unbootimg.c core/libmincrypt/sha.c -Icore/include -Icore/mkbootimg
$ gcc -o mkbootimg core/mkbootimg/mkbootimg.c core/libmincrypt/sha.c -Icore/include
$ gcc -o fastboot core/fastboot/{protocol,engine,bootimg,fastboot,usb_linux,util_linux}.c core/libzipfile/{centraldir,zipfile}.c -Icore/mkbootimg -Icore/include -lz

Once the tools are built, we can extract the various data from the boot image:

$ unbootimg/unbootimg boot.img
section sizes incorrect
kernel 1000 2b1b84
ramdisk 2b3000 22d55
second 2d6000 0
total 2d6000 800000
...but we can still continue

Don’t worry about the error messages about incorrect section sizes if it tells you “we can still continue”. The unbootimg program creates three files:

  • boot.img-mk, containing the mkbootimg options required to produce a working boot image,
  • boot.img-kernel, containing the kernel image,
  • boot.img-ramdisk.cpio.gz, containing the gzipped ramdisk, which we will reuse as-is.

All that is left to do is to generate the new boot image:

$ eval ./mkbootimg $(sed s,boot.img-kernel,samsung-android-kernel/arch/arm/boot/zImage, boot.img-mk)

Booting the image

There are two ways you can use the resulting boot image: one-time boot or flash. If you want to go for the latter, it is best to actually do both, starting with the one-time boot, to be sure you won’t be leaving your phone useless (though recovery is there to the rescue, but is not covered here).

First, you need to get your device in the “fastboot” mode, a.k.a. boot-loader:

$ adb reboot bootloader

Alternatively, you can power it off, and power it back on while pressing the volume up button.

Once you see the boot-loader screen, you can test the boot image with a one-time boot:

$ ./fastboot boot boot.img
downloading 'boot.img'...
OKAY [ 0.xxxs]
OKAY [ 0.xxxs]
finished. total time: 0.xxxs

As a side note, if fastboot sits “waiting for device”, it either means your device is not in fastboot mode (or is not connected), or that you have permissions issues on the corresponding USB device in /dev.

Your device should now be starting up, and eventually be usable under your brand new kernel (and WiFi should be working, too). Congratulations.

If you want to use that kernel permanently, you can now flash it after going back in the bootloader:

$ adb reboot bootloader
$ ./fastboot flash boot boot.img
sending 'boot' (2904 KB)...
OKAY [ 0.xxxs]
writing 'boot'...
OKAY [ 0.xxxs]
finished. total time: 0.xxxs
$ ./fastboot reboot


2011-09-14 09:23:47+0200

p.d.o, p.m.o

You can leave a response, or trackback from your own site.

9 Responses to “Building a custom kernel for the Nexus S”

  1. foo Says:

    Can we have Iceweasel Mobile in Debian now please?

    Support for Nexus S by Debian would be nice too…

  2. Is there a walk-through on how to recompile an Android kernel, and uploading it back to the device? - Quora Says:

    [...] There are some specific walk-throughs depending on the Android device you use. Please refer:1)…3)…This answer .Please [...]

  3. Corrado Says:

    works fine! thanks :)

  4. witek Says: is back. Where there is a git tree for samsung android?

  5. Apoorva Says:

    Hi I am following the above mentioned steps with a few modifications
    # I am using the latest sdk
    # I had android 2.3.6 already installed on my Nexus S and the kernel version was 2.65.7-gf5f63ef
    I have made the appropriate changes in commands

    However while executing the command
    make -j$(($(grep -c processor /proc/cpuinfo) * 3 / 2))
    I was expecting to get the file zImage at the path

    However no image is formed there..
    Can u please help me proceed..


  6. Apoorva Says:

    Hey thanks,

    I was able to resolve this issue. Thanks for a wonderful post !!

  7. Kwalla Says:

    I’m trying to build the perf tool using ARCH=arm and a arm cross compiler, and I’m getting:
    Makefile:512: No libdw.h found or old libdw.h found or elfutils is older than 0.138, disables dwarf support. Please install new elfutils-devel/libdw-dev
    Makefile:548: *** No libelf.h/libelf found, please install libelf-dev/elfutils-libelf-devel and glibc-dev[el]. Stop.

    at tool build. I already have a working kernel up and running, and I’ve been searching for a workaround to this, but I’ve been unsuccessful. The last perf tool modification was from 10-20-2010, and I’ve found that this error existed in the past, but no solutions. Since you mentioned it at the beginning of your post, do you know a workaround?


  8. Extrahujeme Module.symvers a config — Další z mnoha Blogů Says:

    [...] [...]

  9. oangaa879 Says:

    2調査:商業トラック用、放置詳細ValpakでKudzuCouponsでAutotraderLocalサービスでdeadlyAdvertisersとSponsorsCarsすることができます」。べき最低賃金の増加, 芸能人, 新店舗は来年の夏オープンし、年間約200万人を誘致することが期待されている。, 【送料無料】【COACH コーチ】トートバッグ サフィアーノ レザー ミディアム EW 23576_SV/VR(バーミリオン), 【送料無料】【COACH コーチ】サイフ 長財布 フローラル チャーム ジップ アラウンド シグネチャー F48838_BIGIY(ライトカーキ×アイボリー), 14444ビーチブールバード、グリーンバーグ歯科医院のためのテナントビルドアウト、115000ドル。; 3430平方フィート、トライ市環境。, バッグ, CONVERSE, CONVERSE CANVAS ALL STAR J OX 【2013FW】【MADE IN JAPAN】 コンバース オールスター J OX BLACK 32167431,, 【送料無料】【COACH コーチ】サイフ 長財布 ウェイバリー チェリー アコーディオン ジップ 49231_BKHPK(カーキ×ピンク), 法廷書類によると、若い女性が彼女とスティーブンスは、バンドの部屋、スティーブンスのオフィス、楽器を格納するために使用してもクローゼットの中にセックスをしなければならない警察に語った。, 折財布, ブランドプラダ 長財布 PRADA プラダ 財布 L字ファスナー『2013年春夏新作』リボン 型押しレザー タルコ 1M1183 SAF FIO SMALTO TALCO/2A18 F0K74, 午後遅くに、その緊急レベルを緩和し、多くの郡は、人々が不必要な移動を避けるために促したその下で、レベル2にとどまった。 今日。,指輪·リング-c-11_13.html, モン·サン·ミッシェルはノルマンディー、フランスの247エーカーの岩だらけの、潮の島です。 ただ、国の北西部沖の半マイルの上に位置する、島の最高地点は301フィート海抜です。 一番上に、その後修道院、修道院、その下に、グレートホール、店舗や住宅がある。 一番下には、壁の外、漁師や農家の住宅です。 モン·サン·ミッシェルは、彼らが唯一のメインストリートをスパイラルアップした場合、観光客が見ることはないコーナーを隠している。 これらの写真は、アーティストのモン·サン·ミッシェル、サンディSchopbachの心の隅である。 島、町と修道院。, 【送料無料】【COACH コーチ】トートバッグ ギャラリー オプティック シグネチャー F20444_SV/BX(ボルドー),, 【送料無料】【COACH コーチ】トートバッグ シグネチャー ストライプ ラージ 23772E_SKHGN(カーキ×グリーン), 割引操作を実行し、我々はその周りのリース契約を構造化、ヘンドリックスは言った。 バック彼からリースを取る立場にあった。 新しいテナントはショッピングセンターのための改良された使用となります。 また、ショッピングセンターのためのより良い経済的になります。 それはブライアウッドで映画の最後に言った。,ボストンバッグ-c-1_4.html, ジョー·ベル、モールを所有しているヤングベースCafaro株式会社のスポークスマンは、マッドメックスとの署名したリースが存在しないと述べた。 「しかし、それは彼らが話していないという意味ではありません、 ベルは言った。, 赤ん坊のひよこのシーズンが始まりました。 その我々は6赤ちゃんの雛を得たので、それが今年についてされてことを意味します。 私は、私たちのマスターバスルームで自分のケージから自分のさえずりに眠りに落ちるの思い出を持っている。 五鶏と意図しないオンドリは(彼らはすべての女性であることになっていた)、彼らは今、すべての育っ内外小屋に住んでいます。, 問題をさらに複雑にしている庭新鮮市場がその位置に移動するとのニュースが続く近くドミニクの店の閉鎖となりました。, 「私はただのイメージ後の画像を作り始めたと私は良いと感じた」と彼女は言った。

Leave a Reply