2 # $NetBSD: ilsp.doc,v 1.1 2000/04/14 20:24:39 is Exp $
5 #~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6 # MOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP
7 # M68000 Hi-Performance Microprocessor Division
8 # M68060 Software Package Production Release
10 # M68060 Software Package Copyright (C) 1993, 1994, 1995, 1996 Motorola Inc.
11 # All rights reserved.
13 # THE SOFTWARE is provided on an "AS IS" basis and without warranty.
14 # To the maximum extent permitted by applicable law,
15 # MOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED,
16 # INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
17 # FOR A PARTICULAR PURPOSE and any warranty against infringement with
18 # regard to the SOFTWARE (INCLUDING ANY MODIFIED VERSIONS THEREOF)
19 # and any accompanying written materials.
21 # To the maximum extent permitted by applicable law,
22 # IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER
23 # (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,
24 # BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
25 # ARISING OF THE USE OR INABILITY TO USE THE SOFTWARE.
27 # Motorola assumes no responsibility for the maintenance and support
30 # You are hereby granted a copyright license to use, modify, and distribute the
31 # SOFTWARE so long as this entire notice is retained without alteration
32 # in any modified and/or redistributed versions, and that such modified
33 # versions are clearly identified as such.
34 # No licenses are granted by implication, estoppel or otherwise under any
35 # patents or trademarks of Motorola, Inc.
36 #~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38 68060 INTEGER SOFTWARE PACKAGE (Library version)
39 -------------------------------------------------
41 The file ilsp.s contains the "Library version" of the
42 68060 Integer Software Package. Routines included in this
43 module can be used to emulate 64-bit divide and multiply,
44 and the "cmp2" instruction. These instructions are not
45 implemented in hardware on the 68060 and normally take
46 exception vector #61 "Unimplemented Integer Instruction".
48 By re-compiling a program that uses these instructions, and
49 making subroutine calls in place of the unimplemented
50 instructions, a program can avoid the overhead associated with
55 The file ilsp.sa is essentially a hexadecimal image of the
56 release package. This is the ONLY format which will be supported.
57 The hex image was created by assembling the source code and
58 then converting the resulting binary output image into an
59 ASCII text file. The hexadecimal numbers are listed
60 using the Motorola Assembly Syntax assembler directive "dc.l"
61 (define constant longword). The file can be converted to other
62 assembly syntaxes by using any word processor with a global
63 search and replace function.
65 To assist in assembling and linking this module with other modules,
66 the installer should add a symbolic label to the top of the file.
67 This will allow calling routines to access the entry points
70 The source code ilsp.s has also been included but only for
71 documentation purposes.
73 Release file structure:
74 -----------------------
75 The file ilsp.sa contains an "Entry-Point" section and a
76 code section. The ILSP has no "Call-Out" section. The first section
77 is the "Entry-Point" section. In order to access a function in the
78 package, a program must "bsr" or "jsr" to the location listed
79 below in "68060ILSP Entry Points" that corresponds to the desired
80 function. A branch instruction located at the selected entry point
81 within the package will then enter the correct emulation code routine.
83 The entry point addresses at the beginning of the package will remain
84 fixed so that a program calling the routines will not have to be
85 re-compiled with every new 68060ILSP release.
87 For example, to use a 64-bit multiply instruction,
88 do a "bsr" or "jsr" to the entry point defined by
89 the 060ILSP entry table. A compiler generated code sequence
90 for unsigned multiply could look like:
93 # mulu.l _multiplier,%d1:%d0
95 subq.l &0x8,%sp # make room for result on stack
96 pea (%sp) # pass: result addr on stack
97 mov.l %d0,-(%sp) # pass: multiplicand on stack
98 mov.l _multiplier,-(%sp) # pass: multiplier on stack
99 bsr.l _060LISP_TOP+0x18 # branch to multiply routine
100 add.l &0xc,%sp # clear arguments from stack
101 mov.l (%sp)+,%d1 # load result[63:32]
102 mov.l (%sp)+,%d0 # load result[31:0]
107 # divu.l _divisor,%d1:%d0
109 subq.l &0x8,%sp # make room for result on stack
110 pea (%sp) # pass: result addr on stack
111 mov.l %d0,-(%sp) # pass: dividend hi on stack
112 mov.l %d1,-(%sp) # pass: dividend hi on stack
113 mov.l _divisor,-(%sp) # pass: divisor on stack
114 bsr.l _060LISP_TOP+0x08 # branch to divide routine
115 add.l &0xc,%sp # clear arguments from stack
116 mov.l (%sp)+,%d1 # load remainder
117 mov.l (%sp)+,%d0 # load quotient
119 The library routines also return the correct condition code
120 register value. If this is important, then the caller of the library
121 routine must make sure that the value isn't lost while popping
122 other items off of the stack.
124 An example of using the "cmp2" instruction is as follows:
129 pea _bounds # pass ptr to bounds
130 mov.l %d0,-(%sp) # pass Rn
131 bsr.l _060LSP_TOP_+0x48 # branch to "cmp2" routine
132 mov.w %cc,_tmp # save off condition codes
133 addq.l &0x8,%sp # clear arguments from stack
137 If the instruction being emulated is a divide and the source
138 operand is a zero, then the library routine, as it's last
139 instruction, executes an implemented divide using a zero
140 source operand so that an "Integer Divide-by-Zero" exception
141 will be taken. Although the exception stack frame will not
142 point to the correct instruction, the user will at least be able
143 to record that such an event occurred if desired.
145 68060ILSP entry points:
146 -----------------------
148 0x000: _060LSP__idivs64_
149 0x008: _060LSP__idivu64_
151 0x010: _060LSP__imuls64_
152 0x018: _060LSP__imulu64_
154 0x020: _060LSP__cmp2_Ab_
155 0x028: _060LSP__cmp2_Aw_
156 0x030: _060LSP__cmp2_Al_
157 0x038: _060LSP__cmp2_Db_
158 0x040: _060LSP__cmp2_Dw_
159 0x048: _060LSP__cmp2_Dl_