Skip to main content

Crate combustion_rust_ble

Crate combustion_rust_ble 

Source
Expand description

§combustion-rust-ble

A cross-platform Rust library for communicating with Combustion Inc’s Predictive Thermometer probes via Bluetooth Low Energy.

This library specifically targets Predictive Probes (ProductType 1). Other Combustion devices (Display, Booster, MeatNet Repeater, Giant Grill Gauge) are intentionally ignored during discovery.

§Features

  • Probe Discovery: Automatically discover nearby Predictive Probes
  • Real-time Temperatures: Read all 8 sensors in real-time
  • Virtual Sensors: Computed Core, Surface, and Ambient temperatures
  • Temperature Logging: Download complete temperature history
  • Prediction Engine: Set target temperatures and get time predictions
  • Food Safety: SafeCook/USDA Safe compliance monitoring
  • Multi-probe Support: Manage up to 8 probes simultaneously

§Quick Start

use combustion_rust_ble::{DeviceManager, Result};

#[tokio::main]
async fn main() -> Result<()> {
    // Create device manager and start scanning
    let manager = DeviceManager::new().await?;
    manager.start_scanning().await?;

    // Wait for probes to be discovered
    tokio::time::sleep(std::time::Duration::from_secs(5)).await;

    // Get all discovered probes
    for (id, probe) in manager.probes() {
        println!("Found probe: {} ({})", probe.serial_number_string(), id);

        // Read current temperatures
        let temps = probe.current_temperatures();
        let virtual_temps = probe.virtual_temperatures();

        if let Some(core) = virtual_temps.core {
            println!("  Core temperature: {:.1}°C", core);
        }
    }

    manager.shutdown().await?;
    Ok(())
}

§Using an existing btleplug adapter

If your application already holds a btleplug::platform::Adapter, pass it to DeviceManager::with_adapter instead of calling DeviceManager::new. The crate re-exports btleplug so the adapter type always matches.

§Platform Notes

§macOS

Requires Bluetooth permission. Add NSBluetoothAlwaysUsageDescription to your Info.plist for bundled apps.

§Linux

Requires BlueZ. User may need to be in the bluetooth group.

§Windows

Requires Windows 10 or later with Bluetooth LE support.

§Feature Flags

  • serde: Enable serialization/deserialization for data types

Re-exports§

pub use device_manager::DeviceManager;
pub use device_manager::DisconnectedProbeEvent;
pub use device_manager::DiscoveredProbeEvent;
pub use device_manager::MAX_PROBES;
pub use error::Error;
pub use error::Result;
pub use probe::CallbackHandle;
pub use probe::Probe;
pub use utils::celsius_to_fahrenheit;
pub use utils::fahrenheit_to_celsius;
pub use ble::advertising::BatteryStatus;
pub use ble::advertising::Overheating;
pub use ble::advertising::ProbeColor;
pub use ble::advertising::ProbeId;
pub use ble::advertising::ProbeMode;
pub use ble::connection::ConnectionState;
pub use ble::scanner::ScanMode;
pub use data::AlarmConfig;
pub use data::AlarmStatus;
pub use data::FoodSafeConfig;
pub use data::FoodSafeData;
pub use data::FoodSafeMode;
pub use data::FoodSafeProduct;
pub use data::FoodSafeServingState;
pub use data::FoodSafeState;
pub use data::FoodSafeStatus;
pub use data::IntegratedProduct;
pub use data::LoggedDataPoint;
pub use data::PowerMode;
pub use data::PredictionInfo;
pub use data::PredictionLog;
pub use data::PredictionMode;
pub use data::PredictionState;
pub use data::PredictionType;
pub use data::ProbeTemperatures;
pub use data::RawTemperature;
pub use data::Serving;
pub use data::SessionInfo;
pub use data::SimplifiedProduct;
pub use data::TemperatureLog;
pub use data::ThermometerPreferences;
pub use data::VirtualSensorSelection;
pub use data::VirtualTemperatures;
pub use btleplug;

Modules§

ble
BLE communication module.
data
Data structures for probe data.
device_manager
Device manager for discovering and managing Combustion Predictive Probes.
error
Error types for the combustion-rust-ble crate.
probe
Probe struct and methods.
protocol
Protocol module for parsing and constructing messages.
utils
Utility functions for the combustion-rust-ble crate.