xref: /openbmc/qemu/include/hw/ppc/spapr.h (revision 9d953ce44722eeb10d99c814478065bebbf7e1f6)
1 #ifndef HW_SPAPR_H
2 #define HW_SPAPR_H
3 
4 #include "qemu/units.h"
5 #include "sysemu/dma.h"
6 #include "hw/boards.h"
7 #include "hw/ppc/spapr_drc.h"
8 #include "hw/mem/pc-dimm.h"
9 #include "hw/ppc/spapr_ovec.h"
10 #include "hw/ppc/spapr_irq.h"
11 #include "hw/ppc/spapr_xive.h"  /* For SpaprXive */
12 #include "hw/ppc/xics.h"        /* For ICSState */
13 #include "hw/ppc/spapr_tpm_proxy.h"
14 
15 struct SpaprVioBus;
16 struct SpaprPhbState;
17 struct SpaprNvram;
18 
19 typedef struct SpaprEventLogEntry SpaprEventLogEntry;
20 typedef struct SpaprEventSource SpaprEventSource;
21 typedef struct SpaprPendingHpt SpaprPendingHpt;
22 
23 #define HPTE64_V_HPTE_DIRTY     0x0000000000000040ULL
24 #define SPAPR_ENTRY_POINT       0x100
25 
26 #define SPAPR_TIMEBASE_FREQ     512000000ULL
27 
28 #define TYPE_SPAPR_RTC "spapr-rtc"
29 
30 #define SPAPR_RTC(obj)                                  \
31     OBJECT_CHECK(SpaprRtcState, (obj), TYPE_SPAPR_RTC)
32 
33 typedef struct SpaprRtcState SpaprRtcState;
34 struct SpaprRtcState {
35     /*< private >*/
36     DeviceState parent_obj;
37     int64_t ns_offset;
38 };
39 
40 typedef struct SpaprDimmState SpaprDimmState;
41 typedef struct SpaprMachineClass SpaprMachineClass;
42 
43 #define TYPE_SPAPR_MACHINE      "spapr-machine"
44 #define SPAPR_MACHINE(obj) \
45     OBJECT_CHECK(SpaprMachineState, (obj), TYPE_SPAPR_MACHINE)
46 #define SPAPR_MACHINE_GET_CLASS(obj) \
47     OBJECT_GET_CLASS(SpaprMachineClass, obj, TYPE_SPAPR_MACHINE)
48 #define SPAPR_MACHINE_CLASS(klass) \
49     OBJECT_CLASS_CHECK(SpaprMachineClass, klass, TYPE_SPAPR_MACHINE)
50 
51 typedef enum {
52     SPAPR_RESIZE_HPT_DEFAULT = 0,
53     SPAPR_RESIZE_HPT_DISABLED,
54     SPAPR_RESIZE_HPT_ENABLED,
55     SPAPR_RESIZE_HPT_REQUIRED,
56 } SpaprResizeHpt;
57 
58 /**
59  * Capabilities
60  */
61 
62 /* Hardware Transactional Memory */
63 #define SPAPR_CAP_HTM                   0x00
64 /* Vector Scalar Extensions */
65 #define SPAPR_CAP_VSX                   0x01
66 /* Decimal Floating Point */
67 #define SPAPR_CAP_DFP                   0x02
68 /* Cache Flush on Privilege Change */
69 #define SPAPR_CAP_CFPC                  0x03
70 /* Speculation Barrier Bounds Checking */
71 #define SPAPR_CAP_SBBC                  0x04
72 /* Indirect Branch Serialisation */
73 #define SPAPR_CAP_IBS                   0x05
74 /* HPT Maximum Page Size (encoded as a shift) */
75 #define SPAPR_CAP_HPT_MAXPAGESIZE       0x06
76 /* Nested KVM-HV */
77 #define SPAPR_CAP_NESTED_KVM_HV         0x07
78 /* Large Decrementer */
79 #define SPAPR_CAP_LARGE_DECREMENTER     0x08
80 /* Count Cache Flush Assist HW Instruction */
81 #define SPAPR_CAP_CCF_ASSIST            0x09
82 /* FWNMI machine check handling */
83 #define SPAPR_CAP_FWNMI_MCE             0x0A
84 /* Num Caps */
85 #define SPAPR_CAP_NUM                   (SPAPR_CAP_FWNMI_MCE + 1)
86 
87 /*
88  * Capability Values
89  */
90 /* Bool Caps */
91 #define SPAPR_CAP_OFF                   0x00
92 #define SPAPR_CAP_ON                    0x01
93 
94 /* Custom Caps */
95 
96 /* Generic */
97 #define SPAPR_CAP_BROKEN                0x00
98 #define SPAPR_CAP_WORKAROUND            0x01
99 #define SPAPR_CAP_FIXED                 0x02
100 /* SPAPR_CAP_IBS (cap-ibs) */
101 #define SPAPR_CAP_FIXED_IBS             0x02
102 #define SPAPR_CAP_FIXED_CCD             0x03
103 #define SPAPR_CAP_FIXED_NA              0x10 /* Lets leave a bit of a gap... */
104 
105 typedef struct SpaprCapabilities SpaprCapabilities;
106 struct SpaprCapabilities {
107     uint8_t caps[SPAPR_CAP_NUM];
108 };
109 
110 /**
111  * SpaprMachineClass:
112  */
113 struct SpaprMachineClass {
114     /*< private >*/
115     MachineClass parent_class;
116 
117     /*< public >*/
118     bool dr_lmb_enabled;       /* enable dynamic-reconfig/hotplug of LMBs */
119     bool dr_phb_enabled;       /* enable dynamic-reconfig/hotplug of PHBs */
120     bool update_dt_enabled;    /* enable KVMPPC_H_UPDATE_DT */
121     bool use_ohci_by_default;  /* use USB-OHCI instead of XHCI */
122     bool pre_2_10_has_unused_icps;
123     bool legacy_irq_allocation;
124     uint32_t nr_xirqs;
125     bool broken_host_serial_model; /* present real host info to the guest */
126     bool pre_4_1_migration; /* don't migrate hpt-max-page-size */
127     bool linux_pci_probe;
128     bool smp_threads_vsmt; /* set VSMT to smp_threads by default */
129 
130     void (*phb_placement)(SpaprMachineState *spapr, uint32_t index,
131                           uint64_t *buid, hwaddr *pio,
132                           hwaddr *mmio32, hwaddr *mmio64,
133                           unsigned n_dma, uint32_t *liobns, hwaddr *nv2gpa,
134                           hwaddr *nv2atsd, Error **errp);
135     SpaprResizeHpt resize_hpt_default;
136     SpaprCapabilities default_caps;
137     SpaprIrq *irq;
138 };
139 
140 /**
141  * SpaprMachineState:
142  */
143 struct SpaprMachineState {
144     /*< private >*/
145     MachineState parent_obj;
146 
147     struct SpaprVioBus *vio_bus;
148     QLIST_HEAD(, SpaprPhbState) phbs;
149     struct SpaprNvram *nvram;
150     SpaprRtcState rtc;
151 
152     SpaprResizeHpt resize_hpt;
153     void *htab;
154     uint32_t htab_shift;
155     uint64_t patb_entry; /* Process tbl registed in H_REGISTER_PROCESS_TABLE */
156     SpaprPendingHpt *pending_hpt; /* in-progress resize */
157 
158     hwaddr rma_size;
159     int vrma_adjust;
160     uint32_t fdt_size;
161     uint32_t fdt_initial_size;
162     void *fdt_blob;
163     long kernel_size;
164     bool kernel_le;
165     uint32_t initrd_base;
166     long initrd_size;
167     uint64_t rtc_offset; /* Now used only during incoming migration */
168     struct PPCTimebase tb;
169     bool has_graphics;
170     uint32_t vsmt;       /* Virtual SMT mode (KVM's "core stride") */
171 
172     Notifier epow_notifier;
173     QTAILQ_HEAD(, SpaprEventLogEntry) pending_events;
174     bool use_hotplug_event_source;
175     SpaprEventSource *event_sources;
176 
177     /* ibm,client-architecture-support option negotiation */
178     bool cas_reboot;
179     bool cas_pre_isa3_guest;
180     SpaprOptionVector *ov5;         /* QEMU-supported option vectors */
181     SpaprOptionVector *ov5_cas;     /* negotiated (via CAS) option vectors */
182     uint32_t max_compat_pvr;
183 
184     /* Migration state */
185     int htab_save_index;
186     bool htab_first_pass;
187     int htab_fd;
188 
189     /* Pending DIMM unplug cache. It is populated when a LMB
190      * unplug starts. It can be regenerated if a migration
191      * occurs during the unplug process. */
192     QTAILQ_HEAD(, SpaprDimmState) pending_dimm_unplugs;
193 
194     /*< public >*/
195     char *kvm_type;
196     char *host_model;
197     char *host_serial;
198 
199     int32_t irq_map_nr;
200     unsigned long *irq_map;
201     SpaprIrq *irq;
202     qemu_irq *qirqs;
203     SpaprInterruptController *active_intc;
204     ICSState *ics;
205     SpaprXive *xive;
206 
207     bool cmd_line_caps[SPAPR_CAP_NUM];
208     SpaprCapabilities def, eff, mig;
209 
210     unsigned gpu_numa_id;
211     SpaprTpmProxy *tpm_proxy;
212 };
213 
214 #define H_SUCCESS         0
215 #define H_BUSY            1        /* Hardware busy -- retry later */
216 #define H_CLOSED          2        /* Resource closed */
217 #define H_NOT_AVAILABLE   3
218 #define H_CONSTRAINED     4        /* Resource request constrained to max allowed */
219 #define H_PARTIAL         5
220 #define H_IN_PROGRESS     14       /* Kind of like busy */
221 #define H_PAGE_REGISTERED 15
222 #define H_PARTIAL_STORE   16
223 #define H_PENDING         17       /* returned from H_POLL_PENDING */
224 #define H_CONTINUE        18       /* Returned from H_Join on success */
225 #define H_LONG_BUSY_START_RANGE         9900  /* Start of long busy range */
226 #define H_LONG_BUSY_ORDER_1_MSEC        9900  /* Long busy, hint that 1msec \
227                                                  is a good time to retry */
228 #define H_LONG_BUSY_ORDER_10_MSEC       9901  /* Long busy, hint that 10msec \
229                                                  is a good time to retry */
230 #define H_LONG_BUSY_ORDER_100_MSEC      9902  /* Long busy, hint that 100msec \
231                                                  is a good time to retry */
232 #define H_LONG_BUSY_ORDER_1_SEC         9903  /* Long busy, hint that 1sec \
233                                                  is a good time to retry */
234 #define H_LONG_BUSY_ORDER_10_SEC        9904  /* Long busy, hint that 10sec \
235                                                  is a good time to retry */
236 #define H_LONG_BUSY_ORDER_100_SEC       9905  /* Long busy, hint that 100sec \
237                                                  is a good time to retry */
238 #define H_LONG_BUSY_END_RANGE           9905  /* End of long busy range */
239 #define H_HARDWARE        -1       /* Hardware error */
240 #define H_FUNCTION        -2       /* Function not supported */
241 #define H_PRIVILEGE       -3       /* Caller not privileged */
242 #define H_PARAMETER       -4       /* Parameter invalid, out-of-range or conflicting */
243 #define H_BAD_MODE        -5       /* Illegal msr value */
244 #define H_PTEG_FULL       -6       /* PTEG is full */
245 #define H_NOT_FOUND       -7       /* PTE was not found" */
246 #define H_RESERVED_DABR   -8       /* DABR address is reserved by the hypervisor on this processor" */
247 #define H_NO_MEM          -9
248 #define H_AUTHORITY       -10
249 #define H_PERMISSION      -11
250 #define H_DROPPED         -12
251 #define H_SOURCE_PARM     -13
252 #define H_DEST_PARM       -14
253 #define H_REMOTE_PARM     -15
254 #define H_RESOURCE        -16
255 #define H_ADAPTER_PARM    -17
256 #define H_RH_PARM         -18
257 #define H_RCQ_PARM        -19
258 #define H_SCQ_PARM        -20
259 #define H_EQ_PARM         -21
260 #define H_RT_PARM         -22
261 #define H_ST_PARM         -23
262 #define H_SIGT_PARM       -24
263 #define H_TOKEN_PARM      -25
264 #define H_MLENGTH_PARM    -27
265 #define H_MEM_PARM        -28
266 #define H_MEM_ACCESS_PARM -29
267 #define H_ATTR_PARM       -30
268 #define H_PORT_PARM       -31
269 #define H_MCG_PARM        -32
270 #define H_VL_PARM         -33
271 #define H_TSIZE_PARM      -34
272 #define H_TRACE_PARM      -35
273 
274 #define H_MASK_PARM       -37
275 #define H_MCG_FULL        -38
276 #define H_ALIAS_EXIST     -39
277 #define H_P_COUNTER       -40
278 #define H_TABLE_FULL      -41
279 #define H_ALT_TABLE       -42
280 #define H_MR_CONDITION    -43
281 #define H_NOT_ENOUGH_RESOURCES -44
282 #define H_R_STATE         -45
283 #define H_RESCINDEND      -46
284 #define H_P2              -55
285 #define H_P3              -56
286 #define H_P4              -57
287 #define H_P5              -58
288 #define H_P6              -59
289 #define H_P7              -60
290 #define H_P8              -61
291 #define H_P9              -62
292 #define H_UNSUPPORTED_FLAG -256
293 #define H_MULTI_THREADS_ACTIVE -9005
294 
295 
296 /* Long Busy is a condition that can be returned by the firmware
297  * when a call cannot be completed now, but the identical call
298  * should be retried later.  This prevents calls blocking in the
299  * firmware for long periods of time.  Annoyingly the firmware can return
300  * a range of return codes, hinting at how long we should wait before
301  * retrying.  If you don't care for the hint, the macro below is a good
302  * way to check for the long_busy return codes
303  */
304 #define H_IS_LONG_BUSY(x)  ((x >= H_LONG_BUSY_START_RANGE) \
305                             && (x <= H_LONG_BUSY_END_RANGE))
306 
307 /* Flags */
308 #define H_LARGE_PAGE      (1ULL<<(63-16))
309 #define H_EXACT           (1ULL<<(63-24))       /* Use exact PTE or return H_PTEG_FULL */
310 #define H_R_XLATE         (1ULL<<(63-25))       /* include a valid logical page num in the pte if the valid bit is set */
311 #define H_READ_4          (1ULL<<(63-26))       /* Return 4 PTEs */
312 #define H_PAGE_STATE_CHANGE (1ULL<<(63-28))
313 #define H_PAGE_UNUSED     ((1ULL<<(63-29)) | (1ULL<<(63-30)))
314 #define H_PAGE_SET_UNUSED (H_PAGE_STATE_CHANGE | H_PAGE_UNUSED)
315 #define H_PAGE_SET_LOANED (H_PAGE_SET_UNUSED | (1ULL<<(63-31)))
316 #define H_PAGE_SET_ACTIVE H_PAGE_STATE_CHANGE
317 #define H_AVPN            (1ULL<<(63-32))       /* An avpn is provided as a sanity test */
318 #define H_ANDCOND         (1ULL<<(63-33))
319 #define H_ICACHE_INVALIDATE (1ULL<<(63-40))     /* icbi, etc.  (ignored for IO pages) */
320 #define H_ICACHE_SYNCHRONIZE (1ULL<<(63-41))    /* dcbst, icbi, etc (ignored for IO pages */
321 #define H_ZERO_PAGE       (1ULL<<(63-48))       /* zero the page before mapping (ignored for IO pages) */
322 #define H_COPY_PAGE       (1ULL<<(63-49))
323 #define H_N               (1ULL<<(63-61))
324 #define H_PP1             (1ULL<<(63-62))
325 #define H_PP2             (1ULL<<(63-63))
326 
327 /* Values for 2nd argument to H_SET_MODE */
328 #define H_SET_MODE_RESOURCE_SET_CIABR           1
329 #define H_SET_MODE_RESOURCE_SET_DAWR            2
330 #define H_SET_MODE_RESOURCE_ADDR_TRANS_MODE     3
331 #define H_SET_MODE_RESOURCE_LE                  4
332 
333 /* Flags for H_SET_MODE_RESOURCE_LE */
334 #define H_SET_MODE_ENDIAN_BIG    0
335 #define H_SET_MODE_ENDIAN_LITTLE 1
336 
337 /* VASI States */
338 #define H_VASI_INVALID    0
339 #define H_VASI_ENABLED    1
340 #define H_VASI_ABORTED    2
341 #define H_VASI_SUSPENDING 3
342 #define H_VASI_SUSPENDED  4
343 #define H_VASI_RESUMED    5
344 #define H_VASI_COMPLETED  6
345 
346 /* DABRX flags */
347 #define H_DABRX_HYPERVISOR (1ULL<<(63-61))
348 #define H_DABRX_KERNEL     (1ULL<<(63-62))
349 #define H_DABRX_USER       (1ULL<<(63-63))
350 
351 /* Values for KVM_PPC_GET_CPU_CHAR & H_GET_CPU_CHARACTERISTICS */
352 #define H_CPU_CHAR_SPEC_BAR_ORI31               PPC_BIT(0)
353 #define H_CPU_CHAR_BCCTRL_SERIALISED            PPC_BIT(1)
354 #define H_CPU_CHAR_L1D_FLUSH_ORI30              PPC_BIT(2)
355 #define H_CPU_CHAR_L1D_FLUSH_TRIG2              PPC_BIT(3)
356 #define H_CPU_CHAR_L1D_THREAD_PRIV              PPC_BIT(4)
357 #define H_CPU_CHAR_HON_BRANCH_HINTS             PPC_BIT(5)
358 #define H_CPU_CHAR_THR_RECONF_TRIG              PPC_BIT(6)
359 #define H_CPU_CHAR_CACHE_COUNT_DIS              PPC_BIT(7)
360 #define H_CPU_CHAR_BCCTR_FLUSH_ASSIST           PPC_BIT(9)
361 #define H_CPU_BEHAV_FAVOUR_SECURITY             PPC_BIT(0)
362 #define H_CPU_BEHAV_L1D_FLUSH_PR                PPC_BIT(1)
363 #define H_CPU_BEHAV_BNDS_CHK_SPEC_BAR           PPC_BIT(2)
364 #define H_CPU_BEHAV_FLUSH_COUNT_CACHE           PPC_BIT(5)
365 
366 /* Each control block has to be on a 4K boundary */
367 #define H_CB_ALIGNMENT     4096
368 
369 /* pSeries hypervisor opcodes */
370 #define H_REMOVE                0x04
371 #define H_ENTER                 0x08
372 #define H_READ                  0x0c
373 #define H_CLEAR_MOD             0x10
374 #define H_CLEAR_REF             0x14
375 #define H_PROTECT               0x18
376 #define H_GET_TCE               0x1c
377 #define H_PUT_TCE               0x20
378 #define H_SET_SPRG0             0x24
379 #define H_SET_DABR              0x28
380 #define H_PAGE_INIT             0x2c
381 #define H_SET_ASR               0x30
382 #define H_ASR_ON                0x34
383 #define H_ASR_OFF               0x38
384 #define H_LOGICAL_CI_LOAD       0x3c
385 #define H_LOGICAL_CI_STORE      0x40
386 #define H_LOGICAL_CACHE_LOAD    0x44
387 #define H_LOGICAL_CACHE_STORE   0x48
388 #define H_LOGICAL_ICBI          0x4c
389 #define H_LOGICAL_DCBF          0x50
390 #define H_GET_TERM_CHAR         0x54
391 #define H_PUT_TERM_CHAR         0x58
392 #define H_REAL_TO_LOGICAL       0x5c
393 #define H_HYPERVISOR_DATA       0x60
394 #define H_EOI                   0x64
395 #define H_CPPR                  0x68
396 #define H_IPI                   0x6c
397 #define H_IPOLL                 0x70
398 #define H_XIRR                  0x74
399 #define H_PERFMON               0x7c
400 #define H_MIGRATE_DMA           0x78
401 #define H_REGISTER_VPA          0xDC
402 #define H_CEDE                  0xE0
403 #define H_CONFER                0xE4
404 #define H_PROD                  0xE8
405 #define H_GET_PPP               0xEC
406 #define H_SET_PPP               0xF0
407 #define H_PURR                  0xF4
408 #define H_PIC                   0xF8
409 #define H_REG_CRQ               0xFC
410 #define H_FREE_CRQ              0x100
411 #define H_VIO_SIGNAL            0x104
412 #define H_SEND_CRQ              0x108
413 #define H_COPY_RDMA             0x110
414 #define H_REGISTER_LOGICAL_LAN  0x114
415 #define H_FREE_LOGICAL_LAN      0x118
416 #define H_ADD_LOGICAL_LAN_BUFFER 0x11C
417 #define H_SEND_LOGICAL_LAN      0x120
418 #define H_BULK_REMOVE           0x124
419 #define H_MULTICAST_CTRL        0x130
420 #define H_SET_XDABR             0x134
421 #define H_STUFF_TCE             0x138
422 #define H_PUT_TCE_INDIRECT      0x13C
423 #define H_CHANGE_LOGICAL_LAN_MAC 0x14C
424 #define H_VTERM_PARTNER_INFO    0x150
425 #define H_REGISTER_VTERM        0x154
426 #define H_FREE_VTERM            0x158
427 #define H_RESET_EVENTS          0x15C
428 #define H_ALLOC_RESOURCE        0x160
429 #define H_FREE_RESOURCE         0x164
430 #define H_MODIFY_QP             0x168
431 #define H_QUERY_QP              0x16C
432 #define H_REREGISTER_PMR        0x170
433 #define H_REGISTER_SMR          0x174
434 #define H_QUERY_MR              0x178
435 #define H_QUERY_MW              0x17C
436 #define H_QUERY_HCA             0x180
437 #define H_QUERY_PORT            0x184
438 #define H_MODIFY_PORT           0x188
439 #define H_DEFINE_AQP1           0x18C
440 #define H_GET_TRACE_BUFFER      0x190
441 #define H_DEFINE_AQP0           0x194
442 #define H_RESIZE_MR             0x198
443 #define H_ATTACH_MCQP           0x19C
444 #define H_DETACH_MCQP           0x1A0
445 #define H_CREATE_RPT            0x1A4
446 #define H_REMOVE_RPT            0x1A8
447 #define H_REGISTER_RPAGES       0x1AC
448 #define H_DISABLE_AND_GETC      0x1B0
449 #define H_ERROR_DATA            0x1B4
450 #define H_GET_HCA_INFO          0x1B8
451 #define H_GET_PERF_COUNT        0x1BC
452 #define H_MANAGE_TRACE          0x1C0
453 #define H_GET_CPU_CHARACTERISTICS 0x1C8
454 #define H_FREE_LOGICAL_LAN_BUFFER 0x1D4
455 #define H_QUERY_INT_STATE       0x1E4
456 #define H_POLL_PENDING          0x1D8
457 #define H_ILLAN_ATTRIBUTES      0x244
458 #define H_MODIFY_HEA_QP         0x250
459 #define H_QUERY_HEA_QP          0x254
460 #define H_QUERY_HEA             0x258
461 #define H_QUERY_HEA_PORT        0x25C
462 #define H_MODIFY_HEA_PORT       0x260
463 #define H_REG_BCMC              0x264
464 #define H_DEREG_BCMC            0x268
465 #define H_REGISTER_HEA_RPAGES   0x26C
466 #define H_DISABLE_AND_GET_HEA   0x270
467 #define H_GET_HEA_INFO          0x274
468 #define H_ALLOC_HEA_RESOURCE    0x278
469 #define H_ADD_CONN              0x284
470 #define H_DEL_CONN              0x288
471 #define H_JOIN                  0x298
472 #define H_VASI_STATE            0x2A4
473 #define H_ENABLE_CRQ            0x2B0
474 #define H_GET_EM_PARMS          0x2B8
475 #define H_SET_MPP               0x2D0
476 #define H_GET_MPP               0x2D4
477 #define H_HOME_NODE_ASSOCIATIVITY 0x2EC
478 #define H_XIRR_X                0x2FC
479 #define H_RANDOM                0x300
480 #define H_SET_MODE              0x31C
481 #define H_RESIZE_HPT_PREPARE    0x36C
482 #define H_RESIZE_HPT_COMMIT     0x370
483 #define H_CLEAN_SLB             0x374
484 #define H_INVALIDATE_PID        0x378
485 #define H_REGISTER_PROC_TBL     0x37C
486 #define H_SIGNAL_SYS_RESET      0x380
487 
488 #define H_INT_GET_SOURCE_INFO   0x3A8
489 #define H_INT_SET_SOURCE_CONFIG 0x3AC
490 #define H_INT_GET_SOURCE_CONFIG 0x3B0
491 #define H_INT_GET_QUEUE_INFO    0x3B4
492 #define H_INT_SET_QUEUE_CONFIG  0x3B8
493 #define H_INT_GET_QUEUE_CONFIG  0x3BC
494 #define H_INT_SET_OS_REPORTING_LINE 0x3C0
495 #define H_INT_GET_OS_REPORTING_LINE 0x3C4
496 #define H_INT_ESB               0x3C8
497 #define H_INT_SYNC              0x3CC
498 #define H_INT_RESET             0x3D0
499 
500 #define MAX_HCALL_OPCODE        H_INT_RESET
501 
502 /* The hcalls above are standardized in PAPR and implemented by pHyp
503  * as well.
504  *
505  * We also need some hcalls which are specific to qemu / KVM-on-POWER.
506  * We put those into the 0xf000-0xfffc range which is reserved by PAPR
507  * for "platform-specific" hcalls.
508  */
509 #define KVMPPC_HCALL_BASE       0xf000
510 #define KVMPPC_H_RTAS           (KVMPPC_HCALL_BASE + 0x0)
511 #define KVMPPC_H_LOGICAL_MEMOP  (KVMPPC_HCALL_BASE + 0x1)
512 /* Client Architecture support */
513 #define KVMPPC_H_CAS            (KVMPPC_HCALL_BASE + 0x2)
514 #define KVMPPC_H_UPDATE_DT      (KVMPPC_HCALL_BASE + 0x3)
515 #define KVMPPC_HCALL_MAX        KVMPPC_H_UPDATE_DT
516 
517 /*
518  * The hcall range 0xEF00 to 0xEF80 is reserved for use in facilitating
519  * Secure VM mode via an Ultravisor / Protected Execution Facility
520  */
521 #define SVM_HCALL_BASE              0xEF00
522 #define SVM_H_TPM_COMM              0xEF10
523 #define SVM_HCALL_MAX               SVM_H_TPM_COMM
524 
525 
526 typedef struct SpaprDeviceTreeUpdateHeader {
527     uint32_t version_id;
528 } SpaprDeviceTreeUpdateHeader;
529 
530 #define hcall_dprintf(fmt, ...) \
531     do { \
532         qemu_log_mask(LOG_GUEST_ERROR, "%s: " fmt, __func__, ## __VA_ARGS__); \
533     } while (0)
534 
535 typedef target_ulong (*spapr_hcall_fn)(PowerPCCPU *cpu, SpaprMachineState *sm,
536                                        target_ulong opcode,
537                                        target_ulong *args);
538 
539 void spapr_register_hypercall(target_ulong opcode, spapr_hcall_fn fn);
540 target_ulong spapr_hypercall(PowerPCCPU *cpu, target_ulong opcode,
541                              target_ulong *args);
542 
543 /* Virtual Processor Area structure constants */
544 #define VPA_MIN_SIZE           640
545 #define VPA_SIZE_OFFSET        0x4
546 #define VPA_SHARED_PROC_OFFSET 0x9
547 #define VPA_SHARED_PROC_VAL    0x2
548 #define VPA_DISPATCH_COUNTER   0x100
549 
550 /* ibm,set-eeh-option */
551 #define RTAS_EEH_DISABLE                 0
552 #define RTAS_EEH_ENABLE                  1
553 #define RTAS_EEH_THAW_IO                 2
554 #define RTAS_EEH_THAW_DMA                3
555 
556 /* ibm,get-config-addr-info2 */
557 #define RTAS_GET_PE_ADDR                 0
558 #define RTAS_GET_PE_MODE                 1
559 #define RTAS_PE_MODE_NONE                0
560 #define RTAS_PE_MODE_NOT_SHARED          1
561 #define RTAS_PE_MODE_SHARED              2
562 
563 /* ibm,read-slot-reset-state2 */
564 #define RTAS_EEH_PE_STATE_NORMAL         0
565 #define RTAS_EEH_PE_STATE_RESET          1
566 #define RTAS_EEH_PE_STATE_STOPPED_IO_DMA 2
567 #define RTAS_EEH_PE_STATE_STOPPED_DMA    4
568 #define RTAS_EEH_PE_STATE_UNAVAIL        5
569 #define RTAS_EEH_NOT_SUPPORT             0
570 #define RTAS_EEH_SUPPORT                 1
571 #define RTAS_EEH_PE_UNAVAIL_INFO         1000
572 #define RTAS_EEH_PE_RECOVER_INFO         0
573 
574 /* ibm,set-slot-reset */
575 #define RTAS_SLOT_RESET_DEACTIVATE       0
576 #define RTAS_SLOT_RESET_HOT              1
577 #define RTAS_SLOT_RESET_FUNDAMENTAL      3
578 
579 /* ibm,slot-error-detail */
580 #define RTAS_SLOT_TEMP_ERR_LOG           1
581 #define RTAS_SLOT_PERM_ERR_LOG           2
582 
583 /* RTAS return codes */
584 #define RTAS_OUT_SUCCESS                        0
585 #define RTAS_OUT_NO_ERRORS_FOUND                1
586 #define RTAS_OUT_HW_ERROR                       -1
587 #define RTAS_OUT_BUSY                           -2
588 #define RTAS_OUT_PARAM_ERROR                    -3
589 #define RTAS_OUT_NOT_SUPPORTED                  -3
590 #define RTAS_OUT_NO_SUCH_INDICATOR              -3
591 #define RTAS_OUT_NOT_AUTHORIZED                 -9002
592 #define RTAS_OUT_SYSPARM_PARAM_ERROR            -9999
593 
594 /* DDW pagesize mask values from ibm,query-pe-dma-window */
595 #define RTAS_DDW_PGSIZE_4K       0x01
596 #define RTAS_DDW_PGSIZE_64K      0x02
597 #define RTAS_DDW_PGSIZE_16M      0x04
598 #define RTAS_DDW_PGSIZE_32M      0x08
599 #define RTAS_DDW_PGSIZE_64M      0x10
600 #define RTAS_DDW_PGSIZE_128M     0x20
601 #define RTAS_DDW_PGSIZE_256M     0x40
602 #define RTAS_DDW_PGSIZE_16G      0x80
603 
604 /* RTAS tokens */
605 #define RTAS_TOKEN_BASE      0x2000
606 
607 #define RTAS_DISPLAY_CHARACTER                  (RTAS_TOKEN_BASE + 0x00)
608 #define RTAS_GET_TIME_OF_DAY                    (RTAS_TOKEN_BASE + 0x01)
609 #define RTAS_SET_TIME_OF_DAY                    (RTAS_TOKEN_BASE + 0x02)
610 #define RTAS_POWER_OFF                          (RTAS_TOKEN_BASE + 0x03)
611 #define RTAS_SYSTEM_REBOOT                      (RTAS_TOKEN_BASE + 0x04)
612 #define RTAS_QUERY_CPU_STOPPED_STATE            (RTAS_TOKEN_BASE + 0x05)
613 #define RTAS_START_CPU                          (RTAS_TOKEN_BASE + 0x06)
614 #define RTAS_STOP_SELF                          (RTAS_TOKEN_BASE + 0x07)
615 #define RTAS_IBM_GET_SYSTEM_PARAMETER           (RTAS_TOKEN_BASE + 0x08)
616 #define RTAS_IBM_SET_SYSTEM_PARAMETER           (RTAS_TOKEN_BASE + 0x09)
617 #define RTAS_IBM_SET_XIVE                       (RTAS_TOKEN_BASE + 0x0A)
618 #define RTAS_IBM_GET_XIVE                       (RTAS_TOKEN_BASE + 0x0B)
619 #define RTAS_IBM_INT_OFF                        (RTAS_TOKEN_BASE + 0x0C)
620 #define RTAS_IBM_INT_ON                         (RTAS_TOKEN_BASE + 0x0D)
621 #define RTAS_CHECK_EXCEPTION                    (RTAS_TOKEN_BASE + 0x0E)
622 #define RTAS_EVENT_SCAN                         (RTAS_TOKEN_BASE + 0x0F)
623 #define RTAS_IBM_SET_TCE_BYPASS                 (RTAS_TOKEN_BASE + 0x10)
624 #define RTAS_QUIESCE                            (RTAS_TOKEN_BASE + 0x11)
625 #define RTAS_NVRAM_FETCH                        (RTAS_TOKEN_BASE + 0x12)
626 #define RTAS_NVRAM_STORE                        (RTAS_TOKEN_BASE + 0x13)
627 #define RTAS_READ_PCI_CONFIG                    (RTAS_TOKEN_BASE + 0x14)
628 #define RTAS_WRITE_PCI_CONFIG                   (RTAS_TOKEN_BASE + 0x15)
629 #define RTAS_IBM_READ_PCI_CONFIG                (RTAS_TOKEN_BASE + 0x16)
630 #define RTAS_IBM_WRITE_PCI_CONFIG               (RTAS_TOKEN_BASE + 0x17)
631 #define RTAS_IBM_QUERY_INTERRUPT_SOURCE_NUMBER  (RTAS_TOKEN_BASE + 0x18)
632 #define RTAS_IBM_CHANGE_MSI                     (RTAS_TOKEN_BASE + 0x19)
633 #define RTAS_SET_INDICATOR                      (RTAS_TOKEN_BASE + 0x1A)
634 #define RTAS_SET_POWER_LEVEL                    (RTAS_TOKEN_BASE + 0x1B)
635 #define RTAS_GET_POWER_LEVEL                    (RTAS_TOKEN_BASE + 0x1C)
636 #define RTAS_GET_SENSOR_STATE                   (RTAS_TOKEN_BASE + 0x1D)
637 #define RTAS_IBM_CONFIGURE_CONNECTOR            (RTAS_TOKEN_BASE + 0x1E)
638 #define RTAS_IBM_OS_TERM                        (RTAS_TOKEN_BASE + 0x1F)
639 #define RTAS_IBM_SET_EEH_OPTION                 (RTAS_TOKEN_BASE + 0x20)
640 #define RTAS_IBM_GET_CONFIG_ADDR_INFO2          (RTAS_TOKEN_BASE + 0x21)
641 #define RTAS_IBM_READ_SLOT_RESET_STATE2         (RTAS_TOKEN_BASE + 0x22)
642 #define RTAS_IBM_SET_SLOT_RESET                 (RTAS_TOKEN_BASE + 0x23)
643 #define RTAS_IBM_CONFIGURE_PE                   (RTAS_TOKEN_BASE + 0x24)
644 #define RTAS_IBM_SLOT_ERROR_DETAIL              (RTAS_TOKEN_BASE + 0x25)
645 #define RTAS_IBM_QUERY_PE_DMA_WINDOW            (RTAS_TOKEN_BASE + 0x26)
646 #define RTAS_IBM_CREATE_PE_DMA_WINDOW           (RTAS_TOKEN_BASE + 0x27)
647 #define RTAS_IBM_REMOVE_PE_DMA_WINDOW           (RTAS_TOKEN_BASE + 0x28)
648 #define RTAS_IBM_RESET_PE_DMA_WINDOW            (RTAS_TOKEN_BASE + 0x29)
649 #define RTAS_IBM_SUSPEND_ME                     (RTAS_TOKEN_BASE + 0x2A)
650 
651 #define RTAS_TOKEN_MAX                          (RTAS_TOKEN_BASE + 0x2B)
652 
653 /* RTAS ibm,get-system-parameter token values */
654 #define RTAS_SYSPARM_SPLPAR_CHARACTERISTICS      20
655 #define RTAS_SYSPARM_DIAGNOSTICS_RUN_MODE        42
656 #define RTAS_SYSPARM_UUID                        48
657 
658 /* RTAS indicator/sensor types
659  *
660  * as defined by PAPR+ 2.7 7.3.5.4, Table 41
661  *
662  * NOTE: currently only DR-related sensors are implemented here
663  */
664 #define RTAS_SENSOR_TYPE_ISOLATION_STATE        9001
665 #define RTAS_SENSOR_TYPE_DR                     9002
666 #define RTAS_SENSOR_TYPE_ALLOCATION_STATE       9003
667 #define RTAS_SENSOR_TYPE_ENTITY_SENSE RTAS_SENSOR_TYPE_ALLOCATION_STATE
668 
669 /* Possible values for the platform-processor-diagnostics-run-mode parameter
670  * of the RTAS ibm,get-system-parameter call.
671  */
672 #define DIAGNOSTICS_RUN_MODE_DISABLED  0
673 #define DIAGNOSTICS_RUN_MODE_STAGGERED 1
674 #define DIAGNOSTICS_RUN_MODE_IMMEDIATE 2
675 #define DIAGNOSTICS_RUN_MODE_PERIODIC  3
676 
677 static inline uint64_t ppc64_phys_to_real(uint64_t addr)
678 {
679     return addr & ~0xF000000000000000ULL;
680 }
681 
682 static inline uint32_t rtas_ld(target_ulong phys, int n)
683 {
684     return ldl_be_phys(&address_space_memory, ppc64_phys_to_real(phys + 4*n));
685 }
686 
687 static inline uint64_t rtas_ldq(target_ulong phys, int n)
688 {
689     return (uint64_t)rtas_ld(phys, n) << 32 | rtas_ld(phys, n + 1);
690 }
691 
692 static inline void rtas_st(target_ulong phys, int n, uint32_t val)
693 {
694     stl_be_phys(&address_space_memory, ppc64_phys_to_real(phys + 4*n), val);
695 }
696 
697 typedef void (*spapr_rtas_fn)(PowerPCCPU *cpu, SpaprMachineState *sm,
698                               uint32_t token,
699                               uint32_t nargs, target_ulong args,
700                               uint32_t nret, target_ulong rets);
701 void spapr_rtas_register(int token, const char *name, spapr_rtas_fn fn);
702 target_ulong spapr_rtas_call(PowerPCCPU *cpu, SpaprMachineState *sm,
703                              uint32_t token, uint32_t nargs, target_ulong args,
704                              uint32_t nret, target_ulong rets);
705 void spapr_dt_rtas_tokens(void *fdt, int rtas);
706 void spapr_load_rtas(SpaprMachineState *spapr, void *fdt, hwaddr addr);
707 
708 #define SPAPR_TCE_PAGE_SHIFT   12
709 #define SPAPR_TCE_PAGE_SIZE    (1ULL << SPAPR_TCE_PAGE_SHIFT)
710 #define SPAPR_TCE_PAGE_MASK    (SPAPR_TCE_PAGE_SIZE - 1)
711 
712 #define SPAPR_VIO_BASE_LIOBN    0x00000000
713 #define SPAPR_VIO_LIOBN(reg)    (0x00000000 | (reg))
714 #define SPAPR_PCI_LIOBN(phb_index, window_num) \
715     (0x80000000 | ((phb_index) << 8) | (window_num))
716 #define SPAPR_IS_PCI_LIOBN(liobn)   (!!((liobn) & 0x80000000))
717 #define SPAPR_PCI_DMA_WINDOW_NUM(liobn) ((liobn) & 0xff)
718 
719 #define RTAS_ERROR_LOG_MAX      2048
720 
721 #define RTAS_EVENT_SCAN_RATE    1
722 
723 /* This helper should be used to encode interrupt specifiers when the related
724  * "interrupt-controller" node has its "#interrupt-cells" property set to 2 (ie,
725  * VIO devices, RTAS event sources and PHBs).
726  */
727 static inline void spapr_dt_irq(uint32_t *intspec, int irq, bool is_lsi)
728 {
729     intspec[0] = cpu_to_be32(irq);
730     intspec[1] = is_lsi ? cpu_to_be32(1) : 0;
731 }
732 
733 typedef struct SpaprTceTable SpaprTceTable;
734 
735 #define TYPE_SPAPR_TCE_TABLE "spapr-tce-table"
736 #define SPAPR_TCE_TABLE(obj) \
737     OBJECT_CHECK(SpaprTceTable, (obj), TYPE_SPAPR_TCE_TABLE)
738 
739 #define TYPE_SPAPR_IOMMU_MEMORY_REGION "spapr-iommu-memory-region"
740 #define SPAPR_IOMMU_MEMORY_REGION(obj) \
741         OBJECT_CHECK(IOMMUMemoryRegion, (obj), TYPE_SPAPR_IOMMU_MEMORY_REGION)
742 
743 struct SpaprTceTable {
744     DeviceState parent;
745     uint32_t liobn;
746     uint32_t nb_table;
747     uint64_t bus_offset;
748     uint32_t page_shift;
749     uint64_t *table;
750     uint32_t mig_nb_table;
751     uint64_t *mig_table;
752     bool bypass;
753     bool need_vfio;
754     bool skipping_replay;
755     int fd;
756     MemoryRegion root;
757     IOMMUMemoryRegion iommu;
758     struct SpaprVioDevice *vdev; /* for @bypass migration compatibility only */
759     QLIST_ENTRY(SpaprTceTable) list;
760 };
761 
762 SpaprTceTable *spapr_tce_find_by_liobn(target_ulong liobn);
763 
764 struct SpaprEventLogEntry {
765     uint32_t summary;
766     uint32_t extended_length;
767     void *extended_log;
768     QTAILQ_ENTRY(SpaprEventLogEntry) next;
769 };
770 
771 void *spapr_build_fdt(SpaprMachineState *spapr, bool reset, size_t space);
772 void spapr_events_init(SpaprMachineState *sm);
773 void spapr_dt_events(SpaprMachineState *sm, void *fdt);
774 void close_htab_fd(SpaprMachineState *spapr);
775 void spapr_setup_hpt_and_vrma(SpaprMachineState *spapr);
776 void spapr_free_hpt(SpaprMachineState *spapr);
777 SpaprTceTable *spapr_tce_new_table(DeviceState *owner, uint32_t liobn);
778 void spapr_tce_table_enable(SpaprTceTable *tcet,
779                             uint32_t page_shift, uint64_t bus_offset,
780                             uint32_t nb_table);
781 void spapr_tce_table_disable(SpaprTceTable *tcet);
782 void spapr_tce_set_need_vfio(SpaprTceTable *tcet, bool need_vfio);
783 
784 MemoryRegion *spapr_tce_get_iommu(SpaprTceTable *tcet);
785 int spapr_dma_dt(void *fdt, int node_off, const char *propname,
786                  uint32_t liobn, uint64_t window, uint32_t size);
787 int spapr_tcet_dma_dt(void *fdt, int node_off, const char *propname,
788                       SpaprTceTable *tcet);
789 void spapr_pci_switch_vga(bool big_endian);
790 void spapr_hotplug_req_add_by_index(SpaprDrc *drc);
791 void spapr_hotplug_req_remove_by_index(SpaprDrc *drc);
792 void spapr_hotplug_req_add_by_count(SpaprDrcType drc_type,
793                                        uint32_t count);
794 void spapr_hotplug_req_remove_by_count(SpaprDrcType drc_type,
795                                           uint32_t count);
796 void spapr_hotplug_req_add_by_count_indexed(SpaprDrcType drc_type,
797                                             uint32_t count, uint32_t index);
798 void spapr_hotplug_req_remove_by_count_indexed(SpaprDrcType drc_type,
799                                                uint32_t count, uint32_t index);
800 int spapr_hpt_shift_for_ramsize(uint64_t ramsize);
801 void spapr_reallocate_hpt(SpaprMachineState *spapr, int shift,
802                           Error **errp);
803 void spapr_clear_pending_events(SpaprMachineState *spapr);
804 int spapr_max_server_number(SpaprMachineState *spapr);
805 void spapr_store_hpte(PowerPCCPU *cpu, hwaddr ptex,
806                       uint64_t pte0, uint64_t pte1);
807 
808 /* DRC callbacks. */
809 void spapr_core_release(DeviceState *dev);
810 int spapr_core_dt_populate(SpaprDrc *drc, SpaprMachineState *spapr,
811                            void *fdt, int *fdt_start_offset, Error **errp);
812 void spapr_lmb_release(DeviceState *dev);
813 int spapr_lmb_dt_populate(SpaprDrc *drc, SpaprMachineState *spapr,
814                           void *fdt, int *fdt_start_offset, Error **errp);
815 void spapr_phb_release(DeviceState *dev);
816 int spapr_phb_dt_populate(SpaprDrc *drc, SpaprMachineState *spapr,
817                           void *fdt, int *fdt_start_offset, Error **errp);
818 
819 void spapr_rtc_read(SpaprRtcState *rtc, struct tm *tm, uint32_t *ns);
820 int spapr_rtc_import_offset(SpaprRtcState *rtc, int64_t legacy_offset);
821 
822 #define TYPE_SPAPR_RNG "spapr-rng"
823 
824 #define SPAPR_MEMORY_BLOCK_SIZE ((hwaddr)1 << 28) /* 256MB */
825 
826 /*
827  * This defines the maximum number of DIMM slots we can have for sPAPR
828  * guest. This is not defined by sPAPR but we are defining it to 32 slots
829  * based on default number of slots provided by PowerPC kernel.
830  */
831 #define SPAPR_MAX_RAM_SLOTS     32
832 
833 /* 1GB alignment for hotplug memory region */
834 #define SPAPR_DEVICE_MEM_ALIGN (1 * GiB)
835 
836 /*
837  * Number of 32 bit words in each LMB list entry in ibm,dynamic-memory
838  * property under ibm,dynamic-reconfiguration-memory node.
839  */
840 #define SPAPR_DR_LMB_LIST_ENTRY_SIZE 6
841 
842 /*
843  * Defines for flag value in ibm,dynamic-memory property under
844  * ibm,dynamic-reconfiguration-memory node.
845  */
846 #define SPAPR_LMB_FLAGS_ASSIGNED 0x00000008
847 #define SPAPR_LMB_FLAGS_DRC_INVALID 0x00000020
848 #define SPAPR_LMB_FLAGS_RESERVED 0x00000080
849 
850 void spapr_do_system_reset_on_cpu(CPUState *cs, run_on_cpu_data arg);
851 
852 #define HTAB_SIZE(spapr)        (1ULL << ((spapr)->htab_shift))
853 
854 int spapr_get_vcpu_id(PowerPCCPU *cpu);
855 void spapr_set_vcpu_id(PowerPCCPU *cpu, int cpu_index, Error **errp);
856 PowerPCCPU *spapr_find_cpu(int vcpu_id);
857 
858 int spapr_caps_pre_load(void *opaque);
859 int spapr_caps_pre_save(void *opaque);
860 
861 /*
862  * Handling of optional capabilities
863  */
864 extern const VMStateDescription vmstate_spapr_cap_htm;
865 extern const VMStateDescription vmstate_spapr_cap_vsx;
866 extern const VMStateDescription vmstate_spapr_cap_dfp;
867 extern const VMStateDescription vmstate_spapr_cap_cfpc;
868 extern const VMStateDescription vmstate_spapr_cap_sbbc;
869 extern const VMStateDescription vmstate_spapr_cap_ibs;
870 extern const VMStateDescription vmstate_spapr_cap_hpt_maxpagesize;
871 extern const VMStateDescription vmstate_spapr_cap_nested_kvm_hv;
872 extern const VMStateDescription vmstate_spapr_cap_large_decr;
873 extern const VMStateDescription vmstate_spapr_cap_ccf_assist;
874 extern const VMStateDescription vmstate_spapr_cap_fwnmi;
875 
876 static inline uint8_t spapr_get_cap(SpaprMachineState *spapr, int cap)
877 {
878     return spapr->eff.caps[cap];
879 }
880 
881 void spapr_caps_init(SpaprMachineState *spapr);
882 void spapr_caps_apply(SpaprMachineState *spapr);
883 void spapr_caps_cpu_apply(SpaprMachineState *spapr, PowerPCCPU *cpu);
884 void spapr_caps_add_properties(SpaprMachineClass *smc, Error **errp);
885 int spapr_caps_post_migration(SpaprMachineState *spapr);
886 
887 void spapr_check_pagesize(SpaprMachineState *spapr, hwaddr pagesize,
888                           Error **errp);
889 /*
890  * XIVE definitions
891  */
892 #define SPAPR_OV5_XIVE_LEGACY   0x0
893 #define SPAPR_OV5_XIVE_EXPLOIT  0x40
894 #define SPAPR_OV5_XIVE_BOTH     0x80 /* Only to advertise on the platform */
895 
896 void spapr_set_all_lpcrs(target_ulong value, target_ulong mask);
897 #endif /* HW_SPAPR_H */
898