Joost Lekkerkerker 81f160d9a9
Fix Acaia headers (#37058)
Co-authored-by: Franck Nijhof <git@frenck.dev>
2025-01-22 20:36:59 +01:00

3.9 KiB

title, description, ha_release, ha_category, ha_iot_class, ha_config_flow, ha_domain, ha_platforms, ha_bluetooth, ha_codeowners, ha_integration_type, ha_quality_scale
title description ha_release ha_category ha_iot_class ha_config_flow ha_domain ha_platforms ha_bluetooth ha_codeowners ha_integration_type ha_quality_scale
Acaia Instructions on how to integrate your Acaia smart coffee scale with Home Assistant. 2024.12
Binary sensor
Button
Sensor
Local Push true acaia
binary_sensor
button
diagnostics
sensor
true
@zweckj
device platinum

The Acaia {% term integration %} allows you to control Acaia scales through Home Assistant.

If your machine is within Bluetooth range to your Home Assistant host and the Bluetooth integration is fully loaded, the scale should be discovered automatically. If you are configuring the device manually, your scale needs to be turned on during setup.

Once the integration is set up, Home Assistant will try to connect to your scale every 15 seconds. This means there is sometimes a small delay between you turning the scale on and Home Assistant connecting to it.

{% include integrations/config_flow.md %}

{% configuration_basic %} Device: description: "The Bluetooth device that is your scale." {% endconfiguration_basic %}

Available platforms & entities

Binary sensors

  • Timer running: Whether the timer is currently running on the scale

Buttons

  • Tare: Tares the scale.
  • Reset timer: Resets the timer. If the timer is running, it will continue to run.
  • Start/stop timer: Starts or stops the timer, depending on whether the timer is currently running. Does not reset, but continue the timer.

Sensors

  • Battery: Current battery level of the scale.
  • Volume flow rate: Calculates the current flow rate (in mL/s) while brewing.
  • Weight: The weight currently shown on the scale.

Supported devices

The following devices have been tested successfully with this integration:

  • Lunar
  • Pyxis
  • Pearl
  • Pearl S

If you have successfully tested this integration with another Acaia model, please let us know by enhancing this documentation, or by opening an issue in GitHub.

Possible use-cases

This integration can be used in combination with integrations for smart coffee machines, such as the La Marzocco integration integration. It could also be used to display the weight on secondary displays when brewing on a Pyxis or Lunar where you cannot see the display.

Automations

Get started with these automation examples.

Tare & start timer when brew starts

{% details "Example YAML configuration" %}

{% raw %}

alias: "Start timer on scale"
description: "When a brew starts on the machine, the following actions are started: tare, reset the timer, and start the timer on the scale."
triggers:
  - trigger: state
    entity_id:
      - binary_sensor.lm001234_brewing_active
    to: "on"
    from: "off"
actions:
  - action: button.press
    target:
      entity_id: button.lunar_tare
  - action: button.press
    target:
      entity_id:
        - button.lunar_reset_timer
  - action: button.press
    target:
      entity_id:
        - button.lunar_start_stop_timer

{% endraw %} {% enddetails %}

Known limitations

  • While this integration is configured for your device, you won't be able to use the official app, as only one connection at a time is supported.

Remove integration

This integration follows standard integration removal, no extra steps are required.

{% include integrations/remove_device_service.md %}

Troubleshooting

{% details "Device not discovered or found" %}

Make sure your scale is turned on and in Bluetooth range to your Home Assistant instance. ESPHome Bluetooth Proxies are a great way to increase the range if your instance is too far away. Turn on debug settings in the acaia integration and check your logs. {% enddetails %}