75 lines · plain
1Introduction2============3 4This directory contains the version 0.92 test release of the NetWinder5Floating Point Emulator.6 7The majority of the code was written by me, Scott Bambrough It is8written in C, with a small number of routines in inline assembler9where required. It was written quickly, with a goal of implementing a10working version of all the floating point instructions the compiler11emits as the first target. I have attempted to be as optimal as12possible, but there remains much room for improvement.13 14I have attempted to make the emulator as portable as possible. One of15the problems is with leading underscores on kernel symbols. Elf16kernels have no leading underscores, a.out compiled kernels do. I17have attempted to use the C_SYMBOL_NAME macro wherever this may be18important.19 20Another choice I made was in the file structure. I have attempted to21contain all operating system specific code in one module (fpmodule.*).22All the other files contain emulator specific code. This should allow23others to port the emulator to NetBSD for instance relatively easily.24 25The floating point operations are based on SoftFloat Release 2, by26John Hauser. SoftFloat is a software implementation of floating-point27that conforms to the IEC/IEEE Standard for Binary Floating-point28Arithmetic. As many as four formats are supported: single precision,29double precision, extended double precision, and quadruple precision.30All operations required by the standard are implemented, except for31conversions to and from decimal. We use only the single precision,32double precision and extended double precision formats. The port of33SoftFloat to the ARM was done by Phil Blundell, based on an earlier34port of SoftFloat version 1 by Neil Carson for NetBSD/arm32.35 36The file README.FPE contains a description of what has been implemented37so far in the emulator. The file TODO contains a information on what38remains to be done, and other ideas for the emulator.39 40Bug reports, comments, suggestions should be directed to me at41<scottb@netwinder.org>. General reports of "this program doesn't42work correctly when your emulator is installed" are useful for43determining that bugs still exist; but are virtually useless when44attempting to isolate the problem. Please report them, but don't45expect quick action. Bugs still exist. The problem remains in isolating46which instruction contains the bug. Small programs illustrating a specific47problem are a godsend.48 49Legal Notices50-------------51 52The NetWinder Floating Point Emulator is free software. Everything Rebel.com53has written is provided under the GNU GPL. See the file COPYING for copying54conditions. Excluded from the above is the SoftFloat code. John Hauser's55legal notice for SoftFloat is included below.56 57-------------------------------------------------------------------------------58 59SoftFloat Legal Notice60 61SoftFloat was written by John R. Hauser. This work was made possible in62part by the International Computer Science Institute, located at Suite 600,631947 Center Street, Berkeley, California 94704. Funding was partially64provided by the National Science Foundation under grant MIP-9311980. The65original version of this code was written as part of a project to build66a fixed-point vector processor in collaboration with the University of67California at Berkeley, overseen by Profs. Nelson Morgan and John Wawrzynek.68 69THIS SOFTWARE IS DISTRIBUTED AS IS, FOR FREE. Although reasonable effort70has been made to avoid it, THIS SOFTWARE MAY CONTAIN FAULTS THAT WILL AT71TIMES RESULT IN INCORRECT BEHAVIOR. USE OF THIS SOFTWARE IS RESTRICTED TO72PERSONS AND ORGANIZATIONS WHO CAN AND WILL TAKE FULL RESPONSIBILITY FOR ANY73AND ALL LOSSES, COSTS, OR OTHER PROBLEMS ARISING FROM ITS USE.74-------------------------------------------------------------------------------75