^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) MOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) M68000 Hi-Performance Microprocessor Division
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) M68060 Software Package
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Production Release P1.00 -- October 10, 1994
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) M68060 Software Package Copyright © 1993, 1994 Motorola Inc. All rights reserved.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) THE SOFTWARE is provided on an "AS IS" basis and without warranty.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) To the maximum extent permitted by applicable law,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) MOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) and any warranty against infringement with regard to the SOFTWARE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) (INCLUDING ANY MODIFIED VERSIONS THEREOF) and any accompanying written materials.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) To the maximum extent permitted by applicable law,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) ARISING OF THE USE OR INABILITY TO USE THE SOFTWARE.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Motorola assumes no responsibility for the maintenance and support of the SOFTWARE.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) You are hereby granted a copyright license to use, modify, and distribute the SOFTWARE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) so long as this entire notice is retained without alteration in any modified and/or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) redistributed versions, and that such modified versions are clearly identified as such.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) No licenses are granted by implication, estoppel or otherwise under any patents
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) or trademarks of Motorola, Inc.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 68060 SOFTWARE PACKAGE (Kernel version) SIMPLE TESTS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) -----------------------------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) The files itest.sa and ftest.sa contain simple tests to check
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) the state of the 68060ISP and 68060FPSP once they have been installed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Release file format:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) --------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) The release files itest.sa and ftest.sa are essentially
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) hexadecimal images of the actual tests. This format is the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) ONLY format that will be supported. The hex images were created
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) by assembling the source code and then converting the resulting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) binary output images into ASCII text files. The hexadecimal
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) numbers are listed using the Motorola Assembly syntax assembler
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) directive "dc.l" (define constant longword). The files can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) converted to other assembly syntaxes by using any word processor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) with a global search and replace function.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) To assist in assembling and linking these modules with other modules,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) the installer should add symbolic labels to the top of the files.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) This will allow the calling routines to access the entry points
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) of these packages.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) The source code itest.s and ftest.s have been included but only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) for documentation purposes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) Release file structure:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) -----------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) (top of module)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) | | - 128 byte-sized section
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) (1) | Call-Out | - 4 bytes per entry (user fills these in)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) | | - 8 bytes per entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) (2) | Entry Point | - user does "bsr" or "jsr" to this address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) | | - code section
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) (3) ~ ~
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) | |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) -----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) (bottom of module)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) The first section of this module is the "Call-out" section. This section
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) is NOT INCLUDED in {i,f}test.sa (an example "Call-out" section is provided at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) the end of this file). The purpose of this section is to allow the test
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) routines to reference external printing functions that must be provided
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) by the host operating system. This section MUST be exactly 128 bytes in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) size. There are 32 fields, each 4 bytes in size. Each field corresponds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) to a function required by the test packages (these functions and their
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) location are listed in "68060{ISP,FPSP}-TEST call-outs" below). Each field
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) entry should contain the address of the corresponding function RELATIVE to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) the starting address of the "call-out" section. The "Call-out" section must
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) sit adjacent to the {i,f}test.sa image in memory. Since itest.sa and ftest.sa
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) are individual tests, they each require their own "Call-out" sections.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) The second section, the "Entry-point" section, is used by external routines
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) to access the test routines. Since the {i,f}test.sa hex files contain
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) no symbol names, this section contains function entry points that are fixed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) with respect to the top of the package. The currently defined entry-points
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) are listed in section "68060{ISP,FPSP}-TEST entry points" below. A calling
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) routine would simply execute a "bsr" or "jsr" that jumped to the selected
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) function entry-point.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) For example, to run the 060ISP test, write a program that includes the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) itest.sa data and execute something similar to:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) bsr _060ISP_TEST+128+0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) (_060ISP_TEST is the starting address of the "Call-out" section; the "Call-out"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) section is 128 bytes long; and the 68060ISP test entry point is located
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) 0 bytes from the top of the "Entry-point" section.)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) The third section is the code section. After entering through an "Entry-point",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) the entry code jumps to the appropriate test code within the code section.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) 68060ISP-TEST Call-outs:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) ------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) 0x0: _print_string()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) 0x4: _print_number()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) 68060FPSP-TEST Call-outs:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) -------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) 0x0: _print_string()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 0x4: _print_number()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) The test packages call _print_string() and _print_number()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) as subroutines and expect the main program to print a string
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) or a number to a file or to the screen.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) In "C"-like fashion, the test program calls:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) print_string("Test passed");
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) print_number(20);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) For _print_string(), the test programs pass a longword address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) of the string on the stack. For _print_number(), the test programs pass
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) a longword number to be printed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) For debugging purposes, after the main program performs a "print"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) for a test package, it should flush the output so that it's not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) buffered. In this way, if the test program crashes, at least the previous
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) statements printed will be seen.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) 68060ISP-TEST Entry-points:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) ---------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) 0x0: integer test
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) 68060FPSP-TEST Entry-points:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) ----------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) 0x00: main fp test
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) 0x08: FP unimplemented test
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) 0x10: FP enabled snan/operr/ovfl/unfl/dz/inex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) The floating-point unit test has 3 entry points which will require
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) 3 different calls to the package if each of the three following tests
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) is desired:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) main fp test: tests (1) unimp effective address exception
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) (2) unsupported data type exceptions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) (3) non-maskable overflow/underflow exceptions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) FP unimplemented: tests FP unimplemented exception. this one is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) separate from the previous tests for systems that don't
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) want FP unimplemented instructions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) FP enabled: tests enabled snan/operr/ovfl/unfl/dz/inex.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) basically, it enables each of these exceptions and forces
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) each using an implemented FP instruction. this process
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) exercises _fpsp_{snan,operr,ovfl,unfl,dz,inex}() and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) _real_{snan,operr,ovfl,unfl,dz,inex}(). the test expects
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) _real_XXXX() to do nothing except clear the exception
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) and "rte". if a system's _real_XXXX() handler creates an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) alternate result, the test will print "failed" but this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) is acceptable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) Miscellaneous:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) --------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) Again, itest.sa and ftest.sa are simple tests and do not thoroughly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) test all 68060SP connections. For example, they do not test connections
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) to _real_access(), _real_trace(), _real_trap(), etc. because these
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) will be system-implemented several different ways and the test packages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) must remain system independent.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) Example test package set-up:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) ----------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) _print_str:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) . # provided by system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) rts
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) _print_num:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) . # provided by system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) rts
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) bsr _060FPSP_TEST+128+0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) rts
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) # beginning of "Call-out" section; provided by integrator.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) # MUST be 128 bytes long.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) _060FPSP_TEST:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) long _print_str - _060FPSP_TEST
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) long _print_num - _060FPSP_TEST
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) space 120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) # ftest.sa starts here; start of "Entry-point" section.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) long 0x60ff0000, 0x00002346
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) long 0x60ff0000, 0x00018766
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) long 0x60ff0000, 0x00023338
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) long 0x24377299, 0xab2643ea
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) .
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags