macrx_abort_request_info.h 3.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. /* Copyright (c) 2022, Qualcomm Innovation Center, Inc. All rights reserved.
  2. *
  3. * Permission to use, copy, modify, and/or distribute this software for any
  4. * purpose with or without fee is hereby granted, provided that the above
  5. * copyright notice and this permission notice appear in all copies.
  6. *
  7. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  8. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  9. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  10. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  11. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  12. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  13. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  14. */
  15. #ifndef _MACRX_ABORT_REQUEST_INFO_H_
  16. #define _MACRX_ABORT_REQUEST_INFO_H_
  17. #if !defined(__ASSEMBLER__)
  18. #endif
  19. #define NUM_OF_WORDS_MACRX_ABORT_REQUEST_INFO 1
  20. struct macrx_abort_request_info {
  21. #ifndef WIFI_BIT_ORDER_BIG_ENDIAN
  22. uint16_t macrx_abort_reason : 8, // [7:0]
  23. reserved_0 : 8; // [15:8]
  24. #else
  25. uint16_t reserved_0 : 8, // [15:8]
  26. macrx_abort_reason : 8; // [7:0]
  27. #endif
  28. };
  29. /* Description MACRX_ABORT_REASON
  30. <enum 0 macrx_abort_sw_initiated>
  31. <enum 1 macrx_abort_obss_reception> Upon receiving this
  32. abort reason, PHY should stop reception of the current frame
  33. and go back into a search mode
  34. <enum 2 macrx_abort_other>
  35. <enum 3 macrx_abort_sw_initiated_channel_switch> MAC FW
  36. issued an abort for channel switch reasons
  37. <enum 4 macrx_abort_sw_initiated_power_save> MAC FW issued
  38. an abort power save reasons
  39. <enum 5 macrx_abort_too_much_bad_data> RXPCU is terminating
  40. the current ongoing reception, as the data that MAC is
  41. receiving seems to be all garbage... The PER is too high,
  42. or in case of MU UL, Likely the trigger frame never got
  43. properly received by any of the targeted MU UL devices.
  44. After the abort, PHYRX can resume a normal search mode.
  45. <enum 6 macrx_abort_ul_mu_early_abort> RXPCU is terminating
  46. the current ongoing UL MU reception, because at the end
  47. of the "early_termination_window," the required number
  48. of users with at least one valid MPDU delimiter was not
  49. reached. Likely the trigger frame never got properly received
  50. by the required number of targeted devices. After the abort,
  51. PHYRX can resume a normal search mode.
  52. <legal 0-6>
  53. */
  54. #define MACRX_ABORT_REQUEST_INFO_MACRX_ABORT_REASON_OFFSET 0x00000000
  55. #define MACRX_ABORT_REQUEST_INFO_MACRX_ABORT_REASON_LSB 0
  56. #define MACRX_ABORT_REQUEST_INFO_MACRX_ABORT_REASON_MSB 7
  57. #define MACRX_ABORT_REQUEST_INFO_MACRX_ABORT_REASON_MASK 0x000000ff
  58. /* Description RESERVED_0
  59. <legal 0>
  60. */
  61. #define MACRX_ABORT_REQUEST_INFO_RESERVED_0_OFFSET 0x00000000
  62. #define MACRX_ABORT_REQUEST_INFO_RESERVED_0_LSB 8
  63. #define MACRX_ABORT_REQUEST_INFO_RESERVED_0_MSB 15
  64. #define MACRX_ABORT_REQUEST_INFO_RESERVED_0_MASK 0x0000ff00
  65. #endif // MACRX_ABORT_REQUEST_INFO