xref: /openbsd/distrib/notes/luna88k/prep (revision 73471bf0)
1dnl	$OpenBSD: prep,v 1.8 2014/04/22 22:58:02 aoyama Exp $
2dnl Need to provide a short monitor description. Start from
3dnl http://www.nk-home.net/~aoyama/luna88k/monitor.txt
4dnl and also document NVRAM?
5
6LUNA-88K do not require any specific preparation prior to the OpenBSD
7installation. However, you might want to get familiar with the PROM
8interface, in order to be able to boot the installation media and, later,
9specify the correct boot parameters.
10
11Setting up the boot device and filename:
12
13  Boot device and filename information is stored by the PROM into
14  the machine's non-volatile memory.
15
16  LUNA-88K systems can only boot from SCSI devices. The boot device type
17  (such as ``sd'' for a disk) is specified by the
18  ``boot_device'' variable. The SCSI id of the boot device is specified
19  by the ``boot_unit'' NVRAM variable, and the boot partition on said
20  device is specified by the ``boot_partition'' variable. The
21  ``boot_filename'' variable stores the name of the file to boot, and
22  defaults to ``vmunix''. To boot OpenBSD, this variable should be
23  changed to ``boot'', as in:
24
25    0> nvram boot_filename boot
26
27  The ``boot_unit'' value is an encoding of the device SCSI identifier.
28  If the boot device is an SCSI disk (``sd''), the value of ``boot_unit''
29  should be (6 - ID). On LUNA-88K2 systems, if the boot device is connected
30  to the external SCSI connector, 10 should be added to the value of
31  ``boot_unit''. Thus booting off an external SCSI disk of ID #0 would
32  be 16 on a LUNA-88K2, and 6 on a LUNA-88K.
33
34Setting up the boot behaviour:
35
36  Unlike other platforms, boot behaviour is controlled by the front panel
37  DIP switches only.
38
39  The first set of DIP switches in the front panel (DIP SW1) is used to
40  select the machine behaviour upon powerup, as well as the preferred
41  console device.
42
43  The meaning of these switches will depend upon your particular machine.
44  On the LUNA-88K, the 'down' position is 'on', and the 'up' position is
45  'off', while the LUNA-88K2 uses the opposite convention (i.e. 'up' is
46  'on' and 'down' is 'off').
47
48  If the leftmost switch in SW1, #1, is in the 'off' position, the system
49  will auto-boot from the boot device saved in NVRAM (using the
50  ``boot_device'', ``boot_unit'' and ``boot_filename'' variables). Otherwise,
51  the boot process will stop at the PROM prompt.
52
53Setting up serial console:
54
55  The second switch in SW1, #2, selects the console device. When in the 'on'
56  position, it selects the serial console port as the console; otherwise,
57  the graphics display and keyboard are used as the console.
58
59  While the LUNA-88K2 uses ``standard'' DB9 serial ports, the earlier
60  LUNA-88K have a specific connector, HiRose QM10-14R(L)-PR. Wiring
61  information for this connector can be found at the following URL:
62	http://www.kk.iij4u.or.jp/~taokamur/luna68k/serial.jpg
63  A suitable cable connector for this port would be either HiRose
64  QM30-14PA-EP with a QM14-CS cover (with lock), or QM30-14P-EP with a
65  QM14-CY cover (without lock).
66
67