diff options
| author | Vinit Deshpande <vinitd@google.com> | 2015-03-14 22:07:36 -0700 |
|---|---|---|
| committer | Vinit Deshpande <vinitd@google.com> | 2015-03-14 22:07:36 -0700 |
| commit | 3cfe658a8371fb3144f55e8aa5cd77fb1ffd4863 (patch) | |
| tree | debb059e7b8b18f228dd0533531345fd8b05119e /include | |
| parent | b2f29aea0202225bc1f0f4dacbf9df6808f07229 (diff) | |
| parent | 0368419e1a467609e16f9d9cc024dd20fb283d72 (diff) | |
| download | hardware_libhardware_legacy-3cfe658a8371fb3144f55e8aa5cd77fb1ffd4863.zip hardware_libhardware_legacy-3cfe658a8371fb3144f55e8aa5cd77fb1ffd4863.tar.gz hardware_libhardware_legacy-3cfe658a8371fb3144f55e8aa5cd77fb1ffd4863.tar.bz2 | |
am "initial wifi logger HAL header file"
merged from goog/mirror-m-wireless-internal-release
0368419 initial wifi logger HAL header file
Change-Id: I289c18eb5c8e5ea93b71b9e020fca7f3d7d10459
Diffstat (limited to 'include')
| -rw-r--r-- | include/hardware_legacy/wifi_hal.h | 5 | ||||
| -rw-r--r-- | include/hardware_legacy/wifi_logger.h | 87 |
2 files changed, 91 insertions, 1 deletions
diff --git a/include/hardware_legacy/wifi_hal.h b/include/hardware_legacy/wifi_hal.h index 13ba2e4..b318e57 100644 --- a/include/hardware_legacy/wifi_hal.h +++ b/include/hardware_legacy/wifi_hal.h @@ -82,6 +82,8 @@ void wifi_get_error_info(wifi_error err, const char **msg); // return a pointer #define WIFI_FEATURE_EPR 0x4000 // Enhanced power reporting #define WIFI_FEATURE_AP_STA 0x8000 // Support for AP STA Concurrency #define WIFI_FEATURE_LINK_LAYER_STATS 0x10000 // Link layer stats collection +#define WIFI_FEATURE_LOGGER 0x20000 // WiFi Logger + // Add more features here typedef int feature_set; @@ -126,8 +128,9 @@ wifi_error wifi_set_nodfs_flag(wifi_interface_handle handle, u32 nodfs); #include "link_layer_stats.h" #include "rtt.h" #include "tdls.h" +#include "wifi_logger.h" + #ifdef __cplusplus } #endif -#endif diff --git a/include/hardware_legacy/wifi_logger.h b/include/hardware_legacy/wifi_logger.h new file mode 100644 index 0000000..9a9deb9 --- /dev/null +++ b/include/hardware_legacy/wifi_logger.h @@ -0,0 +1,87 @@ +#include "wifi_hal.h"
+
+#ifndef __WIFI_HAL_LOGGER_H
+#define __WIFI_HAL_LOGGER_H
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif /* __cplusplus */
+
+#define LOGGER_MAJOR_VERSION 1
+#define LOGGER_MINOR_VERSION 0
+#define LOGGER_MICRO_VERSION 0
+
+typedef int wifi_radio;
+typedef int wifi_ring_buffer_id;
+
+/**
+ * This structure represent a logger entry within a ring.
+ * Binary entries can be used so as to store packet data or vendor specific information.
+ */
+typedef struct {
+ u16 entry_size:13;
+ u16 binary:1; //set for binary entries
+ u16 has_timestamp:1; //set if 64 bits timestamp is present
+ u16 reserved:1;
+ u8 type; // Per ring specific
+ u8 resvd;
+ u64 timestamp; //present if has_timestamp bit is set.
+ u8 data[0];
+} wifi_ring_buffer_entry;
+
+#define WIFI_RING_BUFFER_FLAG_HAS_BINARY_ENTRIES 0x00000001 // set if binary entries are present
+#define WIFI_RING_BUFFER_FLAG_HAS_ASCII_ENTRIES 0x00000002 // set if ascii entries are present
+
+/* ring buffer params */
+/**
+ * written_bytes and read_bytes implement a producer consumer API
+ * hence written_bytes >= read_bytes
+ * a modulo arithmetic of the buffer size has to be applied to those counters:
+ * actual offset into ring buffer = written_bytes % ring_buffer_byte_size
+ *
+ */
+typedef struct {
+ u8 name[32];
+ u32 flags;
+ u64 fd; // linux file descriptor for that buffer
+ u32 ring_buffer_byte_size; // total memory size allocated for the buffer
+ u32 verbose_level; //
+ u32 written_bytes; // number of bytes that was written to the buffer by driver, monotonously increasing integer
+ u32 read_bytes; // number of bytes that was read from the buffer by user land, monotonously increasing integer
+} wifi_ring_buffer_status;
+
+/* API to trigger the debug collection.
+ Unless his API is invoked - logging is not triggered.
+ - verbose_level 0 corresponds to minimal or no collection
+ - verbose_level 1+ are TBD
+ */
+wifi_error wifi_start_logging(wifi_interface_handle iface, u32 verbose_level, u8 * buffer_name);
+
+/* callback for reporting ring buffer status */
+typedef struct {
+ void (*on_ring_buffer_status_results) (wifi_request_id id, u32 num_buffers, wifi_ring_buffer_status *status);
+} wifi_ring_buffer_status_result_handler;
+
+/* api to get the status of a ring buffer */
+wifi_error wifi_get_ring_buffer_status(wifi_request_id id,
+ wifi_interface_handle iface, wifi_ring_buffer_id ring_id, wifi_ring_buffer_status_result_handler handler);
+
+/* api to collect a firmware memory dump for a given iface */
+wifi_error wifi_get_firmware_memory_dump(wifi_request_id id,
+ wifi_interface_handle iface, char * buffer, int buffer_size);
+
+
+/* Feature set */
+#define WIFI_LOGGER_MEMORY_DUMP_SUPPORTED 1
+#define WIFI_LOGGER_PER_PACKET_TX_RX_STATUS_SUPPORTED 2
+
+wifi_error wifi_get_logger_supported_feature_set(wifi_interface_handle handle, unsigned int *support);
+
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /*__WIFI_HAL_STATS_ */
+
|