| |
| /* Copyright (c) 2022, Qualcomm Innovation Center, Inc. All rights reserved. |
| * |
| * 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. |
| */ |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| #ifndef _MACTX_VHT_SIG_A_H_ |
| #define _MACTX_VHT_SIG_A_H_ |
| #if !defined(__ASSEMBLER__) |
| #endif |
| |
| #include "vht_sig_a_info.h" |
| #define NUM_OF_DWORDS_MACTX_VHT_SIG_A 2 |
| |
| #define NUM_OF_QWORDS_MACTX_VHT_SIG_A 1 |
| |
| |
| struct mactx_vht_sig_a { |
| #ifndef WIFI_BIT_ORDER_BIG_ENDIAN |
| struct vht_sig_a_info mactx_vht_sig_a_info_details; |
| #else |
| struct vht_sig_a_info mactx_vht_sig_a_info_details; |
| #endif |
| }; |
| |
| |
| /* Description MACTX_VHT_SIG_A_INFO_DETAILS |
| |
| See detailed description of the STRUCT |
| */ |
| |
| |
| /* Description BANDWIDTH |
| |
| Packet bandwidth |
| |
| <enum 0 20_MHZ_11AC> |
| <enum 1 40_MHZ_11AC> |
| <enum 2 80_MHZ_11AC> |
| <enum 3 160_MHZ_11AC> |
| |
| <legal 0-3> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BANDWIDTH_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BANDWIDTH_LSB 0 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BANDWIDTH_MSB 1 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BANDWIDTH_MASK 0x0000000000000003 |
| |
| |
| /* Description VHTA_RESERVED_0 |
| |
| Reserved. Set to 1 by MAC, PHY should ignore |
| <legal 1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0_LSB 2 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0_MSB 2 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0_MASK 0x0000000000000004 |
| |
| |
| /* Description STBC |
| |
| Space time block coding: |
| <enum 0 stbc_disabled> Indicates STBC is disabled |
| <enum 1 stbc_enabled> Indicates STBC is enabled on |
| all streams |
| <legal 0-1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_STBC_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_STBC_LSB 3 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_STBC_MSB 3 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_STBC_MASK 0x0000000000000008 |
| |
| |
| /* Description GROUP_ID |
| |
| In a SU VHT PPDU, if the PPDU carries MPDU(s) addressed |
| to an AP or to a mesh STA, the Group ID field is set to |
| 0, otherwise it is set to 63. In an NDP PPDU the Group |
| ID is set according to IEEE 802.11ac_D1.0 Section 9.30.6 |
| (Transmission of a VHT NDP). For a MU-MIMO PPDU the Group |
| ID is set as in 802.11ac_D1.0 Section 22.3.11.3 (Group |
| ID). <legal all> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GROUP_ID_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GROUP_ID_LSB 4 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GROUP_ID_MSB 9 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GROUP_ID_MASK 0x00000000000003f0 |
| |
| |
| /* Description N_STS |
| |
| For MU: |
| 3 bits/user with maximum of 4 users (user u uses |
| vht_sig_a[0][10+3u] - vht_sig_a[0][12+3u]), u = 0, 1, 2, |
| 3) |
| Set to 0 for 0 space time streams |
| Set to 1 for 1 space time stream |
| Set to 2 for 2 space time streams |
| Set to 3 for 3 space time streams |
| Set to 4 for 4 space time streams (not supported in Wifi |
| 3.0) |
| Values 5-7 are reserved |
| In this field, references to user "u" should be interpreted |
| as MU user "u". As described in the previous chapter in |
| this document (see chapter on User number), the MU user |
| value for a given client is defined for each MU group that |
| the client participates in. The MU user number is not related |
| to the internal user number that is used within the BFer. |
| |
| |
| |
| For SU: |
| vht_sig_a[0][12:10] |
| Set to 0 for 1 space time stream |
| Set to 1 for 2 space time streams |
| Set to 2 for 3 space time streams |
| Set to 3 for 4 space time streams |
| Set to 4 for 5 space time streams |
| Set to 5 for 6 space time streams |
| Set to 6 for 7 space time streams |
| Set to 7 for 8 space time streams |
| |
| vht_sig_a[0][21:13] |
| Partial AID: |
| Set to the value of the TXVECTOR parameter PARTIAL_AID. |
| Partial AID provides an abbreviated indication of the intended |
| recipient(s) of the frame (see IEEE802.11ac_D1.0 Section |
| 9.17a (Partial AID in VHT PPDUs)). |
| <legal all> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_N_STS_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_N_STS_LSB 10 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_N_STS_MSB 21 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_N_STS_MASK 0x00000000003ffc00 |
| |
| |
| /* Description TXOP_PS_NOT_ALLOWED |
| |
| E_num 0 txop_ps_allowed Not supported: If set to by |
| VHT AP if it allows non-AP VHT STAs in TXOP power save |
| mode to enter Doze state during a TXOP |
| <enum 1 no_txop_ps_allowed> Otherwise |
| <legal 1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TXOP_PS_NOT_ALLOWED_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TXOP_PS_NOT_ALLOWED_LSB 22 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TXOP_PS_NOT_ALLOWED_MSB 22 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TXOP_PS_NOT_ALLOWED_MASK 0x0000000000400000 |
| |
| |
| /* Description VHTA_RESERVED_0B |
| |
| Reserved: Should be set to 1 by the MAC and ignored by the |
| PHY <legal 1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0B_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0B_LSB 23 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0B_MSB 23 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_0B_MASK 0x0000000000800000 |
| |
| |
| /* Description RESERVED_0 |
| |
| This field is not part of HT-SIG: |
| Reserved: Should be set to 0 by the MAC and ignored by the |
| PHY <legal 0> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_0_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_0_LSB 24 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_0_MSB 31 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_0_MASK 0x00000000ff000000 |
| |
| |
| /* Description GI_SETTING |
| |
| <enum 0 normal_gi> Indicates short guard interval is |
| not used in the data field |
| <enum 1 short_gi> Indicates short guard interval is |
| used in the data field |
| <enum 3 short_gi_ambiguity> Indicates short guard interval |
| is used in the data field and NSYM mod 10 = 9 |
| NSYM is defined in IEEE802.11ac_D1.0 Section 22.4.3 (TXTIME |
| and PSDU_LENGTH calculation). |
| <legal 0,1,3> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GI_SETTING_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GI_SETTING_LSB 32 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GI_SETTING_MSB 33 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_GI_SETTING_MASK 0x0000000300000000 |
| |
| |
| /* Description SU_MU_CODING |
| |
| For an SU PPDU, B2 is set to 0 for BCC, 1 for LDPC For an |
| MU PPDU, if the MU[0] NSTS field is nonzero(#6773), then |
| B2 indicates the coding used for user 0; set to 0 for BCC |
| and 1 for LDPC. If the MU[0] NSTS field is 0, then this |
| field is reserved and set to 1 |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_SU_MU_CODING_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_SU_MU_CODING_LSB 34 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_SU_MU_CODING_MSB 34 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_SU_MU_CODING_MASK 0x0000000400000000 |
| |
| |
| /* Description LDPC_EXTRA_SYMBOL |
| |
| Set to 1 if the LDPC PPDU encoding process (if an SU PPDU), |
| or at least one LDPC user's PPDU encoding process (if an |
| MU PPDU), results in an extra OFDM symbol (or symbols) |
| as described in 22.3.10.5.4 (LDPC coding) and 22.3.10.5.5 |
| (Encoding process for MU PPDUs). Set to 0 otherwise. |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_LDPC_EXTRA_SYMBOL_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_LDPC_EXTRA_SYMBOL_LSB 35 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_LDPC_EXTRA_SYMBOL_MSB 35 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_LDPC_EXTRA_SYMBOL_MASK 0x0000000800000000 |
| |
| |
| /* Description MCS |
| |
| For SU: |
| Set to 0 for BPSK 1/2 |
| Set to 1 for QPSK 1/2 |
| Set to 2 for QPSK 3/4 |
| Set to 3 for 16-QAM 1/2 |
| Set to 4 for 16-QAM 3/4 |
| Set to 5 for 64-QAM 2/3 |
| Set to 6 for 64-QAM 3/4 |
| Set to 7 for 64-QAM 5/6 |
| Set to 8 for 256-QAM 3/4 |
| Set to 9 for 256-QAM 5/6 |
| For MU: |
| If NSTS for user 1 is non-zero, then vht_sig_a[1][4] indicates |
| coding for user 1: set to 0 for BCC, 1 for LDPC. |
| If NSTS for user 1 is set to 0, then vht_sig_a[1][4] is |
| reserved and set to 1. |
| If NSTS for user 2 is non-zero, then vht_sig_a[1][5] indicates |
| coding for user 2: set to 0 for BCC, 1 for LDPC. |
| If NSTS for user 2 is set to 0, then vht_sig_a[1][5] is |
| reserved and set to 1. |
| If NSTS for user 3 is non-zero, then vht_sig_a[1][6] indicates |
| coding for user 3: set to 0 for BCC, 1 for LDPC. |
| If NSTS for user 3 is set to 0, then vht_sig_a[1][6] is |
| reserved and set to 1. |
| vht_sig_a[1][7] is reserved and set to 1 |
| <legal 0-15> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_MCS_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_MCS_LSB 36 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_MCS_MSB 39 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_MCS_MASK 0x000000f000000000 |
| |
| |
| /* Description BEAMFORMED |
| |
| For SU: |
| Set to 1 if a Beamforming steering matrix is applied to |
| the waveform in an SU transmission as described in IEEE802.11ac_D1.0 |
| Section 19.3.11.11.2 (Spatial mapping), set to 0 otherwise. |
| |
| For MU: |
| Reserved and set to 1 |
| <legal 0-1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BEAMFORMED_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BEAMFORMED_LSB 40 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BEAMFORMED_MSB 40 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_BEAMFORMED_MASK 0x0000010000000000 |
| |
| |
| /* Description VHTA_RESERVED_1 |
| |
| Reserved and set to 1. <legal 1> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_1_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_1_LSB 41 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_1_MSB 41 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_VHTA_RESERVED_1_MASK 0x0000020000000000 |
| |
| |
| /* Description CRC |
| |
| CRC calculated as in IEEE802.11ac_D1.0 Section 19.3.9.4.4 |
| (CRC calculation for HTSIG) with C7 in vht_sig_a[1][10], |
| etc. <legal all> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_CRC_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_CRC_LSB 42 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_CRC_MSB 49 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_CRC_MASK 0x0003fc0000000000 |
| |
| |
| /* Description TAIL |
| |
| Used to terminate the trellis of the convolutional decoder. |
| Set to 0. <legal 0> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TAIL_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TAIL_LSB 50 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TAIL_MSB 55 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_TAIL_MASK 0x00fc000000000000 |
| |
| |
| /* Description RESERVED_1 |
| |
| This field is not part of HT-SIG: |
| Reserved: Should be set to 0 by the MAC and ignored by the |
| PHY <legal 0> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_1_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_1_LSB 56 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_1_MSB 62 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RESERVED_1_MASK 0x7f00000000000000 |
| |
| |
| /* Description RX_INTEGRITY_CHECK_PASSED |
| |
| TX side: Set to 0 |
| RX side: Set to 1 if PHY determines the VHT-SIG-A CRC check |
| has passed, else set to 0 |
| |
| <legal all> |
| */ |
| |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RX_INTEGRITY_CHECK_PASSED_OFFSET 0x0000000000000000 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RX_INTEGRITY_CHECK_PASSED_LSB 63 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RX_INTEGRITY_CHECK_PASSED_MSB 63 |
| #define MACTX_VHT_SIG_A_MACTX_VHT_SIG_A_INFO_DETAILS_RX_INTEGRITY_CHECK_PASSED_MASK 0x8000000000000000 |
| |
| |
| |
| #endif // MACTX_VHT_SIG_A |