1 /***********************license start***************
2 * Author: Cavium Networks
4 * Contact: support@caviumnetworks.com
5 * This file is part of the OCTEON SDK
7 * Copyright (c) 2003-2008 Cavium Networks
9 * This file is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License, Version 2, as
11 * published by the Free Software Foundation.
13 * This file is distributed in the hope that it will be useful, but
14 * AS-IS and WITHOUT ANY WARRANTY; without even the implied warranty
15 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, TITLE, or
16 * NONINFRINGEMENT. See the GNU General Public License for more
19 * You should have received a copy of the GNU General Public License
20 * along with this file; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22 * or visit http://www.gnu.org/licenses/.
24 * This file may also be available under a different license from Cavium.
25 * Contact Cavium Networks for more information
26 ***********************license end**************************************/
29 * Interface to the hardware Packet Input Processing unit.
33 #ifndef __CVMX_PIP_H__
34 #define __CVMX_PIP_H__
38 #include "cvmx-pip-defs.h"
40 #define CVMX_PIP_NUM_INPUT_PORTS 40
41 #define CVMX_PIP_NUM_WATCHERS 4
44 * Encodes the different error and exception codes
47 CVMX_PIP_L4_NO_ERR
= 0ull,
49 * 1 = TCP (UDP) packet not long enough to cover TCP (UDP)
52 CVMX_PIP_L4_MAL_ERR
= 1ull,
53 /* 2 = TCP/UDP checksum failure */
54 CVMX_PIP_CHK_ERR
= 2ull,
56 * 3 = TCP/UDP length check (TCP/UDP length does not match IP
59 CVMX_PIP_L4_LENGTH_ERR
= 3ull,
60 /* 4 = illegal TCP/UDP port (either source or dest port is zero) */
61 CVMX_PIP_BAD_PRT_ERR
= 4ull,
62 /* 8 = TCP flags = FIN only */
63 CVMX_PIP_TCP_FLG8_ERR
= 8ull,
64 /* 9 = TCP flags = 0 */
65 CVMX_PIP_TCP_FLG9_ERR
= 9ull,
66 /* 10 = TCP flags = FIN+RST+* */
67 CVMX_PIP_TCP_FLG10_ERR
= 10ull,
68 /* 11 = TCP flags = SYN+URG+* */
69 CVMX_PIP_TCP_FLG11_ERR
= 11ull,
70 /* 12 = TCP flags = SYN+RST+* */
71 CVMX_PIP_TCP_FLG12_ERR
= 12ull,
72 /* 13 = TCP flags = SYN+FIN+* */
73 CVMX_PIP_TCP_FLG13_ERR
= 13ull
78 CVMX_PIP_IP_NO_ERR
= 0ull,
79 /* 1 = not IPv4 or IPv6 */
80 CVMX_PIP_NOT_IP
= 1ull,
81 /* 2 = IPv4 header checksum violation */
82 CVMX_PIP_IPV4_HDR_CHK
= 2ull,
83 /* 3 = malformed (packet not long enough to cover IP hdr) */
84 CVMX_PIP_IP_MAL_HDR
= 3ull,
85 /* 4 = malformed (packet not long enough to cover len in IP hdr) */
86 CVMX_PIP_IP_MAL_PKT
= 4ull,
87 /* 5 = TTL / hop count equal zero */
88 CVMX_PIP_TTL_HOP
= 5ull,
89 /* 6 = IPv4 options / IPv6 early extension headers */
95 * late collision (data received before collision)
96 * late collisions cannot be detected by the receiver
97 * they would appear as JAM bits which would appear as bad FCS
98 * or carrier extend error which is CVMX_PIP_EXTEND_ERR
102 CVMX_PIP_RX_NO_ERR
= 0ull,
103 /* RGM+SPI 1 = partially received packet (buffering/bandwidth
105 CVMX_PIP_PARTIAL_ERR
= 1ull,
106 /* RGM+SPI 2 = receive packet too large and truncated */
107 CVMX_PIP_JABBER_ERR
= 2ull,
109 * RGM 3 = max frame error (pkt len > max frame len) (with FCS
112 CVMX_PIP_OVER_FCS_ERR
= 3ull,
113 /* RGM+SPI 4 = max frame error (pkt len > max frame len) */
114 CVMX_PIP_OVER_ERR
= 4ull,
116 * RGM 5 = nibble error (data not byte multiple - 100M and 10M
119 CVMX_PIP_ALIGN_ERR
= 5ull,
121 * RGM 6 = min frame error (pkt len < min frame len) (with FCS
124 CVMX_PIP_UNDER_FCS_ERR
= 6ull,
125 /* RGM 7 = FCS error */
126 CVMX_PIP_GMX_FCS_ERR
= 7ull,
127 /* RGM+SPI 8 = min frame error (pkt len < min frame len) */
128 CVMX_PIP_UNDER_ERR
= 8ull,
129 /* RGM 9 = Frame carrier extend error */
130 CVMX_PIP_EXTEND_ERR
= 9ull,
132 * RGM 10 = length mismatch (len did not match len in L2
135 CVMX_PIP_LENGTH_ERR
= 10ull,
136 /* RGM 11 = Frame error (some or all data bits marked err) */
137 CVMX_PIP_DAT_ERR
= 11ull,
138 /* SPI 11 = DIP4 error */
139 CVMX_PIP_DIP_ERR
= 11ull,
141 * RGM 12 = packet was not large enough to pass the skipper -
142 * no inspection could occur.
144 CVMX_PIP_SKIP_ERR
= 12ull,
146 * RGM 13 = studder error (data not repeated - 100M and 10M
149 CVMX_PIP_NIBBLE_ERR
= 13ull,
150 /* RGM+SPI 16 = FCS error */
151 CVMX_PIP_PIP_FCS
= 16L,
153 * RGM+SPI+PCI 17 = packet was not large enough to pass the
154 * skipper - no inspection could occur.
156 CVMX_PIP_PIP_SKIP_ERR
= 17L,
158 * RGM+SPI+PCI 18 = malformed l2 (packet not long enough to
161 CVMX_PIP_PIP_L2_MAL_HDR
= 18L
163 * NOTES: xx = late collision (data received before collision)
164 * late collisions cannot be detected by the receiver
165 * they would appear as JAM bits which would appear as
166 * bad FCS or carrier extend error which is
167 * CVMX_PIP_EXTEND_ERR
169 } cvmx_pip_rcv_err_t
;
172 * This defines the err_code field errors in the work Q entry
175 cvmx_pip_l4_err_t l4_err
;
176 cvmx_pip_ip_exc_t ip_exc
;
177 cvmx_pip_rcv_err_t rcv_err
;
181 * Status statistics for a port
184 /* Inbound octets marked to be dropped by the IPD */
185 uint32_t dropped_octets
;
186 /* Inbound packets marked to be dropped by the IPD */
187 uint32_t dropped_packets
;
188 /* RAW PCI Packets received by PIP per port */
189 uint32_t pci_raw_packets
;
190 /* Number of octets processed by PIP */
192 /* Number of packets processed by PIP */
195 * Number of indentified L2 multicast packets. Does not
196 * include broadcast packets. Only includes packets whose
197 * parse mode is SKIP_TO_L2
199 uint32_t multicast_packets
;
201 * Number of indentified L2 broadcast packets. Does not
202 * include multicast packets. Only includes packets whose
203 * parse mode is SKIP_TO_L2
205 uint32_t broadcast_packets
;
206 /* Number of 64B packets */
207 uint32_t len_64_packets
;
208 /* Number of 65-127B packets */
209 uint32_t len_65_127_packets
;
210 /* Number of 128-255B packets */
211 uint32_t len_128_255_packets
;
212 /* Number of 256-511B packets */
213 uint32_t len_256_511_packets
;
214 /* Number of 512-1023B packets */
215 uint32_t len_512_1023_packets
;
216 /* Number of 1024-1518B packets */
217 uint32_t len_1024_1518_packets
;
218 /* Number of 1519-max packets */
219 uint32_t len_1519_max_packets
;
220 /* Number of packets with FCS or Align opcode errors */
221 uint32_t fcs_align_err_packets
;
222 /* Number of packets with length < min */
223 uint32_t runt_packets
;
224 /* Number of packets with length < min and FCS error */
225 uint32_t runt_crc_packets
;
226 /* Number of packets with length > max */
227 uint32_t oversize_packets
;
228 /* Number of packets with length > max and FCS error */
229 uint32_t oversize_crc_packets
;
230 /* Number of packets without GMX/SPX/PCI errors received by PIP */
231 uint32_t inb_packets
;
233 * Total number of octets from all packets received by PIP,
237 /* Number of packets with GMX/SPX/PCI errors received by PIP */
239 } cvmx_pip_port_status_t
;
242 * Definition of the PIP custom header that can be prepended
243 * to a packet by external hardware.
249 * Documented as R - Set if the Packet is RAWFULL. If
250 * set, this header must be the full 8 bytes.
254 uint64_t reserved0
:5;
255 /* PIP parse mode for this packet */
256 uint64_t parse_mode
:2;
258 uint64_t reserved1
:1;
260 * Skip amount, including this header, to the
261 * beginning of the packet
265 uint64_t reserved2
:6;
266 /* POW input queue for this packet */
268 /* POW input group for this packet */
271 * Flag to store this packet in the work queue entry,
275 /* POW input tag type */
280 } cvmx_pip_pkt_inst_hdr_t
;
282 /* CSR typedefs have been moved to cvmx-csr-*.h */
285 * Configure an ethernet input port
287 * @port_num: Port number to configure
288 * @port_cfg: Port hardware configuration
290 * Port POW tagging configuration
292 static inline void cvmx_pip_config_port(uint64_t port_num
,
293 union cvmx_pip_prt_cfgx port_cfg
,
294 union cvmx_pip_prt_tagx port_tag_cfg
)
296 cvmx_write_csr(CVMX_PIP_PRT_CFGX(port_num
), port_cfg
.u64
);
297 cvmx_write_csr(CVMX_PIP_PRT_TAGX(port_num
), port_tag_cfg
.u64
);
301 * @deprecated This function is a thin wrapper around the Pass1 version
302 * of the CVMX_PIP_QOS_WATCHX CSR; Pass2 has added a field for
303 * setting the group that is incompatible with this function,
304 * the preferred upgrade path is to use the CSR directly.
306 * Configure the global QoS packet watchers. Each watcher is
307 * capable of matching a field in a packet to determine the
308 * QoS queue for scheduling.
310 * @watcher: Watcher number to configure (0 - 3).
311 * @match_type: Watcher match type
313 * Value the watcher will match against
314 * @qos: QoS queue for packets matching this watcher
316 static inline void cvmx_pip_config_watcher(uint64_t watcher
,
317 cvmx_pip_qos_watch_types match_type
,
318 uint64_t match_value
, uint64_t qos
)
320 cvmx_pip_port_watcher_cfg_t watcher_config
;
322 watcher_config
.u64
= 0;
323 watcher_config
.s
.match_type
= match_type
;
324 watcher_config
.s
.match_value
= match_value
;
325 watcher_config
.s
.qos
= qos
;
327 cvmx_write_csr(CVMX_PIP_QOS_WATCHX(watcher
), watcher_config
.u64
);
331 * Configure the VLAN priority to QoS queue mapping.
334 * VLAN priority (0-7)
335 * @qos: QoS queue for packets matching this watcher
337 static inline void cvmx_pip_config_vlan_qos(uint64_t vlan_priority
,
340 union cvmx_pip_qos_vlanx pip_qos_vlanx
;
341 pip_qos_vlanx
.u64
= 0;
342 pip_qos_vlanx
.s
.qos
= qos
;
343 cvmx_write_csr(CVMX_PIP_QOS_VLANX(vlan_priority
), pip_qos_vlanx
.u64
);
347 * Configure the Diffserv to QoS queue mapping.
349 * @diffserv: Diffserv field value (0-63)
350 * @qos: QoS queue for packets matching this watcher
352 static inline void cvmx_pip_config_diffserv_qos(uint64_t diffserv
, uint64_t qos
)
354 union cvmx_pip_qos_diffx pip_qos_diffx
;
355 pip_qos_diffx
.u64
= 0;
356 pip_qos_diffx
.s
.qos
= qos
;
357 cvmx_write_csr(CVMX_PIP_QOS_DIFFX(diffserv
), pip_qos_diffx
.u64
);
361 * Get the status counters for a port.
363 * @port_num: Port number to get statistics for.
364 * @clear: Set to 1 to clear the counters after they are read
365 * @status: Where to put the results.
367 static inline void cvmx_pip_get_port_status(uint64_t port_num
, uint64_t clear
,
368 cvmx_pip_port_status_t
*status
)
370 union cvmx_pip_stat_ctl pip_stat_ctl
;
371 union cvmx_pip_stat0_prtx stat0
;
372 union cvmx_pip_stat1_prtx stat1
;
373 union cvmx_pip_stat2_prtx stat2
;
374 union cvmx_pip_stat3_prtx stat3
;
375 union cvmx_pip_stat4_prtx stat4
;
376 union cvmx_pip_stat5_prtx stat5
;
377 union cvmx_pip_stat6_prtx stat6
;
378 union cvmx_pip_stat7_prtx stat7
;
379 union cvmx_pip_stat8_prtx stat8
;
380 union cvmx_pip_stat9_prtx stat9
;
381 union cvmx_pip_stat_inb_pktsx pip_stat_inb_pktsx
;
382 union cvmx_pip_stat_inb_octsx pip_stat_inb_octsx
;
383 union cvmx_pip_stat_inb_errsx pip_stat_inb_errsx
;
385 pip_stat_ctl
.u64
= 0;
386 pip_stat_ctl
.s
.rdclr
= clear
;
387 cvmx_write_csr(CVMX_PIP_STAT_CTL
, pip_stat_ctl
.u64
);
389 stat0
.u64
= cvmx_read_csr(CVMX_PIP_STAT0_PRTX(port_num
));
390 stat1
.u64
= cvmx_read_csr(CVMX_PIP_STAT1_PRTX(port_num
));
391 stat2
.u64
= cvmx_read_csr(CVMX_PIP_STAT2_PRTX(port_num
));
392 stat3
.u64
= cvmx_read_csr(CVMX_PIP_STAT3_PRTX(port_num
));
393 stat4
.u64
= cvmx_read_csr(CVMX_PIP_STAT4_PRTX(port_num
));
394 stat5
.u64
= cvmx_read_csr(CVMX_PIP_STAT5_PRTX(port_num
));
395 stat6
.u64
= cvmx_read_csr(CVMX_PIP_STAT6_PRTX(port_num
));
396 stat7
.u64
= cvmx_read_csr(CVMX_PIP_STAT7_PRTX(port_num
));
397 stat8
.u64
= cvmx_read_csr(CVMX_PIP_STAT8_PRTX(port_num
));
398 stat9
.u64
= cvmx_read_csr(CVMX_PIP_STAT9_PRTX(port_num
));
399 pip_stat_inb_pktsx
.u64
=
400 cvmx_read_csr(CVMX_PIP_STAT_INB_PKTSX(port_num
));
401 pip_stat_inb_octsx
.u64
=
402 cvmx_read_csr(CVMX_PIP_STAT_INB_OCTSX(port_num
));
403 pip_stat_inb_errsx
.u64
=
404 cvmx_read_csr(CVMX_PIP_STAT_INB_ERRSX(port_num
));
406 status
->dropped_octets
= stat0
.s
.drp_octs
;
407 status
->dropped_packets
= stat0
.s
.drp_pkts
;
408 status
->octets
= stat1
.s
.octs
;
409 status
->pci_raw_packets
= stat2
.s
.raw
;
410 status
->packets
= stat2
.s
.pkts
;
411 status
->multicast_packets
= stat3
.s
.mcst
;
412 status
->broadcast_packets
= stat3
.s
.bcst
;
413 status
->len_64_packets
= stat4
.s
.h64
;
414 status
->len_65_127_packets
= stat4
.s
.h65to127
;
415 status
->len_128_255_packets
= stat5
.s
.h128to255
;
416 status
->len_256_511_packets
= stat5
.s
.h256to511
;
417 status
->len_512_1023_packets
= stat6
.s
.h512to1023
;
418 status
->len_1024_1518_packets
= stat6
.s
.h1024to1518
;
419 status
->len_1519_max_packets
= stat7
.s
.h1519
;
420 status
->fcs_align_err_packets
= stat7
.s
.fcs
;
421 status
->runt_packets
= stat8
.s
.undersz
;
422 status
->runt_crc_packets
= stat8
.s
.frag
;
423 status
->oversize_packets
= stat9
.s
.oversz
;
424 status
->oversize_crc_packets
= stat9
.s
.jabber
;
425 status
->inb_packets
= pip_stat_inb_pktsx
.s
.pkts
;
426 status
->inb_octets
= pip_stat_inb_octsx
.s
.octs
;
427 status
->inb_errors
= pip_stat_inb_errsx
.s
.errs
;
429 if (cvmx_octeon_is_pass1()) {
431 * Kludge to fix Octeon Pass 1 errata - Drop counts
434 if (status
->inb_packets
> status
->packets
)
435 status
->dropped_packets
=
436 status
->inb_packets
- status
->packets
;
438 status
->dropped_packets
= 0;
439 if (status
->inb_octets
- status
->inb_packets
* 4 >
441 status
->dropped_octets
=
442 status
->inb_octets
- status
->inb_packets
* 4 -
445 status
->dropped_octets
= 0;
450 * Configure the hardware CRC engine
452 * @interface: Interface to configure (0 or 1)
454 * Invert the result of the CRC
456 * @initialization_vector:
457 * CRC initialization vector
459 static inline void cvmx_pip_config_crc(uint64_t interface
,
460 uint64_t invert_result
, uint64_t reflect
,
461 uint32_t initialization_vector
)
463 if (OCTEON_IS_MODEL(OCTEON_CN38XX
) || OCTEON_IS_MODEL(OCTEON_CN58XX
)) {
464 union cvmx_pip_crc_ctlx config
;
465 union cvmx_pip_crc_ivx pip_crc_ivx
;
468 config
.s
.invres
= invert_result
;
469 config
.s
.reflect
= reflect
;
470 cvmx_write_csr(CVMX_PIP_CRC_CTLX(interface
), config
.u64
);
473 pip_crc_ivx
.s
.iv
= initialization_vector
;
474 cvmx_write_csr(CVMX_PIP_CRC_IVX(interface
), pip_crc_ivx
.u64
);
479 * Clear all bits in a tag mask. This should be called on
480 * startup before any calls to cvmx_pip_tag_mask_set. Each bit
481 * set in the final mask represent a byte used in the packet for
484 * @mask_index: Which tag mask to clear (0..3)
486 static inline void cvmx_pip_tag_mask_clear(uint64_t mask_index
)
489 union cvmx_pip_tag_incx pip_tag_incx
;
490 pip_tag_incx
.u64
= 0;
491 pip_tag_incx
.s
.en
= 0;
492 for (index
= mask_index
* 16; index
< (mask_index
+ 1) * 16; index
++)
493 cvmx_write_csr(CVMX_PIP_TAG_INCX(index
), pip_tag_incx
.u64
);
497 * Sets a range of bits in the tag mask. The tag mask is used
498 * when the cvmx_pip_port_tag_cfg_t tag_mode is non zero.
499 * There are four separate masks that can be configured.
501 * @mask_index: Which tag mask to modify (0..3)
502 * @offset: Offset into the bitmask to set bits at. Use the GCC macro
503 * offsetof() to determine the offsets into packet headers.
504 * For example, offsetof(ethhdr, protocol) returns the offset
505 * of the ethernet protocol field. The bitmask selects which
506 * bytes to include the the tag, with bit offset X selecting
507 * byte at offset X from the beginning of the packet data.
508 * @len: Number of bytes to include. Usually this is the sizeof()
511 static inline void cvmx_pip_tag_mask_set(uint64_t mask_index
, uint64_t offset
,
515 union cvmx_pip_tag_incx pip_tag_incx
;
516 uint64_t index
= mask_index
* 16 + offset
/ 8;
517 pip_tag_incx
.u64
= cvmx_read_csr(CVMX_PIP_TAG_INCX(index
));
518 pip_tag_incx
.s
.en
|= 0x80 >> (offset
& 0x7);
519 cvmx_write_csr(CVMX_PIP_TAG_INCX(index
), pip_tag_incx
.u64
);
524 #endif /* __CVMX_PIP_H__ */