A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol
C arduinobluetoothcan-busdebuggingeepromesp32flipperzerogpiohardware-hackingi2cjtagopenocdprotocolspwmradiorfidspisubghzuartwifi
#pragma once
#include <WiFi.h>
#include <string>
#include <vector>
#include <sstream>
extern "C" {
#include "esp_wifi.h"
#include "esp_wifi_types.h"
}
struct WiFiNetwork {
std::string ssid;
int32_t rssi = 0;
wifi_auth_mode_t encryption = WIFI_AUTH_OPEN;
bool open = false;
bool vulnerable = false;
std::string bssid;
int32_t channel = 0;
bool hidden = false;
};
struct SniffedPacket {
int8_t rssi;
uint8_t channel;
std::string mac;
uint8_t type;
};
class WifiService {
public:
enum class MacInterface {
Station,
AccessPoint
};
WifiService();
// Connection
bool connect(const std::string& ssid, const std::string& password, unsigned long timeoutMs = 15000);
void disconnect();
bool isConnected() const;
// Utils
std::string getLocalIP() const;
std::string getCurrentIP() const;
std::string getSubnetMask() const;
std::string getGatewayIp() const;
std::string getDns1() const;
std::string getDns2() const;
std::string getHostname() const;
void setModeApSta();
void setModeApOnly();
std::string getMacAddressSta() const;
std::string getMacAddressAp() const;
std::string getApIp() const;
std::string getLocalIp() const;
int getRssi() const;
int getChannel() const;
std::string getSsid() const;
std::string getBssid() const;
int getWifiModeRaw() const; // wifi_mode_t
int getWifiStatusRaw() const; // wl_status_t
bool isProvisioningEnabled() const;
void reset();
// Access point
bool startAccessPoint(const std::string& ssid, const std::string& password = "", int channel = 1, int maxConn = 4);
// Spoof MAC
bool spoofMacAddress(const std::string& macStr, MacInterface which);
static std::string formatMac(const uint8_t* mac);
// Scan
std::vector<std::string> scanNetworks();
std::vector<WiFiNetwork> scanDetailedNetworks();
std::vector<WiFiNetwork> getOpenNetworks(const std::vector<WiFiNetwork>& networks);
std::vector<WiFiNetwork> getVulnerableNetworks(const std::vector<WiFiNetwork>& networks);
bool isVulnerable(wifi_auth_mode_t encryption) const;
std::string encryptionTypeToString(wifi_auth_mode_t encryption);
// Sniffing passif
void startPassiveSniffing();
void stopPassiveSniffing();
std::vector<std::string> getSniffLog();
bool switchChannel(uint8_t channel);
static std::string getFrameTypeSubtype(const uint8_t* payload, uint8_t& type, uint8_t& subtype);
static std::string parseSsidFromPacket(const uint8_t* payload, int len, uint8_t type, uint8_t subtype);
static std::string getFrameTypeName(uint8_t type, uint8_t subtype);
static void extractTypeSubtype(const uint8_t* payload, uint8_t& type, uint8_t& subtype);
// Deathentication attacks
bool deauthApBySsid (const std::string& ssid);
void deauthAttack(const uint8_t bssid[6], uint8_t channel, uint8_t bursts, uint32_t sniffMs);
bool connected;
static void snifferCallback(void* buf, wifi_promiscuous_pkt_type_t type);
static std::vector<std::string> sniffLog;
static portMUX_TYPE sniffMux;
// --- Client sniffer ---
static portMUX_TYPE staMux;
static std::vector<std::array<uint8_t, 6>> staList;
static uint8_t apBSSID[6];
static void clientSnifferCallback(void* buf, wifi_promiscuous_pkt_type_t type);
// Wifi mode to string
static inline const char* wifiModeToStr(int m) {
switch (static_cast<wifi_mode_t>(m)) {
case WIFI_MODE_NULL: return "NULL";
case WIFI_MODE_STA: return "STA";
case WIFI_MODE_AP: return "AP";
case WIFI_MODE_APSTA: return "AP+STA";
default: return "?";
}
}
// Wifi status to string
static inline const char* wlStatusToStr(int s) {
switch (s) {
case WL_IDLE_STATUS: return "IDLE";
case WL_NO_SSID_AVAIL: return "NO_SSID";
case WL_SCAN_COMPLETED: return "SCAN_DONE";
case WL_CONNECTED: return "CONNECTED";
case WL_CONNECT_FAILED: return "CONNECT_FAILED";
case WL_CONNECTION_LOST: return "CONNECTION_LOST";
case WL_DISCONNECTED: return "DISCONNECTED";
case WL_NO_SHIELD: return "NO_SHIELD";
default: return "?";
}
}
};