wlan_ftm_ucfg_api.h 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  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. #else
  40. #define ftm_alert(format, args...)
  41. #define ftm_err(format, args...)
  42. #define ftm_warn(format, args...)
  43. #define ftm_notice(format, args...)
  44. #define ftm_debug(format, args...)
  45. #endif
  46. #define FTM_IOCTL_UNIFIED_UTF_CMD 0x1000
  47. #define FTM_IOCTL_UNIFIED_UTF_RSP 0x1001
  48. #define FTM_CMD_MAX_BUF_LENGTH 2048
  49. /**
  50. * enum wifi_ftm_cmd_type - the enumeration of the command source per pdev
  51. * @WIFI_FTM_CMD_IOCTL: command from ioctl on the pdev
  52. * @WIFI_FTM_CMD_NL80211: command from nl80211 on the pdev
  53. *
  54. */
  55. enum wifi_ftm_pdev_cmd_type {
  56. WIFI_FTM_CMD_IOCTL = 1,
  57. WIFI_FTM_CMD_NL80211,
  58. /* command should be added above */
  59. WIFI_FTM_CMD_UNKNOWN,
  60. };
  61. /**
  62. * struct wifi_ftm_pdev_priv_obj - wifi ftm pdev utf event info
  63. * @pdev: pointer to pdev
  64. * @data: data ptr
  65. * @current_seq: curent squence
  66. * @expected_seq: expected sequence
  67. * @length: length
  68. * @offset: offset
  69. * @cmd_type: command type from either ioctl or nl80211
  70. */
  71. struct wifi_ftm_pdev_priv_obj {
  72. struct wlan_objmgr_pdev *pdev;
  73. uint8_t *data;
  74. uint8_t current_seq;
  75. uint8_t expected_seq;
  76. qdf_size_t length;
  77. qdf_size_t offset;
  78. enum wifi_ftm_pdev_cmd_type cmd_type;
  79. };
  80. /**
  81. * wlan_ftm_testmode_cmd() - handle FTM testmode command
  82. * @pdev: pdev pointer
  83. * @data: data
  84. * @len: data length
  85. *
  86. * Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_** on error
  87. */
  88. QDF_STATUS ucfg_wlan_ftm_testmode_cmd(struct wlan_objmgr_pdev *pdev,
  89. uint8_t *data, uint32_t len);
  90. /**
  91. * wlan_ftm_testmode_rsp() - handle FTM testmode command
  92. * @pdev: pdev pointer
  93. * @data: data
  94. *
  95. * Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_** on error
  96. */
  97. QDF_STATUS ucfg_wlan_ftm_testmode_rsp(struct wlan_objmgr_pdev *pdev,
  98. uint8_t *data);
  99. /**
  100. * wlan_ftm_process_utf_event() - process ftm UTF event
  101. * @scn_handle: scn handle
  102. * @event: event buffer
  103. * @len: event length
  104. *
  105. * return: QDF_STATUS_SUCCESS for success or error code
  106. */
  107. QDF_STATUS wlan_ftm_process_utf_event(struct wlan_objmgr_pdev *pdev,
  108. uint8_t *event_buf, uint32_t len);
  109. #endif /* _WLAN_FTM_UCFG_API_H_ */