Download SPARC/CPU-5TE Technical Reference Manual

Transcript
SPARC CPU-5TE Technical Reference Manual
5.2.10
OpenBoot Enhancements
VMEbus Device Node
The OpenBoot device tree contains the device node for the VMEbus interface and is called
“VME”. It is a child device of the device node “/iommu” (The full pathname of the VMEbus
interface device node is displayed by the command show-devs). The device alias vme is
available as an abbreviated representation of the VMEbus interface device-path.
The vocabulary of the VMEbus device includes the standard commands recommended for a
hierarchical device. The words of this vocabulary are only available when the VMEbus device
has been selected as shown below:
ok cd vme
ok words
selftest
reset
close
open ...
... list of additional methods of the device node
ok selftest .
0
ok device-end
ok
The example listed above selects the VMEbus device and makes it the current node. The word
words displays the names of the methods of the VMEbus device. And the third command calls
the method selftest and the value returned by this method is displayed. The last command
unselects the current device node, leaving no node selected.
The following methods are defined in the vocabulary of the VMEbus device:
open ( — true ) prepares the package for subsequent use. The value true is always returned.
close ( — ) frees all resources allocated by open.
reset ( — ) puts the VMEbus interface into quiet state.
selftest ( — error-number ) performs a test of the VMEbus interface, and returns an
error-number to report the course of the test. In the case that the device has been tested
successfully, the value zero is returned; otherwise, it returns a specific error number to
indicate a certain fail state.
decode-unit ( addr len — low high ) converts the addr and len, a text string representation, to low and high, which is a numerical representation of a physical address within
the address space defined by the package.
map-in ( low high size — vaddr ) creates a mapping that associates the range of physical
address beginning at low, extending for size bytes, within the package’s physical
address space, with a processor virtual address vaddr.
FORCE COMPUTERS
Page 157