Doxygen fix.
[bertos.git] / kern / switch_dsp56k.c
1 /*!
2  * \file
3  * <!--
4  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
5  * This file is part of DevLib - See README.devlib for information.
6  * -->
7  *
8  * \version $Id$
9  *
10  * \author Giovanni Bajo <rasky@develer.com>
11  *
12  * \brief DSP5680x task switching support
13  */
14
15 /*#*
16  *#* $Log$
17  *#* Revision 1.6  2006/02/24 01:17:05  bernie
18  *#* Update for new emulator.
19  *#*
20  *#* Revision 1.5  2005/11/04 16:20:02  bernie
21  *#* Fix reference to README.devlib in header.
22  *#*
23  *#* Revision 1.4  2004/08/25 14:12:09  rasky
24  *#* Aggiornato il comment block dei log RCS
25  *#*
26  *#* Revision 1.3  2004/07/30 14:24:16  rasky
27  *#* Task switching con salvataggio perfetto stato di interrupt (SR)
28  *#* Kernel monitor per dump informazioni su stack dei processi
29  *#*
30  *#* Revision 1.2  2004/06/03 11:27:09  bernie
31  *#* Add dual-license information.
32  *#*
33  *#* Revision 1.1  2004/05/23 17:27:00  bernie
34  *#* Import kern/ subdirectory.
35  *#*
36  *#*/
37
38 void asm_switch_context(void ** new_sp/*R2*/, void ** save_sp/*R3*/);
39 asm void asm_switch_context(void ** new_sp, void ** save_sp)
40 {
41         lea   (SP)+
42
43         ; From the manual:
44         ; The compiler uses page 0 address locations X: 0x0030 - 0x003F as register
45         ; variables. Frequently accessed local variables are assigned to the page 0
46         ; registers instead of to stack locations so that load and store instructions
47         ; are shortened. Addresses X: 0x0030 - 0x0037 (page 0 registers MR0-MR7) are
48         ; volatile registers and can be overwritten. The remaining registers (page 0
49         ; registers MR8-MR15) are treated as non-volatile and, if used by a routine,
50         ; must be saved on entry and restored on exit.
51         ;
52         ; So, register 0x30-0x37 are caller-save, while 0x38-0x3F are callee-save.
53         move  x:<$38,y1
54         move  y1,x:(SP)+
55         move  x:<$39,y1
56         move  y1,x:(SP)+
57         move  x:<$3A,y1
58         move  y1,x:(SP)+
59         move  x:<$3B,y1
60         move  y1,x:(SP)+
61         move  x:<$3C,y1
62         move  y1,x:(SP)+
63         move  x:<$3D,y1
64         move  y1,x:(SP)+
65         move  x:<$3E,y1
66         move  y1,x:(SP)+
67         move  x:<$3F,y1
68         move  y1,x:(SP)
69
70         ;
71         ; Switch stacks
72         nop
73         move SP, x:(R3)
74         nop
75         move x:(R2), SP
76         nop
77
78         ;
79         ; restore all saved registers
80         ;
81         pop   y1
82         move  y1,x:<$3F
83         pop   y1
84         move  y1,x:<$3E
85         pop   y1
86         move  y1,x:<$3D
87         pop   y1
88         move  y1,x:<$3C
89         pop   y1
90         move  y1,x:<$3B
91         pop   y1
92         move  y1,x:<$3A
93         pop   y1
94         move  y1,x:<$39
95         pop   y1
96         move  y1,x:<$38
97
98         ; SR is already pushed on the stack (normal call context). Use RTI to restore
99         ; it, so that interrupt status is preserved across the tasks.
100         rti
101 }
102
103 int asm_switch_version(void);
104 int asm_switch_version(void)
105 {
106         return 1;
107 }