mmastrac / longshot

API and CLI for ECAM-based Delonghi machines

longshot

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_name).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

longshot's Issues

List command not running on Linux

Hello, I am not able to run the list command in a Raspberry Pi 4 on linux.
Here is the error output I get:
Error: BTError(Other(DbusError(D-Bus error: Rejected send message, 2 matched rules; type="method_call", sender=":1.17" (uid=1000 pid=1078 comm="longshot list ") interface="org.freedesktop.DBus.ObjectManager" member="GetManagedObjects" error name="(unset)" requested_reply="0" destination="org.bluez" (uid=0 pid=533 comm="/usr/lib/bluetooth/bluetoothd ") (org.freedesktop.DBus.Error.AccessDenied))))

Has anyone faced this issue? Any solutions?

Command to turn on the machine

Hello, very interesting work!!! One question, it's possibile to only turn on the machine?

Recipes

Hi,

it looks like you can even manipulate recipes.

Here's the thing: Having been mistreated by very expensive coffee machines at work, I would love if a Cappuccino was made correctly just for once by a machine. That means that espresso is dispensed first, milk foam second, not the other way around.

Or maybe the DeLonghi does it correctly?

Build on non-mac platforms

This project needs some tweaking to remove the assumption that the device ID is always a UUID. Shouldn't be too tough, but will need testing and build support.

Feature: Open WebSocket server for receiving commands

As mentioned in #5, it could be useful to provide a WebSocket interface for allowing multiple users to multiplex the machine.

CleanKnob alarm (and certain other alarms) should be changed to warnings

Right now the code is intentionally ignoring some alarms that are non-fatal (currently just CleanKnob, but we'd probably want to add descaling):

longshot/src/ecam/ecam_wrapper.rs

Line 88 in 995bf73

for alarm in state.alarms.set() {

We should likely include certain alarms as a warning bitset for the ready state to alert the user that they may wish to take action on something before or after brewing.