master
h 230 lines 7.48 KB
Raw
1 /*
2 * SCLP Support
3 *
4 * Copyright IBM, Corp. 2012
5 *
6 * Authors:
7 * Christian Borntraeger <borntraeger@de.ibm.com>
8 *
9 * This work is licensed under the terms of the GNU GPL, version 2 or (at your
10 * option) any later version. See the COPYING file in the top-level directory.
11 *
12 */
13
14 #ifndef HW_S390_SCLP_H
15 #define HW_S390_SCLP_H
16
17 #include "hw/core/sysbus.h"
18 #include "target/s390x/cpu-qom.h"
19 #include "qom/object.h"
20
21 #define SCLP_CMD_CODE_MASK 0xffff00ff
22
23 /* SCLP command codes */
24 #define SCLP_CMDW_READ_SCP_INFO 0x00020001
25 #define SCLP_CMDW_READ_SCP_INFO_FORCED 0x00120001
26 #define SCLP_READ_STORAGE_ELEMENT_INFO 0x00040001
27 #define SCLP_ATTACH_STORAGE_ELEMENT 0x00080001
28 #define SCLP_ASSIGN_STORAGE 0x000D0001
29 #define SCLP_UNASSIGN_STORAGE 0x000C0001
30 #define SCLP_CMD_READ_EVENT_DATA 0x00770005
31 #define SCLP_CMD_WRITE_EVENT_DATA 0x00760005
32 #define SCLP_CMD_WRITE_EVENT_MASK 0x00780005
33
34 /* SCLP Memory hotplug codes */
35 #define SCLP_FC_ASSIGN_ATTACH_READ_STOR 0xE00000000000ULL
36 #define SCLP_STARTING_SUBINCREMENT_ID 0x10001
37 #define SCLP_INCREMENT_UNIT 0x10000
38 #define MAX_STORAGE_INCREMENTS 1020
39
40 /* CPU hotplug SCLP codes */
41 #define SCLP_HAS_CPU_INFO 0x0800000000000000ULL
42 #define SCLP_CMDW_READ_CPU_INFO 0x00010001
43
44 /* SCLP PCI codes */
45 #define SCLP_HAS_IOA_RECONFIG 0x0000000040000000ULL
46 #define SCLP_CMDW_CONFIGURE_IOA 0x001a0001
47 #define SCLP_CMDW_DECONFIGURE_IOA 0x001b0001
48 #define SCLP_RECONFIG_PCI_ATYPE 2
49
50 /* SCLP response codes */
51 #define SCLP_RC_NORMAL_READ_COMPLETION 0x0010
52 #define SCLP_RC_NORMAL_COMPLETION 0x0020
53 #define SCLP_RC_SCCB_BOUNDARY_VIOLATION 0x0100
54 #define SCLP_RC_NO_ACTION_REQUIRED 0x0120
55 #define SCLP_RC_INVALID_SCLP_COMMAND 0x01f0
56 #define SCLP_RC_CONTAINED_EQUIPMENT_CHECK 0x0340
57 #define SCLP_RC_INSUFFICIENT_SCCB_LENGTH 0x0300
58 #define SCLP_RC_STANDBY_READ_COMPLETION 0x0410
59 #define SCLP_RC_ADAPTER_IN_RESERVED_STATE 0x05f0
60 #define SCLP_RC_ADAPTER_TYPE_NOT_RECOGNIZED 0x06f0
61 #define SCLP_RC_ADAPTER_ID_NOT_RECOGNIZED 0x09f0
62 #define SCLP_RC_INVALID_FUNCTION 0x40f0
63 #define SCLP_RC_NO_EVENT_BUFFERS_STORED 0x60f0
64 #define SCLP_RC_INVALID_SELECTION_MASK 0x70f0
65 #define SCLP_RC_INCONSISTENT_LENGTHS 0x72f0
66 #define SCLP_RC_EVENT_BUFFER_SYNTAX_ERROR 0x73f0
67 #define SCLP_RC_INVALID_MASK_LENGTH 0x74f0
68
69
70 /* Service Call Control Block (SCCB) and its elements */
71
72 #define SCCB_SIZE 4096
73
74 #define SCLP_VARIABLE_LENGTH_RESPONSE 0x80
75 #define SCLP_EVENT_BUFFER_ACCEPTED 0x80
76
77 #define SCLP_FC_NORMAL_WRITE 0
78
79 /*
80 * Normally packed structures are not the right thing to do, since all code
81 * must take care of endianness. We cannot use ldl_phys and friends for two
82 * reasons, though:
83 * - some of the embedded structures below the SCCB can appear multiple times
84 * at different locations, so there is no fixed offset
85 * - we work on a private copy of the SCCB, since there are several length
86 * fields, that would cause a security nightmare if we allow the guest to
87 * alter the structure while we parse it. We cannot use ldl_p and friends
88 * either without doing pointer arithmetic
89 * So we have to double check that all users of sclp data structures use the
90 * right endianness wrappers.
91 */
92 typedef struct SCCBHeader {
93 uint16_t length;
94 uint8_t function_code;
95 uint8_t control_mask[3];
96 uint16_t response_code;
97 } QEMU_PACKED SCCBHeader;
98
99 #define SCCB_DATA_LEN (SCCB_SIZE - sizeof(SCCBHeader))
100 #define SCCB_CPU_FEATURE_LEN 6
101
102 /* CPU information */
103 typedef struct CPUEntry {
104 uint8_t address;
105 uint8_t reserved0;
106 uint8_t features[SCCB_CPU_FEATURE_LEN];
107 uint8_t reserved2[6];
108 uint8_t type;
109 uint8_t reserved1;
110 } QEMU_PACKED CPUEntry;
111
112 #define SCLP_READ_SCP_INFO_FIXED_CPU_OFFSET 128
113 #define SCLP_READ_SCP_INFO_MNEST 4
114 typedef struct ReadInfo {
115 SCCBHeader h;
116 uint16_t rnmax;
117 uint8_t rnsize;
118 uint8_t _reserved1[15 - 11]; /* 11-14 */
119 uint8_t stsi_parm; /* 15-15 */
120 uint16_t entries_cpu; /* 16-17 */
121 uint16_t offset_cpu; /* 18-19 */
122 uint8_t _reserved2[24 - 20]; /* 20-23 */
123 uint8_t loadparm[8]; /* 24-31 */
124 uint8_t _reserved3[48 - 32]; /* 32-47 */
125 uint64_t facilities; /* 48-55 */
126 uint8_t _reserved0[76 - 56]; /* 56-75 */
127 uint32_t ibc_val;
128 uint8_t conf_char[99 - 80]; /* 80-98 */
129 uint8_t mha_pow;
130 uint32_t rnsize2;
131 uint64_t rnmax2;
132 uint8_t _reserved6[116 - 112]; /* 112-115 */
133 uint8_t conf_char_ext[120 - 116]; /* 116-119 */
134 uint16_t highest_cpu;
135 uint8_t _reserved5[124 - 122]; /* 122-123 */
136 uint32_t hmfai;
137 uint8_t _reserved7[134 - 128]; /* 128-133 */
138 uint8_t fac134;
139 uint8_t _reserved8;
140 uint8_t fac_ipl[2]; /* 136-137 */
141 uint8_t _reserved9;
142 uint8_t fac139;
143 uint8_t _reserved10[144 - 140]; /* 140-143 */
144 struct CPUEntry entries[];
145 /*
146 * When the Extended-Length SCCB (ELS) feature is enabled the
147 * start of the entries field begins at an offset denoted by the
148 * offset_cpu field, otherwise it's at an offset of 128.
149 */
150 } QEMU_PACKED ReadInfo;
151
152 typedef struct ReadCpuInfo {
153 SCCBHeader h;
154 uint16_t nr_configured; /* 8-9 */
155 uint16_t offset_configured; /* 10-11 */
156 uint16_t nr_standby; /* 12-13 */
157 uint16_t offset_standby; /* 14-15 */
158 uint8_t reserved0[24-16]; /* 16-23 */
159 struct CPUEntry entries[];
160 } QEMU_PACKED ReadCpuInfo;
161
162 typedef struct ReadStorageElementInfo {
163 SCCBHeader h;
164 uint16_t max_id;
165 uint16_t assigned;
166 uint16_t standby;
167 uint8_t _reserved0[16 - 14]; /* 14-15 */
168 uint32_t entries[];
169 } QEMU_PACKED ReadStorageElementInfo;
170
171 typedef struct AttachStorageElement {
172 SCCBHeader h;
173 uint8_t _reserved0[10 - 8]; /* 8-9 */
174 uint16_t assigned;
175 uint8_t _reserved1[16 - 12]; /* 12-15 */
176 uint32_t entries[];
177 } QEMU_PACKED AttachStorageElement;
178
179 typedef struct AssignStorage {
180 SCCBHeader h;
181 uint16_t rn;
182 } QEMU_PACKED AssignStorage;
183
184 typedef struct IoaCfgSccb {
185 SCCBHeader header;
186 uint8_t atype;
187 uint8_t reserved1;
188 uint16_t reserved2;
189 uint32_t aid;
190 } QEMU_PACKED IoaCfgSccb;
191
192 typedef struct SCCB {
193 SCCBHeader h;
194 char data[];
195 } QEMU_PACKED SCCB;
196
197 #define TYPE_SCLP "sclp"
198 OBJECT_DECLARE_TYPE(SCLPDevice, SCLPDeviceClass,
199 SCLP)
200
201 struct SCLPEventFacility;
202
203 struct SCLPDevice {
204 DeviceState parent_obj;
205
206 struct SCLPEventFacility *event_facility;
207 };
208
209 struct SCLPDeviceClass {
210 /* private */
211 DeviceClass parent_class;
212 void (*read_SCP_info)(SCLPDevice *sclp, SCCB *sccb);
213 void (*read_cpu_info)(SCLPDevice *sclp, SCCB *sccb);
214
215 /* public */
216 void (*execute)(SCLPDevice *sclp, SCCB *sccb, uint32_t code);
217 void (*service_interrupt)(SCLPDevice *sclp, uint32_t sccb);
218 };
219
220 static inline int sccb_data_len(SCCB *sccb)
221 {
222 return be16_to_cpu(sccb->h.length) - sizeof(sccb->h);
223 }
224
225 void sclp_service_interrupt(uint32_t sccb);
226 void raise_irq_cpu_hotplug(void);
227 int sclp_service_call(S390CPU *cpu, uint64_t sccb, uint32_t code);
228 int sclp_service_call_protected(S390CPU *cpu, uint64_t sccb, uint32_t code);
229
230 #endif