Crate ember_mug

ember_mug | Rust crate for controlling and retrieving data from an Ember Ceramic Mug using Bluetooth Low Energy (BLE)

  

You can see current unpublished docs here:

Provides a Rust interface for interacting with Ember Mug devices through the btleplug crate. Used to create applications that can control and monitor Ember Mug devices; retrieving the current temperature or battery level, setting the target temperature or mug color and accessing device metadata.

Example

use ember_mug::{mug::Temperature, EmberMug};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mug = EmberMug::find_and_connect().await?;
    let name = mug.get_name().await?;
    println!("Connected to an Ember Mug with the name '{}'", name);

    let battery = mug.get_battery().await?;
    println!("Battery level: {}%", battery.battery);

    let current_temp = mug.get_current_temperature().await?;
    let target_temp = mug.get_target_temperature().await?;
    let unit = mug.get_temperature_unit().await?;
    println!("Current temperature: {}{}", current_temp, unit);
    println!("Target temperature: {}{}", target_temp, unit);

    mug.set_target_temperature(&Temperature::from_degree(60.0))
        .await?;

    let target_temp = mug.get_target_temperature().await?;
    println!("Changed target temperature to {}{}", target_temp, unit);

    Ok(())
}

Results in

Connected to an Ember Mug with the name 'EMBER'
Battery level: 100%
Current temperature: 20.5°C
Target temperature: 54°C
Changed target temperature to 60°C

Kudos

Thanks to orlopau/ember-mug and sopelj/python-ember-mug for providing hints towards the various BLE characteristics

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}

Re-exports

pub use mug::EmberMug;

pub use btleplug;

Modules

btle

Functions for communicating with BLE to connect to Ember Mugs

mug

Hosts EmberMug and related functions

Enums

ConnectError

Errors when trying to connect to an Ember Mug

KnownCharacteristic

All known characteristics of an Ember Mug

ReadError

Errors when reading data from an Ember Mug

SearchError

Errors when searching for a device

WriteError

Errors when writing data to an Ember Mug

Constants

EMBER_MUG_PUBLIC_SERVICES

Known public UUIDs of ember mugs

EMBER_MUG_SERVICE_UUID

The UUID for the Ember Mug service

Statics

EMBER_ASSIGNED_NUMBER

Assigned Bluetooth company identifier for Ember Technologies, Inc.