What is Debian/NSLU2?
Debian/NSLU2 is the name given to the official Debian distribution for ARM that runs on the NSLU2, thanks to the efforts of the nslu2-linux developers to get the necessary kernel patches and utilities accepted upstream by the kernel maintainers and by the Debian Project.
The goal is to add full support for the NSLU2 and similar devices into the official Linux kernel and the Debian GNU/Linux distribution, so users can benefit from the full Debian package repository and also have slug-specific packages and patches for hardware devices such as the built-in Ethernet port, LEDs, etc.
( And it really run fine on my Slug after a long, long installation ! )
Standard caveats about backup apply. Per Martin Michlmayr, you can safely ignore this message:
Hmm. The package shipped with a symbolic link /lib/modules/2.6.18-6-ixp4xx/source However, I can not read the target: No such file or directory Therefore, I am deleting /lib/modules/2.6.18-6-ixp4xx/source
State of the project
Debian fully supports the NSLU2 using the Debian Installer (this is the setup known as Debian/NSLU2). Please visit http://www.cyrius.com/debian/nslu2/ for the recommended way to install Debian on a NSLU2.
Please note that a lot of information on this wiki is out of date. Refer to http://www.cyrius.com/debian/nslu2/ for up-to-date information about Debian on the NSLU2.
You may still use debian installer. After connecting to the installer via SSH do the following:
Solution from Rainer Hlawaty.
Instructions to set up Debian/NSLU2 are available at Debian on NSLU2, using the latest Debian Lenny release (5.0.4). There is also a manual method described at http://www.cyrius.com/debian/nslu2/unpack.html, but everything should work using the automatic install.
If your device (i.e. an IXP4xx device other than the NSLU2) is not supported by the Debian Installer, then you can use the Bootstrap procedure instead.
Another option is to create and format the ext3 partition on a normal PC as described in the FAQ.
Upgrade from previous versions
Upgrade from debian-installer beta2
If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.
Upgrade from manual bootstrap to testing ("etch")
If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is
do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes
Ethernet driver issue: If your
auto eth0 iface eth0 inet static pre-up modprobe -f ixp400 pre-up modprobe -f ixp400_eth address 10.0.0.201 netmask 255.255.255.0 gateway 10.0.0.138
If this is the case try this:
allow-hotplug eth0 iface eth0 inet static address 10.0.0.201 netmask 255.255.255.0 gateway 10.0.0.138
After that, follow the guide to Upgrading Debian on the Linksys NSLU2. When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.
Obtaining the NPE-B microcode
The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the Wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.
Download the debian-installer image from slug-firmware.net and unpack the image using
(For Ubuntu users, fiesty is not up to date as of 09/09/07 and slugimage should be downloaded from the debian unstable repository and installed using dpkg. Frank: Ubuntu users can extend the software source for the installation to gutsy and will have the recent version
sudo gedit /etc/apt/sources.list
add an additional line with
deb http://at.archive.ubuntu.com/ubuntu/ gutsy universe
update your package list and install the newest version. remove the line afterwards again.).
apt-get install slugimage slugimage -u -i di-nslu2.bin # di-nslu2.bin is the debian-installer
Endian swap the initramfs (
apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz
Unpack the initramfs into a directory e.g.
mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i
The NPE microcode firmware will be in the
[s]cp NPE-B.01000201 [user@hostname:][/mnt]/lib/firmware/ [ssh user@hostname] cd [/mnt]/lib/firmware; sudo ln -s NPE-B.01000201 NPE-B
Upgrade from manual bootstrap to unstable ("sid")
If you have previously bootstrapped your NSLU2 to Debian unstable ("sid"), you will have to adjust your
deb http://ftp.XX.debian.org/debian testing main non-free contrib
Now follow the same steps mentioned above for etch: create the
apt-get -t testing install linux-image-2.6-ixp4xx
Links to more Debian/NSLU2 documentation
The Debian/NSLU2 FAQ.
To learn how to build a Debian/NSLU2 image, see BuildImage.
See ChangeKernelCommandLine for how to change the command line passed to the kernel by the second-stage bootloader, APEX, in a Debian/NSLU2 system.
If you want to free up some space in your internal flash, see NoInitramfs.
To use the Debian Installer with a FatSlug, follow the instructions here.
To use a Hauppauge WinTV PVR USB2, see InstallWinTVPVRUSB2
For information on installing rtorrent, go here InstallRtorrentOnDebian
Section moved to the Debian/NSLU2 Troubleshooting page.
The Debian build-essential package should install without problems, however if you try to compile more than a few dozen lines you might see problems that don't appear to make sense. The first thing to check is that you have enough memory: on a system with 32Mb physical RAM Debian might only install another 90Mb swapspace.
I believe that in order to fix this you will have to reinstall, deleting/recreating partitions to get sensible sizes. Based on the fact that I've seen building the Lazarus GUI taking 200Mb I suggest 256Mb swap as a minimum, 512Mb is probably adequate.
The old solution to run Debian packages in the NSLU2 is SlugOS/LE, previously known as DebianSlug. This solution uses the SlugOS kernel in little-endian mode, in a way that is compatible with the Debian arm distribution. This setup requires a manual bootstrap procedure and is no longer the recommended solution to run Debian in the slug.
Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.
I have added some guidelines in french to install Debian on the Slug, with an associated support forum. Everything is located here and in the forum section of the site.
view · edit · print · history · Last edited by Kees Moerman.
Based on work by tbm, Maisondouf, rwhitby, vtetri, Vernicht, Ruiqiang Huang, Frank Banzhoff, gencier, fcarolo, dumfrac, blue, cyboreal, marceln, celyade, fabroce, Lars, oo, Chris Salinardi, Christopher Salinardi, joederygmailcom, Zword, emm_is, ptan, Andy O'Neill, vatachino, Stein, age, lesterc, condor2k, Anguel Stankov, Phil Endecott, Dean Jackson, mururoa, hs, JLM, Reedy Boy, Tim Froidcoeur, dunfrac, TBBle, Ahmad Khayyat, and molli123.
Originally by rwhitby.
Page last modified on May 10, 2010, at 11:28 AM