hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * drivers/net/ethernet/ibm/emac/mal.h
 *
 * Memory Access Layer (MAL) support
 *
 * Copyright 2007 Benjamin Herrenschmidt, IBM Corp.
 *                <benh@kernel.crashing.org>
 *
 * Based on the arch/ppc version of the driver:
 *
 * Copyright (c) 2004, 2005 Zultys Technologies.
 * Eugene Surovegin <eugene.surovegin@zultys.com> or <ebs@ebshome.net>
 *
 * Based on original work by
 *      Armin Kuster <akuster@mvista.com>
 *      Copyright 2002 MontaVista Softare Inc.
 */
#ifndef __IBM_NEWEMAC_MAL_H
#define __IBM_NEWEMAC_MAL_H
 
/*
 * There are some variations on the MAL, we express them in this driver as
 * MAL Version 1 and 2 though that doesn't match any IBM terminology.
 *
 * We call MAL 1 the version in 405GP, 405GPR, 405EP, 440EP, 440GR and
 * NP405H.
 *
 * We call MAL 2 the version in 440GP, 440GX, 440SP, 440SPE and Axon
 *
 * The driver expects a "version" property in the emac node containing
 * a number 1 or 2. New device-trees for EMAC capable platforms are thus
 * required to include that when porting to arch/powerpc.
 */
 
/* MALx DCR registers */
#define    MAL_CFG            0x00
#define      MAL_CFG_SR        0x80000000
#define   MAL_CFG_PLBB        0x00004000
#define   MAL_CFG_OPBBL        0x00000080
#define   MAL_CFG_EOPIE        0x00000004
#define   MAL_CFG_LEA        0x00000002
#define   MAL_CFG_SD        0x00000001
 
/* MAL V1 CFG bits */
#define   MAL1_CFG_PLBP_MASK    0x00c00000
#define   MAL1_CFG_PLBP_10    0x00800000
#define   MAL1_CFG_GA        0x00200000
#define   MAL1_CFG_OA        0x00100000
#define   MAL1_CFG_PLBLE    0x00080000
#define   MAL1_CFG_PLBT_MASK    0x00078000
#define   MAL1_CFG_DEFAULT    (MAL1_CFG_PLBP_10 | MAL1_CFG_PLBT_MASK)
 
/* MAL V2 CFG bits */
#define   MAL2_CFG_RPP_MASK    0x00c00000
#define   MAL2_CFG_RPP_10    0x00800000
#define   MAL2_CFG_RMBS_MASK    0x00300000
#define   MAL2_CFG_WPP_MASK    0x000c0000
#define   MAL2_CFG_WPP_10    0x00080000
#define   MAL2_CFG_WMBS_MASK    0x00030000
#define   MAL2_CFG_PLBLE    0x00008000
#define   MAL2_CFG_DEFAULT    (MAL2_CFG_RMBS_MASK | MAL2_CFG_WMBS_MASK | \
                MAL2_CFG_RPP_10 | MAL2_CFG_WPP_10)
 
#define MAL_ESR            0x01
#define   MAL_ESR_EVB        0x80000000
#define   MAL_ESR_CIDT        0x40000000
#define   MAL_ESR_CID_MASK    0x3e000000
#define   MAL_ESR_CID_SHIFT    25
#define   MAL_ESR_DE        0x00100000
#define   MAL_ESR_OTE        0x00040000
#define   MAL_ESR_OSE        0x00020000
#define   MAL_ESR_PEIN        0x00010000
#define   MAL_ESR_DEI        0x00000010
#define   MAL_ESR_OTEI        0x00000004
#define   MAL_ESR_OSEI        0x00000002
#define   MAL_ESR_PBEI        0x00000001
 
/* MAL V1 ESR bits */
#define   MAL1_ESR_ONE        0x00080000
#define   MAL1_ESR_ONEI        0x00000008
 
/* MAL V2 ESR bits */
#define   MAL2_ESR_PTE        0x00800000
#define   MAL2_ESR_PRE        0x00400000
#define   MAL2_ESR_PWE        0x00200000
#define   MAL2_ESR_PTEI        0x00000080
#define   MAL2_ESR_PREI        0x00000040
#define   MAL2_ESR_PWEI        0x00000020
 
 
#define MAL_IER            0x02
/* MAL IER bits */
#define   MAL_IER_DE        0x00000010
#define   MAL_IER_OTE        0x00000004
#define   MAL_IER_OE        0x00000002
#define   MAL_IER_PE        0x00000001
 
/* PLB read/write/timeout errors */
#define   MAL_IER_PTE        0x00000080
#define   MAL_IER_PRE        0x00000040
#define   MAL_IER_PWE        0x00000020
 
#define   MAL_IER_SOC_EVENTS    (MAL_IER_PTE | MAL_IER_PRE | MAL_IER_PWE)
#define   MAL_IER_EVENTS    (MAL_IER_SOC_EVENTS | MAL_IER_DE | \
                MAL_IER_OTE | MAL_IER_OE | MAL_IER_PE)
 
#define MAL_TXCASR        0x04
#define MAL_TXCARR        0x05
#define MAL_TXEOBISR        0x06
#define MAL_TXDEIR        0x07
#define MAL_RXCASR        0x10
#define MAL_RXCARR        0x11
#define MAL_RXEOBISR        0x12
#define MAL_RXDEIR        0x13
#define MAL_TXCTPR(n)        ((n) + 0x20)
#define MAL_RXCTPR(n)        ((n) + 0x40)
#define MAL_RCBS(n)        ((n) + 0x60)
 
/* In reality MAL can handle TX buffers up to 4095 bytes long,
 * but this isn't a good round number :)          --ebs
 */
#define MAL_MAX_TX_SIZE        4080
#define MAL_MAX_RX_SIZE        4080
 
static inline int mal_rx_size(int len)
{
   len = (len + 0xf) & ~0xf;
   return len > MAL_MAX_RX_SIZE ? MAL_MAX_RX_SIZE : len;
}
 
static inline int mal_tx_chunks(int len)
{
   return DIV_ROUND_UP(len, MAL_MAX_TX_SIZE);
}
 
#define MAL_CHAN_MASK(n)    (0x80000000 >> (n))
 
/* MAL Buffer Descriptor structure */
struct mal_descriptor {
   u16 ctrl;        /* MAL / Commac status control bits */
   u16 data_len;        /* Max length is 4K-1 (12 bits)     */
   u32 data_ptr;        /* pointer to actual data buffer    */
};
 
/* the following defines are for the MadMAL status and control registers. */
/* MADMAL transmit and receive status/control bits  */
#define MAL_RX_CTRL_EMPTY    0x8000
#define MAL_RX_CTRL_WRAP    0x4000
#define MAL_RX_CTRL_CM        0x2000
#define MAL_RX_CTRL_LAST    0x1000
#define MAL_RX_CTRL_FIRST    0x0800
#define MAL_RX_CTRL_INTR    0x0400
#define MAL_RX_CTRL_SINGLE    (MAL_RX_CTRL_LAST | MAL_RX_CTRL_FIRST)
#define MAL_IS_SINGLE_RX(ctrl)    (((ctrl) & MAL_RX_CTRL_SINGLE) == MAL_RX_CTRL_SINGLE)
 
#define MAL_TX_CTRL_READY    0x8000
#define MAL_TX_CTRL_WRAP    0x4000
#define MAL_TX_CTRL_CM        0x2000
#define MAL_TX_CTRL_LAST    0x1000
#define MAL_TX_CTRL_INTR    0x0400
 
struct mal_commac_ops {
   void    (*poll_tx) (void *dev);
   int    (*poll_rx) (void *dev, int budget);
   int    (*peek_rx) (void *dev);
   void    (*rxde) (void *dev);
};
 
struct mal_commac {
   struct mal_commac_ops    *ops;
   void            *dev;
   struct list_head    poll_list;
   long               flags;
#define MAL_COMMAC_RX_STOPPED        0
#define MAL_COMMAC_POLL_DISABLED    1
   u32            tx_chan_mask;
   u32            rx_chan_mask;
   struct list_head    list;
};
 
struct mal_instance {
   int            version;
   dcr_host_t        dcr_host;
 
   int            num_tx_chans;    /* Number of TX channels */
   int            num_rx_chans;    /* Number of RX channels */
   int             txeob_irq;    /* TX End Of Buffer IRQ  */
   int             rxeob_irq;    /* RX End Of Buffer IRQ  */
   int            txde_irq;    /* TX Descriptor Error IRQ */
   int            rxde_irq;    /* RX Descriptor Error IRQ */
   int            serr_irq;    /* MAL System Error IRQ    */
 
   struct list_head    poll_list;
   struct napi_struct    napi;
 
   struct list_head    list;
   u32            tx_chan_mask;
   u32            rx_chan_mask;
 
   dma_addr_t        bd_dma;
   struct mal_descriptor    *bd_virt;
 
   struct platform_device    *ofdev;
   int            index;
   spinlock_t        lock;
 
   struct net_device    dummy_dev;
 
   unsigned int features;
};
 
static inline u32 get_mal_dcrn(struct mal_instance *mal, int reg)
{
   return dcr_read(mal->dcr_host, reg);
}
 
static inline void set_mal_dcrn(struct mal_instance *mal, int reg, u32 val)
{
   dcr_write(mal->dcr_host, reg, val);
}
 
/* Features of various MAL implementations */
 
/* Set if you have interrupt coalescing and you have to clear the SDR
 * register for TXEOB and RXEOB interrupts to work
 */
#define MAL_FTR_CLEAR_ICINTSTAT    0x00000001
 
/* Set if your MAL has SERR, TXDE, and RXDE OR'd into a single UIC
 * interrupt
 */
#define MAL_FTR_COMMON_ERR_INT    0x00000002
 
enum {
   MAL_FTRS_ALWAYS = 0,
 
   MAL_FTRS_POSSIBLE =
#ifdef CONFIG_IBM_EMAC_MAL_CLR_ICINTSTAT
       MAL_FTR_CLEAR_ICINTSTAT |
#endif
#ifdef CONFIG_IBM_EMAC_MAL_COMMON_ERR
       MAL_FTR_COMMON_ERR_INT |
#endif
       0,
};
 
static inline int mal_has_feature(struct mal_instance *dev,
       unsigned long feature)
{
   return (MAL_FTRS_ALWAYS & feature) ||
       (MAL_FTRS_POSSIBLE & dev->features & feature);
}
 
/* Register MAL devices */
int mal_init(void);
void mal_exit(void);
 
int mal_register_commac(struct mal_instance *mal,
           struct mal_commac *commac);
void mal_unregister_commac(struct mal_instance *mal,
              struct mal_commac *commac);
int mal_set_rcbs(struct mal_instance *mal, int channel, unsigned long size);
 
/* Returns BD ring offset for a particular channel
   (in 'struct mal_descriptor' elements)
*/
int mal_tx_bd_offset(struct mal_instance *mal, int channel);
int mal_rx_bd_offset(struct mal_instance *mal, int channel);
 
void mal_enable_tx_channel(struct mal_instance *mal, int channel);
void mal_disable_tx_channel(struct mal_instance *mal, int channel);
void mal_enable_rx_channel(struct mal_instance *mal, int channel);
void mal_disable_rx_channel(struct mal_instance *mal, int channel);
 
void mal_poll_disable(struct mal_instance *mal, struct mal_commac *commac);
void mal_poll_enable(struct mal_instance *mal, struct mal_commac *commac);
 
/* Add/remove EMAC to/from MAL polling list */
void mal_poll_add(struct mal_instance *mal, struct mal_commac *commac);
void mal_poll_del(struct mal_instance *mal, struct mal_commac *commac);
 
/* Ethtool MAL registers */
struct mal_regs {
   u32 tx_count;
   u32 rx_count;
 
   u32 cfg;
   u32 esr;
   u32 ier;
   u32 tx_casr;
   u32 tx_carr;
   u32 tx_eobisr;
   u32 tx_deir;
   u32 rx_casr;
   u32 rx_carr;
   u32 rx_eobisr;
   u32 rx_deir;
   u32 tx_ctpr[32];
   u32 rx_ctpr[32];
   u32 rcbs[32];
};
 
int mal_get_regs_len(struct mal_instance *mal);
void *mal_dump_regs(struct mal_instance *mal, void *buf);
 
#endif /* __IBM_NEWEMAC_MAL_H */