drivers/staging/ath6kl/include/common/epping_test.h

   1 //------------------------------------------------------------------------------
   2 // Copyright (c) 2009-2010 Atheros Corporation.  All rights reserved.
   3 //
   4 //
   5 // Permission to use, copy, modify, and/or distribute this software for any
   6 // purpose with or without fee is hereby granted, provided that the above
   7 // copyright notice and this permission notice appear in all copies.
   8 //
   9 // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 // ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 // ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 // OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 //
  17 //
  18 //------------------------------------------------------------------------------
  19 //==============================================================================
  20 // Author(s): ="Atheros"
  21 //
  22
  23 /* This file contains shared definitions for the host/target endpoint ping test */
  24
  25 #ifndef EPPING_TEST_H_
  26 #define EPPING_TEST_H_
  27
  28 #ifndef ATH_TARGET
  29 #include "athstartpack.h"
  30 #endif
  31
  32     /* alignment to 4-bytes */
  33 #define EPPING_ALIGNMENT_PAD  (((sizeof(HTC_FRAME_HDR) + 3) & (~0x3)) - sizeof(HTC_FRAME_HDR))
  34
  35 #ifndef A_OFFSETOF
  36 #define A_OFFSETOF(type,field) (int)(&(((type *)NULL)->field))
  37 #endif
  38
  39 #define EPPING_RSVD_FILL                  0xCC
  40
  41 #define HCI_RSVD_EXPECTED_PKT_TYPE_RECV_OFFSET  7
  42
  43 typedef PREPACK struct {
  44     A_UINT8     _HCIRsvd[8];           /* reserved for HCI packet header (GMBOX) testing */
  45     A_UINT8     StreamEcho_h;          /* stream no. to echo this packet on (filled by host) */
  46     A_UINT8     StreamEchoSent_t;      /* stream no. packet was echoed to (filled by target)
  47                                           When echoed: StreamEchoSent_t == StreamEcho_h */
  48     A_UINT8     StreamRecv_t;          /* stream no. that target received this packet on (filled by target) */
  49     A_UINT8     StreamNo_h;            /* stream number to send on (filled by host) */
  50     A_UINT8     Magic_h[4];            /* magic number to filter for this packet on the host*/
  51     A_UINT8     _rsvd[6];              /* reserved fields that must be set to a "reserved" value
  52                                           since this packet maps to a 14-byte ethernet frame we want
  53                                           to make sure ethertype field is set to something unknown */
  54
  55     A_UINT8     _pad[2];               /* padding for alignment */
  56     A_UINT8     TimeStamp[8];          /* timestamp of packet (host or target) */
  57     A_UINT32    HostContext_h;         /* 4 byte host context, target echos this back */
  58     A_UINT32    SeqNo;                 /* sequence number (set by host or target) */
  59     A_UINT16    Cmd_h;                 /* ping command (filled by host) */
  60     A_UINT16    CmdFlags_h;            /* optional flags */
  61     A_UINT8     CmdBuffer_h[8];        /* buffer for command (host -> target) */
  62     A_UINT8     CmdBuffer_t[8];        /* buffer for command (target -> host) */
  63     A_UINT16    DataLength;            /* length of data */
  64     A_UINT16    DataCRC;               /* 16 bit CRC of data */
  65     A_UINT16    HeaderCRC;             /* header CRC (fields : StreamNo_h to end, minus HeaderCRC) */
  66 } POSTPACK EPPING_HEADER;
  67
  68 #define EPPING_PING_MAGIC_0               0xAA
  69 #define EPPING_PING_MAGIC_1               0x55
  70 #define EPPING_PING_MAGIC_2               0xCE
  71 #define EPPING_PING_MAGIC_3               0xEC
  72
  73
  74
  75 #define IS_EPPING_PACKET(pPkt)   (((pPkt)->Magic_h[0] == EPPING_PING_MAGIC_0) && \
  76                                   ((pPkt)->Magic_h[1] == EPPING_PING_MAGIC_1) && \
  77                                   ((pPkt)->Magic_h[2] == EPPING_PING_MAGIC_2) && \
  78                                   ((pPkt)->Magic_h[3] == EPPING_PING_MAGIC_3))
  79
  80 #define SET_EPPING_PACKET_MAGIC(pPkt) { (pPkt)->Magic_h[0] = EPPING_PING_MAGIC_0; \
  81                                         (pPkt)->Magic_h[1] = EPPING_PING_MAGIC_1; \
  82                                         (pPkt)->Magic_h[2] = EPPING_PING_MAGIC_2; \
  83                                         (pPkt)->Magic_h[3] = EPPING_PING_MAGIC_3;}
  84
  85 #define CMD_FLAGS_DATA_CRC            (1 << 0)  /* DataCRC field is valid */
  86 #define CMD_FLAGS_DELAY_ECHO          (1 << 1)  /* delay the echo of the packet */
  87 #define CMD_FLAGS_NO_DROP             (1 << 2)  /* do not drop at HTC layer no matter what the stream is */
  88
  89 #define IS_EPING_PACKET_NO_DROP(pPkt)  ((pPkt)->CmdFlags_h & CMD_FLAGS_NO_DROP)
  90
  91 #define EPPING_CMD_ECHO_PACKET          1   /* echo packet test */
  92 #define EPPING_CMD_RESET_RECV_CNT       2   /* reset recv count */
  93 #define EPPING_CMD_CAPTURE_RECV_CNT     3   /* fetch recv count, 4-byte count returned in CmdBuffer_t */
  94 #define EPPING_CMD_NO_ECHO              4   /* non-echo packet test (tx-only) */
  95 #define EPPING_CMD_CONT_RX_START        5   /* continous RX packets, parameters are in CmdBuffer_h */
  96 #define EPPING_CMD_CONT_RX_STOP         6   /* stop continuous RX packet transmission */
  97
  98     /* test command parameters may be no more than 8 bytes */
  99 typedef PREPACK struct {
 100     A_UINT16  BurstCnt;       /* number of packets to burst together (for HTC 2.1 testing) */
 101     A_UINT16  PacketLength;   /* length of packet to generate including header */
 102     A_UINT16  Flags;          /* flags */
 103
 104 #define EPPING_CONT_RX_DATA_CRC     (1 << 0)  /* Add CRC to all data */
 105 #define EPPING_CONT_RX_RANDOM_DATA  (1 << 1)  /* randomize the data pattern */
 106 #define EPPING_CONT_RX_RANDOM_LEN   (1 << 2)  /* randomize the packet lengths */
 107 } POSTPACK EPPING_CONT_RX_PARAMS;
 108
 109 #define EPPING_HDR_CRC_OFFSET    A_OFFSETOF(EPPING_HEADER,StreamNo_h)
 110 #define EPPING_HDR_BYTES_CRC     (sizeof(EPPING_HEADER) - EPPING_HDR_CRC_OFFSET - (sizeof(A_UINT16)))
 111
 112 #define HCI_TRANSPORT_STREAM_NUM  16  /* this number is higher than the define WMM AC classes so we
 113                                          can use this to distinguish packets */
 114
 115 #ifndef ATH_TARGET
 116 #include "athendpack.h"
 117 #endif
 118
 119
 120 #endif /*EPPING_TEST_H_*/