tatemazer / AcaiaArduinoBLE

Acaia Scale Gateway using the ArduinoBLE library for devices such as the esp32 and other Bluetooth-enabled Arduino compatible hardware.
MIT License
46 stars 7 forks source link

AcaiaArduinoBLE

Acaia / Bookoo Scale Gateway using the ArduinoBLE library for devices such as the esp32, arduino nano esp32, and arduino nano iot 33. This is an Arduino Library which can be found in the Arduino IDE Library Manager.

Scale Compatibility

Mfr Model Submodel Firmware Connection Performance Auto-Tare Auto-Start/Stop Timer Auto-Reset Timer
Acaia Lunar USB-Micro
(Pre-2021)
v2.6.019 Great Yes Yes Untested
Acaia Lunar USB-C
(2021 version)
v1.0.016 Ok ⚠️WARNING⚠️ only compatible* if the bluetooth device name is "LUNAR..." and not "ACAIAL..." Yes Yes Yes
Acaia Pearl S USB-Micro v1.0.056 Ok Yes Yes Yes
Acaia Pearl S USB-C ---- Ok Yes Yes Yes
Acaia Pyxis ---- v1.0.022 Good Not Recommended (too sensitive) Yes Yes
Bookoo Themis ---- v1.0.5 Great Yes Yes Yes

*There is a bug in the firmware for a handful of 2021 Lunars that make this incompatible. The best way to determine if your scale has this bug, is to scan for bluetooth devices with your phone. If you see a device named "ACAIAL..." instead of "LUNAR...", this scale is unfortunately incompatible at this time.

Requirements

This library is intended to be used with any arduino device which is compatible with the ArduinoBLE library.

As of version V2.0.0, non-volatile storage for the setpoint and offset is only available for ESP32-based devices.

Printed Circuit Board

shotStopperV3 screenshot

The included "shotStopper" example code uses the ShotStopper PCB to make it simple to control your espresso machine using the scale. Files are hosted on altium 365.

A kit can also be ordered by visiting tatemazer.com

Join the discord for updates and support: https://discord.gg/NMXb5VYtre

Video showing developmnent of the shotStopper

Espresso Machine Compatibility

Model Powered by Machine (5V) Brew State Detection Method Officially Documented
GS3 No, requires included power supply Brew Button Yes
Linea Micra Yes Brew Switch Yes
Linea Mini Older, non-IoT machines may require a power supply Brew Switch Yes
Silvia Pro (X) Yes Brew Button Yes
Stone Espresso Yes Solenoid Valve (Reed Switch) Yes
Ascaso Steel Duo PID Untested Brew Button No

ShotStopper Example Code Configuration

The following variables at the top of the shotStopper.ino file can be configured by the user:

MOMENTARY

REEDSWITCH

AUTOTARE

Demo

You can find a demo on Youtube:

Video showing an shotStopper pulling a shot on a silvia pro

Project Status

Firmware:

☑ Connect Acaia Pyxis to ESP32

☑ Tare Command

☑ Receive Weight Data

☑ shotStopper Espresso Machine Brew-By-Weight Firmware

☑ Compatibility with Lunar (Pre-2021)

☑ Compatibility with Lunar 2021

☑ Positive and negative weight support

☑ Latching-switch support (LM Mini, LM Micra, etc)

☑ Auto-reconnect

☑ change setpoint over bluetooth

☑ maintain setpoint and offset after powercycle

☑ auto start/stop timer

☑ flowrate-based shot end-time

☑ auto timer reset

⬜ Improve Pyxis Tare Command Reliability

Scale Compatibility:

☑ Acaia Pyxis

☑ Acaia Lunar

most Acaia Lunar (Pre-2021)

☑ Pearl S

❌ Felicita Arc (buggy, see bug report)

☑ Bookoo

Hardware:

☑ PCB Design for Low Voltage Switches (V1.1)

☑ 3D-Printed Half Case

☑ Compatibility with La Marzocco GS3 AV

☑ Compatibility with Rancilio Silvia Pro (and Pro X)

❌ Compatibility with La Marzocco Linea Classic S (Not Compatible, requires investigation)

☑ Compatibility with Stone Espresso (requires reed switch)

☑ Compatibility with La Marzocco Mini

☑ Compatibility with La Marzocco Micra (V2.0)

☑ Powered by espresso machine (V2.0)

☑ Reed switch input (V2.0)

☑ on-board esp32 module (V3.0)

⬜ Compatibility with Breville (presumed but untested)

⬜ Support for High-Voltage Switches (Hall-Effect Sensor and SSR?)

Sales:

☑ Beta Users Determined

☑ Beta Units Built

☑ Beta Units Shipped

☑ Beta Test Complete

☑ Sales Open For GS3, Silvia, and Micra In the US

☑ Sales Open for Linea Mini

☑ International Sales Open

Bugs/Missing

  1. Tare command is less reliable than pressing the tare button.
  2. Only supports grams.

Acknowledgement

This is largely a basic port of the LunarGateway library written for the ESP32.

In addition to some minor notes from pyacaia library written for raspberryPI.

Felicita Arc support contributions from baettigp

Bookoo contributions from philgood