summaryrefslogtreecommitdiff
path: root/distrib/notes/alpha/prep
blob: e9e936828f143b5da5d3277b1d58d8491a85b532 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
dnl	$OpenBSD: prep,v 1.36 2023/03/16 18:04:07 miod Exp $
OpenBSD/MACHINE requires the SRM console.  Some alphas come with
the AlphaBIOS (also known as the ARC firmware on older machines) instead;
this is what Windows NT uses. It is fairly simple to replace the AlphaBIOS
with the SRM firmware.

Switching your MACHINE to SRM console:

    AlphaServer class machines (except for models 300 and 400) and recent
    enough machines (such as the Miata and later models) have enough
    flash ROM space to carry both the AlphaBIOS and the SRM console.

    To switch to SRM from AlphaBIOS, do the following:
    - enter the AlphaBIOS setup upon startup
      (F2 key, or Ctrl-B from serial console)
    - choose "CMOS Setup" from the menu
    - select "Advanced CMOS Setup" (F6 key, or Ctrl-F from serial console)
    - change the "Console Selection" setting to "OpenVMS console (SRM)"
    - confirm your changes with F10 (or Ctrl-U) twice, then enter.
    - power-cycle your system for the changes to take effect.

    If you didn't find a "Console Selection" entry (for example on 164SX or
    164LX), your system can not hold both the AlphaBIOS and SRM console in
    flash, and you will have to upgrade your firmware.

    You can get replacement firmware either from a firmware update CD-ROM,
    which can be downloaded from
        https://archive.org/details/alphafwupcds

    Note that, on most models, upgrading the firmware requires a jumper
    to be moved on the motherboards; refer to the firmware update
    instructions for details.

AXPpci33 Motherboard specific notes:

    The 1994 version of the OEM guide has an incorrect pinout for the
    serial ports.  The newer version used to be available at
	ftp://ftp.digital.com/pub/Digital/axppci/design_guide.ps.Z 
    with a corrected pinout (as well as more information than the 1994
    edition). Although ftp.digital.com does not exist anymore, a few
    copies of this document are scattered across various ftp servers
    on the globe, such as
        https://manx-docs.org/collections/antonio/dec/MDS-2000-01/cd1/ALPHA/AXPCIDGC.PDF
    
    Note that there are two flavors of PC serial connectors.  If you
    have the wrong kind, you won't get any output from the serial console.

Using the SRM console:

    This is not intended to be an exhaustive guide on using the
    SRM firmware console.  It should, however, give you enough
    information to boot OpenBSD/MACHINE.

    To see a list of devices connected to your alpha, you can
    use the "show device" command.  For booting, the devices you
    are interested in are "dka*" (the disk drives).

    You can set ROM variables by saying "set VARIABLE VALUE".
    Some variables you will want to set:

	auto_action
		Determines what happens when you turn the power on,
		halt, or restart your machine.  Valid values are:

		"halt"
			the system will not autoboot, will restart when
			rebooted (shutdown -r), and will not restart
			when halted (shutdown -h).
		"boot"
			the system will autoboot on powerup, and when the
			system is halted (shutdown -h) or rebooted
			(shutdown -r).
		"restart"
			the system will autoboot on powerup, will restart
			when rebooted (shutdown -r), and will not restart
			when halted (shutdown -h).

		Most users will want to set this to "restart".

	bootdef_dev
		Default boot device (or list of devices).

	boot_file
		Name of the kernel to boot.  If this variable is empty,
		the default "bsd" will be loaded.  Note that this variable
		does not exist in all versions of the SRM console.

    To see a list of all variables on your machine, use the "show"
    command with no arguments.  If there are too many of them, you
    might want to page with "show | more".

    You can bypass the boot_file value from the command prompt, with the
    -fi option. For example,

	boot -fi bsd.rd dka0

    will boot the "bsd.rd" kernel on dka0.  However, some versions of the
    SRM console (mainly on DEC 3000 series) will only let you specify
    uppercase filenames. It is preferred to boot without any particular
    option, and enter the correct filename at the boot loader "boot>"
    prompt.

USB support on the XP1000:

    For some unknown reason, the USB interface found on the XP1000
    (and possibly the XP900 and the XP1100) is not enabled unless a
    specific SRM environment variable is set.

    If you plan to use USB devices on these machines, enter
	set usb_enable on
    at the SRM prompt, followed by
	init
    before attempting to install OpenBSD.

EISA configuration:

    A few MACHINE systems support EISA devices. However, the SRM firmware
    has only a very limited knowledge of EISA devices and is not able to
    configure them.

    Every time an EISA board is added to or removed from the system, the
    EISA Configuration Utility needs to be run from a floppy disk using the
    ``runecu'' command at the SRM prompt. An ECU floppy disk is supposed to
    be provided with EISA-capable systems; this disk will be updated with
    the current configuration every time it is run, and needs to be
    writeable. ECU disks should not be shared between systems.

    Redistributing ECU is not allowed, however a copy of it can be
    downloaded from:
      https://archive.org/details/digitalecudisk

    Extract this archive to a newly FAT-formatted 3"1/2 floppy disk to get
    a pristine ECU disk.

SRM console boot device restrictions:

    The SRM firmware on your system may or may not be able to boot from
    any disk controller you may install in your MACHINE.
    The built-in disk controllers on your MACHINE will always be supported,
    however on IDE-based machines, such as the EB164, 164SX and 164LX, as
    well as the low-end Personal Workstation (non-u models), you can plug
    in a SCSI controller, and boot from it if it is recognized.

    Recent SRM releases for these machines will be able to boot (or netboot)
    from the following controllers:
	QLogic PCI SCSI controllers
	Symbios Logic (NCR) 53C8xx (but not on PC164)
	Adaptec AHA-[23]9[34]x[U][W] cards
	Intel i8255x-based cards (EtherExpress PRO)
    The following controllers are known not to be supported as boot devices
    by the SRM:
	Adaptec AHA-[23]9[34]xU2 cards

    Depending on your specific model, your mileage may vary, though.

OpenBSD/MACHINE console device restrictions:

    On systems with no framebuffer supported (currently all
    TURBOchannel-based machines), OpenBSD/MACHINE must be used with a
    serial console.
    
    Setting an Alpha system to use a serial console is system-specific.
    Although most models will default to serial console if no keyboard
    is connected on powerup, this behaviour can't be relied upon.
    The recommended procedure is:

	DEC 3000/[4-9]00
		Flip the `S3' switch on the back of the machine
		(up for glass console, down for serial console).

		When configured to use a serial console, it is also
		necessary to set the ``server'' SRM environment
		variable to ``on'' for the system to autoboot on
		powerup despite the lack of a keyboard and mouse
		plugged in.

	DEC 3000/300 family machines
		Console is selected by the `W2' jumper block, to the
		edge of the logic board, near the memory banks.

		Setting the jumper cap on pins 1-2 selects glass
		console, and on pins 2-3 selects serial console.

	All other machines
		From the SRM console, enter either
			set console serial
		or
			set console graphics
		at the SRM prompt, then enter
			init
		or cycle power.