PowerPC Installation-Document -- APUS (Amiga PowerUp System)
  Sven LUTHER, luther@debian.org
  v1.0, 24 february 2000

  This document describes the installation of Debian GNU/Linux on Pow-
  erPC Systems
  ______________________________________________________________________

  Table of Contents


  1. Installing Debian GNU/Linux on a PowerPC APUS machine
     1.1 Intro
     1.2 Known problems
     1.3 Partitioning from the AmigaOS side
     1.4 Bootstrap
        1.4.1 The debian bootstrap command
     1.5 Kernel Options
        1.5.1 Graphic card options
        1.5.2 The nobats option
        1.5.3 The 60nsram option
        1.5.4 Debugging options
     1.6 Apus particularities in dbootstrap
        1.6.1 Partitioning the harddisk - amiga-fdisk
        1.6.2 Installing the OS kernel & modules
        1.6.3 Option that are not working for apus

  2. Links on where to find information not included in this guide
  3. Conslusion


  ______________________________________________________________________

  11..  IInnssttaalllliinngg DDeebbiiaann GGNNUU//LLiinnuuxx oonn aa PPoowweerrPPCC AAPPUUSS mmaacchhiinnee



  11..11..  IInnttrroo


  Apus is the "Amiga PowerUp System", and consist of an amiga computer,
  A1200, A3000 or A4000, together with one of the PowerPC/m68k
  accelerator boards from the now dead company Phase5, The BlizzardPPC
  or CyberStormPPC board.


  11..22..  KKnnoowwnn pprroobblleemmss


  Well, there are some issues involved with bootstrap on some system
  using not powerup or warpup only, but some hybrid mutant of them both.
  I am not very familiar with this stuff as i use plain powerup only, so
  i hope someone will contribute a more complete description of it.

  Also the scsi controler of the CyberStormPPC is not yet supported by
  linux, so you cannot use disks attached to it.


  11..33..  PPaarrttiittiioonniinngg ffrroomm tthhee AAmmiiggaaOOSS ssiiddee


  amiga-fdisk is the fdisk variant for RDB partition tables used by the
  amiga hardware. It is working, but it is recommended to use some amiga
  partitioning tools to do it on the amigaos side.


  Hdtoolbox, being the official commodore partitionning tool, should be
  installed on every AmigaOS system. Just launching hdtoolbox should
  partition the ide disk of the onboard ide interface. If you want to
  access the scsi disk on your blizzardppc board scsi controler, you
  should use the "hdtoolbox blizzppcscsi.device" command.

  Another option is to use SCSIConfig, the partitioner from Phase5 which
  is on the floppies that came with your accelerator board.

  You will need to set the partition type to custom, and provide the
  following partition type ids :

  * linux partition : 0x4c4e5800 * linus swap partition : 0x53575000


  11..44..  BBoooottssttrraapp


  You will find the bootstrap program in the apus/bootstrap directory of
  the powerpc boot floppies distribution (found at :
  /debian/dists/potato/main/disks-powerpc/current).

  The bootstrap program consists, for now, of three programs, all three
  need to be executable and in your amigaos path. They are the bootstrap
  executable and the ppcboot_wup and ppcboot_pup part, that are the
  actual launcher (ppcboot_pup for the powerup system and ppcboot_wup
  for the warpup system).

  You will launch bootstrap with a line like this :

  * bootstrap --apus "kernel options"

  where "kernel options" are defined in the following sections.

  bootstrap will then give some output, then blank the screen for 10 to
  30 seconds, and then you will have the linux console.


  11..44..11..  TThhee ddeebbiiaann bboooottssttrraapp ccoommmmaanndd


  In the debian case, the actual bootstrap command will be for the root
  disk launch :

  * bootstrap --apus -k apus/linux -r apus/images-1.44/root.bin
  root=/dev/ram

  and for the installed debian launch :

  * bootstrap --apus -k apus/linux root=/dev/sda3

  where sda3 is where i have my debian root partition, change it by the
  partiton that is hosting your root partition.

  Naturally, you will need to add some kernel option depending on your
  actual configuration, which will be explained in the following
  sections.


  11..55..  KKeerrnneell OOppttiioonnss



  11..55..11..  GGrraapphhiicc ccaarrdd ooppttiioonnss


  The graphic device to be used uses option prefaced with video=.

  They are of two kinds, the actual definition of a graphic driver :

  * video=amifb:vga

  for enabling the native graphic in vga mode (640x480)

  * video=pm2fb:mode:1152x864-60,font:SUN12x22

  for enabling the Bvision/CyberVision graphic card in 1152x864 at 60Hz
  mode, with the SUN12x22 fonts.

  or also to disable one of the graphic device :

  * video=amifb:disable

  And for the mapping of virtual consoles to the different devices being
  used :

  * video=map:01

  will map virtual console (vc) 1 to device 0, vc 2 to device 1, and
  after that repeat the same pattern (vc3 to device 0, vc4 to device 1,
  ...).

  * video=map:0001

  will map vc 1,2,3,5,6,7 to device 0 and vc 4,8 to device 1


  11..55..22..  TThhee nnoobbaattss ooppttiioonn


  Blizzard users with scsi disks will need to use the "nobats" option.

  * bootstrap --apus -k apus/linux root=/dev/sda3 nobats


  11..55..33..  TThhee 6600nnssrraamm ooppttiioonn


  People with 60ns ram can also use the 60nsram option.

  * bootstrap --apus -k apus/linux root=/dev/sda3 60nsram


  11..55..44..  DDeebbuuggggiinngg ooppttiioonnss


  if you are experienting problems, you can use the debug option to
  specify console message output to a serial console or memory instaed
  of the console.  this is usefull for debuging when the kernel don't
  comes to the console output.

  * bootstrap --apus -k apus/linux root=/dev/sda3 60nsram debug=mem

  Then you can read the result with the bootmesg utility from the
  apus/bootstrap directoty.

  Another useful tool is the dmesg utility which will give you the
  bootstap process debugging info.

  11..66..  AAppuuss ppaarrttiiccuullaarriittiieess iinn ddbboooottssttrraapp


  There are some specific things to apus in the dbootstrap stuff.


  11..66..11..  PPaarrttiittiioonniinngg tthhee hhaarrddddiisskk -- aammiiggaa--ffddiisskk


  The apus subarch uses the amiga-fdisk partitioning tool. Like said
  above, you can also use AmigaOS-side partitioning tools.


  11..66..22..  IInnssttaalllliinngg tthhee OOSS kkeerrnneell && mmoodduulleess


  This option is actually not working. I am in the process of proposing
  a "Install the OS modules" option to replace it, but in the meantime
  you can use the following alternative :

  * don't install the kernel & modules.

  The kernel is not needed anyway, since it resides on the


  11..66..33..  OOppttiioonn tthhaatt aarree nnoott wwoorrkkiinngg ffoorr aappuuss


  Well some options simply don't make sense on apus, so until i exclude
  them from the menu, just ignore them. They should not work anyway.

  These options are :

  * make lilo bootable directly from the harddisk.

  * make a boot floppy.

  * eject the floppy.


  22..  LLiinnkkss oonn wwhheerree ttoo ffiinndd iinnffoorrmmaattiioonn nnoott iinncclluuddeedd iinn tthhiiss gguuiiddee


  The official linux doc & faq was at :

  ftp://sunsite.auc.dk/pub/os/linux/apus/faq/faq.html

  but is in the process of being moved to linux-apus.sourceforge.org :

  http://linux-apus.sourceforge.org

  You will find there further information, right now, it is a bit out of
  date where bootstrap and some other stuff is concerned.  It will most
  assuredly be updated during the move to sourceforge.

  The other source of valuable information is the linux-m68k web site
  and faq found at :

  ... add here the linux-m68k site ...

  You will find there lot of information regarding linux on the amiga
  plateform that is common to linux-m68k and linux-apus.



  33..  CCoonnsslluussiioonn


  Well, this little guide tries to explain all the particularities of
  the linux-apus installation of debian. The rest of it is quite similar
  to any other debian/powerpc installation, as well as the generic
  debian installation.  You will thus find further info in the debian
  documentation directory as well as in the other generic linux
  information sites and docs.