1 //==========================================================================
5 // HAL miscellaneous functions
7 //==========================================================================
8 //####ECOSGPLCOPYRIGHTBEGIN####
9 // -------------------------------------------
10 // This file is part of eCos, the Embedded Configurable Operating System.
11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
13 // eCos is free software; you can redistribute it and/or modify it under
14 // the terms of the GNU General Public License as published by the Free
15 // Software Foundation; either version 2 or (at your option) any later version.
17 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
18 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22 // You should have received a copy of the GNU General Public License along
23 // with eCos; if not, write to the Free Software Foundation, Inc.,
24 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
26 // As a special exception, if other files instantiate templates or use macros
27 // or inline functions from this file, or you compile this file and link it
28 // with other works to produce a work based on this file, this file does not
29 // by itself cause the resulting work to be covered by the GNU General Public
30 // License. However the source code for this file must still be made available
31 // in accordance with section (3) of the GNU General Public License.
33 // This exception does not invalidate any other reasons why a work based on
34 // this file might be covered by the GNU General Public License.
36 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
37 // at http://sources.redhat.com/ecos/ecos-license/
38 // -------------------------------------------
39 //####ECOSGPLCOPYRIGHTEND####
40 //==========================================================================
41 //#####DESCRIPTIONBEGIN####
44 // Contributors: nickg, jlarmour
46 // Purpose: HAL miscellaneous functions
47 // Description: This file contains miscellaneous functions provided by the
50 //####DESCRIPTIONEND####
52 //========================================================================*/
54 #include <pkgconf/hal.h>
56 #include <cyg/infra/cyg_type.h> // Base types
57 #include <cyg/infra/cyg_trac.h> // tracing macros
58 #include <cyg/infra/cyg_ass.h> // assertion macros
60 #define CYGARC_HAL_COMMON_EXPORT_CPU_MACROS
61 #include <cyg/hal/hal_arch.h> // architectural definitions
63 #include <cyg/hal/hal_intr.h> // Interrupt handling
65 #include <cyg/hal/hal_cache.h> // Cache handling
67 /*------------------------------------------------------------------------*/
68 /* If required, define a variable to store the clock period. */
70 #ifdef CYGHWR_HAL_CLOCK_PERIOD_DEFINED
72 CYG_WORD32 cyg_hal_clock_period;
76 /*------------------------------------------------------------------------*/
77 /* First level C exception handler. */
79 externC void __handle_exception (void);
81 externC HAL_SavedRegisters *_hal_registers;
83 #if defined(CYGDBG_HAL_DEBUG_GDB_INCLUDE_STUBS)
84 externC void* volatile __mem_fault_handler;
87 externC cyg_uint32 cyg_hal_exception_handler(HAL_SavedRegisters *regs)
89 int vec = regs->vector;
91 // adjust PC after 'break' insns
92 if (vec == CYGNUM_HAL_VECTOR_IRQ) {
93 if (__read_prog_uint16((void *)(regs->spc_irq - 2)) == HAL_BREAKINST)
97 #if defined(CYGDBG_HAL_DEBUG_GDB_INCLUDE_STUBS)
99 // If we caught an exception inside the stubs, see if we were expecting it
100 // and if so jump to the saved address
101 if (__mem_fault_handler) {
103 case CYGNUM_HAL_VECTOR_SWI:
104 regs->a[6] = (CYG_ADDRWORD)__mem_fault_handler;
106 case CYGNUM_HAL_VECTOR_FIQ:
107 regs->spc_fiq = (CYG_ADDRWORD)__mem_fault_handler;
110 regs->spc_irq = (CYG_ADDRWORD)__mem_fault_handler;
113 return 0; // Caught an exception inside stubs
116 // Set the pointer to the registers of the current exception
117 // context. At entry the GDB stub will expand the
118 // HAL_SavedRegisters structure into a (bigger) register array.
119 _hal_registers = regs;
120 __handle_exception();
122 #elif defined(CYGFUN_HAL_COMMON_KERNEL_SUPPORT) && defined(CYGPKG_HAL_EXCEPTIONS)
124 // We should decode the vector and pass a more appropriate
125 // value as the second argument. For now we simply pass a
126 // pointer to the saved registers. We should also divert
127 // breakpoint and other debug vectors into the debug stubs.
129 cyg_hal_deliver_exception( vec, (CYG_ADDRWORD)regs );
133 CYG_FAIL("Exception!!!");
139 /*------------------------------------------------------------------------*/
142 #ifndef CYGSEM_HAL_VIRTUAL_VECTOR_SUPPORT
143 externC cyg_uint32 hal_default_isr(CYG_ADDRWORD vector, CYG_ADDRWORD data)
145 #if defined(CYGDBG_HAL_CALM32_DEBUG_GDB_CTRLC_SUPPORT) && \
146 defined(CYGHWR_HAL_GDB_PORT_VECTOR) && \
147 defined(HAL_CTRLC_ISR)
149 #ifndef CYGIMP_HAL_COMMON_INTERRUPTS_CHAIN
150 if( vector == CYGHWR_HAL_GDB_PORT_VECTOR )
153 cyg_uint32 result = HAL_CTRLC_ISR( vector, data );
154 if( result != 0 ) return result;
157 #if defined(CYGSEM_HAL_USE_ROM_MONITOR_CygMon)
158 #if defined(HAL_DIAG_IRQ_CHECK)
161 /* let ROM monitor handle unexpected interrupts */
162 HAL_DIAG_IRQ_CHECK(vector, ret);
166 #endif // def HAL_DIAG_IRQ_CHECK
167 #endif // def CYGSEM_HAL_USE_ROM_MONITOR_CygMon
170 CYG_TRACE1(true, "Interrupt: %d", vector);
171 CYG_FAIL("Spurious Interrupt!!!");
175 #else // CYGSEM_HAL_VIRTUAL_VECTOR_SUPPORT
177 externC cyg_uint32 hal_arch_default_isr(CYG_ADDRWORD vector, CYG_ADDRWORD data)
179 #if defined(CYGDBG_HAL_CALM16_DEBUG_GDB_CTRLC_SUPPORT) && \
180 defined(CYGHWR_HAL_GDB_PORT_VECTOR) && \
181 defined(HAL_CTRLC_ISR)
183 #if defined(CYGSEM_HAL_USE_ROM_MONITOR_CygMon)
184 #if defined(HAL_DIAG_IRQ_CHECK)
187 /* let ROM monitor handle unexpected interrupts */
188 HAL_DIAG_IRQ_CHECK(vector, ret);
192 #endif // def HAL_DIAG_IRQ_CHECK
193 #endif // def CYGSEM_HAL_USE_ROM_MONITOR_CygMon
199 #endif // CYGSEM_HAL_VIRTUAL_VECTOR_SUPPORT
201 /*------------------------------------------------------------------------*/
202 /* data copy and bss zero functions */
204 typedef void (CYG_SYM_ADDRESS)(void);
206 // All these must use this type of address to stop them being given relocations
207 // relative to $gp (i.e. assuming they would be in .sdata)
208 extern CYG_SYM_ADDRESS __ram_data_start;
209 extern CYG_SYM_ADDRESS __ram_data_end;
210 extern CYG_SYM_ADDRESS __rom_data_start;
212 #ifdef CYG_HAL_STARTUP_ROM
213 void hal_copy_data(void)
215 short *p = (short *)&__ram_data_start;
216 short *q = (short *)&__rom_data_start;
219 while( p != (short *)&__ram_data_end ) {
220 asm volatile( "ldc %0,@%1\n" : "=r"(x) : "r"(q) );
227 extern CYG_SYM_ADDRESS __bss_start;
228 extern CYG_SYM_ADDRESS __bss_end;
230 void hal_zero_bss(void)
232 short *p = (short *)&__bss_start;
234 while( p != (short *)&__bss_end )
238 /*------------------------------------------------------------------------*/
240 #ifdef CYGSEM_HAL_STOP_CONSTRUCTORS_ON_FLAG
241 cyg_bool cyg_hal_stop_constructors;
244 typedef void (*pfunc) (void);
245 extern pfunc __CTOR_LIST__[];
246 extern pfunc __CTOR_END__[];
249 cyg_hal_invoke_constructors(void)
251 #ifdef CYGSEM_HAL_STOP_CONSTRUCTORS_ON_FLAG
252 static pfunc *p = &__CTOR_END__[-1];
254 cyg_hal_stop_constructors = 0;
255 for (; p >= __CTOR_LIST__; p--) {
257 if (cyg_hal_stop_constructors) {
265 for (p = &__CTOR_END__[-1]; p >= __CTOR_LIST__; p--)
269 } // cyg_hal_invoke_constructors()
271 /*------------------------------------------------------------------------*/
272 /* Determine the index of the ls bit of the supplied mask. */
274 cyg_uint32 hal_lsbit_index(cyg_uint32 mask)
278 static const signed char tab[64] =
279 { -1, 0, 1, 12, 2, 6, 0, 13, 3, 0, 7, 0, 0, 0, 0, 14, 10,
280 4, 0, 0, 8, 0, 0, 25, 0, 0, 0, 0, 0, 21, 27 , 15, 31, 11,
281 5, 0, 0, 0, 0, 0, 9, 0, 0, 24, 0, 0 , 20, 26, 30, 0, 0, 0,
282 0, 23, 0, 19, 29, 0, 22, 18, 28, 17, 16, 0
293 /*------------------------------------------------------------------------*/
294 /* Determine the index of the ms bit of the supplied mask. */
296 cyg_uint32 hal_msbit_index(cyg_uint32 mask)
301 /* Phase 1: make word with all ones from that one to the right */
308 /* Phase 2: calculate number of "1" bits in the word */
309 w = (x & 0x55555555) + ((x >> 1) & 0x55555555);
310 w = (w & 0x33333333) + ((w >> 2) & 0x33333333);
312 w = (w & 0x000F000F) + ((w >> 8) & 0x000F000F);
313 return (cyg_uint32)((w + (w >> 16)) & 0xFF) - 1;
317 /*------------------------------------------------------------------------*/
318 /* Idle thread action */
320 #include <cyg/infra/diag.h>
322 void hal_idle_thread_action( cyg_uint32 count )
326 /*------------------------------------------------------------------------*/
327 /* End of hal_misc.c */