Initial commit: project docs and ignore rules

ESP32-C5-Toolkit/main/deauth_engine.h

@@ -0,0 +1,50 @@
+#ifndef DEAUTH_ENGINE_H
+#define DEAUTH_ENGINE_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+// Target structure
+typedef struct {
+    uint8_t bssid[6];
+    char ssid[33];
+    uint8_t channel;
+    uint32_t packets_sent;
+    bool active;
+} deauth_target_t;
+
+/**
+ * @brief Start dual-band deauth attack
+ * 
+ * @param target_24ghz 2.4GHz target (can be NULL if not used)
+ * @param target_5ghz 5GHz target (can be NULL if not used)
+ * @param duration Attack duration in seconds
+ * @return true if attack started successfully
+ */
+bool deauth_start_attack(deauth_target_t *target_24ghz, deauth_target_t *target_5ghz, uint32_t duration);
+
+/**
+ * @brief Stop deauth attack
+ * 
+ * @return true if attack stopped successfully
+ */
+bool deauth_stop_attack(void);
+
+/**
+ * @brief Check if attack is running
+ * 
+ * @return true if attack is active
+ */
+bool deauth_is_running(void);
+
+/**
+ * @brief Get attack statistics
+ * 
+ * @param total_packets Output: total packets sent
+ * @param packets_24ghz Output: 2.4GHz packets sent
+ * @param packets_5ghz Output: 5GHz packets sent
+ * @param elapsed_time Output: elapsed time in seconds
+ */
+void deauth_get_stats(uint32_t *total_packets, uint32_t *packets_24ghz, uint32_t *packets_5ghz, uint32_t *elapsed_time);
+
+#endif /* DEAUTH_ENGINE_H */