xref: /openbmc/linux/drivers/s390/cio/css.h (revision 643d1f7f)
1 #ifndef _CSS_H
2 #define _CSS_H
3 
4 #include <linux/mutex.h>
5 #include <linux/wait.h>
6 #include <linux/workqueue.h>
7 #include <linux/device.h>
8 #include <linux/types.h>
9 
10 #include <asm/cio.h>
11 #include <asm/chpid.h>
12 
13 #include "schid.h"
14 
15 /*
16  * path grouping stuff
17  */
18 #define SPID_FUNC_SINGLE_PATH	   0x00
19 #define SPID_FUNC_MULTI_PATH	   0x80
20 #define SPID_FUNC_ESTABLISH	   0x00
21 #define SPID_FUNC_RESIGN	   0x40
22 #define SPID_FUNC_DISBAND	   0x20
23 
24 #define SNID_STATE1_RESET	   0
25 #define SNID_STATE1_UNGROUPED	   2
26 #define SNID_STATE1_GROUPED	   3
27 
28 #define SNID_STATE2_NOT_RESVD	   0
29 #define SNID_STATE2_RESVD_ELSE	   2
30 #define SNID_STATE2_RESVD_SELF	   3
31 
32 #define SNID_STATE3_MULTI_PATH	   1
33 #define SNID_STATE3_SINGLE_PATH	   0
34 
35 struct path_state {
36 	__u8  state1 : 2;	/* path state value 1 */
37 	__u8  state2 : 2;	/* path state value 2 */
38 	__u8  state3 : 1;	/* path state value 3 */
39 	__u8  resvd  : 3;	/* reserved */
40 } __attribute__ ((packed));
41 
42 struct extended_cssid {
43 	u8 version;
44 	u8 cssid;
45 } __attribute__ ((packed));
46 
47 struct pgid {
48 	union {
49 		__u8 fc;   	/* SPID function code */
50 		struct path_state ps;	/* SNID path state */
51 	} __attribute__ ((packed)) inf;
52 	union {
53 		__u32 cpu_addr	: 16;	/* CPU address */
54 		struct extended_cssid ext_cssid;
55 	} __attribute__ ((packed)) pgid_high;
56 	__u32 cpu_id	: 24;	/* CPU identification */
57 	__u32 cpu_model : 16;	/* CPU model */
58 	__u32 tod_high;		/* high word TOD clock */
59 } __attribute__ ((packed));
60 
61 /*
62  * A css driver handles all subchannels of one type.
63  * Currently, we only care about I/O subchannels (type 0), these
64  * have a ccw_device connected to them.
65  */
66 struct subchannel;
67 struct css_driver {
68 	struct module *owner;
69 	unsigned int subchannel_type;
70 	struct device_driver drv;
71 	void (*irq)(struct subchannel *);
72 	int (*notify)(struct subchannel *, int);
73 	void (*verify)(struct subchannel *);
74 	void (*termination)(struct subchannel *);
75 	int (*probe)(struct subchannel *);
76 	int (*remove)(struct subchannel *);
77 	void (*shutdown)(struct subchannel *);
78 	const char *name;
79 };
80 
81 #define to_cssdriver(n) container_of(n, struct css_driver, drv)
82 
83 /*
84  * all css_drivers have the css_bus_type
85  */
86 extern struct bus_type css_bus_type;
87 
88 extern int css_driver_register(struct css_driver *);
89 extern void css_driver_unregister(struct css_driver *);
90 
91 extern void css_sch_device_unregister(struct subchannel *);
92 extern struct subchannel * get_subchannel_by_schid(struct subchannel_id);
93 extern int css_init_done;
94 int for_each_subchannel_staged(int (*fn_known)(struct subchannel *, void *),
95 			       int (*fn_unknown)(struct subchannel_id,
96 			       void *), void *data);
97 extern int for_each_subchannel(int(*fn)(struct subchannel_id, void *), void *);
98 extern void css_process_crw(int, int);
99 extern void css_reiterate_subchannels(void);
100 void css_update_ssd_info(struct subchannel *sch);
101 
102 #define __MAX_SUBCHANNEL 65535
103 #define __MAX_SSID 3
104 
105 struct channel_subsystem {
106 	u8 cssid;
107 	int valid;
108 	struct channel_path *chps[__MAX_CHPID + 1];
109 	struct device device;
110 	struct pgid global_pgid;
111 	struct mutex mutex;
112 	/* channel measurement related */
113 	int cm_enabled;
114 	void *cub_addr1;
115 	void *cub_addr2;
116 	/* for orphaned ccw devices */
117 	struct subchannel *pseudo_subchannel;
118 };
119 #define to_css(dev) container_of(dev, struct channel_subsystem, device)
120 
121 extern struct bus_type css_bus_type;
122 extern struct channel_subsystem *channel_subsystems[];
123 
124 /* Some helper functions for disconnected state. */
125 int device_is_disconnected(struct subchannel *);
126 void device_set_disconnected(struct subchannel *);
127 void device_trigger_reprobe(struct subchannel *);
128 
129 /* Helper functions for vary on/off. */
130 int device_is_online(struct subchannel *);
131 void device_kill_io(struct subchannel *);
132 void device_set_intretry(struct subchannel *sch);
133 int device_trigger_verify(struct subchannel *sch);
134 
135 /* Machine check helper function. */
136 void device_kill_pending_timer(struct subchannel *);
137 
138 /* Helper functions to build lists for the slow path. */
139 void css_schedule_eval(struct subchannel_id schid);
140 void css_schedule_eval_all(void);
141 
142 int sch_is_pseudo_sch(struct subchannel *);
143 struct schib;
144 int css_sch_is_valid(struct schib *);
145 
146 extern struct workqueue_struct *slow_path_wq;
147 
148 extern struct attribute_group *subch_attr_groups[];
149 #endif
150