linux/arch/ia64/include/asm/sal.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0 */
   2#ifndef _ASM_IA64_SAL_H
   3#define _ASM_IA64_SAL_H
   4
   5/*
   6 * System Abstraction Layer definitions.
   7 *
   8 * This is based on version 2.5 of the manual "IA-64 System
   9 * Abstraction Layer".
  10 *
  11 * Copyright (C) 2001 Intel
  12 * Copyright (C) 2002 Jenna Hall <jenna.s.hall@intel.com>
  13 * Copyright (C) 2001 Fred Lewis <frederick.v.lewis@intel.com>
  14 * Copyright (C) 1998, 1999, 2001, 2003 Hewlett-Packard Co
  15 *      David Mosberger-Tang <davidm@hpl.hp.com>
  16 * Copyright (C) 1999 Srinivasa Prasad Thirumalachar <sprasad@sprasad.engr.sgi.com>
  17 *
  18 * 02/01/04 J. Hall Updated Error Record Structures to conform to July 2001
  19 *                  revision of the SAL spec.
  20 * 01/01/03 fvlewis Updated Error Record Structures to conform with Nov. 2000
  21 *                  revision of the SAL spec.
  22 * 99/09/29 davidm      Updated for SAL 2.6.
  23 * 00/03/29 cfleck      Updated SAL Error Logging info for processor (SAL 2.6)
  24 *                      (plus examples of platform error info structures from smariset @ Intel)
  25 */
  26
  27#define IA64_SAL_PLATFORM_FEATURE_BUS_LOCK_BIT          0
  28#define IA64_SAL_PLATFORM_FEATURE_IRQ_REDIR_HINT_BIT    1
  29#define IA64_SAL_PLATFORM_FEATURE_IPI_REDIR_HINT_BIT    2
  30#define IA64_SAL_PLATFORM_FEATURE_ITC_DRIFT_BIT         3
  31
  32#define IA64_SAL_PLATFORM_FEATURE_BUS_LOCK        (1<<IA64_SAL_PLATFORM_FEATURE_BUS_LOCK_BIT)
  33#define IA64_SAL_PLATFORM_FEATURE_IRQ_REDIR_HINT (1<<IA64_SAL_PLATFORM_FEATURE_IRQ_REDIR_HINT_BIT)
  34#define IA64_SAL_PLATFORM_FEATURE_IPI_REDIR_HINT (1<<IA64_SAL_PLATFORM_FEATURE_IPI_REDIR_HINT_BIT)
  35#define IA64_SAL_PLATFORM_FEATURE_ITC_DRIFT       (1<<IA64_SAL_PLATFORM_FEATURE_ITC_DRIFT_BIT)
  36
  37#ifndef __ASSEMBLY__
  38
  39#include <linux/bcd.h>
  40#include <linux/spinlock.h>
  41#include <linux/efi.h>
  42
  43#include <asm/pal.h>
  44#include <asm/fpu.h>
  45
  46extern unsigned long sal_systab_phys;
  47extern spinlock_t sal_lock;
  48
  49/* SAL spec _requires_ eight args for each call. */
  50#define __IA64_FW_CALL(entry,result,a0,a1,a2,a3,a4,a5,a6,a7)    \
  51        result = (*entry)(a0,a1,a2,a3,a4,a5,a6,a7)
  52
  53# define IA64_FW_CALL(entry,result,args...) do {                \
  54        unsigned long __ia64_sc_flags;                          \
  55        struct ia64_fpreg __ia64_sc_fr[6];                      \
  56        ia64_save_scratch_fpregs(__ia64_sc_fr);                 \
  57        spin_lock_irqsave(&sal_lock, __ia64_sc_flags);          \
  58        __IA64_FW_CALL(entry, result, args);                    \
  59        spin_unlock_irqrestore(&sal_lock, __ia64_sc_flags);     \
  60        ia64_load_scratch_fpregs(__ia64_sc_fr);                 \
  61} while (0)
  62
  63# define SAL_CALL(result,args...)                       \
  64        IA64_FW_CALL(ia64_sal, result, args);
  65
  66# define SAL_CALL_NOLOCK(result,args...) do {           \
  67        unsigned long __ia64_scn_flags;                 \
  68        struct ia64_fpreg __ia64_scn_fr[6];             \
  69        ia64_save_scratch_fpregs(__ia64_scn_fr);        \
  70        local_irq_save(__ia64_scn_flags);               \
  71        __IA64_FW_CALL(ia64_sal, result, args);         \
  72        local_irq_restore(__ia64_scn_flags);            \
  73        ia64_load_scratch_fpregs(__ia64_scn_fr);        \
  74} while (0)
  75
  76# define SAL_CALL_REENTRANT(result,args...) do {        \
  77        struct ia64_fpreg __ia64_scs_fr[6];             \
  78        ia64_save_scratch_fpregs(__ia64_scs_fr);        \
  79        preempt_disable();                              \
  80        __IA64_FW_CALL(ia64_sal, result, args);         \
  81        preempt_enable();                               \
  82        ia64_load_scratch_fpregs(__ia64_scs_fr);        \
  83} while (0)
  84
  85#define SAL_SET_VECTORS                 0x01000000
  86#define SAL_GET_STATE_INFO              0x01000001
  87#define SAL_GET_STATE_INFO_SIZE         0x01000002
  88#define SAL_CLEAR_STATE_INFO            0x01000003
  89#define SAL_MC_RENDEZ                   0x01000004
  90#define SAL_MC_SET_PARAMS               0x01000005
  91#define SAL_REGISTER_PHYSICAL_ADDR      0x01000006
  92
  93#define SAL_CACHE_FLUSH                 0x01000008
  94#define SAL_CACHE_INIT                  0x01000009
  95#define SAL_PCI_CONFIG_READ             0x01000010
  96#define SAL_PCI_CONFIG_WRITE            0x01000011
  97#define SAL_FREQ_BASE                   0x01000012
  98#define SAL_PHYSICAL_ID_INFO            0x01000013
  99
 100#define SAL_UPDATE_PAL                  0x01000020
 101
 102struct ia64_sal_retval {
 103        /*
 104         * A zero status value indicates call completed without error.
 105         * A negative status value indicates reason of call failure.
 106         * A positive status value indicates success but an
 107         * informational value should be printed (e.g., "reboot for
 108         * change to take effect").
 109         */
 110        long status;
 111        unsigned long v0;
 112        unsigned long v1;
 113        unsigned long v2;
 114};
 115
 116typedef struct ia64_sal_retval (*ia64_sal_handler) (u64, ...);
 117
 118enum {
 119        SAL_FREQ_BASE_PLATFORM = 0,
 120        SAL_FREQ_BASE_INTERVAL_TIMER = 1,
 121        SAL_FREQ_BASE_REALTIME_CLOCK = 2
 122};
 123
 124/*
 125 * The SAL system table is followed by a variable number of variable
 126 * length descriptors.  The structure of these descriptors follows
 127 * below.
 128 * The defininition follows SAL specs from July 2000
 129 */
 130struct ia64_sal_systab {
 131        u8 signature[4];        /* should be "SST_" */
 132        u32 size;               /* size of this table in bytes */
 133        u8 sal_rev_minor;
 134        u8 sal_rev_major;
 135        u16 entry_count;        /* # of entries in variable portion */
 136        u8 checksum;
 137        u8 reserved1[7];
 138        u8 sal_a_rev_minor;
 139        u8 sal_a_rev_major;
 140        u8 sal_b_rev_minor;
 141        u8 sal_b_rev_major;
 142        /* oem_id & product_id: terminating NUL is missing if string is exactly 32 bytes long. */
 143        u8 oem_id[32];
 144        u8 product_id[32];      /* ASCII product id  */
 145        u8 reserved2[8];
 146};
 147
 148enum sal_systab_entry_type {
 149        SAL_DESC_ENTRY_POINT = 0,
 150        SAL_DESC_MEMORY = 1,
 151        SAL_DESC_PLATFORM_FEATURE = 2,
 152        SAL_DESC_TR = 3,
 153        SAL_DESC_PTC = 4,
 154        SAL_DESC_AP_WAKEUP = 5
 155};
 156
 157/*
 158 * Entry type:  Size:
 159 *      0       48
 160 *      1       32
 161 *      2       16
 162 *      3       32
 163 *      4       16
 164 *      5       16
 165 */
 166#define SAL_DESC_SIZE(type)     "\060\040\020\040\020\020"[(unsigned) type]
 167
 168typedef struct ia64_sal_desc_entry_point {
 169        u8 type;
 170        u8 reserved1[7];
 171        u64 pal_proc;
 172        u64 sal_proc;
 173        u64 gp;
 174        u8 reserved2[16];
 175}ia64_sal_desc_entry_point_t;
 176
 177typedef struct ia64_sal_desc_memory {
 178        u8 type;
 179        u8 used_by_sal; /* needs to be mapped for SAL? */
 180        u8 mem_attr;            /* current memory attribute setting */
 181        u8 access_rights;       /* access rights set up by SAL */
 182        u8 mem_attr_mask;       /* mask of supported memory attributes */
 183        u8 reserved1;
 184        u8 mem_type;            /* memory type */
 185        u8 mem_usage;           /* memory usage */
 186        u64 addr;               /* physical address of memory */
 187        u32 length;     /* length (multiple of 4KB pages) */
 188        u32 reserved2;
 189        u8 oem_reserved[8];
 190} ia64_sal_desc_memory_t;
 191
 192typedef struct ia64_sal_desc_platform_feature {
 193        u8 type;
 194        u8 feature_mask;
 195        u8 reserved1[14];
 196} ia64_sal_desc_platform_feature_t;
 197
 198typedef struct ia64_sal_desc_tr {
 199        u8 type;
 200        u8 tr_type;             /* 0 == instruction, 1 == data */
 201        u8 regnum;              /* translation register number */
 202        u8 reserved1[5];
 203        u64 addr;               /* virtual address of area covered */
 204        u64 page_size;          /* encoded page size */
 205        u8 reserved2[8];
 206} ia64_sal_desc_tr_t;
 207
 208typedef struct ia64_sal_desc_ptc {
 209        u8 type;
 210        u8 reserved1[3];
 211        u32 num_domains;        /* # of coherence domains */
 212        u64 domain_info;        /* physical address of domain info table */
 213} ia64_sal_desc_ptc_t;
 214
 215typedef struct ia64_sal_ptc_domain_info {
 216        u64 proc_count;         /* number of processors in domain */
 217        u64 proc_list;          /* physical address of LID array */
 218} ia64_sal_ptc_domain_info_t;
 219
 220typedef struct ia64_sal_ptc_domain_proc_entry {
 221        u64 id  : 8;            /* id of processor */
 222        u64 eid : 8;            /* eid of processor */
 223} ia64_sal_ptc_domain_proc_entry_t;
 224
 225
 226#define IA64_SAL_AP_EXTERNAL_INT 0
 227
 228typedef struct ia64_sal_desc_ap_wakeup {
 229        u8 type;
 230        u8 mechanism;           /* 0 == external interrupt */
 231        u8 reserved1[6];
 232        u64 vector;             /* interrupt vector in range 0x10-0xff */
 233} ia64_sal_desc_ap_wakeup_t ;
 234
 235extern ia64_sal_handler ia64_sal;
 236extern struct ia64_sal_desc_ptc *ia64_ptc_domain_info;
 237
 238extern unsigned short sal_revision;     /* supported SAL spec revision */
 239extern unsigned short sal_version;      /* SAL version; OEM dependent */
 240#define SAL_VERSION_CODE(major, minor) ((bin2bcd(major) << 8) | bin2bcd(minor))
 241
 242extern const char *ia64_sal_strerror (long status);
 243extern void ia64_sal_init (struct ia64_sal_systab *sal_systab);
 244
 245/* SAL information type encodings */
 246enum {
 247        SAL_INFO_TYPE_MCA  = 0,         /* Machine check abort information */
 248        SAL_INFO_TYPE_INIT = 1,         /* Init information */
 249        SAL_INFO_TYPE_CMC  = 2,         /* Corrected machine check information */
 250        SAL_INFO_TYPE_CPE  = 3          /* Corrected platform error information */
 251};
 252
 253/* Encodings for machine check parameter types */
 254enum {
 255        SAL_MC_PARAM_RENDEZ_INT    = 1, /* Rendezvous interrupt */
 256        SAL_MC_PARAM_RENDEZ_WAKEUP = 2, /* Wakeup */
 257        SAL_MC_PARAM_CPE_INT       = 3  /* Corrected Platform Error Int */
 258};
 259
 260/* Encodings for rendezvous mechanisms */
 261enum {
 262        SAL_MC_PARAM_MECHANISM_INT = 1, /* Use interrupt */
 263        SAL_MC_PARAM_MECHANISM_MEM = 2  /* Use memory synchronization variable*/
 264};
 265
 266/* Encodings for vectors which can be registered by the OS with SAL */
 267enum {
 268        SAL_VECTOR_OS_MCA         = 0,
 269        SAL_VECTOR_OS_INIT        = 1,
 270        SAL_VECTOR_OS_BOOT_RENDEZ = 2
 271};
 272
 273/* Encodings for mca_opt parameter sent to SAL_MC_SET_PARAMS */
 274#define SAL_MC_PARAM_RZ_ALWAYS          0x1
 275#define SAL_MC_PARAM_BINIT_ESCALATE     0x10
 276
 277/*
 278 * Definition of the SAL Error Log from the SAL spec
 279 */
 280
 281/* SAL Error Record Section GUID Definitions */
 282#define SAL_PROC_DEV_ERR_SECT_GUID  \
 283    EFI_GUID(0xe429faf1, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 284#define SAL_PLAT_MEM_DEV_ERR_SECT_GUID  \
 285    EFI_GUID(0xe429faf2, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 286#define SAL_PLAT_SEL_DEV_ERR_SECT_GUID  \
 287    EFI_GUID(0xe429faf3, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 288#define SAL_PLAT_PCI_BUS_ERR_SECT_GUID  \
 289    EFI_GUID(0xe429faf4, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 290#define SAL_PLAT_SMBIOS_DEV_ERR_SECT_GUID  \
 291    EFI_GUID(0xe429faf5, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 292#define SAL_PLAT_PCI_COMP_ERR_SECT_GUID  \
 293    EFI_GUID(0xe429faf6, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 294#define SAL_PLAT_SPECIFIC_ERR_SECT_GUID  \
 295    EFI_GUID(0xe429faf7, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 296#define SAL_PLAT_HOST_CTLR_ERR_SECT_GUID  \
 297    EFI_GUID(0xe429faf8, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 298#define SAL_PLAT_BUS_ERR_SECT_GUID  \
 299    EFI_GUID(0xe429faf9, 0x3cb7, 0x11d4, 0xbc, 0xa7, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81)
 300#define PROCESSOR_ABSTRACTION_LAYER_OVERWRITE_GUID \
 301    EFI_GUID(0x6cb0a200, 0x893a, 0x11da, 0x96, 0xd2, 0x0, 0x10, 0x83, 0xff, \
 302                0xca, 0x4d)
 303
 304#define MAX_CACHE_ERRORS        6
 305#define MAX_TLB_ERRORS          6
 306#define MAX_BUS_ERRORS          1
 307
 308/* Definition of version  according to SAL spec for logging purposes */
 309typedef struct sal_log_revision {
 310        u8 minor;               /* BCD (0..99) */
 311        u8 major;               /* BCD (0..99) */
 312} sal_log_revision_t;
 313
 314/* Definition of timestamp according to SAL spec for logging purposes */
 315typedef struct sal_log_timestamp {
 316        u8 slh_second;          /* Second (0..59) */
 317        u8 slh_minute;          /* Minute (0..59) */
 318        u8 slh_hour;            /* Hour (0..23) */
 319        u8 slh_reserved;
 320        u8 slh_day;             /* Day (1..31) */
 321        u8 slh_month;           /* Month (1..12) */
 322        u8 slh_year;            /* Year (00..99) */
 323        u8 slh_century;         /* Century (19, 20, 21, ...) */
 324} sal_log_timestamp_t;
 325
 326/* Definition of log record  header structures */
 327typedef struct sal_log_record_header {
 328        u64 id;                         /* Unique monotonically increasing ID */
 329        sal_log_revision_t revision;    /* Major and Minor revision of header */
 330        u8 severity;                    /* Error Severity */
 331        u8 validation_bits;             /* 0: platform_guid, 1: !timestamp */
 332        u32 len;                        /* Length of this error log in bytes */
 333        sal_log_timestamp_t timestamp;  /* Timestamp */
 334        efi_guid_t platform_guid;       /* Unique OEM Platform ID */
 335} sal_log_record_header_t;
 336
 337#define sal_log_severity_recoverable    0
 338#define sal_log_severity_fatal          1
 339#define sal_log_severity_corrected      2
 340
 341/*
 342 * Error Recovery Info (ERI) bit decode.  From SAL Spec section B.2.2 Table B-3
 343 * Error Section Error_Recovery_Info Field Definition.
 344 */
 345#define ERI_NOT_VALID           0x0     /* Error Recovery Field is not valid */
 346#define ERI_NOT_ACCESSIBLE      0x30    /* Resource not accessible */
 347#define ERI_CONTAINMENT_WARN    0x22    /* Corrupt data propagated */
 348#define ERI_UNCORRECTED_ERROR   0x20    /* Uncorrected error */
 349#define ERI_COMPONENT_RESET     0x24    /* Component must be reset */
 350#define ERI_CORR_ERROR_LOG      0x21    /* Corrected error, needs logging */
 351#define ERI_CORR_ERROR_THRESH   0x29    /* Corrected error threshold exceeded */
 352
 353/* Definition of log section header structures */
 354typedef struct sal_log_sec_header {
 355    efi_guid_t guid;                    /* Unique Section ID */
 356    sal_log_revision_t revision;        /* Major and Minor revision of Section */
 357    u8 error_recovery_info;             /* Platform error recovery status */
 358    u8 reserved;
 359    u32 len;                            /* Section length */
 360} sal_log_section_hdr_t;
 361
 362typedef struct sal_log_mod_error_info {
 363        struct {
 364                u64 check_info              : 1,
 365                    requestor_identifier    : 1,
 366                    responder_identifier    : 1,
 367                    target_identifier       : 1,
 368                    precise_ip              : 1,
 369                    reserved                : 59;
 370        } valid;
 371        u64 check_info;
 372        u64 requestor_identifier;
 373        u64 responder_identifier;
 374        u64 target_identifier;
 375        u64 precise_ip;
 376} sal_log_mod_error_info_t;
 377
 378typedef struct sal_processor_static_info {
 379        struct {
 380                u64 minstate        : 1,
 381                    br              : 1,
 382                    cr              : 1,
 383                    ar              : 1,
 384                    rr              : 1,
 385                    fr              : 1,
 386                    reserved        : 58;
 387        } valid;
 388        struct pal_min_state_area min_state_area;
 389        u64 br[8];
 390        u64 cr[128];
 391        u64 ar[128];
 392        u64 rr[8];
 393        struct ia64_fpreg __attribute__ ((packed)) fr[128];
 394} sal_processor_static_info_t;
 395
 396struct sal_cpuid_info {
 397        u64 regs[5];
 398        u64 reserved;
 399};
 400
 401typedef struct sal_log_processor_info {
 402        sal_log_section_hdr_t header;
 403        struct {
 404                u64 proc_error_map      : 1,
 405                    proc_state_param    : 1,
 406                    proc_cr_lid         : 1,
 407                    psi_static_struct   : 1,
 408                    num_cache_check     : 4,
 409                    num_tlb_check       : 4,
 410                    num_bus_check       : 4,
 411                    num_reg_file_check  : 4,
 412                    num_ms_check        : 4,
 413                    cpuid_info          : 1,
 414                    reserved1           : 39;
 415        } valid;
 416        u64 proc_error_map;
 417        u64 proc_state_parameter;
 418        u64 proc_cr_lid;
 419        /*
 420         * The rest of this structure consists of variable-length arrays, which can't be
 421         * expressed in C.
 422         */
 423        sal_log_mod_error_info_t info[0];
 424        /*
 425         * This is what the rest looked like if C supported variable-length arrays:
 426         *
 427         * sal_log_mod_error_info_t cache_check_info[.valid.num_cache_check];
 428         * sal_log_mod_error_info_t tlb_check_info[.valid.num_tlb_check];
 429         * sal_log_mod_error_info_t bus_check_info[.valid.num_bus_check];
 430         * sal_log_mod_error_info_t reg_file_check_info[.valid.num_reg_file_check];
 431         * sal_log_mod_error_info_t ms_check_info[.valid.num_ms_check];
 432         * struct sal_cpuid_info cpuid_info;
 433         * sal_processor_static_info_t processor_static_info;
 434         */
 435} sal_log_processor_info_t;
 436
 437/* Given a sal_log_processor_info_t pointer, return a pointer to the processor_static_info: */
 438#define SAL_LPI_PSI_INFO(l)                                                                     \
 439({      sal_log_processor_info_t *_l = (l);                                                     \
 440        ((sal_processor_static_info_t *)                                                        \
 441         ((char *) _l->info + ((_l->valid.num_cache_check + _l->valid.num_tlb_check             \
 442                                + _l->valid.num_bus_check + _l->valid.num_reg_file_check        \
 443                                + _l->valid.num_ms_check) * sizeof(sal_log_mod_error_info_t)    \
 444                               + sizeof(struct sal_cpuid_info))));                              \
 445})
 446
 447/* platform error log structures */
 448
 449typedef struct sal_log_mem_dev_err_info {
 450        sal_log_section_hdr_t header;
 451        struct {
 452                u64 error_status    : 1,
 453                    physical_addr   : 1,
 454                    addr_mask       : 1,
 455                    node            : 1,
 456                    card            : 1,
 457                    module          : 1,
 458                    bank            : 1,
 459                    device          : 1,
 460                    row             : 1,
 461                    column          : 1,
 462                    bit_position    : 1,
 463                    requestor_id    : 1,
 464                    responder_id    : 1,
 465                    target_id       : 1,
 466                    bus_spec_data   : 1,
 467                    oem_id          : 1,
 468                    oem_data        : 1,
 469                    reserved        : 47;
 470        } valid;
 471        u64 error_status;
 472        u64 physical_addr;
 473        u64 addr_mask;
 474        u16 node;
 475        u16 card;
 476        u16 module;
 477        u16 bank;
 478        u16 device;
 479        u16 row;
 480        u16 column;
 481        u16 bit_position;
 482        u64 requestor_id;
 483        u64 responder_id;
 484        u64 target_id;
 485        u64 bus_spec_data;
 486        u8 oem_id[16];
 487        u8 oem_data[1];                 /* Variable length data */
 488} sal_log_mem_dev_err_info_t;
 489
 490typedef struct sal_log_sel_dev_err_info {
 491        sal_log_section_hdr_t header;
 492        struct {
 493                u64 record_id       : 1,
 494                    record_type     : 1,
 495                    generator_id    : 1,
 496                    evm_rev         : 1,
 497                    sensor_type     : 1,
 498                    sensor_num      : 1,
 499                    event_dir       : 1,
 500                    event_data1     : 1,
 501                    event_data2     : 1,
 502                    event_data3     : 1,
 503                    reserved        : 54;
 504        } valid;
 505        u16 record_id;
 506        u8 record_type;
 507        u8 timestamp[4];
 508        u16 generator_id;
 509        u8 evm_rev;
 510        u8 sensor_type;
 511        u8 sensor_num;
 512        u8 event_dir;
 513        u8 event_data1;
 514        u8 event_data2;
 515        u8 event_data3;
 516} sal_log_sel_dev_err_info_t;
 517
 518typedef struct sal_log_pci_bus_err_info {
 519        sal_log_section_hdr_t header;
 520        struct {
 521                u64 err_status      : 1,
 522                    err_type        : 1,
 523                    bus_id          : 1,
 524                    bus_address     : 1,
 525                    bus_data        : 1,
 526                    bus_cmd         : 1,
 527                    requestor_id    : 1,
 528                    responder_id    : 1,
 529                    target_id       : 1,
 530                    oem_data        : 1,
 531                    reserved        : 54;
 532        } valid;
 533        u64 err_status;
 534        u16 err_type;
 535        u16 bus_id;
 536        u32 reserved;
 537        u64 bus_address;
 538        u64 bus_data;
 539        u64 bus_cmd;
 540        u64 requestor_id;
 541        u64 responder_id;
 542        u64 target_id;
 543        u8 oem_data[1];                 /* Variable length data */
 544} sal_log_pci_bus_err_info_t;
 545
 546typedef struct sal_log_smbios_dev_err_info {
 547        sal_log_section_hdr_t header;
 548        struct {
 549                u64 event_type      : 1,
 550                    length          : 1,
 551                    time_stamp      : 1,
 552                    data            : 1,
 553                    reserved1       : 60;
 554        } valid;
 555        u8 event_type;
 556        u8 length;
 557        u8 time_stamp[6];
 558        u8 data[1];                     /* data of variable length, length == slsmb_length */
 559} sal_log_smbios_dev_err_info_t;
 560
 561typedef struct sal_log_pci_comp_err_info {
 562        sal_log_section_hdr_t header;
 563        struct {
 564                u64 err_status      : 1,
 565                    comp_info       : 1,
 566                    num_mem_regs    : 1,
 567                    num_io_regs     : 1,
 568                    reg_data_pairs  : 1,
 569                    oem_data        : 1,
 570                    reserved        : 58;
 571        } valid;
 572        u64 err_status;
 573        struct {
 574                u16 vendor_id;
 575                u16 device_id;
 576                u8 class_code[3];
 577                u8 func_num;
 578                u8 dev_num;
 579                u8 bus_num;
 580                u8 seg_num;
 581                u8 reserved[5];
 582        } comp_info;
 583        u32 num_mem_regs;
 584        u32 num_io_regs;
 585        u64 reg_data_pairs[1];
 586        /*
 587         * array of address/data register pairs is num_mem_regs + num_io_regs elements
 588         * long.  Each array element consists of a u64 address followed by a u64 data
 589         * value.  The oem_data array immediately follows the reg_data_pairs array
 590         */
 591        u8 oem_data[1];                 /* Variable length data */
 592} sal_log_pci_comp_err_info_t;
 593
 594typedef struct sal_log_plat_specific_err_info {
 595        sal_log_section_hdr_t header;
 596        struct {
 597                u64 err_status      : 1,
 598                    guid            : 1,
 599                    oem_data        : 1,
 600                    reserved        : 61;
 601        } valid;
 602        u64 err_status;
 603        efi_guid_t guid;
 604        u8 oem_data[1];                 /* platform specific variable length data */
 605} sal_log_plat_specific_err_info_t;
 606
 607typedef struct sal_log_host_ctlr_err_info {
 608        sal_log_section_hdr_t header;
 609        struct {
 610                u64 err_status      : 1,
 611                    requestor_id    : 1,
 612                    responder_id    : 1,
 613                    target_id       : 1,
 614                    bus_spec_data   : 1,
 615                    oem_data        : 1,
 616                    reserved        : 58;
 617        } valid;
 618        u64 err_status;
 619        u64 requestor_id;
 620        u64 responder_id;
 621        u64 target_id;
 622        u64 bus_spec_data;
 623        u8 oem_data[1];                 /* Variable length OEM data */
 624} sal_log_host_ctlr_err_info_t;
 625
 626typedef struct sal_log_plat_bus_err_info {
 627        sal_log_section_hdr_t header;
 628        struct {
 629                u64 err_status      : 1,
 630                    requestor_id    : 1,
 631                    responder_id    : 1,
 632                    target_id       : 1,
 633                    bus_spec_data   : 1,
 634                    oem_data        : 1,
 635                    reserved        : 58;
 636        } valid;
 637        u64 err_status;
 638        u64 requestor_id;
 639        u64 responder_id;
 640        u64 target_id;
 641        u64 bus_spec_data;
 642        u8 oem_data[1];                 /* Variable length OEM data */
 643} sal_log_plat_bus_err_info_t;
 644
 645/* Overall platform error section structure */
 646typedef union sal_log_platform_err_info {
 647        sal_log_mem_dev_err_info_t mem_dev_err;
 648        sal_log_sel_dev_err_info_t sel_dev_err;
 649        sal_log_pci_bus_err_info_t pci_bus_err;
 650        sal_log_smbios_dev_err_info_t smbios_dev_err;
 651        sal_log_pci_comp_err_info_t pci_comp_err;
 652        sal_log_plat_specific_err_info_t plat_specific_err;
 653        sal_log_host_ctlr_err_info_t host_ctlr_err;
 654        sal_log_plat_bus_err_info_t plat_bus_err;
 655} sal_log_platform_err_info_t;
 656
 657/* SAL log over-all, multi-section error record structure (processor+platform) */
 658typedef struct err_rec {
 659        sal_log_record_header_t sal_elog_header;
 660        sal_log_processor_info_t proc_err;
 661        sal_log_platform_err_info_t plat_err;
 662        u8 oem_data_pad[1024];
 663} ia64_err_rec_t;
 664
 665/*
 666 * Now define a couple of inline functions for improved type checking
 667 * and convenience.
 668 */
 669
 670extern s64 ia64_sal_cache_flush (u64 cache_type);
 671extern void __init check_sal_cache_flush (void);
 672
 673/* Initialize all the processor and platform level instruction and data caches */
 674static inline s64
 675ia64_sal_cache_init (void)
 676{
 677        struct ia64_sal_retval isrv;
 678        SAL_CALL(isrv, SAL_CACHE_INIT, 0, 0, 0, 0, 0, 0, 0);
 679        return isrv.status;
 680}
 681
 682/*
 683 * Clear the processor and platform information logged by SAL with respect to the machine
 684 * state at the time of MCA's, INITs, CMCs, or CPEs.
 685 */
 686static inline s64
 687ia64_sal_clear_state_info (u64 sal_info_type)
 688{
 689        struct ia64_sal_retval isrv;
 690        SAL_CALL_REENTRANT(isrv, SAL_CLEAR_STATE_INFO, sal_info_type, 0,
 691                      0, 0, 0, 0, 0);
 692        return isrv.status;
 693}
 694
 695
 696/* Get the processor and platform information logged by SAL with respect to the machine
 697 * state at the time of the MCAs, INITs, CMCs, or CPEs.
 698 */
 699static inline u64
 700ia64_sal_get_state_info (u64 sal_info_type, u64 *sal_info)
 701{
 702        struct ia64_sal_retval isrv;
 703        SAL_CALL_REENTRANT(isrv, SAL_GET_STATE_INFO, sal_info_type, 0,
 704                      sal_info, 0, 0, 0, 0);
 705        if (isrv.status)
 706                return 0;
 707
 708        return isrv.v0;
 709}
 710
 711/*
 712 * Get the maximum size of the information logged by SAL with respect to the machine state
 713 * at the time of MCAs, INITs, CMCs, or CPEs.
 714 */
 715static inline u64
 716ia64_sal_get_state_info_size (u64 sal_info_type)
 717{
 718        struct ia64_sal_retval isrv;
 719        SAL_CALL_REENTRANT(isrv, SAL_GET_STATE_INFO_SIZE, sal_info_type, 0,
 720                      0, 0, 0, 0, 0);
 721        if (isrv.status)
 722                return 0;
 723        return isrv.v0;
 724}
 725
 726/*
 727 * Causes the processor to go into a spin loop within SAL where SAL awaits a wakeup from
 728 * the monarch processor.  Must not lock, because it will not return on any cpu until the
 729 * monarch processor sends a wake up.
 730 */
 731static inline s64
 732ia64_sal_mc_rendez (void)
 733{
 734        struct ia64_sal_retval isrv;
 735        SAL_CALL_NOLOCK(isrv, SAL_MC_RENDEZ, 0, 0, 0, 0, 0, 0, 0);
 736        return isrv.status;
 737}
 738
 739/*
 740 * Allow the OS to specify the interrupt number to be used by SAL to interrupt OS during
 741 * the machine check rendezvous sequence as well as the mechanism to wake up the
 742 * non-monarch processor at the end of machine check processing.
 743 * Returns the complete ia64_sal_retval because some calls return more than just a status
 744 * value.
 745 */
 746static inline struct ia64_sal_retval
 747ia64_sal_mc_set_params (u64 param_type, u64 i_or_m, u64 i_or_m_val, u64 timeout, u64 rz_always)
 748{
 749        struct ia64_sal_retval isrv;
 750        SAL_CALL(isrv, SAL_MC_SET_PARAMS, param_type, i_or_m, i_or_m_val,
 751                 timeout, rz_always, 0, 0);
 752        return isrv;
 753}
 754
 755/* Read from PCI configuration space */
 756static inline s64
 757ia64_sal_pci_config_read (u64 pci_config_addr, int type, u64 size, u64 *value)
 758{
 759        struct ia64_sal_retval isrv;
 760        SAL_CALL(isrv, SAL_PCI_CONFIG_READ, pci_config_addr, size, type, 0, 0, 0, 0);
 761        if (value)
 762                *value = isrv.v0;
 763        return isrv.status;
 764}
 765
 766/* Write to PCI configuration space */
 767static inline s64
 768ia64_sal_pci_config_write (u64 pci_config_addr, int type, u64 size, u64 value)
 769{
 770        struct ia64_sal_retval isrv;
 771        SAL_CALL(isrv, SAL_PCI_CONFIG_WRITE, pci_config_addr, size, value,
 772                 type, 0, 0, 0);
 773        return isrv.status;
 774}
 775
 776/*
 777 * Register physical addresses of locations needed by SAL when SAL procedures are invoked
 778 * in virtual mode.
 779 */
 780static inline s64
 781ia64_sal_register_physical_addr (u64 phys_entry, u64 phys_addr)
 782{
 783        struct ia64_sal_retval isrv;
 784        SAL_CALL(isrv, SAL_REGISTER_PHYSICAL_ADDR, phys_entry, phys_addr,
 785                 0, 0, 0, 0, 0);
 786        return isrv.status;
 787}
 788
 789/*
 790 * Register software dependent code locations within SAL. These locations are handlers or
 791 * entry points where SAL will pass control for the specified event. These event handlers
 792 * are for the bott rendezvous, MCAs and INIT scenarios.
 793 */
 794static inline s64
 795ia64_sal_set_vectors (u64 vector_type,
 796                      u64 handler_addr1, u64 gp1, u64 handler_len1,
 797                      u64 handler_addr2, u64 gp2, u64 handler_len2)
 798{
 799        struct ia64_sal_retval isrv;
 800        SAL_CALL(isrv, SAL_SET_VECTORS, vector_type,
 801                        handler_addr1, gp1, handler_len1,
 802                        handler_addr2, gp2, handler_len2);
 803
 804        return isrv.status;
 805}
 806
 807/* Update the contents of PAL block in the non-volatile storage device */
 808static inline s64
 809ia64_sal_update_pal (u64 param_buf, u64 scratch_buf, u64 scratch_buf_size,
 810                     u64 *error_code, u64 *scratch_buf_size_needed)
 811{
 812        struct ia64_sal_retval isrv;
 813        SAL_CALL(isrv, SAL_UPDATE_PAL, param_buf, scratch_buf, scratch_buf_size,
 814                 0, 0, 0, 0);
 815        if (error_code)
 816                *error_code = isrv.v0;
 817        if (scratch_buf_size_needed)
 818                *scratch_buf_size_needed = isrv.v1;
 819        return isrv.status;
 820}
 821
 822/* Get physical processor die mapping in the platform. */
 823static inline s64
 824ia64_sal_physical_id_info(u16 *splid)
 825{
 826        struct ia64_sal_retval isrv;
 827
 828        if (sal_revision < SAL_VERSION_CODE(3,2))
 829                return -1;
 830
 831        SAL_CALL(isrv, SAL_PHYSICAL_ID_INFO, 0, 0, 0, 0, 0, 0, 0);
 832        if (splid)
 833                *splid = isrv.v0;
 834        return isrv.status;
 835}
 836
 837extern unsigned long sal_platform_features;
 838
 839extern int (*salinfo_platform_oemdata)(const u8 *, u8 **, u64 *);
 840
 841struct sal_ret_values {
 842        long r8; long r9; long r10; long r11;
 843};
 844
 845#define IA64_SAL_OEMFUNC_MIN            0x02000000
 846#define IA64_SAL_OEMFUNC_MAX            0x03ffffff
 847
 848extern int ia64_sal_oemcall(struct ia64_sal_retval *, u64, u64, u64, u64, u64,
 849                            u64, u64, u64);
 850extern int ia64_sal_oemcall_nolock(struct ia64_sal_retval *, u64, u64, u64,
 851                                   u64, u64, u64, u64, u64);
 852extern int ia64_sal_oemcall_reentrant(struct ia64_sal_retval *, u64, u64, u64,
 853                                      u64, u64, u64, u64, u64);
 854extern long
 855ia64_sal_freq_base (unsigned long which, unsigned long *ticks_per_second,
 856                    unsigned long *drift_info);
 857#ifdef CONFIG_HOTPLUG_CPU
 858/*
 859 * System Abstraction Layer Specification
 860 * Section 3.2.5.1: OS_BOOT_RENDEZ to SAL return State.
 861 * Note: region regs are stored first in head.S _start. Hence they must
 862 * stay up front.
 863 */
 864struct sal_to_os_boot {
 865        u64 rr[8];              /* Region Registers */
 866        u64 br[6];              /* br0:
 867                                 * return addr into SAL boot rendez routine */
 868        u64 gr1;                /* SAL:GP */
 869        u64 gr12;               /* SAL:SP */
 870        u64 gr13;               /* SAL: Task Pointer */
 871        u64 fpsr;
 872        u64 pfs;
 873        u64 rnat;
 874        u64 unat;
 875        u64 bspstore;
 876        u64 dcr;                /* Default Control Register */
 877        u64 iva;
 878        u64 pta;
 879        u64 itv;
 880        u64 pmv;
 881        u64 cmcv;
 882        u64 lrr[2];
 883        u64 gr[4];
 884        u64 pr;                 /* Predicate registers */
 885        u64 lc;                 /* Loop Count */
 886        struct ia64_fpreg fp[20];
 887};
 888
 889/*
 890 * Global array allocated for NR_CPUS at boot time
 891 */
 892extern struct sal_to_os_boot sal_boot_rendez_state[NR_CPUS];
 893
 894extern void ia64_jump_to_sal(struct sal_to_os_boot *);
 895#endif
 896
 897extern void ia64_sal_handler_init(void *entry_point, void *gpval);
 898
 899#define PALO_MAX_TLB_PURGES     0xFFFF
 900#define PALO_SIG        "PALO"
 901
 902struct palo_table {
 903        u8  signature[4];       /* Should be "PALO" */
 904        u32 length;
 905        u8  minor_revision;
 906        u8  major_revision;
 907        u8  checksum;
 908        u8  reserved1[5];
 909        u16 max_tlb_purges;
 910        u8  reserved2[6];
 911};
 912
 913#define NPTCG_FROM_PAL                  0
 914#define NPTCG_FROM_PALO                 1
 915#define NPTCG_FROM_KERNEL_PARAMETER     2
 916
 917#endif /* __ASSEMBLY__ */
 918
 919#endif /* _ASM_IA64_SAL_H */
 920