From c569e1a990b881e6e173e36e1be01806e3982527 Mon Sep 17 00:00:00 2001
From: Josef Zweck <24647999+zweckj@users.noreply.github.com>
Date: Fri, 15 Nov 2024 16:49:52 +0100
Subject: [PATCH] Add documentation for acaia integration (#35635)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
---
 source/_integrations/acaia.markdown | 97 +++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 source/_integrations/acaia.markdown

diff --git a/source/_integrations/acaia.markdown b/source/_integrations/acaia.markdown
new file mode 100644
index 000000000000..a5b32e4d37af
--- /dev/null
+++ b/source/_integrations/acaia.markdown
@@ -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 %}
+