--------------------------------------------------------------------------------

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

Other Open Boot PROM Commands
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
SBus References
Bus Specification A.1, 800-4453-10.
SBus Specification B.0, 800-5922-10.
PCI:SBus Comparison, 802-7681.
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 (overtime warning)
ok setenv env-monitor enabled (overtime 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
Note: See References below for E450 documentation.
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/*@1,*
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