Crate longshot

Source
Expand description

Brew coffee from the command-line!

§Details

Longshot is an API and command-line application to brew coffee from the command-line (or whatever front-end is built). At this time it supports DeLonghi ECAM-based Bluetooth-Low-Energy devices, and has only been tested on the Dinamica Plus over Bluetooth.

The protocol for status and monitoring has been mostly decoded, but at this time is only available in source form.

§Command-Line Examples

Monitor the given device (will continue until you press Ctrl+C):

$ longshot monitor --device-name (device)
Dispensing... [###############################===========]

Get the brew information for a given beverage:

$ longshot brew  --device-name (device) --beverage regularcoffee
...

Brew a beverage:

$ longshot brew  --device-name (device) --beverage regularcoffee --coffee 180 --taste strong
Fetching recipe for RegularCoffee...
Fetching recipes...
Brewing RegularCoffee...

§API Examples

Brew a long coffee with 250 impulses of water (approximately the size of an average North American coffee mug, or slightly more).

let ecam = ecam_lookup(&device_id, false).await?;
let req = Request::BeverageDispensingMode(
    EcamBeverageId::LongCoffee.into(),
    EcamOperationTrigger::Start.into(),
    vec![RecipeInfo::new(EcamIngredients::Coffee, 250)],
    EcamBeverageTasteType::Prepare.into(),
);
ecam.write_request(req).await?;

§Demo

Demo of brewing a cappuccino

Modules§

display
Status display utilities.
ecam
Low-level communication with ECAM-based devices.
logging
Logging utilities.
operations
Coffee-related operations: brewing, monitoring, etc.
protocol
Protocols for communication with ECAM-based devices.
util

Macros§

info
Writes info text for the given event.
trace_packet
Writes a trace of the given communication packet or event if enable_tracing has been called.
trace_shutdown
Writes a trace of the given shutdown event if enable_tracing has been called.
warning
Writes a warning of the given event if enable_tracing has been called.