1/*
2 * Channel subsystem structures and definitions.
3 *
4 * Copyright 2012 IBM Corp.
5 * Author(s): Cornelia Huck <cornelia.huck@de.ibm.com>
6 *
7 * This work is licensed under the terms of the GNU GPL, version 2 or (at
8 * your option) any later version. See the COPYING file in the top-level
9 * directory.
10 */
11
12#ifndef CSS_H
13#define CSS_H
14
15#include "cpu.h"
16#include "hw/s390x/adapter.h"
17#include "hw/s390x/s390_flic.h"
18#include "hw/s390x/ioinst.h"
19#include "sysemu/kvm.h"
20#include "target/s390x/cpu-qom.h"
21
22/* Channel subsystem constants. */
23#define MAX_DEVNO 65535
24#define MAX_SCHID 65535
25#define MAX_SSID 3
26#define MAX_CSSID 255
27#define MAX_CHPID 255
28
29#define MAX_ISC 7
30
31#define MAX_CIWS 62
32
33#define VIRTUAL_CSSID 0xfe
34#define VIRTIO_CCW_CHPID 0 /* used by convention */
35
36typedef struct CIW {
37 uint8_t type;
38 uint8_t command;
39 uint16_t count;
40} QEMU_PACKED CIW;
41
42typedef struct SenseId {
43 /* common part */
44 uint8_t reserved; /* always 0x'FF' */
45 uint16_t cu_type; /* control unit type */
46 uint8_t cu_model; /* control unit model */
47 uint16_t dev_type; /* device type */
48 uint8_t dev_model; /* device model */
49 uint8_t unused; /* padding byte */
50 /* extended part */
51 CIW ciw[MAX_CIWS]; /* variable # of CIWs */
52} SenseId; /* Note: No QEMU_PACKED due to unaligned members */
53
54/* Channel measurements, from linux/drivers/s390/cio/cmf.c. */
55typedef struct CMB {
56 uint16_t ssch_rsch_count;
57 uint16_t sample_count;
58 uint32_t device_connect_time;
59 uint32_t function_pending_time;
60 uint32_t device_disconnect_time;
61 uint32_t control_unit_queuing_time;
62 uint32_t device_active_only_time;
63 uint32_t reserved[2];
64} QEMU_PACKED CMB;
65
66typedef struct CMBE {
67 uint32_t ssch_rsch_count;
68 uint32_t sample_count;
69 uint32_t device_connect_time;
70 uint32_t function_pending_time;
71 uint32_t device_disconnect_time;
72 uint32_t control_unit_queuing_time;
73 uint32_t device_active_only_time;
74 uint32_t device_busy_time;
75 uint32_t initial_command_response_time;
76 uint32_t reserved[7];
77} QEMU_PACKED CMBE;
78
79typedef enum CcwDataStreamOp {
80 CDS_OP_R = 0, /* read, false when used as is_write */
81 CDS_OP_W = 1, /* write, true when used as is_write */
82 CDS_OP_A = 2 /* advance, should not be used as is_write */
83} CcwDataStreamOp;
84
85/* normal usage is via SuchchDev.cds instead of instantiating */
86typedef struct CcwDataStream {
87#define CDS_F_IDA 0x01
88#define CDS_F_MIDA 0x02
89#define CDS_F_I2K 0x04
90#define CDS_F_C64 0x08
91#define CDS_F_FMT 0x10 /* CCW format-1 */
92#define CDS_F_STREAM_BROKEN 0x80
93 uint8_t flags;
94 uint8_t at_idaw;
95 uint16_t at_byte;
96 uint16_t count;
97 uint32_t cda_orig;
98 int (*op_handler)(struct CcwDataStream *cds, void *buff, int len,
99 CcwDataStreamOp op);
100 hwaddr cda;
101 bool do_skip;
102} CcwDataStream;
103
104/*
105 * IO instructions conclude according to this. Currently we have only
106 * cc codes. Valid values are 0, 1, 2, 3 and the generic semantic for
107 * IO instructions is described briefly. For more details consult the PoP.
108 */
109typedef enum IOInstEnding {
110 /* produced expected result */
111 IOINST_CC_EXPECTED = 0,
112 /* status conditions were present or produced alternate result */
113 IOINST_CC_STATUS_PRESENT = 1,
114 /* inst. ineffective because busy with previously initiated function */
115 IOINST_CC_BUSY = 2,
116 /* inst. ineffective because not operational */
117 IOINST_CC_NOT_OPERATIONAL = 3
118} IOInstEnding;
119
120typedef struct SubchDev SubchDev;
121struct SubchDev {
122 /* channel-subsystem related things: */
123 SCHIB curr_status; /* Needs alignment and thus must come first */
124 ORB orb;
125 uint8_t cssid;
126 uint8_t ssid;
127 uint16_t schid;
128 uint16_t devno;
129 uint8_t sense_data[32];
130 hwaddr channel_prog;
131 CCW1 last_cmd;
132 bool last_cmd_valid;
133 bool ccw_fmt_1;
134 bool thinint_active;
135 uint8_t ccw_no_data_cnt;
136 uint16_t migrated_schid; /* used for missmatch detection */
137 CcwDataStream cds;
138 /* transport-provided data: */
139 int (*ccw_cb) (SubchDev *, CCW1);
140 void (*disable_cb)(SubchDev *);
141 IOInstEnding (*do_subchannel_work) (SubchDev *);
142 SenseId id;
143 void *driver_data;
144};
145
146static inline void sch_gen_unit_exception(SubchDev *sch)
147{
148 sch->curr_status.scsw.ctrl &= ~SCSW_ACTL_START_PEND;
149 sch->curr_status.scsw.ctrl |= SCSW_STCTL_PRIMARY |
150 SCSW_STCTL_SECONDARY |
151 SCSW_STCTL_ALERT |
152 SCSW_STCTL_STATUS_PEND;
153 sch->curr_status.scsw.cpa = sch->channel_prog + 8;
154 sch->curr_status.scsw.dstat = SCSW_DSTAT_UNIT_EXCEP;
155}
156
157extern const VMStateDescription vmstate_subch_dev;
158
159/*
160 * Identify a device within the channel subsystem.
161 * Note that this can be used to identify either the subchannel or
162 * the attached I/O device, as there's always one I/O device per
163 * subchannel.
164 */
165typedef struct CssDevId {
166 uint8_t cssid;
167 uint8_t ssid;
168 uint16_t devid;
169 bool valid;
170} CssDevId;
171
172extern const PropertyInfo css_devid_propinfo;
173
174#define DEFINE_PROP_CSS_DEV_ID(_n, _s, _f) \
175 DEFINE_PROP(_n, _s, _f, css_devid_propinfo, CssDevId)
176
177typedef struct IndAddr {
178 hwaddr addr;
179 uint64_t map;
180 unsigned long refcnt;
181 int32_t len;
182 QTAILQ_ENTRY(IndAddr) sibling;
183} IndAddr;
184
185extern const VMStateDescription vmstate_ind_addr;
186
187#define VMSTATE_PTR_TO_IND_ADDR(_f, _s) \
188 VMSTATE_STRUCT(_f, _s, 1, vmstate_ind_addr, IndAddr*)
189
190IndAddr *get_indicator(hwaddr ind_addr, int len);
191void release_indicator(AdapterInfo *adapter, IndAddr *indicator);
192int map_indicator(AdapterInfo *adapter, IndAddr *indicator);
193
194typedef SubchDev *(*css_subch_cb_func)(uint8_t m, uint8_t cssid, uint8_t ssid,
195 uint16_t schid);
196int css_create_css_image(uint8_t cssid, bool default_image);
197bool css_devno_used(uint8_t cssid, uint8_t ssid, uint16_t devno);
198void css_subch_assign(uint8_t cssid, uint8_t ssid, uint16_t schid,
199 uint16_t devno, SubchDev *sch);
200void css_sch_build_virtual_schib(SubchDev *sch, uint8_t chpid, uint8_t type);
201int css_sch_build_schib(SubchDev *sch, CssDevId *dev_id);
202unsigned int css_find_free_chpid(uint8_t cssid);
203uint16_t css_build_subchannel_id(SubchDev *sch);
204void copy_scsw_to_guest(SCSW *dest, const SCSW *src);
205void css_inject_io_interrupt(SubchDev *sch);
206void css_reset(void);
207void css_reset_sch(SubchDev *sch);
208void css_queue_crw(uint8_t rsc, uint8_t erc, int solicited,
209 int chain, uint16_t rsid);
210void css_generate_sch_crws(uint8_t cssid, uint8_t ssid, uint16_t schid,
211 int hotplugged, int add);
212void css_generate_chp_crws(uint8_t cssid, uint8_t chpid);
213void css_generate_css_crws(uint8_t cssid);
214void css_clear_sei_pending(void);
215IOInstEnding s390_ccw_cmd_request(SubchDev *sch);
216IOInstEnding do_subchannel_work_virtual(SubchDev *sub);
217IOInstEnding do_subchannel_work_passthrough(SubchDev *sub);
218
219int s390_ccw_halt(SubchDev *sch);
220int s390_ccw_clear(SubchDev *sch);
221
222typedef enum {
223 CSS_IO_ADAPTER_VIRTIO = 0,
224 CSS_IO_ADAPTER_PCI = 1,
225 CSS_IO_ADAPTER_TYPE_NUMS,
226} CssIoAdapterType;
227
228void css_adapter_interrupt(CssIoAdapterType type, uint8_t isc);
229int css_do_sic(CPUS390XState *env, uint8_t isc, uint16_t mode);
230uint32_t css_get_adapter_id(CssIoAdapterType type, uint8_t isc);
231void css_register_io_adapters(CssIoAdapterType type, bool swap, bool maskable,
232 uint8_t flags, Error **errp);
233
234#ifndef CONFIG_KVM
235#define S390_ADAPTER_SUPPRESSIBLE 0x01
236#else
237#define S390_ADAPTER_SUPPRESSIBLE KVM_S390_ADAPTER_SUPPRESSIBLE
238#endif
239
240#ifndef CONFIG_USER_ONLY
241SubchDev *css_find_subch(uint8_t m, uint8_t cssid, uint8_t ssid,
242 uint16_t schid);
243bool css_subch_visible(SubchDev *sch);
244void css_conditional_io_interrupt(SubchDev *sch);
245int css_do_stsch(SubchDev *sch, SCHIB *schib);
246bool css_schid_final(int m, uint8_t cssid, uint8_t ssid, uint16_t schid);
247IOInstEnding css_do_msch(SubchDev *sch, const SCHIB *schib);
248IOInstEnding css_do_xsch(SubchDev *sch);
249IOInstEnding css_do_csch(SubchDev *sch);
250IOInstEnding css_do_hsch(SubchDev *sch);
251IOInstEnding css_do_ssch(SubchDev *sch, ORB *orb);
252int css_do_tsch_get_irb(SubchDev *sch, IRB *irb, int *irb_len);
253void css_do_tsch_update_subch(SubchDev *sch);
254int css_do_stcrw(CRW *crw);
255void css_undo_stcrw(CRW *crw);
256int css_collect_chp_desc(int m, uint8_t cssid, uint8_t f_chpid, uint8_t l_chpid,
257 int rfmt, void *buf);
258void css_do_schm(uint8_t mbk, int update, int dct, uint64_t mbo);
259int css_enable_mcsse(void);
260int css_enable_mss(void);
261IOInstEnding css_do_rsch(SubchDev *sch);
262int css_do_rchp(uint8_t cssid, uint8_t chpid);
263bool css_present(uint8_t cssid);
264#endif
265
266extern const PropertyInfo css_devid_ro_propinfo;
267
268#define DEFINE_PROP_CSS_DEV_ID_RO(_n, _s, _f) \
269 DEFINE_PROP(_n, _s, _f, css_devid_ro_propinfo, CssDevId)
270
271/**
272 * Create a subchannel for the given bus id.
273 *
274 * If @p bus_id is valid, verify that it is not already in use, and find a
275 * free devno for it.
276 * If @p bus_id is not valid find a free subchannel id and device number
277 * across all subchannel sets and all css images starting from the default
278 * css image.
279 *
280 * If either of the former actions succeed, allocate a subchannel structure,
281 * initialise it with the bus id, subchannel id and device number, register
282 * it with the CSS and return it. Otherwise return NULL.
283 *
284 * The caller becomes owner of the returned subchannel structure and
285 * is responsible for unregistering and freeing it.
286 */
287SubchDev *css_create_sch(CssDevId bus_id, Error **errp);
288
289/** Turn on css migration */
290void css_register_vmstate(void);
291
292
293void ccw_dstream_init(CcwDataStream *cds, CCW1 const *ccw, ORB const *orb);
294
295static inline void ccw_dstream_rewind(CcwDataStream *cds)
296{
297 cds->at_byte = 0;
298 cds->at_idaw = 0;
299 cds->cda = cds->cda_orig;
300}
301
302static inline bool ccw_dstream_good(CcwDataStream *cds)
303{
304 return !(cds->flags & CDS_F_STREAM_BROKEN);
305}
306
307static inline uint16_t ccw_dstream_residual_count(CcwDataStream *cds)
308{
309 return cds->count - cds->at_byte;
310}
311
312static inline uint16_t ccw_dstream_avail(CcwDataStream *cds)
313{
314 return ccw_dstream_good(cds) ? ccw_dstream_residual_count(cds) : 0;
315}
316
317static inline int ccw_dstream_advance(CcwDataStream *cds, int len)
318{
319 return cds->op_handler(cds, NULL, len, CDS_OP_A);
320}
321
322static inline int ccw_dstream_write_buf(CcwDataStream *cds, void *buff, int len)
323{
324 return cds->op_handler(cds, buff, len, CDS_OP_W);
325}
326
327static inline int ccw_dstream_read_buf(CcwDataStream *cds, void *buff, int len)
328{
329 return cds->op_handler(cds, buff, len, CDS_OP_R);
330}
331
332#define ccw_dstream_read(cds, v) ccw_dstream_read_buf((cds), &(v), sizeof(v))
333#define ccw_dstream_write(cds, v) ccw_dstream_write_buf((cds), &(v), sizeof(v))
334
335#endif
336