[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

This is an old revision of the document!


Setting up Slackware ARM 14.0 on the OLinuXino A10S Micro from scratch

This document can also be found at http://www.malaya-digital.org/setting-up-slackware-arm-14-0-on-the-olinuxino-a10s-from-scratch/

NOTE: Please use the aforementioned link for the latest documentation. The documentation below is dated. I will update the documentation below when time allows.

Setup of development environment

  • Create a VirtualBox VM for Debian 7.1.0 i386. I allocated 1024MB of RAM to it. As for the virtual hard drive space, I allocated 8GB. I also recommend that you disable audio support for the VM.
  • Download the Net Install ISO image for Debian 7.1.0 i386. Boot the mentioned ISO in the VirtualBox VM you've created. I used the “Install” option in the installer boot menu.
  • This set of instructions will work with everything deselected under “Software selection.” You may select software to your taste during installation.
  • After the installation, the guest OS will automatically get an IP Address via DHCP.
  • Install OpenSSH client and server software as root if this will make file transfers and access to your development environment convenient for you:
    apt-get install openssh-client openssh-server
  • You need to download a dependency and install it manually. Do these as root in your guest OS:
    cd ~
    wget http://www.malaya-digital.org/libgmp3c2_4.3.2+dfsg-1_i386.deb
    dpkg --install libgmp3c2_4.3.2+dfsg-1_i386.deb
  • As root, append the following line to /etc/apt/sources.list in your guest OS:
    deb http://www.emdebian.org/debian squeeze main
  • As root in your guest OS:
    apt-get install emdebian-archive-keyring
    apt-get update
    apt-get install gcc-4.4-arm-linux-gnueabi ncurses-dev uboot-mkimage build-essential git
    apt-get upgrade
  • Restart your development environment as root:
    shutdown -r now

Compiling the kernel

  • In the development environment you've made above, login as root. Then get the kernel source code:
    cd ~
    git clone https://github.com/linux-sunxi/linux-sunxi.git
  • Download a10s_olinuxino_defconfig:
    wget http://www.malaya-digital.org/a10s_olinuxino_defconfig
  • Move this file to linux-sunxi/arch/arm/configs/ . These are to be done in your development environment as root:
    mv a10s_olinuxino_defconfig ~/linux-sunxi/arch/arm/configs/
  • Execute the following under the linux-sunxi directory in your development environment as root:
    cd ~/linux-sunxi/
    make ARCH=arm a10s_olinuxino_defconfig
  • Configure the kernel in your development environment as root:
    make ARCH=arm menuconfig
    • HINT: To enable OTG (for Linux 3.4.61):
      • Under Kernel Configuration, build this in the kernel:
        • Device Drivers→USB support→[*] SUNXI USB2.0 Dual Role Controller Support
      • Then build this in the kernel, too:
        • Device Drivers→USB support→SUNXI USB2.0 Dual Role Controller Support→[*] SUNXI USB2.0 Manager
      • And make sure of the following:
        • Device Drivers→USB support→SUNXI USB2.0 Dual Role Controller Support→SUNXI USB2.0 Manager→USB0 Controller support (otg support)→(X) otg support
    • HINT: To enable Ethernet (for Linux 3.4.61):
      • Under Kernel Configuration, build this in the kernel:
        • Device Drivers→Network device support→Ethernet driver support→<*> Allwinner Ethernet MAC support
  • Edit ~/linux-sunxi/arch/arm/plat-sunxi/include/plat/i2c.h . Find “I2C0_TRANSFER_SPEED”. Define “100000” for I2C1_TRANSFER_SPEED and up. These are to be done in your development environment as root. For example, the desired edit is:
    #define I2C0_TRANSFER_SPEED (400000)
    #define I2C1_TRANSFER_SPEED (100000)
    #define I2C2_TRANSFER_SPEED (100000)
    #define I2C3_TRANSFER_SPEED (100000)
    #define I2C4_TRANSFER_SPEED (100000)
  • You can now compile the kernel and its modules in your development environment as root.
    cd ~/linux-sunxi/
    make clean
    make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- uImage
    make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- INSTALL_MOD_PATH=out modules
    make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- INSTALL_MOD_PATH=out modules_install
  • In your development environment, your kernel will be “~/linux-sunxi/arch/arm/boot/uImage”. And your modules will be found at “~/linux-sunxi/out/lib/modules/3.x.xx” where 3.x.xx is kernel version (eg: “3.4.61+”).

Compiling Uboot

(Copied from http://olimex.wordpress.com/2013/06/19/building-linux-for-a10s-from-scratch/ with some modifications)

  • The Allwinner Linux-Sunxi community uboot is maintained by Henrik Nordstrom aka hno on Freenode irc. You can find him in #linux-sunxi or #olimex channels. If something with uboot is broken, he is your man.
  • Download the uboot sources from GitHub repository. Note that there are a lot of branches. You have to use the sunxi branch.
    cd ~
    git clone -b sunxi https://github.com/linux-sunxi/u-boot-sunxi.git
  • After the download, you should have a new directory.
    cd ~/u-boot-sunxi/
  • Edit ~/u-boot-sunxi/include/configs/sunxi-common.h . Look for the following:
    "setargs=" \
    "if test -z \\\\\"$root\\\\\"; then"\
    " if test \\\\\"$bootpath\\\\\" = \"/boot/\"; then"\
    " root=\"/dev/mmcblk0p1 rootwait\";"\
    " else" \
    " root=\"/dev/mmcblk0p2 rootwait\";"\
    " fi;"\
    " fi;"\
  • Change “ root=\”/dev/mmcblk0p2 rootwait\“;”\“ to the following:
    " root=\"/dev/mmcblk0p2 ro rootwait\";"\
  • With the following command, you can start the uboot build:
    cd ~/u-boot-sunxi/
    make distclean CROSS_COMPILE=arm-linux-gnueabi-
    make A10s-OLinuXino-M_config
    make CROSS_COMPILE=arm-linux-gnueabi-
  • At the end of the process, you can check if everything is OK by:
    ls u-boot-sunxi-with-spl.bin
    • If you got this file, well done so far.

Format and setup the micro SD-card

(Copied from http://olimex.wordpress.com/2013/06/19/building-linux-for-a10s-from-scratch/ with some modifications)

  • We suggest that you use a 4GB class 10 micro SD card. But you can use micro SD any card between 2GB and 16GB.
  • First, we have to make the correct card partitions. This is done with fdisk.
  • Plug the micro SD card into your SD card reader. Then, enter in the terminal:
    ls /dev/sd
  • Then press TAB twice. You will see a list of your sd devices like sda, sdb, sdc, etc. Note that some of these devices may be your hard disk, so make sure you know which one is your micro SD card before you proceed. You can damage your HDD if you choose the wrong sd device. You can do this by unplugging your SD card reader, and identify which “sd” devices was removed from the list.
  • Once you know which device is your micro SD card, use this text instead of the sdX name in the references below:
    fdisk -u=sectors /dev/sdX
  • Then do these steps:
  • This will list your partitions:
    • p
  • If there are already partitions on your card, do:
    • d 1
  • If you have more than one partitition, delete them all.
  • Create the first partition. It should start from 2048 and end at 34815:
    • n p 1
  • Create the second partition:
    • n p 2 enter enter
  • List the created partitions:
    • p
  • If you did everything correctly on a 4GB card, you should see something like:
    Disk /dev/sdX: 3980 MB, 3980394496 bytes
    123 heads, 62 sectors/track, 1019 cylinders, total 7774208 sectors
    Units = sectors of 1 * 512 = 512 bytes
    Sector size (logical/physical): 512 bytes / 512 bytes
    I/O size (minimum/optimal): 512 bytes / 512 bytes
    Disk identifier: 0x00000000
    Device Boot Start End Blocks Id System
    /dev/sdg1 2048 34815 16384 83 Linux
    /dev/sdg2 34816 7774207 3869696 83 Linux
  • Write changes to the micro SD card.
    • w
  • Now, we have to format the file system on the card:
  • The first partition should be vfat as this is the FS which the Allwinner bootloader understands.
    mkfs.vfat /dev/sdX1
  • The second partition should be a normal Linux EXT4 FS:
    mkfs.ext4 /dev/sdX2

Installing the kernel, Slackware ARM 14.0 mini root filesystem, and kernel modules

  • Copy the ”~/linux-sunxi/arch/arm/boot/uImage“ kernel you've compiled in the development environment into the first filesystem of the micro SD card.

Mount the first partition:

mkdir /mnt/olinuxino0
mount /dev/sdX1 /mnt/olinuxino0 # Substitute the appropriate value for X in /dev/sdX1
  • Then copy the kernel uImage to the first filesystem of the micro SD card.
    cp uImage /mnt/olinuxino0 # Get the uImage file from the environment you've compiled the kernel.
  • Extract this file in /mnt/olinuxino0 : http://www.malaya-digital.org/a10s_scripts.tar.gz
  • Unmount /mnt/olinuxino0 :
    umount /mnt/olinuxino0
  • Mount the second partition:
    mkdir /mnt/olinuxino1
    mount /dev/sdX2 /mnt/olinuxino1 # Substitute the appropriate value for X in /dev/sdX1
  • Extract the Slackware ARM 14.0 mini root filesystem in /mnt/olinuxino1 .
  • Delete all contents of /mnt/olinuxino1/dev/*
  • Extract this file in /mnt/olinuxino1/dev : http://www.malaya-digital.org/dev.tar.gz
  • Proceed to copy the generated kernel modules (”~/linux-sunxi/out/lib/modules/3.x.xx“ in the development environment where you've compiled the kernel) in the second filesystem of the micro SD card.
    • If the /mnt/olinuxino1/lib/modules directory does not exist, create it.
      mkdir /mnt/olinuxino1/lib/modules
      cp -rf 3.x.xx+ /mnt/olinuxino1/lib/modules # Get the modules directory from the environment you've compiled the kernel.
  • Append the following in /mnt/olinuxino1/etc/fstab:
    /dev/mmcblk0p2 / ext4 errors=remount-ro 0 1
  • Unmount /mnt/olinuxino1 :
    umount /mnt/olinuxino1

Write Uboot

(Copied from http://olimex.wordpress.com/2013/06/19/building-linux-for-a10s-from-scratch/ with some modifications)

  • Note that you have to write u-boot-sunxi-with-spl.bin in /dev/sdX (not sdX1 or sdX2).
    dd if=u-boot-sunxi-with-spl.bin of=/dev/sdX bs=1024 seek=8
    sync

NB: When you boot OLinuXino using the micro SD card with Slackware 14.0 for ARM, the “root” user has the password “password” by default.

Sources

 howtos:hardware:arm:olinuxinoa10s ()