| /** |
| ****************************************************************************** |
| * |
| * @file rwnx_bfmer.h |
| * |
| * @brief VHT Beamformer function declarations |
| * |
| * Copyright (C) RivieraWaves 2016-2019 |
| * |
| ****************************************************************************** |
| */ |
| |
| #ifndef _RWNX_BFMER_H_ |
| #define _RWNX_BFMER_H_ |
| |
| /** |
| * INCLUDE FILES |
| ****************************************************************************** |
| */ |
| |
| #include "rwnx_defs.h" |
| |
| /** |
| * DEFINES |
| ****************************************************************************** |
| */ |
| |
| /// Maximal supported report length (in bytes) |
| #define RWNX_BFMER_REPORT_MAX_LEN 2048 |
| |
| /// Size of the allocated report space (twice the maximum report length) |
| #define RWNX_BFMER_REPORT_SPACE_SIZE (RWNX_BFMER_REPORT_MAX_LEN * 2) |
| |
| /** |
| * TYPE DEFINITIONS |
| ****************************************************************************** |
| */ |
| |
| /* |
| * Structure used to store a beamforming report. |
| */ |
| struct rwnx_bfmer_report { |
| dma_addr_t dma_addr; /* Virtual address provided to MAC for |
| DMA transfer of the Beamforming Report */ |
| unsigned int length; /* Report Length */ |
| u8 report[1]; /* Report to be used for VHT TX Beamforming */ |
| }; |
| |
| /** |
| * FUNCTION DECLARATIONS |
| ****************************************************************************** |
| */ |
| |
| /** |
| ****************************************************************************** |
| * @brief Allocate memory aiming to contains the Beamforming Report received |
| * from a Beamformee capable capable. |
| * The providing length shall be large enough to contain the VHT Compressed |
| * Beaforming Report and the MU Exclusive part. |
| * It also perform a DMA Mapping providing an address to be provided to the HW |
| * responsible for the DMA transfer of the report. |
| * If successful a struct rwnx_bfmer_report object is allocated, it's address |
| * is stored in rwnx_sta->bfm_report. |
| * |
| * @param[in] rwnx_hw PHY Information |
| * @param[in] rwnx_sta Peer STA Information |
| * @param[in] length Memory size to be allocated |
| * |
| * @return 0 if operation is successful, else -1. |
| ****************************************************************************** |
| */ |
| int rwnx_bfmer_report_add(struct rwnx_hw *rwnx_hw, struct rwnx_sta *rwnx_sta, |
| unsigned int length); |
| |
| /** |
| ****************************************************************************** |
| * @brief Free a previously allocated memory intended to be used for |
| * Beamforming Reports. |
| * |
| * @param[in] rwnx_hw PHY Information |
| * @param[in] rwnx_sta Peer STA Information |
| * |
| ****************************************************************************** |
| */ |
| void rwnx_bfmer_report_del(struct rwnx_hw *rwnx_hw, struct rwnx_sta *rwnx_sta); |
| |
| #ifdef CONFIG_RWNX_FULLMAC |
| /** |
| ****************************************************************************** |
| * @brief Parse a Rx VHT-MCS map in order to deduce the maximum number of |
| * Spatial Streams supported by a beamformee. |
| * |
| * @param[in] vht_capa Received VHT Capability field. |
| * |
| ****************************************************************************** |
| */ |
| u8 rwnx_bfmer_get_rx_nss(const struct ieee80211_vht_cap *vht_capa); |
| #endif /* CONFIG_RWNX_FULLMAC */ |
| |
| #endif /* _RWNX_BFMER_H_ */ |