wlan_ftm_ucfg_api.h 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. /*
  2. * Copyright (c) 2018 The Linux Foundation. All rights reserved.
  3. * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
  4. *
  5. *
  6. * Permission to use, copy, modify, and/or distribute this software for
  7. * any purpose with or without fee is hereby granted, provided that the
  8. * above copyright notice and this permission notice appear in all
  9. * copies.
  10. *
  11. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  12. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  13. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  14. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  15. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  16. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  17. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  18. * PERFORMANCE OF THIS SOFTWARE.
  19. */
  20. /**
  21. * DOC: declare the ftm service data structure and apis
  22. */
  23. #ifndef _WLAN_FTM_UCFG_API_H_
  24. #define _WLAN_FTM_UCFG_API_H_
  25. #include <qdf_types.h>
  26. #include <qdf_status.h>
  27. #include <wlan_objmgr_cmn.h>
  28. #define FTM_DEBUG 0
  29. #if FTM_DEBUG
  30. #define ftm_alert(params...) \
  31. QDF_TRACE_FATAL(QDF_MODULE_ID_FTM, params)
  32. #define ftm_err(params...) \
  33. QDF_TRACE_ERROR(QDF_MODULE_ID_FTM, params)
  34. #define ftm_warn(params...) \
  35. QDF_TRACE_WARN(QDF_MODULE_ID_FTM, params)
  36. #define ftm_notice(params...) \
  37. QDF_TRACE_INFO(QDF_MODULE_ID_FTM, params)
  38. #define ftm_debug(params...) \
  39. QDF_TRACE_DEBUG(QDF_MODULE_ID_FTM, params)
  40. #define ftm_nofl_alert(params...) \
  41. QDF_TRACE_FATAL_NO_FL(QDF_MODULE_ID_FTM, params)
  42. #define ftm_nofl_err(params...) \
  43. QDF_TRACE_ERROR_NO_FL(QDF_MODULE_ID_FTM, params)
  44. #define ftm_nofl_warn(params...) \
  45. QDF_TRACE_WARN_NO_FL(QDF_MODULE_ID_FTM, params)
  46. #define ftm_nofl_notice(params...) \
  47. QDF_TRACE_INFO_NO_FL(QDF_MODULE_ID_FTM, params)
  48. #define ftm_nofl_debug(params...) \
  49. QDF_TRACE_DEBUG_NO_FL(QDF_MODULE_ID_FTM, params)
  50. #else
  51. #define ftm_alert(params...)
  52. #define ftm_err(params...)
  53. #define ftm_warn(params...)
  54. #define ftm_notice(params...)
  55. #define ftm_debug(params...)
  56. #define ftm_nofl_alert(params...)
  57. #define ftm_nofl_err(params...)
  58. #define ftm_nofl_warn(params...)
  59. #define ftm_nofl_notice(params...)
  60. #define ftm_nofl_debug(params...)
  61. #endif
  62. #define FTM_IOCTL_UNIFIED_UTF_CMD 0x1000
  63. #define FTM_IOCTL_UNIFIED_UTF_RSP 0x1001
  64. #define FTM_CMD_MAX_BUF_LENGTH 2048
  65. /**
  66. * enum wifi_ftm_cmd_type - the enumeration of the command source per pdev
  67. * @WIFI_FTM_CMD_IOCTL: command from ioctl on the pdev
  68. * @WIFI_FTM_CMD_NL80211: command from nl80211 on the pdev
  69. *
  70. */
  71. enum wifi_ftm_pdev_cmd_type {
  72. WIFI_FTM_CMD_IOCTL = 1,
  73. WIFI_FTM_CMD_NL80211,
  74. /* command should be added above */
  75. WIFI_FTM_CMD_UNKNOWN,
  76. };
  77. /**
  78. * struct wifi_ftm_pdev_priv_obj - wifi ftm pdev utf event info
  79. * @pdev: pointer to pdev
  80. * @data: data ptr
  81. * @current_seq: current sequence
  82. * @expected_seq: expected sequence
  83. * @length: length
  84. * @offset: offset
  85. * @cmd_type: command type from either ioctl or nl80211
  86. */
  87. struct wifi_ftm_pdev_priv_obj {
  88. struct wlan_objmgr_pdev *pdev;
  89. uint8_t *data;
  90. uint8_t current_seq;
  91. uint8_t expected_seq;
  92. qdf_size_t length;
  93. qdf_size_t offset;
  94. enum wifi_ftm_pdev_cmd_type cmd_type;
  95. };
  96. /**
  97. * wlan_ftm_testmode_cmd() - handle FTM testmode command
  98. * @pdev: pdev pointer
  99. * @data: data
  100. * @len: data length
  101. *
  102. * Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_** on error
  103. */
  104. QDF_STATUS ucfg_wlan_ftm_testmode_cmd(struct wlan_objmgr_pdev *pdev,
  105. uint8_t *data, uint32_t len);
  106. /**
  107. * wlan_ftm_testmode_rsp() - handle FTM testmode command
  108. * @pdev: pdev pointer
  109. * @data: data
  110. *
  111. * Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_** on error
  112. */
  113. QDF_STATUS ucfg_wlan_ftm_testmode_rsp(struct wlan_objmgr_pdev *pdev,
  114. uint8_t *data);
  115. /**
  116. * wlan_ftm_process_utf_event() - process ftm UTF event
  117. * @scn_handle: scn handle
  118. * @event: event buffer
  119. * @len: event length
  120. *
  121. * return: QDF_STATUS_SUCCESS for success or error code
  122. */
  123. QDF_STATUS wlan_ftm_process_utf_event(struct wlan_objmgr_pdev *pdev,
  124. uint8_t *event_buf, uint32_t len);
  125. #endif /* _WLAN_FTM_UCFG_API_H_ */