Add documentation for acaia integration (#35635)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Josef Zweck 2024-11-15 16:49:52 +01:00 committed by GitHub
parent 0244173bc5
commit c569e1a990
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -0,0 +1,97 @@
---
title: Acaia
description: Instructions on how to integrate your Acaia smart coffee scale with Home Assistant.
ha_release: 2024.12
ha_category:
- Button
ha_iot_class: Local Push
ha_config_flow: true
ha_domain: acaia
ha_platforms:
- button
ha_bluetooth: true
ha_codeowners:
- '@zweckj'
ha_integration_type: device
---
The **Acaia** {% term integrations %} 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.
{% include integrations/config_flow.md %}
{% configuration_basic %}
MAC:
description: "The MAC address of your scale."
{% endconfiguration_basic %}
# Available platforms & entities
## 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.
## Supported devices
The following devices have been tested successfully with this integration:
- Lunar (manufactured after 2021)
- Pyxis
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.
## 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 %}