U-boot, Linux Kernel, and Android Patches for Freescale i.MX6 HDMI TV Dongles

Orange Pi Development Boards

We can now get some quad core Android mini PCs (e.g. Hi802, GK802) featuring Freescale i.MX6Q processor, Freescale has released full documentation and source code its development platforms, Hi802 / GK802 HDMI TV dongles are easily hackable, and there’s even an Ubuntu image for the devices. So it looks pretty good ,right? Well almost.. there are some patches and config for GK802 that have not been released by Richtechie, so we can’t modify the  bootloader and Linux kernel. But this may change, as ARMTvTech forum user hste noticed some Freescale i.MX6 HDMI dongle patches om IMX Community website. Even though I’m not sure those are fully compatible with Hi802 / GK802, this could be a starting point. Today, I’ll provide the instructions to build u-boot, the linux kernel and Android ICS with those patches in a machine running Linux 12.04 64-bit.

Patch Sets Descriptions

There are two set of patches that can be applied to R13.4-GA release:

  • hdmidongle_REVB_R13.4_patch-20121115.tgz –  Adds HDMI dongle support in U-boot, the Linux kernel and customize Android 4.0.4 for mini PCs.
  • hdmidongle_REVB_R13.4_patch-20130201.tgz –   Adds support for ldo bypass , uboot fastboot, ntfs, Bluetooth A2DP, fakes an alway full battery, removed the screen locker, and check the video mode. There are also patches for bug fixes for WifiDirect, Wi-Fi performance, uboot mmu, and system stability

A script (revb_dongle_patch_install.sh) is provided to apply 20121115 patches.

Getting Freescale i.MX6 U-boot, Linux kernel and Android source code (R13.4-GA)

Since those patches need to be applied against R13.4-GA, so we need to get the code first. The instructions are explained in section 5 “Get Android Source Code (Android/Kernel/U-Boot)” of R13.4-GA.01_Android_User_Guide.pdf.

First download IMX6_R13.4_ANDROID_SOURCE_CODE (171 MB). After download, you should get a file named imx-android-r13.4-ga.01.tar.gz that includes the documentation, patches, and Mfgtool for Android 4.0.4.

Let’s extract it, extract the (default) patches:


If you don’t have it the repo tool yet download it, and add it to your path:


Now let’s create a working directory (myandroid) and get Android 4.0.4 r1.1 AOSP source code:


repo init -u https://android.googlesource.com/platform/manifest -b android-4.0.4_r1.1
cp ../code/r13.4-ga/default.xml .repo/manifests/default.xml
repo sync

This will take a little while, after or while it’s progressing you can (also) get imx kernel and U-boot source code:


When checking out imx-android-r13.4 branch for the kernel and U-boot, you’ll get messages like:
HEAD is now at c9dfae3… ENGR00224938 HDMI audio: clear HDMI dma done bit before start
HEAD is now at 097643f… ENGR00224313:i.MX6 general:enable CONFIG_CMD_IMXOTP to fix the build error

It just shows the latest commit, so there’s no issue here.

After repo sync is complete, you’ll also need to get some more code:


Now patch all those with R13.4-GA patches:


After a lot of debug output (and warnings), you should see the following message to indicate patching was successful:
**************************************************************
Success: Now you can build the Android code for FSL i.MX platform
**************************************************************

We’re done for this part we now have all source for R13.4-GA release.

Patching R13.4-GA with HDMI dongle patches

We can now patch the code to add HDMI dongle support. I’ll assume you’ve downloaded all 3 files describe at the top of this post to ~/edev/Freescale/imx-android-r13.4-ga directory:


For the second set of patches, you’ll noticed patches 0001 to 0012 have been applied, except 0008 since it’s not needed anymore.

One more step completed. Have a tea break, or drink a beer, since there’s still a bit more work to do.

Building U-Boot, the kernel and Android for Freescale i.MX6 HDMI TV Dongles

I’m probably missing some per-requisites in this part, and most required dependencies were already installed in my PC. You may want to have a look at the post “How to compile Android on Ubuntu 12.04“, and in particular the part about install Sun Java 6 JDK, where you need to download Sun Java 6 JDK, install it, and run update-alternatives:


Now we should be ready to build:

Build Freescale imx6 hdmidongle lunch menu

We can select either hdmidongle_6dq-eng or hdmidongle_6dq-user for the build. The “eng(ineering)” build is a debug build, and the “user” build is a release version. I’ve gone with hdmidongle_6dq-user (15) to try it out.

In theory, we now just need to run make:


However “in theory, there is no difference between theory and practice; In practice, there is”, and I’ve come across a few issues during the build, and if you build in Ubuntu 12.04 64-bit, you may want to perform the following steps before running make.

Some directories are duplicates in the source tree, and the build ends with error such as:

build/core/base_rules.mk:166: *** external/mtd-utils/mtd-utils/mkfs.ubifs: MODULE.HOST.EXECUTABLES.mkfs.ubifs already defined by external/mtd-utils/mkfs.ubifs.  Stop

I fixed it by deleting one of the duplicate in the source:


I found some dependencies missing, so you may have to install:


But the build still failed, so here’s an ugly hack:


Then I got several errors:

error: “_FORTIFY_SOURCE” redefined [-Werror]
make: *** [out/host/linux-x86/obj/EXECUTABLES/obbtool_intermediates/Main.o] Error 1

The solution is to edit vi build/core/combo/HOST_linux-x86.mk and edit the corresponding line as follows:


Source: http://code.google.com/p/android/issues/detail?id=20795

External/mesa3d/src/glsl/linker.cpp:1734:59: error: ‘offsetof’ was not declared in this scope make: *** [out/host/linux-x86/obj/STATIC_LIBRARIES/libMesa_intermediates/src/glsl/linker.o] Error 1

Edit external/mesa3d/src/glsl/linker.cpp and add #include <stddef.h>
Source: http://code.google.com/p/android/issues/detail?id=23206

host C++: liboprofile_pp <= external/oprofile/libpp/arrange_profiles.cpp In file included from external/oprofile/libpp/arrange_profiles.cpp:24:0: external/oprofile/libpp/format_output.h:94:22: error: reference ‘counts’ cannot be declared ‘mutable’ [-fpermissive] make: *** [out/host/linux-x86/obj/STATIC_LIBRARIES/liboprofile_pp_intermediates/arrange_profiles.o] Error 1

Edit external/oprofile/libpp/format_output.h and Remove ‘mutable’ from ‘mutable counts_t & counts;’ on line 94 => counts_t & counts;
Source: https://groups.google.com/forum/?fromgroups=#!msg/android-building/2EwtWQTqjdI/eBl1bK-KNM8J

external/gtest/src/../include/gtest/internal/gtest-param-util.h:122:11: error: ‘ptrdiff_t’ does not name a type

Edit external/gtest/include/gtest/internal/gtest-param-util.h and add one line:


Source: http://code.google.com/p/android/issues/detail?id=22005

/home/jaufranc/edev/Freescale/imx-android-r13.4-ga/myandroid/external/llvm/lib/Support/Mutex.cpp:143: undefined reference to `pthread_mutex_trylock’
collect2: ld returned 1 exit status
make: *** [out/host/linux-x86/obj/EXECUTABLES/test-librsloader_intermediates/test-librsloader] Error 1

Edit vi frameworks/compile/linkloader/Android.mk and rename LOCAL_LDFLAGS to LOCAL_LDLIBS.
Source: https://bugs.launchpad.net/linaro-android/+bug/1018832/comments/6

frameworks/compile/slang/slang_rs_export_foreach.cpp:249:23: error: variable ‘ParamName’ set but not used [-Werror=unused-but-set-variable]
cc1plus: all warnings being treated as errors
make: *** [out/host/linux-x86/obj/EXECUTABLES/llvm-rs-cc_intermediates/slang_rs_export_foreach.o] Error 1

Edit frameworks/compile/slang/Android.mk and remove -Werror
Source: http://code.google.com/p/android/issues/detail?id=22006

After all those changes, I was finally able to complete the build with the output in out/target/product/hdmidongle_6dq including the following directories and files:

  • root/ – Root file system (including init, init.rc, etc). Mounted at /
  • system/ – Android system binary/libraries. Mounted at /system.
  • data/ – Android data area. Mounted at /data.
  • recovery/ – Root file system when booting in “recovery” mode.
  • boot.img – Image which includes the kernel zImage, ramdisk, and boot parameters.
  • ramdisk.img – Ramdisk image generated from “root/”.
  • system.img – EXT4 image generated from “system/”. It can be programmed to “SYSTEM” partition on SD/eMMC card with “dd”.
  • userdata.img – EXT4 image generated from “data/”.
  • recovery.img – EXT4 image generated from “recovery/”. It can be programmed to “RECOVERY” partition on SD/eMMC card with “dd”.
  • u-boot-6q.bin – U-Boot image with padding for i.MX 6Quad version of the HDMI dongle.
  • u-boot-6dl.bin – U-Boot image with padding for i.MX 6Dual version of the HDMI dongle.
  • uImage – Kernel image

If you just want to build U-boot and/or the Kernel follow section 5.3 and 5.4 in R13.4-GA.01_Android_User_Guide.pdf. For the kernel there are 5 configs which all seem quite different from GK802 config:

  • imx6_android_defconfig – Android kernel config
  • imx6_defconfig – Linux kernel config
  • imx6_nand_android_defconfig
  • imx6_nand_updater_defconfig
  • imx6_updater_defconfig

To build U-boot for Freescale HDMI dongles, there are over 12 config (6 for i.MX6 dual, 6 for i.MX6 Quad), but the most interesting appear to be mx6q_hdmidongle_android_config and mx6q_hdmidongle_nand_android_config.

That’s all for today, I’ll post more if I, or somebody else, make progress trying it or/and building it for GK802 / Hi802 mini PC.

Leave a Reply

40 Comments on "U-boot, Linux Kernel, and Android Patches for Freescale i.MX6 HDMI TV Dongles"

avatar
  Subscribe  
newest oldest most voted
Notify of
S
Guest

Were you able to put the software on your gk802? And if so, did it boot??

The Cageybee
Guest

Do you know if X acceleration is supported or enabled?

trackback

[…] También en CNX-Software comentan como compilar ficheros necesarios para generar una distribución AQUI […]

S
Guest

@cnxsoft: You’ll find a dropbox mirror there as well :-)….

Jasbir
Guest

@cnxsoft
Richtechie have create there own BSP that partially implements the HDMI dongle BSP. Anyway I’m making progress in getting the kernel to boot.

Fma965
Guest

@cnxsoft

Great 🙁 Why richteechie lying to us for 🙁

Jasbir
Guest

@cnxsoft
Finally got a compiled kernel to boot all the way 🙂 , still requires a bit more work….

EXT4-fs (mmcblk0p1): mounted filesystem with ordered data mode. Opts: (null)
VFS: Mounted root (ext4 filesystem) on device 179:1.
Freeing init memory: 184K

Last login: Wed Dec 31 16:03:27 PST 1969 on tty1
Welcome to Ubuntu 12.04.1 LTS (GNU/Linux 3.0.35-05236-gc9dfae3-dirty armv7l)

[email protected]:/# ls /
bin dev home lost+found mnt proc run selinux sys unit_tests var
boot etc lib media opt root sbin srv tmp usr

Dmitriy Beykun
Guest

@cnxsoft
Hi, I’m rz2k, I was testing the sources on my hi802 that arrived this week. I want to have both u-boot and kernel loading, it seems like @Jasbir uses richtechie provided u-boot, not the one from sources. Also one of my goals is to disable HDMI I2S audio, without this my DVI monitor locks up really hard.

If there are many guys trying to work this out – maybe we need to set up ML or IRC channel for this? Since i.MX has good support and docs, usage of chinese cheap hw can go really far, might replace A10 one day.

Dmitriy Beykun
Guest

@cnxsoft
I believe richtechie only changed the LDO (hi802 uses couple of DC-DC convertors on board and nothing else, reference design uses maxim PMIC) and DDR memory setup, HDMI drivers are standard from freescale.

Jasbir
Guest

cnxsoft :
@Fma965
That does not mean we can’t use it, but there may be a bit more work. I guess they don’t want to release their work, because they don’t want other companies to copy their product.
@Jasbir
Great. Since we don’t have the HDMI part from Richtechie, do you have any video output?

Yes video out is working.

Jasbir
Guest

Dmitriy Beykun :
@cnxsoft
I believe richtechie only changed the LDO (hi802 uses couple of DC-DC convertors on board and nothing else, reference design uses maxim PMIC) and DDR memory setup, HDMI drivers are standard from freescale.

Reference design is based on booting from flash memory not SD card. Also the IOMUX pins can be setup differently depending on the perpherials supported.

Dmitriy Beykun
Guest

@Jasbir
Yeah, I get it now. The HDMI dongle board is another reference design upon what hi802 is based. They replaced Wolfson PMIC with couple of passive regulators + internal imx6q LDO, replaced NAND with SD and that should be it.

I’ve placed a github repo with all patches that I’ve found applied. https://github.com/rzk/linux-imx/commits/imx-android-r13.4-ga-hdmidongle

Any help is welcome.

Jasbir
Guest

@Dmitriy Beykun
Yep, we can’t use HDMI reference design code out of the box. I started with the kernel because it is easier to test out the hardware differences. Once those difference are known then uboot will be easier to implement.

Finally got a kernel working that boots up Ubuntu oneiric, desktop appears ok but requires more work but making steady progress.

@cnxsoft
IRC channel would be useful, imx6-minipc sounds good.

Dmitriy Beykun
Guest

@cnxsoft
yes, I just had bad import/mirror if uboot-imx, many tags disappeared, will try again asap, also since this u-boot needs a lot of work to be useful, I didnt prioritize it against the kernel, that was confirmed working with default shipped u-boot.

GG name sound good, for IRC, imx6-dongle sound good.

trackback

[…] week, I explained how to build U-boot, the kernel, and Android for Freescale i.MX6 HDMI dongle reference platform. Since them, there has been a bit more activity, with Richtechie releasing […]

trackback

[…] of proper Linux support on the device was fading, until the community discovered Freescale released patches for i.mx6 HDMI dongles, developers setup the imx6-dongle community, and after a lot of work, mainly by three members: […]

hroth
Guest

That’s funny – it looks like the R13.4-GA release is not available for download anymore?

The Freescale web site isn’t easy to navigate, but:
http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=IMXANDROID&fpsp=1&tab=Design_Tools_Tab

Shows that IMX6_R13.41_ANDROID_SOURCE_CODE is the only version available.

Similarly on the community web site,

There *is* a R13.4-GA.03 general patchset – https://community.freescale.com/docs/DOC-94597

But the GA code itself is inaccessible.

There is a R13.4.1.04 general patchset as well – https://community.freescale.com/docs/DOC-94596

Am I missing something? Is there a big difference between R13.4-GA and R13.4.1?

Will the HDMI Dongle patches work for that? Si

trackback

[…] already had the source code for Freescale i.MX6 HDMI TV dongle, and some work has been done on the Linux front by imx6-dongle community to make Ubuntu work on […]

hroth
Guest

@cnxsoft
Thanks for your rescue again! I went to the website you mentioned and downloaded the repository as a Zip file… Seems a little small (127 MB). But here goes! If I get somewhere I’ll be sure to give a blow-by-blow so your other readers will have a reference.

hroth
Guest

@cnxsoft

I downloaded the R13.4-GA from the Boundary Devices git but went ‘off the rails’ on your step-by-step instructions since the directory structure was different. I did try the R13.4.1 from Freescale but the patches definitely do not work.

I did download Richtechie’s so-called released source code since it seems to have the R13.4-GA kernel source, which includes the hid-quanta.c that I’m after. Again, I’m still learning – so I can’t map Richtechie’s release into your step-by-step instructions above.

But taking a step back, how about another dumb question:

To just get to a kernel module (instead of bootstrapping the entire kernel) is there a simple way to either:

a) Get i.mx6 Android binaries for kernel development (compiler, menuconfig, etc) within Android so I can just build the kernel module within the i.mx6?

b) Set up a Ubuntu 10.04 VM to simply cross-compile the kernel module and insert the module? I guess I have to assume the Richtechie source-code ‘release’ is close enough for the 1.65.4 firmware available.

Michael
Guest

Hello,

unfortunately the link to the IMX6_R13.4_ANDROID_SOURCE_CODE is not working. Do you have alternatives to get the R13.4 Android sources for the iMX6?

Many thanks and best regards,
Michael

Michael
Guest

Sorry, I am a bit confused. The link only shows the kernel sources. I think I need the whole Android sources. I do not mind if it is 4.2.2 or 4.0.something. I only need to add a new HDMI/DVI mode to my GK802 that is not supported by default. If there is a set of u-boot/kernel/Android sources that can be compiled for a GK802 out of the box tis would be great.
Best regards, Michael