PowerPC™ Open Firmware Quick Start Guide Release 2.
Notice While reasonable efforts have been made to assure the accuracy of this document, Motorola, Inc. assumes no liability resulting from any omissions in this document, or from the use of the information obtained therein. Motorola reserves the right to revise this document and to make changes from time to time in the content hereof without obligation of Motorola to notify any person of such revision or changes.
Preface The PowerPC Open Firmware Quick Start Guide provides the general information and procedures required to test and initialize the system hardware, determine the hardware conÞguration, and to boot the operating system.
Motorola® and the Motorola symbol are registered trademarks of Motorola, Inc. PowerStackª is a trademark of Motorola, Inc. PowerPCª and the PowerPC logo are trademarks of International Business Machines Corporation. AIX® and IBM® are registered trademarks of International Business Machines Corporation. Microsoft Windows® and MS-DOS® are registered trademarks of Microsoft Corporation. The software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law.
Contents General Information 1 Overview 1 Scope 1 PowerPC Implementation 1 Hardware Requirements 1 Display Device 2 Memory Requirements 2 EDO Memory ConÞguration 2 System Setup 3 System Power-Up 3 Initialization Process 4 PowerPC Open Firmware Console Detection 5 Keystroke and Mouse Introduction 6 Menu Level Keystrokes 6 Execution Window Keystrokes 6 Mouse Operation 7 Menu-Level Mouse 7 Execution Window Mouse 7 The Graphical User Interface 9 Motorola or OEM Logo 9 Time Clock 9 Submenu 10 Context Sensitive H
Change the Current Password 18 Help on Security Levels 19 Reset the Computer 20 Boot the Operating System 21 The Booting Process 21 Perform Boot Operation 22 Perform Diagnostic Boot Operation 22 Perform Network Boot Operation 22 Perform Auto-Scan Boot Operation 23 Help on Booting the Operating System 23 Advanced Options 24 Display the System Configuration 25 Display Hardware Devices Menu 29 Firmware Diagnostics 33 Configure Keyboard Options 36 Help on Advanced Options 37 Administrative Options 38 Invoke the
Overview General Information Overview This guide introduces you to the basic features of the PowerPC Open Firmware and the tasks you need to perform using the Graphical User Interface. The primary tasks of PowerPC Open Firmware are to test and initialize the system hardware, determine the hardware conÞguration, and boot the operating system.
Memory Requirements Display Device For display on a graphics terminal, a VGA display and a Þrmware-supported PCI graphics card are required. Please refer to the PowerPC Open Firmware Supported PCI Cards Quick Reference for a listing of supported devices. For display on a serial terminal, an ANSI-compatible 80x24 terminal or terminal emulator is required. Memory Requirements The amount of memory in the system is dynamically identiÞed by PowerPC Open Firmware and does not require user intervention.
EDO Memory Configuration System Setup The PowerPC Open Firmware is installed by Motorola at the factory when your PowerPC system or board is manufactured. Refer to your PowerPC board or system installation manual and verify that the necessary hardware preparation has been properly completed. System Power-Up Refer to your PowerPC board or system installation manual for steps on powering up your system.
Initialization Process Initialization Process The MPU, hardware, and Þrmware initialization process is performed by the PowerPC Open Firmware power-up or system reset. The Þrmware initializes the devices on the computer motherboard in preparation for booting your operating system. The Þrmware is shipped from the factory with an appropriate set of defaults. In most cases there isnÕt a need to modify the conÞgurations in the Þrmware prior to booting your operating system.
EDO Memory Configuration Your PowerPC Open Firmware has been conÞgured to automatically initialize your system, detect your console (VGA or serial), run system selftests, and autoboot your operating system. If Then Your operating system has already been installed on your PowerPC system The PowerPC Open Firmware automatically detects the installed operating system and autoboots it.
Keystroke and Mouse Introduction Keystroke and Mouse Introduction Menu Level Keystrokes The following keystrokes are used in the menu interface to easily navigate through the task selection process: Key Action Description Executes the highlighted menu option. This may bring up another submenu or start an execution window. Up/Down Arrow Moves the highlight bar to the next or previous selection.
Mouse Operation Mouse Operation PowerPC Open Firmware has two levels of mouse support. ❏ Menu level ❏ Execution window Note that the mouse is not available at the Command Line Interface (ok prompt). Mouse support requires a VGA display device. Menu-Level Mouse Moving the mouse over a menu or submenu item causes the menu highlight bar to change position and help text to appear in the context-sensitive help window at the bottom of the screen.
Keystroke and Mouse Introduction Note 8 Although icon context-sensitive help is available from within an execution window, you cannot execute icons in this window. You must return to the menu system in order to execute an icon.
Motorola or OEM Logo The Graphical User Interface The Main Menu lists the major options that you most commonly execute. Menu selection and execution is made by using the Up or Down arrow keys and pressing ENTER, or by clicking on the option with the left mouse button. Time Clock Logo Dec 28, 1995 9:27 00 am Main Menu Selections Display the Copyrights Change the Security Level... Reset the Computer Boot an Operating System... Advanced Options... Administrative Options...
The Graphical User Interface Submenu This lower-level menu offers detailed options in the subject category speciÞed by the parent menu. Submenus are displayed in a cascading formation. Dec 28, 1995 9:27 00 am Submenu Selections Display the Copyrights the Security Change Display the Security Level...Level Novice User Level Reset theSet Computer Set Advanced User Level Boot an Operating System... SetOptions... Administrator Level Advanced ChangeOptions...
Execution Window Execution Window An execution window is displayed for some of the menu options to provide input and/or output. An execution window is also provided when using the ok prompt. Board (PWA) Serial Number = “1954499” Board Identifier = “bh “ Artwork (PWA) Identifier = “01-W3107f02g” MPU Clock Speed = “100” BUS Clock Speed = 067” Ethernet Address = “08003E303433” Local SCSI Identifier - “07” System serial Number = “MOTRISC1954499” System Identifier = “MOT RISC PC (e0)” ...
The Graphical User Interface Display and Security of Icons There is security attached to each of the icons in PowerPC Open Firmware. Executing an icon is like executing a menu option, Þrst a security check is done prior to actual execution of the item if security? = true. There are eight icons, however, the number of icons displayed on your VGA screen depend on your security settings in the Þrmware.
Icons Icon Description Click this icon to run the extended selftests on your PowerPC system or board. If security? = false any user level can execute this option. If security? = true, security-mode must be set at advanced or higher. Click this icon to reset your PowerPC system. This option may be executed by any level of user regardless of the security? value. Click this icon to reset your NVRAM variables to their original default setting.
Main Menu Main Menu The PowerPC Open Firmware GUI is accessed after power-up or restart if these conditions are true: ❏ The auto-boot is disabled auto-boot?=false ❏ You manually interrupt the auto-boot countdown The intuitive GUI is designed to provide easy access to the most commonly used Þrmware features, as shown below. Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Administrative Options 11433.
Copyright Information Copyright Information Copyright information is automatically displayed during powerup and reset but can also be viewed by clicking on the logo area or selecting the appropriate option from the Main Menu. Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Administrative Options 11427.00 9605 Using the keyboard or mouse, select Display the Copyrights to view the copyrights.
Main Menu Menu- and Boot-Level Security Each one of the three security levels requires a different password that must be between one and eight characters long. In order to access a particular security level, the user needs to login as that level or higher. A submenu exists which allows users to login to different levels and to change the password of the current security level. The administrative-level boot-time options are explained in detail in the PowerPC Open Firmware UserÕs Manual, Volume 1.
Change the Security Level 2. Press or click the right mouse button to return to the previous menu. Set Novice User Level The Novice level allows you to redisplay copyright messages, boot the operating system, and reset the computer. Use the keyboard or mouse to: 1. Select the Set Novice User Level option from the Change Security Level menu. 2. At the prompt, type in the Novice level password (provided by your Administrator) and press ENTER.
Main Menu Set Administrator Level The Administrator level allows setting of date and time, modiÞcation of conÞguration settings, updating the Þrmware ROM, and invoking the Command Line Interface. Use the keyboard or mouse to: 1. Select the Set Administrator Level option from the Change Security Level menu. 2. At the prompt, type in the administrator password and press ENTER. A message appears confirming that the security level is set to Administrator. 3.
Change the Security Level If the retyped password doesnÕt match the new password, an error message displays and the old password remains in effect. See your administrator if you receive an error. Help on Security Levels Select the Help on Security Levels option to access the online help provided for each of the security selections.
Main Menu Reset the Computer Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Administrative Options 11435.00 9605 Occasionally, you may need to do a software or a hardware reset to your system. This can be done by selecting the Reset Computer option on the Main Menu or by clicking on the reset icon. To reset the system, use the keyboard or mouse to: 1. Select the Reset the Computer option from the Main Menu.
Boot the Operating System Boot the Operating System PowerPC Open Firmware allows easy booting at the menu level. Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Administrative Options Perform Boot Operation Perform Diagnostic Boot Operation Perform Network Boot Operation Perform AutoScan Boot Operation Help Booting Operating System 11426.
Main Menu Perform Boot Operation To boot your operating system, use the keyboard or mouse to: 1. Select the Boot an Operating System from the Main Menu. 2. Select Perform Boot Operation from the submenu. 3. A message similar to this appears: Please wait while the system is booting Boot device: boot File and args: ˘srmp\carloss.elf Perform Diagnostic Boot Operation To perform a diagnostic boot, use the keyboard or mouse to: 1. Select the Boot an Operating System from the Main Menu. 2.
Boot the Operating System Perform Auto-Scan Boot Operation To do an auto-scan boot, use the keyboard or mouse to: 1. Select the Boot an Operating System from the Main Menu. 2. Select Perform Auto-scan Boot Operation from the submenu. Trying..., Trying..., Trying..., Trying..., Failed boot Failed fdisk0 Failed cdrom0 Failed tape0 Can’t rewind tape Trying..., enet0 Booting Please wait while the system is booting Boot device: /pci/ethernet@e:144.191.24.252,˘sr mp\carloss.elf,144.191.24.76,0 .0.0.
Advanced Options These options are for the person who needs to display system information and run diagnostics. Select the Advanced Options from the Main Menu. A submenu appears that offers several options to choose from. Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Display System Configuration Display Hardware Devices Firmware Diagnostics Configure Keyboard Options Administrative Options 11425.
Advanced Options Display the System Configuration By selecting this option you are presented with a submenu offering many selections that display important conÞguration information. Main Menu Advanced Options Display System Configuration Display Board Configuration Block Display Hardware Devices Display the Device Tree Firmware Diagnostics Display NVRAM Variables Display the Device Aliases Configure Keyboard Options Help on System Configuration 11436.
Display the Board ConÞguration Block To view information about your PowerPC system or board, use the keyboard or mouse to: 1. Select the Display Board Configuration Block option from the Display System Configuration menu.
Advanced Options /mmu /memory@0 /aliases /menu./packages /pci/DEC,ethernet@e /pci/scsi@c Press or click the right mouse button to return to the previous menu. Display the NVRAM Variables To display the variable names, values, and default values, use the keyboard or mouse key to: 1. Select the Display the NVRAM Variables option from the Display System ConÞguration menu. The screen displays the current NVRAM information.
Display the Device Aliases The device aliases provide a shorthand version of a device path, that makes it easier to access or refer to the devices on your system. 1. Select the Display the Device Aliases option from the Display System ConÞguration menu. The screen displays the current Device Aliases information. screen a ntdisk com3 com4 disk cdrom disk2 disk1 disk0 scsi . . /pci/viper@12 /floppy /pci/scsi@c/disk@0,0:\veneer.
Advanced Options Display Hardware Devices Menu Select this option to check your hardware version, view the contents of your ßoppy disk, and search the SCSI bus for devices. Main Menu Advanced Options Display Hardware Devices Display System Configuration Display Version Information Display Extended Version Information Display Floppy Disk Contents Configure Keyboard Options Firmware Diagnostics Search SCSI Bus for Device Help on Hardware Devices 11431.
The screen displays the current version information similar to the following. ... Open Firmware Revision ID.......................1.0 Open Firmware Revision...Date.Tues Jan 30 14:46:31 MST 1996 CPU Type................................PowerPC,604 MicroProcessor Internal Clock Speed (MHZ).......100 Local Memory Size...........................4000000 (64MB) ... 3. Press or click the right mouse button to return to the previous menu.
Advanced Options 0 01 00 06 01 80 20 24 00 00 06 00 00 00PCI Bus Bridge Device Registers Base+$0000 57 10 01 00 06 01 80 20 24 00 00 06 00 00 00 00 Base+$0010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Base+$0020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 . . . /pci/cirrus@f Device ID/Revision . . . . . . . . . . . . . .
The screen displays the current device information. /pci/scsi@c Target 0 Unit 0 Disk SEAGATE ST31230W 0465 Target 5 Unit 0 Removable Read Only device TOSHIBA CD-ROM XM-4101TA1084 3. Press or click the right mouse button to return to the previous menu. Help on Hardware Devices Selecting the Help on Hardware Devices provides you with further detail and usage tips for the Display Hardware Devices options.
Advanced Options Firmware Diagnostics PowerPC Open Firmware provides several built-in diagnostics that you can use to verify the correct operation of various aspects of the board operation. Main Menu Advanced Options Display System Configuration Display Cumulative Test Results Display Hardware Devices Firmware Diagnostics Display Diagnostic Output Buffer Run Full Diagnostics Configure Keyboard Options Help on Firmware Diagnostics 11430.
A display similar to the one below appears: Total Tests Run: 18 Total Passed: 18 Total Failed: 0 2. Press or click the right mouse button to return to the previous menu. Display the Diagnostic Output Buffer This display is a cumulative log of ALL tests which have been run since the last reset/power-up. For example, if the Run the Full Diagnostics option has been run twice since the last rest or power-up, then two sets of test results are included in the diagnostics buffer.
Advanced Options Run the Full Diagnostics These onboard diagnostic test routines check devices such as the network controller, the ßoppy disk system, memory, PCI cards, SCSI devices and the system clock. To run the diagnostic tests, use the keyboard or mouse to: 1. Select Run the Full Diagnostics from the Firmware Diagnostics menu.
Configure Keyboard Options PowerPC Open Firmware provides support for the United States and some European style keyboards. Main Menu Advanced Options Display System Configuration Display Hardware Devices Configure Keyboard Options Firmware Diagnostics N-101 (EN) Belgian Danish French . . . Norwegian Portuguese Spanish UK Help Configuring Keyboard 11562.00 9609 To modify the international keyboard, use the keyboard or mouse to: 1. Select Advanced Options. 2. Select the Configure Keyboard Options.
Advanced Options 3. Using the Up/Down arrow keys or the mouse, select the language that you require. That countryÕs keyboard is immediately activated and remains as the set variable whenever the system is powered up. Help on Advanced Options Select this option to get more detail on system configuration, hardware devices, running diagnostics, and keyboard configurations.
Administrative Options The Administrative Options selection is for the user who is responsible for setting the date and time, modifying the system, and updating the Þrmware. Main Menu Display the Copyrights Change the Security Level Reset the Computer Boot an Operating System Advanced Options Administrative Options Invoke Command Line Prompt Set the Date & Time Enable or Disable Security Modify Configuration Settings Update the Firmware Help on Administrative Options 11424.
Administrative Options Invoke the Command Line Prompt The Command Line Prompt (ok prompt) is an interactive command interpreter that gives you access to an extensive set of functions for hardware and software development, fault isolation, and debugging. Main Menu Administrative Options Invoke Command Line Prompt Set the Date & Time Enable or Disable Security Modify Configuration Settings Update the Firmware Help on Administrative Options 11434.
Set the Date and Time Selecting Set the Date and Time results in a series of prompts that help you set the systemÕs date and time. The default format for the time portion of the display is in AM/PM style. The values you enter will be in local 24-hour-time format. Main Menu Administrative Options Invoke Command Line Prompt Enable or Disable Security Set the Date & Time Modify Configuration Settings Update the Firmware Help on Administrative Options 11429.
Administrative Options 3. Type in the current year, month, day, hour, and minute as prompted and press ENTER. If you enter a value outside of the range it is discarded and you are prompted to enter the value again. After entering the values, a message displays showing the date and time which you entered and you are asked if it is correct. 4. Respond with a Y or N and press ENTER or press the key to go to the previous menu. Note The time is changed only if you answer yes (Y).
Enable or Disable Security Choosing this option allows the administrator to enable or disable security. Main Menu Administrative Options Invoke Command Line Prompt Set the Date & Time Enable or Disable Security Modify Configuration Settings Update the Firmware Help on Administrative Options 11440.00 9605 Using the keyboard or mouse: 1. Select the Enable or Disable Security option from the Administrative Options menu. A dialog box is displayed with the message: Would you like to enable security? 2.
Administrative Options Modify the Configuration Settings System configuration variables are stored in the system NVRAM. These variables determine the start-up machine configuration and related communication characteristics. You can modify the values of the configuration variables and any changes you make remain in effect even after a power cycle. Configuration variables should be adjusted cautiously.
Edit the ConÞguration Variables Using the keyboard or mouse: 1. Select the Edit the Configuration Variables option. The NVRAM variables are presented one-at-a-time, similar to this example: Press to use the existing value. Type = to use the default value. Type . to exit and save changes.
Administrative Options 3. Press the key or click the right mouse button to return to the previous menu. Refer to the PowerPC Open Firmware UserÕs Manual, Volume 2 for further information on editing these variables. Edit the Boot Variables This option allows you to interactively modify the NVRAM boot related variables. 1. Select the Edit the Boot Variables option. The ok prompt appears where you can use the Command Line Interface to edit and change the variables.
Format the Hard Drive Choosing this option allows you to format a SCSI hard drive and place a single, FAT file system partition on the drive. 1. Select the Format the Hard Drive option. The available SCSI devices are displayed for you to select from, similar to this example: Scanning for devices, please wait. /pci/scsi@c a) target 0 Unit 0 Disk SEAGATE ST32430W 0660 /pci/scsi@11 /pci/pci@13/scsi@6 b) target 0 Unit 0 Disk SEAGATE ST12400N ST324300456 2.
Administrative Options 4. You are then asked to enter the size of the FAT partition. Enter FAT partition size in MB. (default = 20 = enter) Partition Region Boot Format 1 Primary Yes Size (MB) FAT-16 20 done Restore Default Environment Settings Choosing this option forces the default NVRAM configuration variable settings. Warning: Use this icon with caution as you may lose user-speciÞc NVRAM settings when you choose to return to the default settings. Using the keyboard or mouse: 1.
Choosing Y resets the system and settings take affect immediately. Choosing N does not reset the system which defers the effect of the defaults until the next power-up or reset. Select N to return to the menu. Help on ConÞguration Settings Select this option for further details on default values and modifying the conÞguration variables.
Update Your Firmware If your system is currently running the PPC1Bug Þrmware and you are updating to the new PowerPC Open Firmware, please read the following information. Main Menu Administrative Options Invoke Command Line Prompt Set the Date & Time Enable or Disable Security Modify Configuration Settings Update the Firmware Help on Administrative Options Save the Existing ROM Update the Firmware ROM Replace the Logo Bitmap Help on Update Commands 11438.00 9605 Using the keyboard or mouse: 1.
1. Using the keyboard or mouse, select the Save the Existing ROM option and respond to the prompt by removing all tapes and disks from the system. Disks and tapes should be removed from the system since the ROM image is saved to the first formatted disk or tape found. 2. Insert a DOS formatted disk or tape on which to store the saved ROM image. Note No special formatting of the disk is required if a preformatted (IBM format) high density floppy disk is used.
Note Because MVME2600/3600 Series products provide two distinct flash memory banks, selection of a bank is required. Only the first megabyte is saved to disk due to the limitations of the floppy disk medium. 6. The following prompt appears next: Firmware Selection: (B)PPC1BUG (O)Open Firmware Which Firmware Do You Currently Have in ROM? (B/O) 7. Select the firmware type that is currently in ROM: PPC1BUG or Open Firmware. With the selection entered, a probe for a formatted floppy disk is performed.
When a formatted disk or tape is located, the following prompt appears: Formatted Disk/Tape Found At /pci/ccc/ddd Save To This Device? (Y/N) 10. Type a Y if you desire to save the ROM image at this time to the indicated device and disk or tape. If you type an N, the save process halts and returns you to the Update The Firmware menu. (Note: ccc = controller string, ddd = device string) Saving the ROM image takes approximately 1 to 2 minutes.
To PowerPC Open Firmware From Open Firmware Follow these steps to update to PowerPC Open Firmware from an earlier version of Open Firmware. 1. Using the keyboard or mouse, enter the Administrative Options menu. 2. Select Update The Firmware option. 3. Select Update The Firmware ROM option. The following prompt appears: Insert Bootable Disk or Tape with Firmware Upgrade Proceed? (Y/N) 4. Insert the bootable floppy disk or tape into the appropriate drive and enter a Y to continue the update process.
7. If you responded with a Y in step 4, a probe for a bootable floppy disk is performed. If no floppy disk is present or if no floppy drive is attached, the following prompt appears: No Floppy Drive/Disk Found Search SCSI Bus? (Y/N) 8. To bypass a SCSI bus search and return to the main Update The Firmware menu, enter N and press . 9. To search the SCSI Bus, enter Y and press .
Note If the image is valid and you wish to proceed, you must remove the floppy disk from the disk drive before selecting Y. 12. Enter a Y to load the image into ROM and overwrite the existing firmware. Once the ROM is updated, the system is automatically reset. During the process the following is displayed: Updating ROM Erasing ... Programming ... Verifying ... This update process can take up to several minutes to complete.
Replace the Logo Bitmap You may flash an OEM logo bitmap into ROM in order to supersede the default Motorola logo bitmap. The NVRAM variable mot-oem-logo? is used to choose between the default logo and the OEM logo. This variable defaults to false. The bitmap Þle must be in the standard (uncompressed) 256-color Microsoft Windows .bmp format. The image should be 300 pixels wide by 75 pixels high. If this area is too large, fill in the unused pixels with the background color (index $13).
Make your selection by entering either A or B. Note Because MVME2600/3600 Series products provide two distinct flash memory banks, selection of a bank is required. 7. Enter Y and press to proceed with the replacement. A search for the file oemlogo.bmp is performed. When the file is found, the following prompt is displayed: Update the OEM Bitmap Logo in ROM Using This File? (Y/N) 8.
Color Indexes The following VGA standard color indexes are available for use in the bitmap: $00 dark black $08 light black (light gray) $01 dark red $09 light red $02 dark green $0A light green $03 dark yellow $0B light yellow $04 dark blue $0C light blue $05 dark violet $0D light violet $06 dark cyan $0E light cyan $07 dark white (dark gray) $0F light white The following extended color indexes are also available. All other color indexes are reserved by Motorola.