OpenBoot 2.x Command Reference Manual

Changing the Power-on Banner

The banner configuration parameters are:

To view the power-on banner, type:.


ok banner
            SPARCstation 2, Type 4 Keyboard 
            ROM Rev. 2.0, 16MB memory installed, Serial # 289
            Ethernet address 8:0:20:d:e2:7b, Host ID: 55000121
ok

The PROM displays the system banner. The preceding example shows a SPARCstation 2 banner. The banner for your SPARC system may be different.

The banner consists of two parts: the text field and the logo (over serial ports, only the text field is displayed). You can replace the existing text field with a custom text message using the oem-banner and oem-banner? configuration parameters.

To insert a custom text field in the power-on banner, type:


ok setenv oem-banner Hello Mom and Dad
ok setenv oem-banner? true
ok banner

             Hello Mom and Dad

ok

The system displays the banner with your new message, as shown in the preceding screen.

However, the graphic logo must be handled somewhat differently. oem-logo is a 512-byte array, containing a total of 4096 bits arranged in a 64 x 64 array. Each bit controls one pixel. The most significant bit (MSB) of the first byte controls the upper-left corner pixel. The next bit controls the pixel to the right of it, and so on.

To create a new logo, first create a Forth array containing the correct data; then copy this array into oem-logo. In the following example, the array is created using Forth commands. (It could also be done under the operating system using the eeprom command.) The array is then copied using the to command. The example below fills the top half of oem-logo with an ascending pattern.


ok create logoarray d# 512 allot
ok logoarray d# 256 0 do i over i + c! loop drop
ok logoarray d# 256 to oem-logo
ok setenv oem-logo? true
ok banner 

To restore the original Sun power-on banner, set the oem-logo? and oem-banner? parameters to false.


ok setenv oem-logo? false
ok setenv oem-banner? false
ok

Because the oem-logo array is so large, printenv displays approximately the first 8 bytes (in hexadecimal). Use the oem-logo dump command to display the entire array. The oem-logo array is not erased by set-defaults, since it might be difficult to restore the data. However, oem-logo? is set to false when set-defaults executes, so the custom logo is no longer displayed.