xref: /dpdk/drivers/bus/dpaa/include/fman.h (revision ef5baf34)
1 /* SPDX-License-Identifier: (BSD-3-Clause OR GPL-2.0)
2  *
3  * Copyright 2010-2012 Freescale Semiconductor, Inc.
4  * All rights reserved.
5  *
6  */
7 
8 #ifndef __FMAN_H
9 #define __FMAN_H
10 
11 #include <stdbool.h>
12 #include <net/if.h>
13 
14 #include <rte_ethdev_driver.h>
15 #include <rte_ether.h>
16 
17 #include <compat.h>
18 #include <dpaa_list.h>
19 
20 #ifndef FMAN_DEVICE_PATH
21 #define FMAN_DEVICE_PATH "/dev/mem"
22 #endif
23 
24 #define MEMAC_NUM_OF_PADDRS 7 /* Num of additional exact match MAC adr regs */
25 
26 /* Control and Configuration Register (COMMAND_CONFIG) for MEMAC */
27 #define CMD_CFG_LOOPBACK_EN	0x00000400
28 /**< 21 XGMII/GMII loopback enable */
29 #define CMD_CFG_PROMIS_EN	0x00000010
30 /**< 27 Promiscuous operation enable */
31 #define CMD_CFG_PAUSE_IGNORE	0x00000100
32 /**< 23 Ignore Pause frame quanta */
33 
34 /* Statistics Configuration Register (STATN_CONFIG) */
35 #define STATS_CFG_CLR           0x00000004
36 /**< 29 Reset all counters */
37 #define STATS_CFG_CLR_ON_RD     0x00000002
38 /**< 30 Clear on read */
39 #define STATS_CFG_SATURATE      0x00000001
40 /**< 31 Saturate at the maximum val */
41 
42 /**< Max receive frame length mask */
43 #define MAXFRM_SIZE_MEMAC	0x00007fe0
44 #define MAXFRM_RX_MASK		0x0000ffff
45 
46 /**< Interface Mode Register Register for MEMAC */
47 #define IF_MODE_RLP 0x00000820
48 
49 /**< Pool Limits */
50 #define FMAN_PORT_MAX_EXT_POOLS_NUM	8
51 #define FMAN_PORT_OBS_EXT_POOLS_NUM	2
52 
53 #define FMAN_PORT_CG_MAP_NUM		8
54 #define FMAN_PORT_PRS_RESULT_WORDS_NUM	8
55 #define FMAN_PORT_BMI_FIFO_UNITS	0x100
56 #define FMAN_PORT_IC_OFFSET_UNITS	0x10
57 
58 #define FMAN_ENABLE_BPOOL_DEPLETION	0xF00000F0
59 
60 #define HASH_CTRL_MCAST_EN	0x00000100
61 #define GROUP_ADDRESS		0x0000010000000000LL
62 #define HASH_CTRL_ADDR_MASK	0x0000003F
63 
64 /* Pre definitions of FMAN interface and Bpool structures */
65 struct __fman_if;
66 struct fman_if_bpool;
67 /* Lists of fman interfaces and bpools */
68 TAILQ_HEAD(rte_fman_if_list, __fman_if);
69 
70 /* Represents the different flavour of network interface */
71 enum fman_mac_type {
72 	fman_offline = 0,
73 	fman_mac_1g,
74 	fman_mac_10g,
75 };
76 
77 struct mac_addr {
78 	uint32_t   mac_addr_l;	/**< Lower 32 bits of 48-bit MAC address */
79 	uint32_t   mac_addr_u;	/**< Upper 16 bits of 48-bit MAC address */
80 };
81 
82 struct memac_regs {
83 	/* General Control and Status */
84 	uint32_t res0000[2];
85 	uint32_t command_config;	/**< 0x008 Ctrl and cfg */
86 	struct mac_addr mac_addr0;	/**< 0x00C-0x010 MAC_ADDR_0...1 */
87 	uint32_t maxfrm;		/**< 0x014 Max frame length */
88 	uint32_t res0018[5];
89 	uint32_t hashtable_ctrl;	/**< 0x02C Hash table control */
90 	uint32_t res0030[4];
91 	uint32_t ievent;		/**< 0x040 Interrupt event */
92 	uint32_t tx_ipg_length;
93 	/**< 0x044 Transmitter inter-packet-gap */
94 	uint32_t res0048;
95 	uint32_t imask;			/**< 0x04C Interrupt mask */
96 	uint32_t res0050;
97 	uint32_t pause_quanta[4];	/**< 0x054 Pause quanta */
98 	uint32_t pause_thresh[4];	/**< 0x064 Pause quanta threshold */
99 	uint32_t rx_pause_status;	/**< 0x074 Receive pause status */
100 	uint32_t res0078[2];
101 	struct mac_addr mac_addr[MEMAC_NUM_OF_PADDRS];
102 	/**< 0x80-0x0B4 mac padr */
103 	uint32_t lpwake_timer;
104 	/**< 0x0B8 Low Power Wakeup Timer */
105 	uint32_t sleep_timer;
106 	/**< 0x0BC Transmit EEE Low Power Timer */
107 	uint32_t res00c0[8];
108 	uint32_t statn_config;
109 	/**< 0x0E0 Statistics configuration */
110 	uint32_t res00e4[7];
111 	/* Rx Statistics Counter */
112 	uint32_t reoct_l;		/**<Rx Eth Octets Counter */
113 	uint32_t reoct_u;
114 	uint32_t roct_l;		/**<Rx Octet Counters */
115 	uint32_t roct_u;
116 	uint32_t raln_l;		/**<Rx Alignment Error Counter */
117 	uint32_t raln_u;
118 	uint32_t rxpf_l;		/**<Rx valid Pause Frame */
119 	uint32_t rxpf_u;
120 	uint32_t rfrm_l;		/**<Rx Frame counter */
121 	uint32_t rfrm_u;
122 	uint32_t rfcs_l;		/**<Rx frame check seq error */
123 	uint32_t rfcs_u;
124 	uint32_t rvlan_l;		/**<Rx Vlan Frame Counter */
125 	uint32_t rvlan_u;
126 	uint32_t rerr_l;		/**<Rx Frame error */
127 	uint32_t rerr_u;
128 	uint32_t ruca_l;		/**<Rx Unicast */
129 	uint32_t ruca_u;
130 	uint32_t rmca_l;		/**<Rx Multicast */
131 	uint32_t rmca_u;
132 	uint32_t rbca_l;		/**<Rx Broadcast */
133 	uint32_t rbca_u;
134 	uint32_t rdrp_l;		/**<Rx Dropper Packet */
135 	uint32_t rdrp_u;
136 	uint32_t rpkt_l;		/**<Rx packet */
137 	uint32_t rpkt_u;
138 	uint32_t rund_l;		/**<Rx undersized packets */
139 	uint32_t rund_u;
140 	uint32_t r64_l;			/**<Rx 64 byte */
141 	uint32_t r64_u;
142 	uint32_t r127_l;
143 	uint32_t r127_u;
144 	uint32_t r255_l;
145 	uint32_t r255_u;
146 	uint32_t r511_l;
147 	uint32_t r511_u;
148 	uint32_t r1023_l;
149 	uint32_t r1023_u;
150 	uint32_t r1518_l;
151 	uint32_t r1518_u;
152 	uint32_t r1519x_l;
153 	uint32_t r1519x_u;
154 	uint32_t rovr_l;		/**<Rx oversized but good */
155 	uint32_t rovr_u;
156 	uint32_t rjbr_l;		/**<Rx oversized with bad csum */
157 	uint32_t rjbr_u;
158 	uint32_t rfrg_l;		/**<Rx fragment Packet */
159 	uint32_t rfrg_u;
160 	uint32_t rcnp_l;		/**<Rx control packets (0x8808 */
161 	uint32_t rcnp_u;
162 	uint32_t rdrntp_l;		/**<Rx dropped due to FIFO overflow */
163 	uint32_t rdrntp_u;
164 	uint32_t res01d0[12];
165 	/* Tx Statistics Counter */
166 	uint32_t teoct_l;		/**<Tx eth octets */
167 	uint32_t teoct_u;
168 	uint32_t toct_l;		/**<Tx Octets */
169 	uint32_t toct_u;
170 	uint32_t res0210[2];
171 	uint32_t txpf_l;		/**<Tx valid pause frame */
172 	uint32_t txpf_u;
173 	uint32_t tfrm_l;		/**<Tx frame counter */
174 	uint32_t tfrm_u;
175 	uint32_t tfcs_l;		/**<Tx FCS error */
176 	uint32_t tfcs_u;
177 	uint32_t tvlan_l;		/**<Tx Vlan Frame */
178 	uint32_t tvlan_u;
179 	uint32_t terr_l;		/**<Tx frame error */
180 	uint32_t terr_u;
181 	uint32_t tuca_l;		/**<Tx Unicast */
182 	uint32_t tuca_u;
183 	uint32_t tmca_l;		/**<Tx Multicast */
184 	uint32_t tmca_u;
185 	uint32_t tbca_l;		/**<Tx Broadcast */
186 	uint32_t tbca_u;
187 	uint32_t res0258[2];
188 	uint32_t tpkt_l;		/**<Tx Packet */
189 	uint32_t tpkt_u;
190 	uint32_t tund_l;		/**<Tx Undersized */
191 	uint32_t tund_u;
192 	uint32_t t64_l;
193 	uint32_t t64_u;
194 	uint32_t t127_l;
195 	uint32_t t127_u;
196 	uint32_t t255_l;
197 	uint32_t t255_u;
198 	uint32_t t511_l;
199 	uint32_t t511_u;
200 	uint32_t t1023_l;
201 	uint32_t t1023_u;
202 	uint32_t t1518_l;
203 	uint32_t t1518_u;
204 	uint32_t t1519x_l;
205 	uint32_t t1519x_u;
206 	uint32_t res02a8[6];
207 	uint32_t tcnp_l;		/**<Tx Control Packet type - 0x8808 */
208 	uint32_t tcnp_u;
209 	uint32_t res02c8[14];
210 	/* Line Interface Control */
211 	uint32_t if_mode;		/**< 0x300 Interface Mode Control */
212 	uint32_t if_status;		/**< 0x304 Interface Status */
213 	uint32_t res0308[14];
214 	/* HiGig/2 */
215 	uint32_t hg_config;		/**< 0x340 Control and cfg */
216 	uint32_t res0344[3];
217 	uint32_t hg_pause_quanta;	/**< 0x350 Pause quanta */
218 	uint32_t res0354[3];
219 	uint32_t hg_pause_thresh;	/**< 0x360 Pause quanta threshold */
220 	uint32_t res0364[3];
221 	uint32_t hgrx_pause_status;	/**< 0x370 Receive pause status */
222 	uint32_t hg_fifos_status;	/**< 0x374 fifos status */
223 	uint32_t rhm;			/**< 0x378 rx messages counter */
224 	uint32_t thm;			/**< 0x37C tx messages counter */
225 };
226 
227 struct rx_bmi_regs {
228 	uint32_t fmbm_rcfg;		/**< Rx Configuration */
229 	uint32_t fmbm_rst;		/**< Rx Status */
230 	uint32_t fmbm_rda;		/**< Rx DMA attributes*/
231 	uint32_t fmbm_rfp;		/**< Rx FIFO Parameters*/
232 	uint32_t fmbm_rfed;		/**< Rx Frame End Data*/
233 	uint32_t fmbm_ricp;		/**< Rx Internal Context Parameters*/
234 	uint32_t fmbm_rim;		/**< Rx Internal Buffer Margins*/
235 	uint32_t fmbm_rebm;		/**< Rx External Buffer Margins*/
236 	uint32_t fmbm_rfne;		/**< Rx Frame Next Engine*/
237 	uint32_t fmbm_rfca;		/**< Rx Frame Command Attributes.*/
238 	uint32_t fmbm_rfpne;		/**< Rx Frame Parser Next Engine*/
239 	uint32_t fmbm_rpso;		/**< Rx Parse Start Offset*/
240 	uint32_t fmbm_rpp;		/**< Rx Policer Profile  */
241 	uint32_t fmbm_rccb;		/**< Rx Coarse Classification Base */
242 	uint32_t fmbm_reth;		/**< Rx Excessive Threshold */
243 	uint32_t reserved003c[1];	/**< (0x03C 0x03F) */
244 	uint32_t fmbm_rprai[FMAN_PORT_PRS_RESULT_WORDS_NUM];
245 					/**< Rx Parse Results Array Init*/
246 	uint32_t fmbm_rfqid;		/**< Rx Frame Queue ID*/
247 	uint32_t fmbm_refqid;		/**< Rx Error Frame Queue ID*/
248 	uint32_t fmbm_rfsdm;		/**< Rx Frame Status Discard Mask*/
249 	uint32_t fmbm_rfsem;		/**< Rx Frame Status Error Mask*/
250 	uint32_t fmbm_rfene;		/**< Rx Frame Enqueue Next Engine */
251 	uint32_t reserved0074[0x2];	/**< (0x074-0x07C)  */
252 	uint32_t fmbm_rcmne;
253 	/**< Rx Frame Continuous Mode Next Engine */
254 	uint32_t reserved0080[0x20];/**< (0x080 0x0FF)  */
255 	uint32_t fmbm_ebmpi[FMAN_PORT_MAX_EXT_POOLS_NUM];
256 					/**< Buffer Manager pool Information-*/
257 	uint32_t fmbm_acnt[FMAN_PORT_MAX_EXT_POOLS_NUM];
258 					/**< Allocate Counter-*/
259 	uint32_t reserved0130[8];
260 					/**< 0x130/0x140 - 0x15F reserved -*/
261 	uint32_t fmbm_rcgm[FMAN_PORT_CG_MAP_NUM];
262 					/**< Congestion Group Map*/
263 	uint32_t fmbm_mpd;		/**< BM Pool Depletion  */
264 	uint32_t reserved0184[0x1F];	/**< (0x184 0x1FF) */
265 	uint32_t fmbm_rstc;		/**< Rx Statistics Counters*/
266 	uint32_t fmbm_rfrc;		/**< Rx Frame Counter*/
267 	uint32_t fmbm_rfbc;		/**< Rx Bad Frames Counter*/
268 	uint32_t fmbm_rlfc;		/**< Rx Large Frames Counter*/
269 	uint32_t fmbm_rffc;		/**< Rx Filter Frames Counter*/
270 	uint32_t fmbm_rfdc;		/**< Rx Frame Discard Counter*/
271 	uint32_t fmbm_rfldec;		/**< Rx Frames List DMA Error Counter*/
272 	uint32_t fmbm_rodc;		/**< Rx Out of Buffers Discard nntr*/
273 	uint32_t fmbm_rbdc;		/**< Rx Buffers Deallocate Counter*/
274 	uint32_t reserved0224[0x17];	/**< (0x224 0x27F) */
275 	uint32_t fmbm_rpc;		/**< Rx Performance Counters*/
276 	uint32_t fmbm_rpcp;		/**< Rx Performance Count Parameters*/
277 	uint32_t fmbm_rccn;		/**< Rx Cycle Counter*/
278 	uint32_t fmbm_rtuc;		/**< Rx Tasks Utilization Counter*/
279 	uint32_t fmbm_rrquc;
280 	/**< Rx Receive Queue Utilization cntr*/
281 	uint32_t fmbm_rduc;		/**< Rx DMA Utilization Counter*/
282 	uint32_t fmbm_rfuc;		/**< Rx FIFO Utilization Counter*/
283 	uint32_t fmbm_rpac;		/**< Rx Pause Activation Counter*/
284 	uint32_t reserved02a0[0x18];	/**< (0x2A0 0x2FF) */
285 	uint32_t fmbm_rdbg;		/**< Rx Debug-*/
286 };
287 
288 struct fman_port_qmi_regs {
289 	uint32_t fmqm_pnc;		/**< PortID n Configuration Register */
290 	uint32_t fmqm_pns;		/**< PortID n Status Register */
291 	uint32_t fmqm_pnts;		/**< PortID n Task Status Register */
292 	uint32_t reserved00c[4];	/**< 0xn00C - 0xn01B */
293 	uint32_t fmqm_pnen;		/**< PortID n Enqueue NIA Register */
294 	uint32_t fmqm_pnetfc;		/**< PortID n Enq Total Frame Counter */
295 	uint32_t reserved024[2];	/**< 0xn024 - 0x02B */
296 	uint32_t fmqm_pndn;		/**< PortID n Dequeue NIA Register */
297 	uint32_t fmqm_pndc;		/**< PortID n Dequeue Config Register */
298 	uint32_t fmqm_pndtfc;		/**< PortID n Dequeue tot Frame cntr */
299 	uint32_t fmqm_pndfdc;		/**< PortID n Dequeue FQID Dflt Cntr */
300 	uint32_t fmqm_pndcc;		/**< PortID n Dequeue Confirm Counter */
301 };
302 
303 /* This struct exports parameters about an Fman network interface, determined
304  * from the device-tree.
305  */
306 struct fman_if {
307 	/* Which Fman this interface belongs to */
308 	uint8_t fman_idx;
309 	/* The type/speed of the interface */
310 	enum fman_mac_type mac_type;
311 	/* Boolean, set when mac type is memac */
312 	uint8_t is_memac;
313 	/* Boolean, set when PHY is RGMII */
314 	uint8_t is_rgmii;
315 	/* The index of this MAC (within the Fman it belongs to) */
316 	uint8_t mac_idx;
317 	/* The MAC address */
318 	struct rte_ether_addr mac_addr;
319 	/* The Qman channel to schedule Tx FQs to */
320 	u16 tx_channel_id;
321 	/* The hard-coded FQIDs for this interface. Note: this doesn't cover
322 	 * the PCD nor the "Rx default" FQIDs, which are configured via FMC
323 	 * and its XML-based configuration.
324 	 */
325 	uint32_t fqid_rx_def;
326 	uint32_t fqid_rx_err;
327 	uint32_t fqid_tx_err;
328 	uint32_t fqid_tx_confirm;
329 
330 	struct list_head bpool_list;
331 	/* The node for linking this interface into "fman_if_list" */
332 	struct list_head node;
333 };
334 
335 /* This struct exposes parameters for buffer pools, extracted from the network
336  * interface settings in the device tree.
337  */
338 struct fman_if_bpool {
339 	uint32_t bpid;
340 	uint64_t count;
341 	uint64_t size;
342 	uint64_t addr;
343 	/* The node for linking this bpool into fman_if::bpool_list */
344 	struct list_head node;
345 };
346 
347 /* Internal Context transfer params - FMBM_RICP*/
348 struct fman_if_ic_params {
349 	/*IC offset in the packet buffer */
350 	uint16_t iceof;
351 	/*IC internal offset */
352 	uint16_t iciof;
353 	/*IC size to copy */
354 	uint16_t icsz;
355 };
356 
357 /* The exported "struct fman_if" type contains the subset of fields we want
358  * exposed. This struct is embedded in a larger "struct __fman_if" which
359  * contains the extra bits we *don't* want exposed.
360  */
361 struct __fman_if {
362 	struct fman_if __if;
363 	char node_path[PATH_MAX];
364 	uint64_t regs_size;
365 	void *ccsr_map;
366 	void *bmi_map;
367 	void *qmi_map;
368 	struct list_head node;
369 };
370 
371 /* And this is the base list node that the interfaces are added to. (See
372  * fman_if_enable_all_rx() below for an example of its use.)
373  */
374 extern const struct list_head *fman_if_list;
375 
376 extern int fman_ccsr_map_fd;
377 
378 /* To iterate the "bpool_list" for an interface. Eg;
379  *        struct fman_if *p = get_ptr_to_some_interface();
380  *        struct fman_if_bpool *bp;
381  *        printf("Interface uses following BPIDs;\n");
382  *        fman_if_for_each_bpool(bp, p) {
383  *            printf("    %d\n", bp->bpid);
384  *            [...]
385  *        }
386  */
387 #define fman_if_for_each_bpool(bp, __if) \
388 	list_for_each_entry(bp, &(__if)->bpool_list, node)
389 
390 #define FMAN_ERR(rc, fmt, args...) \
391 	do { \
392 		_errno = (rc); \
393 		DPAA_BUS_LOG(ERR, fmt "(%d)", ##args, errno); \
394 	} while (0)
395 
396 #define FMAN_IP_REV_1	0xC30C4
397 #define FMAN_IP_REV_1_MAJOR_MASK 0x0000FF00
398 #define FMAN_IP_REV_1_MAJOR_SHIFT 8
399 #define FMAN_V3	0x06
400 #define FMAN_V3_CONTEXTA_EN_A2V	0x10000000
401 #define FMAN_V3_CONTEXTA_EN_OVOM	0x02000000
402 #define FMAN_V3_CONTEXTA_EN_EBD	0x80000000
403 #define FMAN_CONTEXTA_DIS_CHECKSUM	0x7ull
404 #define FMAN_CONTEXTA_SET_OPCODE11 0x2000000b00000000
405 extern u16 fman_ip_rev;
406 extern u32 fman_dealloc_bufs_mask_hi;
407 extern u32 fman_dealloc_bufs_mask_lo;
408 
409 /**
410  * Initialize the FMAN driver
411  *
412  * @args void
413  * @return
414  *	0 for success; error OTHERWISE
415  */
416 int fman_init(void);
417 
418 /**
419  * Teardown the FMAN driver
420  *
421  * @args void
422  * @return void
423  */
424 void fman_finish(void);
425 
426 #endif	/* __FMAN_H */
427