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| iskeleton.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#include <asm/entry.h> 39#include <asm/asm-offsets.h> 40 41 42|################################ 43| (1) EXAMPLE CALL-OUTS # 44| # 45| _060_isp_done() # 46| _060_real_chk() # 47| _060_real_divbyzero() # 48| # 49| _060_real_cas() # 50| _060_real_cas2() # 51| _060_real_lock_page() # 52| _060_real_unlock_page() # 53|################################ 54 55| 56| _060_isp_done(): 57| 58| This is and example main exit point for the Unimplemented Integer 59| Instruction exception handler. For a normal exit, the 60| _isp_unimp() branches to here so that the operating system 61| can do any clean-up desired. The stack frame is the 62| Unimplemented Integer Instruction stack frame with 63| the PC pointing to the instruction following the instruction 64| just emulated. 65| To simply continue execution at the next instruction, just 66| do an "rte". 67| 68| Linux/68k: If returning to user space, check for needed reselections. 69 70 .global _060_isp_done 71_060_isp_done: 72 btst #0x5,%sp@ | supervisor bit set in saved SR? 73 beq .Lnotkern 74 rte 75.Lnotkern: 76 SAVE_ALL_INT 77 GET_CURRENT(%d0) 78 | deliver signals, reschedule etc.. 79 jra ret_from_exception 80 81| 82| _060_real_chk(): 83| 84| This is an alternate exit point for the Unimplemented Integer 85| Instruction exception handler. If the instruction was a "chk2" 86| and the operand was out of bounds, then _isp_unimp() creates 87| a CHK exception stack frame from the Unimplemented Integer Instrcution 88| stack frame and branches to this routine. 89| 90| Linux/68k: commented out test for tracing 91 92 .global _060_real_chk 93_060_real_chk: 94| tst.b (%sp) | is tracing enabled? 95| bpls real_chk_end | no 96 97| 98| CHK FRAME TRACE FRAME 99| ***************** ***************** 100| * Current PC * * Current PC * 101| ***************** ***************** 102| * 0x2 * 0x018 * * 0x2 * 0x024 * 103| ***************** ***************** 104| * Next * * Next * 105| * PC * * PC * 106| ***************** ***************** 107| * SR * * SR * 108| ***************** ***************** 109| 110| move.b #0x24,0x7(%sp) | set trace vecno 111| bral _060_real_trace 112 113real_chk_end: 114 bral trap | jump to trap handler 115 116| 117| _060_real_divbyzero: 118| 119| This is an alternate exit point for the Unimplemented Integer 120| Instruction exception handler isp_unimp(). If the instruction is a 64-bit 121| integer divide where the source operand is a zero, then the _isp_unimp() 122| creates a Divide-by-zero exception stack frame from the Unimplemented 123| Integer Instruction stack frame and branches to this routine. 124| 125| Remember that a trace exception may be pending. The code below performs 126| no action associated with the "chk" exception. If tracing is enabled, 127| then it create a Trace exception stack frame from the "chk" exception 128| stack frame and branches to the _real_trace() entry point. 129| 130| Linux/68k: commented out test for tracing 131 132 .global _060_real_divbyzero 133_060_real_divbyzero: 134| tst.b (%sp) | is tracing enabled? 135| bpls real_divbyzero_end | no 136 137| 138| DIVBYZERO FRAME TRACE FRAME 139| ***************** ***************** 140| * Current PC * * Current PC * 141| ***************** ***************** 142| * 0x2 * 0x014 * * 0x2 * 0x024 * 143| ***************** ***************** 144| * Next * * Next * 145| * PC * * PC * 146| ***************** ***************** 147| * SR * * SR * 148| ***************** ***************** 149| 150| move.b #0x24,0x7(%sp) | set trace vecno 151| bral _060_real_trace 152 153real_divbyzero_end: 154 bral trap | jump to trap handler 155 156|########################## 157 158| 159| _060_real_cas(): 160| 161| Entry point for the selected cas emulation code implementation. 162| If the implementation provided by the 68060ISP is sufficient, 163| then this routine simply re-enters the package through _isp_cas. 164| 165 .global _060_real_cas 166_060_real_cas: 167 bral _I_CALL_TOP+0x80+0x08 168 169| 170| _060_real_cas2(): 171| 172| Entry point for the selected cas2 emulation code implementation. 173| If the implementation provided by the 68060ISP is sufficient, 174| then this routine simply re-enters the package through _isp_cas2. 175| 176 .global _060_real_cas2 177_060_real_cas2: 178 bral _I_CALL_TOP+0x80+0x10 179 180| 181| _060_lock_page(): 182| 183| Entry point for the operating system`s routine to "lock" a page 184| from being paged out. This routine is needed by the cas/cas2 185| algorithms so that no page faults occur within the "core" code 186| region. Note: the routine must lock two pages if the operand 187| spans two pages. 188| NOTE: THE ROUTINE SHOULD RETURN AN FSLW VALUE IN D0 ON FAILURE 189| SO THAT THE 060SP CAN CREATE A PROPER ACCESS ERROR FRAME. 190| Arguments: 191| a0 = operand address 192| d0 = `xxxxxxff -> supervisor; `xxxxxx00 -> user 193| d1 = `xxxxxxff -> longword; `xxxxxx00 -> word 194| Expected outputs: 195| d0 = 0 -> success; non-zero -> failure 196| 197| Linux/m68k: Make sure the page is properly paged in, so we use 198| plpaw and handle any exception here. The kernel must not be 199| preempted until _060_unlock_page(), so that the page stays mapped. 200| 201 .global _060_real_lock_page 202_060_real_lock_page: 203 move.l %d2,-(%sp) 204 | load sfc/dfc 205 tst.b %d0 206 jne 1f 207 moveq #1,%d0 208 jra 2f 2091: moveq #5,%d0 2102: movec.l %dfc,%d2 211 movec.l %d0,%dfc 212 movec.l %d0,%sfc 213 214 clr.l %d0 215 | prefetch address 216 .chip 68060 217 move.l %a0,%a1 2181: plpaw (%a1) 219 addq.w #1,%a0 220 tst.b %d1 221 jeq 2f 222 addq.w #2,%a0 2232: plpaw (%a0) 2243: .chip 68k 225 226 | restore sfc/dfc 227 movec.l %d2,%dfc 228 movec.l %d2,%sfc 229 move.l (%sp)+,%d2 230 rts 231 232.section __ex_table,"a" 233 .align 4 234 .long 1b,11f 235 .long 2b,21f 236.previous 237.section .fixup,"ax" 238 .even 23911: move.l #0x020003c0,%d0 240 or.l %d2,%d0 241 swap %d0 242 jra 3b 24321: move.l #0x02000bc0,%d0 244 or.l %d2,%d0 245 swap %d0 246 jra 3b 247.previous 248 249| 250| _060_unlock_page(): 251| 252| Entry point for the operating system`s routine to "unlock" a 253| page that has been "locked" previously with _real_lock_page. 254| Note: the routine must unlock two pages if the operand spans 255| two pages. 256| Arguments: 257| a0 = operand address 258| d0 = `xxxxxxff -> supervisor; `xxxxxx00 -> user 259| d1 = `xxxxxxff -> longword; `xxxxxx00 -> word 260| 261| Linux/m68k: perhaps reenable preemption here... 262 263 .global _060_real_unlock_page 264_060_real_unlock_page: 265 clr.l %d0 266 rts 267 268|########################################################################### 269 270|################################# 271| (2) EXAMPLE PACKAGE ENTRY CODE # 272|################################# 273 274 .global _060_isp_unimp 275_060_isp_unimp: 276 bral _I_CALL_TOP+0x80+0x00 277 278 .global _060_isp_cas 279_060_isp_cas: 280 bral _I_CALL_TOP+0x80+0x08 281 282 .global _060_isp_cas2 283_060_isp_cas2: 284 bral _I_CALL_TOP+0x80+0x10 285 286 .global _060_isp_cas_finish 287_060_isp_cas_finish: 288 bra.l _I_CALL_TOP+0x80+0x18 289 290 .global _060_isp_cas2_finish 291_060_isp_cas2_finish: 292 bral _I_CALL_TOP+0x80+0x20 293 294 .global _060_isp_cas_inrange 295_060_isp_cas_inrange: 296 bral _I_CALL_TOP+0x80+0x28 297 298 .global _060_isp_cas_terminate 299_060_isp_cas_terminate: 300 bral _I_CALL_TOP+0x80+0x30 301 302 .global _060_isp_cas_restart 303_060_isp_cas_restart: 304 bral _I_CALL_TOP+0x80+0x38 305 306|########################################################################### 307 308|############################### 309| (3) EXAMPLE CALL-OUT SECTION # 310|############################### 311 312| The size of this section MUST be 128 bytes!!! 313 314_I_CALL_TOP: 315 .long _060_real_chk - _I_CALL_TOP 316 .long _060_real_divbyzero - _I_CALL_TOP 317 .long _060_real_trace - _I_CALL_TOP 318 .long _060_real_access - _I_CALL_TOP 319 .long _060_isp_done - _I_CALL_TOP 320 321 .long _060_real_cas - _I_CALL_TOP 322 .long _060_real_cas2 - _I_CALL_TOP 323 .long _060_real_lock_page - _I_CALL_TOP 324 .long _060_real_unlock_page - _I_CALL_TOP 325 326 .long 0x00000000, 0x00000000, 0x00000000, 0x00000000 327 .long 0x00000000, 0x00000000, 0x00000000 328 329 .long _060_imem_read - _I_CALL_TOP 330 .long _060_dmem_read - _I_CALL_TOP 331 .long _060_dmem_write - _I_CALL_TOP 332 .long _060_imem_read_word - _I_CALL_TOP 333 .long _060_imem_read_long - _I_CALL_TOP 334 .long _060_dmem_read_byte - _I_CALL_TOP 335 .long _060_dmem_read_word - _I_CALL_TOP 336 .long _060_dmem_read_long - _I_CALL_TOP 337 .long _060_dmem_write_byte - _I_CALL_TOP 338 .long _060_dmem_write_word - _I_CALL_TOP 339 .long _060_dmem_write_long - _I_CALL_TOP 340 341 .long 0x00000000 342 .long 0x00000000, 0x00000000, 0x00000000, 0x00000000 343 344|########################################################################### 345 346| 060 INTEGER KERNEL PACKAGE MUST GO HERE!!! 347#include "isp.sa" 348