source: rtems/c/src/lib/libcpu/powerpc/mpc750/exceptions/raw_exception.h @ a4f6b02

/*
 * raw_execption.h
 *
 *          This file contains implementation of C function to
 *          Instanciate 60x ppc primary exception entries.
 *          More detailled information can be found on motorola
 *          site and more precisely in the following book :
 *
 *              MPC750 
 *              Risc Microporcessor User's Manual
 *              Mtorola REF : MPC750UM/AD 8/97
 *
 * Copyright (C) 1999  Eric Valette (valette@crf.canon.fr)
 *                     Canon Centre Recherche France.
 *
 *  The license and distribution terms for this file may be
 *  found in found in the file LICENSE in this distribution or at
 *  http://www.OARcorp.com/rtems/license.html.
 *
 * $Id$
 */

#ifndef _LIBCPU_MCP750_EXCEPTION_RAW_EXCEPTION_H
#define _LIBCPU_MCP750_EXCEPTION_RAW_EXCEPTION_H

/*
 * Exception Vectors as defined in the MCP750 manual
 */

#define ASM_RESET_VECTOR        0x01
#define ASM_MACH_VECTOR         0x02
#define ASM_PROT_VECTOR         0x03
#define ASM_ISI_VECTOR          0x04
#define ASM_EXT_VECTOR          0x05
#define ASM_ALIGN_VECTOR        0x06
#define ASM_PROG_VECTOR         0x07
#define ASM_FLOAT_VECTOR        0x08
#define ASM_DEC_VECTOR          0x09
#define ASM_SYS_VECTOR          0x0C
#define ASM_TRACE_VECTOR        0x0D
#define ASM_ADDR_VECTOR         0x13
#define ASM_SYSMGMT_VECTOR      0x14
#define ASM_ITM_VECTOR          0x17
#define LAST_VALID_EXC          ASM_ITM_VECTOR

/*
 * Vector offsets as defined in the MCP750 manual
 */

#define ASM_RESET_VECTOR_OFFSET         (ASM_RESET_VECTOR << 8)
#define ASM_MACH_VECTOR_OFFSET          (ASM_MACH_VECTOR  << 8)
#define ASM_PROT_VECTOR_OFFSET          (ASM_PROT_VECTOR  << 8)
#define ASM_ISI_VECTOR_OFFSET           (ASM_ISI_VECTOR   << 8)
#define ASM_EXT_VECTOR_OFFSET           (ASM_EXT_VECTOR   << 8)
#define ASM_ALIGN_VECTOR_OFFSET         (ASM_ALIGN_VECTOR << 8)
#define ASM_PROG_VECTOR_OFFSET          (ASM_PROG_VECTOR  << 8)
#define ASM_FLOAT_VECTOR_OFFSET         (ASM_FLOAT_VECTOR << 8)
#define ASM_DEC_VECTOR_OFFSET           (ASM_DEC_VECTOR   << 8)
#define ASM_SYS_VECTOR_OFFSET           (ASM_SYS_VECTOR   << 8)
#define ASM_TRACE_VECTOR_OFFSET         (ASM_TRACE_VECTOR << 8)
#define ASM_ADDR_VECTOR_OFFSET          (ASM_ADDR_VECTOR  << 8)
#define ASM_SYSMGMT_VECTOR_OFFSET       (ASM_SYSMGMT_VECTOR << 8)
#define ASM_ITM_VECTOR_OFFSET           (ASM_ITM_VECTOR   << 8)


#ifndef ASM

/*
 * Type definition for raw exceptions. 
 */

typedef unsigned char  rtems_vector;
struct  __rtems_raw_except_connect_data__;
typedef void            (*rtems_raw_except_func)                (void);
typedef unsigned char   rtems_raw_except_hdl_size;

typedef struct {
  rtems_vector                  vector;
  rtems_raw_except_func         raw_hdl;
  rtems_raw_except_hdl_size     raw_hdl_size;
}rtems_raw_except_hdl;
  
typedef void (*rtems_raw_except_enable)         (const struct __rtems_raw_except_connect_data__*);
typedef void (*rtems_raw_except_disable)        (const struct __rtems_raw_except_connect_data__*);
typedef int  (*rtems_raw_except_is_enabled)     (const struct __rtems_raw_except_connect_data__*);

typedef struct __rtems_raw_except_connect_data__{
 /*
  * Exception vector (As defined in the manual)
  */
  rtems_vector                  exceptIndex;
  /*
   * Exception raw handler. See comment on handler properties below in function prototype.
   */
  rtems_raw_except_hdl          hdl;
  /*
   * function for enabling raw exceptions. In order to be consistent
   * with the fact that the raw connexion can defined in the
   * libcpu library, this library should have no knowledge of
   * board specific hardware to manage exceptions and thus the
   * "on" routine must enable the except at processor level only.
   * 
   */
    rtems_raw_except_enable     on;     
  /*
   * function for disabling raw exceptions. In order to be consistent
   * with the fact that the raw connexion can defined in the
   * libcpu library, this library should have no knowledge of
   * board specific hardware to manage exceptions and thus the
   * "on" routine must disable the except both at device and PIC level.
   * 
   */
  rtems_raw_except_disable      off;
  /*
   * function enabling to know what exception may currently occur
   */
  rtems_raw_except_is_enabled   isOn;
}rtems_raw_except_connect_data;

typedef struct {
  /*
   * size of all the table fields (*Tbl) described below.
   */
  unsigned int                          exceptSize;
  /*
   * Default handler used when disconnecting exceptions.
   */
  rtems_raw_except_connect_data         defaultRawEntry;
  /*
   * Table containing initials/current value.
   */
  rtems_raw_except_connect_data*        rawExceptHdlTbl;
}rtems_raw_except_global_settings;

/*
 * C callable function enabling to set up one raw idt entry
 */
extern int mpc60x_set_exception (const rtems_raw_except_connect_data*);

/*
 * C callable function enabling to get one current raw idt entry
 */
extern int mpc60x_get_current_exception (rtems_raw_except_connect_data*);

/*
 * C callable function enabling to remove one current raw idt entry
 */
extern int mpc60x_delete_exception (const rtems_raw_except_connect_data*);

/*
 * C callable function enabling to check if vector is valid
 */
extern int mpc750_vector_is_valid(rtems_vector vector);

inline static  void* mpc60x_get_vector_addr(rtems_vector vector)
{
  return ((void*)  (((unsigned) vector) << 8));
}
/*
 * Exception global init.
 */
extern int mpc60x_init_exceptions (rtems_raw_except_global_settings* config);
extern int mpc60x_get_exception_config (rtems_raw_except_global_settings** config);

# endif /* ASM */

#endif