xref: /openbmc/linux/drivers/s390/net/ctcm_fsms.h (revision 4f3db074)
1 /*
2  * Copyright IBM Corp. 2001, 2007
3  * Authors: 	Fritz Elfert (felfert@millenux.com)
4  * 		Peter Tiedemann (ptiedem@de.ibm.com)
5  * 	MPC additions :
6  *		Belinda Thompson (belindat@us.ibm.com)
7  *		Andy Richter (richtera@us.ibm.com)
8  */
9 #ifndef _CTCM_FSMS_H_
10 #define _CTCM_FSMS_H_
11 
12 #include <linux/module.h>
13 #include <linux/init.h>
14 #include <linux/kernel.h>
15 #include <linux/slab.h>
16 #include <linux/errno.h>
17 #include <linux/types.h>
18 #include <linux/interrupt.h>
19 #include <linux/timer.h>
20 #include <linux/bitops.h>
21 
22 #include <linux/signal.h>
23 #include <linux/string.h>
24 
25 #include <linux/ip.h>
26 #include <linux/if_arp.h>
27 #include <linux/tcp.h>
28 #include <linux/skbuff.h>
29 #include <linux/ctype.h>
30 #include <net/dst.h>
31 
32 #include <linux/io.h>
33 #include <asm/ccwdev.h>
34 #include <asm/ccwgroup.h>
35 #include <linux/uaccess.h>
36 
37 #include <asm/idals.h>
38 
39 #include "fsm.h"
40 #include "ctcm_main.h"
41 
42 /*
43  * Definitions for the channel statemachine(s) for ctc and ctcmpc
44  *
45  * To allow better kerntyping, prefix-less definitions for channel states
46  * and channel events have been replaced :
47  * ch_event... -> ctc_ch_event...
48  * CH_EVENT... -> CTC_EVENT...
49  * ch_state... -> ctc_ch_state...
50  * CH_STATE... -> CTC_STATE...
51  */
52 /*
53  * Events of the channel statemachine(s) for ctc and ctcmpc
54  */
55 enum ctc_ch_events {
56 	/*
57 	 * Events, representing return code of
58 	 * I/O operations (ccw_device_start, ccw_device_halt et al.)
59 	 */
60 	CTC_EVENT_IO_SUCCESS,
61 	CTC_EVENT_IO_EBUSY,
62 	CTC_EVENT_IO_ENODEV,
63 	CTC_EVENT_IO_UNKNOWN,
64 
65 	CTC_EVENT_ATTNBUSY,
66 	CTC_EVENT_ATTN,
67 	CTC_EVENT_BUSY,
68 	/*
69 	 * Events, representing unit-check
70 	 */
71 	CTC_EVENT_UC_RCRESET,
72 	CTC_EVENT_UC_RSRESET,
73 	CTC_EVENT_UC_TXTIMEOUT,
74 	CTC_EVENT_UC_TXPARITY,
75 	CTC_EVENT_UC_HWFAIL,
76 	CTC_EVENT_UC_RXPARITY,
77 	CTC_EVENT_UC_ZERO,
78 	CTC_EVENT_UC_UNKNOWN,
79 	/*
80 	 * Events, representing subchannel-check
81 	 */
82 	CTC_EVENT_SC_UNKNOWN,
83 	/*
84 	 * Events, representing machine checks
85 	 */
86 	CTC_EVENT_MC_FAIL,
87 	CTC_EVENT_MC_GOOD,
88 	/*
89 	 * Event, representing normal IRQ
90 	 */
91 	CTC_EVENT_IRQ,
92 	CTC_EVENT_FINSTAT,
93 	/*
94 	 * Event, representing timer expiry.
95 	 */
96 	CTC_EVENT_TIMER,
97 	/*
98 	 * Events, representing commands from upper levels.
99 	 */
100 	CTC_EVENT_START,
101 	CTC_EVENT_STOP,
102 	CTC_NR_EVENTS,
103 	/*
104 	 * additional MPC events
105 	 */
106 	CTC_EVENT_SEND_XID = CTC_NR_EVENTS,
107 	CTC_EVENT_RSWEEP_TIMER,
108 	/*
109 	 * MUST be always the last element!!
110 	 */
111 	CTC_MPC_NR_EVENTS,
112 };
113 
114 /*
115  * States of the channel statemachine(s) for ctc and ctcmpc.
116  */
117 enum ctc_ch_states {
118 	/*
119 	 * Channel not assigned to any device,
120 	 * initial state, direction invalid
121 	 */
122 	CTC_STATE_IDLE,
123 	/*
124 	 * Channel assigned but not operating
125 	 */
126 	CTC_STATE_STOPPED,
127 	CTC_STATE_STARTWAIT,
128 	CTC_STATE_STARTRETRY,
129 	CTC_STATE_SETUPWAIT,
130 	CTC_STATE_RXINIT,
131 	CTC_STATE_TXINIT,
132 	CTC_STATE_RX,
133 	CTC_STATE_TX,
134 	CTC_STATE_RXIDLE,
135 	CTC_STATE_TXIDLE,
136 	CTC_STATE_RXERR,
137 	CTC_STATE_TXERR,
138 	CTC_STATE_TERM,
139 	CTC_STATE_DTERM,
140 	CTC_STATE_NOTOP,
141 	CTC_NR_STATES,     /* MUST be the last element of non-expanded states */
142 	/*
143 	 * additional MPC states
144 	 */
145 	CH_XID0_PENDING = CTC_NR_STATES,
146 	CH_XID0_INPROGRESS,
147 	CH_XID7_PENDING,
148 	CH_XID7_PENDING1,
149 	CH_XID7_PENDING2,
150 	CH_XID7_PENDING3,
151 	CH_XID7_PENDING4,
152 	CTC_MPC_NR_STATES, /* MUST be the last element of expanded mpc states */
153 };
154 
155 extern const char *ctc_ch_event_names[];
156 
157 extern const char *ctc_ch_state_names[];
158 
159 void ctcm_ccw_check_rc(struct channel *ch, int rc, char *msg);
160 void ctcm_purge_skb_queue(struct sk_buff_head *q);
161 void fsm_action_nop(fsm_instance *fi, int event, void *arg);
162 
163 /*
164  * ----- non-static actions for ctcm channel statemachine -----
165  *
166  */
167 void ctcm_chx_txidle(fsm_instance *fi, int event, void *arg);
168 
169 /*
170  * ----- FSM (state/event/action) of the ctcm channel statemachine -----
171  */
172 extern const fsm_node ch_fsm[];
173 extern int ch_fsm_len;
174 
175 
176 /*
177  * ----- non-static actions for ctcmpc channel statemachine ----
178  *
179  */
180 /* shared :
181 void ctcm_chx_txidle(fsm_instance * fi, int event, void *arg);
182  */
183 void ctcmpc_chx_rxidle(fsm_instance *fi, int event, void *arg);
184 
185 /*
186  * ----- FSM (state/event/action) of the ctcmpc channel statemachine -----
187  */
188 extern const fsm_node ctcmpc_ch_fsm[];
189 extern int mpc_ch_fsm_len;
190 
191 /*
192  * Definitions for the device interface statemachine for ctc and mpc
193  */
194 
195 /*
196  * States of the device interface statemachine.
197  */
198 enum dev_states {
199 	DEV_STATE_STOPPED,
200 	DEV_STATE_STARTWAIT_RXTX,
201 	DEV_STATE_STARTWAIT_RX,
202 	DEV_STATE_STARTWAIT_TX,
203 	DEV_STATE_STOPWAIT_RXTX,
204 	DEV_STATE_STOPWAIT_RX,
205 	DEV_STATE_STOPWAIT_TX,
206 	DEV_STATE_RUNNING,
207 	/*
208 	 * MUST be always the last element!!
209 	 */
210 	CTCM_NR_DEV_STATES
211 };
212 
213 extern const char *dev_state_names[];
214 
215 /*
216  * Events of the device interface statemachine.
217  * ctcm and ctcmpc
218  */
219 enum dev_events {
220 	DEV_EVENT_START,
221 	DEV_EVENT_STOP,
222 	DEV_EVENT_RXUP,
223 	DEV_EVENT_TXUP,
224 	DEV_EVENT_RXDOWN,
225 	DEV_EVENT_TXDOWN,
226 	DEV_EVENT_RESTART,
227 	/*
228 	 * MUST be always the last element!!
229 	 */
230 	CTCM_NR_DEV_EVENTS
231 };
232 
233 extern const char *dev_event_names[];
234 
235 /*
236  * Actions for the device interface statemachine.
237  * ctc and ctcmpc
238  */
239 /*
240 static void dev_action_start(fsm_instance * fi, int event, void *arg);
241 static void dev_action_stop(fsm_instance * fi, int event, void *arg);
242 static void dev_action_restart(fsm_instance *fi, int event, void *arg);
243 static void dev_action_chup(fsm_instance * fi, int event, void *arg);
244 static void dev_action_chdown(fsm_instance * fi, int event, void *arg);
245 */
246 
247 /*
248  * The (state/event/action) fsm table of the device interface statemachine.
249  * ctcm and ctcmpc
250  */
251 extern const fsm_node dev_fsm[];
252 extern int dev_fsm_len;
253 
254 
255 /*
256  * Definitions for the MPC Group statemachine
257  */
258 
259 /*
260  * MPC Group Station FSM States
261 
262 State Name		When In This State
263 ======================	=======================================
264 MPCG_STATE_RESET	Initial State When Driver Loaded
265 			We receive and send NOTHING
266 
267 MPCG_STATE_INOP         INOP Received.
268 			Group level non-recoverable error
269 
270 MPCG_STATE_READY	XID exchanges for at least 1 write and
271 			1 read channel have completed.
272 			Group is ready for data transfer.
273 
274 States from ctc_mpc_alloc_channel
275 ==============================================================
276 MPCG_STATE_XID2INITW	Awaiting XID2(0) Initiation
277 			      ATTN from other side will start
278 			      XID negotiations.
279 			      Y-side protocol only.
280 
281 MPCG_STATE_XID2INITX	XID2(0) negotiations are in progress.
282 			      At least 1, but not all, XID2(0)'s
283 			      have been received from partner.
284 
285 MPCG_STATE_XID7INITW	XID2(0) complete
286 			      No XID2(7)'s have yet been received.
287 			      XID2(7) negotiations pending.
288 
289 MPCG_STATE_XID7INITX	XID2(7) negotiations in progress.
290 			      At least 1, but not all, XID2(7)'s
291 			      have been received from partner.
292 
293 MPCG_STATE_XID7INITF	XID2(7) negotiations complete.
294 			      Transitioning to READY.
295 
296 MPCG_STATE_READY	      Ready for Data Transfer.
297 
298 
299 States from ctc_mpc_establish_connectivity call
300 ==============================================================
301 MPCG_STATE_XID0IOWAIT	Initiating XID2(0) negotiations.
302 			      X-side protocol only.
303 			      ATTN-BUSY from other side will convert
304 			      this to Y-side protocol and the
305 			      ctc_mpc_alloc_channel flow will begin.
306 
307 MPCG_STATE_XID0IOWAIX	XID2(0) negotiations are in progress.
308 			      At least 1, but not all, XID2(0)'s
309 			      have been received from partner.
310 
311 MPCG_STATE_XID7INITI	XID2(0) complete
312 			      No XID2(7)'s have yet been received.
313 			      XID2(7) negotiations pending.
314 
315 MPCG_STATE_XID7INITZ	XID2(7) negotiations in progress.
316 			      At least 1, but not all, XID2(7)'s
317 			      have been received from partner.
318 
319 MPCG_STATE_XID7INITF	XID2(7) negotiations complete.
320 			      Transitioning to READY.
321 
322 MPCG_STATE_READY	      Ready for Data Transfer.
323 
324 */
325 
326 enum mpcg_events {
327 	MPCG_EVENT_INOP,
328 	MPCG_EVENT_DISCONC,
329 	MPCG_EVENT_XID0DO,
330 	MPCG_EVENT_XID2,
331 	MPCG_EVENT_XID2DONE,
332 	MPCG_EVENT_XID7DONE,
333 	MPCG_EVENT_TIMER,
334 	MPCG_EVENT_DOIO,
335 	MPCG_NR_EVENTS,
336 };
337 
338 enum mpcg_states {
339 	MPCG_STATE_RESET,
340 	MPCG_STATE_INOP,
341 	MPCG_STATE_XID2INITW,
342 	MPCG_STATE_XID2INITX,
343 	MPCG_STATE_XID7INITW,
344 	MPCG_STATE_XID7INITX,
345 	MPCG_STATE_XID0IOWAIT,
346 	MPCG_STATE_XID0IOWAIX,
347 	MPCG_STATE_XID7INITI,
348 	MPCG_STATE_XID7INITZ,
349 	MPCG_STATE_XID7INITF,
350 	MPCG_STATE_FLOWC,
351 	MPCG_STATE_READY,
352 	MPCG_NR_STATES,
353 };
354 
355 #endif
356 /* --- This is the END my friend --- */
357