← Back to branch summary

~ubuntu-core-dev/debian-installer/xenial-proposed

« back to all changes in this revision

Viewing changes to doc/devel/hardware/arm/nslu2/README

  • Committer: Colin Watson
  • Date: 2007-11-28 18:32:20 UTC
  • mfrom: (664.2.2667)
  • Revision ID: cjwatson@canonical.com-20071128183220-ilixcc1n5fw1m2t6
Tags: 20061102ubuntu1
* Resynchronise with Debian. Remaining changes:
  - Ubuntu branding of various kinds.
  - Use Ubuntu kernels. Various tweaks for different udeb splits.
  - Fetch distribution name and version number from lsb_release.
  - Use the full version number in image directories.
  - Build-depend on belocs-locales-bin.
  - Various boot screen text adjustments.
  - Add server boot options.
  - Add memtest boot option.
  - Add live CD boot screens.
  - Adjust memory size recommendations.
  - Document pci=noacpi.
  - Add translatable boot screen text for gfxboot.
  - Use ubuntu-keyring-udeb (and gpgv-udeb) instead of the Debian archive
    keyring.
  - Switch all images to initramfs.
  - Add netboot images suitable for USB memory sticks.
  - Remove floppy support, since it never used to work with 2.6. (This may
    be fixed in the future.)
  - Disable gtk frontend.
  - Add kickseed-common and initrd-kickseed to all images containing
    preseed-common and initrd-preseed.
  - Add nfs-modules to all netboot images except powerpc, for Kickstart.
  - kbd-chooser -> console-setup.
  - Include keymap decision tree in all.utf.
  - Replace cdebconf-newt-entropy with cdebconf-newt-detect-keys in
    EXTRAUDEBS.
  - Add bootchart-udeb to all images.
  - Add grepmap-udeb to all images.
  - Add hdparm-udeb to cdrom images.
  - Add nic-firmware to netboot images.
  - Ship elilo configuration on i386 for Intel-based Macs.
  - Use mkvmlinuz'\''s fallback object files on powerpc rather than relying
    on the kernel'\''s.
  - Remove sparc32.
  - Use ${RAMDISK_SIZE} in sparc'\''s silo.conf rather than a hardcoded size.
  - Add input-modules to the sparc netboot image.
* Set default suite to feisty.
* Fix server option to preseed "tasks=standard" instead of
  "pkgsel/install-pattern=~t^ubuntu-standard$".
* Move to 2.6.19-7 kernels. Handle various module udeb changes:
  ide-core-modules, loop-modules, scsi-core-modules, usb-storage-modules
  -> storage-core-modules; lots of filesystem modules -> fs-core-modules,
  fs-secondary-modules.
* Remove auto-install/ai-choosers targets, at least for now.
* Make nic-firmware optional, since it seems to have gone AWOL (filed
  #73896).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/devel/hardware/arm/nslu2/README
 
1
The Linksys NSLU2 is a small ARM based gadget which has one Ethernet and
 
2
two USB ports.  The idea is to connect an external hard driver through USB
 
3
and use the device as a small server.  It's very popular because you can
 
4
get it for under $100.  There is a large user community at
 
5
http://www.nslu2-linux.org/
 
6
 
 
7
The firmware is based on RedBoot but there is also functionality which
 
8
allows you to put the device into upgrade mode and then upgrade the
 
9
firmware via the network.  There's a utility in Debian called upslug2 which
 
10
can do this.  Even though the NSLU2 is based on RedBoot, there are some
 
11
restrictions we need to work around.  Instead of using the FIS table to
 
12
locate the kernel and initrd, specific values of their locations are
 
13
hard coded.  In practice, this means that there is only 1 MB of space for
 
14
the kernel because the initrd starts 1 MB after the kernel.
 
15
 
 
16
Since we want to use a generic ixp4xx kernel, we've worked around this
 
17
limitation by using a 2nd boot loader, APEX.  We put APEX in flash at the
 
18
point where RedBoot loads the 'kernel' from and then we split the kernel in
 
19
two parts - this is because NSLU2's RedBoot excepts to find a specific
 
20
header at the start of the initrd and the kernel will use this space now.
 
21
Effectively, this means that there is:
 
22
 - A partition for APEX
 
23
 - A partition for the kernel: the kernel is split in two and each parts
 
24
   have a header
 
25
 - A partition for the initrd
 
26
 
 
27
A description of the NSLU2's flash layout can be found at
 
28
http://www.nslu2-linux.org/wiki/Info/BootFlash
 
29
 
 
30
There is also a problem with Ethernet: the ixp4xx chip has built-in
 
31
Ethernet but requires a microcode.  Up until recently, there was only a
 
32
driver from Intel, but now a GPLed driver that is aiming for mainline
 
33
inclusion is available.  It's still not clear how to handle the microcode
 
34
but at the moment unofficial images with it are distribution from
 
35
nslu2-firmware.net
 
36
 
 
37
Apart from this, the NSLU2 is pretty easy to support.
 
38