RTEMS 4.0.0 On-Line Library

Processor Dependent Information Table CPU Dependent Information Table

RTEMS Intel i960 Applications Supplement

7.2: CPU Dependent Information Table

The i960CA version of the RTEMS CPU Dependent Information Table contains the information required to interface a Board Support Package and RTEMS on the i960CA. This information is provided to allow RTEMS to interoperate effectively with the BSP. The C structure definition is given here:

typedef struct {
  void        (*pretasking_hook)( void );
  void        (*predriver_hook)( void );
  void        (*postdriver_hook)( void );
  void        (*idle_task)( void );
  boolean       do_zero_of_workspace;
  unsigned32    idle_task_stack_size;
  unsigned32    interrupt_stack_size;
  unsigned32    extra_mpci_receive_server_stack;
  void       (*stack_free_hook)( void* );
  /* end of fields required on all CPUs */

#if defined(__i960CA__) || defined(__i960_CA__) || defined(__i960CA)
  i960ca_PRCB *Prcb;
#endif

} rtems_cpu_table;

The contents of the i960CA Processor Control Block are discussed in Intel's i960CA User's Manual. Structure definitions for the i960CA PRCB and Control Table are provided by including the file rtems.h.

pretasking_hook: is the address of the user provided routine which is invoked once RTEMS initialization is complete but before interrupts and tasking are enabled. This field may be NULL to indicate that the hook is not utilized.
predriver_hook: is the address of the user provided routine which is invoked with tasking enabled immediately before the MPCI and device drivers are initialized. RTEMS initialization is complete, interrupts and tasking are enabled, but no device drivers are initialized. This field may be NULL to indicate that the hook is not utilized.
postdriver_hook: is the address of the user provided routine which is invoked with tasking enabled immediately after the MPCI and device drivers are initialized. RTEMS initialization is complete, interrupts and tasking are enabled, and the device drivers are initialized. This field may be NULL to indicate that the hook is not utilized.
idle_task: is the address of the optional user provided routine which is used as the system's IDLE task. If this field is not NULL, then the RTEMS default IDLE task is not used. This field may be NULL to indicate that the default IDLE is to be used.
do_zero_of_workspace: indicates whether RTEMS should zero the Workspace as part of its initialization. If set to TRUE, the Workspace is zeroed. Otherwise, it is not.
idle_task_stack_size: is the size of the RTEMS idle task stack in bytes. If this number is less than MINIMUM_STACK_SIZE, then the idle task's stack will be MINIMUM_STACK_SIZE in byte.
interrupt_stack_size: is the size of the RTEMS allocated interrupt stack in bytes. This value must be at least as large as MINIMUM_STACK_SIZE.
extra_mpci_receive_server_stack: is the extra stack space allocated for the RTEMS MPCI receive server task in bytes. The MPCI receive server may invoke nearly all directives and may require extra stack space on some targets.
stack_allocate_hook: is the address of the optional user provided routine which allocates memory for task stacks. If this hook is not NULL, then a stack_free_hook must be provided as well.
stack_free_hook: is the address of the optional user provided routine which frees memory for task stacks. If this hook is not NULL, then a stack_allocate_hook must be provided as well.
Prcb: is the base address of the i960CA's Processor Control Block. It is primarily used by RTEMS to install interrupt handlers.

RTEMS Intel i960 Applications Supplement