Home | History | Annotate | Line # | Download | only in Docs
      1 $NetBSD: FBInstall,v 1.1 2006/07/23 13:33:53 bjh21 Exp $
      2 
      3 Note of FastBoot/AutoBoot Installation for !BtNetBSD V0.90
      4 based on !BtRiscBSD
      5 
      6 Updated by Reinoud Zandijk 18 Feb 2001
      7 Author: Mark Brinicombe 12th May 1995
      8 Updated: 20th June 1997
      9 
     10 Installation
     11 ------------
     12 
     13 Two patches are required to the standard boot files
     14 
     15 The following lines should be added to the start of
     16 !Boot.Choices.Boot.PreDesktop
     17 
     18 ----------------------- Cut here -----------------------
     19 
     20 |Start NetBSD !Boot FastBoot
     21 Run <Obey$Dir>.^.^.^.BtNetBSD.!BtNetBSD.!Boot
     22 Run <BtNetBSD$Dir>.TestBoot
     23 If "<NetBSD$FastBoot>" = "1" THEN Echo NetBSD FastBoot mode engaged
     24 If "<NetBSD$FastBoot>" = "2" THEN Echo NetBSD ConfBoot mode engaged
     25 If "<NetBSD$FastBoot>" = "3" THEN Echo NetBSD AutoBoot mode engaged
     26 If "<NetBSD$FastBoot>" = "4" THEN Echo NetBSD FastConf mode engaged
     27 |End
     28 
     29 ----------------------- Cut here -----------------------
     30 
     31 These commands should be the first one run in the PreDesktop
     32 file. They boot the boot loader application (primarily to set
     33 BtNetBSD$Dir). The file <BtNetBSD$Dir>.TestBoot is then run
     34 to test for the ALT or CTRL keys are being held down. In addition
     35 it checks several CMOS RAM bits for boot configuration options.
     36 
     37 The following lines should be added to the start of
     38 !Boot.Choices.Boot.Desktop
     39 
     40 ----------------------- Cut here -----------------------
     41 
     42 |Start NetBSD !Boot FastBoot
     43 Iconsprites <BtNetBSD$Dir>.!Sprites22
     44 If <NetBSD$FastBoot> = 4 THEN Run <BtNetBSD$Dir>.!Edit
     45 If <NetBSD$FastBoot> > 0 AND <NetBSD$FastBoot> < 4 THEN Obey <BtNetBSD$Dir>.fastboot
     46 |End
     47 
     48 ----------------------- Cut here -----------------------
     49 
     50 This command should be the first one run in the Desktop file.
     51 It runs the NetBSD Bootloader with the configured parameters.
     52 
     53 
     54 There is a specific reason for not putting all the fastboot code in
     55 one file. The PreDesktop patch is run very early in the boot up so
     56 that the ALT and CTRL keys can be detected quickly. However, currently
     57 the actually bootloader cannot be run at this point unless a lot of
     58 memory is available in the module area (~1Meg) as currently the
     59 module area is used for temporary storage of the kernel being
     60 booted. 
     61 This means that the actual boot is prosponed until the start of
     62 the Desktop file. At this point the desktop has been started and
     63 the task manager is running so it will be possible to allocate
     64 a large amount of module space.
     65 
     66 
     67 Activation
     68 ----------
     69 
     70 Once installed, to engage the fastboot hold ALT down immediately
     71 after a reset. As soon as the "fastboot engaged" message is printed
     72 the ALT key can be released.
     73 To engage the fastconf mode  hold CTRL down immediately
     74 after a reset. As soon as the "fastconf engaged" message is printed
     75 the CTRL key can be released.
     76 
     77 
     78 Configuration
     79 -------------
     80 
     81 Configuration is done via the !BtNetBSD application.
     82 When ever NetBSD is booted the commandline used to boot it is saved
     83 by the bootloader to the file <BtNetBSD$Dir>.FastBoot
     84 Rerunning this file will then boot NetBSD with the last parameters
     85 used. It is this file that the fastboot uses so the fast boot will
     86 boot NetBSD with the same parameters as were used for the last boot.
     87 
     88 
     89 ConfBoot mode
     90 -------------
     91 
     92 This mode is identified by NetBSD$FastBoot being set to 2. This indicates
     93 that the bootloader has been configured to always boot NetBSD. This is
     94 down by setting a bit in the CMOS RAM (via !BtNetBSD).
     95 If NetBSD boots are configured the action of the ALT is reversed so that
     96 holding down ALT will allow a RISC OS boot instead.
     97 
     98 
     99 AutoBoot mode
    100 -------------
    101 
    102 This mode is identified by NetBSD$FastBoot being set to 3. This indicates
    103 that an automatic boot was requested by NetBSD before it rebooted. This
    104 will happen when /sbin/reboot is used instead of /sbin/halt.
    105 
    106 
    107 FastBoot mode
    108 -------------
    109 
    110 This is the behaviour when ALT is held down at boot time and ConfBoot mode
    111 has not been configured. It just bypasses most of the normal startup and
    112 boots NetBSD.
    113 
    114 
    115 FastConf mode
    116 -------------
    117 
    118 This is the behaviour when CTRL is held down at boot time. This is similar to
    119 FastBoot mode except that the !BtNetBSD is provided to allow boot parameters
    120 to be changed.
    121 
    122 
    123 Bugs
    124 ----
    125 
    126 Well hopefully there are no bugs :-)
    127