Comments and Suggestions
Last updated: November 26, 1999



Pages INTRO-
Configurations
PCI Mechanical & Electrical Specifications
PCI Board and PCI Connector Illustrations
Dip Switches and Jumpers
Power-On Self Test
Open Boot PROM Commands
PCI System Commands
OBP Commands for Ultra 30
OBP Commands for U60/E220R/U80/E420R
OBP Commands for Netra 1120/1125/1400/1405
OBP Commands for Enterprise 250
OBP Commands for Ultra Enterprise 450
E3000 - E6500 Flash PROM and FCode
References
1-2
3
4-5
6
7
8-15
16
17
18
18
19-20
21-28
28-30
31


Configurations

Handling Static Sensitive Devices

Electronic components on printed circuit boards can be damaged by static electricity. Always wear a grounding strap and use an antistatic mat when handling boards or components.

Reference Documentation

Standard Configurations and Standard Options supported by Sun Microsystems are documented in the End User Price List, Reseller Price List, Hardware Configuration Guides, Product Brochures, and Hardware Installation Manuals.

Abbreviations

Assy Assembly
Bkt Bracket
FRU Field Replaceable Unit
OBP Open Boot PROM
OS Operating System
w With
w/o Without

Option Abbreviations

SSA SPARCstorage Array
A1000 StorEdge A1000
D1000 StorEdge D1000
A3000 StorEdge A3000 (RSM Array 2000)
A3500 StorEdge A3500
A5000 Enterprise Network Array A5000
A5000 StorEdge A5000
A7000 StorEdge A7000

System Abbreviations

SC SPARCcenter
SS SPARCserver, SPARCstation, or SPARCsystem
A11 Ultra 1 Models 140 and 170
A12 Ultra 1 Models 140E, 170E, and 200E
A14 Ultra 2
A16 Ultra 30
A17 Ultra Enterprise 3000 Workstation
A18 Ultra Enterprise 4000 Workstation
A20 Ultra 450 Workstation
A21 Ultra 5
A22 Ultra 10
A23 Ultra 60
A25 Ultra Enterprise 450 Workgroup Server
A26 Enterprise 250
A27 Ultra 80
A33 Enterprise 420R
A34 Enterprise 220R
E150 Ultra Enterprise 150
Ex000 Ultra Enterprise 3000/4000/5000/6000
Ex500 Enterprise 3500/4500/5500/6500


PCI Local Bus

PCI Mechanical Specification

PCI boards have two basic form factors, standard or long length (312 mm) and short length (119-167 mm). Board edge connectors are keyed for 3.3V signaling, 5V signaling, or universal signaling. Universal boards are designed to fit in 3.3V or 5V connectors.

The 32-Bit, 124 pin PCI connector has 120 signal pins and 4 key pins. The 32-Bit connector defines the system signaling as 3.3V or 5V. An optional 64-Bit extension is built into the same connector molding extending the number of pins to 184.

A 32-Bit PCI board identifies itself for 32-Bit transfers when it is installed in a 32-Bit or 64-Bit connector. A 32-Bit PCI board can be installed in either a 32-Bit or 64-Bit connector.

A 64-Bit PCI board identifies itself for 32-Bit transfers when it is installed in a 32-Bit connector. A 64-Bit PCI board identifies itself for 64-Bit transfers when it is installed in a 64-Bit connector.

The signals that enable 64-bit operation are REQ64 and ACK64. They are Side A Pin-60 and Side B Pin-60 of the 32-bit connector.

PCI Electrical Specification

The PCI specification provides for 3.3V and 5V signaling. Signaling is determined by the motherboard. Signaling for a 3.3V PCI board is at 3.3V. Signaling for a 5V PCI board is at 5V. Signaling for a universal PCI board is at 3.3V or 5V.

All PCI connectors require four power rails: +3.3V, +5V, +12V, and -12V. The distinction between a 3.3V and 5V PCI boards is in the signaling protocol, not the connector power rails.

The maximum power allowed for a PCI board is 25 Watts from all four power rails combined.


PCI Board and PCI Connector Illustrations

PCI Boards are shown with the solder side up because this is the orientation in many PCI systems including the Ultra 5 (Slots 1 and 3), Ultra 10, Ultra 30, Ultra 60, Ultra 80, Enterprise 250, and Ultra Enterprise 450.

32-Bit PCI Boards     PCI Connectors
   
   
   

64-Bit PCI Boards     PCI Connectors
   
   
   


Dip Switches

Rocker and Slide type DIP Switches are used in Sun products. Turn on a Rocker-type switch by pressing down the end of the switch furthest from the OPEN lettering on the switch. Turn on a Slide-type switch by sliding the switch in the direction of the arrow on the switch. Switches 1 and 2 are shown in the ON position in these illustrations.

Jumpers

Jumpers are used to connect two pins of a Terminal Strip. Two sizes of jumpers are used: 0.100 inch and 2.0 millimeter.


Power-On Self Test

Power-On Self Test (POST) is a diagnostic that performs hardware tests at power-on. When POST runs in Diagnostic mode, output is sent to Serial Port A. Frame buffer output occurs during memory initialization after POST has completed. Answer Books, Service Manuals, and Owners Guides provide system specific details on how to use POST and the available options.

Normal Mode runs when:

The NVRAM parameter diag-switch? is set to false.
The NVRAM parameter diag-level is set to off.
The front panel keyswitch is in the Normal or Secure position.
Diagnostic Mode runs when:
The NVRAM parameter diag-switch? is set to true.
The NVRAM parameter diag-level is set to min, med, or max.
The front panel keyswitch is in the Diagnostic position.
DEMON and Extended Modes is initialized after POST when:
The s key (Stop after POST) is depressed after power-on.
The m key (Menus) is depressed after power-on.

DEMON is available on the SS1000(E) and SC2000(E).
Extended POST is available on the E3x00-E6x00.
OBDiag in interactive mode is initialized from OBP when:
The forth word obdiag is entered at the ok prompt.
The forth words obdiag obtest are entered at the ok prompt.
The NVRAM parameter diag-level is set to menus.

OBDiag is available on the Ultra 5, Ultra 10, Ultra 30, Ultra 60, Ultra 80, Enterprise 250, and Ultra Enterprise 450.
OBDiag runs automatically on the E250/E450 after POST when:
The NVRAM parameter diag-switch? is set to true.
The NVRAM parameter diag-level is set to min, med, or max.
The front panel keyswitch is in the Diagnostic position.

Open Boot PROM Commands

Power On Commands

STOP bypasses POST. STOP-A aborts POST.
STOP-D forces a diagnostic power on. The NVRAM Parameter diag-switch? is set to true.
STOP-F forces input and output to ttya. Input from the Keyboard is disabled except for L1-A.
STOP-N forces a set-defaults of the NVRAM.

Help and Printenv Commands

These examples are from an Enterprise 250 with OBP 3.5.

The help command displays the menu of available help options.

ok help
Enter 'help command-name' or 'help category-name' for more help.
(Use ONLY the first word of a category-name or category description)

Examples: help select or help line

Main categories are:

Repeated loops
Defining new commands
Numeric output
Radix (number base conversions)
Arithmetic
Memory access
Line editor
System and boot configuration parameters
Select I/O devices
Floppy eject
Power on reset
Diag (diagnostic routines)
Resume execution
File download and boot
nvramrc (making new commands permanent)
Enable/Disable selected hardware subsystems
Environmental monitor

The printenv command displays NVRAM parameter names, current values, and default values.

Variable Name Value Default Value
diag-passes 1 1
diag-verbosity 0 0
diag-continue? false false
tpe-link-test? true true
scsi-initiator-id 7 7
keyboard-click? false false
keymap

ttyb-mode 9600,8,n,1,- 9600,8,n,1,-
ttya-mode 9600,8,n,1,- 9600,8,n,1,-
ttyb-rts-dtr-off false false
ttyb-ignore-cd true true
ttya-rts-dtr-off false false
ttya-ignore-cd true true
reboot-flag false false
reboot-posc 4294582272 0
reboot-posl 0 0
reboot-cmd boot net -r
pci-slot-skip-list none none
pci0-probe-list 3,2,4,5 3,2,4,5
upa-port-skip-list none none
diag-level min min
diag-script normal normal
diag-targets none none
diag-trigger power-reset power-reset
env-monitor enabled enabled
asr-disable-list

asr-status 18437736870358094097 18437736870358094097
post-status 18437736870358094097
post-address 0
post-flag 0
obp-flags 0
obp-state 6
obp-status 0
#power-cycles 4
system-board-serial# 802F01F0
system-board-date 34cf6a6b
fcode-debug? false false
output-device screen screen
input-device keyboard keyboard
load-base 16384 16384
boot-command boot boot
auto-boot? true true
auto-boot-on-error? false false
watchdog-reboot? false false
diag-file

diag-device net net
boot-file

boot-device net disk net
local-mac-address? false false
ansi-terminal? true true
screen-#columns 80 80
screen-#rows 34 34
silent-mode? false false
use-nvramrc? false false
nvramrc

security-mode none
security-password

security-#badlogins 0
oem-logo

oem-logo? false false
oem-banner

oem-banner? false false
hardware-revision

last-hardware-update

upa-noprobe-mask 0 0
mfg-options 49
diag-switch? false false

Use printenv and the variable name to show a specific parameter.

ok printenv diag-switch?
diag-switch? = true
The Ultra 450 and Ultra Enterprise 450 OBP 3.12 changed the printenv output to eliminate non-user configurable variables used for the internal workings of OpenBoot. Use printenv -a to see all variables.

Use the setenv command to change a parameter.

ok setenv diag-switch? true
Use the set-defaults command to restore the default settings.
ok set-defaults

Other commonly used commands are shown below.
OPTION DESCRIPTION
banner Displays the selftest banner message
.version Displays the version and date of boot PROM
print-nvram-stat Display the PROM version for all boards installed
.enet-addr Displays the Ethernet address
.idprom Displays the ID PROM contents
input [source] Selects source for input (ttya, ttyb, or keyboard)
output [source] Selects source for output (ttya, ttyb, or keyboard)
reset Resets entire system, similar to SunMon k2
soft-reset Soft reset, similar to SunMon k1
eject-floppy Ejects floppy diskette from the drive
security-mode Select non-secure mode (enter none)
Select command secure mode (enter command)
Select full secure mode (enter full)
security-password Allows user to enter an 8 byte password in ASCII
sifting text Display forth commands containing text
words Display forth words in the dictionary
probe-scsi Displays addresses and types of SCSI devices
probe-ide Displays addresses and types of IDE devices
obdiag Enter open boot diagnostics
flash-update-ucm Update UCM flash prom
diag-level Set the diagnostic level to min, max, menus, or off

Open Boot PROM Commands, continued

nvramrc

The nvramrc is an NVRAM location reserved for user-defined commands used during system initialization. Include the following entries when creating a custom nvramrc:
probe-all Probes for plug-in devices
install-console Selects and activates the console
banner Displays the banner to the console

nvedit

The nvedit command opens the nvramrc editor and enables the use of the following commands:
Return Inserts a new line
Control-L Displays all lines in the buffer
Control-C Exits the nvramrc editor

nvquit

The nvquit command discards the contents of the temporary nvramrc buffer created when an nvedit session is exited.

nvrun

The nvrun command executes the contents of the temporary nvramrc buffer created when an nvedit session is exited.

nvstore

The nvstore command saves the contents of the temporary nvramrc buffer created when an nvedit session is exited.

use-nvramrc?

Set the use-nvramrc? parameter to true to use the nvramrc. This parameter is normally set to false.

Twisted Pair Ethernet Link Integrity Test

Set the tpe-link-test? nvram parameter to false to disable the on-board Link Integrity Test.

Use the set-tpe-test command to enable or disable the on-board Link Integrity Test on the SPARCserver 1000.

ok true set-tpe-test
enables the Link Test on all System Boards
ok false set-tpe-test
disables the Link Test on all System Boards
ok false apply set-tpe-test net0 [net1, net2, net3]
disables the Link Test on System Board 0 [1, 2, 3]
Use the nvedit command to program the nvramrc to disable the Link Integrity Test when a reset or power cycle occurs on the SPARCserver 1000.
ok nvedit
0: probe-all install-console <Return>
1: false set-tpe-test <Return>
or
1: false apply set-tpe-test net0 [net1, net2, net3] <Return>
2: banner <Control-c>
ok nvstore
ok setenv use-nvramrc? true
ok reset

SBus Quad Ethernet Controller Link Integrity Test

Use the set-tpe-test command to enable the Link Integrity Test.
ok true "sqec-node1-path" "set-tpe-test" execute-device-method drop
ok true "sqec-node2-path" "set-tpe-test" execute-device-method drop
ok true "sqec-node3-path" "set-tpe-test" execute-device-method drop
ok true "sqec-node4-path" "set-tpe-test" execute-device-method drop
Use the set-tpe-test command to disable the Link Integrity Test. The Link Integrity Test is enabled if a system reset or power cycle occurs.
ok false "sqec-node1-path" "set-tpe-test" execute-device-method drop
ok false "sqec-node2-path" "set-tpe-test" execute-device-method drop
ok false "sqec-node3-path" "set-tpe-test" execute-device-method drop
ok false "sqec-node4-path" "set-tpe-test" execute-device-method drop
Use the nvedit command to program the nvramrc to disable the Link Integrity Test. The Link Integrity Test is not enabled if a system reset or power cycle occurs.
ok nvedit
0: probe-all install-console <Return>
1: false "sqec-node1-path" "set-tpe-test" execute-device-method drop
2: false "sqec-node2-path" "set-tpe-test" execute-device-method drop
3: false "sqec-node3-path" "set-tpe-test" execute-device-method drop
4: false "sqec-node4-path" "set-tpe-test" execute-device-method drop
5: banner <Control-c>
ok nvstore
ok setenv use-nvramrc? true
ok reset

SPARCstation 4 Frame Buffer Resolution

The following methods are available for changing the SS4 tcx frame buffer resolution:
ok setenv fcode-debug? true
ok setenv output-device screen:r1152x900x94
ok reset
or
ok setenv fcode-debug? true
ok setenv output-device /sbus/sunw,tcx:r1024x768x84
ok reset
or
ok setenv fcode-debug? true
ok cd /sbus/sunw,tcx
ok screen select-dev
ok r1280x1024x135 set-resolution

PCI System Commands

The following user query and control commands (forth words) are available on PCI based systems.

Use the show-pci-devs command to show all devices on a specific PCI bus.

ok show-pci-devs /pci@1f,2000 (show pcia devices)
ok show-pci-devs /pci@1f,4000 (show pcib devices)
Use the show-pci-devs-all command to show all PCI devices.
ok show-pci-devs-all (show all pci devices)
Use the show-pci-config command to show configuration space registers for a given PCI device.
ok show-pci-config /pci@1f,4000/network@1,1
Use the show-pci-configs command to show configuration space registers for all PCI devices on a PCI bus.
ok show-pci-configs /pci@1f,4000
Use the show-pci-configs-all command to show configuration space registers for all PCI devices on all PCI busses.
ok show-pci-configs-all /pci@1f,4000
Use the probe-pci command to probe all devices on a specific PCI bus.
ok probe-pci /pci@1f,4000
probing /pci@1f,4000 at Device 3 scsi disk tape
probing /pci@1f,4000 at Device 3 nothing there
Use the probe-pci-slot command to probe a specific PCI slot on a specific PCI bus.
ok 3 probe-pci-slot /pci@1f,4000
probing /pci@1f,4000 at Device 3 scsi disk tape

Ultra 30

The pcia-probe-list NVRAM variable is used to control the probe order for the following pcia devices (/pci@1f,2000):
Psycho 0 (not probed)
PCI Slot 0    1 (J1301 = pci@1f,2000/xxx@1)
no device 2 (historical entry)
ok setenv pcia-probe-list 1,2 (Probe in order 1,2)
The pcib-probe-list NVRAM variable is used to control the probe order for the following pcib devices (/pci@1f,4000):
Psycho 0 (not probed)
Cheerio 1 (not probed)
PCI Slot 1 2 (J1401 = pci@1f,4000/xxx@2)
Onboard SCSI    3 (first device probed by default)
PCI Slot 2 4 (J1501 = pci@1f,4000/xxx@4)
PCI Slot 3 5 (J1601 = pci@1f,4000/xxx@5)
ok setenv pcib-probe-list 3,2,4,5 (Probe in order 3,2,4,5)
The printenv pcix-probe-list command is used to show the probe list for pcia or pcib:
ok printenv pcia-probe-list (print pcia probe list)
ok printenv pcib-probe-list (print pcib probe list)
The show-pci-devs command is used to show all devices on a specific PCI bus:
ok show-pci-devs /pci@1f,2000 (show pcia devices)
ok show-pci-devs /pci@1f,4000 (show pcib devices)
The show-pci-devs-all command is used to show all devices:
ok show-pci-devs-all (show all pci devices)

Ultra 60, Netra t 1120/1125, and Enterprise 220R
Ultra 80, Netra t 1400/1405, and Enterprise 420R

The Ultra 60 Workstation, Netra t 1120/1125 Telco Server, and Enterprise 220R Workgroup Server use the same System Board.

The Ultra 80 Workstation, Netra t 1400/1405 Telco Server, and Enterprise 420R Workgroup Server use the same System Board.

The banner-name, enclosure-type, and energystar-enabled? NVRAM variables set up the system board for use in a Workstation, Telco Server, or Workgroup Server. These variables:

Control the system name displayed in the power-on banner
Enable or disable energystar
Report the enclosure type to software

ok setenv banner-name Sun Enterprise 220R
banner-name = Sun Enterprise 220R

ok setenv enclosure-type 540-4284
enclosure-type = 540-4284

ok setenv energystar-enabled? true
energy-star-enabled? = false
System banner-name enclosure-type energystar-enabled?
Ultra 60
Netra t 1120/1125
Enterprise 220R
Sun Ultra 60 UPA/PCI
Sun Ultra 60 UPA/PCI
Sun Enterprise 220R
540-3251
Unknown
540-4284
true
false
false
Ultra 80
Netra t 1400/1405
Enterprise 420R
Sun Ultra 80 UPA/PCI
Sun Ultra 80 UPA/PCI
Sun Enterprise 420R
540-3871
Unknown
540-4115
true
false
false
The enclosure-type variable is for future use. Current software uses the banner-name.

The banner-name, enclosure-type, and energystar-enabled? variables are not changed by the set-defaults command.

Enterprise 250

The upa-port-skip-list NVRAM variable is used to skip probing of UPA ports. The following UPA ports are used:
Processors UPA Ports 0 and 1
Psycho UPA Port 1
ok setenv upa-port-skip-list 1 (Skip CPU1)
The pci0-probe-list NVRAM variable is used to control the probe order for PCI devices /pci@1f,4000. Device 2 is card slot 2, device 3 is SCSI, device 4 is card slot 1, and device 5 is card slot 0.
ok setenv pci0-probe-list 3,2,4 (Probe in order 3-2-4)
The pci-slot-skip-list NVRAM variable is used to skip probing of PCI devices plugged into the backpanel slots 0, 1, 2, and 3.
ok setenv pci-slot-skip-list 0,3 (Skip slot 0 and 3)
The diag-trigger NVRAM variable is used to control which resets will automatically enable POST when diag-switch? is true.
ok setenv diag-trigger power-reset
Run diagnostics on power-on resets.
ok setenv diag-trigger error-reset
Run diagnostics on power-on resets, fatal hardware errors, and watchdog resets.
ok setenv diag-trigger soft-reset
Run diagnostics on all resets (except XIR) including UNIX init 6 or reboot
ok setenv diag-trigger none
Does not run diagnostics on any resets.
The auto-boot-on-error? NVRAM variable is used to allow the system to attempt to boot if POST fails and auto-boot? is true.
ok setenv auto-boot-on-error? true
Attempt to boot if POST fails and auto-boot? is true
The env-monitor NVRAM variable is used for environmental monitoring at the Open Boot PROM level.
ok setenv env-monitor advise (overtemp warning)
ok setenv env-monitor enabled (overtemp warning, shut down power)
ok setenv env-monitor disabled (env-monitor is off)
The asr-enable and asr-disable commands enable and disable system devices. The .asr command displays the settings.
ok .asr
System status : Enabled
CPU0 : Enabled
CPU1 : Enabled
SC-MP : Enabled
Psycho@1f : Enabled
Cheerio : Enabled
SCSI : Enabled
Mem Bank0 : Enabled
Mem Bank1 : Enabled
Mem Bank2 : Enabled
Mem Bank3 : Enabled
PROM : Enabled
NVRAM : Enabled
TTY : Enabled
Audio : Enabled
Soupier : Enabled
PCI Slots : Enabled
Known 'enable/disable' subsystem components are:
cpu*   cpu0   cpu1
bank*   bank0   bank1   bank2   bank3
dimm0 - dimm15

Ultra 450 and Ultra Enterprise 450

The mfg-options NVRAM variable is a decimal value that sets up the system as a Workstation or a Server. The mfg-options:
Controls the system name displayed in the power-on banner
Enables or disables energystar
Controls the behavior after a watchdog reset
Enables or disables the blinking front panel LEDs

ok setenv mfg-options 0 (Workstation default, in decimal)
ok setenv mfg-options 49 (Server default, in decimal)
Hex Root ( / )
Node Properties
/eeprom
Node Properties
SUNW,envctrl
Node Properties
banner-name system-type energystar-v2 watchdog-enable activity-led-blink?
xxxx xxx0 Ultra 450 Workstation Enabled

xxxx xxx1 Enterprise 450 Server Disabled

xxx0 xxxx



Disabled
xxx1 xxxx



Enabled
xx0x xxxx


Disabled
xx1x xxxx


Enabled

The method of changing the mfg-options, diag-targets, and diag-verbosity was changed in OBP 3.12. The new method accepts a + or - construct for these variables.

mfg-options:
workstation-class -+(0x00) Workstation
server-class -+(0x01) Server
workstation -+(0x00) Workstation
energystar -+(0x10) Energy Star
watch-dog -+(0x20) Watchdog
server -+(0x31) Server/Energy Star/Watchdog
ok setenv mfg-options + server
ok setenv mfg-options + watchdog + energystar
ok setenv mfg-options - energystar

diag-targets:
none -+(0x00) no bus or device I/O testing
iopath -+(0x01) test bus connectivity (eg SCSI)
media -+(0x02) perform I/O to the device
device -+(0x04) invoke device self test (BIST)
loopback -+(0x10) external loopback (eg tty)
loopback2 -+(0x20) external loopback2 (eg MII)
loopbacks -+(0x30) external loopback + loopback2
loopback3 -+(0x40) external loopback3 (eg RSC)

diag-verbosity:
none -+(0x00) minimum output (errors only)
silent -+(0x00) minimum output (errors only)
verbose -+(0x01) test progress information
subtests -+(0x02) print subtest names
debug -+(0x04) print debug messages
callers -+(0x08) print back trace of callers on errors
tests -+(0x10) print Testing
all -+(0x1f) verbose + names + debug + callers

The upa-port-skip-list NVRAM variable is used to skip probing of UPA ports. The following UPA ports are used:
Processors UPA Ports 0, 1, 2, and 3
Frame Buffers    UPA Ports 1d and 1e
Psycho UPA Ports 4, 6, and 1f

ok setenv upa-port-skip-list 3,1d (Skip CPU3 and FFB1)
The pci0-probe-list NVRAM variable is used to control the probe order for onboard PCI devices (/pci@1f,4000). The probe order for PCI devices plugged into the backpanel slots cannot be controlled. Devices omitted from the pci0-probe-list are not probed.

Devices in the pci0-probe-list are:

2 = scsi (rma backplane & external connector)
3 = scsi (4 disk backplane)
4 = Empty slot - Back panel slot 10

ok setenv pci0-probe-list 3,2,4 (Probe in order 3-2-4)
Due to internal PCI changes introduced in OBP 3.12, the Cheerio node is pseudo-probed and device 1 must always be included in the pci0-probe-list. Prior to OBP 3.12, an entry for device 1 was not required. The default probe order for OBP 3.12 is 1-3-2-4.

Devices in the OBP 3.12 pci0-probe-list are:

1 = Cheerio (flash, nvram, superio, serial, audio, and I2C)
2 = SCSI (rma backplane & external connector)
3 = SCSI (4 disk backplane)
4 = PCI Slot 10

ok setenv pci0-probe-list 1,3,2,4 (Probe in order 1-3-2-4)
The pci-slot-skip-list NVRAM variable is used to skip probing of PCI devices plugged into the backpanel slots. If slot 10 is in the pci-slot-skip-list, it will be skipped even if device 4 is included in the pci0-probe-list.
ok setenv pci-slot-skip-list 4,6 (Skip slot 4 and 6)
The memory-interleave NVRAM variable controls how OBP sets memory interleaving. If interleaving is enabled with mixed memory bank sizes, the smaller memory size is used and POST displays a smaller memory value than is physically installed.
ok setenv memory-interleave max-size
Setting Description
auto (default) OBP chooses best setting
max-size Configure for maximum available memory space
max-interleave Configure for maximum memory bandwidth (high
interleaving values) at the expense of memory size
 1 Use 1-way interleaving
 2 Use 2-way interleaving
 4 Use 4-way interleaving

The env-monitor NVRAM variable determines how OBP responds to environmental monitoring via the I2C serial bus.

ok setenv env-monitor advise
Setting Description
enabled (default) Issue a warning and shut down the system in 15 seconds
if an unsafe condition is detected
advise Issue a warning if an unsafe condition is detected
disabled Do not monitor for unsafe conditions

The .post command displays the results of the Power On Self Test.

ok .post
System status :   OK
CPU0 : OK
CPU1 : OK
CPU2 : OK
CPU3 : OK
etc ...
The diag-trigger NVRAM variable is used to control which resets will automatically enable POST when diag-switch? is true.
ok setenv diag-trigger power-reset
Run diagnostics on power-on resets.
ok setenv diag-trigger error-reset
Run diagnostics on power-on resets, fatal hardware errors, and watchdog resets.
ok setenv diag-trigger soft-reset
Run diagnostics on all resets (except XIR) including UNIX init 6 or reboot
ok setenv diag-trigger none
Does not run diagnostics on any resets.
The asr-enable and asr-disable commands enable and disable system devices. The .asr command displays the settings.
ok .asr
System status :   Enabled (Not Selectable)
CPU0 :   Enabled (cpu0 or cpu*)
CPU1 :   Enabled (cpu1 or cpu*)
CPU2 :   Disabled (cpu2 or cpu*)
CPU3 :   Enabled (cpu3 or cpu*)
SC-Marvin :   Enabled (Not Selectable)
Psycho@1f :   Enabled (Not Selectable)
Psycho@4 :   Enabled (Not Selectable)
Psycho@6 :   Enabled (Not Selectable)
Cheerio :   Enabled (Not Selectable)
SCSI :   Enabled (Not Selectable)
Mem Bank0 :   Enabled (bank0 or bank* or dimm0-3)
Mem Bank1 :   Enabled (bank1 or bank* or dimm4-7)
Mem Bank2 :   Enabled (bank2 or bank* or dimm8-11)
Mem Bank3 :   Enabled (bank3 or bank* or dimm12-15)
PROM :   Enabled (Not Selectable)
NVRAM :   Enabled (Not Selectable)
TTY :   Enabled (Not Selectable)
Audio :   Enabled (Not Selectable)
SuperIO :   Enabled (Not Selectable)
PCI Slots :   Enabled (Not Selectable)
The /mc device node stores memory configuration information for use by the operating system.
ok cd /mc@0,0
ok ls
f007f3e8   bank@0,c0000000
f007f230   bank@0,80000000
f007f078   bank@0,40000000
f007e9a0   bank@0,00000000

ok cd /mc@0,0/bank@0,0
ok ls
f007eed8   dimm@0,3
f007ed90   dimm@0,2
f007ec48   dimm@0,1
f007eb00   dimm@0,0

ok .properties
reg   00000000 00000000 00000000 08000000
#size-cells   00000002
fru   motherboard
device_type   memory-bank
name   bank

The lower half of the register is the bank size:
00000000 08000000 = 128mb bank
The upper half of the register is the starting address:
00000000 00000000 = starting address 0

ok cd /mc@0,0/bank@0,0/dimm@0,3
ok .properties
socket-name   1704
reg   00000000 00000003 00000000 02000000
fru   memory-module
device_type   memory-module
name   dimm

The lower half of the register is the dimm size:
00000000 02000000 = 32mb
The upper half of the register is the dimm number in the bank:
00000000 00000003 = dimm 3
The /associations tree node contains entries representing categories of associations, or connections, between system components that are dispersed in the device tree.
ok cd /associations/slot2dev
ok .properties
Sub-System   Is Associated With
ebus|audio   /pci@1f, 4000/ebus@1/*@14, 200000
pci-slot#10   /pci@1f, 4000/*@4,*
pci-slot#9   /pci@4, 4000/*@2,*
pci-slot#8   /pci@4, 4000/*@3,*
pci-slot#7   /pci@4, 4000/*@4,*
pci-slot#6   /pci@4, 2000/*@1,*
pci-slot#5   /pci@1f, 2000/*@4,*
pci-slot#4   /pci@6, 2000/*@1,*
pci-slot#3   /pci@6, 4000/*@2,*
pci-slot#2   /pci@6, 4000/*@3,*
pci-slot#1   /pci@6, 4000/*@4,*
graphics#2   /*@1d,0
graphics#1   /*@1e,0
cpu-b2   /*@3,0
cpu-b1   /*@2,0
cpu-a2   /*@1,0
cpu-a1   /*@0,0

ok cd /associations/slot2led
ok .properties
Sub-System   Is Associated With
slot # 3   /pci@1f,4000/ebus@1/i2c@14,600000/bits@40/wo@3
slot # 2   /pci@1f,4000/ebus@1/i2c@14,600000/bits@40/wo@2
slot # 1   /pci@1f,4000/ebus@1/i2c@14,600000/bits@40/wo@1
slot # 0   /pci@1f,4000/ebus@1/i2c@14,600000/bits@40/wo@0

ok cd /associations/slot2disk
ok .properties
Sub-System   Is Associated With
slot # 3   /pci@1f,4000/scsi@3/disk@3
slot # 2   /pci@1f,4000/scsi@3/disk@2
slot # 1   /pci@1f,4000/scsi@3/disk@1
slot # 0   /pci@1f,4000/scsi@3/disk@0

The disk-led-assoc NVRAM variable defines the PCI slot location for the dual channel Ultra/Wide SCSI controller connected to the lower and upper 8-drive backplanes.

The value 0 defines the location of the onboard SCSI controller that connects to the 4-drive backplane.

The value x defines the PCI slot location of the lower SCSI controller that connects to the lower 8-drive backplane.

The value y defines the PCI slot location of the upper SCSI controller that connects to the upper 8-drive backplane.

ok printenv disk-led-assoc
disk-led-assoc 0 (default)
ok setenv disk-led-assoc 0 x y

E3000 - E6500 Flash and FCode

Use the Flash PROM programming utility to update the Flash PROM on the CPU/Memory board and FCode on the I/O boards.

Program the Flash PROM and FCode over a local area network, from CD-ROM, or from Patch 103346Internet Link. Patch <=103346-09Internet Link is for the 32-bit Solaris Operating System and Patch >=103346-10Internet Link is for the 32-bit or 64-bit Solaris Operating System.

Use caution when performing a Flash PROM update. A board may be inoperable if it is programmed with an older version of code. For example:

CPU/Memory boards with 336MHz modules require OBP >=3.2 Version 12. Selftest fails if older code is downloaded.

Flash Update 1.6 does not support Type-4 I/O boards. A Type-4 I/O board will appear to be a Type-1 I/O board after downloading FCode from Flash Update 1.6. The device SUNW,socal will not be recognized, and errors from device SUNW,soc will appear during selftest.

Use caution when using flash-update. A board may be inoperable if it is programmed with a newer version of code. For example:

OBP 3.2.11 does not support Type-4 I/O Boards. If the OBP flash-update command is used when Type-1 and Type-4 I/O Boards are installed, the Type-1 I/O Board will appear to be a Type-4 I/O Board after downloading FCode. The SUNW,soc will be programmed as a SUNW,socal.
A corrupted Flash PROM can be reprogrammed if another board of the same type with uncorrupted code is available.
  1. Connect to Serial Port A at 9600 baud, 8-bit, no parity, 1 stop bit.
  2. Disconnect the board with corrupted code from the backplane.
  3. Install the known good board in any available slot.
  4. Turn the keyswitch to On.
  5. Wait 15 seconds and press s to enter Extended POST.
  6. Select f for fcopy from the Extended POST Menus.
  7. Insert the board with corrupted code into the backplane.
  8. Select 4 for Activate System Board and follow the prompts.
  9. Select 1 to copy the code and follow the prompts.
  10. Turn the keyswitch to Standby.

Use the .version command to display the CPU/Memory Board Flash PROM and I/O Board FCode revision.

ok .version
Slot 1 - I/O Type 4 FCODE 1.8.7 1997/12/08 15:39 iPOST 3.4.4 1997/08/26 17:37
Slot 3 - I/O Type 3 FCODE 1.8.7 1997/05/09 11:18 iPOST 3.0.2 1997/05/01 10:56
Slot 9 - CPU/Memory OBP 3.2.16 1998/06/08 16:58 POST 3.9.4 1998/06/09 16:25

Use the .properties command to display the CPU/Memory Board Flash PROM revision in hexadecimal ASCII.

ok cd /fhc@12,f8800000/flashprom@0,0
ok .properties
version 4f 42 50 20 20 20 33 2e 32 2e 31 36 20 31 39 39
model SUNW,525-1431
name flashprom
4f 42 50 20 20 20 33 2e 32 2e 31 36 20 31 39 39 = OBP 3.2.16 199

The model property contains the part number of the Flash PROM. The model property of some boards is not the same as the part number used for the Flash PROM Code.

Board Model Property Flash PROM
CPU/Memory SUNW,525-1431 525-1387
I/O Type 1 SUNW,525-1432 525-1445
I/O Type 2 SUNW,525-1433 525-1446
I/O Type 3 SUNW,525-1680 525-1680
I/O Type 4 SUNW,525-1757 525-1757
I/O Type 5 SUNW,525-1760 525-1760

Use the .properties command to display the I/O Board FCode revision in hexadecimal ASCII.

ok cd /fhc@e,f8800000/flashprom@0,0
ok .properties
version 46 43 4f 44 45 20 31 2e 38 2e 33 20 31 39 39 37
model SUNW,525-1432
name flashprom
46 43 4f 44 45 20 31 2e 38 2e 33 20 31 39 39 37 = FCODE 1.8.3 1997

Use the .properties command to display the I/O Board SOC Controller FCode revision.

ok cd /sbus@2,0/SUNW,soc@d,10000
ok .properties
soc-fcode 1.3 95/09/28
model 501-2069
name SUNW,soc

Use the .properties command to display the I/O Board SOC+ Controller FCode revision.

ok cd /sbus@2,0/SUNW,socal@d,10000
ok .properties
version @(#) FCode 1.11 97/12/07
model 501-3060
name SUNW,socal


References

SBus References
  1. Bus Specification A.1, 800-4453-10.Internet Link
  2. SBus Specification B.0, 800-5922-10.Internet Link
  3. PCI:SBus Comparison, 802-7681.Internet Link
OBP 1.x and 2.x References
  1. Open Boot PROM Toolkit User's Guide, 800-4251-10.Internet Link
  2. Open Boot PROM Toolkit User's Guide, 800-5279-10.Internet Link
  3. Introduction to Open Boot 2.0, 800-5674-10.Internet Link
  4. Open Boot PROM 2.0 Command Reference, 800-6076-11.Internet Link
  5. Open Boot PROM Toolkit Reference Summary, 800-4687-10.Internet Link
  6. Open Boot PROM Toolkit Reference Summary, 800-5280-10.Internet Link
  7. Open Boot PROM Command Summary, 800-5675-11.Internet Link
  8. Writing FCode Programs for SBus Cards, 800-4456-10.Internet Link
  9. Writing FCode 2.x Programs, 801-5123-10.Internet Link
OBP 3.x References
  1. OpenBoot 3.x Quick Reference, 802-3240-10.Internet Link
  2. OpenBoot 3.x Command Reference, 802-3242-10.Internet Link
  3. Writing FCode 3.x Programs, 802-3239-10.Internet Link
  4. Writing FCode 3.x Programs, 802-5895-10.Internet Link
  5. OpenBoot 3.x Supplement for PCI, 802-7679.Internet Link
  6. Enterprise 250 Platform Note, 805-3399.Internet Link
Flash PROM References
  1. Ultra 1 and Ultra 2 Flash PROM Programming Guide, 802-3233-12.Internet Link
  2. Ultra System Flash PROM Programming Guide for Ultra 1, Ultra 2, Ultra 5/10, Ultra 30, Ultra 60, and Ultra Enterprise 450, 802-3233-17.Internet Link
  3. E3000/4000/5000/6000 Flash PROM Programming Guide, 802-5579-10.Internet Link
  4. E6x00/5x00/4x00/3x00 Flash PROM Programming Guide, 802-5579-12.Internet Link
Ultra 450 and Ultra Enterprise 450 References
  1. Ultra Enterprise 450 Owners Guide, 805-0429-10.Internet Link
  2. Ultra 450 Owners Guide, 805-0430-10.Internet Link
Field Engineer Handbook References
  1. Sun-3 Handbook, 802-6796-01.Internet Link
  2. Sun-4 Handbook, 805-3028-01.Internet Link
  3. Sun-4c Handbook, 805-6849-02.Internet Link
  4. SS600MP Handbook, 805-3973-02.Internet Link
  5. Printer Handbook, 806-2138-01.Internet Link
  6. SPARCstation 10 Handbook, 806-2139-01.Internet Link
  7. SPARCstation Voyager Handbook, 806-2140-01.Internet Link
  8. Removable Media Handbook, 806-2141-01.Internet Link
  9. Sun-4/10/15/30 Handbook, 806-2142-01.Internet Link


© 1987-2000, Sun Microsystems Inc.