fskeleton.S (10691B)
1|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 2|MOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP 3|M68000 Hi-Performance Microprocessor Division 4|M68060 Software Package 5|Production Release P1.00 -- October 10, 1994 6| 7|M68060 Software Package Copyright © 1993, 1994 Motorola Inc. All rights reserved. 8| 9|THE SOFTWARE is provided on an "AS IS" basis and without warranty. 10|To the maximum extent permitted by applicable law, 11|MOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED, 12|INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE 13|and any warranty against infringement with regard to the SOFTWARE 14|(INCLUDING ANY MODIFIED VERSIONS THEREOF) and any accompanying written materials. 15| 16|To the maximum extent permitted by applicable law, 17|IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER 18|(INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, 19|BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) 20|ARISING OF THE USE OR INABILITY TO USE THE SOFTWARE. 21|Motorola assumes no responsibility for the maintenance and support of the SOFTWARE. 22| 23|You are hereby granted a copyright license to use, modify, and distribute the SOFTWARE 24|so long as this entire notice is retained without alteration in any modified and/or 25|redistributed versions, and that such modified versions are clearly identified as such. 26|No licenses are granted by implication, estoppel or otherwise under any patents 27|or trademarks of Motorola, Inc. 28|~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 29| fskeleton.s 30| 31| This file contains: 32| (1) example "Call-out"s 33| (2) example package entry code 34| (3) example "Call-out" table 35| 36 37#include <linux/linkage.h> 38 39|################################ 40| (1) EXAMPLE CALL-OUTS # 41| # 42| _060_fpsp_done() # 43| _060_real_ovfl() # 44| _060_real_unfl() # 45| _060_real_operr() # 46| _060_real_snan() # 47| _060_real_dz() # 48| _060_real_inex() # 49| _060_real_bsun() # 50| _060_real_fline() # 51| _060_real_fpu_disabled() # 52| _060_real_trap() # 53|################################ 54 55| 56| _060_fpsp_done(): 57| 58| This is the main exit point for the 68060 Floating-Point 59| Software Package. For a normal exit, all 060FPSP routines call this 60| routine. The operating system can do system dependent clean-up or 61| simply execute an "rte" as with the sample code below. 62| 63 .global _060_fpsp_done 64_060_fpsp_done: 65 bral _060_isp_done | do the same as isp_done 66 67| 68| _060_real_ovfl(): 69| 70| This is the exit point for the 060FPSP when an enabled overflow exception 71| is present. The routine below should point to the operating system handler 72| for enabled overflow conditions. The exception stack frame is an overflow 73| stack frame. The FP state frame holds the EXCEPTIONAL OPERAND. 74| 75| The sample routine below simply clears the exception status bit and 76| does an "rte". 77| 78 .global _060_real_ovfl 79_060_real_ovfl: 80 fsave -(%sp) 81 move.w #0x6000,0x2(%sp) 82 frestore (%sp)+ 83 bral trap | jump to trap handler 84 85 86| 87| _060_real_unfl(): 88| 89| This is the exit point for the 060FPSP when an enabled underflow exception 90| is present. The routine below should point to the operating system handler 91| for enabled underflow conditions. The exception stack frame is an underflow 92| stack frame. The FP state frame holds the EXCEPTIONAL OPERAND. 93| 94| The sample routine below simply clears the exception status bit and 95| does an "rte". 96| 97 .global _060_real_unfl 98_060_real_unfl: 99 fsave -(%sp) 100 move.w #0x6000,0x2(%sp) 101 frestore (%sp)+ 102 bral trap | jump to trap handler 103 104| 105| _060_real_operr(): 106| 107| This is the exit point for the 060FPSP when an enabled operand error exception 108| is present. The routine below should point to the operating system handler 109| for enabled operand error exceptions. The exception stack frame is an operand error 110| stack frame. The FP state frame holds the source operand of the faulting 111| instruction. 112| 113| The sample routine below simply clears the exception status bit and 114| does an "rte". 115| 116 .global _060_real_operr 117_060_real_operr: 118 fsave -(%sp) 119 move.w #0x6000,0x2(%sp) 120 frestore (%sp)+ 121 bral trap | jump to trap handler 122 123| 124| _060_real_snan(): 125| 126| This is the exit point for the 060FPSP when an enabled signalling NaN exception 127| is present. The routine below should point to the operating system handler 128| for enabled signalling NaN exceptions. The exception stack frame is a signalling NaN 129| stack frame. The FP state frame holds the source operand of the faulting 130| instruction. 131| 132| The sample routine below simply clears the exception status bit and 133| does an "rte". 134| 135 .global _060_real_snan 136_060_real_snan: 137 fsave -(%sp) 138 move.w #0x6000,0x2(%sp) 139 frestore (%sp)+ 140 bral trap | jump to trap handler 141 142| 143| _060_real_dz(): 144| 145| This is the exit point for the 060FPSP when an enabled divide-by-zero exception 146| is present. The routine below should point to the operating system handler 147| for enabled divide-by-zero exceptions. The exception stack frame is a divide-by-zero 148| stack frame. The FP state frame holds the source operand of the faulting 149| instruction. 150| 151| The sample routine below simply clears the exception status bit and 152| does an "rte". 153| 154 .global _060_real_dz 155_060_real_dz: 156 fsave -(%sp) 157 move.w #0x6000,0x2(%sp) 158 frestore (%sp)+ 159 bral trap | jump to trap handler 160 161| 162| _060_real_inex(): 163| 164| This is the exit point for the 060FPSP when an enabled inexact exception 165| is present. The routine below should point to the operating system handler 166| for enabled inexact exceptions. The exception stack frame is an inexact 167| stack frame. The FP state frame holds the source operand of the faulting 168| instruction. 169| 170| The sample routine below simply clears the exception status bit and 171| does an "rte". 172| 173 .global _060_real_inex 174_060_real_inex: 175 fsave -(%sp) 176 move.w #0x6000,0x2(%sp) 177 frestore (%sp)+ 178 bral trap | jump to trap handler 179 180| 181| _060_real_bsun(): 182| 183| This is the exit point for the 060FPSP when an enabled bsun exception 184| is present. The routine below should point to the operating system handler 185| for enabled bsun exceptions. The exception stack frame is a bsun 186| stack frame. 187| 188| The sample routine below clears the exception status bit, clears the NaN 189| bit in the FPSR, and does an "rte". The instruction that caused the 190| bsun will now be re-executed but with the NaN FPSR bit cleared. 191| 192 .global _060_real_bsun 193_060_real_bsun: 194| fsave -(%sp) 195 196 fmove.l %fpsr,-(%sp) 197 andi.b #0xfe,(%sp) 198 fmove.l (%sp)+,%fpsr 199 200 bral trap | jump to trap handler 201 202| 203| _060_real_fline(): 204| 205| This is the exit point for the 060FPSP when an F-Line Illegal exception is 206| encountered. Three different types of exceptions can enter the F-Line exception 207| vector number 11: FP Unimplemented Instructions, FP implemented instructions when 208| the FPU is disabled, and F-Line Illegal instructions. The 060FPSP module 209| _fpsp_fline() distinguishes between the three and acts appropriately. F-Line 210| Illegals branch here. 211| 212 .global _060_real_fline 213_060_real_fline: 214 bral trap | jump to trap handler 215 216| 217| _060_real_fpu_disabled(): 218| 219| This is the exit point for the 060FPSP when an FPU disabled exception is 220| encountered. Three different types of exceptions can enter the F-Line exception 221| vector number 11: FP Unimplemented Instructions, FP implemented instructions when 222| the FPU is disabled, and F-Line Illegal instructions. The 060FPSP module 223| _fpsp_fline() distinguishes between the three and acts appropriately. FPU disabled 224| exceptions branch here. 225| 226| The sample code below enables the FPU, sets the PC field in the exception stack 227| frame to the PC of the instruction causing the exception, and does an "rte". 228| The execution of the instruction then proceeds with an enabled floating-point 229| unit. 230| 231 .global _060_real_fpu_disabled 232_060_real_fpu_disabled: 233 move.l %d0,-(%sp) | enabled the fpu 234 .long 0x4E7A0808 |movec pcr,%d0 235 bclr #0x1,%d0 236 .long 0x4E7B0808 |movec %d0,pcr 237 move.l (%sp)+,%d0 238 239 move.l 0xc(%sp),0x2(%sp) | set "Current PC" 240 rte 241 242| 243| _060_real_trap(): 244| 245| This is the exit point for the 060FPSP when an emulated "ftrapcc" instruction 246| discovers that the trap condition is true and it should branch to the operating 247| system handler for the trap exception vector number 7. 248| 249| The sample code below simply executes an "rte". 250| 251 .global _060_real_trap 252_060_real_trap: 253 bral trap | jump to trap handler 254 255|############################################################################ 256 257|################################# 258| (2) EXAMPLE PACKAGE ENTRY CODE # 259|################################# 260 261 .global _060_fpsp_snan 262_060_fpsp_snan: 263 bra.l _FP_CALL_TOP+0x80+0x00 264 265 .global _060_fpsp_operr 266_060_fpsp_operr: 267 bra.l _FP_CALL_TOP+0x80+0x08 268 269 .global _060_fpsp_ovfl 270_060_fpsp_ovfl: 271 bra.l _FP_CALL_TOP+0x80+0x10 272 273 .global _060_fpsp_unfl 274_060_fpsp_unfl: 275 bra.l _FP_CALL_TOP+0x80+0x18 276 277 .global _060_fpsp_dz 278_060_fpsp_dz: 279 bra.l _FP_CALL_TOP+0x80+0x20 280 281 .global _060_fpsp_inex 282_060_fpsp_inex: 283 bra.l _FP_CALL_TOP+0x80+0x28 284 285 .global _060_fpsp_fline 286_060_fpsp_fline: 287 bra.l _FP_CALL_TOP+0x80+0x30 288 289 .global _060_fpsp_unsupp 290_060_fpsp_unsupp: 291 bra.l _FP_CALL_TOP+0x80+0x38 292 293 .global _060_fpsp_effadd 294_060_fpsp_effadd: 295 bra.l _FP_CALL_TOP+0x80+0x40 296 297|############################################################################ 298 299|############################### 300| (3) EXAMPLE CALL-OUT SECTION # 301|############################### 302 303| The size of this section MUST be 128 bytes!!! 304 305_FP_CALL_TOP: 306 .long _060_real_bsun - _FP_CALL_TOP 307 .long _060_real_snan - _FP_CALL_TOP 308 .long _060_real_operr - _FP_CALL_TOP 309 .long _060_real_ovfl - _FP_CALL_TOP 310 .long _060_real_unfl - _FP_CALL_TOP 311 .long _060_real_dz - _FP_CALL_TOP 312 .long _060_real_inex - _FP_CALL_TOP 313 .long _060_real_fline - _FP_CALL_TOP 314 .long _060_real_fpu_disabled - _FP_CALL_TOP 315 .long _060_real_trap - _FP_CALL_TOP 316 .long _060_real_trace - _FP_CALL_TOP 317 .long _060_real_access - _FP_CALL_TOP 318 .long _060_fpsp_done - _FP_CALL_TOP 319 320 .long 0x00000000, 0x00000000, 0x00000000 321 322 .long _060_imem_read - _FP_CALL_TOP 323 .long _060_dmem_read - _FP_CALL_TOP 324 .long _060_dmem_write - _FP_CALL_TOP 325 .long _060_imem_read_word - _FP_CALL_TOP 326 .long _060_imem_read_long - _FP_CALL_TOP 327 .long _060_dmem_read_byte - _FP_CALL_TOP 328 .long _060_dmem_read_word - _FP_CALL_TOP 329 .long _060_dmem_read_long - _FP_CALL_TOP 330 .long _060_dmem_write_byte - _FP_CALL_TOP 331 .long _060_dmem_write_word - _FP_CALL_TOP 332 .long _060_dmem_write_long - _FP_CALL_TOP 333 334 .long 0x00000000 335 336 .long 0x00000000, 0x00000000, 0x00000000, 0x00000000 337 338|############################################################################ 339 340| 060 FPSP KERNEL PACKAGE NEEDS TO GO HERE!!! 341 342#include "fpsp.sa"