18c2ecf20Sopenharmony_ci~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
28c2ecf20Sopenharmony_ciMOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP
38c2ecf20Sopenharmony_ciM68000 Hi-Performance Microprocessor Division
48c2ecf20Sopenharmony_ciM68060 Software Package
58c2ecf20Sopenharmony_ciProduction Release P1.00 -- October 10, 1994
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_ciM68060 Software Package Copyright © 1993, 1994 Motorola Inc.  All rights reserved.
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ciTHE SOFTWARE is provided on an "AS IS" basis and without warranty.
108c2ecf20Sopenharmony_ciTo the maximum extent permitted by applicable law,
118c2ecf20Sopenharmony_ciMOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED,
128c2ecf20Sopenharmony_ciINCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
138c2ecf20Sopenharmony_ciand any warranty against infringement with regard to the SOFTWARE
148c2ecf20Sopenharmony_ci(INCLUDING ANY MODIFIED VERSIONS THEREOF) and any accompanying written materials.
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_ciTo the maximum extent permitted by applicable law,
178c2ecf20Sopenharmony_ciIN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER
188c2ecf20Sopenharmony_ci(INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,
198c2ecf20Sopenharmony_ciBUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
208c2ecf20Sopenharmony_ciARISING OF THE USE OR INABILITY TO USE THE SOFTWARE.
218c2ecf20Sopenharmony_ciMotorola assumes no responsibility for the maintenance and support of the SOFTWARE.
228c2ecf20Sopenharmony_ci
238c2ecf20Sopenharmony_ciYou are hereby granted a copyright license to use, modify, and distribute the SOFTWARE
248c2ecf20Sopenharmony_ciso long as this entire notice is retained without alteration in any modified and/or
258c2ecf20Sopenharmony_ciredistributed versions, and that such modified versions are clearly identified as such.
268c2ecf20Sopenharmony_ciNo licenses are granted by implication, estoppel or otherwise under any patents
278c2ecf20Sopenharmony_cior trademarks of Motorola, Inc.
288c2ecf20Sopenharmony_ci~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ciCHANGES SINCE LAST RELEASE:
318c2ecf20Sopenharmony_ci---------------------------
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ci1) "movep" emulation where data was being read from memory
348c2ecf20Sopenharmony_ciwas reading the intermediate bytes. Emulation now only
358c2ecf20Sopenharmony_cireads the required bytes.
368c2ecf20Sopenharmony_ci
378c2ecf20Sopenharmony_ci2) "flogn", "flog2", and "flog10" of "1" was setting the
388c2ecf20Sopenharmony_ciInexact FPSR bit. Emulation now does not set Inexact for
398c2ecf20Sopenharmony_cithis case.
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci3) For an opclass three FP instruction where the effective addressing
428c2ecf20Sopenharmony_cimode was pre-decrement or post-increment and the address register
438c2ecf20Sopenharmony_ciwas A0 or A1, the address register was not being updated as a result
448c2ecf20Sopenharmony_ciof the operation. This has been corrected.
458c2ecf20Sopenharmony_ci
468c2ecf20Sopenharmony_ci4) Beta B.2 version had the following erratum:
478c2ecf20Sopenharmony_ci
488c2ecf20Sopenharmony_ci	Scenario:
498c2ecf20Sopenharmony_ci	---------
508c2ecf20Sopenharmony_ci	If {i,d}mem_{read,write}_{byte,word,long}() returns
518c2ecf20Sopenharmony_ci	a failing value to the 68060SP, the package ignores
528c2ecf20Sopenharmony_ci	this return value and continues with program execution
538c2ecf20Sopenharmony_ci	as if it never received a failing value.
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci	Effect:
568c2ecf20Sopenharmony_ci	-------
578c2ecf20Sopenharmony_ci	For example, if a user executed "fsin.x ADDR,fp0" where
588c2ecf20Sopenharmony_ci	ADDR should cause a "segmentation violation", the memory read
598c2ecf20Sopenharmony_ci	requested by the package should return a failing value
608c2ecf20Sopenharmony_ci	to the package. Since the package currently ignores this
618c2ecf20Sopenharmony_ci	return value, the user program will continue to the
628c2ecf20Sopenharmony_ci	next instruction, and the result created in fp0 will be
638c2ecf20Sopenharmony_ci	undefined.
648c2ecf20Sopenharmony_ci
658c2ecf20Sopenharmony_ci	Fix:
668c2ecf20Sopenharmony_ci	----
678c2ecf20Sopenharmony_ci	This has been fixed in the current release.
688c2ecf20Sopenharmony_ci
698c2ecf20Sopenharmony_ci	Notes:
708c2ecf20Sopenharmony_ci	------
718c2ecf20Sopenharmony_ci	Upon receiving a non-zero (failing) return value from
728c2ecf20Sopenharmony_ci	a {i,d}mem_{read,write}_{byte,word,long}() "call-out",
738c2ecf20Sopenharmony_ci	the package creates a 16-byte access error stack frame
748c2ecf20Sopenharmony_ci	from the current exception stack frame and exits
758c2ecf20Sopenharmony_ci	through the "call-out" _real_access(). This is the process
768c2ecf20Sopenharmony_ci	as described in the MC68060 User's Manual.
778c2ecf20Sopenharmony_ci
788c2ecf20Sopenharmony_ci	For instruction read access errors, the info stacked is:
798c2ecf20Sopenharmony_ci		SR	= SR at time of exception
808c2ecf20Sopenharmony_ci		PC	= PC of instruction being emulated
818c2ecf20Sopenharmony_ci		VOFF	= $4008 (stack frame format type)
828c2ecf20Sopenharmony_ci		ADDRESS	= PC of instruction being emulated
838c2ecf20Sopenharmony_ci		FSLW	= FAULT STATUS LONGWORD
848c2ecf20Sopenharmony_ci
858c2ecf20Sopenharmony_ci	The valid FSLW bits are:
868c2ecf20Sopenharmony_ci		bit 27		= 1	(misaligned bit)
878c2ecf20Sopenharmony_ci		bit 24		= 1	(read)
888c2ecf20Sopenharmony_ci		bit 23		= 0	(write)
898c2ecf20Sopenharmony_ci		bit 22:21	= 10	(SIZE = word)
908c2ecf20Sopenharmony_ci		bit 20:19	= 00	(TT)
918c2ecf20Sopenharmony_ci		bit 18:16	= x10	(TM; x = 1 for supervisor mode)
928c2ecf20Sopenharmony_ci		bit 15		= 1	(IO)
938c2ecf20Sopenharmony_ci		bit 0		= 1	(Software Emulation Error)
948c2ecf20Sopenharmony_ci
958c2ecf20Sopenharmony_ci	all other bits are EQUAL TO ZERO and can be set by the _real_access()
968c2ecf20Sopenharmony_ci	"call-out" stub by the user as appropriate. The MC68060 User's Manual
978c2ecf20Sopenharmony_ci	stated that ONLY "bit 0" would be set. The 060SP attempts to set a few
988c2ecf20Sopenharmony_ci	other bits.
998c2ecf20Sopenharmony_ci
1008c2ecf20Sopenharmony_ci	For data read/write access errors, the info stacked is:
1018c2ecf20Sopenharmony_ci		SR	= SR at time of exception
1028c2ecf20Sopenharmony_ci		PC	= PC of instruction being emulated
1038c2ecf20Sopenharmony_ci		VOFF	= $4008 (stack frame format type)
1048c2ecf20Sopenharmony_ci		ADDRESS	= Address of source or destination operand
1058c2ecf20Sopenharmony_ci		FSLW	= FAULT STATUS LONGWORD
1068c2ecf20Sopenharmony_ci
1078c2ecf20Sopenharmony_ci	The valid FSLW bits are:
1088c2ecf20Sopenharmony_ci		bit 27		= 0	(misaligned bit)
1098c2ecf20Sopenharmony_ci		bit 24		= x	(read; 1 if read, 0 if write)
1108c2ecf20Sopenharmony_ci		bit 23		= x	(write; 1 if write, 0 if read)
1118c2ecf20Sopenharmony_ci		bit 22:21	= xx	(SIZE; see MC68060 User's Manual)
1128c2ecf20Sopenharmony_ci		bit 20:19	= 00	(TT)
1138c2ecf20Sopenharmony_ci		bit 18:16	= x01	(TM; x = 1 for supervisor mode)
1148c2ecf20Sopenharmony_ci		bit 15		= 0	(IO)
1158c2ecf20Sopenharmony_ci		bit 0		= 1	(Software Emulation Error)
1168c2ecf20Sopenharmony_ci
1178c2ecf20Sopenharmony_ci	all other bits are EQUAL TO ZERO and can be set by the _real_access()
1188c2ecf20Sopenharmony_ci	"call-out" stub by the user as appropriate. The MC68060 User's Manual
1198c2ecf20Sopenharmony_ci	stated that ONLY "bit 0" would be set. The 060SP attempts to set a few
1208c2ecf20Sopenharmony_ci	other bits.
121