4948f4b8d5
Executive is a library that can be used by standalone applications and kernels to abstract access to Octeon SoC and board-specific hardware and facilities. The FreeBSD port to Octeon will be updated to use this where possible.
316 lines
16 KiB
C
316 lines
16 KiB
C
/***********************license start***************
|
|
* Copyright (c) 2003-2008 Cavium Networks (support@cavium.com). All rights
|
|
* reserved.
|
|
*
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are
|
|
* met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* * Redistributions in binary form must reproduce the above
|
|
* copyright notice, this list of conditions and the following
|
|
* disclaimer in the documentation and/or other materials provided
|
|
* with the distribution.
|
|
*
|
|
* * Neither the name of Cavium Networks nor the names of
|
|
* its contributors may be used to endorse or promote products
|
|
* derived from this software without specific prior written
|
|
* permission.
|
|
*
|
|
* TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE SOFTWARE IS PROVIDED "AS IS"
|
|
* AND WITH ALL FAULTS AND CAVIUM NETWORKS MAKES NO PROMISES, REPRESENTATIONS
|
|
* OR WARRANTIES, EITHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, WITH
|
|
* RESPECT TO THE SOFTWARE, INCLUDING ITS CONDITION, ITS CONFORMITY TO ANY
|
|
* REPRESENTATION OR DESCRIPTION, OR THE EXISTENCE OF ANY LATENT OR PATENT
|
|
* DEFECTS, AND CAVIUM SPECIFICALLY DISCLAIMS ALL IMPLIED (IF ANY) WARRANTIES
|
|
* OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR A PARTICULAR
|
|
* PURPOSE, LACK OF VIRUSES, ACCURACY OR COMPLETENESS, QUIET ENJOYMENT, QUIET
|
|
* POSSESSION OR CORRESPONDENCE TO DESCRIPTION. THE ENTIRE RISK ARISING OUT
|
|
* OF USE OR PERFORMANCE OF THE SOFTWARE LIES WITH YOU.
|
|
*
|
|
*
|
|
* For any questions regarding licensing please contact marketing@caviumnetworks.com
|
|
*
|
|
***********************license end**************************************/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
* @file
|
|
*
|
|
* This header file defines the work queue entry (wqe) data structure.
|
|
* Since this is a commonly used structure that depends on structures
|
|
* from several hardware blocks, those definitions have been placed
|
|
* in this file to create a single point of definition of the wqe
|
|
* format.
|
|
* Data structures are still named according to the block that they
|
|
* relate to.
|
|
*
|
|
* This file must not depend on any other header files, except for cvmx.h!!!
|
|
*
|
|
*
|
|
* <hr>$Revision: 41586 $<hr>
|
|
*
|
|
*
|
|
*/
|
|
|
|
|
|
#ifndef __CVMX_WQE_H__
|
|
#define __CVMX_WQE_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define OCT_TAG_TYPE_STRING(x) (((x) == CVMX_POW_TAG_TYPE_ORDERED) ? "ORDERED" : \
|
|
(((x) == CVMX_POW_TAG_TYPE_ATOMIC) ? "ATOMIC" : \
|
|
(((x) == CVMX_POW_TAG_TYPE_NULL) ? "NULL" : \
|
|
"NULL_NULL")))
|
|
|
|
|
|
/**
|
|
* HW decode / err_code in work queue entry
|
|
*/
|
|
typedef union
|
|
{
|
|
uint64_t u64;
|
|
|
|
/** Use this struct if the hardware determines that the packet is IP */
|
|
struct
|
|
{
|
|
uint64_t bufs : 8; /**< HW sets this to the number of buffers used by this packet */
|
|
uint64_t ip_offset : 8; /**< HW sets to the number of L2 bytes prior to the IP */
|
|
uint64_t vlan_valid : 1; /**< set to 1 if we found DSA/VLAN in the L2 */
|
|
uint64_t vlan_stacked : 1; /**< Set to 1 if the DSA/VLAN tag is stacked */
|
|
uint64_t unassigned : 1;
|
|
uint64_t vlan_cfi : 1; /**< HW sets to the DSA/VLAN CFI flag (valid when vlan_valid) */
|
|
uint64_t vlan_id :12; /**< HW sets to the DSA/VLAN_ID field (valid when vlan_valid) */
|
|
uint64_t pr : 4; /**< Ring Identifier (if PCIe). Requires PIP_GBL_CTL[RING_EN]=1 */
|
|
uint64_t unassigned2 : 8;
|
|
uint64_t dec_ipcomp : 1; /**< the packet needs to be decompressed */
|
|
uint64_t tcp_or_udp : 1; /**< the packet is either TCP or UDP */
|
|
uint64_t dec_ipsec : 1; /**< the packet needs to be decrypted (ESP or AH) */
|
|
uint64_t is_v6 : 1; /**< the packet is IPv6 */
|
|
|
|
// (rcv_error, not_IP, IP_exc, is_frag, L4_error, software, etc.)
|
|
|
|
uint64_t software : 1; /**< reserved for software use, hardware will clear on packet creation */
|
|
// exceptional conditions below
|
|
uint64_t L4_error : 1; /**< the receive interface hardware detected an L4 error (only applies if !is_frag)
|
|
(only applies if !rcv_error && !not_IP && !IP_exc && !is_frag)
|
|
failure indicated in err_code below, decode:
|
|
- 1 = Malformed L4
|
|
- 2 = L4 Checksum Error: the L4 checksum value is
|
|
- 3 = UDP Length Error: The UDP length field would make the UDP data longer than what
|
|
remains in the IP packet (as defined by the IP header length field).
|
|
- 4 = Bad L4 Port: either the source or destination TCP/UDP port is 0.
|
|
- 8 = TCP FIN Only: the packet is TCP and only the FIN flag set.
|
|
- 9 = TCP No Flags: the packet is TCP and no flags are set.
|
|
- 10 = TCP FIN RST: the packet is TCP and both FIN and RST are set.
|
|
- 11 = TCP SYN URG: the packet is TCP and both SYN and URG are set.
|
|
- 12 = TCP SYN RST: the packet is TCP and both SYN and RST are set.
|
|
- 13 = TCP SYN FIN: the packet is TCP and both SYN and FIN are set. */
|
|
|
|
|
|
|
|
uint64_t is_frag : 1; /**< set if the packet is a fragment */
|
|
uint64_t IP_exc : 1; /**< the receive interface hardware detected an IP error / exception
|
|
(only applies if !rcv_error && !not_IP) failure indicated in err_code below, decode:
|
|
- 1 = Not IP: the IP version field is neither 4 nor 6.
|
|
- 2 = IPv4 Header Checksum Error: the IPv4 header has a checksum violation.
|
|
- 3 = IP Malformed Header: the packet is not long enough to contain the IP header.
|
|
- 4 = IP Malformed: the packet is not long enough to contain the bytes indicated by the IP
|
|
header. Pad is allowed.
|
|
- 5 = IP TTL Hop: the IPv4 TTL field or the IPv6 Hop Count field are zero.
|
|
- 6 = IP Options */
|
|
|
|
uint64_t is_bcast : 1; /**< set if the hardware determined that the packet is a broadcast */
|
|
uint64_t is_mcast : 1; /**< set if the hardware determined that the packet is a multi-cast */
|
|
uint64_t not_IP : 1; /**< set if the packet may not be IP (must be zero in this case) */
|
|
uint64_t rcv_error : 1; /**< the receive interface hardware detected a receive error (must be zero in this case) */
|
|
/* lower err_code = first-level descriptor of the work */
|
|
/* zero for packet submitted by hardware that isn't on the slow path */
|
|
|
|
uint64_t err_code : 8; /**< type is cvmx_pip_err_t */
|
|
} s;
|
|
|
|
/**< use this to get at the 16 vlan bits */
|
|
struct
|
|
{
|
|
uint64_t unused1 :16;
|
|
uint64_t vlan :16;
|
|
uint64_t unused2 :32;
|
|
} svlan;
|
|
|
|
/**< use this struct if the hardware could not determine that the packet is ip */
|
|
struct
|
|
{
|
|
uint64_t bufs : 8; /**< HW sets this to the number of buffers used by this packet */
|
|
uint64_t unused : 8;
|
|
uint64_t vlan_valid : 1; /**< set to 1 if we found DSA/VLAN in the L2 */
|
|
uint64_t vlan_stacked : 1; /**< Set to 1 if the DSA/VLAN tag is stacked */
|
|
uint64_t unassigned : 1;
|
|
uint64_t vlan_cfi : 1; /**< HW sets to the DSA/VLAN CFI flag (valid when vlan_valid) */
|
|
uint64_t vlan_id :12; /**< HW sets to the DSA/VLAN_ID field (valid when vlan_valid) */
|
|
uint64_t pr : 4; /**< Ring Identifier (if PCIe). Requires PIP_GBL_CTL[RING_EN]=1 */
|
|
uint64_t unassigned2 :12;
|
|
uint64_t software : 1; /**< reserved for software use, hardware will clear on packet creation */
|
|
uint64_t unassigned3 : 1;
|
|
uint64_t is_rarp : 1; /**< set if the hardware determined that the packet is rarp */
|
|
uint64_t is_arp : 1; /**< set if the hardware determined that the packet is arp */
|
|
uint64_t is_bcast : 1; /**< set if the hardware determined that the packet is a broadcast */
|
|
uint64_t is_mcast : 1; /**< set if the hardware determined that the packet is a multi-cast */
|
|
uint64_t not_IP : 1; /**< set if the packet may not be IP (must be one in this case) */
|
|
uint64_t rcv_error : 1; /**< the receive interface hardware detected a receive error.
|
|
Failure indicated in err_code below, decode:
|
|
- 1 = partial error: a packet was partially received, but internal
|
|
buffering / bandwidth was not adequate to receive the entire packet.
|
|
- 2 = jabber error: the RGMII packet was too large and is truncated.
|
|
- 3 = overrun error: the RGMII packet is longer than allowed and had
|
|
an FCS error.
|
|
- 4 = oversize error: the RGMII packet is longer than allowed.
|
|
- 5 = alignment error: the RGMII packet is not an integer number of bytes
|
|
and had an FCS error (100M and 10M only).
|
|
- 6 = fragment error: the RGMII packet is shorter than allowed and had an
|
|
FCS error.
|
|
- 7 = GMX FCS error: the RGMII packet had an FCS error.
|
|
- 8 = undersize error: the RGMII packet is shorter than allowed.
|
|
- 9 = extend error: the RGMII packet had an extend error.
|
|
- 10 = length mismatch error: the RGMII packet had a length that did not
|
|
match the length field in the L2 HDR.
|
|
- 11 = RGMII RX error/SPI4 DIP4 Error: the RGMII packet had one or more
|
|
data reception errors (RXERR) or the SPI4 packet had one or more DIP4
|
|
errors.
|
|
- 12 = RGMII skip error/SPI4 Abort Error: the RGMII packet was not large
|
|
enough to cover the skipped bytes or the SPI4 packet was terminated
|
|
with an About EOPS.
|
|
- 13 = RGMII nibble error/SPI4 Port NXA Error: the RGMII packet had a
|
|
studder error (data not repeated - 10/100M only) or the SPI4 packet
|
|
was sent to an NXA.
|
|
- 16 = FCS error: a SPI4.2 packet had an FCS error.
|
|
- 17 = Skip error: a packet was not large enough to cover the skipped bytes.
|
|
- 18 = L2 header malformed: the packet is not long enough to contain the L2 */
|
|
|
|
|
|
/* lower err_code = first-level descriptor of the work */
|
|
/* zero for packet submitted by hardware that isn't on the slow path */
|
|
uint64_t err_code : 8; // type is cvmx_pip_err_t (union, so can't use directly
|
|
} snoip;
|
|
|
|
} cvmx_pip_wqe_word2;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
* Work queue entry format
|
|
*
|
|
* must be 8-byte aligned
|
|
*/
|
|
typedef struct
|
|
{
|
|
|
|
/*****************************************************************
|
|
* WORD 0
|
|
* HW WRITE: the following 64 bits are filled by HW when a packet arrives
|
|
*/
|
|
|
|
/**
|
|
* raw chksum result generated by the HW
|
|
*/
|
|
uint16_t hw_chksum;
|
|
/**
|
|
* Field unused by hardware - available for software
|
|
*/
|
|
uint8_t unused;
|
|
/**
|
|
* Next pointer used by hardware for list maintenance.
|
|
* May be written/read by HW before the work queue
|
|
* entry is scheduled to a PP
|
|
* (Only 36 bits used in Octeon 1)
|
|
*/
|
|
uint64_t next_ptr : 40;
|
|
|
|
|
|
/*****************************************************************
|
|
* WORD 1
|
|
* HW WRITE: the following 64 bits are filled by HW when a packet arrives
|
|
*/
|
|
|
|
/**
|
|
* HW sets to the total number of bytes in the packet
|
|
*/
|
|
uint64_t len :16;
|
|
/**
|
|
* HW sets this to input physical port
|
|
*/
|
|
uint64_t ipprt : 6;
|
|
|
|
/**
|
|
* HW sets this to what it thought the priority of the input packet was
|
|
*/
|
|
uint64_t qos : 3;
|
|
|
|
/**
|
|
* the group that the work queue entry will be scheduled to
|
|
*/
|
|
uint64_t grp : 4;
|
|
/**
|
|
* the type of the tag (ORDERED, ATOMIC, NULL)
|
|
*/
|
|
cvmx_pow_tag_type_t tag_type : 3;
|
|
/**
|
|
* the synchronization/ordering tag
|
|
*/
|
|
uint64_t tag :32;
|
|
|
|
/**
|
|
* WORD 2
|
|
* HW WRITE: the following 64-bits are filled in by hardware when a packet arrives
|
|
* This indicates a variety of status and error conditions.
|
|
*/
|
|
cvmx_pip_wqe_word2 word2;
|
|
|
|
/**
|
|
* Pointer to the first segment of the packet.
|
|
*/
|
|
cvmx_buf_ptr_t packet_ptr;
|
|
|
|
/**
|
|
* HW WRITE: octeon will fill in a programmable amount from the
|
|
* packet, up to (at most, but perhaps less) the amount
|
|
* needed to fill the work queue entry to 128 bytes
|
|
* If the packet is recognized to be IP, the hardware starts (except that
|
|
* the IPv4 header is padded for appropriate alignment) writing here where
|
|
* the IP header starts.
|
|
* If the packet is not recognized to be IP, the hardware starts writing
|
|
* the beginning of the packet here.
|
|
*/
|
|
uint8_t packet_data[96];
|
|
|
|
|
|
/**
|
|
* If desired, SW can make the work Q entry any length. For the
|
|
* purposes of discussion here, Assume 128B always, as this is all that
|
|
* the hardware deals with.
|
|
*
|
|
*/
|
|
|
|
} CVMX_CACHE_LINE_ALIGNED cvmx_wqe_t;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __CVMX_WQE_H__ */
|