Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | | |
| 2 | | fpsp.h 3.3 3.3 |
| 3 | | |
| 4 | |
| 5 | | Copyright (C) Motorola, Inc. 1990 |
| 6 | | All Rights Reserved |
| 7 | | |
Matt Waddel | e00d82d | 2006-02-11 17:55:48 -0800 | [diff] [blame] | 8 | | For details on the license for this file, please see the |
| 9 | | file, README, in this same directory. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 10 | |
| 11 | | fpsp.h --- stack frame offsets during FPSP exception handling |
| 12 | | |
| 13 | | These equates are used to access the exception frame, the fsave |
| 14 | | frame and any local variables needed by the FPSP package. |
| 15 | | |
| 16 | | All FPSP handlers begin by executing: |
| 17 | | |
| 18 | | link a6,#-LOCAL_SIZE |
| 19 | | fsave -(a7) |
| 20 | | movem.l d0-d1/a0-a1,USER_DA(a6) |
| 21 | | fmovem.x fp0-fp3,USER_FP0(a6) |
| 22 | | fmove.l fpsr/fpcr/fpiar,USER_FPSR(a6) |
| 23 | | |
| 24 | | After initialization, the stack looks like this: |
| 25 | | |
| 26 | | A7 ---> +-------------------------------+ |
| 27 | | | | |
| 28 | | | FPU fsave area | |
| 29 | | | | |
| 30 | | +-------------------------------+ |
| 31 | | | | |
| 32 | | | FPSP Local Variables | |
| 33 | | | including | |
| 34 | | | saved registers | |
| 35 | | | | |
| 36 | | +-------------------------------+ |
| 37 | | A6 ---> | Saved A6 | |
| 38 | | +-------------------------------+ |
| 39 | | | | |
| 40 | | | Exception Frame | |
| 41 | | | | |
| 42 | | | | |
| 43 | | |
| 44 | | Positive offsets from A6 refer to the exception frame. Negative |
| 45 | | offsets refer to the Local Variable area and the fsave area. |
| 46 | | The fsave frame is also accessible from the top via A7. |
| 47 | | |
| 48 | | On exit, the handlers execute: |
| 49 | | |
| 50 | | movem.l USER_DA(a6),d0-d1/a0-a1 |
| 51 | | fmovem.x USER_FP0(a6),fp0-fp3 |
| 52 | | fmove.l USER_FPSR(a6),fpsr/fpcr/fpiar |
| 53 | | frestore (a7)+ |
| 54 | | unlk a6 |
| 55 | | |
| 56 | | and then either "bra fpsp_done" if the exception was completely |
| 57 | | handled by the package, or "bra real_xxxx" which is an external |
| 58 | | label to a routine that will process a real exception of the |
| 59 | | type that was generated. Some handlers may omit the "frestore" |
| 60 | | if the FPU state after the exception is idle. |
| 61 | | |
| 62 | | Sometimes the exception handler will transform the fsave area |
| 63 | | because it needs to report an exception back to the user. This |
| 64 | | can happen if the package is entered for an unimplemented float |
| 65 | | instruction that generates (say) an underflow. Alternatively, |
| 66 | | a second fsave frame can be pushed onto the stack and the |
| 67 | | handler exit code will reload the new frame and discard the old. |
| 68 | | |
| 69 | | The registers d0, d1, a0, a1 and fp0-fp3 are always saved and |
| 70 | | restored from the "local variable" area and can be used as |
| 71 | | temporaries. If a routine needs to change any |
| 72 | | of these registers, it should modify the saved copy and let |
| 73 | | the handler exit code restore the value. |
| 74 | | |
| 75 | |---------------------------------------------------------------------- |
| 76 | | |
| 77 | | Local Variables on the stack |
| 78 | | |
| 79 | .set LOCAL_SIZE,192 | bytes needed for local variables |
| 80 | .set LV,-LOCAL_SIZE | convenient base value |
| 81 | | |
| 82 | .set USER_DA,LV+0 | save space for D0-D1,A0-A1 |
| 83 | .set USER_D0,LV+0 | saved user D0 |
| 84 | .set USER_D1,LV+4 | saved user D1 |
| 85 | .set USER_A0,LV+8 | saved user A0 |
| 86 | .set USER_A1,LV+12 | saved user A1 |
| 87 | .set USER_FP0,LV+16 | saved user FP0 |
| 88 | .set USER_FP1,LV+28 | saved user FP1 |
| 89 | .set USER_FP2,LV+40 | saved user FP2 |
| 90 | .set USER_FP3,LV+52 | saved user FP3 |
| 91 | .set USER_FPCR,LV+64 | saved user FPCR |
| 92 | .set FPCR_ENABLE,USER_FPCR+2 | FPCR exception enable |
| 93 | .set FPCR_MODE,USER_FPCR+3 | FPCR rounding mode control |
| 94 | .set USER_FPSR,LV+68 | saved user FPSR |
| 95 | .set FPSR_CC,USER_FPSR+0 | FPSR condition code |
| 96 | .set FPSR_QBYTE,USER_FPSR+1 | FPSR quotient |
| 97 | .set FPSR_EXCEPT,USER_FPSR+2 | FPSR exception |
| 98 | .set FPSR_AEXCEPT,USER_FPSR+3 | FPSR accrued exception |
| 99 | .set USER_FPIAR,LV+72 | saved user FPIAR |
| 100 | .set FP_SCR1,LV+76 | room for a temporary float value |
| 101 | .set FP_SCR2,LV+92 | room for a temporary float value |
| 102 | .set L_SCR1,LV+108 | room for a temporary long value |
| 103 | .set L_SCR2,LV+112 | room for a temporary long value |
| 104 | .set STORE_FLG,LV+116 |
| 105 | .set BINDEC_FLG,LV+117 | used in bindec |
| 106 | .set DNRM_FLG,LV+118 | used in res_func |
| 107 | .set RES_FLG,LV+119 | used in res_func |
| 108 | .set DY_MO_FLG,LV+120 | dyadic/monadic flag |
| 109 | .set UFLG_TMP,LV+121 | temporary for uflag errata |
| 110 | .set CU_ONLY,LV+122 | cu-only flag |
| 111 | .set VER_TMP,LV+123 | temp holding for version number |
| 112 | .set L_SCR3,LV+124 | room for a temporary long value |
| 113 | .set FP_SCR3,LV+128 | room for a temporary float value |
| 114 | .set FP_SCR4,LV+144 | room for a temporary float value |
| 115 | .set FP_SCR5,LV+160 | room for a temporary float value |
| 116 | .set FP_SCR6,LV+176 |
| 117 | | |
| 118 | |NEXT equ LV+192 ;need to increase LOCAL_SIZE |
| 119 | | |
| 120 | |-------------------------------------------------------------------------- |
| 121 | | |
| 122 | | fsave offsets and bit definitions |
| 123 | | |
| 124 | | Offsets are defined from the end of an fsave because the last 10 |
| 125 | | words of a busy frame are the same as the unimplemented frame. |
| 126 | | |
| 127 | .set CU_SAVEPC,LV-92 | micro-pc for CU (1 byte) |
| 128 | .set FPR_DIRTY_BITS,LV-91 | fpr dirty bits |
| 129 | | |
| 130 | .set WBTEMP,LV-76 | write back temp (12 bytes) |
| 131 | .set WBTEMP_EX,WBTEMP | wbtemp sign and exponent (2 bytes) |
| 132 | .set WBTEMP_HI,WBTEMP+4 | wbtemp mantissa [63:32] (4 bytes) |
| 133 | .set WBTEMP_LO,WBTEMP+8 | wbtemp mantissa [31:00] (4 bytes) |
| 134 | | |
| 135 | .set WBTEMP_SGN,WBTEMP+2 | used to store sign |
| 136 | | |
| 137 | .set FPSR_SHADOW,LV-64 | fpsr shadow reg |
| 138 | | |
| 139 | .set FPIARCU,LV-60 | Instr. addr. reg. for CU (4 bytes) |
| 140 | | |
| 141 | .set CMDREG2B,LV-52 | cmd reg for machine 2 |
| 142 | .set CMDREG3B,LV-48 | cmd reg for E3 exceptions (2 bytes) |
| 143 | | |
| 144 | .set NMNEXC,LV-44 | NMNEXC (unsup,snan bits only) |
| 145 | .set nmn_unsup_bit,1 | |
| 146 | .set nmn_snan_bit,0 | |
| 147 | | |
| 148 | .set NMCEXC,LV-43 | NMNEXC & NMCEXC |
| 149 | .set nmn_operr_bit,7 |
| 150 | .set nmn_ovfl_bit,6 |
| 151 | .set nmn_unfl_bit,5 |
| 152 | .set nmc_unsup_bit,4 |
| 153 | .set nmc_snan_bit,3 |
| 154 | .set nmc_operr_bit,2 |
| 155 | .set nmc_ovfl_bit,1 |
| 156 | .set nmc_unfl_bit,0 |
| 157 | | |
| 158 | .set STAG,LV-40 | source tag (1 byte) |
| 159 | .set WBTEMP_GRS,LV-40 | alias wbtemp guard, round, sticky |
| 160 | .set guard_bit,1 | guard bit is bit number 1 |
| 161 | .set round_bit,0 | round bit is bit number 0 |
| 162 | .set stag_mask,0xE0 | upper 3 bits are source tag type |
| 163 | .set denorm_bit,7 | bit determines if denorm or unnorm |
| 164 | .set etemp15_bit,4 | etemp exponent bit #15 |
| 165 | .set wbtemp66_bit,2 | wbtemp mantissa bit #66 |
| 166 | .set wbtemp1_bit,1 | wbtemp mantissa bit #1 |
| 167 | .set wbtemp0_bit,0 | wbtemp mantissa bit #0 |
| 168 | | |
| 169 | .set STICKY,LV-39 | holds sticky bit |
| 170 | .set sticky_bit,7 |
| 171 | | |
| 172 | .set CMDREG1B,LV-36 | cmd reg for E1 exceptions (2 bytes) |
| 173 | .set kfact_bit,12 | distinguishes static/dynamic k-factor |
| 174 | | ;on packed move outs. NOTE: this |
| 175 | | ;equate only works when CMDREG1B is in |
| 176 | | ;a register. |
| 177 | | |
| 178 | .set CMDWORD,LV-35 | command word in cmd1b |
| 179 | .set direction_bit,5 | bit 0 in opclass |
| 180 | .set size_bit2,12 | bit 2 in size field |
| 181 | | |
| 182 | .set DTAG,LV-32 | dest tag (1 byte) |
| 183 | .set dtag_mask,0xE0 | upper 3 bits are dest type tag |
| 184 | .set fptemp15_bit,4 | fptemp exponent bit #15 |
| 185 | | |
| 186 | .set WB_BYTE,LV-31 | holds WBTE15 bit (1 byte) |
| 187 | .set wbtemp15_bit,4 | wbtemp exponent bit #15 |
| 188 | | |
| 189 | .set E_BYTE,LV-28 | holds E1 and E3 bits (1 byte) |
| 190 | .set E1,2 | which bit is E1 flag |
| 191 | .set E3,1 | which bit is E3 flag |
| 192 | .set SFLAG,0 | which bit is S flag |
| 193 | | |
| 194 | .set T_BYTE,LV-27 | holds T and U bits (1 byte) |
| 195 | .set XFLAG,7 | which bit is X flag |
| 196 | .set UFLAG,5 | which bit is U flag |
| 197 | .set TFLAG,4 | which bit is T flag |
| 198 | | |
| 199 | .set FPTEMP,LV-24 | fptemp (12 bytes) |
| 200 | .set FPTEMP_EX,FPTEMP | fptemp sign and exponent (2 bytes) |
| 201 | .set FPTEMP_HI,FPTEMP+4 | fptemp mantissa [63:32] (4 bytes) |
| 202 | .set FPTEMP_LO,FPTEMP+8 | fptemp mantissa [31:00] (4 bytes) |
| 203 | | |
| 204 | .set FPTEMP_SGN,FPTEMP+2 | used to store sign |
| 205 | | |
| 206 | .set ETEMP,LV-12 | etemp (12 bytes) |
| 207 | .set ETEMP_EX,ETEMP | etemp sign and exponent (2 bytes) |
| 208 | .set ETEMP_HI,ETEMP+4 | etemp mantissa [63:32] (4 bytes) |
| 209 | .set ETEMP_LO,ETEMP+8 | etemp mantissa [31:00] (4 bytes) |
| 210 | | |
| 211 | .set ETEMP_SGN,ETEMP+2 | used to store sign |
| 212 | | |
| 213 | .set EXC_SR,4 | exception frame status register |
| 214 | .set EXC_PC,6 | exception frame program counter |
| 215 | .set EXC_VEC,10 | exception frame vector (format+vector#) |
| 216 | .set EXC_EA,12 | exception frame effective address |
| 217 | | |
| 218 | |-------------------------------------------------------------------------- |
| 219 | | |
| 220 | | FPSR/FPCR bits |
| 221 | | |
| 222 | .set neg_bit,3 | negative result |
| 223 | .set z_bit,2 | zero result |
| 224 | .set inf_bit,1 | infinity result |
| 225 | .set nan_bit,0 | not-a-number result |
| 226 | | |
| 227 | .set q_sn_bit,7 | sign bit of quotient byte |
| 228 | | |
| 229 | .set bsun_bit,7 | branch on unordered |
| 230 | .set snan_bit,6 | signalling nan |
| 231 | .set operr_bit,5 | operand error |
| 232 | .set ovfl_bit,4 | overflow |
| 233 | .set unfl_bit,3 | underflow |
| 234 | .set dz_bit,2 | divide by zero |
| 235 | .set inex2_bit,1 | inexact result 2 |
| 236 | .set inex1_bit,0 | inexact result 1 |
| 237 | | |
| 238 | .set aiop_bit,7 | accrued illegal operation |
| 239 | .set aovfl_bit,6 | accrued overflow |
| 240 | .set aunfl_bit,5 | accrued underflow |
| 241 | .set adz_bit,4 | accrued divide by zero |
| 242 | .set ainex_bit,3 | accrued inexact |
| 243 | | |
| 244 | | FPSR individual bit masks |
| 245 | | |
| 246 | .set neg_mask,0x08000000 |
| 247 | .set z_mask,0x04000000 |
| 248 | .set inf_mask,0x02000000 |
| 249 | .set nan_mask,0x01000000 |
| 250 | | |
| 251 | .set bsun_mask,0x00008000 | |
| 252 | .set snan_mask,0x00004000 |
| 253 | .set operr_mask,0x00002000 |
| 254 | .set ovfl_mask,0x00001000 |
| 255 | .set unfl_mask,0x00000800 |
| 256 | .set dz_mask,0x00000400 |
| 257 | .set inex2_mask,0x00000200 |
| 258 | .set inex1_mask,0x00000100 |
| 259 | | |
| 260 | .set aiop_mask,0x00000080 | accrued illegal operation |
| 261 | .set aovfl_mask,0x00000040 | accrued overflow |
| 262 | .set aunfl_mask,0x00000020 | accrued underflow |
| 263 | .set adz_mask,0x00000010 | accrued divide by zero |
| 264 | .set ainex_mask,0x00000008 | accrued inexact |
| 265 | | |
| 266 | | FPSR combinations used in the FPSP |
| 267 | | |
| 268 | .set dzinf_mask,inf_mask+dz_mask+adz_mask |
| 269 | .set opnan_mask,nan_mask+operr_mask+aiop_mask |
| 270 | .set nzi_mask,0x01ffffff | clears N, Z, and I |
| 271 | .set unfinx_mask,unfl_mask+inex2_mask+aunfl_mask+ainex_mask |
| 272 | .set unf2inx_mask,unfl_mask+inex2_mask+ainex_mask |
| 273 | .set ovfinx_mask,ovfl_mask+inex2_mask+aovfl_mask+ainex_mask |
| 274 | .set inx1a_mask,inex1_mask+ainex_mask |
| 275 | .set inx2a_mask,inex2_mask+ainex_mask |
| 276 | .set snaniop_mask,nan_mask+snan_mask+aiop_mask |
| 277 | .set naniop_mask,nan_mask+aiop_mask |
| 278 | .set neginf_mask,neg_mask+inf_mask |
| 279 | .set infaiop_mask,inf_mask+aiop_mask |
| 280 | .set negz_mask,neg_mask+z_mask |
| 281 | .set opaop_mask,operr_mask+aiop_mask |
| 282 | .set unfl_inx_mask,unfl_mask+aunfl_mask+ainex_mask |
| 283 | .set ovfl_inx_mask,ovfl_mask+aovfl_mask+ainex_mask |
| 284 | | |
| 285 | |-------------------------------------------------------------------------- |
| 286 | | |
| 287 | | FPCR rounding modes |
| 288 | | |
| 289 | .set x_mode,0x00 | round to extended |
| 290 | .set s_mode,0x40 | round to single |
| 291 | .set d_mode,0x80 | round to double |
| 292 | | |
| 293 | .set rn_mode,0x00 | round nearest |
| 294 | .set rz_mode,0x10 | round to zero |
| 295 | .set rm_mode,0x20 | round to minus infinity |
| 296 | .set rp_mode,0x30 | round to plus infinity |
| 297 | | |
| 298 | |-------------------------------------------------------------------------- |
| 299 | | |
| 300 | | Miscellaneous equates |
| 301 | | |
| 302 | .set signan_bit,6 | signalling nan bit in mantissa |
| 303 | .set sign_bit,7 |
| 304 | | |
| 305 | .set rnd_stky_bit,29 | round/sticky bit of mantissa |
| 306 | | this can only be used if in a data register |
| 307 | .set sx_mask,0x01800000 | set s and x bits in word $48 |
| 308 | | |
| 309 | .set LOCAL_EX,0 |
| 310 | .set LOCAL_SGN,2 |
| 311 | .set LOCAL_HI,4 |
| 312 | .set LOCAL_LO,8 |
| 313 | .set LOCAL_GRS,12 | valid ONLY for FP_SCR1, FP_SCR2 |
| 314 | | |
| 315 | | |
| 316 | .set norm_tag,0x00 | tag bits in {7:5} position |
| 317 | .set zero_tag,0x20 |
| 318 | .set inf_tag,0x40 |
| 319 | .set nan_tag,0x60 |
| 320 | .set dnrm_tag,0x80 |
| 321 | | |
| 322 | | fsave sizes and formats |
| 323 | | |
| 324 | .set VER_4,0x40 | fpsp compatible version numbers |
| 325 | | are in the $40s {$40-$4f} |
| 326 | .set VER_40,0x40 | original version number |
| 327 | .set VER_41,0x41 | revision version number |
| 328 | | |
| 329 | .set BUSY_SIZE,100 | size of busy frame |
| 330 | .set BUSY_FRAME,LV-BUSY_SIZE | start of busy frame |
| 331 | | |
| 332 | .set UNIMP_40_SIZE,44 | size of orig unimp frame |
| 333 | .set UNIMP_41_SIZE,52 | size of rev unimp frame |
| 334 | | |
| 335 | .set IDLE_SIZE,4 | size of idle frame |
| 336 | .set IDLE_FRAME,LV-IDLE_SIZE | start of idle frame |
| 337 | | |
| 338 | | exception vectors |
| 339 | | |
| 340 | .set TRACE_VEC,0x2024 | trace trap |
| 341 | .set FLINE_VEC,0x002C | real F-line |
| 342 | .set UNIMP_VEC,0x202C | unimplemented |
| 343 | .set INEX_VEC,0x00C4 |
| 344 | | |
| 345 | .set dbl_thresh,0x3C01 |
| 346 | .set sgl_thresh,0x3F81 |
| 347 | | |