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.