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