xref: /openbmc/linux/arch/ia64/include/asm/sal.h (revision 2a598d0b)
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 
46 extern unsigned long sal_systab_phys;
47 extern 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 
102 struct 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 
116 typedef struct ia64_sal_retval (*ia64_sal_handler) (u64, ...);
117 
118 enum {
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  */
130 struct 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 
148 enum 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 
168 typedef 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 
177 typedef 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 
192 typedef 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 
198 typedef 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 
208 typedef 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 
215 typedef 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 
220 typedef 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 
228 typedef 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 
235 extern ia64_sal_handler ia64_sal;
236 extern struct ia64_sal_desc_ptc *ia64_ptc_domain_info;
237 
238 extern unsigned short sal_revision;	/* supported SAL spec revision */
239 extern unsigned short sal_version;	/* SAL version; OEM dependent */
240 #define SAL_VERSION_CODE(major, minor) ((bin2bcd(major) << 8) | bin2bcd(minor))
241 
242 extern const char *ia64_sal_strerror (long status);
243 extern void ia64_sal_init (struct ia64_sal_systab *sal_systab);
244 
245 /* SAL information type encodings */
246 enum {
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 */
254 enum {
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 */
261 enum {
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 */
267 enum {
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 */
309 typedef 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 */
315 typedef 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 */
327 typedef 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 */
354 typedef 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 
362 typedef 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 
378 typedef 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 
396 struct sal_cpuid_info {
397 	u64 regs[5];
398 	u64 reserved;
399 };
400 
401 typedef 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[];
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 
449 typedef 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 
490 typedef 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 
518 typedef 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 
546 typedef 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 
561 typedef 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 
594 typedef 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 
607 typedef 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 
626 typedef 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 */
646 typedef 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) */
658 typedef 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 
670 extern s64 ia64_sal_cache_flush (u64 cache_type);
671 extern void __init check_sal_cache_flush (void);
672 
673 /* Initialize all the processor and platform level instruction and data caches */
674 static inline s64
675 ia64_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  */
686 static inline s64
687 ia64_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  */
699 static inline u64
700 ia64_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  */
715 static inline u64
716 ia64_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  */
731 static inline s64
732 ia64_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  */
746 static inline struct ia64_sal_retval
747 ia64_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 */
756 static inline s64
757 ia64_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 */
767 static inline s64
768 ia64_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  */
780 static inline s64
781 ia64_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  */
794 static inline s64
795 ia64_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 */
808 static inline s64
809 ia64_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. */
823 static inline s64
824 ia64_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 
837 extern unsigned long sal_platform_features;
838 
839 extern int (*salinfo_platform_oemdata)(const u8 *, u8 **, u64 *);
840 
841 struct 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 
848 extern int ia64_sal_oemcall(struct ia64_sal_retval *, u64, u64, u64, u64, u64,
849 			    u64, u64, u64);
850 extern int ia64_sal_oemcall_nolock(struct ia64_sal_retval *, u64, u64, u64,
851 				   u64, u64, u64, u64, u64);
852 extern int ia64_sal_oemcall_reentrant(struct ia64_sal_retval *, u64, u64, u64,
853 				      u64, u64, u64, u64, u64);
854 extern long
855 ia64_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  */
864 struct 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  */
892 extern struct sal_to_os_boot sal_boot_rendez_state[NR_CPUS];
893 
894 extern void ia64_jump_to_sal(struct sal_to_os_boot *);
895 #endif
896 
897 extern void ia64_sal_handler_init(void *entry_point, void *gpval);
898 
899 #define PALO_MAX_TLB_PURGES	0xFFFF
900 #define PALO_SIG	"PALO"
901 
902 struct 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