Developers working on AllWinner A10 have released an Ubuntu 10.04 LTS SD card image (4GB) for the Mele A1000.
I’ll show how you can create your own Debian or Ubuntu image based on this image for any size of SD Card using Debian 6.0 (Squeeze) and the recent Ubuntu 12.04 (Precise Pangolin) as example. The current image is not perfect, for example Ethernet doesn’t work (but you can still get network connectivity with WiFi), the NAND flash can not be accessed, the system does not appear to be very stable when running X and a few more issues. But this will be fixed by the developer community over time.
First download the SD card image
wget http://hands.com/~lkcl/mele-ubuntu-lucid.img.lzma
Install 7z (if you don’t have it yet) and decompress the file:
sudo apt-get install p7zip-full
7z x mele-ubuntu-lucid.img.lzma
The decompressed size is 4008706048, which might be larger than your 4GB SD Card (as it was my case). If you card is larger, you can simply dd the image to it:
dd if=mele-ubuntu-lucid.img of=/dev/sdX
where X is the letter corresponding to your SD Card device.
Let’s now have a look at the partitions in this image:
file mele-ubuntu-lucid.img
mele-ubuntu-lucid.img: x86 boot sector; partition 1: ID=0x83, starthead 33, startsector 2048, 32768 sectors; partition 2: ID=0x83, starthead 65, startsector 34816, 7794688 sectors, code offset 0x0
There are 2 partitions, let try to mount in 2 directories using the startsector value:
mkdir mnt
mkdir mnt2
sudo mount -o loop,offset=$((512*2048)) mele-ubuntu-lucid.img mnt
sudo mount -o loop,offset=$((512*34816)) mele-ubuntu-lucid.img mnt2mount | grep loop
/dev/loop0 on /home/jaufranc/edev/mele_A1000/mnt type vfat (rw,offset=1048576)
/dev/loop1 on /home/jaufranc/edev/mele_A1000/mnt2 type ext4 (rw,offset=17825792)
So we can now see the content of the 2 partitions:
- Partition 1 (FAT 32) – Linux 3.0.8 Kernel (uImage) + some binaries files (evb.bin, mele.bin and sys_config1.mele_mod.bin).
- Partition 2 (EXT-4) – Ubuntu 10.04 rootfs
There are some files specific to A10 in the rootfs, namely the kernel modules and OpenGL ES files, so we need to extract them in order to copy in the our new rootfs lateron.
cd mnt2
tar cjvf ../a10_modules_3.0.8.tar.bz2 lib/modules/3.0.8+/
tar cjvf ../a10_opengles.tar.bz2 lib/libUMP.so lib/libEGL.so lib/libGLESv2.so lib/libGLESv1_CM.so lib/libMali.so
cd ..
sudo umount mnt
sudo umount mnt2
We haven’t found the bootloader yet, but you may noticed there is a 1MB offset (512*2048) for the first partition, that because the partition table and the bootloader are located in the first 1MB of the SD Card as explained in A10 MMC Page. There are two part for U-boot: U-boot and the X-loader up-streaming(SPL), but they are both located in the first 1MB of the SD Card.
Now let’s make a copy of u-boot (and u-boot SPL) and the FAT 32 partition:
dd if=mele-ubuntu-lucid.img of=mele_u-boot.bin bs=1024 skip=8 count=1008
dd if=mele-ubuntu-lucid.img of=mele_kernel_3.0.8_vfat.bin skip=2048 count=32768
Now that we have all what’s needed from the SD card image, let’s create the root file system.
Here are the instructions to get a minimal Debian 6.0 (Squeeze) rootfs:
mkdir debian_armel_squeeze
sudo apt-get install debootstrap
sudo debootstrap --foreign --arch armel squeeze debian_armel_squeeze http://ftp.debian.org/debian
Here are the instructions to get a Ubuntu 12.04 (Precise Pangolin) desktop: (JLA check command in Ubuntu virtual box)
sudo apt-get install rootstock
sudo rootstock --fqdn ubuntu --login ubuntu --password ubuntu --imagesize 3G --seed ubuntu-desktop,openssh-server --serial ttyS0 --dist precise
Which ever command you choose it will take while, so in the meantime, let’s prepare the SD Card. I’ll only provide a summary here, for line by line details refer to the instructions provided in the Format section of A10 MMC page. I’ll use /dev/sdb as the drive letter, it may be different on your computer.
- Wipe out the SD card partition table:
1sudo dd if=/dev/zero of=/dev/sdb bs=1M count=1 - Create 2 partitions with fdisk:
1sudo fdisk /dev/sdb
The first partition must start at sector 2048 and its size must be 16MB.
The second partition must start at sector 34816 (I think this may slightly vary depending on your SD card) and fill the rest of the SD card. - Format partition 2:
1sudo mkfs.ext4 /dev/sdb2 - Copy the u-boot and kernel binaries to your SD card
12sudo dd if=mele_u-boot.bin of=/dev/sdb bs=1024 seek=8sudo dd if=mele_kernel_3.0.8_vfat.bin of=/dev/sdb1
Once the rootfs of your choice has been generated, first mount the ext4 partition:
1 |
sudo mount /dev/sdb2 mnt |
Then copy the rootfs to the SD card together with the kernel modules and OpenGL ES files. We are using Ubuntu 12.04 armel here, but if you want to use Ubuntu 12.04 armhf (hard-float) the OpenGL ES file might not work on this system, and AllWinner would have to release hard-float binaries.
For Debian:
1 2 3 4 5 |
sudo cp -a <code>debian_armel_squeeze/* mnt cd mnt sudo tar xjvf ../a10_modules_3.0.8.tar.bz2 sudo tar xjvf ../a10_opengles.tar.bz2 cd .. sudo umount mnt |
For Ubuntu:
1 2 3 4 5 6 |
cd mnt sudo tar xzvf ../armel-rootfs-201204060847.tgz sudo tar xjvf ../a10_modules_3.0.8.tar.bz2 sudo tar xjvf ../a10_opengles.tar.bz2 cd .. sudo umount mnt |
At this point the Ubuntu image is basically done and you should be able to see the desktop and login, as long as the Mele A1000 is connected to an HDMI display.
For Debian, you’ll need to complete the second stage of deboostrap and add the apt-get source list using the Mele A1000 serial console, basically following the instructions given in the section “Generating ARMEL Debian Squeeze Rootfs” of that post. Since Ethernet does not work and WiFi is then required for internet connectivity, you also need to go to http://www.debian.org/distrib/packages#search_packages, download the Debian Squeeze armel packages for libdbus-1-3, libiw30, libnl1, libpcsclite1, multiarch-support, wireless-tools_30 and wpasupplicant_0.6 and copy them to the ext4 partition or a USB thumbdrive to install it at a later stage. You can install the package with dpkg in the Mele A1000:
1 |
sudo dpkg --i *.deb |
If you’d like to use the network in your device (including apt-get), you’ll need to setup Wi-Fi. With Ubuntu, you can simply do so in the graphical interface like you would do in PC or use the following instructions for Debian. With Debian, create /etc/network/interfaces file as follows (assuming you are using WPA/WPA2):
1 2 3 4 |
auto wlan0 iface wlan0 inet dhcp wpa-ssid ESSID wpa-psk password |
Make sure the Wi-Fi module (8192cu) is loaded with lsmod. If not, run depmod -a and possibly restart your device.
Wi-Fi should start automatically, if not run “ifup wlan0”.
By default (due to a setting in the Android kernel provide), a normal user will not be able to access the network, to change that (for user ubuntu):
1 2 |
sudo groupadd -g 3003 aid_inet sudo usermod -a -G aid_inet ubuntu |
A final tip. In case you prefer to use VGA instead of HDMI, you can use this code:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
int main(int argc, char const *argv[]) { unsigned long args[4]; int ret = -1; int disp = open("/dev/disp", O_RDWR, 0); args[0] = 0; args[1] = 0; args[2] = 0; args[3] = 0; ret = ioctl(disp,0x201,(unsigned long)args); //turn VGA off args[1] = 0x4; //set mode to 1024x768 ret = ioctl(disp,0x202,(unsigned long)args); //set the mode ret = ioctl(disp,0x200,(unsigned long)args); //turn VGA on again return 0; } |
The value in this code are based on drv_display_sun4i.h in the kernel code.
Build it and run it:
1 2 |
gcc vga_on.c -o vga_on sudo ./vga_on |
In case somebody tries those instructions and find some issues or have ideas for improvements, please let me know in the comments section as I may have missed some steps.
Jean-Luc started CNX Software in 2010 as a part-time endeavor, before quitting his job as a software engineering manager, and starting to write daily news, and reviews full time later in 2011.
Support CNX Software! Donate via cryptocurrencies, become a Patron on Patreon, or purchase goods on Amazon or Aliexpress
really good writeup .. thx
Very good tutorial !
I make Ethernet work by adding one line into the evb.fex file,
“emac_power = port:PH15″
insert this line in the end of [emac_para] setting.
I also replaced the MAC=”000000000000” by the one on my machine which can be found on the RJ45 network Interface, but I am not sure whether it is necessary
Since the HTML syntax, I cannot reply the correct setting.
So I share my evb.fex at http://dl.dropbox.com/u/15543924/evb.fex
@ suzuke
Thanks for the file suzuke! Sorry about the quote issue in WordPress comments.
Known issues: It seems only work with wicd.
@ suzuke
Thanks, I also work for me. Also I have VGA image, have you changed something else?
You can also use Debian armhf instead of armel as that works fine. I had my debian setup before you posted this and didn’t bother copying over the files that you put in a10_opengles.tar.bz2. Do they get used for anything and/or work at all?
@ opk
Currently they are not used, but are needed if want to use the GPU for 2D/3D acceleration. Btw, I’ve tried es2gears but it fails. If you want to play videos, there is the CedarX library, which is also delivered in binary form.
All those binaries are only available for armel for now and would not work for armhf.
@ chiribe
I also modified “disp_init” setting according to Steev’s recommendation in BarryK’ blog.
Here is the url : “http://bkhome.org/blog/?viewDetailed=02808”
Hi,
Nice one I’m gonna try it.
In the below point 4 you mean is SD card and not CF card right ?
4.Copy the u-boot and kernel binaries to your CF card
@ Saravana
Yes, you are right. I’ve corrected the typo.
@ cnxsoft
That was fast. Also one more typo your first HyperLinK ” A10 MMC Page” works but not the second. Sorry for pointing all silly errors.
@ Saravana
Thanks. Anything else let me know. 🙂
The section containing “sudo cp -a debian_armel_squeeze/* mnt…” is missing line breaks. This results in not being able to see the last command. (view source in your browser shows the commands in full).
@ robertjw
Thanks, it is fixed now. WordPress sometimes does strange things when switching between Viewer and HTML tabs…
It works great thnx for all the information. There is only one problem; The SD card interface is very slow. Therefore i would like to install the linux image on a Harddisc.
Is it possible and how can i do that?
@ jchaos
If you are using Ubuntu 12.04 make sure you select Ubuntu 2D, the default Unity 3d interface will be very slow.
As for installing the Linux image in the hard disk, it’s possible. But I don’t have a 2.5″ SATA hard disk, so I don’t know the exact procedure. I think some people have done it on arm-netbook mailing list, by changing evb.bin, the boot loader parameters and possibly recompiling the kernel.
Hi,
I dont suppose you can release the compliled versions of debian and ubuntu ready for install onto an SD Card? Im having major issues trying to compile and get it working?
Thanks
Mathew
@ Mathew
Since at the time it was not really stable, I just provided the instructions to build it. But the image will be available soon, or at least much simpler instructions (e.g. 3 lines instructions). It still have some issues with the latest bootloader before I can provide those. In the meantime, you can also use Ubuntu 10.04 image mentioned at the top of the post.
Hi,
I’m stuck with rootstock because I’m on Mac. I’ve done almost everything but still cannot build Ubuntu 12 image. Has anybody built it already?
Regards,
Alexander
@ Alexander What ? you don’t already have a dualBoot with Linux ?
@ Mathew
@ Alexander
You can try the new method (about 3 steps) to create an SD card image with Ubuntu 12.04 (Linaro version):
http://www.cnx-software.com/2012/06/13/hardware-packs-for-allwinner-a10-devices-and-easier-method-to-create-a-bootable-ubuntu-12-04-sd-card/
@ cnxsoft
I’ve found this – https://www.miniand.com/forums/forums/2/topics/1
@ Alexander
Yes, this is based on Ubuntu 10.04 release with kernel 3.0.8+ and probably based on the instructions above.
This easy to replace Ubuntu 10.04 rootfs with Ubuntu 12.04 rootfs. I suppose this image works, but it does not work with kernel 3.0.31 because SATA is now enable. I might receive a Z802 soon, so I might be able to investigate.
Hi, I just got a couple of Mele A10 boards and had a bash at cross compiling Debian Wheezy (ARMHF) .. which all seemed to go smoothly BUT .. what a nighmare the GIT UBOOT are at the moment .. no matter what i tried i couldnt get them to work .. gave up in the end after reading stories about the GIT code being broken e.t.c. … in the end used the image of a known UBOOT bootable linaro server and copied my Kernel/script.bin/boot.scr in to ROOT partition (deleting existing) and likewise copied my ROOTFS/modules in to ROOTFS partition…… Read more »
@ mac me
To build u-boot, kernel from source, you can try the scripts I did for the hardware packs:
http://www.cnx-software.com/2012/06/13/hardware-packs-for-allwinner-a10-devices-and-easier-method-to-create-a-bootable-ubuntu-12-04-sd-card/
For server, you can just use “mele-a1000-server” as the product. There is no display, but you’ll have maximum memory. And then you can just create an SD card image with something like “./a1x-media-create.sh /dev/sdb hardware_pack.7z wheezy_rootfs.tar.bz2”
sda is for SATA or USB, but the SD card slot is connected via the SD card I/F of the CPU, that’s why the device is seen as mmcblk0.
@Jean-Luc Aufranc (CNXSoft)
hi,
thx for the reply and the scripts … im happy just to have it up and running at the mmt and ready to move on now to get the build a bit better with more memory and a clean shutdown
what about the nand being mounted ? is that normal ?
thx
ian
@ mac me
The NAND flash is not mounted in the image is currently use (ALIP).
I’ve seen you also asked about testing Ethernet performance. I used iperf and top. http://www.cnx-software.com/2012/06/22/ubuntu-12-04-server-armhf-image-for-mele-a1000a2000/comment-page-2/#comment-9283
But there may be a better way to test that.
Do you still get any hardware acceleration on this board if you replace the original Android with a Linux distro? I’m talking mainly about hardware video decoding.
@ M.C.
Not really.
There is some code (https://github.com/amery/allwinner-a10-video) but it does not appear to work.
There is a working sample in http://hands.com/~lkcl/mele-ubuntu-lucid.img.lzma, I think it’s only available in binary.
Finally, one of XBMC developers has already obtained the cedarx libs and sample code, but AFAIK it’s not available publicly yet.
Hey,
we want to cross compile some of the drivers and put it on this ubuntu image. Can you please provide us the source code of the kernel used, so that we can cross compile those drivers.
@Ashwin Jain
Source and instructions: http://www.cnx-software.com/2012/06/13/hardware-packs-for-allwinner-a10-devices-and-easier-method-to-create-a-bootable-ubuntu-12-04-sd-card/
Hi.
Is there a method to switch the HDMI output from YCrCb to RGB, and to use Other resolutions, like 1024*768?
Background: I don’t have a Mele, but an A10 stick that has only a HDMI output. I want to use a DVI Monitor with an adapter. This works, but colours and aspect ratio are off.
Is there any way to get puppy arcade(http://scottjarvis.com/page105.htm) running on the MK802?
@Peter
It looks like Puppy Arcade is actually an OS based on Puppy Linux, and AFAIK there is no ARM port just now, so somebody needs to work on it.
You may get a better answer on Puppy Arcade website.