macrx_abort_request_info.h 3.4 KB

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