Remove \version svn tag.
[bertos.git] / bertos / cpu / dsp56k / hw / 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, 2008 Develer S.r.l. (http://www.develer.com/)
30  * -->
31  *
32  * \author Giovanni Bajo <rasky@develer.com>
33  *
34  * \brief DSP5680x task switching support
35  */
36
37 void asm_switch_context(void ** new_sp /* R2 */, void ** save_sp /* R3 */);
38 asm void asm_switch_context(void ** new_sp, void ** save_sp)
39 {
40         lea   (SP)+
41
42         ; From the manual:
43         ; The compiler uses page 0 address locations X: 0x0030 - 0x003F as register
44         ; variables. Frequently accessed local variables are assigned to the page 0
45         ; registers instead of to stack locations so that load and store instructions
46         ; are shortened. Addresses X: 0x0030 - 0x0037 (page 0 registers MR0-MR7) are
47         ; volatile registers and can be overwritten. The remaining registers (page 0
48         ; registers MR8-MR15) are treated as non-volatile and, if used by a routine,
49         ; must be saved on entry and restored on exit.
50         ;
51         ; So, register 0x30-0x37 are caller-save, while 0x38-0x3F are callee-save.
52         move  x:<$38,y1
53         move  y1,x:(SP)+
54         move  x:<$39,y1
55         move  y1,x:(SP)+
56         move  x:<$3A,y1
57         move  y1,x:(SP)+
58         move  x:<$3B,y1
59         move  y1,x:(SP)+
60         move  x:<$3C,y1
61         move  y1,x:(SP)+
62         move  x:<$3D,y1
63         move  y1,x:(SP)+
64         move  x:<$3E,y1
65         move  y1,x:(SP)+
66         move  x:<$3F,y1
67         move  y1,x:(SP)
68
69         ;
70         ; Switch stacks
71         nop
72         move SP, x:(R3)
73         nop
74         move x:(R2), SP
75         nop
76
77         ;
78         ; restore all saved registers
79         ;
80         pop   y1
81         move  y1,x:<$3F
82         pop   y1
83         move  y1,x:<$3E
84         pop   y1
85         move  y1,x:<$3D
86         pop   y1
87         move  y1,x:<$3C
88         pop   y1
89         move  y1,x:<$3B
90         pop   y1
91         move  y1,x:<$3A
92         pop   y1
93         move  y1,x:<$39
94         pop   y1
95         move  y1,x:<$38
96
97         ; SR is already pushed on the stack (normal call context). Use RTI to restore
98         ; it, so that interrupt status is preserved across the tasks.
99         rti
100 }