IQOS

Rust library for controlling IQOS devices over BLE, exposing device internals not accessible through the official IQOS app.

Early development. The public API is still taking shape and should be considered unstable.

What This Exposes

The official IQOS app surfaces only basic status and settings. This library goes further.

Diagnostic telemetry — not available in the official app

Programmatic device control

• Brightness, vibration, FlexPuff
• FlexBattery mode and Pause Mode (ILUMA i)
• Smart Gesture and Auto Start
• Device lock / unlock
• Firmware version (stick and holder)

Transport Support

⚠️ USB is not implemented. The architecture is designed to support it — the Transport trait is transport-agnostic — but no USB backend exists yet.

Architecture

src/
├── lib.rs              # Public facade — Iqos<T> device handle
├── error.rs            # Error types and Result alias
├── transport.rs        # Transport trait shared by BLE/USB backends
├── protocol/           # Command builders, response parsers, typed domain values
│   ├── ble.rs
│   ├── brightness.rs
│   ├── diagnosis.rs
│   ├── firmware.rs
│   ├── flexbattery.rs
│   ├── flexpuff.rs
│   ├── gesture.rs
│   ├── lock.rs
│   ├── types.rs
│   └── vibration.rs
└── transports/
    ├── ble_btleplug.rs # BLE backend (btleplug-support feature)
    └── usb.rs          # USB stub (usb-support feature, not yet implemented)

Design principles

• Library-first — no stdout/stderr output, no unwrap()/panic!() in library code
• Typed protocol models — all device state is represented as typed Rust values, not raw bytes
• Transport-agnostic — BLE and USB share the same Transport trait
• Testable without hardware — full coverage via MockTransport

Development

cargo fmt --all --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets --all-features

License

GPL-3.0 — see LICENSE.