Initial commit: project docs and ignore rules

ESP32-C5-Toolkit/main/wifi_scan.h

@@ -0,0 +1,33 @@
+#ifndef WIFI_SCAN_H
+#define WIFI_SCAN_H
+
+#include <stdint.h>
+
+/**
+ * @brief Perform WiFi network scan (dual-band)
+ * 
+ * Scans both 2.4GHz and 5GHz bands for available networks.
+ * Results are stored internally and can be retrieved via wifi_scan_get_results_json()
+ * 
+ * @return 0 on success, negative error code on failure
+ */
+int wifi_scan_networks(void);
+
+/**
+ * @brief Get scan results as JSON string
+ * 
+ * Returns the last scan results in JSON format.
+ * The returned string is valid until the next scan is performed.
+ * 
+ * @return JSON string with network information, or NULL on error
+ */
+const char* wifi_scan_get_results_json(void);
+
+/**
+ * @brief Get number of networks found in last scan
+ * 
+ * @return Number of networks found
+ */
+int wifi_scan_get_count(void);
+
+#endif /* WIFI_SCAN_H */