Doc fixes.
[bertos.git] / kern / switch_dsp56k.c
1 /**
2  * \file
3  * <!--
4  * This file is part of BeRTOS.
5  *
6  * Bertos is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  * As a special exception, you may use this file as part of a free software
21  * library without restriction.  Specifically, if other files instantiate
22  * templates or use macros or inline functions from this file, or you compile
23  * this file and link it with other files to produce an executable, this
24  * file does not by itself cause the resulting executable to be covered by
25  * the GNU General Public License.  This exception does not however
26  * invalidate any other reasons why the executable file might be covered by
27  * the GNU General Public License.
28  *
29  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
30  *
31  * -->
32  *
33  * \version $Id$
34  *
35  * \author Giovanni Bajo <rasky@develer.com>
36  *
37  * \brief DSP5680x task switching support
38  */
39
40 /*#*
41  *#* $Log$
42  *#* Revision 1.7  2006/07/19 12:56:27  bernie
43  *#* Convert to new Doxygen style.
44  *#*
45  *#* Revision 1.6  2006/02/24 01:17:05  bernie
46  *#* Update for new emulator.
47  *#*
48  *#* Revision 1.5  2005/11/04 16:20:02  bernie
49  *#* Fix reference to README.devlib in header.
50  *#*
51  *#* Revision 1.4  2004/08/25 14:12:09  rasky
52  *#* Aggiornato il comment block dei log RCS
53  *#*
54  *#* Revision 1.3  2004/07/30 14:24:16  rasky
55  *#* Task switching con salvataggio perfetto stato di interrupt (SR)
56  *#* Kernel monitor per dump informazioni su stack dei processi
57  *#*
58  *#* Revision 1.2  2004/06/03 11:27:09  bernie
59  *#* Add dual-license information.
60  *#*
61  *#* Revision 1.1  2004/05/23 17:27:00  bernie
62  *#* Import kern/ subdirectory.
63  *#*
64  *#*/
65
66 void asm_switch_context(void ** new_sp/*R2*/, void ** save_sp/*R3*/);
67 asm void asm_switch_context(void ** new_sp, void ** save_sp)
68 {
69         lea   (SP)+
70
71         ; From the manual:
72         ; The compiler uses page 0 address locations X: 0x0030 - 0x003F as register
73         ; variables. Frequently accessed local variables are assigned to the page 0
74         ; registers instead of to stack locations so that load and store instructions
75         ; are shortened. Addresses X: 0x0030 - 0x0037 (page 0 registers MR0-MR7) are
76         ; volatile registers and can be overwritten. The remaining registers (page 0
77         ; registers MR8-MR15) are treated as non-volatile and, if used by a routine,
78         ; must be saved on entry and restored on exit.
79         ;
80         ; So, register 0x30-0x37 are caller-save, while 0x38-0x3F are callee-save.
81         move  x:<$38,y1
82         move  y1,x:(SP)+
83         move  x:<$39,y1
84         move  y1,x:(SP)+
85         move  x:<$3A,y1
86         move  y1,x:(SP)+
87         move  x:<$3B,y1
88         move  y1,x:(SP)+
89         move  x:<$3C,y1
90         move  y1,x:(SP)+
91         move  x:<$3D,y1
92         move  y1,x:(SP)+
93         move  x:<$3E,y1
94         move  y1,x:(SP)+
95         move  x:<$3F,y1
96         move  y1,x:(SP)
97
98         ;
99         ; Switch stacks
100         nop
101         move SP, x:(R3)
102         nop
103         move x:(R2), SP
104         nop
105
106         ;
107         ; restore all saved registers
108         ;
109         pop   y1
110         move  y1,x:<$3F
111         pop   y1
112         move  y1,x:<$3E
113         pop   y1
114         move  y1,x:<$3D
115         pop   y1
116         move  y1,x:<$3C
117         pop   y1
118         move  y1,x:<$3B
119         pop   y1
120         move  y1,x:<$3A
121         pop   y1
122         move  y1,x:<$39
123         pop   y1
124         move  y1,x:<$38
125
126         ; SR is already pushed on the stack (normal call context). Use RTI to restore
127         ; it, so that interrupt status is preserved across the tasks.
128         rti
129 }
130
131 int asm_switch_version(void);
132 int asm_switch_version(void)
133 {
134         return 1;
135 }