docs: convert README, CODING_STYLE and HACKING to RST syntax
[qemu/ar7.git] / include / hw / ppc / spapr_xive.h
blobbfd40f01d882a96e3bb2fa0d7583f5eee9300054
1 /*
2 * QEMU PowerPC sPAPR XIVE interrupt controller model
4 * Copyright (c) 2017-2018, IBM Corporation.
6 * This code is licensed under the GPL version 2 or later. See the
7 * COPYING file in the top-level directory.
8 */
10 #ifndef PPC_SPAPR_XIVE_H
11 #define PPC_SPAPR_XIVE_H
13 #include "hw/ppc/spapr_irq.h"
14 #include "hw/ppc/xive.h"
16 #define TYPE_SPAPR_XIVE "spapr-xive"
17 #define SPAPR_XIVE(obj) OBJECT_CHECK(SpaprXive, (obj), TYPE_SPAPR_XIVE)
19 typedef struct SpaprXive {
20 XiveRouter parent;
22 /* Internal interrupt source for IPIs and virtual devices */
23 XiveSource source;
24 hwaddr vc_base;
26 /* END ESB MMIOs */
27 XiveENDSource end_source;
28 hwaddr end_base;
30 /* DT */
31 gchar *nodename;
33 /* Routing table */
34 XiveEAS *eat;
35 uint32_t nr_irqs;
36 XiveEND *endt;
37 uint32_t nr_ends;
39 /* TIMA mapping address */
40 hwaddr tm_base;
41 MemoryRegion tm_mmio;
43 /* KVM support */
44 int fd;
45 void *tm_mmap;
46 MemoryRegion tm_mmio_kvm;
47 VMChangeStateEntry *change;
48 } SpaprXive;
51 * The sPAPR machine has a unique XIVE IC device. Assign a fixed value
52 * to the controller block id value. It can nevertheless be changed
53 * for testing purpose.
55 #define SPAPR_XIVE_BLOCK_ID 0x0
57 bool spapr_xive_irq_claim(SpaprXive *xive, uint32_t lisn, bool lsi);
58 bool spapr_xive_irq_free(SpaprXive *xive, uint32_t lisn);
59 void spapr_xive_pic_print_info(SpaprXive *xive, Monitor *mon);
60 int spapr_xive_post_load(SpaprXive *xive, int version_id);
62 void spapr_xive_hcall_init(SpaprMachineState *spapr);
63 void spapr_dt_xive(SpaprMachineState *spapr, uint32_t nr_servers, void *fdt,
64 uint32_t phandle);
65 void spapr_xive_set_tctx_os_cam(XiveTCTX *tctx);
66 void spapr_xive_mmio_set_enabled(SpaprXive *xive, bool enable);
67 void spapr_xive_map_mmio(SpaprXive *xive);
69 int spapr_xive_end_to_target(uint8_t end_blk, uint32_t end_idx,
70 uint32_t *out_server, uint8_t *out_prio);
73 * KVM XIVE device helpers
75 void kvmppc_xive_connect(SpaprXive *xive, Error **errp);
76 void kvmppc_xive_disconnect(SpaprXive *xive, Error **errp);
77 void kvmppc_xive_reset(SpaprXive *xive, Error **errp);
78 void kvmppc_xive_set_source_config(SpaprXive *xive, uint32_t lisn, XiveEAS *eas,
79 Error **errp);
80 void kvmppc_xive_sync_source(SpaprXive *xive, uint32_t lisn, Error **errp);
81 uint64_t kvmppc_xive_esb_rw(XiveSource *xsrc, int srcno, uint32_t offset,
82 uint64_t data, bool write);
83 void kvmppc_xive_set_queue_config(SpaprXive *xive, uint8_t end_blk,
84 uint32_t end_idx, XiveEND *end,
85 Error **errp);
86 void kvmppc_xive_get_queue_config(SpaprXive *xive, uint8_t end_blk,
87 uint32_t end_idx, XiveEND *end,
88 Error **errp);
89 void kvmppc_xive_synchronize_state(SpaprXive *xive, Error **errp);
90 int kvmppc_xive_pre_save(SpaprXive *xive);
91 int kvmppc_xive_post_load(SpaprXive *xive, int version_id);
93 #endif /* PPC_SPAPR_XIVE_H */