123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186 |
- /*
- * Copyright (c) 2012 The Linux Foundation. All rights reserved.
- *
- * Previously licensed under the ISC license by Qualcomm Atheros, Inc.
- *
- *
- * Permission to use, copy, modify, and/or distribute this software for
- * any purpose with or without fee is hereby granted, provided that the
- * above copyright notice and this permission notice appear in all
- * copies.
- *
- * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
- * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
- * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
- * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
- * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
- * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- * PERFORMANCE OF THIS SOFTWARE.
- */
- /*
- * This file was originally distributed by Qualcomm Atheros, Inc.
- * under proprietary terms before Copyright ownership was assigned
- * to the Linux Foundation.
- */
- /**
- * @file ol_fw_tx_dbg.h
- *
- * @details data structs used for uploading summary info about the FW's tx
- */
- #ifndef _OL_FW_TX_DBG__H_
- #define _OL_FW_TX_DBG__H_
- /*
- * Undef ATH_SUPPORT_FW_TX_DBG to remove the FW tx debug feature.
- * Removing the FW tx debug feature saves a modest amount of program memory.
- * The data memory allocation for the FW tx debug feature is controlled
- * by the host --> target resource configuration parameters; even if
- * ATH_SUPPORT_FW_TX_DBG is defined, no data memory will be allocated for
- * the FW tx debug log unless the host --> target resource configuration
- * specifies it.
- */
- #define ATH_SUPPORT_FW_TX_DBG 1 /* enabled */
- //#undef ATH_SUPPORT_FW_TX_DBG /* disabled */
- #if defined(ATH_TARGET)
- #include <osapi.h> /* A_UINT32 */
- #else
- #include <a_types.h> /* A_UINT32 */
- #include <a_osapi.h> /* PREPACK, POSTPACK */
- #endif
- enum ol_fw_tx_dbg_log_mode {
- ol_fw_tx_dbg_log_mode_wraparound, /* overwrite old data with new */
- ol_fw_tx_dbg_log_mode_single, /* fill log once, then stop */
- };
- /*
- * tx PPDU stats upload message header
- */
- struct ol_fw_tx_dbg_ppdu_msg_hdr {
- /* word 0 */
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_BYTES_WORD 0
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_BYTES_S 0
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_BYTES_M 0x000000ff
- A_UINT8 mpdu_bytes_array_len; /* length of array of per-MPDU byte counts */
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MSDU_BYTES_WORD 0
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MSDU_BYTES_S 8
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MSDU_BYTES_M 0x0000ff00
- A_UINT8 msdu_bytes_array_len; /* length of array of per-MSDU byte counts */
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_MSDUS_WORD 0
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_MSDUS_S 16
- #define OL_FW_TX_DBG_PPDU_HDR_NUM_MPDU_MSDUS_M 0x00ff0000
- A_UINT8 mpdu_msdus_array_len; /* length of array of per-MPDU MSDU counts */
- A_UINT8 reserved;
- /* word 1 */
- #define OL_FW_TX_DBG_PPDU_HDR_MICROSEC_PER_TICK_WORD 1
- #define OL_FW_TX_DBG_PPDU_HDR_MICROSEC_PER_TICK_S 0
- #define OL_FW_TX_DBG_PPDU_HDR_MICROSEC_PER_TICK_M 0xffffffff
- A_UINT32 microsec_per_tick; /* conversion for timestamp entries */
- };
- /*
- * tx PPDU log element / stats upload message element
- */
- struct ol_fw_tx_dbg_ppdu_base {
- /* word 0 - filled in during tx enqueue */
- #define OL_FW_TX_DBG_PPDU_START_SEQ_NUM_WORD 0
- #define OL_FW_TX_DBG_PPDU_START_SEQ_NUM_S 0
- #define OL_FW_TX_DBG_PPDU_START_SEQ_NUM_M 0x0000ffff
- A_UINT16 start_seq_num;
- #define OL_FW_TX_DBG_PPDU_START_PN_LSBS_WORD 0
- #define OL_FW_TX_DBG_PPDU_START_PN_LSBS_S 16
- #define OL_FW_TX_DBG_PPDU_START_PN_LSBS_M 0xffff0000
- A_UINT16 start_pn_lsbs;
- /* word 1 - filled in during tx enqueue */
- #define OL_FW_TX_DBG_PPDU_NUM_BYTES_WORD 1
- #define OL_FW_TX_DBG_PPDU_NUM_BYTES_S 0
- #define OL_FW_TX_DBG_PPDU_NUM_BYTES_M 0xffffffff
- A_UINT32 num_bytes;
- /* word 2 - filled in during tx enqueue */
- #define OL_FW_TX_DBG_PPDU_NUM_MSDUS_WORD 2
- #define OL_FW_TX_DBG_PPDU_NUM_MSDUS_S 0
- #define OL_FW_TX_DBG_PPDU_NUM_MSDUS_M 0x000000ff
- A_UINT8 num_msdus;
- #define OL_FW_TX_DBG_PPDU_NUM_MPDUS_WORD 2
- #define OL_FW_TX_DBG_PPDU_NUM_MPDUS_S 8
- #define OL_FW_TX_DBG_PPDU_NUM_MPDUS_M 0x0000ff00
- A_UINT8 num_mpdus;
- A_UINT16
- #define OL_FW_TX_DBG_PPDU_EXT_TID_WORD 2
- #define OL_FW_TX_DBG_PPDU_EXT_TID_S 16
- #define OL_FW_TX_DBG_PPDU_EXT_TID_M 0x001f0000
- ext_tid : 5,
- #define OL_FW_TX_DBG_PPDU_PEER_ID_WORD 2
- #define OL_FW_TX_DBG_PPDU_PEER_ID_S 21
- #define OL_FW_TX_DBG_PPDU_PEER_ID_M 0xffe00000
- peer_id : 11;
- /* word 3 - filled in during tx enqueue */
- #define OL_FW_TX_DBG_PPDU_TIME_ENQUEUE_WORD 3
- #define OL_FW_TX_DBG_PPDU_TIME_ENQUEUE_S 0
- #define OL_FW_TX_DBG_PPDU_TIME_ENQUEUE_M 0xffffffff
- A_UINT32 timestamp_enqueue;
- /* word 4 - filled in during tx completion */
- #define OL_FW_TX_DBG_PPDU_TIME_COMPL_WORD 4
- #define OL_FW_TX_DBG_PPDU_TIME_COMPL_S 0
- #define OL_FW_TX_DBG_PPDU_TIME_COMPL_M 0xffffffff
- A_UINT32 timestamp_completion;
- /* word 5 - filled in during tx completion */
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_LSBS_WORD 5
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_LSBS_S 0
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_LSBS_M 0xffffffff
- A_UINT32 block_ack_bitmap_lsbs;
- /* word 6 - filled in during tx completion */
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_MSBS_WORD 6
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_MSBS_S 0
- #define OL_FW_TX_DBG_PPDU_BLOCK_ACK_MSBS_M 0xffffffff
- A_UINT32 block_ack_bitmap_msbs;
- /* word 7 - filled in during tx completion (enqueue would work too) */
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_LSBS_WORD 7
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_LSBS_S 0
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_LSBS_M 0xffffffff
- A_UINT32 enqueued_bitmap_lsbs;
- /* word 8 - filled in during tx completion (enqueue would work too) */
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_MSBS_WORD 8
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_MSBS_S 0
- #define OL_FW_TX_DBG_PPDU_ENQUEUED_MSBS_M 0xffffffff
- A_UINT32 enqueued_bitmap_msbs;
- /* word 9 - filled in during tx completion */
- #define OL_FW_TX_DBG_PPDU_RATE_CODE_WORD 9
- #define OL_FW_TX_DBG_PPDU_RATE_CODE_S 0
- #define OL_FW_TX_DBG_PPDU_RATE_CODE_M 0x000000ff
- A_UINT8 rate_code;
- #define OL_FW_TX_DBG_PPDU_RATE_FLAGS_WORD 9
- #define OL_FW_TX_DBG_PPDU_RATE_FLAGS_S 8
- #define OL_FW_TX_DBG_PPDU_RATE_FLAGS_M 0x0000ff00
- A_UINT8 rate_flags; /* includes dynamic bandwidth info */
- #define OL_FW_TX_DBG_PPDU_TRIES_WORD 9
- #define OL_FW_TX_DBG_PPDU_TRIES_S 16
- #define OL_FW_TX_DBG_PPDU_TRIES_M 0x00ff0000
- A_UINT8 tries;
- #define OL_FW_TX_DBG_PPDU_COMPLETE_WORD 9
- #define OL_FW_TX_DBG_PPDU_COMPLETE_S 24
- #define OL_FW_TX_DBG_PPDU_COMPLETE_M 0xff000000
- A_UINT8 complete;
- };
- #endif /* _OL_FW_TX_DBG__H_ */
|