sal.h

嵌入式系统设计与实例开发实验教材二源码 多线程应用程序设计 串行端口程序设计 AD接口实验 CAN总线通信实验 GPS通信实验 Linux内核移植与编译实验 IC卡读写实验 SD驱动使

#ifndef _ASM_IA64_SAL_H
#define _ASM_IA64_SAL_H

/*
 * System Abstraction Layer definitions.
 *
 * This is based on version 2.5 of the manual "IA-64 System
 * Abstraction Layer".
 *
 * Copyright (C) 2001 Intel
 * Copyright (C) 2001 Fred Lewis <[e-mail]>
 * Copyright (C) 1998, 1999, 2001 Hewlett-Packard Co
 * Copyright (C) 1998, 1999, 2001 David Mosberger-Tang <[e-mail]>
 * Copyright (C) 1999 Srinivasa Prasad Thirumalachar <[e-mail]>
 *
 * 01/01/03 fvlewis Updated Error Record Structures to conform with Nov. 2000
 *                  revision of the SAL spec.
 * 99/09/29 davidm	Updated for SAL 2.6.
 * 00/03/29 cfleck      Updated SAL Error Logging info for processor (SAL 2.6) 
 *                      (plus examples of platform error info structures from smariset @ Intel)
 */

#include <linux/spinlock.h>

#include <asm/pal.h>
#include <asm/efi.h>
#include <asm/system.h>
#include <asm/fpu.h>

extern spinlock_t sal_lock;

/* SAL spec _requires_ eight args for each call. */
#define __SAL_CALL(result,a0,a1,a2,a3,a4,a5,a6,a7)	\
	result = (*ia64_sal)(a0,a1,a2,a3,a4,a5,a6,a7)

# define SAL_CALL(result,args...) do {			\
	unsigned long flags;				\
	spin_lock_irqsave(&sal_lock, flags);		\
	__SAL_CALL(result,args);			\
	spin_unlock_irqrestore(&sal_lock, flags);	\
} while (0)

#define SAL_SET_VECTORS			0x01000000
#define SAL_GET_STATE_INFO		0x01000001
#define SAL_GET_STATE_INFO_SIZE		0x01000002
#define SAL_CLEAR_STATE_INFO		0x01000003
#define SAL_MC_RENDEZ			0x01000004
#define SAL_MC_SET_PARAMS		0x01000005
#define SAL_REGISTER_PHYSICAL_ADDR	0x01000006

#define SAL_CACHE_FLUSH			0x01000008
#define SAL_CACHE_INIT			0x01000009
#define SAL_PCI_CONFIG_READ		0x01000010
#define SAL_PCI_CONFIG_WRITE		0x01000011
#define SAL_FREQ_BASE			0x01000012

#define SAL_UPDATE_PAL			0x01000020

struct ia64_sal_retval {
	/*
	 * A zero status value indicates call completed without error.
	 * A negative status value indicates reason of call failure.
	 * A positive status value indicates success but an
	 * informational value should be printed (e.g., "reboot for
	 * change to take effect").
	 */
	s64 status;
	u64 v0;
	u64 v1;
	u64 v2;
};

typedef struct ia64_sal_retval (*ia64_sal_handler) (u64, ...);

enum {
	SAL_FREQ_BASE_PLATFORM = 0,
	SAL_FREQ_BASE_INTERVAL_TIMER = 1,
	SAL_FREQ_BASE_REALTIME_CLOCK = 2
};

/*
 * The SAL system table is followed by a variable number of variable
 * length descriptors.  The structure of these descriptors follows
 * below.
 * The defininition follows SAL specs from July 2000
 */
struct ia64_sal_systab {
	u8 signature[4];	/* should be "SST_" */
	u32 size;		/* size of this table in bytes */
	u8 sal_rev_minor;
	u8 sal_rev_major;
	u16 entry_count;	/* # of entries in variable portion */
	u8 checksum;
	u8 reserved1[7];
	u8 sal_a_rev_minor;
	u8 sal_a_rev_major;
	u8 sal_b_rev_minor;
	u8 sal_b_rev_major;
	/* oem_id & product_id: terminating NUL is missing if string is exactly 32 bytes long. */
	u8 oem_id[32];
	u8 product_id[32];	/* ASCII product id  */
	u8 reserved2[8];
};

enum sal_systab_entry_type {
	SAL_DESC_ENTRY_POINT = 0,
	SAL_DESC_MEMORY = 1,
	SAL_DESC_PLATFORM_FEATURE = 2,
	SAL_DESC_TR = 3,
	SAL_DESC_PTC = 4,
	SAL_DESC_AP_WAKEUP = 5
};

/*
 * Entry type:	Size:
 *	0	48
 *	1	32
 *	2	16
 *	3	32
 *	4	16
 *	5	16
 */
#define SAL_DESC_SIZE(type)	"\060\040\020\040\020\020"[(unsigned) type]

typedef struct ia64_sal_desc_entry_point {
	u8 type;
	u8 reserved1[7];
	u64 pal_proc;
	u64 sal_proc;
	u64 gp;
	u8 reserved2[16];
}ia64_sal_desc_entry_point_t;

typedef struct ia64_sal_desc_memory {
	u8 type;
	u8 used_by_sal;	/* needs to be mapped for SAL? */
	u8 mem_attr;		/* current memory attribute setting */
	u8 access_rights;	/* access rights set up by SAL */
	u8 mem_attr_mask;	/* mask of supported memory attributes */
	u8 reserved1;
	u8 mem_type;		/* memory type */
	u8 mem_usage;		/* memory usage */
	u64 addr;		/* physical address of memory */
	u32 length;	/* length (multiple of 4KB pages) */
	u32 reserved2;
	u8 oem_reserved[8];
} ia64_sal_desc_memory_t;

#define IA64_SAL_PLATFORM_FEATURE_BUS_LOCK		(1 << 0)
#define IA64_SAL_PLATFORM_FEATURE_IRQ_REDIR_HINT	(1 << 1)
#define IA64_SAL_PLATFORM_FEATURE_IPI_REDIR_HINT	(1 << 2)

typedef struct ia64_sal_desc_platform_feature {
	u8 type;
	u8 feature_mask;
	u8 reserved1[14];
} ia64_sal_desc_platform_feature_t;

typedef struct ia64_sal_desc_tr {
	u8 type;
	u8 tr_type;		/* 0 == instruction, 1 == data */
	u8 regnum;		/* translation register number */
	u8 reserved1[5];
	u64 addr;		/* virtual address of area covered */
	u64 page_size;		/* encoded page size */
	u8 reserved2[8];
} ia64_sal_desc_tr_t;

typedef struct ia64_sal_desc_ptc {
	u8 type;
	u8 reserved1[3];
	u32 num_domains;	/* # of coherence domains */
	u64 domain_info;	/* physical address of domain info table */
} ia64_sal_desc_ptc_t;

typedef struct ia64_sal_ptc_domain_info {
	u64 proc_count;		/* number of processors in domain */
	u64 proc_list;		/* physical address of LID array */
} ia64_sal_ptc_domain_info_t;

typedef struct ia64_sal_ptc_domain_proc_entry {
	u64 id  : 8;		/* id of processor */
	u64 eid : 8;		/* eid of processor */
} ia64_sal_ptc_domain_proc_entry_t;


#define IA64_SAL_AP_EXTERNAL_INT 0

typedef struct ia64_sal_desc_ap_wakeup {
	u8 type;
	u8 mechanism;		/* 0 == external interrupt */
	u8 reserved1[6];
	u64 vector;		/* interrupt vector in range 0x10-0xff */
} ia64_sal_desc_ap_wakeup_t ;

extern ia64_sal_handler ia64_sal;
extern struct ia64_sal_desc_ptc *ia64_ptc_domain_info;

extern const char *ia64_sal_strerror (long status);
extern void ia64_sal_init (struct ia64_sal_systab *sal_systab);

/* SAL information type encodings */
enum {
	SAL_INFO_TYPE_MCA	=		0,	/* Machine check abort information */
        SAL_INFO_TYPE_INIT	=		1,	/* Init information */
        SAL_INFO_TYPE_CMC   =       2,  /* Corrected machine check information */
        SAL_INFO_TYPE_CPE   =       3   /* Corrected platform error information */
};

/* Encodings for machine check parameter types */
enum {
        SAL_MC_PARAM_RENDEZ_INT		=	1,	/* Rendezevous interrupt */
        SAL_MC_PARAM_RENDEZ_WAKEUP  =   2,  /* Wakeup */
        SAL_MC_PARAM_CPE_INT        =   3   /* Corrected Platform Error Int */
};

/* Encodings for rendezvous mechanisms */
enum {
        SAL_MC_PARAM_MECHANISM_INT	=	1,	/* Use interrupt */
        SAL_MC_PARAM_MECHANISM_MEM	=	2	/* Use memory synchronization variable*/
};

/* Encodings for vectors which can be registered by the OS with SAL */
enum {
	SAL_VECTOR_OS_MCA		= 0,
	SAL_VECTOR_OS_INIT		= 1,
	SAL_VECTOR_OS_BOOT_RENDEZ	= 2
};

/*
** Definition of the SAL Error Log from the SAL spec
*/

/* SAL Error Record Section GUID Definitions */
#define SAL_PROC_DEV_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf1, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_MEM_DEV_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf2, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_SEL_DEV_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf3, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_PCI_BUS_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf4, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_SMBIOS_DEV_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf5, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_PCI_COMP_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf6, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_SPECIFIC_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf7, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_HOST_CTLR_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf8, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )
#define SAL_PLAT_BUS_ERR_SECT_GUID  \
    ((efi_guid_t) { 0xe429faf9, 0x3cb7, 0x11d4, { 0xbc, 0xa7, 0x0, 0x80, \
                    0xc7, 0x3c, 0x88, 0x81 }} )

#define MAX_CACHE_ERRORS			6
#define MAX_TLB_ERRORS				6
#define MAX_BUS_ERRORS				1

/* Definition of version  according to SAL spec for logging purposes */
typedef struct sal_log_revision
{
    u8  minor;              /* BCD (0..99) */
    u8  major;              /* BCD (0..99) */
} sal_log_revision_t;

/* Definition of timestamp according to SAL spec for logging purposes */
typedef struct sal_log_timestamp
{
	u8 slh_second;		/* Second (0..59) */
    u8 slh_minute;      /* Minute (0..59) */
    u8 slh_hour;        /* Hour (0..23) */
    u8 slh_reserved;
    u8 slh_day;         /* Day (1..31) */
    u8 slh_month;       /* Month (1..12) */
    u8 slh_year;        /* Year (00..99) */
    u8 slh_century;     /* Century (19, 20, 21, ...) */
} sal_log_timestamp_t;

/* Definition of log record  header structures */
typedef struct sal_log_record_header
{
    u64                 id;             /* Unique monotonically increasing ID */
    sal_log_revision_t  revision;       /* Major and Minor revision of header */
    u16                 severity;       /* Error Severity */
    u32                 len;            /* Length of this error log in bytes */
    sal_log_timestamp_t timestamp;      /* Timestamp */
    efi_guid_t          platform_guid;  /* Unique OEM Platform ID */
} sal_log_record_header_t;

/* Definition of log section header structures */
typedef struct sal_log_sec_header
{
    efi_guid_t          guid;       /* Unique Section ID */
    sal_log_revision_t  revision;   /* Major and Minor revision of Section */
    u16                 reserved;
    u32                 len;        /* Section length */
} sal_log_section_hdr_t;

typedef struct sal_log_mod_error_info
{
    struct
    {
        u64 check_info              : 1,
            requestor_identifier    : 1,
            responder_identifier    : 1,
            target_identifier       : 1,
            precise_ip              : 1,
            reserved                : 59;
    } valid;
    u64 check_info;
    u64 requestor_identifier;
    u64 responder_identifier;
    u64 target_identifier;
    u64 precise_ip;
} sal_log_mod_error_info_t;

typedef struct sal_processor_static_info
{
    struct
    {
        u64 minstate        : 1,
            br              : 1,
            cr              : 1,
            ar              : 1,
            rr              : 1,
            fr              : 1,
            reserved        : 58;
    } valid;
    pal_min_state_area_t    min_state_area;
    u64                     br[8];
    u64                     cr[128];
    u64                     ar[128];
    u64                     rr[8];
    struct ia64_fpreg       fr[128];
} sal_processor_static_info_t;

typedef struct sal_log_processor_info
{
    sal_log_section_hdr_t       header;
    struct
    {
        u64 proc_error_map      : 1,
            proc_state_param    : 1,
            proc_cr_lid         : 1,
            psi_static_struct   : 1,
            num_cache_check     : 4,
            num_tlb_check       : 4,
            num_bus_check       : 4,
            num_reg_file_check  : 4,
            num_ms_check        : 4,
            cpuid_info          : 1,
            reserved1           : 39;
    } valid;
    u64                         proc_error_map;
    u64                         proc_state_parameter;
    u64                         proc_cr_lid;
    sal_log_mod_error_info_t    cache_check_info[16];
    sal_log_mod_error_info_t    tlb_check_info[16];
    sal_log_mod_error_info_t    bus_check_info[16];
    sal_log_mod_error_info_t    reg_file_check_info[16];
    sal_log_mod_error_info_t    ms_check_info[16];
    struct
    {
        u64 regs[5];
        u64 reserved;
    } cpuid_info;
    sal_processor_static_info_t processor_static_info;
} sal_log_processor_info_t;

/* platform error log structures */

typedef struct sal_log_mem_dev_err_info
{
    sal_log_section_hdr_t   header;
    struct
    {
        u64 error_status    : 1,
            physical_addr   : 1,
            addr_mask       : 1,
            node            : 1,
            card            : 1,
            module          : 1,