DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

TODO

====== Old guide: Installing Linux on your AC100 ======
{{:woa_outdated.gif?nolink&200|}} Having problems with the old guide? Ask around on [[links|IRC]].
^ :!: Before doing anything else, please, help yourself, help people who would like to help you: Make Backups !\\ [[backups|How to backup and restore your AC100]]^

===== Which Linux or rather which kernel should I use ? =====

There is number of options available, but generally Ubuntu Oneiric Ocelot is what you are looking for.\\ 
\\ [[https://wiki.ubuntu.com/ARM/TEGRA/AC100#Installer|
GET UBUNTU 11.10 NOW!]]

Ubuntu is definitely the easiest way to get Linux onto a AC100. However - if you are a Linux-User with more experience - or - if you want to learn more about how Linux works - then Gentoo might be an interesting alternative. All software is compiled during installation (interesting for all NON-X86 architectures) and therefore the assortment of software is bigger and your are not dependent on the choice the distribution made for you. Another advantage of Gentoo is shurely the possibility to get the smallest Linux running (light-weight) which fits exactly to your demands.
But WARNING: This stuff is not for Linux-Newbies!  
===== Preparation - Common steps =====

* install [[nvflash|nvflash]] or [[putusb]] (warning: with putusb you're on your own, it's not fully tested and you might have problems restoring your backups)
  * [[backups|backup]] your AC100. Did I already say it ? 
  * you might want to [[repartition_mmc|repartion your internal MMC]]

===== How to install: =====
==== Ubuntu (Natty) ====

=== Please note that natty is not supported, nor should be used. ===

* First install [[nvflash|nvflash]] and make a [[backups|backup]].
  * Download [[http://people.canonical.com/~ogra/tegra/2.6.37/boot-installer-2.6.37-1-ac100.img|boot-installer-2.6.37-1-ac100.img]].
  * Start AC100 into developer mode (CTRL + ESC + POWER).
  * nvflash -r --download 6 boot-installer-2.6.37-1-ac100.img
  * Download [[http://people.canonical.com/~ogra/tegra/2.6.37/ubuntu-natty-netbook-2.6.37-1-ac100-rootfs.tgz|ubuntu-natty-netbook-2.6.37-1-ac100-rootfs.tgz]] to a usb stick and put it into the AC100.
  * Restart the AC100 normal. 
  * Installation to mmcblk0p7? => yes [it is the biggest partition 14, the storage-partition of android]
  * After a automatical reboot some error message ocurrs (plymouth...). But it doesn't matter.
  * Now go through the normal installation process.
  * If the mouse pointer freezes please unplug the usb stick and plug in a usb mouse.
  * If all finished, please upgrade with the following: sudo apt-get update && sudo apt-get install linux-ac100

==== Ubuntu Oneiric ====

Same as the above but use the rootfs from here:
http://cdimage.ubuntu.com/releases/oneiric/release/

Install instructions can be found here:
https://wiki.ubuntu.com/ARM/TEGRA/AC100

Note on suspend:
It works out of box if you're running Android 2.1 bootloader, otherwise you'll need either revert to [[https://lists.launchpad.net/ac100/msg00297.html | 2.1]] or tweak /boot/bootimg.cfg:
  - remove lp0_vec option from cmdparam line in /boot/bootimg.cfg
  - <ctrl-C> whole line with resulting cmdline
  - execute sudo [[abootimg]] -u /dev/mmcblk0p2 -c "<ctrl-V>"

Examples:((these are examples from ac100-116 machine, yours may differ in values))
<file txt bootimg.cfg>
bootsize = 0x800000
pagesize = 0x800
kerneladdr = 0x10008000
ramdiskaddr = 0x11000000
secondaddr = 0x10f00000
tagsaddr = 0x10000100
name = Ubuntu Boot Img
cmdline = mem=448M@0M tegrapart=recovery:300:a00:800,boot:d00:1000:800,mbr:1d00:200:800 root=UUID=3aee423d-d428-4e01-9804-0aa1948099e8 quiet splash
</file>
<file txt aboot-update.sh >
sudo abootimg -u /dev/mmcblk0p2 -c "cmdline = mem=448M@0M  tegrapart=recovery:300:a00:800,boot:d00:1000:800,mbr:1d00:200:800 root=UUID=3aee423d-d428-4e01-9804-0aa1948099e8 quiet splash"
</file>

linux-ac100 package is provided in Oneiric repositories, not need to add ppa. Atomatic kernel update is supported.

Continue installing properitary video driver (see L4T drivers [[http://ac100.grandou.net/links | linked here]]), [[http://ac100.grandou.net/apps#flash | flash support]] and further [[apps]]

With Beta 2 release and kernel 2.6.38-1000-ac100 as provided in the Oneiric repository since 2011/09/24 all the features of previous versions are supported (suspend, headphone sound, lid events) and we recommend an Oneiric install instead of Natty.

Anyway, it is adviseable to use some lightweight desktop environment. I can recommend LXDE on the Ubuntu basis. It is much faster regarding boot time, tool launch, file manager, etc and uses less RAM/eMMC in contrast to Ubuntu Unity/Gnome. --- //[[pibach@web.de|Peter Ibach]] 2011/10/02 15:58//

See [[ubuntu_deubuntuization]] on how to cleanup your installation.
===== More installation HOWTOs =====

* [[http://ac100.tunk.org/wiki/phh/|phh]] (ubuntu with kernel version 2.6.32, working suspend and headphones audio)
  * [[https://wiki.ubuntu.com/ARM/TEGRA/AC100|ubuntu]] (offical ubuntu page with install instructions for kernel version 2.6.38 and later. Automatic kernel updates through Oneiric repositories or PPA ((ppa:ac100/ppa)) for Natty. Status 2011/10/01, Ubuntu Oneiric Ocelot Beta 2 with kernel 2.6.38-1000-ac100: suspend works with Android 2.1 bootloader, audio working over headphones
  * [[http://wiki.debian.org/InstallingDebianOn/Toshiba/AC100|debian]]
  * [[fedora|Fedora]]
  * [[gentoo|Gentoo]]
  * [[ArchLinux]] - Status 2011/10/01: latest zram support. More in [[http://archlinuxarm.org/forum/viewtopic.php?f=27&t=1626 | this thread]].
  * [[http://www.redsleeve.org/|RedSleeve Enterprise Linux (RSEL)]] soon-to-be-released RHEL6 port by [[http://www.altechnative.net/|Gordan Bobic]].

===== SOSBoot =====

[[sosboot|SOSBoot]]

====== New guide: Installing Linux on your AC100 ======
^ :!: Before doing anything else, please, help yourself, help people who would like to help you: Make Backups !\\ [[backups|How to backup and restore your AC100]]^

This guide is not complete yet. For now, follow the "old" guide above.

===== Prerequisites =====

It is highly recommended to [[backups|backup]] all data on your AC100 before continuing. With access to the original partitions, it is practically impossible to make irreversible changes to (that is, to "brick") your AC100; it's simply not going to happen.

For the rest of this guide, you'll need:

* Your AC100
  * A secondary computer ("helper") for [[nvflash|nvflash]] / putusb operations
  * A mini-USB (male) to USB (male) cable

===== Choice of distribution =====

The AC100 is an ARMv7 system, so you'll want to run a distribution with ARMv7 repositories (or a source distribution, like Gentoo). We'll discuss some alternatives presently, but if you're in doubt, just choose Ubuntu.

=== Ubuntu ===

You can run Ubuntu on the AC100! [more]

You may follow the dedicated [[ubuntu|Ubuntu]] installation guide, or keep reading, for general instructions.

=== Arch Linux ARM ===

ALARM works very well on the AC100!

Choose this distribution for a KISS system. You'll assume responsibility for the dirty details of system administration. As a novice user, prepare to wade through a lot of knowledge about modern Linux distributions,  with the Arch wiki holding your hand firmly.

Users of (regular/x86) Arch Linux will feel very much at home with ALARM; there isn't really any difference from user point of view. The vast majority of packages from x86 Arch repositories are available in ALARM's armv7h counterparts, and ABS and the AUR are fully at your service.

You may follow the dedicated [[archlinux|Arch]] installation guide, or keep reading, for general instructions.

=== Gentoo ===

Gentoo is Gentoo. [more]

=== Fedora ===

?

=== Slackware ===

It should be very possible to run Slackware on AC100.

=== RSEL ===

RedSleeve Enterprise Linux, Gordan Bobic's RHEL ARM port. [more]

===== Choice of kernel =====

Once you've settled for a distribution, you need to choose a Linux kernel adapted to the AC100. This is provided mainly by the [[https://gitorious.org/ac100/marvin24s-kernel/|marvin24s-kernel]] project on gitorious.org. Except for the case of Ubuntu (?), you will not find compiled kernel packages for the AC100 in the official distribution repositories.

For a complete comparison of kernels for the AC100, along with their status and requirements, check [[kernels|kernels]]. Here's a condensed list of marvin24s-kernel branches:

* 2.6.37
    * ()
  * 3.0.27
    * [[https://gitorious.org/ac100/marvin24s-kernel/source/939a863dcaae0d5941ccc9643d21342bcfcc0356:|Branch chromeos-ac100-3.0-exp]]
  * 3.1.x 
    * [[https://gitorious.org/ac100/marvin24s-kernel/source/66a8ee5599effdbbb364b38d48c3f6e3b7bf7a68:|Branch l4t-r16-r2-ac100]]
  * 3.8.x
    * ()
  * 3.10.x
    * [[https://gitorious.org/ac100/marvin24s-kernel/source/945588153f6a2d3638411a2a7373a4068855793e:|Branch linux-ac100-3.10]]
  * 3.12.x
    * ()

===== Bootloader and partition table =====

The stock bootloader (Fastboot) works only with the proprietary partition scheme (tegrapart) present on a stock AC100.

If your plan is to install Linux to the internal eMMC, please keep in mind that kernel support for tegrapart varies (see [[kernels|kernels]]). Generally, kernel versions > 3.1 do not have tegrapart support. At this point you need to decide whether to keep using tegrapart or to switch over ("upgrade") to a standard GPT partition scheme, which works with all kernels.

==== Keeping tegrapart ====

If you are fine with keeping tegrapart / Fastboot (you don't plan to run kernels > 3.1.x and/or you'll run Linux from external media), you can skip ahead to section [[Install#Section:next]]

==== Switching to GPT ====

If you decide to use GPT, there's a tiny bit more work to be done.

While it may be theoretically possible to keep both partition schemes in parallel, you should assume that GPT replaces tegrapart on your eMMC. This means that you will need to change the bootloader as well. Instead of Fastboot, we will use Das U-boot ([[uboot|uboot]]) / the universal bootloader.

Conversion to GPT/uboot is done in one easy step, by running a script preinstalled on the [[sosboot|sosboot]] ramdisk.

=== Step 1 ===

Connect your AC100 to your secondary computer with the USB cable.

=== Step 2 ===

Start your AC100 into [[faq:what_is_recovery_mode|recovery mode]] by holding CTRL+ESC and pressing the Power button. The screen should stay black at this point.

=== Step 3 ===

Transfer the sosboot ramdisk as a bootloader with [[nvflash|nvflash]]:

<code>
helper # nvflash --bl /path/to/sosboot.img --sync
</code>

=== Step 4 ===

You are now in an sosboot environment running from RAM on your ac100. To convert your partition table to GPT and install uboot, execute the script (./switch-to-uboot):

<code>
sosboot # ./switch-to-uboot
</code>

and follow the on-screen instructions.

=== Step 5 ===

Switch off your AC100.

===== Installing the new system =====

Installation consists of deploying these parts:

* A base rootfs - Transfer to the target root partition
  * A Kernel image + initramfs - Transfer to the target boot partition
  * Modules corresponding to the kernel (if not already included in the rootfs!) 
  * Firmware (if not already included in the rootfs!)
    
    
Modules and firmware should reside in /usr/lib/modules and /usr/lib/firmware respectively on the rootfs.

==== Base rootfs ====

For the specific rootfs to use, please refer to the documentation of your distribution of choice. (E.g for Arch Linux ARM the recommended base is the Trimslice archive, and for Ubuntu you should use the lubuntu 12.10 armv7h rootfs image.)

=== Step 1 ===

Download your rootfs (image or archive) to an ext2/vFAT formatted USB drive or SD card.

=== Step 2 ===

Start sosboot (see steps 1 to 3 of section [[here#section:GPT|Switch to GPT]]).

=== Step 3 ===

Insert the USB drive / SD card and mount the medium:

<code>
sosboot # mkdir /medium
</code>
<code>
sosboot # export MEDIUM="/dev/mmcblk1p1"
</code>
for SD card, OR
<code>
sosboot # export MEDIUM="/dev/sda1"
</code>
for USB drive. Then mount the medium:
<code>
sosboot # mount $MEDIUM /medium
</code>

=== Step 4 ===

Create a new filesystem on the target root partition. If unsure, use ext4: TODO: This probably isn't possible.
<code>
sosboot # mkfs.ext4 $TARGET TODO: This probably isn't possible.
</code>
There are different choices of $TARGET depending on your setup:

== Fastboot case ==

- Use the largest partition of the internal eMMC (usually /dev/mmcblk0p7):<code>
sosboot # export TARGET="/dev/mmcblk0p7"
sosboot # mkfs.ext4 $TARGET TODO: This isn't possible.
  </code>
  - Use an SD card\\
(Instructions missing) TODO: Add this
  - Use a USB drive
  (Instructions missing) TODO: Add this
  - ...

== Uboot case ==

* Use the largest partition of the internal eMMC (usually /dev/mmcblk0p7):<code>
  sosboot # export TARGET="/dev/mmcblk0p7"
  sosboot # mkfs.ext4 $TARGET TODO: This probably isn't possible.
  </code>
  * ...
=== Step 5 ===

For a rootfs package in the form of an archive (e.g. ALARM Trimslice), mount $TARGET and extract the files to its filesystem:

<code>
sosboot # mkdir /target
sosboot # mount $TARGET /target
sosboot # tar xvf /medium/rootfs.tar.gz -C /target
</code>

For a rootfs package in the form of an image, just flash this image to $TARGET:

<code>
sosboot # dd if=/mnt/rootfs.img of=$TARGET bs=1M
</code>

=== Step 6 ===

Unmount the medium:
<code>
sosboot # umount /dev/medium
</code>

==== Kernel image, modules and firmware ====

For the minimum amount of work, it is recommended to start by using precompiled kernel images (see [[kernels|kernels]]), modules and firmware.

Once you're in your new system, you may compile a different kernel - natively - on your AC100 and deploy this in place of the precompiled one.

You may also compile or cross-compile a kernel from sources (see kernels#compile|kernels:compilation) and use that one instead.

=== Fastboot ===

If you opted to keep the Fastboot bootloader; the kernel, initramfs and kernel parameters need to take the form of a unified Android boot image, which is flashed to either partition 1 ("SOS") or partition 2 ("LNX") of the internal eMMC. TODO: This may not be true at all

== Step 1 ==

Download a boot image to your USB drive or SD card. (E.g. lubuntu-12.10-preinstalled-desktop-armhf+ac100.bootimg for Ubuntu 12.10.)

(If you have a kernel zImage and initramfs, you may create your own Fastboot compatible Android boot image with the '[[abootimg|abootimg]]' utility.)

== Step 2 ==

In sosboot, mount the medium:
<code>
sosboot # mount $MEDIUM /medium
</code>

== Step 3 ==

Flash the kernel image to the kernel partition:
<code>
sosboot # dd if=/medium/kernel.boot.image of=/dev/mmcblk0p2
</code>
if you want the kernel on the "LNX" partition, or
<code>
sosboot # dd if=/medium/kernel.boot.image of=/dev/mmcblk0p1
</code>
if you want the kernel on the "SOS" partition.

=== Uboot ===

If you installed Uboot, the kernel and initramfs images are loaded directly from an ext2/ext3/ext4 partition anywhere on the internal eMMC, an SD card or a USB device, or via a network connection.

== Step 1 ==

Find a [[kernels|kernel]]! You should be looking for

# A kernel image (zImage)
  # An initramfs (initramfs.img)
  # Kernel modules

If you have an Android boot image, you can extract a zImage and initramfs.img from that with
abootimg -x <bootimage>.

== Step 2 ==

Create a filesystem on the first partition of the internal eMMC, your USB drive or your SD card. If unsure, use an ext2 filesystem on "SOS" partition, i.e. replace <boot> with /dev/mmcblk0p1.

<code>
sosboot # mkfs.ext2 <boot>
</code>
Mount the ext2 partition and create a /boot directory there:
<code>
sos # mount <boot> /mnt
sos # mkdir /mnt/boot
</code>

== Step 3 ==

Transfer the kernel (you may use the same filesystem):

<code>
sosboot # cp /path/to/zImage /mnt/boot/zImage
sosboot # cp /path/to/initramfs /mnt/boot/initramfs
</code>

== Step 4 ==

Create a bootscript source file /mnt/boot/boot.cmd of the following form:

<code>
echo === <Insert some message here> ===
<device type> dev <device no>
setenv bootargs '<your kernel command line>'
ext2load <device type> <device no>:<partition no> <address 1> </path/to/zImage>
ext2load <device type> <device no>:<partition no> <address 2> </path/to/initramfs>
bootz <address 1> <address 2>
</code>

Example for ext4 rootfs on eMMC partition 7, and kernel files on partition 1:

<code>
echo === boot.scr: Loading your kernel from eMMC partition 1 ===
mmc dev 0
setenv bootargs 'quiet root=/dev/mmcblk0p7 rootfstype=ext4 mem=512M@0M vmalloc=320M'
ext2load mmc 0:1 0x1000000 /boot/zImage
ext2load mmc 0:1 0x2200000 /boot/initramfs
bootz 0x1000000 0x2200000
</code>

== Step 5 ==

Compile the boot script:
<code>
sosboot # cd /mnt/boot
sosboot # mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "ubootscript" -d boot.cmd boot.scr
</code>

== Step 6 ==

Finally check that the following files exist and are accessible to uboot:

# zImage [on an ext filesystem on eMMC, SD or USB drive]
  # initramfs [on an ext filesystem on eMMC, SD or USB drive]]
  # boot.scr [In /boot of an ext filesystem on the 1:st partition of eMMC/SD/USB
  
Then cd /, umount /mnt and switch off your AC100.

===== Booting your new Linux system / troubleshooting =====

Press the power button.

The boot process will look a bit different depending on your bootloader:

==== Fastboot ====

With Fastboot you have the choice to boot from "LNX" partition or "SOS" partition.

If you installed the boot image to "LNX", just wait for the kernel to load.

If you installed the boot image to "SOS", hold <HOME> button after power on. Then wait for the kernel to load.

==== Uboot ====

(Note: boot.scr may not be needed anymore. TODO: Please correct.)

'uboot' will look for a boot script (/boot/boot.scr) on the 1:st partition of each device known to it, until it finds one or runs out of devices to search.

If the boot script fails to execute, you should be presented with a uboot shell. You may use this to manually set the kernel parameters, load the kernel and boot. This procedure is illustrated with an example: Load a kernel located on an ext4 filesystem on the "SOS" partition and boot into a rootfs on eMMC partition 7.

Uboot PAZ00 # setenv bootargs "quiet root=/dev/mmcblk0p7 rootfstype=ext4 mem=512M@0M vmalloc=320M
Uboot PAZ00 # ext2load mmc 0:1 0x1000000 /boot/zImage
Uboot PAZ00 # ext2load mmc 0:1 0x2000000 /boot/initramfs
Uboot PAZ00 # bootz 0x1000000 0x2000000

===== Problems =====

Problems that can't be helped / corrected in the guide.
E.g.
  * "I gave away my AC100" A: Don't.
  * "I forgot to create backups" A: Don't.
  * "My AC100 doesn't hover with this kernel" A: That's a known bug
etc.

/END OF GUIDE

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International