| |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |MOTOROLA MICROPROCESSOR & MEMORY TECHNOLOGY GROUP |
| |M68000 Hi-Performance Microprocessor Division |
| |M68060 Software Package |
| |Production Release P1.00 -- October 10, 1994 |
| | |
| |M68060 Software Package Copyright © 1993, 1994 Motorola Inc. All rights reserved. |
| | |
| |THE SOFTWARE is provided on an "AS IS" basis and without warranty. |
| |To the maximum extent permitted by applicable law, |
| |MOTOROLA DISCLAIMS ALL WARRANTIES WHETHER EXPRESS OR IMPLIED, |
| |INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE |
| |and any warranty against infringement with regard to the SOFTWARE |
| |(INCLUDING ANY MODIFIED VERSIONS THEREOF) and any accompanying written materials. |
| | |
| |To the maximum extent permitted by applicable law, |
| |IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY DAMAGES WHATSOEVER |
| |(INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, |
| |BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) |
| |ARISING OF THE USE OR INABILITY TO USE THE SOFTWARE. |
| |Motorola assumes no responsibility for the maintenance and support of the SOFTWARE. |
| | |
| |You are hereby granted a copyright license to use, modify, and distribute the SOFTWARE |
| |so long as this entire notice is retained without alteration in any modified and/or |
| |redistributed versions, and that such modified versions are clearly identified as such. |
| |No licenses are granted by implication, estoppel or otherwise under any patents |
| |or trademarks of Motorola, Inc. |
| |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| | iskeleton.s |
| | |
| | This file contains: |
| | (1) example "Call-out"s |
| | (2) example package entry code |
| | (3) example "Call-out" table |
| | |
| |
| #include <linux/linkage.h> |
| #include <asm/entry.h> |
| #include <asm/asm-offsets.h> |
| |
| |
| |################################ |
| | (1) EXAMPLE CALL-OUTS # |
| | # |
| | _060_isp_done() # |
| | _060_real_chk() # |
| | _060_real_divbyzero() # |
| | # |
| | _060_real_cas() # |
| | _060_real_cas2() # |
| | _060_real_lock_page() # |
| | _060_real_unlock_page() # |
| |################################ |
| |
| | |
| | _060_isp_done(): |
| | |
| | This is and example main exit point for the Unimplemented Integer |
| | Instruction exception handler. For a normal exit, the |
| | _isp_unimp() branches to here so that the operating system |
| | can do any clean-up desired. The stack frame is the |
| | Unimplemented Integer Instruction stack frame with |
| | the PC pointing to the instruction following the instruction |
| | just emulated. |
| | To simply continue execution at the next instruction, just |
| | do an "rte". |
| | |
| | Linux/68k: If returning to user space, check for needed reselections. |
| |
| .global _060_isp_done |
| _060_isp_done: |
| btst #0x5,%sp@ | supervisor bit set in saved SR? |
| beq .Lnotkern |
| rte |
| .Lnotkern: |
| SAVE_ALL_INT |
| GET_CURRENT(%d0) |
| | deliver signals, reschedule etc.. |
| jra ret_from_exception |
| |
| | |
| | _060_real_chk(): |
| | |
| | This is an alternate exit point for the Unimplemented Integer |
| | Instruction exception handler. If the instruction was a "chk2" |
| | and the operand was out of bounds, then _isp_unimp() creates |
| | a CHK exception stack frame from the Unimplemented Integer Instrcution |
| | stack frame and branches to this routine. |
| | |
| | Linux/68k: commented out test for tracing |
| |
| .global _060_real_chk |
| _060_real_chk: |
| | tst.b (%sp) | is tracing enabled? |
| | bpls real_chk_end | no |
| |
| | |
| | CHK FRAME TRACE FRAME |
| | ***************** ***************** |
| | * Current PC * * Current PC * |
| | ***************** ***************** |
| | * 0x2 * 0x018 * * 0x2 * 0x024 * |
| | ***************** ***************** |
| | * Next * * Next * |
| | * PC * * PC * |
| | ***************** ***************** |
| | * SR * * SR * |
| | ***************** ***************** |
| | |
| | move.b #0x24,0x7(%sp) | set trace vecno |
| | bral _060_real_trace |
| |
| real_chk_end: |
| bral trap | jump to trap handler |
| |
| | |
| | _060_real_divbyzero: |
| | |
| | This is an alternate exit point for the Unimplemented Integer |
| | Instruction exception handler isp_unimp(). If the instruction is a 64-bit |
| | integer divide where the source operand is a zero, then the _isp_unimp() |
| | creates a Divide-by-zero exception stack frame from the Unimplemented |
| | Integer Instruction stack frame and branches to this routine. |
| | |
| | Remember that a trace exception may be pending. The code below performs |
| | no action associated with the "chk" exception. If tracing is enabled, |
| | then it create a Trace exception stack frame from the "chk" exception |
| | stack frame and branches to the _real_trace() entry point. |
| | |
| | Linux/68k: commented out test for tracing |
| |
| .global _060_real_divbyzero |
| _060_real_divbyzero: |
| | tst.b (%sp) | is tracing enabled? |
| | bpls real_divbyzero_end | no |
| |
| | |
| | DIVBYZERO FRAME TRACE FRAME |
| | ***************** ***************** |
| | * Current PC * * Current PC * |
| | ***************** ***************** |
| | * 0x2 * 0x014 * * 0x2 * 0x024 * |
| | ***************** ***************** |
| | * Next * * Next * |
| | * PC * * PC * |
| | ***************** ***************** |
| | * SR * * SR * |
| | ***************** ***************** |
| | |
| | move.b #0x24,0x7(%sp) | set trace vecno |
| | bral _060_real_trace |
| |
| real_divbyzero_end: |
| bral trap | jump to trap handler |
| |
| |########################## |
| |
| | |
| | _060_real_cas(): |
| | |
| | Entry point for the selected cas emulation code implementation. |
| | If the implementation provided by the 68060ISP is sufficient, |
| | then this routine simply re-enters the package through _isp_cas. |
| | |
| .global _060_real_cas |
| _060_real_cas: |
| bral _I_CALL_TOP+0x80+0x08 |
| |
| | |
| | _060_real_cas2(): |
| | |
| | Entry point for the selected cas2 emulation code implementation. |
| | If the implementation provided by the 68060ISP is sufficient, |
| | then this routine simply re-enters the package through _isp_cas2. |
| | |
| .global _060_real_cas2 |
| _060_real_cas2: |
| bral _I_CALL_TOP+0x80+0x10 |
| |
| | |
| | _060_lock_page(): |
| | |
| | Entry point for the operating system`s routine to "lock" a page |
| | from being paged out. This routine is needed by the cas/cas2 |
| | algorithms so that no page faults occur within the "core" code |
| | region. Note: the routine must lock two pages if the operand |
| | spans two pages. |
| | NOTE: THE ROUTINE SHOULD RETURN AN FSLW VALUE IN D0 ON FAILURE |
| | SO THAT THE 060SP CAN CREATE A PROPER ACCESS ERROR FRAME. |
| | Arguments: |
| | a0 = operand address |
| | d0 = `xxxxxxff -> supervisor; `xxxxxx00 -> user |
| | d1 = `xxxxxxff -> longword; `xxxxxx00 -> word |
| | Expected outputs: |
| | d0 = 0 -> success; non-zero -> failure |
| | |
| | Linux/m68k: Make sure the page is properly paged in, so we use |
| | plpaw and handle any exception here. The kernel must not be |
| | preempted until _060_unlock_page(), so that the page stays mapped. |
| | |
| .global _060_real_lock_page |
| _060_real_lock_page: |
| move.l %d2,-(%sp) |
| | load sfc/dfc |
| tst.b %d0 |
| jne 1f |
| moveq #1,%d0 |
| jra 2f |
| 1: moveq #5,%d0 |
| 2: movec.l %dfc,%d2 |
| movec.l %d0,%dfc |
| movec.l %d0,%sfc |
| |
| clr.l %d0 |
| | prefetch address |
| .chip 68060 |
| move.l %a0,%a1 |
| 1: plpaw (%a1) |
| addq.w #1,%a0 |
| tst.b %d1 |
| jeq 2f |
| addq.w #2,%a0 |
| 2: plpaw (%a0) |
| 3: .chip 68k |
| |
| | restore sfc/dfc |
| movec.l %d2,%dfc |
| movec.l %d2,%sfc |
| move.l (%sp)+,%d2 |
| rts |
| |
| .section __ex_table,"a" |
| .align 4 |
| .long 1b,11f |
| .long 2b,21f |
| .previous |
| .section .fixup,"ax" |
| .even |
| 11: move.l #0x020003c0,%d0 |
| or.l %d2,%d0 |
| swap %d0 |
| jra 3b |
| 21: move.l #0x02000bc0,%d0 |
| or.l %d2,%d0 |
| swap %d0 |
| jra 3b |
| .previous |
| |
| | |
| | _060_unlock_page(): |
| | |
| | Entry point for the operating system`s routine to "unlock" a |
| | page that has been "locked" previously with _real_lock_page. |
| | Note: the routine must unlock two pages if the operand spans |
| | two pages. |
| | Arguments: |
| | a0 = operand address |
| | d0 = `xxxxxxff -> supervisor; `xxxxxx00 -> user |
| | d1 = `xxxxxxff -> longword; `xxxxxx00 -> word |
| | |
| | Linux/m68k: perhaps reenable preemption here... |
| |
| .global _060_real_unlock_page |
| _060_real_unlock_page: |
| clr.l %d0 |
| rts |
| |
| |########################################################################### |
| |
| |################################# |
| | (2) EXAMPLE PACKAGE ENTRY CODE # |
| |################################# |
| |
| .global _060_isp_unimp |
| _060_isp_unimp: |
| bral _I_CALL_TOP+0x80+0x00 |
| |
| .global _060_isp_cas |
| _060_isp_cas: |
| bral _I_CALL_TOP+0x80+0x08 |
| |
| .global _060_isp_cas2 |
| _060_isp_cas2: |
| bral _I_CALL_TOP+0x80+0x10 |
| |
| .global _060_isp_cas_finish |
| _060_isp_cas_finish: |
| bra.l _I_CALL_TOP+0x80+0x18 |
| |
| .global _060_isp_cas2_finish |
| _060_isp_cas2_finish: |
| bral _I_CALL_TOP+0x80+0x20 |
| |
| .global _060_isp_cas_inrange |
| _060_isp_cas_inrange: |
| bral _I_CALL_TOP+0x80+0x28 |
| |
| .global _060_isp_cas_terminate |
| _060_isp_cas_terminate: |
| bral _I_CALL_TOP+0x80+0x30 |
| |
| .global _060_isp_cas_restart |
| _060_isp_cas_restart: |
| bral _I_CALL_TOP+0x80+0x38 |
| |
| |########################################################################### |
| |
| |############################### |
| | (3) EXAMPLE CALL-OUT SECTION # |
| |############################### |
| |
| | The size of this section MUST be 128 bytes!!! |
| |
| _I_CALL_TOP: |
| .long _060_real_chk - _I_CALL_TOP |
| .long _060_real_divbyzero - _I_CALL_TOP |
| .long _060_real_trace - _I_CALL_TOP |
| .long _060_real_access - _I_CALL_TOP |
| .long _060_isp_done - _I_CALL_TOP |
| |
| .long _060_real_cas - _I_CALL_TOP |
| .long _060_real_cas2 - _I_CALL_TOP |
| .long _060_real_lock_page - _I_CALL_TOP |
| .long _060_real_unlock_page - _I_CALL_TOP |
| |
| .long 0x00000000, 0x00000000, 0x00000000, 0x00000000 |
| .long 0x00000000, 0x00000000, 0x00000000 |
| |
| .long _060_imem_read - _I_CALL_TOP |
| .long _060_dmem_read - _I_CALL_TOP |
| .long _060_dmem_write - _I_CALL_TOP |
| .long _060_imem_read_word - _I_CALL_TOP |
| .long _060_imem_read_long - _I_CALL_TOP |
| .long _060_dmem_read_byte - _I_CALL_TOP |
| .long _060_dmem_read_word - _I_CALL_TOP |
| .long _060_dmem_read_long - _I_CALL_TOP |
| .long _060_dmem_write_byte - _I_CALL_TOP |
| .long _060_dmem_write_word - _I_CALL_TOP |
| .long _060_dmem_write_long - _I_CALL_TOP |
| |
| .long 0x00000000 |
| .long 0x00000000, 0x00000000, 0x00000000, 0x00000000 |
| |
| |########################################################################### |
| |
| | 060 INTEGER KERNEL PACKAGE MUST GO HERE!!! |
| #include "isp.sa" |