2 * Channel subsystem structures and definitions.
4 * Copyright 2012 IBM Corp.
5 * Author(s): Cornelia Huck <cornelia.huck@de.ibm.com>
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
16 #include "hw/s390x/adapter.h"
17 #include "hw/s390x/s390_flic.h"
18 #include "hw/s390x/ioinst.h"
19 #include "sysemu/kvm.h"
21 /* Channel subsystem constants. */
22 #define MAX_DEVNO 65535
23 #define MAX_SCHID 65535
32 #define VIRTUAL_CSSID 0xfe
33 #define VIRTIO_CCW_CHPID 0 /* used by convention */
41 typedef struct SenseId
{
43 uint8_t reserved
; /* always 0x'FF' */
44 uint16_t cu_type
; /* control unit type */
45 uint8_t cu_model
; /* control unit model */
46 uint16_t dev_type
; /* device type */
47 uint8_t dev_model
; /* device model */
48 uint8_t unused
; /* padding byte */
50 CIW ciw
[MAX_CIWS
]; /* variable # of CIWs */
51 } QEMU_PACKED SenseId
;
53 /* Channel measurements, from linux/drivers/s390/cio/cmf.c. */
55 uint16_t ssch_rsch_count
;
56 uint16_t sample_count
;
57 uint32_t device_connect_time
;
58 uint32_t function_pending_time
;
59 uint32_t device_disconnect_time
;
60 uint32_t control_unit_queuing_time
;
61 uint32_t device_active_only_time
;
66 uint32_t ssch_rsch_count
;
67 uint32_t sample_count
;
68 uint32_t device_connect_time
;
69 uint32_t function_pending_time
;
70 uint32_t device_disconnect_time
;
71 uint32_t control_unit_queuing_time
;
72 uint32_t device_active_only_time
;
73 uint32_t device_busy_time
;
74 uint32_t initial_command_response_time
;
78 typedef enum CcwDataStreamOp
{
79 CDS_OP_R
= 0, /* read, false when used as is_write */
80 CDS_OP_W
= 1, /* write, true when used as is_write */
81 CDS_OP_A
= 2 /* advance, should not be used as is_write */
84 /* normal usage is via SuchchDev.cds instead of instantiating */
85 typedef struct CcwDataStream
{
86 #define CDS_F_IDA 0x01
87 #define CDS_F_MIDA 0x02
88 #define CDS_F_I2K 0x04
89 #define CDS_F_C64 0x08
90 #define CDS_F_FMT 0x10 /* CCW format-1 */
91 #define CDS_F_STREAM_BROKEN 0x80
97 int (*op_handler
)(struct CcwDataStream
*cds
, void *buff
, int len
,
103 * IO instructions conclude according to this. Currently we have only
104 * cc codes. Valid values are 0, 1, 2, 3 and the generic semantic for
105 * IO instructions is described briefly. For more details consult the PoP.
107 typedef enum IOInstEnding
{
108 /* produced expected result */
109 IOINST_CC_EXPECTED
= 0,
110 /* status conditions were present or produced alternate result */
111 IOINST_CC_STATUS_PRESENT
= 1,
112 /* inst. ineffective because busy with previously initiated function */
114 /* inst. ineffective because not operational */
115 IOINST_CC_NOT_OPERATIONAL
= 3
118 typedef struct SubchDev SubchDev
;
120 /* channel-subsystem related things: */
126 uint8_t sense_data
[32];
132 uint8_t ccw_no_data_cnt
;
133 uint16_t migrated_schid
; /* used for missmatch detection */
136 /* transport-provided data: */
137 int (*ccw_cb
) (SubchDev
*, CCW1
);
138 void (*disable_cb
)(SubchDev
*);
139 IOInstEnding (*do_subchannel_work
) (SubchDev
*);
144 static inline void sch_gen_unit_exception(SubchDev
*sch
)
146 sch
->curr_status
.scsw
.ctrl
&= ~SCSW_ACTL_START_PEND
;
147 sch
->curr_status
.scsw
.ctrl
|= SCSW_STCTL_PRIMARY
|
148 SCSW_STCTL_SECONDARY
|
150 SCSW_STCTL_STATUS_PEND
;
151 sch
->curr_status
.scsw
.cpa
= sch
->channel_prog
+ 8;
152 sch
->curr_status
.scsw
.dstat
= SCSW_DSTAT_UNIT_EXCEP
;
155 extern const VMStateDescription vmstate_subch_dev
;
158 * Identify a device within the channel subsystem.
159 * Note that this can be used to identify either the subchannel or
160 * the attached I/O device, as there's always one I/O device per
163 typedef struct CssDevId
{
170 extern const PropertyInfo css_devid_propinfo
;
172 #define DEFINE_PROP_CSS_DEV_ID(_n, _s, _f) \
173 DEFINE_PROP(_n, _s, _f, css_devid_propinfo, CssDevId)
175 typedef struct IndAddr
{
178 unsigned long refcnt
;
180 QTAILQ_ENTRY(IndAddr
) sibling
;
183 extern const VMStateDescription vmstate_ind_addr
;
185 #define VMSTATE_PTR_TO_IND_ADDR(_f, _s) \
186 VMSTATE_STRUCT(_f, _s, 1, vmstate_ind_addr, IndAddr*)
188 IndAddr
*get_indicator(hwaddr ind_addr
, int len
);
189 void release_indicator(AdapterInfo
*adapter
, IndAddr
*indicator
);
190 int map_indicator(AdapterInfo
*adapter
, IndAddr
*indicator
);
192 typedef SubchDev
*(*css_subch_cb_func
)(uint8_t m
, uint8_t cssid
, uint8_t ssid
,
194 int css_create_css_image(uint8_t cssid
, bool default_image
);
195 bool css_devno_used(uint8_t cssid
, uint8_t ssid
, uint16_t devno
);
196 void css_subch_assign(uint8_t cssid
, uint8_t ssid
, uint16_t schid
,
197 uint16_t devno
, SubchDev
*sch
);
198 void css_sch_build_virtual_schib(SubchDev
*sch
, uint8_t chpid
, uint8_t type
);
199 int css_sch_build_schib(SubchDev
*sch
, CssDevId
*dev_id
);
200 unsigned int css_find_free_chpid(uint8_t cssid
);
201 uint16_t css_build_subchannel_id(SubchDev
*sch
);
202 void copy_scsw_to_guest(SCSW
*dest
, const SCSW
*src
);
203 void css_inject_io_interrupt(SubchDev
*sch
);
204 void css_reset(void);
205 void css_reset_sch(SubchDev
*sch
);
206 void css_queue_crw(uint8_t rsc
, uint8_t erc
, int solicited
,
207 int chain
, uint16_t rsid
);
208 void css_generate_sch_crws(uint8_t cssid
, uint8_t ssid
, uint16_t schid
,
209 int hotplugged
, int add
);
210 void css_generate_chp_crws(uint8_t cssid
, uint8_t chpid
);
211 void css_generate_css_crws(uint8_t cssid
);
212 void css_clear_sei_pending(void);
213 IOInstEnding
s390_ccw_cmd_request(SubchDev
*sch
);
214 IOInstEnding
do_subchannel_work_virtual(SubchDev
*sub
);
215 IOInstEnding
do_subchannel_work_passthrough(SubchDev
*sub
);
218 CSS_IO_ADAPTER_VIRTIO
= 0,
219 CSS_IO_ADAPTER_PCI
= 1,
220 CSS_IO_ADAPTER_TYPE_NUMS
,
223 void css_adapter_interrupt(CssIoAdapterType type
, uint8_t isc
);
224 int css_do_sic(CPUS390XState
*env
, uint8_t isc
, uint16_t mode
);
225 uint32_t css_get_adapter_id(CssIoAdapterType type
, uint8_t isc
);
226 void css_register_io_adapters(CssIoAdapterType type
, bool swap
, bool maskable
,
227 uint8_t flags
, Error
**errp
);
230 #define S390_ADAPTER_SUPPRESSIBLE 0x01
232 #define S390_ADAPTER_SUPPRESSIBLE KVM_S390_ADAPTER_SUPPRESSIBLE
235 #ifndef CONFIG_USER_ONLY
236 SubchDev
*css_find_subch(uint8_t m
, uint8_t cssid
, uint8_t ssid
,
238 bool css_subch_visible(SubchDev
*sch
);
239 void css_conditional_io_interrupt(SubchDev
*sch
);
240 int css_do_stsch(SubchDev
*sch
, SCHIB
*schib
);
241 bool css_schid_final(int m
, uint8_t cssid
, uint8_t ssid
, uint16_t schid
);
242 IOInstEnding
css_do_msch(SubchDev
*sch
, const SCHIB
*schib
);
243 IOInstEnding
css_do_xsch(SubchDev
*sch
);
244 IOInstEnding
css_do_csch(SubchDev
*sch
);
245 IOInstEnding
css_do_hsch(SubchDev
*sch
);
246 IOInstEnding
css_do_ssch(SubchDev
*sch
, ORB
*orb
);
247 int css_do_tsch_get_irb(SubchDev
*sch
, IRB
*irb
, int *irb_len
);
248 void css_do_tsch_update_subch(SubchDev
*sch
);
249 int css_do_stcrw(CRW
*crw
);
250 void css_undo_stcrw(CRW
*crw
);
251 int css_collect_chp_desc(int m
, uint8_t cssid
, uint8_t f_chpid
, uint8_t l_chpid
,
252 int rfmt
, void *buf
);
253 void css_do_schm(uint8_t mbk
, int update
, int dct
, uint64_t mbo
);
254 int css_enable_mcsse(void);
255 int css_enable_mss(void);
256 IOInstEnding
css_do_rsch(SubchDev
*sch
);
257 int css_do_rchp(uint8_t cssid
, uint8_t chpid
);
258 bool css_present(uint8_t cssid
);
261 extern const PropertyInfo css_devid_ro_propinfo
;
263 #define DEFINE_PROP_CSS_DEV_ID_RO(_n, _s, _f) \
264 DEFINE_PROP(_n, _s, _f, css_devid_ro_propinfo, CssDevId)
267 * Create a subchannel for the given bus id.
269 * If @p bus_id is valid, verify that it is not already in use, and find a
271 * If @p bus_id is not valid find a free subchannel id and device number
272 * across all subchannel sets and all css images starting from the default
275 * If either of the former actions succeed, allocate a subchannel structure,
276 * initialise it with the bus id, subchannel id and device number, register
277 * it with the CSS and return it. Otherwise return NULL.
279 * The caller becomes owner of the returned subchannel structure and
280 * is responsible for unregistering and freeing it.
282 SubchDev
*css_create_sch(CssDevId bus_id
, Error
**errp
);
284 /** Turn on css migration */
285 void css_register_vmstate(void);
288 void ccw_dstream_init(CcwDataStream
*cds
, CCW1
const *ccw
, ORB
const *orb
);
290 static inline void ccw_dstream_rewind(CcwDataStream
*cds
)
294 cds
->cda
= cds
->cda_orig
;
297 static inline bool ccw_dstream_good(CcwDataStream
*cds
)
299 return !(cds
->flags
& CDS_F_STREAM_BROKEN
);
302 static inline uint16_t ccw_dstream_residual_count(CcwDataStream
*cds
)
304 return cds
->count
- cds
->at_byte
;
307 static inline uint16_t ccw_dstream_avail(CcwDataStream
*cds
)
309 return ccw_dstream_good(cds
) ? ccw_dstream_residual_count(cds
) : 0;
312 static inline int ccw_dstream_advance(CcwDataStream
*cds
, int len
)
314 return cds
->op_handler(cds
, NULL
, len
, CDS_OP_A
);
317 static inline int ccw_dstream_write_buf(CcwDataStream
*cds
, void *buff
, int len
)
319 return cds
->op_handler(cds
, buff
, len
, CDS_OP_W
);
322 static inline int ccw_dstream_read_buf(CcwDataStream
*cds
, void *buff
, int len
)
324 return cds
->op_handler(cds
, buff
, len
, CDS_OP_R
);
327 #define ccw_dstream_read(cds, v) ccw_dstream_read_buf((cds), &(v), sizeof(v))
328 #define ccw_dstream_write(cds, v) ccw_dstream_write_buf((cds), &(v), sizeof(v))