Politician 1.0.0
WiFi Auditing Library for ESP32
Loading...
Searching...
No Matches
PoliticianFingerprint.h File Reference
#include "Politician.h"
#include <string.h>
#include "PoliticianFingerprintDB.h"
+ Include dependency graph for PoliticianFingerprint.h:

Go to the source code of this file.

Classes

class  politician::fingerprint::Detector
 

Namespaces

namespace  politician
 
namespace  politician::fingerprint
 

Macros

#define FP_DB_NONE   0
 PoliticianFingerprint: Passive WiFi Device Fingerprinting.
 
#define FP_DB_BUILTIN   1
 
#define POLITICIAN_FP_DB   FP_DB_BUILTIN
 
#define POLITICIAN_MAX_FP_USER   16
 
#define POLITICIAN_MAX_FP_SEEN   64
 

Typedefs

using politician::fingerprint::DeviceFoundCb = void(*)(const DeviceRecord &rec)
 

Macro Definition Documentation

◆ FP_DB_BUILTIN

#define FP_DB_BUILTIN   1

Definition at line 36 of file PoliticianFingerprint.h.

◆ FP_DB_NONE

#define FP_DB_NONE   0

PoliticianFingerprint: Passive WiFi Device Fingerprinting.

Identifies devices by matching observed MAC OUIs, probe request SSID patterns, HT Capabilities, Supported Rates, and IE presence flags against a built-in database. Fires a callback once per unique device per session (seen-MAC cache). RSSI is silently refreshed on re-sightings.

DATABASE TIERS — define before including this header, or in build_flags: -DPOLITICIAN_FP_DB=FP_DB_BUILTIN curated WiFi consumer devices [default] -DPOLITICIAN_FP_DB=FP_DB_NONE no built-ins; user-defined entries only

CAPACITY OVERRIDES (build_flags): -DPOLITICIAN_MAX_FP_USER=N max user-defined fingerprints [default 16] -DPOLITICIAN_MAX_FP_SEEN=N seen-MAC dedup cache size [default 64]

USAGE: #include <PoliticianFingerprint.h> fingerprint::Detector fp(engine); fp.setCallback([](const DeviceRecord& dev) { Serial.printf("[FP] %s %s conf=%d%% flags=0x%02X\n", dev.vendor, dev.model, dev.confidence, dev.match_flags); }); fp.setMinConfidence(60); fp.addFingerprint({"Acme", "Plug", {0xAA,0xBB,0xCC}, nullptr, 75});

NOTE: Include in a single translation unit (your main sketch).

Definition at line 35 of file PoliticianFingerprint.h.

◆ POLITICIAN_FP_DB

#define POLITICIAN_FP_DB   FP_DB_BUILTIN

Definition at line 39 of file PoliticianFingerprint.h.

◆ POLITICIAN_MAX_FP_SEEN

#define POLITICIAN_MAX_FP_SEEN   64

Definition at line 54 of file PoliticianFingerprint.h.

◆ POLITICIAN_MAX_FP_USER

#define POLITICIAN_MAX_FP_USER   16

Definition at line 50 of file PoliticianFingerprint.h.