xref: /wlan-dirver/fw-api/fw/ol_fw_tx_dbg.h (revision 0775ac24dbf6d67941b66e530998fb5c1390298b)

/*
 * 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_ */