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