[PATCH] setup_irq(): better mismatch debugging
[linux-2.6/sactl.git] / include / asm-ia64 / pal.h
blob4283ddcc25fbf69a50cfce33483fbbf203023ff9
1 #ifndef _ASM_IA64_PAL_H
2 #define _ASM_IA64_PAL_H
4 /*
5 * Processor Abstraction Layer definitions.
7 * This is based on Intel IA-64 Architecture Software Developer's Manual rev 1.0
8 * chapter 11 IA-64 Processor Abstraction Layer
10 * Copyright (C) 1998-2001 Hewlett-Packard Co
11 * David Mosberger-Tang <davidm@hpl.hp.com>
12 * Stephane Eranian <eranian@hpl.hp.com>
13 * Copyright (C) 1999 VA Linux Systems
14 * Copyright (C) 1999 Walt Drummond <drummond@valinux.com>
15 * Copyright (C) 1999 Srinivasa Prasad Thirumalachar <sprasad@sprasad.engr.sgi.com>
17 * 99/10/01 davidm Make sure we pass zero for reserved parameters.
18 * 00/03/07 davidm Updated pal_cache_flush() to be in sync with PAL v2.6.
19 * 00/03/23 cfleck Modified processor min-state save area to match updated PAL & SAL info
20 * 00/05/24 eranian Updated to latest PAL spec, fix structures bugs, added
21 * 00/05/25 eranian Support for stack calls, and static physical calls
22 * 00/06/18 eranian Support for stacked physical calls
26 * Note that some of these calls use a static-register only calling
27 * convention which has nothing to do with the regular calling
28 * convention.
30 #define PAL_CACHE_FLUSH 1 /* flush i/d cache */
31 #define PAL_CACHE_INFO 2 /* get detailed i/d cache info */
32 #define PAL_CACHE_INIT 3 /* initialize i/d cache */
33 #define PAL_CACHE_SUMMARY 4 /* get summary of cache heirarchy */
34 #define PAL_MEM_ATTRIB 5 /* list supported memory attributes */
35 #define PAL_PTCE_INFO 6 /* purge TLB info */
36 #define PAL_VM_INFO 7 /* return supported virtual memory features */
37 #define PAL_VM_SUMMARY 8 /* return summary on supported vm features */
38 #define PAL_BUS_GET_FEATURES 9 /* return processor bus interface features settings */
39 #define PAL_BUS_SET_FEATURES 10 /* set processor bus features */
40 #define PAL_DEBUG_INFO 11 /* get number of debug registers */
41 #define PAL_FIXED_ADDR 12 /* get fixed component of processors's directed address */
42 #define PAL_FREQ_BASE 13 /* base frequency of the platform */
43 #define PAL_FREQ_RATIOS 14 /* ratio of processor, bus and ITC frequency */
44 #define PAL_PERF_MON_INFO 15 /* return performance monitor info */
45 #define PAL_PLATFORM_ADDR 16 /* set processor interrupt block and IO port space addr */
46 #define PAL_PROC_GET_FEATURES 17 /* get configurable processor features & settings */
47 #define PAL_PROC_SET_FEATURES 18 /* enable/disable configurable processor features */
48 #define PAL_RSE_INFO 19 /* return rse information */
49 #define PAL_VERSION 20 /* return version of PAL code */
50 #define PAL_MC_CLEAR_LOG 21 /* clear all processor log info */
51 #define PAL_MC_DRAIN 22 /* drain operations which could result in an MCA */
52 #define PAL_MC_EXPECTED 23 /* set/reset expected MCA indicator */
53 #define PAL_MC_DYNAMIC_STATE 24 /* get processor dynamic state */
54 #define PAL_MC_ERROR_INFO 25 /* get processor MCA info and static state */
55 #define PAL_MC_RESUME 26 /* Return to interrupted process */
56 #define PAL_MC_REGISTER_MEM 27 /* Register memory for PAL to use during MCAs and inits */
57 #define PAL_HALT 28 /* enter the low power HALT state */
58 #define PAL_HALT_LIGHT 29 /* enter the low power light halt state*/
59 #define PAL_COPY_INFO 30 /* returns info needed to relocate PAL */
60 #define PAL_CACHE_LINE_INIT 31 /* init tags & data of cache line */
61 #define PAL_PMI_ENTRYPOINT 32 /* register PMI memory entry points with the processor */
62 #define PAL_ENTER_IA_32_ENV 33 /* enter IA-32 system environment */
63 #define PAL_VM_PAGE_SIZE 34 /* return vm TC and page walker page sizes */
65 #define PAL_MEM_FOR_TEST 37 /* get amount of memory needed for late processor test */
66 #define PAL_CACHE_PROT_INFO 38 /* get i/d cache protection info */
67 #define PAL_REGISTER_INFO 39 /* return AR and CR register information*/
68 #define PAL_SHUTDOWN 40 /* enter processor shutdown state */
69 #define PAL_PREFETCH_VISIBILITY 41 /* Make Processor Prefetches Visible */
70 #define PAL_LOGICAL_TO_PHYSICAL 42 /* returns information on logical to physical processor mapping */
71 #define PAL_CACHE_SHARED_INFO 43 /* returns information on caches shared by logical processor */
73 #define PAL_COPY_PAL 256 /* relocate PAL procedures and PAL PMI */
74 #define PAL_HALT_INFO 257 /* return the low power capabilities of processor */
75 #define PAL_TEST_PROC 258 /* perform late processor self-test */
76 #define PAL_CACHE_READ 259 /* read tag & data of cacheline for diagnostic testing */
77 #define PAL_CACHE_WRITE 260 /* write tag & data of cacheline for diagnostic testing */
78 #define PAL_VM_TR_READ 261 /* read contents of translation register */
79 #define PAL_GET_PSTATE 262 /* get the current P-state */
80 #define PAL_SET_PSTATE 263 /* set the P-state */
81 #define PAL_BRAND_INFO 274 /* Processor branding information */
83 #ifndef __ASSEMBLY__
85 #include <linux/types.h>
86 #include <asm/fpu.h>
89 * Data types needed to pass information into PAL procedures and
90 * interpret information returned by them.
93 /* Return status from the PAL procedure */
94 typedef s64 pal_status_t;
96 #define PAL_STATUS_SUCCESS 0 /* No error */
97 #define PAL_STATUS_UNIMPLEMENTED (-1) /* Unimplemented procedure */
98 #define PAL_STATUS_EINVAL (-2) /* Invalid argument */
99 #define PAL_STATUS_ERROR (-3) /* Error */
100 #define PAL_STATUS_CACHE_INIT_FAIL (-4) /* Could not initialize the
101 * specified level and type of
102 * cache without sideeffects
103 * and "restrict" was 1
106 /* Processor cache level in the heirarchy */
107 typedef u64 pal_cache_level_t;
108 #define PAL_CACHE_LEVEL_L0 0 /* L0 */
109 #define PAL_CACHE_LEVEL_L1 1 /* L1 */
110 #define PAL_CACHE_LEVEL_L2 2 /* L2 */
113 /* Processor cache type at a particular level in the heirarchy */
115 typedef u64 pal_cache_type_t;
116 #define PAL_CACHE_TYPE_INSTRUCTION 1 /* Instruction cache */
117 #define PAL_CACHE_TYPE_DATA 2 /* Data or unified cache */
118 #define PAL_CACHE_TYPE_INSTRUCTION_DATA 3 /* Both Data & Instruction */
121 #define PAL_CACHE_FLUSH_INVALIDATE 1 /* Invalidate clean lines */
122 #define PAL_CACHE_FLUSH_CHK_INTRS 2 /* check for interrupts/mc while flushing */
124 /* Processor cache line size in bytes */
125 typedef int pal_cache_line_size_t;
127 /* Processor cache line state */
128 typedef u64 pal_cache_line_state_t;
129 #define PAL_CACHE_LINE_STATE_INVALID 0 /* Invalid */
130 #define PAL_CACHE_LINE_STATE_SHARED 1 /* Shared */
131 #define PAL_CACHE_LINE_STATE_EXCLUSIVE 2 /* Exclusive */
132 #define PAL_CACHE_LINE_STATE_MODIFIED 3 /* Modified */
134 typedef struct pal_freq_ratio {
135 u32 den, num; /* numerator & denominator */
136 } itc_ratio, proc_ratio;
138 typedef union pal_cache_config_info_1_s {
139 struct {
140 u64 u : 1, /* 0 Unified cache ? */
141 at : 2, /* 2-1 Cache mem attr*/
142 reserved : 5, /* 7-3 Reserved */
143 associativity : 8, /* 16-8 Associativity*/
144 line_size : 8, /* 23-17 Line size */
145 stride : 8, /* 31-24 Stride */
146 store_latency : 8, /*39-32 Store latency*/
147 load_latency : 8, /* 47-40 Load latency*/
148 store_hints : 8, /* 55-48 Store hints*/
149 load_hints : 8; /* 63-56 Load hints */
150 } pcci1_bits;
151 u64 pcci1_data;
152 } pal_cache_config_info_1_t;
154 typedef union pal_cache_config_info_2_s {
155 struct {
156 u32 cache_size; /*cache size in bytes*/
159 u32 alias_boundary : 8, /* 39-32 aliased addr
160 * separation for max
161 * performance.
163 tag_ls_bit : 8, /* 47-40 LSb of addr*/
164 tag_ms_bit : 8, /* 55-48 MSb of addr*/
165 reserved : 8; /* 63-56 Reserved */
166 } pcci2_bits;
167 u64 pcci2_data;
168 } pal_cache_config_info_2_t;
171 typedef struct pal_cache_config_info_s {
172 pal_status_t pcci_status;
173 pal_cache_config_info_1_t pcci_info_1;
174 pal_cache_config_info_2_t pcci_info_2;
175 u64 pcci_reserved;
176 } pal_cache_config_info_t;
178 #define pcci_ld_hints pcci_info_1.pcci1_bits.load_hints
179 #define pcci_st_hints pcci_info_1.pcci1_bits.store_hints
180 #define pcci_ld_latency pcci_info_1.pcci1_bits.load_latency
181 #define pcci_st_latency pcci_info_1.pcci1_bits.store_latency
182 #define pcci_stride pcci_info_1.pcci1_bits.stride
183 #define pcci_line_size pcci_info_1.pcci1_bits.line_size
184 #define pcci_assoc pcci_info_1.pcci1_bits.associativity
185 #define pcci_cache_attr pcci_info_1.pcci1_bits.at
186 #define pcci_unified pcci_info_1.pcci1_bits.u
187 #define pcci_tag_msb pcci_info_2.pcci2_bits.tag_ms_bit
188 #define pcci_tag_lsb pcci_info_2.pcci2_bits.tag_ls_bit
189 #define pcci_alias_boundary pcci_info_2.pcci2_bits.alias_boundary
190 #define pcci_cache_size pcci_info_2.pcci2_bits.cache_size
194 /* Possible values for cache attributes */
196 #define PAL_CACHE_ATTR_WT 0 /* Write through cache */
197 #define PAL_CACHE_ATTR_WB 1 /* Write back cache */
198 #define PAL_CACHE_ATTR_WT_OR_WB 2 /* Either write thru or write
199 * back depending on TLB
200 * memory attributes
204 /* Possible values for cache hints */
206 #define PAL_CACHE_HINT_TEMP_1 0 /* Temporal level 1 */
207 #define PAL_CACHE_HINT_NTEMP_1 1 /* Non-temporal level 1 */
208 #define PAL_CACHE_HINT_NTEMP_ALL 3 /* Non-temporal all levels */
210 /* Processor cache protection information */
211 typedef union pal_cache_protection_element_u {
212 u32 pcpi_data;
213 struct {
214 u32 data_bits : 8, /* # data bits covered by
215 * each unit of protection
218 tagprot_lsb : 6, /* Least -do- */
219 tagprot_msb : 6, /* Most Sig. tag address
220 * bit that this
221 * protection covers.
223 prot_bits : 6, /* # of protection bits */
224 method : 4, /* Protection method */
225 t_d : 2; /* Indicates which part
226 * of the cache this
227 * protection encoding
228 * applies.
230 } pcp_info;
231 } pal_cache_protection_element_t;
233 #define pcpi_cache_prot_part pcp_info.t_d
234 #define pcpi_prot_method pcp_info.method
235 #define pcpi_prot_bits pcp_info.prot_bits
236 #define pcpi_tagprot_msb pcp_info.tagprot_msb
237 #define pcpi_tagprot_lsb pcp_info.tagprot_lsb
238 #define pcpi_data_bits pcp_info.data_bits
240 /* Processor cache part encodings */
241 #define PAL_CACHE_PROT_PART_DATA 0 /* Data protection */
242 #define PAL_CACHE_PROT_PART_TAG 1 /* Tag protection */
243 #define PAL_CACHE_PROT_PART_TAG_DATA 2 /* Tag+data protection (tag is
244 * more significant )
246 #define PAL_CACHE_PROT_PART_DATA_TAG 3 /* Data+tag protection (data is
247 * more significant )
249 #define PAL_CACHE_PROT_PART_MAX 6
252 typedef struct pal_cache_protection_info_s {
253 pal_status_t pcpi_status;
254 pal_cache_protection_element_t pcp_info[PAL_CACHE_PROT_PART_MAX];
255 } pal_cache_protection_info_t;
258 /* Processor cache protection method encodings */
259 #define PAL_CACHE_PROT_METHOD_NONE 0 /* No protection */
260 #define PAL_CACHE_PROT_METHOD_ODD_PARITY 1 /* Odd parity */
261 #define PAL_CACHE_PROT_METHOD_EVEN_PARITY 2 /* Even parity */
262 #define PAL_CACHE_PROT_METHOD_ECC 3 /* ECC protection */
265 /* Processor cache line identification in the heirarchy */
266 typedef union pal_cache_line_id_u {
267 u64 pclid_data;
268 struct {
269 u64 cache_type : 8, /* 7-0 cache type */
270 level : 8, /* 15-8 level of the
271 * cache in the
272 * heirarchy.
274 way : 8, /* 23-16 way in the set
276 part : 8, /* 31-24 part of the
277 * cache
279 reserved : 32; /* 63-32 is reserved*/
280 } pclid_info_read;
281 struct {
282 u64 cache_type : 8, /* 7-0 cache type */
283 level : 8, /* 15-8 level of the
284 * cache in the
285 * heirarchy.
287 way : 8, /* 23-16 way in the set
289 part : 8, /* 31-24 part of the
290 * cache
292 mesi : 8, /* 39-32 cache line
293 * state
295 start : 8, /* 47-40 lsb of data to
296 * invert
298 length : 8, /* 55-48 #bits to
299 * invert
301 trigger : 8; /* 63-56 Trigger error
302 * by doing a load
303 * after the write
306 } pclid_info_write;
307 } pal_cache_line_id_u_t;
309 #define pclid_read_part pclid_info_read.part
310 #define pclid_read_way pclid_info_read.way
311 #define pclid_read_level pclid_info_read.level
312 #define pclid_read_cache_type pclid_info_read.cache_type
314 #define pclid_write_trigger pclid_info_write.trigger
315 #define pclid_write_length pclid_info_write.length
316 #define pclid_write_start pclid_info_write.start
317 #define pclid_write_mesi pclid_info_write.mesi
318 #define pclid_write_part pclid_info_write.part
319 #define pclid_write_way pclid_info_write.way
320 #define pclid_write_level pclid_info_write.level
321 #define pclid_write_cache_type pclid_info_write.cache_type
323 /* Processor cache line part encodings */
324 #define PAL_CACHE_LINE_ID_PART_DATA 0 /* Data */
325 #define PAL_CACHE_LINE_ID_PART_TAG 1 /* Tag */
326 #define PAL_CACHE_LINE_ID_PART_DATA_PROT 2 /* Data protection */
327 #define PAL_CACHE_LINE_ID_PART_TAG_PROT 3 /* Tag protection */
328 #define PAL_CACHE_LINE_ID_PART_DATA_TAG_PROT 4 /* Data+tag
329 * protection
331 typedef struct pal_cache_line_info_s {
332 pal_status_t pcli_status; /* Return status of the read cache line
333 * info call.
335 u64 pcli_data; /* 64-bit data, tag, protection bits .. */
336 u64 pcli_data_len; /* data length in bits */
337 pal_cache_line_state_t pcli_cache_line_state; /* mesi state */
339 } pal_cache_line_info_t;
342 /* Machine Check related crap */
344 /* Pending event status bits */
345 typedef u64 pal_mc_pending_events_t;
347 #define PAL_MC_PENDING_MCA (1 << 0)
348 #define PAL_MC_PENDING_INIT (1 << 1)
350 /* Error information type */
351 typedef u64 pal_mc_info_index_t;
353 #define PAL_MC_INFO_PROCESSOR 0 /* Processor */
354 #define PAL_MC_INFO_CACHE_CHECK 1 /* Cache check */
355 #define PAL_MC_INFO_TLB_CHECK 2 /* Tlb check */
356 #define PAL_MC_INFO_BUS_CHECK 3 /* Bus check */
357 #define PAL_MC_INFO_REQ_ADDR 4 /* Requestor address */
358 #define PAL_MC_INFO_RESP_ADDR 5 /* Responder address */
359 #define PAL_MC_INFO_TARGET_ADDR 6 /* Target address */
360 #define PAL_MC_INFO_IMPL_DEP 7 /* Implementation
361 * dependent
365 typedef struct pal_process_state_info_s {
366 u64 reserved1 : 2,
367 rz : 1, /* PAL_CHECK processor
368 * rendezvous
369 * successful.
372 ra : 1, /* PAL_CHECK attempted
373 * a rendezvous.
375 me : 1, /* Distinct multiple
376 * errors occurred
379 mn : 1, /* Min. state save
380 * area has been
381 * registered with PAL
384 sy : 1, /* Storage integrity
385 * synched
389 co : 1, /* Continuable */
390 ci : 1, /* MC isolated */
391 us : 1, /* Uncontained storage
392 * damage.
396 hd : 1, /* Non-essential hw
397 * lost (no loss of
398 * functionality)
399 * causing the
400 * processor to run in
401 * degraded mode.
404 tl : 1, /* 1 => MC occurred
405 * after an instr was
406 * executed but before
407 * the trap that
408 * resulted from instr
409 * execution was
410 * generated.
411 * (Trap Lost )
413 mi : 1, /* More information available
414 * call PAL_MC_ERROR_INFO
416 pi : 1, /* Precise instruction pointer */
417 pm : 1, /* Precise min-state save area */
419 dy : 1, /* Processor dynamic
420 * state valid
424 in : 1, /* 0 = MC, 1 = INIT */
425 rs : 1, /* RSE valid */
426 cm : 1, /* MC corrected */
427 ex : 1, /* MC is expected */
428 cr : 1, /* Control regs valid*/
429 pc : 1, /* Perf cntrs valid */
430 dr : 1, /* Debug regs valid */
431 tr : 1, /* Translation regs
432 * valid
434 rr : 1, /* Region regs valid */
435 ar : 1, /* App regs valid */
436 br : 1, /* Branch regs valid */
437 pr : 1, /* Predicate registers
438 * valid
441 fp : 1, /* fp registers valid*/
442 b1 : 1, /* Preserved bank one
443 * general registers
444 * are valid
446 b0 : 1, /* Preserved bank zero
447 * general registers
448 * are valid
450 gr : 1, /* General registers
451 * are valid
452 * (excl. banked regs)
454 dsize : 16, /* size of dynamic
455 * state returned
456 * by the processor
459 reserved2 : 11,
460 cc : 1, /* Cache check */
461 tc : 1, /* TLB check */
462 bc : 1, /* Bus check */
463 rc : 1, /* Register file check */
464 uc : 1; /* Uarch check */
466 } pal_processor_state_info_t;
468 typedef struct pal_cache_check_info_s {
469 u64 op : 4, /* Type of cache
470 * operation that
471 * caused the machine
472 * check.
474 level : 2, /* Cache level */
475 reserved1 : 2,
476 dl : 1, /* Failure in data part
477 * of cache line
479 tl : 1, /* Failure in tag part
480 * of cache line
482 dc : 1, /* Failure in dcache */
483 ic : 1, /* Failure in icache */
484 mesi : 3, /* Cache line state */
485 mv : 1, /* mesi valid */
486 way : 5, /* Way in which the
487 * error occurred
489 wiv : 1, /* Way field valid */
490 reserved2 : 10,
492 index : 20, /* Cache line index */
493 reserved3 : 2,
495 is : 1, /* instruction set (1 == ia32) */
496 iv : 1, /* instruction set field valid */
497 pl : 2, /* privilege level */
498 pv : 1, /* privilege level field valid */
499 mcc : 1, /* Machine check corrected */
500 tv : 1, /* Target address
501 * structure is valid
503 rq : 1, /* Requester identifier
504 * structure is valid
506 rp : 1, /* Responder identifier
507 * structure is valid
509 pi : 1; /* Precise instruction pointer
510 * structure is valid
512 } pal_cache_check_info_t;
514 typedef struct pal_tlb_check_info_s {
516 u64 tr_slot : 8, /* Slot# of TR where
517 * error occurred
519 trv : 1, /* tr_slot field is valid */
520 reserved1 : 1,
521 level : 2, /* TLB level where failure occurred */
522 reserved2 : 4,
523 dtr : 1, /* Fail in data TR */
524 itr : 1, /* Fail in inst TR */
525 dtc : 1, /* Fail in data TC */
526 itc : 1, /* Fail in inst. TC */
527 op : 4, /* Cache operation */
528 reserved3 : 30,
530 is : 1, /* instruction set (1 == ia32) */
531 iv : 1, /* instruction set field valid */
532 pl : 2, /* privilege level */
533 pv : 1, /* privilege level field valid */
534 mcc : 1, /* Machine check corrected */
535 tv : 1, /* Target address
536 * structure is valid
538 rq : 1, /* Requester identifier
539 * structure is valid
541 rp : 1, /* Responder identifier
542 * structure is valid
544 pi : 1; /* Precise instruction pointer
545 * structure is valid
547 } pal_tlb_check_info_t;
549 typedef struct pal_bus_check_info_s {
550 u64 size : 5, /* Xaction size */
551 ib : 1, /* Internal bus error */
552 eb : 1, /* External bus error */
553 cc : 1, /* Error occurred
554 * during cache-cache
555 * transfer.
557 type : 8, /* Bus xaction type*/
558 sev : 5, /* Bus error severity*/
559 hier : 2, /* Bus hierarchy level */
560 reserved1 : 1,
561 bsi : 8, /* Bus error status
562 * info
564 reserved2 : 22,
566 is : 1, /* instruction set (1 == ia32) */
567 iv : 1, /* instruction set field valid */
568 pl : 2, /* privilege level */
569 pv : 1, /* privilege level field valid */
570 mcc : 1, /* Machine check corrected */
571 tv : 1, /* Target address
572 * structure is valid
574 rq : 1, /* Requester identifier
575 * structure is valid
577 rp : 1, /* Responder identifier
578 * structure is valid
580 pi : 1; /* Precise instruction pointer
581 * structure is valid
583 } pal_bus_check_info_t;
585 typedef struct pal_reg_file_check_info_s {
586 u64 id : 4, /* Register file identifier */
587 op : 4, /* Type of register
588 * operation that
589 * caused the machine
590 * check.
592 reg_num : 7, /* Register number */
593 rnv : 1, /* reg_num valid */
594 reserved2 : 38,
596 is : 1, /* instruction set (1 == ia32) */
597 iv : 1, /* instruction set field valid */
598 pl : 2, /* privilege level */
599 pv : 1, /* privilege level field valid */
600 mcc : 1, /* Machine check corrected */
601 reserved3 : 3,
602 pi : 1; /* Precise instruction pointer
603 * structure is valid
605 } pal_reg_file_check_info_t;
607 typedef struct pal_uarch_check_info_s {
608 u64 sid : 5, /* Structure identification */
609 level : 3, /* Level of failure */
610 array_id : 4, /* Array identification */
611 op : 4, /* Type of
612 * operation that
613 * caused the machine
614 * check.
616 way : 6, /* Way of structure */
617 wv : 1, /* way valid */
618 xv : 1, /* index valid */
619 reserved1 : 8,
620 index : 8, /* Index or set of the uarch
621 * structure that failed.
623 reserved2 : 24,
625 is : 1, /* instruction set (1 == ia32) */
626 iv : 1, /* instruction set field valid */
627 pl : 2, /* privilege level */
628 pv : 1, /* privilege level field valid */
629 mcc : 1, /* Machine check corrected */
630 tv : 1, /* Target address
631 * structure is valid
633 rq : 1, /* Requester identifier
634 * structure is valid
636 rp : 1, /* Responder identifier
637 * structure is valid
639 pi : 1; /* Precise instruction pointer
640 * structure is valid
642 } pal_uarch_check_info_t;
644 typedef union pal_mc_error_info_u {
645 u64 pmei_data;
646 pal_processor_state_info_t pme_processor;
647 pal_cache_check_info_t pme_cache;
648 pal_tlb_check_info_t pme_tlb;
649 pal_bus_check_info_t pme_bus;
650 pal_reg_file_check_info_t pme_reg_file;
651 pal_uarch_check_info_t pme_uarch;
652 } pal_mc_error_info_t;
654 #define pmci_proc_unknown_check pme_processor.uc
655 #define pmci_proc_bus_check pme_processor.bc
656 #define pmci_proc_tlb_check pme_processor.tc
657 #define pmci_proc_cache_check pme_processor.cc
658 #define pmci_proc_dynamic_state_size pme_processor.dsize
659 #define pmci_proc_gpr_valid pme_processor.gr
660 #define pmci_proc_preserved_bank0_gpr_valid pme_processor.b0
661 #define pmci_proc_preserved_bank1_gpr_valid pme_processor.b1
662 #define pmci_proc_fp_valid pme_processor.fp
663 #define pmci_proc_predicate_regs_valid pme_processor.pr
664 #define pmci_proc_branch_regs_valid pme_processor.br
665 #define pmci_proc_app_regs_valid pme_processor.ar
666 #define pmci_proc_region_regs_valid pme_processor.rr
667 #define pmci_proc_translation_regs_valid pme_processor.tr
668 #define pmci_proc_debug_regs_valid pme_processor.dr
669 #define pmci_proc_perf_counters_valid pme_processor.pc
670 #define pmci_proc_control_regs_valid pme_processor.cr
671 #define pmci_proc_machine_check_expected pme_processor.ex
672 #define pmci_proc_machine_check_corrected pme_processor.cm
673 #define pmci_proc_rse_valid pme_processor.rs
674 #define pmci_proc_machine_check_or_init pme_processor.in
675 #define pmci_proc_dynamic_state_valid pme_processor.dy
676 #define pmci_proc_operation pme_processor.op
677 #define pmci_proc_trap_lost pme_processor.tl
678 #define pmci_proc_hardware_damage pme_processor.hd
679 #define pmci_proc_uncontained_storage_damage pme_processor.us
680 #define pmci_proc_machine_check_isolated pme_processor.ci
681 #define pmci_proc_continuable pme_processor.co
682 #define pmci_proc_storage_intergrity_synced pme_processor.sy
683 #define pmci_proc_min_state_save_area_regd pme_processor.mn
684 #define pmci_proc_distinct_multiple_errors pme_processor.me
685 #define pmci_proc_pal_attempted_rendezvous pme_processor.ra
686 #define pmci_proc_pal_rendezvous_complete pme_processor.rz
689 #define pmci_cache_level pme_cache.level
690 #define pmci_cache_line_state pme_cache.mesi
691 #define pmci_cache_line_state_valid pme_cache.mv
692 #define pmci_cache_line_index pme_cache.index
693 #define pmci_cache_instr_cache_fail pme_cache.ic
694 #define pmci_cache_data_cache_fail pme_cache.dc
695 #define pmci_cache_line_tag_fail pme_cache.tl
696 #define pmci_cache_line_data_fail pme_cache.dl
697 #define pmci_cache_operation pme_cache.op
698 #define pmci_cache_way_valid pme_cache.wv
699 #define pmci_cache_target_address_valid pme_cache.tv
700 #define pmci_cache_way pme_cache.way
701 #define pmci_cache_mc pme_cache.mc
703 #define pmci_tlb_instr_translation_cache_fail pme_tlb.itc
704 #define pmci_tlb_data_translation_cache_fail pme_tlb.dtc
705 #define pmci_tlb_instr_translation_reg_fail pme_tlb.itr
706 #define pmci_tlb_data_translation_reg_fail pme_tlb.dtr
707 #define pmci_tlb_translation_reg_slot pme_tlb.tr_slot
708 #define pmci_tlb_mc pme_tlb.mc
710 #define pmci_bus_status_info pme_bus.bsi
711 #define pmci_bus_req_address_valid pme_bus.rq
712 #define pmci_bus_resp_address_valid pme_bus.rp
713 #define pmci_bus_target_address_valid pme_bus.tv
714 #define pmci_bus_error_severity pme_bus.sev
715 #define pmci_bus_transaction_type pme_bus.type
716 #define pmci_bus_cache_cache_transfer pme_bus.cc
717 #define pmci_bus_transaction_size pme_bus.size
718 #define pmci_bus_internal_error pme_bus.ib
719 #define pmci_bus_external_error pme_bus.eb
720 #define pmci_bus_mc pme_bus.mc
723 * NOTE: this min_state_save area struct only includes the 1KB
724 * architectural state save area. The other 3 KB is scratch space
725 * for PAL.
728 typedef struct pal_min_state_area_s {
729 u64 pmsa_nat_bits; /* nat bits for saved GRs */
730 u64 pmsa_gr[15]; /* GR1 - GR15 */
731 u64 pmsa_bank0_gr[16]; /* GR16 - GR31 */
732 u64 pmsa_bank1_gr[16]; /* GR16 - GR31 */
733 u64 pmsa_pr; /* predicate registers */
734 u64 pmsa_br0; /* branch register 0 */
735 u64 pmsa_rsc; /* ar.rsc */
736 u64 pmsa_iip; /* cr.iip */
737 u64 pmsa_ipsr; /* cr.ipsr */
738 u64 pmsa_ifs; /* cr.ifs */
739 u64 pmsa_xip; /* previous iip */
740 u64 pmsa_xpsr; /* previous psr */
741 u64 pmsa_xfs; /* previous ifs */
742 u64 pmsa_br1; /* branch register 1 */
743 u64 pmsa_reserved[70]; /* pal_min_state_area should total to 1KB */
744 } pal_min_state_area_t;
747 struct ia64_pal_retval {
749 * A zero status value indicates call completed without error.
750 * A negative status value indicates reason of call failure.
751 * A positive status value indicates success but an
752 * informational value should be printed (e.g., "reboot for
753 * change to take effect").
755 s64 status;
756 u64 v0;
757 u64 v1;
758 u64 v2;
762 * Note: Currently unused PAL arguments are generally labeled
763 * "reserved" so the value specified in the PAL documentation
764 * (generally 0) MUST be passed. Reserved parameters are not optional
765 * parameters.
767 extern struct ia64_pal_retval ia64_pal_call_static (u64, u64, u64, u64);
768 extern struct ia64_pal_retval ia64_pal_call_stacked (u64, u64, u64, u64);
769 extern struct ia64_pal_retval ia64_pal_call_phys_static (u64, u64, u64, u64);
770 extern struct ia64_pal_retval ia64_pal_call_phys_stacked (u64, u64, u64, u64);
771 extern void ia64_save_scratch_fpregs (struct ia64_fpreg *);
772 extern void ia64_load_scratch_fpregs (struct ia64_fpreg *);
774 #define PAL_CALL(iprv,a0,a1,a2,a3) do { \
775 struct ia64_fpreg fr[6]; \
776 ia64_save_scratch_fpregs(fr); \
777 iprv = ia64_pal_call_static(a0, a1, a2, a3); \
778 ia64_load_scratch_fpregs(fr); \
779 } while (0)
781 #define PAL_CALL_STK(iprv,a0,a1,a2,a3) do { \
782 struct ia64_fpreg fr[6]; \
783 ia64_save_scratch_fpregs(fr); \
784 iprv = ia64_pal_call_stacked(a0, a1, a2, a3); \
785 ia64_load_scratch_fpregs(fr); \
786 } while (0)
788 #define PAL_CALL_PHYS(iprv,a0,a1,a2,a3) do { \
789 struct ia64_fpreg fr[6]; \
790 ia64_save_scratch_fpregs(fr); \
791 iprv = ia64_pal_call_phys_static(a0, a1, a2, a3); \
792 ia64_load_scratch_fpregs(fr); \
793 } while (0)
795 #define PAL_CALL_PHYS_STK(iprv,a0,a1,a2,a3) do { \
796 struct ia64_fpreg fr[6]; \
797 ia64_save_scratch_fpregs(fr); \
798 iprv = ia64_pal_call_phys_stacked(a0, a1, a2, a3); \
799 ia64_load_scratch_fpregs(fr); \
800 } while (0)
802 typedef int (*ia64_pal_handler) (u64, ...);
803 extern ia64_pal_handler ia64_pal;
804 extern void ia64_pal_handler_init (void *);
806 extern ia64_pal_handler ia64_pal;
808 extern pal_cache_config_info_t l0d_cache_config_info;
809 extern pal_cache_config_info_t l0i_cache_config_info;
810 extern pal_cache_config_info_t l1_cache_config_info;
811 extern pal_cache_config_info_t l2_cache_config_info;
813 extern pal_cache_protection_info_t l0d_cache_protection_info;
814 extern pal_cache_protection_info_t l0i_cache_protection_info;
815 extern pal_cache_protection_info_t l1_cache_protection_info;
816 extern pal_cache_protection_info_t l2_cache_protection_info;
818 extern pal_cache_config_info_t pal_cache_config_info_get(pal_cache_level_t,
819 pal_cache_type_t);
821 extern pal_cache_protection_info_t pal_cache_protection_info_get(pal_cache_level_t,
822 pal_cache_type_t);
825 extern void pal_error(int);
828 /* Useful wrappers for the current list of pal procedures */
830 typedef union pal_bus_features_u {
831 u64 pal_bus_features_val;
832 struct {
833 u64 pbf_reserved1 : 29;
834 u64 pbf_req_bus_parking : 1;
835 u64 pbf_bus_lock_mask : 1;
836 u64 pbf_enable_half_xfer_rate : 1;
837 u64 pbf_reserved2 : 22;
838 u64 pbf_disable_xaction_queueing : 1;
839 u64 pbf_disable_resp_err_check : 1;
840 u64 pbf_disable_berr_check : 1;
841 u64 pbf_disable_bus_req_internal_err_signal : 1;
842 u64 pbf_disable_bus_req_berr_signal : 1;
843 u64 pbf_disable_bus_init_event_check : 1;
844 u64 pbf_disable_bus_init_event_signal : 1;
845 u64 pbf_disable_bus_addr_err_check : 1;
846 u64 pbf_disable_bus_addr_err_signal : 1;
847 u64 pbf_disable_bus_data_err_check : 1;
848 } pal_bus_features_s;
849 } pal_bus_features_u_t;
851 extern void pal_bus_features_print (u64);
853 /* Provide information about configurable processor bus features */
854 static inline s64
855 ia64_pal_bus_get_features (pal_bus_features_u_t *features_avail,
856 pal_bus_features_u_t *features_status,
857 pal_bus_features_u_t *features_control)
859 struct ia64_pal_retval iprv;
860 PAL_CALL_PHYS(iprv, PAL_BUS_GET_FEATURES, 0, 0, 0);
861 if (features_avail)
862 features_avail->pal_bus_features_val = iprv.v0;
863 if (features_status)
864 features_status->pal_bus_features_val = iprv.v1;
865 if (features_control)
866 features_control->pal_bus_features_val = iprv.v2;
867 return iprv.status;
870 /* Enables/disables specific processor bus features */
871 static inline s64
872 ia64_pal_bus_set_features (pal_bus_features_u_t feature_select)
874 struct ia64_pal_retval iprv;
875 PAL_CALL_PHYS(iprv, PAL_BUS_SET_FEATURES, feature_select.pal_bus_features_val, 0, 0);
876 return iprv.status;
879 /* Get detailed cache information */
880 static inline s64
881 ia64_pal_cache_config_info (u64 cache_level, u64 cache_type, pal_cache_config_info_t *conf)
883 struct ia64_pal_retval iprv;
885 PAL_CALL(iprv, PAL_CACHE_INFO, cache_level, cache_type, 0);
887 if (iprv.status == 0) {
888 conf->pcci_status = iprv.status;
889 conf->pcci_info_1.pcci1_data = iprv.v0;
890 conf->pcci_info_2.pcci2_data = iprv.v1;
891 conf->pcci_reserved = iprv.v2;
893 return iprv.status;
897 /* Get detailed cche protection information */
898 static inline s64
899 ia64_pal_cache_prot_info (u64 cache_level, u64 cache_type, pal_cache_protection_info_t *prot)
901 struct ia64_pal_retval iprv;
903 PAL_CALL(iprv, PAL_CACHE_PROT_INFO, cache_level, cache_type, 0);
905 if (iprv.status == 0) {
906 prot->pcpi_status = iprv.status;
907 prot->pcp_info[0].pcpi_data = iprv.v0 & 0xffffffff;
908 prot->pcp_info[1].pcpi_data = iprv.v0 >> 32;
909 prot->pcp_info[2].pcpi_data = iprv.v1 & 0xffffffff;
910 prot->pcp_info[3].pcpi_data = iprv.v1 >> 32;
911 prot->pcp_info[4].pcpi_data = iprv.v2 & 0xffffffff;
912 prot->pcp_info[5].pcpi_data = iprv.v2 >> 32;
914 return iprv.status;
918 * Flush the processor instruction or data caches. *PROGRESS must be
919 * initialized to zero before calling this for the first time..
921 static inline s64
922 ia64_pal_cache_flush (u64 cache_type, u64 invalidate, u64 *progress, u64 *vector)
924 struct ia64_pal_retval iprv;
925 PAL_CALL(iprv, PAL_CACHE_FLUSH, cache_type, invalidate, *progress);
926 if (vector)
927 *vector = iprv.v0;
928 *progress = iprv.v1;
929 return iprv.status;
933 /* Initialize the processor controlled caches */
934 static inline s64
935 ia64_pal_cache_init (u64 level, u64 cache_type, u64 rest)
937 struct ia64_pal_retval iprv;
938 PAL_CALL(iprv, PAL_CACHE_INIT, level, cache_type, rest);
939 return iprv.status;
942 /* Initialize the tags and data of a data or unified cache line of
943 * processor controlled cache to known values without the availability
944 * of backing memory.
946 static inline s64
947 ia64_pal_cache_line_init (u64 physical_addr, u64 data_value)
949 struct ia64_pal_retval iprv;
950 PAL_CALL(iprv, PAL_CACHE_LINE_INIT, physical_addr, data_value, 0);
951 return iprv.status;
955 /* Read the data and tag of a processor controlled cache line for diags */
956 static inline s64
957 ia64_pal_cache_read (pal_cache_line_id_u_t line_id, u64 physical_addr)
959 struct ia64_pal_retval iprv;
960 PAL_CALL_PHYS_STK(iprv, PAL_CACHE_READ, line_id.pclid_data,
961 physical_addr, 0);
962 return iprv.status;
965 /* Return summary information about the heirarchy of caches controlled by the processor */
966 static inline s64
967 ia64_pal_cache_summary (u64 *cache_levels, u64 *unique_caches)
969 struct ia64_pal_retval iprv;
970 PAL_CALL(iprv, PAL_CACHE_SUMMARY, 0, 0, 0);
971 if (cache_levels)
972 *cache_levels = iprv.v0;
973 if (unique_caches)
974 *unique_caches = iprv.v1;
975 return iprv.status;
978 /* Write the data and tag of a processor-controlled cache line for diags */
979 static inline s64
980 ia64_pal_cache_write (pal_cache_line_id_u_t line_id, u64 physical_addr, u64 data)
982 struct ia64_pal_retval iprv;
983 PAL_CALL_PHYS_STK(iprv, PAL_CACHE_WRITE, line_id.pclid_data,
984 physical_addr, data);
985 return iprv.status;
989 /* Return the parameters needed to copy relocatable PAL procedures from ROM to memory */
990 static inline s64
991 ia64_pal_copy_info (u64 copy_type, u64 num_procs, u64 num_iopics,
992 u64 *buffer_size, u64 *buffer_align)
994 struct ia64_pal_retval iprv;
995 PAL_CALL(iprv, PAL_COPY_INFO, copy_type, num_procs, num_iopics);
996 if (buffer_size)
997 *buffer_size = iprv.v0;
998 if (buffer_align)
999 *buffer_align = iprv.v1;
1000 return iprv.status;
1003 /* Copy relocatable PAL procedures from ROM to memory */
1004 static inline s64
1005 ia64_pal_copy_pal (u64 target_addr, u64 alloc_size, u64 processor, u64 *pal_proc_offset)
1007 struct ia64_pal_retval iprv;
1008 PAL_CALL(iprv, PAL_COPY_PAL, target_addr, alloc_size, processor);
1009 if (pal_proc_offset)
1010 *pal_proc_offset = iprv.v0;
1011 return iprv.status;
1014 /* Return the number of instruction and data debug register pairs */
1015 static inline s64
1016 ia64_pal_debug_info (u64 *inst_regs, u64 *data_regs)
1018 struct ia64_pal_retval iprv;
1019 PAL_CALL(iprv, PAL_DEBUG_INFO, 0, 0, 0);
1020 if (inst_regs)
1021 *inst_regs = iprv.v0;
1022 if (data_regs)
1023 *data_regs = iprv.v1;
1025 return iprv.status;
1028 #ifdef TBD
1029 /* Switch from IA64-system environment to IA-32 system environment */
1030 static inline s64
1031 ia64_pal_enter_ia32_env (ia32_env1, ia32_env2, ia32_env3)
1033 struct ia64_pal_retval iprv;
1034 PAL_CALL(iprv, PAL_ENTER_IA_32_ENV, ia32_env1, ia32_env2, ia32_env3);
1035 return iprv.status;
1037 #endif
1039 /* Get unique geographical address of this processor on its bus */
1040 static inline s64
1041 ia64_pal_fixed_addr (u64 *global_unique_addr)
1043 struct ia64_pal_retval iprv;
1044 PAL_CALL(iprv, PAL_FIXED_ADDR, 0, 0, 0);
1045 if (global_unique_addr)
1046 *global_unique_addr = iprv.v0;
1047 return iprv.status;
1050 /* Get base frequency of the platform if generated by the processor */
1051 static inline s64
1052 ia64_pal_freq_base (u64 *platform_base_freq)
1054 struct ia64_pal_retval iprv;
1055 PAL_CALL(iprv, PAL_FREQ_BASE, 0, 0, 0);
1056 if (platform_base_freq)
1057 *platform_base_freq = iprv.v0;
1058 return iprv.status;
1062 * Get the ratios for processor frequency, bus frequency and interval timer to
1063 * to base frequency of the platform
1065 static inline s64
1066 ia64_pal_freq_ratios (struct pal_freq_ratio *proc_ratio, struct pal_freq_ratio *bus_ratio,
1067 struct pal_freq_ratio *itc_ratio)
1069 struct ia64_pal_retval iprv;
1070 PAL_CALL(iprv, PAL_FREQ_RATIOS, 0, 0, 0);
1071 if (proc_ratio)
1072 *(u64 *)proc_ratio = iprv.v0;
1073 if (bus_ratio)
1074 *(u64 *)bus_ratio = iprv.v1;
1075 if (itc_ratio)
1076 *(u64 *)itc_ratio = iprv.v2;
1077 return iprv.status;
1080 /* Make the processor enter HALT or one of the implementation dependent low
1081 * power states where prefetching and execution are suspended and cache and
1082 * TLB coherency is not maintained.
1084 static inline s64
1085 ia64_pal_halt (u64 halt_state)
1087 struct ia64_pal_retval iprv;
1088 PAL_CALL(iprv, PAL_HALT, halt_state, 0, 0);
1089 return iprv.status;
1092 typedef union pal_power_mgmt_info_u {
1093 u64 ppmi_data;
1094 struct {
1095 u64 exit_latency : 16,
1096 entry_latency : 16,
1097 power_consumption : 28,
1098 im : 1,
1099 co : 1,
1100 reserved : 2;
1101 } pal_power_mgmt_info_s;
1102 } pal_power_mgmt_info_u_t;
1104 /* Return information about processor's optional power management capabilities. */
1105 static inline s64
1106 ia64_pal_halt_info (pal_power_mgmt_info_u_t *power_buf)
1108 struct ia64_pal_retval iprv;
1109 PAL_CALL_STK(iprv, PAL_HALT_INFO, (unsigned long) power_buf, 0, 0);
1110 return iprv.status;
1113 /* Get the current P-state information */
1114 static inline s64
1115 ia64_pal_get_pstate (u64 *pstate_index)
1117 struct ia64_pal_retval iprv;
1118 PAL_CALL_STK(iprv, PAL_GET_PSTATE, 0, 0, 0);
1119 *pstate_index = iprv.v0;
1120 return iprv.status;
1123 /* Set the P-state */
1124 static inline s64
1125 ia64_pal_set_pstate (u64 pstate_index)
1127 struct ia64_pal_retval iprv;
1128 PAL_CALL_STK(iprv, PAL_SET_PSTATE, pstate_index, 0, 0);
1129 return iprv.status;
1132 /* Processor branding information*/
1133 static inline s64
1134 ia64_pal_get_brand_info (char *brand_info)
1136 struct ia64_pal_retval iprv;
1137 PAL_CALL_STK(iprv, PAL_BRAND_INFO, 0, (u64)brand_info, 0);
1138 return iprv.status;
1141 /* Cause the processor to enter LIGHT HALT state, where prefetching and execution are
1142 * suspended, but cache and TLB coherency is maintained.
1144 static inline s64
1145 ia64_pal_halt_light (void)
1147 struct ia64_pal_retval iprv;
1148 PAL_CALL(iprv, PAL_HALT_LIGHT, 0, 0, 0);
1149 return iprv.status;
1152 /* Clear all the processor error logging registers and reset the indicator that allows
1153 * the error logging registers to be written. This procedure also checks the pending
1154 * machine check bit and pending INIT bit and reports their states.
1156 static inline s64
1157 ia64_pal_mc_clear_log (u64 *pending_vector)
1159 struct ia64_pal_retval iprv;
1160 PAL_CALL(iprv, PAL_MC_CLEAR_LOG, 0, 0, 0);
1161 if (pending_vector)
1162 *pending_vector = iprv.v0;
1163 return iprv.status;
1166 /* Ensure that all outstanding transactions in a processor are completed or that any
1167 * MCA due to thes outstanding transaction is taken.
1169 static inline s64
1170 ia64_pal_mc_drain (void)
1172 struct ia64_pal_retval iprv;
1173 PAL_CALL(iprv, PAL_MC_DRAIN, 0, 0, 0);
1174 return iprv.status;
1177 /* Return the machine check dynamic processor state */
1178 static inline s64
1179 ia64_pal_mc_dynamic_state (u64 offset, u64 *size, u64 *pds)
1181 struct ia64_pal_retval iprv;
1182 PAL_CALL(iprv, PAL_MC_DYNAMIC_STATE, offset, 0, 0);
1183 if (size)
1184 *size = iprv.v0;
1185 if (pds)
1186 *pds = iprv.v1;
1187 return iprv.status;
1190 /* Return processor machine check information */
1191 static inline s64
1192 ia64_pal_mc_error_info (u64 info_index, u64 type_index, u64 *size, u64 *error_info)
1194 struct ia64_pal_retval iprv;
1195 PAL_CALL(iprv, PAL_MC_ERROR_INFO, info_index, type_index, 0);
1196 if (size)
1197 *size = iprv.v0;
1198 if (error_info)
1199 *error_info = iprv.v1;
1200 return iprv.status;
1203 /* Inform PALE_CHECK whether a machine check is expected so that PALE_CHECK willnot
1204 * attempt to correct any expected machine checks.
1206 static inline s64
1207 ia64_pal_mc_expected (u64 expected, u64 *previous)
1209 struct ia64_pal_retval iprv;
1210 PAL_CALL(iprv, PAL_MC_EXPECTED, expected, 0, 0);
1211 if (previous)
1212 *previous = iprv.v0;
1213 return iprv.status;
1216 /* Register a platform dependent location with PAL to which it can save
1217 * minimal processor state in the event of a machine check or initialization
1218 * event.
1220 static inline s64
1221 ia64_pal_mc_register_mem (u64 physical_addr)
1223 struct ia64_pal_retval iprv;
1224 PAL_CALL(iprv, PAL_MC_REGISTER_MEM, physical_addr, 0, 0);
1225 return iprv.status;
1228 /* Restore minimal architectural processor state, set CMC interrupt if necessary
1229 * and resume execution
1231 static inline s64
1232 ia64_pal_mc_resume (u64 set_cmci, u64 save_ptr)
1234 struct ia64_pal_retval iprv;
1235 PAL_CALL(iprv, PAL_MC_RESUME, set_cmci, save_ptr, 0);
1236 return iprv.status;
1239 /* Return the memory attributes implemented by the processor */
1240 static inline s64
1241 ia64_pal_mem_attrib (u64 *mem_attrib)
1243 struct ia64_pal_retval iprv;
1244 PAL_CALL(iprv, PAL_MEM_ATTRIB, 0, 0, 0);
1245 if (mem_attrib)
1246 *mem_attrib = iprv.v0 & 0xff;
1247 return iprv.status;
1250 /* Return the amount of memory needed for second phase of processor
1251 * self-test and the required alignment of memory.
1253 static inline s64
1254 ia64_pal_mem_for_test (u64 *bytes_needed, u64 *alignment)
1256 struct ia64_pal_retval iprv;
1257 PAL_CALL(iprv, PAL_MEM_FOR_TEST, 0, 0, 0);
1258 if (bytes_needed)
1259 *bytes_needed = iprv.v0;
1260 if (alignment)
1261 *alignment = iprv.v1;
1262 return iprv.status;
1265 typedef union pal_perf_mon_info_u {
1266 u64 ppmi_data;
1267 struct {
1268 u64 generic : 8,
1269 width : 8,
1270 cycles : 8,
1271 retired : 8,
1272 reserved : 32;
1273 } pal_perf_mon_info_s;
1274 } pal_perf_mon_info_u_t;
1276 /* Return the performance monitor information about what can be counted
1277 * and how to configure the monitors to count the desired events.
1279 static inline s64
1280 ia64_pal_perf_mon_info (u64 *pm_buffer, pal_perf_mon_info_u_t *pm_info)
1282 struct ia64_pal_retval iprv;
1283 PAL_CALL(iprv, PAL_PERF_MON_INFO, (unsigned long) pm_buffer, 0, 0);
1284 if (pm_info)
1285 pm_info->ppmi_data = iprv.v0;
1286 return iprv.status;
1289 /* Specifies the physical address of the processor interrupt block
1290 * and I/O port space.
1292 static inline s64
1293 ia64_pal_platform_addr (u64 type, u64 physical_addr)
1295 struct ia64_pal_retval iprv;
1296 PAL_CALL(iprv, PAL_PLATFORM_ADDR, type, physical_addr, 0);
1297 return iprv.status;
1300 /* Set the SAL PMI entrypoint in memory */
1301 static inline s64
1302 ia64_pal_pmi_entrypoint (u64 sal_pmi_entry_addr)
1304 struct ia64_pal_retval iprv;
1305 PAL_CALL(iprv, PAL_PMI_ENTRYPOINT, sal_pmi_entry_addr, 0, 0);
1306 return iprv.status;
1309 struct pal_features_s;
1310 /* Provide information about configurable processor features */
1311 static inline s64
1312 ia64_pal_proc_get_features (u64 *features_avail,
1313 u64 *features_status,
1314 u64 *features_control)
1316 struct ia64_pal_retval iprv;
1317 PAL_CALL_PHYS(iprv, PAL_PROC_GET_FEATURES, 0, 0, 0);
1318 if (iprv.status == 0) {
1319 *features_avail = iprv.v0;
1320 *features_status = iprv.v1;
1321 *features_control = iprv.v2;
1323 return iprv.status;
1326 /* Enable/disable processor dependent features */
1327 static inline s64
1328 ia64_pal_proc_set_features (u64 feature_select)
1330 struct ia64_pal_retval iprv;
1331 PAL_CALL_PHYS(iprv, PAL_PROC_SET_FEATURES, feature_select, 0, 0);
1332 return iprv.status;
1336 * Put everything in a struct so we avoid the global offset table whenever
1337 * possible.
1339 typedef struct ia64_ptce_info_s {
1340 u64 base;
1341 u32 count[2];
1342 u32 stride[2];
1343 } ia64_ptce_info_t;
1345 /* Return the information required for the architected loop used to purge
1346 * (initialize) the entire TC
1348 static inline s64
1349 ia64_get_ptce (ia64_ptce_info_t *ptce)
1351 struct ia64_pal_retval iprv;
1353 if (!ptce)
1354 return -1;
1356 PAL_CALL(iprv, PAL_PTCE_INFO, 0, 0, 0);
1357 if (iprv.status == 0) {
1358 ptce->base = iprv.v0;
1359 ptce->count[0] = iprv.v1 >> 32;
1360 ptce->count[1] = iprv.v1 & 0xffffffff;
1361 ptce->stride[0] = iprv.v2 >> 32;
1362 ptce->stride[1] = iprv.v2 & 0xffffffff;
1364 return iprv.status;
1367 /* Return info about implemented application and control registers. */
1368 static inline s64
1369 ia64_pal_register_info (u64 info_request, u64 *reg_info_1, u64 *reg_info_2)
1371 struct ia64_pal_retval iprv;
1372 PAL_CALL(iprv, PAL_REGISTER_INFO, info_request, 0, 0);
1373 if (reg_info_1)
1374 *reg_info_1 = iprv.v0;
1375 if (reg_info_2)
1376 *reg_info_2 = iprv.v1;
1377 return iprv.status;
1380 typedef union pal_hints_u {
1381 u64 ph_data;
1382 struct {
1383 u64 si : 1,
1384 li : 1,
1385 reserved : 62;
1386 } pal_hints_s;
1387 } pal_hints_u_t;
1389 /* Return information about the register stack and RSE for this processor
1390 * implementation.
1392 static inline s64
1393 ia64_pal_rse_info (u64 *num_phys_stacked, pal_hints_u_t *hints)
1395 struct ia64_pal_retval iprv;
1396 PAL_CALL(iprv, PAL_RSE_INFO, 0, 0, 0);
1397 if (num_phys_stacked)
1398 *num_phys_stacked = iprv.v0;
1399 if (hints)
1400 hints->ph_data = iprv.v1;
1401 return iprv.status;
1404 /* Cause the processor to enter SHUTDOWN state, where prefetching and execution are
1405 * suspended, but cause cache and TLB coherency to be maintained.
1406 * This is usually called in IA-32 mode.
1408 static inline s64
1409 ia64_pal_shutdown (void)
1411 struct ia64_pal_retval iprv;
1412 PAL_CALL(iprv, PAL_SHUTDOWN, 0, 0, 0);
1413 return iprv.status;
1416 /* Perform the second phase of processor self-test. */
1417 static inline s64
1418 ia64_pal_test_proc (u64 test_addr, u64 test_size, u64 attributes, u64 *self_test_state)
1420 struct ia64_pal_retval iprv;
1421 PAL_CALL(iprv, PAL_TEST_PROC, test_addr, test_size, attributes);
1422 if (self_test_state)
1423 *self_test_state = iprv.v0;
1424 return iprv.status;
1427 typedef union pal_version_u {
1428 u64 pal_version_val;
1429 struct {
1430 u64 pv_pal_b_rev : 8;
1431 u64 pv_pal_b_model : 8;
1432 u64 pv_reserved1 : 8;
1433 u64 pv_pal_vendor : 8;
1434 u64 pv_pal_a_rev : 8;
1435 u64 pv_pal_a_model : 8;
1436 u64 pv_reserved2 : 16;
1437 } pal_version_s;
1438 } pal_version_u_t;
1442 * Return PAL version information. While the documentation states that
1443 * PAL_VERSION can be called in either physical or virtual mode, some
1444 * implementations only allow physical calls. We don't call it very often,
1445 * so the overhead isn't worth eliminating.
1447 static inline s64
1448 ia64_pal_version (pal_version_u_t *pal_min_version, pal_version_u_t *pal_cur_version)
1450 struct ia64_pal_retval iprv;
1451 PAL_CALL_PHYS(iprv, PAL_VERSION, 0, 0, 0);
1452 if (pal_min_version)
1453 pal_min_version->pal_version_val = iprv.v0;
1455 if (pal_cur_version)
1456 pal_cur_version->pal_version_val = iprv.v1;
1458 return iprv.status;
1461 typedef union pal_tc_info_u {
1462 u64 pti_val;
1463 struct {
1464 u64 num_sets : 8,
1465 associativity : 8,
1466 num_entries : 16,
1467 pf : 1,
1468 unified : 1,
1469 reduce_tr : 1,
1470 reserved : 29;
1471 } pal_tc_info_s;
1472 } pal_tc_info_u_t;
1474 #define tc_reduce_tr pal_tc_info_s.reduce_tr
1475 #define tc_unified pal_tc_info_s.unified
1476 #define tc_pf pal_tc_info_s.pf
1477 #define tc_num_entries pal_tc_info_s.num_entries
1478 #define tc_associativity pal_tc_info_s.associativity
1479 #define tc_num_sets pal_tc_info_s.num_sets
1482 /* Return information about the virtual memory characteristics of the processor
1483 * implementation.
1485 static inline s64
1486 ia64_pal_vm_info (u64 tc_level, u64 tc_type, pal_tc_info_u_t *tc_info, u64 *tc_pages)
1488 struct ia64_pal_retval iprv;
1489 PAL_CALL(iprv, PAL_VM_INFO, tc_level, tc_type, 0);
1490 if (tc_info)
1491 tc_info->pti_val = iprv.v0;
1492 if (tc_pages)
1493 *tc_pages = iprv.v1;
1494 return iprv.status;
1497 /* Get page size information about the virtual memory characteristics of the processor
1498 * implementation.
1500 static inline s64
1501 ia64_pal_vm_page_size (u64 *tr_pages, u64 *vw_pages)
1503 struct ia64_pal_retval iprv;
1504 PAL_CALL(iprv, PAL_VM_PAGE_SIZE, 0, 0, 0);
1505 if (tr_pages)
1506 *tr_pages = iprv.v0;
1507 if (vw_pages)
1508 *vw_pages = iprv.v1;
1509 return iprv.status;
1512 typedef union pal_vm_info_1_u {
1513 u64 pvi1_val;
1514 struct {
1515 u64 vw : 1,
1516 phys_add_size : 7,
1517 key_size : 8,
1518 max_pkr : 8,
1519 hash_tag_id : 8,
1520 max_dtr_entry : 8,
1521 max_itr_entry : 8,
1522 max_unique_tcs : 8,
1523 num_tc_levels : 8;
1524 } pal_vm_info_1_s;
1525 } pal_vm_info_1_u_t;
1527 typedef union pal_vm_info_2_u {
1528 u64 pvi2_val;
1529 struct {
1530 u64 impl_va_msb : 8,
1531 rid_size : 8,
1532 reserved : 48;
1533 } pal_vm_info_2_s;
1534 } pal_vm_info_2_u_t;
1536 /* Get summary information about the virtual memory characteristics of the processor
1537 * implementation.
1539 static inline s64
1540 ia64_pal_vm_summary (pal_vm_info_1_u_t *vm_info_1, pal_vm_info_2_u_t *vm_info_2)
1542 struct ia64_pal_retval iprv;
1543 PAL_CALL(iprv, PAL_VM_SUMMARY, 0, 0, 0);
1544 if (vm_info_1)
1545 vm_info_1->pvi1_val = iprv.v0;
1546 if (vm_info_2)
1547 vm_info_2->pvi2_val = iprv.v1;
1548 return iprv.status;
1551 typedef union pal_itr_valid_u {
1552 u64 piv_val;
1553 struct {
1554 u64 access_rights_valid : 1,
1555 priv_level_valid : 1,
1556 dirty_bit_valid : 1,
1557 mem_attr_valid : 1,
1558 reserved : 60;
1559 } pal_tr_valid_s;
1560 } pal_tr_valid_u_t;
1562 /* Read a translation register */
1563 static inline s64
1564 ia64_pal_tr_read (u64 reg_num, u64 tr_type, u64 *tr_buffer, pal_tr_valid_u_t *tr_valid)
1566 struct ia64_pal_retval iprv;
1567 PAL_CALL_PHYS_STK(iprv, PAL_VM_TR_READ, reg_num, tr_type,(u64)ia64_tpa(tr_buffer));
1568 if (tr_valid)
1569 tr_valid->piv_val = iprv.v0;
1570 return iprv.status;
1574 * PAL_PREFETCH_VISIBILITY transaction types
1576 #define PAL_VISIBILITY_VIRTUAL 0
1577 #define PAL_VISIBILITY_PHYSICAL 1
1580 * PAL_PREFETCH_VISIBILITY return codes
1582 #define PAL_VISIBILITY_OK 1
1583 #define PAL_VISIBILITY_OK_REMOTE_NEEDED 0
1584 #define PAL_VISIBILITY_INVAL_ARG -2
1585 #define PAL_VISIBILITY_ERROR -3
1587 static inline s64
1588 ia64_pal_prefetch_visibility (s64 trans_type)
1590 struct ia64_pal_retval iprv;
1591 PAL_CALL(iprv, PAL_PREFETCH_VISIBILITY, trans_type, 0, 0);
1592 return iprv.status;
1595 /* data structure for getting information on logical to physical mappings */
1596 typedef union pal_log_overview_u {
1597 struct {
1598 u64 num_log :16, /* Total number of logical
1599 * processors on this die
1601 tpc :8, /* Threads per core */
1602 reserved3 :8, /* Reserved */
1603 cpp :8, /* Cores per processor */
1604 reserved2 :8, /* Reserved */
1605 ppid :8, /* Physical processor ID */
1606 reserved1 :8; /* Reserved */
1607 } overview_bits;
1608 u64 overview_data;
1609 } pal_log_overview_t;
1611 typedef union pal_proc_n_log_info1_u{
1612 struct {
1613 u64 tid :16, /* Thread id */
1614 reserved2 :16, /* Reserved */
1615 cid :16, /* Core id */
1616 reserved1 :16; /* Reserved */
1617 } ppli1_bits;
1618 u64 ppli1_data;
1619 } pal_proc_n_log_info1_t;
1621 typedef union pal_proc_n_log_info2_u {
1622 struct {
1623 u64 la :16, /* Logical address */
1624 reserved :48; /* Reserved */
1625 } ppli2_bits;
1626 u64 ppli2_data;
1627 } pal_proc_n_log_info2_t;
1629 typedef struct pal_logical_to_physical_s
1631 pal_log_overview_t overview;
1632 pal_proc_n_log_info1_t ppli1;
1633 pal_proc_n_log_info2_t ppli2;
1634 } pal_logical_to_physical_t;
1636 #define overview_num_log overview.overview_bits.num_log
1637 #define overview_tpc overview.overview_bits.tpc
1638 #define overview_cpp overview.overview_bits.cpp
1639 #define overview_ppid overview.overview_bits.ppid
1640 #define log1_tid ppli1.ppli1_bits.tid
1641 #define log1_cid ppli1.ppli1_bits.cid
1642 #define log2_la ppli2.ppli2_bits.la
1644 /* Get information on logical to physical processor mappings. */
1645 static inline s64
1646 ia64_pal_logical_to_phys(u64 proc_number, pal_logical_to_physical_t *mapping)
1648 struct ia64_pal_retval iprv;
1650 PAL_CALL(iprv, PAL_LOGICAL_TO_PHYSICAL, proc_number, 0, 0);
1652 if (iprv.status == PAL_STATUS_SUCCESS)
1654 mapping->overview.overview_data = iprv.v0;
1655 mapping->ppli1.ppli1_data = iprv.v1;
1656 mapping->ppli2.ppli2_data = iprv.v2;
1659 return iprv.status;
1662 typedef struct pal_cache_shared_info_s
1664 u64 num_shared;
1665 pal_proc_n_log_info1_t ppli1;
1666 pal_proc_n_log_info2_t ppli2;
1667 } pal_cache_shared_info_t;
1669 /* Get information on logical to physical processor mappings. */
1670 static inline s64
1671 ia64_pal_cache_shared_info(u64 level,
1672 u64 type,
1673 u64 proc_number,
1674 pal_cache_shared_info_t *info)
1676 struct ia64_pal_retval iprv;
1678 PAL_CALL(iprv, PAL_CACHE_SHARED_INFO, level, type, proc_number);
1680 if (iprv.status == PAL_STATUS_SUCCESS) {
1681 info->num_shared = iprv.v0;
1682 info->ppli1.ppli1_data = iprv.v1;
1683 info->ppli2.ppli2_data = iprv.v2;
1686 return iprv.status;
1688 #endif /* __ASSEMBLY__ */
1690 #endif /* _ASM_IA64_PAL_H */