annotate packages/hal/openrisc/arch/current/include/hal_arch.h @ 2729:74dbf4c3f2e1 after-copyright-change-20090129

Update all copyright banners to reflect FSF ownership; fix and improve licence text.
author jlarmour
date Thu, 29 Jan 2009 17:47:46 +0000
parents 38840e07f305
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
1 //==========================================================================
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
2 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
3 // hal_arch.h
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
4 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
5 // Architecture specific abstractions
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
6 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
7 //==========================================================================
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
8 // ####ECOSGPLCOPYRIGHTBEGIN####
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
9 // -------------------------------------------
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
10 // This file is part of eCos, the Embedded Configurable Operating System.
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
12 //
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
13 // eCos is free software; you can redistribute it and/or modify it under
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
14 // the terms of the GNU General Public License as published by the Free
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
15 // Software Foundation; either version 2 or (at your option) any later
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
16 // version.
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
17 //
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
18 // eCos is distributed in the hope that it will be useful, but WITHOUT
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
19 // ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
20 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
21 // for more details.
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
22 //
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
23 // You should have received a copy of the GNU General Public License
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
24 // along with eCos; if not, write to the Free Software Foundation, Inc.,
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
25 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
26 //
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
27 // As a special exception, if other files instantiate templates or use
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
28 // macros or inline functions from this file, or you compile this file
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
29 // and link it with other works to produce a work based on this file,
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
30 // this file does not by itself cause the resulting work to be covered by
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
31 // the GNU General Public License. However the source code for this file
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
32 // must still be made available in accordance with section (3) of the GNU
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
33 // General Public License v2.
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
34 //
2729
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
35 // This exception does not invalidate any other reasons why a work based
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
36 // on this file might be covered by the GNU General Public License.
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
37 // -------------------------------------------
74dbf4c3f2e1 Update all copyright banners to reflect FSF ownership; fix and improve licence text.
jlarmour
parents: 964
diff changeset
38 // ####ECOSGPLCOPYRIGHTEND####
964
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
39 //==========================================================================
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
40 //#####DESCRIPTIONBEGIN####
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
41 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
42 // Author(s): sfurman
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
43 // Contributors:
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
44 // Date: 2003-01-17
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
45 // Purpose: Define architecture abstractions
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
46 // Usage: #include <cyg/hal/hal_arch.h>
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
47 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
48 //####DESCRIPTIONEND####
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
49 //
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
50 //==========================================================================
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
51
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
52 #ifndef CYGONCE_HAL_HAL_ARCH_H
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
53 #define CYGONCE_HAL_HAL_ARCH_H
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
54
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
55 // Include macros to access special-purpose registers (SPRs)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
56 #include <cyg/hal/spr_defs.h>
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
57
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
58 #define CYG_HAL_OPENRISC_REG_SIZE 4
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
59
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
60 #ifndef __ASSEMBLER__
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
61 #include <pkgconf/hal.h>
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
62 #include <cyg/infra/cyg_type.h>
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
63
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
64 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
65 // Processor saved states:
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
66 // The layout of this structure is also defined in "arch.inc", for assembly
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
67 // code. Do not change this without changing that (or vice versa).
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
68
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
69 #define CYG_HAL_OPENRISC_REG CYG_WORD32
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
70
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
71 typedef struct
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
72 {
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
73 // These are common to all saved states
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
74 CYG_HAL_OPENRISC_REG r[32]; // GPR regs
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
75 CYG_HAL_OPENRISC_REG machi; // High and low words of
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
76 CYG_HAL_OPENRISC_REG maclo; // multiply/accumulate reg
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
77
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
78 // These are only saved for exceptions and interrupts
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
79 CYG_WORD32 vector; /* Vector number */
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
80 CYG_WORD32 sr; /* Status Reg */
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
81 CYG_HAL_OPENRISC_REG pc; /* Program Counter */
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
82
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
83 // Saved only for exceptions, and not restored when continued:
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
84 // Effective address of instruction/data access that caused exception
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
85 CYG_HAL_OPENRISC_REG eear; /* Exception effective address reg */
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
86 } HAL_SavedRegisters;
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
87
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
88 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
89 // Utilities
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
90
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
91 // Move from architecture special register (SPR)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
92 #define MFSPR(_spr_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
93 ({ CYG_HAL_OPENRISC_REG _result_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
94 asm volatile ("l.mfspr %0, r0, %1;" \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
95 : "=r"(_result_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
96 : "K"(_spr_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
97 ); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
98 _result_;})
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
99
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
100 // Move data to architecture special registers (SPR)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
101 #define MTSPR(_spr_, _val_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
102 CYG_MACRO_START \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
103 CYG_HAL_OPENRISC_REG val = _val_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
104 asm volatile ("l.mtspr r0, %0, %1;" \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
105 : \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
106 : "r"(val), "K"(_spr_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
107 ); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
108 CYG_MACRO_END
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
109
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
110 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
111 // Exception handling function.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
112 // This function is defined by the kernel according to this prototype. It is
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
113 // invoked from the HAL to deal with any CPU exceptions that the HAL does
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
114 // not want to deal with itself. It usually invokes the kernel's exception
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
115 // delivery mechanism.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
116
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
117 externC void cyg_hal_deliver_exception( CYG_WORD code, CYG_ADDRWORD data );
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
118
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
119 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
120 // Bit manipulation macros
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
121
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
122 externC cyg_uint32 hal_lsbit_index(cyg_uint32 mask);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
123 externC cyg_uint32 hal_msbit_index(cyg_uint32 mask);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
124
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
125 #define HAL_LSBIT_INDEX(index, mask) index = hal_lsbit_index(mask);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
126
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
127 // NOTE - Below can be optimized with l.ff1 instruction if that optional
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
128 // instruction is implemented in HW. OR12k does not implement
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
129 // it at this time, however.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
130 #define HAL_MSBIT_INDEX(index, mask) index = hal_msbit_index(mask);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
131
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
132 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
133 // Context Initialization
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
134
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
135
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
136 // Initialize the context of a thread.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
137 // Arguments:
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
138 // _sparg_ name of variable containing current sp, will be written with new sp
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
139 // _thread_ thread object address, passed as argument to entry point
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
140 // _entry_ entry point address.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
141 // _id_ bit pattern used in initializing registers, for debugging.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
142 #define HAL_THREAD_INIT_CONTEXT( _sparg_, _thread_, _entry_, _id_ ) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
143 { \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
144 int _i_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
145 register CYG_WORD _sp_ = ((CYG_WORD)_sparg_); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
146 register HAL_SavedRegisters *_regs_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
147 _regs_ = (HAL_SavedRegisters *)(((_sp_) - sizeof(HAL_SavedRegisters)) & ~(CYGARC_ALIGNMENT));\
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
148 _sp_ &= ~(CYGARC_ALIGNMENT); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
149 for( _i_ = 1; _i_ < 32; _i_++ ) (_regs_)->r[_i_] = (_id_)|_i_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
150 (_regs_)->r[1] = (CYG_HAL_OPENRISC_REG)(_sp_); /* SP = top of stack */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
151 (_regs_)->r[2] = (CYG_HAL_OPENRISC_REG)(_sp_); /* FP = top of stack */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
152 (_regs_)->r[3] = (CYG_HAL_OPENRISC_REG)(_thread_); /* R3 = arg1 = thread ptr */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
153 (_regs_)->maclo = 0; /* MACLO = 0 */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
154 (_regs_)->machi = 0; /* MACHI = 0 */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
155 (_regs_)->sr = (SPR_SR_TEE|SPR_SR_IEE); /* Interrupts enabled */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
156 (_regs_)->pc = (CYG_HAL_OPENRISC_REG)(_entry_); /* PC = entry point */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
157 (_regs_)->r[9] = (CYG_HAL_OPENRISC_REG)(_entry_); /* PC = entry point */ \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
158 _sparg_ = (CYG_ADDRESS)_regs_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
159 }
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
160
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
161 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
162 // Context switch macros.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
163
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
164 // The arguments to these macros are *pointers* to locations where the
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
165 // stack pointer of the thread is to be stored/retrieved, i.e. *not*
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
166 // the value of the stack pointer itself.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
167
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
168 externC void hal_thread_switch_context( CYG_ADDRESS to, CYG_ADDRESS from );
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
169 externC void hal_thread_load_context( CYG_ADDRESS to )
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
170 __attribute__ ((noreturn));
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
171
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
172 #define HAL_THREAD_SWITCH_CONTEXT(_fspptr_,_tspptr_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
173 hal_thread_switch_context( (CYG_ADDRESS)_tspptr_, \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
174 (CYG_ADDRESS)_fspptr_);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
175
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
176 #define HAL_THREAD_LOAD_CONTEXT(_tspptr_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
177 hal_thread_load_context( (CYG_ADDRESS)_tspptr_ );
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
178
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
179 // Translate a stack pointer as saved by the thread context macros above into
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
180 // a pointer to a HAL_SavedRegisters structure.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
181 #define HAL_THREAD_GET_SAVED_REGISTERS( _sp_, _regs_ ) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
182 (_regs_) = (HAL_SavedRegisters *)(_sp_)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
183
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
184 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
185 // Execution reorder barrier.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
186 // When optimizing the compiler can reorder code. In multithreaded systems
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
187 // where the order of actions is vital, this can sometimes cause problems.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
188 // This macro may be inserted into places where reordering should not happen.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
189 // The "memory" keyword is potentially unnecessary, but it is harmless to
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
190 // keep it.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
191
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
192 #define HAL_REORDER_BARRIER() asm volatile ( "" : : : "memory" )
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
193
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
194 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
195 // Breakpoint support
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
196 // HAL_BREAKPOINT() is a code sequence that will cause a breakpoint to
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
197 // occur if executed.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
198 // HAL_BREAKINST is the value of the breakpoint instruction and...
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
199 // HAL_BREAKINST_SIZE is its size in bytes and...
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
200 // HAL_BREAKINST_TYPE is its type.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
201
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
202 #define HAL_BREAKPOINT(_label_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
203 asm volatile (" .globl _" #_label_ ";" \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
204 "_" #_label_ ":" \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
205 " l.trap 1;" \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
206 );
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
207
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
208 #define HAL_BREAKINST (0x21000001) // l.trap 1 instruction
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
209
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
210 #define HAL_BREAKINST_SIZE 4
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
211
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
212 #define HAL_BREAKINST_TYPE cyg_uint32
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
213
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
214 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
215 // Thread register state manipulation for GDB support.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
216
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
217 // Default to a 32 bit register size for GDB register dumps.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
218 #ifndef CYG_HAL_GDB_REG
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
219 #define CYG_HAL_GDB_REG CYG_WORD32
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
220 #endif
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
221
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
222 // Register layout expected by GDB
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
223 typedef struct
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
224 {
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
225 CYG_HAL_OPENRISC_REG r[32]; // GPR regs
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
226 CYG_HAL_OPENRISC_REG pc; // Program Counter
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
227 CYG_HAL_OPENRISC_REG sr; // Supervisor/Status Reg
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
228 } GDB_Registers;
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
229
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
230 // Copy a set of registers from a HAL_SavedRegisters structure into a
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
231 // GDB_Registers structure.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
232 #define HAL_GET_GDB_REGISTERS( _aregval_, _regs_ ) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
233 CYG_MACRO_START \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
234 GDB_Registers *_gdb_ = (GDB_Registers *)(_aregval_); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
235 int _i_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
236 \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
237 for( _i_ = 0; _i_ < 32; _i_++ ) { \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
238 _gdb_->r[_i_] = (_regs_)->r[_i_]; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
239 } \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
240 \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
241 _gdb_->pc = (_regs_)->pc; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
242 _gdb_->sr = (_regs_)->sr; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
243 CYG_MACRO_END
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
244
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
245 // Copy a set of registers from a GDB_Registers structure into a
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
246 // HAL_SavedRegisters structure.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
247 #define HAL_SET_GDB_REGISTERS( _regs_ , _aregval_ ) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
248 CYG_MACRO_START \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
249 GDB_Registers *_gdb_ = (GDB_Registers *)(_aregval_); \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
250 int _i_; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
251 \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
252 for( _i_ = 0; _i_ < 32; _i_++ ) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
253 (_regs_)->r[_i_] = _gdb_->r[_i_]; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
254 \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
255 (_regs_)->pc = _gdb_->pc; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
256 (_regs_)->sr = _gdb_->sr; \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
257 CYG_MACRO_END
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
258
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
259 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
260 // HAL setjmp
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
261 // Note: These definitions are repeated in context.S. If changes are
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
262 // required remember to update both sets.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
263
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
264 #define CYGARC_JMP_BUF_R1 0
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
265 #define CYGARC_JMP_BUF_R2 1
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
266 #define CYGARC_JMP_BUF_R9 2
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
267 #define CYGARC_JMP_BUF_R10 3
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
268 #define CYGARC_JMP_BUF_R12 4
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
269 #define CYGARC_JMP_BUF_R14 5
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
270 #define CYGARC_JMP_BUF_R16 6
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
271 #define CYGARC_JMP_BUF_R18 7
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
272 #define CYGARC_JMP_BUF_R20 8
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
273 #define CYGARC_JMP_BUF_R22 9
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
274 #define CYGARC_JMP_BUF_R24 10
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
275 #define CYGARC_JMP_BUF_R26 11
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
276 #define CYGARC_JMP_BUF_R28 12
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
277 #define CYGARC_JMP_BUF_R30 13
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
278
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
279 #define CYGARC_JMP_BUF_SIZE 14
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
280
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
281 typedef CYG_HAL_OPENRISC_REG hal_jmp_buf[CYGARC_JMP_BUF_SIZE];
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
282
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
283 externC int hal_setjmp(hal_jmp_buf env);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
284 externC void hal_longjmp(hal_jmp_buf env, int val);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
285
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
286 //-------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
287 // Idle thread code.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
288 // This macro is called in the idle thread loop, and gives the HAL the
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
289 // chance to run code when no threads are runnable. Typical idle
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
290 // thread behaviour might be to halt the processor.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
291
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
292 externC void hal_idle_thread_action(cyg_uint32 loop_count);
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
293
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
294 #define HAL_IDLE_THREAD_ACTION(_count_) hal_idle_thread_action(_count_)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
295
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
296 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
297 // Minimal and sensible stack sizes: the intention is that applications
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
298 // will use these to provide a stack size in the first instance prior to
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
299 // proper analysis. Idle thread stack should be this big.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
300
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
301 // *** THESE ARE NOT INTENDED TO BE GUARANTEED SUFFICIENT STACK SIZES ***
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
302 // They are, however, enough to start programming.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
303 // You might, for example, need to make your stacks larger if you have
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
304 // large "auto" variables.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
305
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
306 // This is not a config option because it should not be adjusted except
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
307 // under "enough rope to hang yourself" sort of disclaimers.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
308
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
309 // Typical case stack frame size: return link + 10 caller-saved temporaries + 4 locals.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
310 #define CYGNUM_HAL_STACK_FRAME_SIZE (15 * CYG_HAL_OPENRISC_REG_SIZE)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
311
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
312 // Stack needed for a context switch:
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
313 #define CYGNUM_HAL_STACK_CONTEXT_SIZE (38 * 4) // sizeof(HAL_SavedRegisters)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
314
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
315 // Interrupt + call to ISR, interrupt_end() and the DSR
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
316 #define CYGNUM_HAL_STACK_INTERRUPT_SIZE (CYGNUM_HAL_STACK_CONTEXT_SIZE + 2*CYGNUM_HAL_STACK_FRAME_SIZE)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
317
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
318 // We define a minimum stack size as the minimum any thread could ever
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
319 // legitimately get away with. We can throw asserts if users ask for less
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
320 // than this. Allow enough for three interrupt sources - clock, serial and
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
321 // one other
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
322
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
323 // If interrupts are segregated onto their own stack...
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
324 #ifdef CYGIMP_HAL_COMMON_INTERRUPTS_USE_INTERRUPT_STACK
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
325
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
326 // An interrupt stack which is large enough for all possible interrupt
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
327 // conditions (and only used for that purpose) exists. "User" stacks
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
328 // can therefore be much smaller
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
329 // NOTE - interrupt stack sizes can be smaller if we don't allow interrupts
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
330 // to nest.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
331
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
332 # define CYGNUM_HAL_STACK_SIZE_MINIMUM \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
333 ((3 * 5)*CYGNUM_HAL_STACK_FRAME_SIZE + 2*CYGNUM_HAL_STACK_INTERRUPT_SIZE)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
334
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
335 #else
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
336
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
337 // No separate interrupt stack exists. Make sure all threads contain
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
338 // a stack sufficiently large
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
339 # define CYGNUM_HAL_STACK_SIZE_MINIMUM \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
340 (( 3*CYGNUM_HAL_STACK_INTERRUPT_SIZE) + \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
341 (25*CYGNUM_HAL_STACK_FRAME_SIZE))
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
342 #endif
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
343
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
344 // Now make a reasonable choice for a typical thread size. Pluck figures
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
345 // from thin air and say 40 call frames
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
346 #define CYGNUM_HAL_STACK_SIZE_TYPICAL \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
347 (CYGNUM_HAL_STACK_SIZE_MINIMUM + \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
348 40 * (CYGNUM_HAL_STACK_FRAME_SIZE))
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
349
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
350 #endif /* __ASSEMBLER__ */
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
351
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
352 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
353 // Macros for switching context between two eCos instances (jump from
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
354 // code in ROM to code in RAM or vice versa).
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
355 // These are NOP's in the case of OpenRISC.
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
356 #define CYGARC_HAL_SAVE_GP()
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
357 #define CYGARC_HAL_RESTORE_GP()
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
358
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
359 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
360 // Macro for finding return address of current function
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
361 #define CYGARC_HAL_GET_RETURN_ADDRESS(_x_, _dummy_) \
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
362 asm volatile ( "l.ori %0,r9,0;" : "=r" (_x_) )
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
363
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
364 #define CYGARC_HAL_GET_RETURN_ADDRESS_BACKUP(_dummy_)
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
365
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
366 //--------------------------------------------------------------------------
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
367 #endif // CYGONCE_HAL_HAL_ARCH_H
38840e07f305 Add OpenRISC port
jlarmour
parents:
diff changeset
368 // End of hal_arch.h