1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * Copyright IBM Corp. 2001, 2007
4 * Authors: Fritz Elfert (felfert@millenux.com)
5 * Peter Tiedemann (ptiedem@de.ibm.com)
6 * MPC additions :
7 * Belinda Thompson (belindat@us.ibm.com)
8 * Andy Richter (richtera@us.ibm.com)
9 */
10#ifndef _CTCM_FSMS_H_
11#define _CTCM_FSMS_H_
12
13#include <linux/module.h>
14#include <linux/init.h>
15#include <linux/kernel.h>
16#include <linux/slab.h>
17#include <linux/errno.h>
18#include <linux/types.h>
19#include <linux/interrupt.h>
20#include <linux/timer.h>
21#include <linux/bitops.h>
22
23#include <linux/signal.h>
24#include <linux/string.h>
25
26#include <linux/ip.h>
27#include <linux/if_arp.h>
28#include <linux/tcp.h>
29#include <linux/skbuff.h>
30#include <linux/ctype.h>
31#include <net/dst.h>
32
33#include <linux/io.h>
34#include <asm/ccwdev.h>
35#include <asm/ccwgroup.h>
36#include <linux/uaccess.h>
37
38#include <asm/idals.h>
39
40#include "fsm.h"
41#include "ctcm_main.h"
42
43/*
44 * Definitions for the channel statemachine(s) for ctc and ctcmpc
45 *
46 * To allow better kerntyping, prefix-less definitions for channel states
47 * and channel events have been replaced :
48 * ch_event... -> ctc_ch_event...
49 * CH_EVENT... -> CTC_EVENT...
50 * ch_state... -> ctc_ch_state...
51 * CH_STATE... -> CTC_STATE...
52 */
53/*
54 * Events of the channel statemachine(s) for ctc and ctcmpc
55 */
56enum ctc_ch_events {
57 /*
58 * Events, representing return code of
59 * I/O operations (ccw_device_start, ccw_device_halt et al.)
60 */
61 CTC_EVENT_IO_SUCCESS,
62 CTC_EVENT_IO_EBUSY,
63 CTC_EVENT_IO_ENODEV,
64 CTC_EVENT_IO_UNKNOWN,
65
66 CTC_EVENT_ATTNBUSY,
67 CTC_EVENT_ATTN,
68 CTC_EVENT_BUSY,
69 /*
70 * Events, representing unit-check
71 */
72 CTC_EVENT_UC_RCRESET,
73 CTC_EVENT_UC_RSRESET,
74 CTC_EVENT_UC_TXTIMEOUT,
75 CTC_EVENT_UC_TXPARITY,
76 CTC_EVENT_UC_HWFAIL,
77 CTC_EVENT_UC_RXPARITY,
78 CTC_EVENT_UC_ZERO,
79 CTC_EVENT_UC_UNKNOWN,
80 /*
81 * Events, representing subchannel-check
82 */
83 CTC_EVENT_SC_UNKNOWN,
84 /*
85 * Events, representing machine checks
86 */
87 CTC_EVENT_MC_FAIL,
88 CTC_EVENT_MC_GOOD,
89 /*
90 * Event, representing normal IRQ
91 */
92 CTC_EVENT_IRQ,
93 CTC_EVENT_FINSTAT,
94 /*
95 * Event, representing timer expiry.
96 */
97 CTC_EVENT_TIMER,
98 /*
99 * Events, representing commands from upper levels.
100 */
101 CTC_EVENT_START,
102 CTC_EVENT_STOP,
103 CTC_NR_EVENTS,
104 /*
105 * additional MPC events
106 */
107 CTC_EVENT_SEND_XID = CTC_NR_EVENTS,
108 CTC_EVENT_RSWEEP_TIMER,
109 /*
110 * MUST be always the last element!!
111 */
112 CTC_MPC_NR_EVENTS,
113};
114
115/*
116 * States of the channel statemachine(s) for ctc and ctcmpc.
117 */
118enum ctc_ch_states {
119 /*
120 * Channel not assigned to any device,
121 * initial state, direction invalid
122 */
123 CTC_STATE_IDLE,
124 /*
125 * Channel assigned but not operating
126 */
127 CTC_STATE_STOPPED,
128 CTC_STATE_STARTWAIT,
129 CTC_STATE_STARTRETRY,
130 CTC_STATE_SETUPWAIT,
131 CTC_STATE_RXINIT,
132 CTC_STATE_TXINIT,
133 CTC_STATE_RX,
134 CTC_STATE_TX,
135 CTC_STATE_RXIDLE,
136 CTC_STATE_TXIDLE,
137 CTC_STATE_RXERR,
138 CTC_STATE_TXERR,
139 CTC_STATE_TERM,
140 CTC_STATE_DTERM,
141 CTC_STATE_NOTOP,
142 CTC_NR_STATES, /* MUST be the last element of non-expanded states */
143 /*
144 * additional MPC states
145 */
146 CH_XID0_PENDING = CTC_NR_STATES,
147 CH_XID0_INPROGRESS,
148 CH_XID7_PENDING,
149 CH_XID7_PENDING1,
150 CH_XID7_PENDING2,
151 CH_XID7_PENDING3,
152 CH_XID7_PENDING4,
153 CTC_MPC_NR_STATES, /* MUST be the last element of expanded mpc states */
154};
155
156extern const char *ctc_ch_event_names[];
157
158extern const char *ctc_ch_state_names[];
159
160void ctcm_ccw_check_rc(struct channel *ch, int rc, char *msg);
161void ctcm_purge_skb_queue(struct sk_buff_head *q);
162
163/*
164 * ----- non-static actions for ctcm channel statemachine -----
165 *
166 */
167void ctcm_chx_txidle(fsm_instance *fi, int event, void *arg);
168
169/*
170 * ----- FSM (state/event/action) of the ctcm channel statemachine -----
171 */
172extern const fsm_node ch_fsm[];
173extern int ch_fsm_len;
174
175
176/*
177 * ----- non-static actions for ctcmpc channel statemachine ----
178 *
179 */
180/* shared :
181void ctcm_chx_txidle(fsm_instance * fi, int event, void *arg);
182 */
183void ctcmpc_chx_rxidle(fsm_instance *fi, int event, void *arg);
184
185/*
186 * ----- FSM (state/event/action) of the ctcmpc channel statemachine -----
187 */
188extern const fsm_node ctcmpc_ch_fsm[];
189extern 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 */
198enum 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
213extern const char *dev_state_names[];
214
215/*
216 * Events of the device interface statemachine.
217 * ctcm and ctcmpc
218 */
219enum 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
233extern const char *dev_event_names[];
234
235/*
236 * Actions for the device interface statemachine.
237 * ctc and ctcmpc
238 */
239/*
240static void dev_action_start(fsm_instance * fi, int event, void *arg);
241static void dev_action_stop(fsm_instance * fi, int event, void *arg);
242static void dev_action_restart(fsm_instance *fi, int event, void *arg);
243static void dev_action_chup(fsm_instance * fi, int event, void *arg);
244static 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 */
251extern const fsm_node dev_fsm[];
252extern int dev_fsm_len;
253
254
255/*
256 * Definitions for the MPC Group statemachine
257 */
258
259/*
260 * MPC Group Station FSM States
261
262State Name When In This State
263====================== =======================================
264MPCG_STATE_RESET Initial State When Driver Loaded
265 We receive and send NOTHING
266
267MPCG_STATE_INOP INOP Received.
268 Group level non-recoverable error
269
270MPCG_STATE_READY XID exchanges for at least 1 write and
271 1 read channel have completed.
272 Group is ready for data transfer.
273
274States from ctc_mpc_alloc_channel
275==============================================================
276MPCG_STATE_XID2INITW Awaiting XID2(0) Initiation
277 ATTN from other side will start
278 XID negotiations.
279 Y-side protocol only.
280
281MPCG_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
285MPCG_STATE_XID7INITW XID2(0) complete
286 No XID2(7)'s have yet been received.
287 XID2(7) negotiations pending.
288
289MPCG_STATE_XID7INITX XID2(7) negotiations in progress.
290 At least 1, but not all, XID2(7)'s
291 have been received from partner.
292
293MPCG_STATE_XID7INITF XID2(7) negotiations complete.
294 Transitioning to READY.
295
296MPCG_STATE_READY Ready for Data Transfer.
297
298
299States from ctc_mpc_establish_connectivity call
300==============================================================
301MPCG_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
307MPCG_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
311MPCG_STATE_XID7INITI XID2(0) complete
312 No XID2(7)'s have yet been received.
313 XID2(7) negotiations pending.
314
315MPCG_STATE_XID7INITZ XID2(7) negotiations in progress.
316 At least 1, but not all, XID2(7)'s
317 have been received from partner.
318
319MPCG_STATE_XID7INITF XID2(7) negotiations complete.
320 Transitioning to READY.
321
322MPCG_STATE_READY Ready for Data Transfer.
323
324*/
325
326enum 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
338enum 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

source code of linux/drivers/s390/net/ctcm_fsms.h