Initial commit: project docs and ignore rules

ESP32-C5-Toolkit/main/wifi_sniffer.h

@@ -0,0 +1,39 @@
+#ifndef WIFI_SNIFFER_H
+#define WIFI_SNIFFER_H
+
+#include <stdbool.h>
+#include <stdint.h>
+#include "esp_wifi_types.h"
+
+/**
+ * @brief Start WiFi packet sniffer
+ * 
+ * @param channel Channel to sniff on (0 for channel hopping)
+ * @param filter_type Type of packets to capture:
+ *                   0: All packets
+ *                   1: Management frames only
+ *                   2: Data frames only
+ *                   3: Control frames only
+ *                   4: Beacon frames only
+ *                   5: Probe request/response only
+ * @return true if sniffer started successfully
+ */
+bool start_wifi_sniffer(uint8_t channel, uint8_t filter_type);
+
+/**
+ * @brief Stop WiFi packet sniffer
+ * 
+ * @return true if sniffer stopped successfully
+ */
+bool stop_wifi_sniffer(void);
+
+/**
+ * @brief Get captured packets
+ * 
+ * @param packets Array of pointers to store packet data (must be freed by caller)
+ * @param max_packets Maximum number of packets to retrieve
+ * @return Number of packets retrieved
+ */
+int get_captured_packets(void **packets, int max_packets);
+
+#endif /* WIFI_SNIFFER_H */