mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-24 19:16:50 +00:00
123 lines
3.9 KiB
Markdown
123 lines
3.9 KiB
Markdown
---
|
|
title: Acaia
|
|
description: Instructions on how to integrate your Acaia smart coffee scale with Home Assistant.
|
|
ha_release: 2024.12
|
|
ha_category:
|
|
- Binary sensor
|
|
- Button
|
|
- Sensor
|
|
ha_iot_class: Local Push
|
|
ha_config_flow: true
|
|
ha_domain: acaia
|
|
ha_platforms:
|
|
- binary_sensor
|
|
- button
|
|
- diagnostics
|
|
- sensor
|
|
ha_bluetooth: true
|
|
ha_codeowners:
|
|
- '@zweckj'
|
|
ha_integration_type: device
|
|
ha_quality_scale: platinum
|
|
---
|
|
|
|
The **Acaia** {% term integration %} allows you to control [Acaia](https://acaia.co/) scales through Home Assistant.
|
|
|
|
If your machine is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/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](https://www.home-assistant.io/integrations/lamarzocco/) 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 %}
|
|
|
|
```yaml
|
|
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.
|
|
|
|
## Removing the 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](https://esphome.io/components/bluetooth_proxy.html) 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 %}
|