Funtoo now provides [http://ftp.osuosl.org/pub/funtoo/funtoo-current/arm-32bit/ stage3 images] for arm platform. At this time are only armv6j_hardfp and armv7a_hardfp stages available. If you would like us to support other processors (see the list below), please fill a bug report on [http://bugs.funtoo.org].

+

Funtoo now provides [http://ftp.osuosl.org/pub/funtoo/funtoo-current/arm-32bit/ stage3 images] for arm platform. At this time armv5te, armv6j_hardfp and armv7a_hardfp stages available. If you would like us to support other processors (see the list below), please fill a bug report on [http://bugs.funtoo.org].

Line 64:

Line 64:

Edit the <tt>/mnt/SD_root/etc/fstab</tt> file to look like this:

Edit the <tt>/mnt/SD_root/etc/fstab</tt> file to look like this:

−

{{File

+

<pre>

−

|/mnt/SD_root/etc/fstab|<pre>

+

/dev/mmcblk0p1 /boot vfat noauto,noatime 1 2

/dev/mmcblk0p1 /boot vfat noauto,noatime 1 2

/dev/mmcblk0p2 / ext4 noatime 0 1

/dev/mmcblk0p2 / ext4 noatime 0 1

−

</pre>}}

+

</pre>

Adjust the partition devices and types to suit your needs.

Adjust the partition devices and types to suit your needs.

Line 86:

Line 85:

Modify the line beginning by "root" to match the following:

Modify the line beginning by "root" to match the following:

−

{{File

+

<pre>

−

|/mnt/SD_root/etc/shadow|<pre>

+

root::10770:0:::::

root::10770:0:::::

</pre>

</pre>

Line 108:

Line 106:

</console>

</console>

−

{{File

+

<pre>

−

|/mnt/SD_root/etc/shadow|<pre>

+

root:YOUR_PASSWORD_MD5:14698:0:::::

root:YOUR_PASSWORD_MD5:14698:0:::::

−

</pre>}}

+

</pre>

==== Setup hostname and networking ====

==== Setup hostname and networking ====

Line 161:

Line 158:

</console>

</console>

−

(For example for Pandaboard: )

+

Example for Pandaboard:

−

+

<pre>

−

{{File

+

−

|/etc/SD_root/etc/inittab|<pre>

+

s0:12345:respawn:/sbin/agetty 115200 ttyO2 vt100

s0:12345:respawn:/sbin/agetty 115200 ttyO2 vt100

−

</pre>}}

+

</pre>

=== Finishing the installation and booting up the new system ===

=== Finishing the installation and booting up the new system ===

Line 174:

Line 169:

</console>

</console>

−

Once you have the card ready, put it into your device, and you should be able to boot it. If you have a debug port you will be able to see the boot process using minicom or similar program on another PC connected with the debug cable.

+

=== Troubleshooting ===

+

With the armv5te at least, these instructions work great. However, when it is time to update sys-devel/gcc this underpowered wimp has trouble, mainly due to limited memory I think. Cross-compiling toolchains made by crossdev work well within limits, it won't do gcc. However I have found a trick that works well and solves this, thanks to the timely posting of new stage3's by Funtoo.<br />

+

Simply make a chroot using qemu-user files as described here: http://wiki.gentoo.org/wiki/Cross_Container_Support_Project

+

Enter the chroot and tweak your /etc/portage/make.conf to point to the directory you wish to save packages to (PACKAGEDIR) and any other necessary tweaks in there.<br />

+

Since this latest stage3 will have the latest gcc installed in it, simply enter:

+

<console>

+

# ##i##quickpkg sys-devel/gcc

+

</console>

+

It will build the binary package, which then installs on my Dockstar quickly & easily in comparison to compiling 48 hours and then failing.<br />

+

As an added bonus you now have a nifty arm chroot you may find handy for other tasks.

+

[[Category:HOWTO]]

[[Category:HOWTO]]

[[Category:ARM]]

[[Category:ARM]]

Revision as of 23:45, February 28, 2014

Funtoo now provides stage3 images for arm platform. At this time armv5te, armv6j_hardfp and armv7a_hardfp stages available. If you would like us to support other processors (see the list below), please fill a bug report on [1].

List of ARM processor "flavors"

armv4l-unknown-linux-gnu (Rebel NetWinder, HP Armada and other devices having an ARMv4 processor, which is only capable of running the old ABI. Nevertheless it should work on newer CPUs)

armv4tl-softfloat-linux-gnueabi (OpenMoko FreeRunner and other devices using an ARMv4T processor. Uses the new ARM EABI and software floating point by default)

armv6j-unknown-linux-gnueabi (Raspberry Pi, Nokia N800/N810, Smart Q7, OMAP2-based devices and other multimedia devices using an ARMv6 CPU and VFP. Uses the new ARM EABI and hardware floating point by default)

Default installation of Funtoo on your platform/board

This document is not a complete installation tutorial. Basic information about Funtoo Linux installation can be found on Funtoo Linux Installation. The goal of this document is to provide general information about installing Funtoo Linux on an ARM device, and highlight differences with a x86 installation.

The following notes are non-board specific. Other instructions can be found in the specific articles for the above mentioned devices.

Overview

Most of the ARM boards come with a SD card slot, so you will need an empty SD card (4GB is enough to get you started), in most cases the boards are also equipped with debug port which can be used with USB-to-serial cables, if you have one, you can use it to login to the machine without the need of connecting keyboards or displays. You will need a network connection to be able to download stages, kernel and update your portage tree.

Kernel and bootloader setup

Before you start you will need a kernel and a bootloader for your device. Some of the devices look for bootloader (in most cases U-Boot) on the SD along with the kernel.

More information about the kernel and bootloader can be found on pages specific for your device.

Installing Funtoo (overview)

The installation on these devices differs from the normal installation procedure of booting an installation environment and chrooting from there to your new root, and can be little bit easier, but in some cases tricky.

Overview of the installation:

Extract stage3 to the 2nd partition of the SD card

Extract portage snapshot

Setup fstab

Setup root password

Configure hostname and networking (optional, but recommended)

Enable SSH access (optional, but recommended)

Enable serial console access (optional, but recommended)

Correct RTC "bug" with swclock

Installing the Stage 3 tarball

ARM stage3 tarballs can be found on [2]. Use the subarchitecture that suits best your device.

Mount the partition that will hold your rootfs of the SD card and extract the stage3 you have downloaded.

# mkdir /mnt/SD_root
# mount /dev/sdcard-device-px /mnt/SD_root

Extract the stage3 (it may take a while).

# tar xapf stage3-armv7a_hardfp-xxxx.tar.xz -C /mnt/SD_root

Extracting a portage snapshot

Now, download the portage snapshot from [3], and extract it to your partition.

Setup fstab

Setting the default root password

Warning

Don't skip this step. This part differs from the standard installation procedure, as the root password must be set outside of a chroot environment. Skipping this step will result in an impossibility to login.

Normally, for setting the password, one has to be able to run passwd. However that's not possible in this case since an x86 system can't run ARM binaries. Therefore, it is needed to modify the file that contains the passwords (/etc/shadow) to set a default root password.

Clearing the root password

This will allow to login with a blank password for the root user.

# nano -w /mnt/SD_root/etc/shadow

Modify the line beginning by "root" to match the following:

root::10770:0:::::

Warning

After initial login, remember to change the root password using the passwd command.

Choosing a root password (alternative)

First, generate a password. The output of this command will be used to modify the shadow file.

Setup hostname and networking

Using swclock

One of the problems some of the devices have, is that they don't have a battery to save the clock time. To mitigate this, on Funtoo we have an option in our init system called swclock which sets the date of the system upon boot from a last modified date of a file.

First, add swclock to the boot runlevel.

# ln -sf /etc/init.d/swclock /mnt/SD_root/etc/runlevels/boot

Then, remove hwclock from the startup because it sets the date from the RTC, which is 2000-01-01 upon startup and overrides swclock's date.

# rm /mnt/SD_root/etc/runlevels/boot/hwclock

swclock uses the /lib/rc/cache/shutdowntime modification time to set the date, therefore we update it to have the current date and time.

# touch /mnt/SD_root/lib/rc/cache/shutdowntime

Although this doesn't fix the issue, at least helps to set a sane date and time.
Note: Consider using NTP, documented on the next chapter

Enabling SSH access (optional)

Adding sshd to the default runlevel will enable access to the device using ssh (if network has been configured).

# ln -sf /etc/init.d/sshd /mnt/SD_root/etc/runlevels/default

If no network has been configured yet, it might be a good idea to add dhcpcd in the default runlevel as well.

# ln -sf /etc/init.d/dhcpcd /mnt/SD_root/etc/runlevels/default

Enabling serial console access (optional)

By default the ttyS0 port is configured at 9600 bps. However, almost all of the ARM devices run the serial port at 115200 bps. Also, the port device names differ (ttyO2 for Pandaboard, ttySAC1 for Odroid-X ...). So edit your /etc/inittab file:

# nano -w /mnt/SD_root/etc/inittab

Example for Pandaboard:

s0:12345:respawn:/sbin/agetty 115200 ttyO2 vt100

Finishing the installation and booting up the new system

Let's unmount the SD card.

# umount /mnt/SD_root

Troubleshooting

With the armv5te at least, these instructions work great. However, when it is time to update sys-devel/gcc this underpowered wimp has trouble, mainly due to limited memory I think. Cross-compiling toolchains made by crossdev work well within limits, it won't do gcc. However I have found a trick that works well and solves this, thanks to the timely posting of new stage3's by Funtoo.
Simply make a chroot using qemu-user files as described here: http://wiki.gentoo.org/wiki/Cross_Container_Support_Project
Enter the chroot and tweak your /etc/portage/make.conf to point to the directory you wish to save packages to (PACKAGEDIR) and any other necessary tweaks in there.
Since this latest stage3 will have the latest gcc installed in it, simply enter:

# quickpkg sys-devel/gcc

It will build the binary package, which then installs on my Dockstar quickly & easily in comparison to compiling 48 hours and then failing.
As an added bonus you now have a nifty arm chroot you may find handy for other tasks.