1da177e4c3
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
231 lines
7.8 KiB
Text
231 lines
7.8 KiB
Text
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
MOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP
|
|
M68000 Hi-Performance Microprocessor Division
|
|
M68060 Software Package
|
|
Production Release P1.00 -- October 10, 1994
|
|
|
|
M68060 Software Package Copyright © 1993, 1994 Motorola Inc. All rights reserved.
|
|
|
|
THE SOFTWARE is provided on an "AS IS" basis and without warranty.
|
|
To the maximum extent permitted by applicable law,
|
|
MOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED,
|
|
INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
|
|
and any warranty against infringement with regard to the SOFTWARE
|
|
(INCLUDING ANY MODIFIED VERSIONS THEREOF) and any accompanying written materials.
|
|
|
|
To the maximum extent permitted by applicable law,
|
|
IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER
|
|
(INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,
|
|
BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
|
|
ARISING OF THE USE OR INABILITY TO USE THE SOFTWARE.
|
|
Motorola assumes no responsibility for the maintenance and support of the SOFTWARE.
|
|
|
|
You are hereby granted a copyright license to use, modify, and distribute the SOFTWARE
|
|
so long as this entire notice is retained without alteration in any modified and/or
|
|
redistributed versions, and that such modified versions are clearly identified as such.
|
|
No licenses are granted by implication, estoppel or otherwise under any patents
|
|
or trademarks of Motorola, Inc.
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
68060 FLOATING-POINT SOFTWARE PACKAGE (Library version)
|
|
--------------------------------------------------------
|
|
|
|
The file fplsp.sa contains the "Library version" of the
|
|
68060SP Floating-Point Software Package. The routines
|
|
included in this module can be used to emulate the
|
|
FP instructions not implemented in 68060 hardware. These
|
|
instructions normally take exception vector #11
|
|
"FP Unimplemented Instruction".
|
|
|
|
By re-compiling a program that uses these instructions, and
|
|
making subroutine calls in place of the unimplemented
|
|
instructions, a program can avoid the overhead associated
|
|
with taking the exception.
|
|
|
|
Release file format:
|
|
--------------------
|
|
The file fplsp.sa is essentially a hexadecimal image of the
|
|
release package. This is the ONLY format which will be supported.
|
|
The hex image was created by assembling the source code and
|
|
then converting the resulting binary output image into an
|
|
ASCII text file. The hexadecimal numbers are listed
|
|
using the Motorola Assembly Syntax assembler directive "dc.l"
|
|
(define constant longword). The file can be converted to other
|
|
assembly syntaxes by using any word processor with a global
|
|
search and replace function.
|
|
|
|
To assist in assembling and linking this module with other modules,
|
|
the installer should add a symbolic label to the top of the file.
|
|
This will allow calling routines to access the entry points
|
|
of this package.
|
|
|
|
The source code fplsp.s has also been included but only for
|
|
documentation purposes.
|
|
|
|
Release file structure:
|
|
-----------------------
|
|
The file fplsp.sa contains an "Entry-Point" section and a
|
|
code section. The FPLSP has no "Call-Out" section. The first section
|
|
is the "Entry-Point" section. In order to access a function in the
|
|
package, a program must "bsr" or "jsr" to the location listed
|
|
below in "68060FPLSP entry points" that corresponds to the desired
|
|
function. A branch instruction located at the selected entry point
|
|
within the package will then enter the correct emulation code routine.
|
|
|
|
The entry point addresses at the beginning of the package will remain
|
|
fixed so that a program calling the routines will not have to be
|
|
re-compiled with every new 68060FPLSP release.
|
|
|
|
There are 3 entry-points for each instruction type: single precision,
|
|
double precision, and extended precision.
|
|
|
|
As an example, the "fsin" library instruction can be passed an
|
|
extended precision operand if program executes:
|
|
|
|
# fsin.x fp0
|
|
|
|
fmovm.x &0x01,-(%sp) # pass operand on stack
|
|
bsr.l _060FPLSP_TOP+0x1a8 # branch to fsin routine
|
|
add.l &0xc,%sp # clear operand from stack
|
|
|
|
Upon return, fp0 holds the correct result. The FPSR is
|
|
set correctly. The FPCR is unchanged. The FPIAR is undefined.
|
|
|
|
Another example. This time, a dyadic operation:
|
|
|
|
# frem.s %fp1,%fp0
|
|
|
|
fmov.s %fp1,-(%sp) # pass src operand
|
|
fmov.s %fp0,-(%sp) # pass dst operand
|
|
bsr.l _060FPLSP_TOP+0x168 # branch to frem routine
|
|
addq.l &0x8,%sp # clear operands from stack
|
|
|
|
Again, the result is returned in fp0. Note that BOTH operands
|
|
are passed in single precision format.
|
|
|
|
Exception reporting:
|
|
--------------------
|
|
The package takes exceptions according to the FPCR value upon subroutine
|
|
entry. If an exception should be reported, then the package forces
|
|
this exception using implemented floating-point instructions.
|
|
For example, if the instruction being emulated should cause a
|
|
floating-point Operand Error exception, then the library routine
|
|
executes an FMUL of a zero and an infinity to force the OPERR
|
|
exception. Although the FPIAR will be undefined for the enabled
|
|
Operand Error exception handler, the user will at least be able
|
|
to record that the event occurred.
|
|
|
|
Miscellaneous:
|
|
--------------
|
|
The package does not attempt to correctly emulate instructions
|
|
with Signalling NAN inputs. Use of SNANs should be avoided with
|
|
this package.
|
|
|
|
The fabs/fadd/fdiv/fint/fintrz/fmul/fneg/fsqrt/fsub entry points
|
|
are provided for the convenience of older compilers that make
|
|
subroutine calls for all fp instructions. The code does NOT emulate
|
|
the instruction but rather simply executes it.
|
|
|
|
68060FPLSP entry points:
|
|
------------------------
|
|
_060FPLSP_TOP:
|
|
0x000: _060LSP__facoss_
|
|
0x008: _060LSP__facosd_
|
|
0x010: _060LSP__facosx_
|
|
0x018: _060LSP__fasins_
|
|
0x020: _060LSP__fasind_
|
|
0x028: _060LSP__fasinx_
|
|
0x030: _060LSP__fatans_
|
|
0x038: _060LSP__fatand_
|
|
0x040: _060LSP__fatanx_
|
|
0x048: _060LSP__fatanhs_
|
|
0x050: _060LSP__fatanhd_
|
|
0x058: _060LSP__fatanhx_
|
|
0x060: _060LSP__fcoss_
|
|
0x068: _060LSP__fcosd_
|
|
0x070: _060LSP__fcosx_
|
|
0x078: _060LSP__fcoshs_
|
|
0x080: _060LSP__fcoshd_
|
|
0x088: _060LSP__fcoshx_
|
|
0x090: _060LSP__fetoxs_
|
|
0x098: _060LSP__fetoxd_
|
|
0x0a0: _060LSP__fetoxx_
|
|
0x0a8: _060LSP__fetoxm1s_
|
|
0x0b0: _060LSP__fetoxm1d_
|
|
0x0b8: _060LSP__fetoxm1x_
|
|
0x0c0: _060LSP__fgetexps_
|
|
0x0c8: _060LSP__fgetexpd_
|
|
0x0d0: _060LSP__fgetexpx_
|
|
0x0d8: _060LSP__fgetmans_
|
|
0x0e0: _060LSP__fgetmand_
|
|
0x0e8: _060LSP__fgetmanx_
|
|
0x0f0: _060LSP__flog10s_
|
|
0x0f8: _060LSP__flog10d_
|
|
0x100: _060LSP__flog10x_
|
|
0x108: _060LSP__flog2s_
|
|
0x110: _060LSP__flog2d_
|
|
0x118: _060LSP__flog2x_
|
|
0x120: _060LSP__flogns_
|
|
0x128: _060LSP__flognd_
|
|
0x130: _060LSP__flognx_
|
|
0x138: _060LSP__flognp1s_
|
|
0x140: _060LSP__flognp1d_
|
|
0x148: _060LSP__flognp1x_
|
|
0x150: _060LSP__fmods_
|
|
0x158: _060LSP__fmodd_
|
|
0x160: _060LSP__fmodx_
|
|
0x168: _060LSP__frems_
|
|
0x170: _060LSP__fremd_
|
|
0x178: _060LSP__fremx_
|
|
0x180: _060LSP__fscales_
|
|
0x188: _060LSP__fscaled_
|
|
0x190: _060LSP__fscalex_
|
|
0x198: _060LSP__fsins_
|
|
0x1a0: _060LSP__fsind_
|
|
0x1a8: _060LSP__fsinx_
|
|
0x1b0: _060LSP__fsincoss_
|
|
0x1b8: _060LSP__fsincosd_
|
|
0x1c0: _060LSP__fsincosx_
|
|
0x1c8: _060LSP__fsinhs_
|
|
0x1d0: _060LSP__fsinhd_
|
|
0x1d8: _060LSP__fsinhx_
|
|
0x1e0: _060LSP__ftans_
|
|
0x1e8: _060LSP__ftand_
|
|
0x1f0: _060LSP__ftanx_
|
|
0x1f8: _060LSP__ftanhs_
|
|
0x200: _060LSP__ftanhd_
|
|
0x208: _060LSP__ftanhx_
|
|
0x210: _060LSP__ftentoxs_
|
|
0x218: _060LSP__ftentoxd_
|
|
0x220: _060LSP__ftentoxx_
|
|
0x228: _060LSP__ftwotoxs_
|
|
0x230: _060LSP__ftwotoxd_
|
|
0x238: _060LSP__ftwotoxx_
|
|
|
|
0x240: _060LSP__fabss_
|
|
0x248: _060LSP__fabsd_
|
|
0x250: _060LSP__fabsx_
|
|
0x258: _060LSP__fadds_
|
|
0x260: _060LSP__faddd_
|
|
0x268: _060LSP__faddx_
|
|
0x270: _060LSP__fdivs_
|
|
0x278: _060LSP__fdivd_
|
|
0x280: _060LSP__fdivx_
|
|
0x288: _060LSP__fints_
|
|
0x290: _060LSP__fintd_
|
|
0x298: _060LSP__fintx_
|
|
0x2a0: _060LSP__fintrzs_
|
|
0x2a8: _060LSP__fintrzd_
|
|
0x2b0: _060LSP__fintrzx_
|
|
0x2b8: _060LSP__fmuls_
|
|
0x2c0: _060LSP__fmuld_
|
|
0x2c8: _060LSP__fmulx_
|
|
0x2d0: _060LSP__fnegs_
|
|
0x2d8: _060LSP__fnegd_
|
|
0x2e0: _060LSP__fnegx_
|
|
0x2e8: _060LSP__fsqrts_
|
|
0x2f0: _060LSP__fsqrtd_
|
|
0x2f8: _060LSP__fsqrtx_
|
|
0x300: _060LSP__fsubs_
|
|
0x308: _060LSP__fsubd_
|
|
0x310: _060LSP__fsubx_
|