+----------------------------------------------------------------------+ | _____ _ _ _ ____ ___ ____ FLUID OPERATING SYSTEM | | | | | | | | |/ | / _ / | ---------------------- | | | | | | | | | | | _ | | | _ \ 802.11 PACKET-WAVE SAMPLER | | | | | || || | || | | || |) | ESP8285 SAMPLER BOARD | | || ||_/ _| _/|___/ FLIPPER ZERO WIFI v1 | +----------------------------------------------------------------------+ | [ 2.4GHz SPECTRUM ANALYZER WAVE ] [ FLIPPER CYBER-DOLPHIN ] | | dBm ( ( ( RF ) ) ) | | -30| /\ /\ /\ | | -40| / \ /\ / \ / \ __ | | -50| /\ / \ / \ /\ / /\ / / |[o ]_ | | -60| / # / / # / \ _/ /====|====/ \ | | -70| / / \ /\ /\ / / \ / '--' \ | | -80|// _/ _/ // ____/ __/_/ | | 2412MHz--------------------------------------------------> 2484MHz | | CH: 01 02 03 04 05 06 07 08 09 10 11 12 13 14 __/ | | WAV: ~~~^~~~v~~~^~~~^~~~v~~~^~~~v~~~^~~~v~~~^~~~v~~~~~~~~~~~~~~~~~ | +----------------------------------------------------------------------+ | PACKET TYPES : [BEACON] [PROBE-REQ] [DATA-ACK] [EAPOL] [DEAUTH] | | SAMPLING : Promiscuous IQ Waveform Captures @ 802.11b/g/n | +----------------------------------------------------------------------+ | TARGET BOARD : Flipper Zero WiFi Devboard v1 (ESP8285) | | SYSTEM CORE : FLUG-OS Real-Time Kernel + Wave Engine v0.3.0 | | SIGNING : ML-DSA-65 + SLH-DSA post-quantum (NIST FIPS 204/205) | +----------------------------------------------------------------------+

FLUG-OS{-1,0,+1} — Fluid Operating System for the Flipper Zero WiFi Module v1 (ESP8285). Captures 802.11 frames in promiscuous mode, streams packet features as numerical wave data through the universal sine kernel K(u)=sin(πu)/(πu). Every WiFi packet becomes a musical note, a ternary matrix row, or a spectral analysis point.

Aligned with axiomquant.org — five threshold domains: Erdős β₁ · BitNet ternary γ · Markowitz λ · Black-Scholes σ · Rényi dyadic β.

Signed with ML-DSA-65 + SLH-DSA post-quantum signatures (NIST FIPS 203/204/205).

Roadmap: https://github.com/8b-is/FLUG-OS/blob/main/ROADMAP.md — target v1.4.2 parity with MLX-QUANT.

Quick start — 3 minutes

1. What you need

[ ] Flipper Zero
[ ] WiFi Module v1 (ESP8285, black PCB)
[ ] USB-C cable
[ ] Computer with Python 3

2. Flash

# Install PlatformIO (one time)
pip3 install platformio

# Clone & build
git clone https://github.com/8b-is/FLUG-OS.git
cd FLUG-OS
pio run -e esp8285 -t upload

No Flipper? FLUG-OS runs on any ESP8266. Edit platformio.ini: change board = esp8285 to board = nodemcuv2 for NodeMCU, Wemos D1, etc.

3. Connect

# Find your serial port
ls /dev/tty.*
# macOS: /dev/tty.usbserial-XXXX  or  /dev/tty.wchusbserial*
# Linux: /dev/ttyUSB0  or  /dev/ttyACM0
# Windows: COM3 or similar

# Listen (macOS/Linux)
screen /dev/tty.usbserial-XXXX 115200

WiFi Module v1: the ESP8285 module connects via UART through the Flipper Zero's USB-C. FLUG-OS talks directly to the ESP8285's serial console at 115200 baud. No Flipper Zero application needed — the firmware runs standalone on the ESP8285 itself.

4. Start sniffing

mode wave          # hear the spectrum as sine waves
ch 6              # listen on channel 6
hop               # sweep all channels
filter mgmt       # only management frames
stats             # packet counts

5. Pipe to music

pip3 install pyserial
python3 bridge/wave_bridge.py /dev/tty.usbserial-XXXX --mode wave --dump

---

WiFi Module v1 setup guide

The Flipper Zero WiFi Module v1 uses an ESP8285 (ESP8266 family) with 1MB flash. It connects to your computer through the Flipper Zero's USB-C port and communicates over UART at 115200 baud.

Identifying your module

Revision	Chip	Flash	Board ID
v1 (black PCB)	ESP8285	1MB	esp8285
v2 (white PCB)	ESP32-S2	4MB	esp32-s2

FLUG-OS targets the v1 module (ESP8285). For v2 with ESP32-S2 a separate build target is planned.

Physical connection

The WiFi Module v1 does not have its own USB port. It is powered and communicated with through the Flipper Zero's USB-C connector. When you plug the Flipper Zero into your computer via USB, the ESP8285 appears as a serial device:

  Flipper Zero (USB-C)  --- cable --->  WiFi Module v1 (ESP8285)
  /dev/tty.usbserial-XXXX                UART @ 115200 baud

Flashing via Flipper Zero (recommended)

1. Connect the WiFi Module to the Flipper Zero (16-pin GPIO header)
2. Connect the Flipper Zero to your computer via USB-C
3. Put the Flipper in DFU mode: hold LEFT + BACK on boot
4. Flash:

   pio run -e esp8285 -t upload

   PlatformIO auto-detects the ESP8285 through the Flipper's serial bridge.

Flashing directly (FTDI adapter)

If you have a USB-UART (FTDI) adapter:

FTDI -> ESP8285
GND  -> GND (pin 9)
TX   -> RX  (pin 8)
RX   -> TX  (pin 7)
3.3V -> 3.3V(pin 1)
IO0  -> GND (for flash mode, remove after)

pio run -e esp8285 -t upload --upload-port /dev/tty.usbserial-XXXX

After flashing, remove the IO0->GND jumper and reset the module.

Serial console

Connect to see the FLUG-OS boot screen:

screen /dev/tty.usbserial-XXXX 115200

Expected output:

  =============================================
        FLUG-OS  {-1, 0, +1}
    Fluid Operating System v0.3.0+dev
  =============================================
  ...

No Flipper Zero?

FLUG-OS runs on any ESP8266/ESP8285 board. Edit platformio.ini:

board = nodemcuv2        # NodeMCU v2, Wemos D1 Mini, etc.

Build and upload:

pio run -e generic -t upload

UART output will be on the board's built-in USB serial (/dev/ttyUSB0).

---

Commands

Command	What it does
ch 6	Set channel (1-13)
hop	Toggle channel hopping (1s/ch)
mode raw	RSSI density type domain kernel — 5 floats
mode wave	Synthesized sine wave sample — 3 floats
mode json	Structured JSON with musical parameters
`filter mgmt	ctrl
stats	Show capture statistics
reset	Reset counters

---

Wave output formats

raw mode — 5 floats per packet

~ RSSI DENSITY FRAME_TYPE DOMAIN KERNEL
~ 0.750 0.320 2 1 0.9231

Field	Range	Meaning
RSSI	0.0 — 1.0	Normalized signal strength
DENSITY	0.0 — 1.0	Packets per 100ms window
FRAME_TYPE	0, 1, 2	mgmt, ctrl, data
DOMAIN	-1, 0, +1	Below/at/above critical threshold
KERNEL	0.0 — 1.0	Sine kernel K(u)=sin(πu)/(πu)

wave mode — 3 floats per packet

~ WAVE DOMAIN KERNEL
~ 0.4231 1 0.9231

json mode — structured musical data

~ {"rssi":0.750,"density":0.320,"freq":220.00,"type":0,"subtype":8,"domain":1,"kernel":0.9231,"ts":123456}

default (no wave mode) — 802.11 frame JSON

🌊 {"ts":123456,"len":68,"rssi":-45,"type":"mgmt","subtype":"beacon","src":"aa:bb:cc:dd:ee:ff","dst":"...","bssid":"...","ssid":"MyNetwork","chan":6,"bi":100}

---

Ecosystem

Node	What	Layer
HF-MAC{-1,0,+1}	Native macOS Hugging Face client	App
entheai	Agent with MEM8 wave memory	Agent
ayeOS	Ternary matrix inference daemon	Inference
MLX-QUANT	Metal GPU ternary kernels	GPU
FLUG-OS	802.11 packet-wave sampler	Hardware
axiomquant.org	Universal threshold kernel research	Math

All ternary. All aligned. {-1, 0, +1}

---

Build

pio run -e esp8285                    # Flipper Zero WiFi v1
pio run -e generic                    # Generic ESP8266
pio run -e debug                      # Debug build with serial output

Files

FLUG-OS/
├── src/
│   ├── flugos.cpp           # Main firmware (500 lines)
│   ├── wave_output.h        # Sine kernel wave sonification
│   ├── matrix_decoder.h     # 1:1 packet→ternary matrix decoder
│   └── version.h            # Semantic versioning + CI commit
├── bridge/
│   └── wave_bridge.py       # Serial → HTTP/MIDI wave bridge
├── .github/workflows/
│   └── ci.yml               # Blacksmith CI + PQC signing
├── platformio.ini           # Build config
└── README.md                # This file

Security

Firmware releases are signed with post-quantum signatures:

Algorithm	Standard	Purpose
ML-DSA-65	FIPS 204 (CRYSTALS-Dilithium)	Primary firmware signature
SLH-DSA-SHAKE-128s	FIPS 205 (SPHINCS+)	Backup signature

Public keys published with each release. Verify:

openssl dgst -verify flugos-signing-mldsa65.pub \
  -signature firmware.bin.mldsa65.sig firmware.bin

Reference: NIST FIPS 203/204/205 — August 13, 2024

License

MIT — educational/defensive security research only.

---

Built by the 8b-is constellation. 🜂 {-1, 0, +1} — ennyi elég.