forked from Imagelibrary/rtems
* cpu_supplement/arm.t, cpu_supplement/i386.t, cpu_supplement/m68k.t, cpu_supplement/mips.t, cpu_supplement/powerpc.t, cpu_supplement/sh.t, cpu_supplement/sparc.t, cpu_supplement/tic4x.t, porting/cpuinit.t, user/conf.t, user/init.t: Move interrupt_stack_size field from CPU Table to Configuration Table. Eliminate CPU Table from all ports. Delete references to CPU Table in all forms.
53 lines
1.7 KiB
Perl
53 lines
1.7 KiB
Perl
@c
|
|
@c COPYRIGHT (c) 1988-2002.
|
|
@c On-Line Applications Research Corporation (OAR).
|
|
@c All rights reserved.
|
|
@c
|
|
@c $Id$
|
|
@c
|
|
|
|
@chapter CPU Initialization
|
|
|
|
This section describes the general CPU and system initialization sequence
|
|
as it pertains to the CPU dependent code.
|
|
|
|
@section Introduction
|
|
|
|
XXX general startup sequence description rewritten to make it more
|
|
applicable to CPU depdent code in executive
|
|
|
|
@section Initializing the CPU
|
|
|
|
The _CPU_Initialize routine performs processor dependent initialization.
|
|
|
|
@example
|
|
void _CPU_Initialize(
|
|
void (*thread_dispatch) /* may be ignored */
|
|
)
|
|
@end example
|
|
|
|
The thread_dispatch argument is the address of the entry point for the
|
|
routine called at the end of an ISR once it has been decided a context
|
|
switch is necessary. On some compilation systems it is difficult to call
|
|
a high-level language routine from assembly. Providing the address of the
|
|
_Thread_ISR_Dispatch routine allows the porter an easy way to obtain this
|
|
critical address and thus provides an easy way to work around this
|
|
limitation on these systems.
|
|
|
|
If you encounter this problem save the entry point in a CPU dependent
|
|
variable as shown below:
|
|
|
|
@example
|
|
_CPU_Thread_dispatch_pointer = thread_dispatch;
|
|
@end example
|
|
|
|
|
|
During the initialization of the context for tasks with floating point,
|
|
the CPU dependent code is responsible for initializing the floating point
|
|
context. If there is not an easy way to initialize the FP context during
|
|
Context_Initialize, then it is usually easier to save an "uninitialized"
|
|
FP context here and copy it to the task's during Context_Initialize. If
|
|
this technique is used to initialize the FP contexts, then it is important
|
|
to ensure that the state of the floating point unit is in a coherent,
|
|
initialized state.
|