/space/home/slher/rel/Beken/v6_4_5/macsw/ip/lmac/src/tx/txl/txl_agg.h

Go to the documentation of this file.

#ifndef _TXL_AGG_H_
#define _TXL_AGG_H_


/*
 * INCLUDE FILES
 ****************************************************************************************
 */
#include "co_int.h"

// for AC_MAX
#include "mac.h"
// for co_status_t
#include "co_status.h"
// for co_list
#include "co_list.h"
#include "tx_swdesc.h"
#include "ke_event.h"
#include "hal_machw.h"

#include "sta_mgmt.h"

#if NX_AMPDU_TX
/*
 * DEFINES
 ****************************************************************************************
 */
/*
 * TYPE and STRUCT DEFINITIONS
 ****************************************************************************************
 */
struct tx_agg_desc
{
    struct co_list_hdr list_hdr;
    uint16_t status;
    uint16_t available_len;
    uint8_t available_cnt;
    uint8_t sta_idx;
    uint8_t tid;
    uint8_t user_cnt;
    struct tx_hd a_thd;
    struct tx_hd bar_thd;
    struct bar_frame bar_payl;
    struct tx_policy_tbl bar_pol_tbl;
    struct ba_ssc_bitmap *ssc_bitmap;
    struct ba_ssc_bitmap_256 ssc_bitmap_tab;
    #if NX_MAC_HE
    struct tx_policy_tbl pol_tbl;
    struct txdesc *txdesc_last;
    #endif
    #if NX_BW_LEN_ADAPT
    struct txdesc *txdesc[NX_BW_LEN_STEPS - 1];
    #endif
    #if RW_MUMIMO_TX_EN
    struct co_list cfm;
    struct tx_agg_desc *prim_agg_desc;
    struct tx_hd *last_bar_thd;
    uint8_t download;
    #endif
    struct co_list *free_list;
};

/*
 * GLOBAL VARIABLE DECLARATION
 ****************************************************************************************
 */
extern struct co_list tx_agg_desc_pool[];

/*
 * FUNCTION PROTOTYPES
 ****************************************************************************************
 */

__INLINE bool is_mpdu_agg(struct txdesc * txdesc)
{
    return ((txdesc->umac.flags & AMPDU_BIT) == AMPDU_BIT);
}

__INLINE bool is_mpdu_first(struct txdesc *txdesc)
{
    return ((txdesc->umac.flags & WHICHDESC_MSK) == WHICHDESC_AMPDU_FIRST);
}

__INLINE bool is_mpdu_interm(struct txdesc * txdesc)
{
    return ((txdesc->umac.flags & WHICHDESC_MSK) == WHICHDESC_AMPDU_INT);
}

__INLINE bool is_mpdu_last(struct txdesc * txdesc)
{
    return ((txdesc->umac.flags & WHICHDESC_MSK) == WHICHDESC_AMPDU_LAST);
}

__INLINE bool is_mpdu_unpos(struct txdesc * txdesc)
{
    //the definition of Which descriptor with 00 for position may be for the AMPDU THD
    //but we're using the 00 also until MPDU has a position, then for HW the right things
    //will be set in macctrlinfo2
    return ((txdesc->umac.flags & WHICHDESC_MSK) == WHICHDESC_AMPDU_EXTRA);
}

__INLINE void set_mpdu_pos(struct txdesc * txdesc, uint32_t pos)
{
    txdesc->umac.flags = ( txdesc->umac.flags         &
                                 (~(WHICHDESC_MSK & (~AMPDU_BIT))) ) | pos;
}

__INLINE uint16_t txl_mpdu_subframe_len(struct tx_hd *thd)
{
    // Align packet length and add front delimiter length
    return (CO_ALIGN4_HI(thd->frmlen) + DELIMITER_LEN);
}

#if RW_MUMIMO_TX_EN

__INLINE bool is_in_mumimo_ppdu(struct txdesc * txdesc)
{
    struct tx_agg_desc *agg_desc = txdesc->lmac.agg_desc;

    return ((agg_desc != NULL) && (agg_desc->prim_agg_desc != NULL));
}

__INLINE bool is_primary_user(struct txdesc * txdesc)
{
    struct tx_agg_desc *agg_desc = txdesc->lmac.agg_desc;

    return (agg_desc == agg_desc->prim_agg_desc);
}

__INLINE bool is_mumimo_group_id(uint8_t group_id)
{
    return (group_id > 0) && (group_id < 63);
}

__INLINE uint8_t get_group_id(struct txdesc * txdesc)
{
    return (txdesc->host.mumimo_info & 0x3F);
}
#endif

__INLINE uint8_t get_user_pos(struct txdesc * txdesc)
{
    #if RW_MUMIMO_TX_EN
    return (txdesc->host.mumimo_info >> 6);
    #else
    return 0;
    #endif
}

__INLINE struct tx_agg_desc * txl_agg_desc_alloc(uint8_t access_category)
{
    return ((struct tx_agg_desc *)co_list_pop_front(&tx_agg_desc_pool[access_category]));
}

__INLINE void txl_agg_desc_free(struct tx_agg_desc *agg_desc)
{
    //chain back into free pool
    co_list_push_back(agg_desc->free_list, (struct co_list_hdr *)agg_desc);
}

void txl_agg_init(void);

void txl_agg_reset(void);

int txl_agg_push_mpdu(struct txdesc *txdesc, uint8_t ac);

void txl_agg_finish(uint8_t ac);

#if (NX_BW_LEN_ADAPT)

void txl_agg_bw_drop_handle(uint8_t access_category);
#endif

void txl_agg_check(uint8_t access_category);

void txl_agg_set_ampdu_protection(uint32_t *rc);

void txl_agg_check_rtscts_retry_limit(struct tx_hd *a_thd, uint8_t access_category);

void txl_agg_check_saved_agg_desc(uint8_t access_category);

#if RW_MUMIMO_TX_EN

void txl_agg_mumimo_close(uint8_t ac);

void txl_agg_sec_transmit_trigger(void);
#endif // RW_MUMIMO_TX_EN

uint16_t txl_agg_mpdu_nb_delims(struct tx_hd *thd, uint16_t mmss_bytes);

void txl_agg_release(struct tx_agg_desc *agg_desc);

struct tx_hd *txl_agg_change_to_singleton(struct txdesc *txdesc, bool he_tb);

#if NX_MAC_HE

struct tx_hd *txl_agg_set_new_ampdu_head(struct txdesc *txdesc, struct tx_hd **bar_thd);

struct tx_hd *txl_agg_he_tb_prep(struct txdesc *txdesc, struct txdesc **txdesc_next,
                                 uint32_t max_len, uint16_t min_mpdu_len, uint8_t ac);

#endif // NX_MAC_HE

#endif // NX_AMPDU_TX


#endif // _TXL_AGG_H_

---