wlan_ftm_ucfg_api.h 3.9 KB

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